힉스필드 CLI 사용법, 클로드 코드⁠·블렌더 프리비즈로 AI 영상 만들기 37단계

힉스필드 CLI 사용법은 클로드 코드가 힉스필드와 블렌더를 직접 다루게 해서 AI 영상을 만드는 방법입니다. VS Code에 클로드 코드를 설치하고, 힉스필드 CLI를 연결하고, 블렌더로 카메라 움직임 시안(프리비즈)을 만든 뒤, 480p 초안으로 연출을 다듬고 마지막에 한 번만 고화질로 뽑는 순서까지 37단계로 풀었습니다.

세 도구를 이어서 쓰는 작업 방식

클로드 코드는 내 컴퓨터에서 직접 일을 하는 클로드입니다. 채팅창의 클로드는 대답만 하지만, 클로드 코드는 내 폴더의 파일을 열고 프로그램을 설치하고 실행까지 합니다. 이 방식에서는 세 도구가 역할을 나눕니다.

• 클로드 코드: 설치, 블렌더 조작, 영어 프롬프트 작성, 힉스필드 호출을 대신합니다.
• 힉스필드: 키프레임(장면의 첫 그림과 끝 그림), 영상, 캐릭터 목소리, 배경 음악을 한곳에서 만듭니다.
• 블렌더: 무료 3D 프로그램입니다. 캐릭터가 어디로 걷고 카메라가 어떻게 따라가는지를 대충 만든 3D 영상으로 보여 주는 용도입니다.

글로만 "이런 장면 만들어 줘"라고 하면 영상은 만들어지지만 생각한 장면은 거의 나오지 않습니다. 카메라 위치와 움직임을 글로 설명하는 것은 한도 끝도 없기 때문에, 글 대신 대충 만든 3D 영상을 보여 줍니다. 영화⁠·광고 업계에서는 이것을 프리비즈(본 제작 전에 만드는 움직이는 콘티)라고 부릅니다.

"딸깍 한 번"으로 끝나는 작업은 아닙니다. 한 게임 인트로 영상 제작 사례에서는 영상을 46번 뽑아 10개를 쓰고, 키프레임은 86장을 만들었습니다. 프리비즈 제작, 영상 생성, 수정과 편집에 하루씩 걸려 거의 3일이 들었습니다. 다른 일을 하면서 AI에게 시켜 병행한 시간이고, 규칙을 처음부터 알고 다시 하면 훨씬 짧아진다고 합니다.

준비물과 비용

준비물

• 컴퓨터: 이 사례는 RTX 3070 Ti 그래픽 카드 환경에서 작업했습니다.
• 계정: 클로드 계정, 힉스필드 계정, 캐릭터 시트를 그릴 GPT 계정. 클로드 코드 VS Code 확장은 유료 Claude 요금제(Pro, Max, Team, Enterprise) 또는 Claude Console 계정이 있어야 쓸 수 있습니다.
• 설치물: VS Code(무료), 클로드 코드 확장, 블렌더(무료). 모두 아래 단계에서 설치합니다.
• 비용: VS Code와 블렌더는 무료입니다. 클로드 요금제와 힉스필드 크레딧은 유료이고 요금은 공식 안내를 확인합니다.

순서

클로드 코드를 먼저 설치합니다. 힉스필드 연결과 블렌더 설치는 클로드 코드에게 시켜서 진행할 수 있습니다.

클로드 코드 설치 (1~6단계)

1. VS Code(무료 편집 프로그램)를 내려받아 설치합니다. 버전은 1.94.0 이상이어야 합니다.

   • 위치: VS Code 공식 사이트(code.visualstudio.com)
   • 확인: VS Code가 열립니다. 버전은 도움말의 정보 메뉴에서 볼 수 있습니다.

2. VS Code 왼쪽의 확장 메뉴를 엽니다. 단축키는 맥은 Cmd+Shift+X, 윈도우는 Ctrl+Shift+X입니다.

   • 확인: 확장을 검색할 수 있는 화면이 열립니다.

3. 확장 메뉴에서 "Claude Code"를 검색합니다.

   • 확인: 게시자가 Anthropic이고 확장 ID가 anthropic.claude-code인 확장이 목록에 나옵니다.

