Claude Code skill that generates images through Codex CLI — powered by OAuth, no API key needed.
Codex CLI를 통한 AI 이미지 생성 Claude Code 스킬 — OAuth 인증, API 키 불필요.
Prompt: "A lone astronaut standing on the edge of a crater on Mars, looking at Earth rising on the horizon, cinematic composition" · 1024x1536 · high quality
Most image generation tools require you to manage API keys, install Python SDKs, or leave your editor. codex-image lets you generate production-quality images without leaving Claude Code — and without ever touching an API key.
대부분의 이미지 생성 도구는 API 키 관리, Python SDK 설치, 또는 에디터를 벗어나야 합니다. codex-image는 Claude Code를 떠나지 않고, API 키 없이 프로덕션 품질의 이미지를 생성합니다.
/codex-image cherry blossom hanok courtyard, golden afternoon light
That's it. One command. / 이게 끝입니다. 명령어 하나.
Prompt: "Elegant minimalist product photography: a single white ceramic coffee cup on dark marble surface, steam rising softly, dramatic side lighting" · 1024x1024 · high quality
Prompt: "An epic fantasy landscape: a massive floating castle in the sky connected by glowing golden chains to mountain peaks below, waterfalls cascading from the floating island, dragon silhouettes circling the towers, bioluminescent flora, magical aurora in the twilight sky" · 1536x1024 · high quality
Prompt: "A breathtaking coastal Mediterranean city at night, white-washed buildings cascading down hillside to a crescent harbor, thousands of warm golden lights reflecting on calm dark blue water, luxury yachts, crescent moon, long exposure photography style" · 1536x1024 · high quality
Prompt: "A lone astronaut standing on the edge of a crater on Mars, looking at Earth rising on the horizon, cinematic composition, volumetric dust particles" · 1024x1536 · high quality
All images above were generated using this skill with
codex exec→ built-inimage_gen→gpt-image-2. No API key was used. OAuth authentication only.위 이미지는 모두 이 스킬로 생성되었습니다. API 키 없이 OAuth 인증만 사용.
We tested every auth path so you don't have to:
우리가 모든 인증 경로를 테스트했습니다:
| Method | Works? | Notes |
|---|---|---|
OPENAI_API_KEY → REST API |
Yes | Standard, but requires API key management |
| OAuth token → REST API directly | No (401) | OAuth tokens are session tokens, not API keys |
OAuth token → codex exec → image_gen |
Yes | This is what codex-image uses |
Codex OAuth tokens are ChatGPT session tokens, not sk-* format API keys. The OpenAI REST API rejects them with HTTP 401. But codex exec has an internal bridge that routes OAuth authentication to the image generation service.
Codex OAuth 토큰은 ChatGPT 세션 토큰이며 sk-* 형식의 API 키가 아닙니다. OpenAI REST API는 401로 거부합니다. 하지만 codex exec는 OAuth 인증을 이미지 생성 서비스로 라우팅하는 내부 브릿지를 가지고 있습니다.
codex login (one-time / 최초 1회)
→ OAuth token stored in ~/.codex/auth.json
→ codex exec reads token automatically
→ Built-in image_gen tool authenticates via OAuth
→ gpt-image-2 generates image
→ Image saved to your project
| Requirement | Command | Note |
|---|---|---|
| Claude Code | Install guide | The host environment / 호스트 환경 |
| Codex CLI | npm install -g @openai/codex |
Image generation engine / 이미지 생성 엔진 |
| Codex Login | codex login |
One-time OAuth via ChatGPT / ChatGPT로 최초 1회 OAuth |
# Verify everything is ready / 설치 확인
codex --version # OpenAI Codex v0.1xx.x
codex login status # "Logged in using ChatGPT"git clone https://github.com/wjb127/codex-image.git ~/.claude/skills/codex-imagegit clone https://github.com/wjb127/codex-image.git .claude/skills/codex-imageAfter installation, the /codex-image command is immediately available in Claude Code.
설치 후 Claude Code에서 /codex-image 명령어를 바로 사용할 수 있습니다.
/codex-image a red apple on white background# Vertical portrait / 세로형
/codex-image --size 1024x1536 futuristic seoul skyline at sunset
# High quality to specific folder / 고품질로 특정 폴더에 저장
/codex-image --quality high --out ./public/images korean hanok with cherry blossoms
# Multiple variations / 여러 변형
/codex-image -n 3 logo variations for a tech startup
# Landscape / 가로형
/codex-image --size 1536x1024 aerial view of jeju island coastline| Flag | Values | Default | Description |
|---|---|---|---|
--size |
1024x1024 · 1024x1536 · 1536x1024 · auto |
1024x1024 |
Image dimensions / 이미지 크기 |
--quality |
low · medium · high · auto |
auto |
Generation quality / 생성 품질 |
--out |
directory path | project root | Save location / 저장 위치 |
-n |
1–10 | 1 |
Number of images / 생성 장수 |
Images are saved with timestamped filenames to prevent overwrites:
이미지는 타임스탬프 파일명으로 저장되어 덮어쓰기를 방지합니다:
codex-image-20260423-143052.png # single image
codex-image-20260423-143052-1.png # multiple: first
codex-image-20260423-143052-2.png # multiple: second
Generated images are displayed inline in Claude Code for immediate review.
생성된 이미지는 Claude Code에서 즉시 확인할 수 있도록 인라인으로 표시됩니다.
┌─────────────────────────────────────────────────────────┐
│ Claude Code │
│ ┌───────────────────────────────────────────────────┐ │
│ │ /codex-image "cherry blossom hanok" │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ Parse args (size, quality, out, n, prompt) │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ codex exec ─────────────────────┐ │ │
│ │ │ │ │ │
│ └───────┼──────────────────────────┼────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌─────────────────────────────┐ │
│ │ OAuth Auth │ │ Built-in image_gen tool │ │
│ │ (auto from │──▶│ Model: gpt-image-2 │ │
│ │ ~/.codex/ │ │ ┌───────────────────────┐ │ │
│ │ auth.json) │ │ │ ~/.codex/ │ │ │
│ └──────────────┘ │ │ generated_images/ │ │ │
│ │ │ <session>/ig_*.png │ │ │
│ │ └───────────┬───────────┘ │ │
│ └──────────────┼───────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────┐ │
│ │ Copy to project │ │
│ │ root / --out dir │ │
│ └──────────────────┘ │
└─────────────────────────────────────────────────────────┘
Writing good prompts makes a huge difference. Here's what works:
좋은 프롬프트가 결과를 크게 바꿉니다. 효과적인 방법:
Scene/backdrop → Subject → Details → Constraints
배경/장면 → 주체 → 디테일 → 제약조건
- Be specific about lighting: "warm golden hour side light" > "good lighting"
- Include camera language: "shallow depth of field", "aerial view", "close-up macro"
- Specify style: "photorealistic", "oil painting style", "3D render", "concept art"
- Add mood/atmosphere: "serene", "dramatic", "moody", "vibrant"
- Mention quality: "8K detail", "high resolution", "ultra detailed"
- Avoid vague prompts: "a nice picture" (too generic)
- Don't overload with contradicting styles
- Skip negative prompts (not supported in gpt-image-2)
| Category | Prompt |
|---|---|
| Product | Elegant perfume bottle on reflective black surface, studio lighting, luxury brand catalog style |
| Landscape | Aerial drone shot of Jeju coastline, turquoise water meeting volcanic rock, golden hour |
| Food | Overhead flat-lay of Korean bibimbap in stone pot, steam rising, vibrant vegetables, dark wood table |
| Architecture | Modern minimalist house with floor-to-ceiling windows overlooking a misty mountain valley |
| Portrait | Professional headshot, soft natural window light, shallow depth of field, neutral background |
| UI/Mockup | iPhone 15 Pro mockup showing a fitness app dashboard, clean UI, dark mode, floating on gradient background |
| Issue | Solution |
|---|---|
NOT_FOUND |
Install Codex: npm install -g @openai/codex |
| Auth expired | Re-login: codex login |
| Trust error | Skill uses --skip-git-repo-check. Or trust project: add to ~/.codex/config.toml |
| Timeout (>2min) | Try --quality low for faster generation |
| 401 on REST API | Expected — OAuth tokens can't call REST API directly. codex exec handles this. |
No image_gen tool |
Update Codex: npm update -g @openai/codex |
Image generation costs are charged to your OpenAI account (via ChatGPT Plus/Team/Enterprise).
이미지 생성 비용은 OpenAI 계정(ChatGPT Plus/Team/Enterprise)에 청구됩니다.
| Size | Quality | Approximate Cost |
|---|---|---|
1024x1024 |
low |
~$0.02 |
1024x1024 |
high |
~$0.04 |
1024x1536 |
high |
~$0.06 |
Refer to OpenAI pricing for current gpt-image-2 rates.
- No API keys stored or transmitted — OAuth only
- No telemetry — no analytics, no error reporting, no tracking
- Images stay local — saved to your project directory, never uploaded anywhere
- Single external connection —
api.openai.comvia Codex CLI only
API 키 저장/전송 없음. 텔레메트리 없음. 이미지는 로컬에만 저장. 외부 연결은 Codex CLI를 통한 api.openai.com 하나뿐.
codex-image/
├── SKILL.md # Claude Code skill definition / 스킬 정의
├── README.md # Documentation / 문서
├── LICENSE # MIT License
├── .gitignore
└── examples/ # Generated sample images / 생성 예시 이미지
├── product-coffee.png (1024x1024, high)
├── fantasy-castle.png (1536x1024, high)
├── coastal-night.png (1536x1024, high)
└── mars-poster.png (1024x1536, high)
- Inspired by daedal — Rust CLI for gpt-image-2 (API key auth)
- Built for Claude Code skill system
- Uses OpenAI Codex CLI for OAuth-authenticated image generation
MIT — see LICENSE