힉스필드 AI 클로드코드 연동 방법 총정리｜MCP·CLI 설치부터 영상 생성·크레딧 확인까지

힉스필드 AI를 클로드코드와 연결하면 터미널 안에서 이미지와 영상 생성 작업까지 이어갈 수 있습니다.
여러 생성형 AI 서비스를 따로 열어두는 대신 클로드코드에서 한 번에 호출하고 비교할 수 있다는 점이 가장 큰 장점입니다.
특히 Veo, Sora, Kling 계열처럼 서로 다른 생성 모델을 함께 써보고 싶은 분이라면 훨씬 편해질 수 있습니다.

연동 방법은 크게 두 가지입니다.
MCP 커넥터로 연결하는 방법과 힉스필드 공식 CLI를 설치하는 방법인데요.
둘 다 같은 힉스필드 계정을 사용하지만 활용 범위와 자동화 편의성이 조금 다릅니다.

 

 

힉스필드 AI는 어떤 서비스일까

힉스필드는 여러 이미지·영상 생성 모델을 한 계정에서 사용할 수 있도록 묶은 플랫폼입니다.
Veo, Sora, Kling 계열과 자체 이미지·영상 모델을 함께 사용할 수 있다는 점이 특징입니다.

같은 프롬프트를 여러 모델에 넣어 비교하거나, 특정 인물과 제품의 일관성을 유지하면서 여러 컷을 생성하는 작업에도 활용할 수 있습니다.
광고 영상이나 쇼츠처럼 반복 제작이 많은 작업에서는 모델을 바꿀 때마다 서비스를 다시 열지 않아도 된다는 점이 꽤 편합니다.

 

 

클로드코드와 연결하면 “영상 만들어줘”라는 지시가 단순한 프롬프트 작성에서 끝나지 않습니다.
조건에 맞는 모델 호출과 생성 작업까지 터미널 안에서 이어서 처리할 수 있습니다.

 

 

방법 1. MCP 커넥터로 연동하기

MCP는 AI 에이전트와 외부 서비스나 도구를 연결하는 표준입니다.
힉스필드는 MCP 서버를 제공하기 때문에 클로드코드에서 비교적 간단하게 연결할 수 있습니다.

참고자료에 나온 명령은 아래와 같습니다.
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp
이 명령을 터미널에서 실행하면 사용자 범위 설정으로 힉스필드 MCP가 추가됩니다.

--scope user 옵션을 사용하면 특정 프로젝트에만 묶이지 않고 사용자 설정에 저장됩니다.
프로젝트 폴더를 바꿔도 계속 같은 연결을 사용할 수 있다는 뜻입니다.

연결 후 클로드코드에서 /mcp 명령을 실행하면 인증 과정을 진행할 수 있습니다.
브라우저에서 힉스필드 계정으로 로그인하면 기존 계정과 크레딧을 그대로 사용할 수 있습니다.

 

 

방법 2. 공식 CLI로 연결하기

클로드코드나 Codex에서 반복적으로 활용할 생각이라면 공식 CLI 방식이 더 잘 맞을 수 있습니다.
특히 자동화 스크립트와 연결하거나 생성 작업을 여러 단계로 묶을 때 편합니다.

참고자료에서 제시한 설치 명령은 다음 세 단계입니다.
npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills

첫 번째 명령으로 힉스필드 CLI를 설치하고, 두 번째 명령에서 브라우저 로그인을 진행합니다.
마지막 명령은 클로드코드에서 사용할 수 있는 관련 스킬을 추가하는 과정입니다.

CLI 방식은 단순 이미지·영상 생성뿐 아니라 캐릭터 관련 작업이나 마케팅용 생성 작업처럼 범위를 넓히기 좋습니다.
처음 한 번 인증을 끝내고 나면 이후에는 터미널 중심으로 작업할 수 있습니다.

 

 

MCP와 CLI 중 무엇을 선택하면 될까