4. 클로드 코드 확장에서 "Install"을 누릅니다.

   • 확인: 클로드 코드를 쓸 수 있는 채팅창이 생깁니다. 확장이 보이지 않으면 VS Code를 다시 시작합니다.
   • 대안: 코덱스를 쓰는 사람은 코덱스로 해도 되고 같은 스킬 파일을 읽습니다.

5. 클로드 계정으로 로그인합니다. 처음 패널을 열면 나오는 "Sign in"을 눌러 브라우저에서 승인합니다.

   • 확인: 로그인이 끝나면 대화 입력창이 열립니다.

6. (선택) 모델을 고릅니다. 이 사례는 오퍼스 5.5를 썼지만 필수는 아닙니다.

   • 확인: 입력창 근처의 모델 이름이 원하는 모델로 표시됩니다.

힉스필드 연결, CLI 방식 (7~14단계)

힉스필드는 그림, 영상, 캐릭터 목소리, 배경 음악처럼 원래 따로 있는 AI를 한곳에 모은 AI 영상 플랫폼입니다. AI에게 힉스필드를 연결하는 방법은 두 가지입니다.

• MCP: 클로드나 챗GPT 채팅창에 힉스필드를 꽂아 놓는 연결선입니다.
• CLI: 내 컴퓨터에 설치하는 명령어 프로그램입니다. AI가 이 CLI로 직접 명령어를 쳐서 힉스필드를 씁니다.

힉스필드 공식 안내도 채팅 앱에는 MCP, 클로드 코드 같은 코딩 에이전트에는 CLI를 권하고, 둘 다 설치할 필요는 없다고 합니다. 이 작업에서 CLI가 맞는 이유는 두 가지입니다.

• 내 파일에 접근할 수 있습니다. MCP는 AI가 내 폴더를 보지 못하지만, CLI는 폴더의 프리비즈 영상과 키프레임을 바로 올리고 결과물을 데스크톱 폴더에 바로 저장합니다.
• 반복 작업이 됩니다. 영상을 연달아 뽑고, 실패하면 그 부분만 다시 뽑을 수 있습니다.

공식 안내가 알려 주는 설치 명령은 아래 두 줄입니다.

npx skills add higgsfield-ai/skills
higgsfield auth login

첫 줄은 힉스필드 스킬(생성, 소울, 제품 촬영)을 설치하고, 둘째 줄은 API 키 없이 힉스필드 계정으로 로그인합니다. 힉스필드 CLI 프로그램 자체의 설치 문구는 힉스필드 사이트의 CLI 안내 페이지에 있습니다. 이 단계는 클로드 코드에게 맡길 수 있습니다.

7. 힉스필드 사이트에 로그인해 CLI(코딩 에이전트) 연결 안내 페이지를 엽니다.

   • 확인: 클로드 코드에 붙여 넣을 설치 문구가 보입니다. 보이지 않으면 아래 8단계의 문구를 그대로 씁니다.

8. 설치 문구(또는 아래 문구)를 클로드 코드 채팅창에 붙여 넣습니다.

   • 확인: 클로드가 프로그램 설치, 로그인, 힉스필드 스킬 설치를 차례로 진행합니다.
   • 대안: 클로드가 중간에 허락을 요청하면 모두 허용합니다. Node.js처럼 필요한 프로그램이 없으면 클로드가 설치를 도와줍니다.

힉스필드 CLI를 설치하고 로그인한 다음, 힉스필드 스킬까지 설치해 줘.
스킬 설치 명령은 npx skills add higgsfield-ai/skills, 로그인 명령은 higgsfield auth login 이야.
필요한 프로그램이 없으면 설치 방법을 알려 주거나 직접 설치해 줘.

9. 로그인이 시작되면 브라우저에 뜨는 창에서 "허용"을 누릅니다.

   • 확인: 요금제 화면이 바로 뜹니다.

10. 요금제 화면을 훑어봅니다.

    • 확인: 여러 프로모션이 보입니다. 필요한 경우에만 결제합니다.

11. 이미 결제했다면 오른쪽 위 "건너뛰기"를 누릅니다.

    • 위치: 요금제 화면 오른쪽 위
    • 확인: 요금제 화면이 넘어갑니다.

