원문: 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
옵션값기본값
--size1024x1024 · 1024x1536 · 1536x1024 · auto1024x1024
--qualitylow · medium · high · autoauto
--out저장 디렉터리프로젝트 루트
-n1–101

파일명은 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 참고.