간단하게 연결해서 클로드코드 안에서 힉스필드를 호출해보고 싶다면 MCP 방식이 이해하기 쉽습니다.
반대로 자동화와 반복 작업, 여러 기능을 적극적으로 쓰고 싶다면 CLI 방식이 더 편할 수 있습니다.

둘 중 하나만 반드시 선택해야 하는 것은 아닙니다.
처음에는 MCP로 연결 구조를 익히고, 실제 업무에 자주 쓰게 되면 CLI까지 설치하는 방법도 괜찮습니다.

 

 

클로드코드가 없다면 먼저 설치해야 합니다

힉스필드를 연동하기 전에 클로드코드가 정상적으로 실행되는지 먼저 확인하세요.
설치 후 터미널에서 claude --version을 입력했을 때 버전 정보가 나오면 기본 설치는 끝난 상태입니다.

처음 실행할 때는 claude 명령으로 로그인하고, 작업할 프로젝트 폴더에서 실행하는 것이 좋습니다.
필요하다면 /init으로 프로젝트용 CLAUDE.md를 만들어 기본 지침을 정리할 수도 있습니다.

 

 

Claude 공식 문서 확인하기 →
Claude Code 설치와 MCP 설정 방법을 공식 문서에서 확인하세요.

 

 

영상 생성 전에 크레딧부터 확인하세요

힉스필드에서 가장 먼저 체크해야 할 부분은 생성 비용입니다.
이미지와 영상은 사용하는 모델과 해상도, 길이에 따라 소모되는 크레딧이 달라집니다.

참고자료에서는 higgsfield account 명령으로 계정 상태를 보고, higgsfield generate cost로 생성 전에 예상 비용을 확인하는 방법을 소개하고 있습니다.
영상은 이미지보다 크레딧 소모가 커질 수 있으니 바로 고품질 렌더링부터 시작하는 건 부담이 될 수 있습니다.

처음에는 저렴한 모델과 낮은 설정으로 구도와 프롬프트를 확인하고, 결과가 마음에 들었을 때 최종 렌더링으로 넘어가는 편이 좋습니다.
이 순서만 지켜도 불필요한 크레딧 소비를 꽤 줄일 수 있습니다.

 

 

여러 모델을 비교할 때 특히 유용합니다

힉스필드의 장점은 특정 모델 하나만 쓰는 것보다 여러 모델을 비교하면서 작업할 때 더 크게 느껴집니다.
같은 장면을 Veo 계열과 Kling 계열에 각각 생성시키고 결과를 비교하는 식으로 활용할 수 있습니다.

클로드코드에서 작업 지시와 파일 정리까지 함께 한다면 프롬프트 작성 → 모델 호출 → 결과 비교 → 다음 장면 수정 같은 흐름을 한 곳에서 관리하기 쉬워집니다.
영상 콘텐츠를 많이 만드는 분에게는 이 부분이 꽤 큰 장점입니다.

 

 

연동 전에 꼭 확인할 것
클로드코드 정상 실행 여부, 힉스필드 로그인 계정, MCP 또는 CLI 설치 상태, 크레딧 잔액, 생성 모델별 비용을 먼저 확인하세요.

 

 

처음에는 MCP로 연결하고 필요하면 CLI로 확장하세요

힉스필드 AI와 클로드코드 연동 자체는 복잡하지 않습니다.
간단히 써보고 싶다면 MCP 커넥터부터 연결하고, 반복 생성이나 자동화까지 필요해지면 CLI를 추가하는 순서가 부담이 적습니다.

중요한 건 연결 자체보다 어떤 작업을 자동화할지 먼저 정하는 것입니다.
영상 생성, 모델 비교, 캐릭터 일관성 유지처럼 반복되는 작업부터 묶어두면 클로드코드를 단순 코딩 도구가 아니라 콘텐츠 제작용 에이전트처럼 활용할 수 있습니다.