12. 클로드가 마지막 줄(힉스필드 스킬 설치)을 끝낼 때까지 기다립니다.

    • 확인: 진행이 다 끝납니다. 클로드가 힉스필드 쓰는 법을 미리 알고 시작하게 해 주는 단계입니다.

13. 클로드 코드에게 힉스필드가 잘 연결됐는지 묻습니다.

    • 확인: 클로드가 답을 합니다.

지금 힉스필드가 잘 연결되어 있는지 확인해 줘.

14. 클로드의 답을 읽습니다.
    • 확인: "연결이 되어 있다"고 하면 끝난 것입니다. 이후 클로드 코드 안에서 /higgsfield:generate를 입력하거나 평소 말투로 이미지⁠·영상을 요청하면 클로드가 알맞은 스킬을 골라 실행합니다.

블렌더 설치 (15~16단계)

블렌더는 무료 프로그램이고, 클로드 코드가 블렌더를 직접 켜서 장면을 만들고 카메라까지 움직여 하나의 애니메이션으로 만들어 줍니다. 이 사례는 게임 맵을 그대로 넣어 프리비즈를 만들었습니다. 이 프리비즈를 영상 AI에 같이 넣고 "프리비즈에 있는 카메라 움직임대로 만들어라"고 시킵니다.

15. 블렌더 공식 홈페이지(blender.org)에서 무료로 내려받습니다.

    • 위치: 블렌더 공식 홈페이지의 다운로드 메뉴
    • 확인: 설치 파일이 내려받아집니다.

16. 설치 창에서 "다음"을 계속 눌러 설치를 끝냅니다.

    • 확인: 블렌더가 설치되어 프로그램 목록에 나타납니다.

영상 AI는 프리비즈에 보이는 것을 전부 따라 한다

그림을 넣고 프리비즈를 넣고 "영상 만들어 줘" 하면 끝일까요? 반만 맞습니다. 영상 AI는 프리비즈에 보이는 것을 전부 따라서 만들기 때문입니다. 카메라 움직임은 물론이고 회색 인형의 팔 각도, 소품 모양까지 따라 합니다. 한 사례에서는 게임 속 정령 캐릭터의 날개가 옆으로 뻗은 길쭉한 모양인데, 프리비즈에서 날개를 작고 동그랗게 대충 만들었더니 영상에서도 동그란 모양이 나왔습니다.

그래서 정보를 세 군데로 나눠서 줍니다.

• 프리비즈: 카메라 위치와 움직임, 타이밍, 인물이 서 있는 자리와 지나가는 길
• 그림(캐릭터 시트와 키프레임): 캐릭터 얼굴과 옷, 배경의 색과 재질, 소품의 모양
• 프롬프트: 어떻게 움직이고 어디를 보고 어떤 기분인지

따라 하면 안 되는 것은 프리비즈에서 지우거나 단순하게 만듭니다. 사람 몸은 회색 원통으로 바꾸는 식입니다. 반대로 따라 해야 하는 것은 진짜 모양대로 만듭니다. 3D 자료가 없어도 됩니다. 필요한 3D는 클로드가 알아서 만들어 주고, 장면에 나온 배 한 척도 디자인 그림 한 장만 보고 클로드가 만들었습니다.

따라 하기 1, 캐릭터 시트 (17~21단계)

캐릭터 시트는 한 장에 세 가지가 들어간 그림이 가장 안정적이었고, 세 가지가 한 장에 있으면 영상 내내 캐릭터가 같은 모습으로 나옵니다. 세 칸은 정면 얼굴, 정면 전신, 뒷모습 전신입니다.

17. GPT를 엽니다.

    • 확인: 대화창이 열립니다.

18. 참고할 캐릭터 시트 이미지가 있으면 대화창에 첨부합니다. 없으면 건너뛰고 19단계에서 칸 구성을 글로 설명합니다.

    • 확인: 시트 그림이 대화창에 올라갑니다.

19. GPT에 세 칸 구성을 설명하고 캐릭터 그림을 요청합니다. "이런 캐릭터" 자리에는 만들고 싶은 캐릭터 설명을 넣습니다.

    • 확인: 세 칸이 한 장에 든 캐릭터 그림이 나옵니다.

