Claude Code용 eroq 플러그인: 원격 서버, 로그인, 가격 아는 스킬

이제 Claude Code에 eroq 도구를 붙이는 방법은 세 가지이고, 셋은 서로 같지 않아요. 한 줄짜리 claude mcp add는 도구를 줘요. 플러그인은 도구에 스킬까지 줘요. 스킬은 eroq의 가격 체계, 어떤 모델을 고를지, 시키지 않아도 동영상을 어떻게 기다릴지를 Claude Code에 알려 주는 짧은 문서예요. CLI는 파일을 쓰는 로컬 서버를 줘요. 이 가이드는 플러그인에 관한 거예요. 설치, 스킬의 내용, 그리고 언제 무엇을 고를지 다뤄요.

설치

Claude Code 플러그인은 마켓플레이스에서 설치하고, eroq는 eroq.ai에서 자체 마켓플레이스를 제공해요. git 저장소는 필요 없어요.

/plugin marketplace add https://eroq.ai/claude-code/marketplace.json
/plugin install eroq@eroq

그다음 /mcp를 실행해 eroq를 선택하고 Authenticate를 고르세요. 브라우저에서 eroq가 열리면 로그인하고 Allow(허용)를 클릭하세요. Claude Code는 전용 키를 받고, 개발자 → API 키에 'Claude Code (connected)'로 표시돼요. 연결을 끊으려면 거기서 취소하세요.

마켓플레이스 항목은 SHA-256으로 고정된 아카이브라서, 설치되는 건 저희가 게시한 그대로예요. 플러그인 없이 서버만 쓰려면 이렇게 하세요.

claude mcp add --transport http eroq https://eroq.ai/mcp

(모든 프로젝트에서 쓰려면 --scope user를 추가하세요) 그다음 똑같이 /mcp → Authenticate를 하면 돼요. 헤더에 키를 넣는 방식이 좋다면 --header "Authorization: Bearer eroq_sk_…"도 돼요.

스킬이 알려 주는 것

스킬은 작업이 설명과 맞을 때 Claude Code가 읽는 마크다운 파일이에요. eroq 스킬은 이미지, 클립, 보이스 대사, 프로젝트용 비주얼 에셋을 요청할 때 작동하고, 요약하면 이런 내용이에요.

• 가격을 추측하지 마세요. 사용자가 모델을 지정하지 않았다면 세션당 한 번 list_models를 호출하세요. 모든 모델의 가격과 플랜에서 열려 있는지를 돌려줘요. 잔액은 get_account로 확인하고, 생성 비용이 잔액을 분명히 넘는다면 렌더하지 말고 그렇다고 알려 주세요.
• 거친 브리프는 다듬으세요. enhance_prompt는 무료예요. 요청이 모호할 때 쓰고, 다듬은 결과가 의도를 바꾸면 사용자에게 프롬프트를 보여 주세요.
• 이미지: generate_image는 기다렸다가 이미지와 30분 동안 유효한 서명 링크를 돌려줘요. aspect는 가격이 같은 다섯 가지 비율 중에서 고르고, 링크가 만료되니 curl -L -o <path> "<url>"로 바로 프로젝트에 저장하세요. 시작이 느려서 작업 ID가 돌아오면 get_image_status로 폴링하라는 뜻이에요.
• 동영상: 비동기예요. generate_video는 약 45초까지 기다린 뒤 작업 ID를 돌려줘요. get_video_status를 10초 정도마다 폴링하세요. 렌더에는 1~5분이 걸려요. 룩이 중요하면 model로 엔진을 지정하세요. seconds는 플랜 상한이 적용되고 엔진이 지원하는 길이로 맞춰져요. 이미지 투 비디오를 지원하는 엔진에서는 reference_image_url이 첫 프레임이 돼요.
• 음성: generate_speech는 MP3를 돌려줘요. list_voices에서 보이스를 고르거나, 사용자의 캐릭터 목소리로 말하려면 list_characters에서 char:<id>를 고르세요.
• 프롬프트: 자연스럽게 이어지는 한 문단. 피사체, 동작, 배경, 빛, 렌즈나 카메라 무브, 무드 순서로 쓰고, 형용사보다 구체적인 명사를 쓰세요. 동영상이라면 움직임과 카메라를 묘사하세요.
• 정책: 미성년자가 관련되거나 동의 없이 실존 인물이 등장하는 콘텐츠는 절대 요청하지 마세요. eroq의 거절 메시지는 받은 그대로 전달하세요.

