Claude Code용 Codex 이미지 생성 플러그인 공개

실용적 조언

Claude Code에서 이미지 생성을 원한다면 KingGyuSuh/codex-image-in-cc 플러그인을 설치하라.
플러그인 개발 시 인자 전달 오류를 방지하기 위해 쉘 스크립트 대신 Node.js와 같은 런타임에서 파싱 로직을 구현하라.

섹션별 상세

작성자는 Claude Code와 Codex CLI를 연결하는 경량 플러그인을 구축하여 이미지 생성 기능을 구현했다. 사용자는 /codex-image:generate와 같은 슬래시 커맨드를 통해 자연어로 이미지 생성, 편집, 상태 확인 명령을 내릴 수 있다. 별도의 API 키 관리 없이 기존 ChatGPT 구독이나 OpenAI API 설정을 그대로 활용하도록 설계됐다. 이를 통해 Claude 환경 내에서 워크플로우 중단 없이 시각적 자산을 생성할 수 있는 환경이 마련됐다.

javascript

node script.mjs "$ARGUMENTS"

SKILL.md에서 Node.js 스크립트를 호출하여 인자를 전달하는 아키텍처 구조

플러그인 아키텍처는 각 기술(Skill)을 정의하는 SKILL.md 파일이 Node.js 스크립트를 호출하는 노드 구조로 설계됐다. 약 375라인의 Node 래퍼가 인자 분할 및 Codex 실행 프로세스 생성을 담당하며, 실제 이미지 생성 지능은 Codex의 내장 기술에 의존한다. 개발 과정에서 모델이 SKILL.md 내의 bash 명령을 그대로 실행하지 않고 미리 평가해버리는 특성을 발견하여 모든 파싱 로직을 Node 스크립트로 옮겼다. 이러한 구조적 결정은 플러그인의 안정적인 인자 전달을 보장한다.

성능 및 비용 측면에서 에이전트 토큰 소모량에 대한 구체적인 수치가 제시됐다. 이미지 생성 비용 외에도 단일 이미지 생성 시 약 30,000개의 에이전트 토큰이 추가로 소모된다는 점이 확인됐다. 이는 에이전트가 도구를 호출하고 결과를 처리하는 과정에서 발생하는 오버헤드로, 사용자는 사용량 제한을 고려해야 한다. 그럼에도 불구하고 자연어만으로 출력 경로, 크기, 투명도 등을 제어할 수 있어 편의성이 높다는 평가다.

용어 해설

슬래시 커맨드(Slash Command): — CLI 도구나 채팅 인터페이스에서 '/' 기호로 시작하여 특정 기능이나 도구를 호출하는 명령어 방식이다. 이 아티클에서는 Claude Code 내에서 외부 이미지 생성 기능을 실행하는 트리거 역할을 수행한다.
에이전트 토큰(Agent Token): — AI 에이전트가 작업을 수행하기 위해 소모하는 연산 단위이다. 이미지 생성 자체 비용 외에도 에이전트가 명령을 해석하고 도구를 실행하는 과정에서 발생하는 추가적인 텍스트 처리 비용을 의미한다.
헤드리스 도구(Headless Tool): — 그래픽 사용자 인터페이스(GUI) 없이 명령줄이나 API를 통해 백그라운드에서 실행되는 소프트웨어이다. Codex CLI는 별도의 화면 없이 Claude Code와 연동되어 이미지 생성 로직을 처리한다.

코드 예제

bash

claude plugin marketplace add KingGyuSuh/codex-image-in-cc
claude plugin install codex-image@codex-image-in-cc

Claude Code에 제작한 이미지 생성 플러그인을 설치하는 명령어

언급된 도구

Claude Code중립

Anthropic의 공식 코딩 에이전트 CLI

Codex CLI추천

이미지 생성 및 코드 리뷰 기능을 제공하는 개발자 도구

언급된 리소스

GitHubcodex-image-in-cc GitHub Repo