한 장에 세 칸으로 된 캐릭터 시트를 그려 줘. 왼쪽부터 정면 얼굴 클로즈업, 정면 전신, 뒷모습 전신이야. 배경은 단색 회색이고 글자는 넣지 마. 캐릭터는 이런 모습이야: (여기에 캐릭터 설명)

20. 이미 그린 캐릭터가 있으면 그 그림도 같이 올립니다.

    • 확인: 그림이 대화창에 올라갑니다.

21. "이 캐릭터랑 똑같이 그려 달라"고 씁니다.

    • 확인: 올린 캐릭터와 같은 모습의 시트가 나옵니다. 20~21단계는 이미 그린 캐릭터가 있을 때만 합니다.

따라 하기 2, 프리비즈 (22~30단계)

시행착오에서 얻은 규칙을 한 파일에 적어 두면 클로드가 매번 같은 기준으로 프리비즈를 만듭니다. 클로드 코드는 작업 폴더의 CLAUDE.md 파일을 세션을 시작할 때 읽으므로, 이 규칙 파일을 그 이름으로 저장하면 됩니다.

22. 작업 폴더를 하나 만들고 VS Code로 엽니다. 그 폴더에 CLAUDE.md 파일을 만듭니다.

    • 확인: 폴더 안에 빈 CLAUDE.md가 생깁니다.

23. 아래 규칙을 CLAUDE.md에 붙여 넣고 저장합니다.

    • 확인: 파일에 규칙이 저장됩니다. 클로드 코드를 새로 시작하면 이 규칙을 읽습니다.

# AI 영상 제작 규칙

## 역할 나누기
- 프리비즈는 카메라 위치와 움직임, 타이밍, 인물 동선만 담당한다.
- 캐릭터 시트와 키프레임은 얼굴, 옷, 색, 재질, 소품 모양을 담당한다.
- 프롬프트는 어떻게 움직이고 어디를 보고 어떤 기분인지 자세히 연출한다.

## 프리비즈 만들기
- 색은 빼고 회색으로, 사람 몸은 원통으로 단순하게 만든다.
- 글자와 자막은 모두 지운다.
- 영상 AI가 따라 하면 안 되는 모양은 지우거나 단순하게 만든다. 따라 해야 하는 모양은 실제 모양대로 만든다.
- 블렌더 렌더링은 낮은 품질 설정으로 빠르게 돌린다. 프리비즈는 예쁠 필요가 없다.
- 렌더링은 한 번에 하나씩만 돌린다.

## 영상 만들기
- 영상을 뽑기 전에 키프레임(첫 그림과 끝 그림)을 먼저 만들어 보여 준다.
- 시작 그림, 끝 그림, 프리비즈는 같은 공간과 같은 구도여야 한다.
- 480p 초안으로 연출을 다듬고, 고화질은 마지막에 한 번만 뽑는다.
- 힉스필드용 프롬프트는 영어로 쓴다.

24. 클로드 코드 채팅창에 어떤 영상인지 적습니다.

    • 확인: 입력창에 글이 들어갑니다.

25. 캐릭터 시트가 어디 있는지 적습니다.

    • 확인: 시트 위치가 적혀 있습니다.

26. 배경이 무엇인지 적습니다.

    • 확인: 배경 설명이 적혀 있습니다.

27. 스토리가 어떤지 적습니다.

    • 확인: 스토리가 적혀 있습니다.

28. 마지막에 CLAUDE.md의 규칙을 따라 프리비즈를 만들어 달라고 적습니다. 24~28단계는 한 번에 이어서 보내도 됩니다.

    • 확인: 클로드가 프리비즈를 만듭니다.
    • 대안: 3D 자료가 없어도 됩니다. 필요한 3D는 클로드가 만들어 줍니다.

영상 내용: (어떤 영상인지 한두 문장)
캐릭터 시트: (시트 이미지가 있는 폴더 경로)
배경: (배경 설명)
스토리: (처음, 중간, 끝 순서로 3~5문장)
CLAUDE.md 규칙을 따라 블렌더 프리비즈를 만들어 줘. 컷은 몇 개로 나눌지 먼저 제안해 줘.

29. 완성된 프리비즈를 직접 눈으로 봅니다.

    • 확인: 카메라 움직임, 캐릭터 동선, 인물이나 물건 자리를 확인했습니다.