마법 같은 건 하나도 없어요. "동영상 만들어 줘"라는 말만 듣고 가장 비싼 엔진으로 20초 클립을 렌더하는 에이전트와, 어떤 엔진을 쓸지 묻고, 기본 엔진에서 5초에 45 크레딧이라고 견적을 내고, 파일이 생길 때까지 폴링하는 에이전트의 차이일 뿐이에요.

플러그인을 쓴 세션 예시

나: 온보딩 화면에 일러스트가 필요해요. steps.ts의 단계마다 하나씩, 4:3, 플랫한 파스텔 스타일로 통일감 있게 만들어 주세요.

Claude Code는 steps.ts를 읽고(5단계), list_models와 get_account를 호출해요('1,240 크레딧 있어요. Krea 2 이미지 5장은 50 크레딧이에요'). 스타일에 enhance_prompt를 한 번 돌리고 다듬어진 스타일 문장을 단계마다 재사용하며, aspect: "4:3"으로 generate_image를 다섯 번 호출해요. 각 이미지를 curl로 public/onboarding/step-N.webp에 저장하고, steps.ts에 경로를 업데이트해요. '50 크레딧을 썼고, 1,190 크레딧 남았어요.'

스킬이 없으면 같은 요청에도 보통 스타일을 다섯 번 따로 추측하고, 예산 이야기는 나오지 않아요.

플러그인, 명령어, CLI 중 무엇을 쓸까

	claude mcp add	플러그인	CLI (eroq mcp)
도구	원격 서버	원격 서버	로컬 서버
로그인	/mcp로 OAuth	/mcp로 OAuth	환경 변수에 키
스킬	없음	있음	없음
출력	링크 + 인라인 이미지	링크 + 인라인 이미지	지정 경로에 파일
추천 용도	체험해 보기	일상 사용	빌드 단계, CI

플러그인과 명령어는 같은 서버예요. 플러그인은 여기에 스킬을 더하고 버전을 고정해요. CLI는 파일을 쓰는 별개의 로컬 서버예요. 스킬의 판단력과 파일 출력을 둘 다 원한다면 CLI와 플러그인을 함께 쓰세요. 스킬의 조언은 어느 쪽에도 적용되니까요.

업데이트

마켓플레이스 항목에는 버전이 있어요. 새 버전이 게시되면 /plugin update eroq@eroq를 실행하세요(모델과 가격이 바뀌면 스킬도 바뀌어요). 포크했다면 claude plugin validate로 로컬 사본을 검증하세요.

자주 묻는 질문

플러그인은 한 줄 명령어에 비해 무엇을 더해 주나요?

같은 서버에, eroq의 프롬프트, 가격, 비동기 동영상이 어떻게 작동하는지 Claude Code에 가르쳐 주는 스킬이 더해져요. 그래서 시키지 않아도 적절한 모델을 고르고, 크레딧 견적을 내고, 클립을 폴링해요.

API 키가 필요한가요?

아니요. /mcp → Authenticate가 브라우저 로그인을 진행해요. 스크립트로 구성하는 환경이라면 헤더에 키를 넣는 방식도 여전히 돼요.

렌더를 내 저장소에 저장할 수 있나요?

원격 서버는 링크와 인라인 이미지로 응답하고, 스킬이 Claude Code에게 그걸 curl로 프로젝트에 받아 두라고 알려 줘요. 파일로 바로 출력하려면 CLI의 로컬 서버 npx -y @eroq/cli mcp를 쓰세요.

마켓플레이스를 추가해도 안전한가요?

eroq.ai에서 HTTPS로 제공되고, 플러그인 아카이브는 마켓플레이스 파일에 SHA-256으로 고정돼 있어서 Claude Code가 설치하는 내용을 검증해요.

Claude Code 페이지에서 두 명령어를 모두 복사할 수 있어요.