원문: wjb127/codex-image · 수집일: 2026-10-04 · 커밋
1a7423c(2026-07-24) · Stars 약 60 · MIT · 한·영 병기 README
개요
Claude Code 안에서 /codex-image <프롬프트> 한 줄로 이미지를 만드는 스킬이다. 이미지 생성은 codex CLI가 맡고 모델은 gpt-image-2다. OpenAI API 키 없이 ChatGPT 로그인(OAuth)만으로 동작한다는 점이 핵심이다. 한국 개발자(wjb127)가 클라이언트 웹사이트를 만들며 쓴 Claude Code 스킬 7종 묶음 claude-skills의 하나다.
핵심 발견: 어떤 인증 경로가 통하나
| 경로 | 결과 | 비고 |
|---|---|---|
OPENAI_API_KEY → REST API | 성공 | 표준이지만 키 관리 필요 |
| OAuth 토큰 → REST API 직접 호출 | 실패(401) | OAuth 토큰은 sk-* API 키가 아닌 ChatGPT 세션 토큰 |
OAuth 토큰 → codex exec → 내장 image_gen | 성공 | codex-image가 쓰는 경로 |
흐름은 codex login(최초 1회, ~/.codex/auth.json에 저장) → codex exec가 토큰을 읽음 → 내장 image_gen 툴이 OAuth로 인증 → ~/.codex/generated_images/<session>/에 생성 → 프로젝트 폴더로 복사 → Claude Code에서 인라인 표시 순이다.
사용법
/plugin marketplace add wjb127/claude-skills
/plugin install codex-image@wjb127-skills
/codex-image --size 1024x1536 futuristic seoul skyline at sunset
/codex-image --quality high --out ./public/images korean hanok with cherry blossoms
/codex-image -n 3 logo variations for a tech startup| 옵션 | 값 | 기본값 |
|---|---|---|
--size | 1024x1024 · 1024x1536 · 1536x1024 · auto | 1024x1024 |
--quality | low · medium · high · auto | auto |
--out | 저장 디렉터리 | 프로젝트 루트 |
-n | 1–10 | 1 |
파일명은 codex-image-YYYYMMDD-HHMMSS(-N).png로 붙어 덮어쓰지 않는다. 사전 준비는 npm install -g @openai/codex와 codex login뿐이다.
의미와 주의
- 다른 모델의 기능을 Claude Code에 끌어오는 방식으로 보면 2026-07-12-cliproxyapi-gpt-in-claude-code와 같은 계열이다. 다만 여기서는 프록시 없이 공식 CLI의 내장 툴을 호출한다.
- 생성량은 API 과금이 아니라 ChatGPT 구독 쪽 사용 한도에 잡히는 것으로 보인다(README에 한도 설명은 없음).
codex exec의 내부 연결에 기대는 방식이라 Codex CLI가 업데이트되면 깨질 수 있다. - 이미지 생성 도구 전반은 moc-multimedia 참고.