30. 마음에 안 드는 부분을 말로 피드백합니다.

    • 확인: 클로드가 프리비즈를 고칩니다.

따라 하기 3, 프롬프트로 영상 만들기 (31~33단계)

프롬프트는 직접 쓸 필요가 없습니다. 규칙 파일에 역할 나누기가 들어 있으면, 클로드가 프리비즈가 맡을 것, 캐릭터 시트가 맡을 것, 움직임과 시선과 기분을 영어 프롬프트로 정리해 힉스필드에 넣습니다.

31. 클로드 코드에 규칙을 참고해서 영상을 만들어 달라고 요청합니다.

    • 확인: 프롬프트를 직접 쓰지 않고 우리말 지시만 입력했습니다.

32. 프리비즈의 "몇 초부터 몇 초까지는 이렇게 연출해 달라"고 구간별로 말합니다.

    • 확인: 구간마다 연출 지시가 적혀 있습니다.

CLAUDE.md 규칙을 참고해서 1번 컷 영상을 만들어 줘. 프리비즈의 카메라 움직임을 따르고, 캐릭터 시트의 외형을 쓰고, 힉스필드 프롬프트는 영어로 써 줘.
0초에서 3초까지는 인물이 앞을 보며 천천히 걷고, 3초에서 6초까지는 카메라가 옆으로 돌며 인물의 얼굴을 보여 줘.

33. 클로드가 영상을 만들 때까지 기다린 뒤 결과를 확인합니다.
    • 확인: 클로드가 힉스필드가 알아듣기 쉬운 영어 프롬프트를 써서 영상을 만듭니다. CLI 방식이라 결과물이 내 컴퓨터의 폴더에 바로 저장됩니다.

해상도 순서로 비용 아끼기 (34~37단계)

480p 초안을 먼저 뽑고, 1080p는 마지막에 한 번만 뽑습니다. 해상도가 올라갈수록 크레딧이 크게 늘어납니다. 이 사례에서는 힉스필드의 1080p가 480p의 4배 가격이었고, 한 번에 마음에 드는 결과는 거의 나오지 않으므로 처음부터 1080p로 뽑지 않습니다. 초안에서 연출을 확정한 뒤 고화질로 올리는 방식은 시댄스 2.5의 초안 모드가 대표적입니다. 480p 초안을 만든 뒤 같은 프롬프트, 길이, 화면 비율, 소리 설정을 그대로 물려받아 1080p로 최종 생성합니다.

34. 480p 초안(드래프트)으로 영상을 뽑습니다.

    • 확인: 480p 초안 영상이 나옵니다.

35. 초안을 보고 피드백을 줍니다.

    • 확인: 피드백이 반영된 초안이 다시 나옵니다.

36. 마음에 들 때까지 35단계를 반복합니다.

    • 확인: 연출이 마음에 듭니다.

37. 확정한 초안을 같은 연출 그대로 1080p로 만드는 기능을 씁니다.

    • 확인: 같은 연출 그대로 화질만 올라갑니다.
    • 대안: 모델 선택 화면에 초안을 고화질로 올리는 기능이 보이지 않으면, 480p로 확정한 뒤 720p로 새로 뽑아 1080p로 업스케일(해상도 확대)하는 방법이 있습니다. 크레딧은 1초에 5크레딧 정도 더 싸지만, 새로 생성하므로 확정한 480p와 같은 연출이 나온다는 보장은 없습니다. 힉스필드의 모델별 지원 기능과 요금은 수시로 바뀌니 생성 화면에서 확인합니다.

규칙 파일이 해 주는 일

위 CLAUDE.md 규칙은 여섯 가지 일을 합니다.

• 역할 나누기: 프리비즈, 그림, 프롬프트가 맡을 일을 정해 두고 AI가 그대로 일하게 합니다.
• 프리비즈 다듬기: 힉스필드에 넣기 좋게 색은 빼서 회색으로, 사람은 원통으로, 글자나 자막은 다 지웁니다.
• 제작 시간 줄이기: 블렌더는 렌더링 설정이 여러 가지인데 정확히 알려 주지 않으면 AI가 프리비즈도 예쁘게 뽑으려고 합니다. 한 사례에서는 렌더링 설정을 바꿔 24초짜리 프리비즈가 43분에서 6~7분으로 줄었습니다. 프리비즈는 예쁠 필요가 없으니 낮은 품질로 여러 번 뽑아 연출 피드백을 많이 주는 쪽이 낫습니다.
• 컴퓨터 사양에 맞춰 돌리기: 프리비즈 두 개를 동시에 렌더링하다가 그래픽 카드 드라이버가 멈춰 재부팅한 사례가 있습니다. 렌더링은 한 번에 하나씩 돌립니다.
• 키프레임 먼저 보여 주기: 영상을 뽑기 전에 장면의 첫 그림과 끝 그림부터 만들어 보여 주고, 키프레임끼리 소품, 빛, 배경이 어긋나지 않게 맞춥니다.
• 비용 아끼기: 위의 해상도 순서입니다.

자주 생기는 문제와 해결

배경이 중간에 바뀔 때

• 증상: 마지막 컷, 두 사람이 마을로 걸어가는 12초짜리 컷을 아홉 번 다시 뽑았는데 뽑을 때마다 부두였던 배경이 절벽 위의 등대로 바뀌었습니다.
• 원인: 시작 그림은 등대가 멀리 언덕 위에 있었는데 프리비즈는 부두 바로 앞이었습니다.
• 해결: 시작 그림을 프리비즈와 똑같은 구도로 다시 그리자 배경이 끝까지 유지됐습니다.

하늘에 해가 두 개 뜰 때

• 원인: 바다 장면에서 끝 그림에 해를 다른 자리에 그렸습니다.
• 해결: 시작 그림, 끝 그림, 프리비즈는 항상 같은 공간이어야 합니다.

"윙크해"라고 썼더니 두 눈을 감을 때

• 원인: 프롬프트에 순서 없이 "윙크해"라고만 썼습니다.
• 해결: 양쪽 눈 뜨고, 한쪽만 감고, 다시 뜨는 순서까지 써 줬습니다.

프리비즈가 결과물의 모양을 끌고 갈 때

• 증상: 길쭉한 날개가 동그랗게 나온 것처럼, 프리비즈의 대충 만든 모양을 영상 AI가 따라 합니다.
• 해결: 따라 하면 안 되는 것은 지우거나 단순하게, 따라 해야 하는 것은 진짜 모양대로 만듭니다.

렌더링 중에 그래픽 카드 드라이버가 멈출 때

• 원인: 프리비즈 두 개를 동시에 렌더링했습니다. 재부팅이 필요했습니다.
• 해결: 렌더링을 한 번에 하나씩만 돌리도록 규칙 파일에 적어 둡니다.

들어간 비용, 한 제작 사례

• 힉스필드 크레딧 1,673을 썼습니다. 울트라 요금제로 치면 72달러, 우리 돈 약 10만 원입니다.
• 이 중 영상을 뽑는 데만 1,383크레딧이 들었습니다.
• 지금까지는 480p 시안이고, 1080p로 다시 뽑으면 1,000크레딧이 더 듭니다. 그래서 1080p는 마지막에 한 번만 뽑습니다.
• 이 사례는 동료들의 피드백을 받아 한 번 더 다듬은 뒤 최종본을 만들 계획이어서 15만 원은 넘게 들 것으로 봤습니다.

요금제와 크레딧 단가는 수시로 바뀌므로, 따라 한다면 그 시점의 가격을 먼저 확인합니다. 작업의 대부분은 AI에게 설명을 디테일하게 하는 일이었습니다. 카메라는 어디서, 날개는 어떤 모양, 윙크는 어떤 방식으로 하는지를 하나하나 적어 주는 정도가 결과를 가릅니다.

최종 체크리스트

• 클로드 코드가 힉스필드 연결 여부 질문에 "연결이 되어 있다"고 답했다
• 블렌더가 설치되어 있다
• 캐릭터 시트가 한 장에 세 칸으로 만들어졌다
• 프리비즈를 눈으로 확인하고 피드백했다
• 시작 그림, 끝 그림, 프리비즈가 같은 공간이다
• 영상은 480p 초안으로 다듬고 1080p는 마지막에 한 번만 뽑았다
• 비용을 위 사례(1,673크레딧, 약 10만 원)와 비교해 보았다