🎨 imagine

"OpenAI API 키? 안 씁니다. ChatGPT 구독으로 끝."

Claude Code 안에서 imagine ... 한 줄이면 이미지가 튀어나옵니다.

---

🔥 왜 이게 화제냐면

매달 ChatGPT Plus $20 내고 있잖아요. 그거 이미 내고 있는데 왜 OpenAI Image API 크레딧을 또 삽니까?

imagine은 여러분이 이미 결제하고 있는 ChatGPT Plus/Pro 세션을 재사용해서, Claude Code 안에서 이미지를 무제한에 가깝게 뽑아냅니다.

• 💸 API 키 0개, 청구서 0원 — Codex OAuth 프록시가 여러분의 ChatGPT 로그인 세션을 그대로 씁니다.
• 🤖 Claude Code × ChatGPT 합법 동거 — Claude로 코딩하다가 "imagine 사이버펑크 도시 3장" 한 마디면 ./images/ 에 결과물이 착.
• 🎯 "imagine"이라고만 말하면 끝 — 프롬프트 엔지니어링 몰라도 스킬이 알아서 size / quality / n 을 매핑합니다.
• 🖼️ text→image 도 되고, image→image 리스타일도 됩니다 — 가지고 있던 사진을 수채화로, 로고를 네온 사인으로.
• 📦 결과물은 프로젝트 안에 — ./images/gpt-img2_<timestamp>_<index>.png 로 깔끔하게 저장. 절대 Downloads 폴더 어지르지 않음.

이 프로젝트는 ktkarchive/codex-imagegen-2-skill-for-kimi (Kimi CLI용) 을 참고하여 Claude Code 플러그인 포맷으로 재구성한 포크입니다. 원작자분께 리스펙트 🙏

---

⚡ 30초 설치

1. Claude Code 마켓플레이스에서 플러그인 설치

# Claude Code 마켓플레이스에서 설치
/plugin marketplace add Mineru98/imagine
/plugin install imagine

끝입니다. 정말로. 두 줄.

2. ChatGPT 한 번만 로그인 (최초 1회)

npx @openai/codex login

브라우저가 열리면 평소 쓰는 ChatGPT 계정으로 로그인하세요. ~/.codex/auth.json 에 세션이 저장됩니다.

3. 요구사항

항목	요구 버전 / 조건
Node.js	≥ 18 (native fetch 사용)
ChatGPT 구독	Plus 또는 Pro (이미지 쿼터가 붙어 있는 플랜)
npx	OAuth 프록시 자동 실행용

---

🎬 써먹는 법

Claude Code 세션 안에서 그냥 자연어로 말해보세요.

/imagine 미래도시의 야경, 네온 반사가 번쩍이는 젖은 거리, 3장 뽑아줘

/imagine 이 사진(./me.png)을 유화 스타일로 바꿔서 저장해줘

스킬이 자동으로:

• 프롬프트 → --prompt
• "3장" → --n 3
• "고퀄" / "detailed" → --quality high
• "세로 포스터" → --size 1024x1536

이렇게 매핑해서 스크립트를 돌립니다.

직접 CLI로 쓰고 싶다면

# text → image
node <skill-root>/scripts/generate.js \
  --prompt "a cyberpunk city at night, neon reflections on wet streets" \
  --quality high \
  --size 1024x1024 \
  --n 2

# image → image (리스타일)
node <skill-root>/scripts/edit.js \
  --input ./photo.png \
  --prompt "turn into a watercolor painting, soft pastels" \
  --out ./images/photo-watercolor.png

---

🧩 imagine 만 있는 게 아닙니다 — 18개 스킬 · 11개 에이전트

이 플러그인에는 용도별로 특화된 스킬 18개와, 그 뒤에서 특정 역할만 맡는 에이전트 11개가 같이 들어 있습니다. 전체 지도·사용 순서·금기는 docs/skills-and-agents.md 한 장으로 정리해뒀습니다.

빠른 요약:

쓰임새	스킬
일반 텍스트→이미지 / 이미지→이미지	imagine
디자인 스크린샷 → HTML+Tailwind	image-to-code
랜딩 히어로 3:2	imagine-hero
발표 섹션 일러스트 세트	imagine-slide
이벤트 포스터/배너/카드 3종	imagine-poster
OG·소셜 카드 (+ --bulk)	imagine-og
YouTube 썸네일 A/B	imagine-thumb
팟캐스트 커버 3000×3000	imagine-podcast
로고 시안 (마크 + 워드마크 + SVG)	imagine-logo
iOS·Android·Web 아이콘 세트	imagine-icon
UI 무드 보드 레퍼런스	imagine-ui
엠프티 스테이트 라이트/다크 쌍	imagine-empty
앱스토어 기기 목업	imagine-mockup
게임 캐릭터 일관 생성	imagine-char
정수 픽셀 아트	imagine-pixel
Unity/Godot 스프라이트 시트	imagine-sprite
seamless 타일 · 큰 배경 패턴	imagine-pattern
인물 사진 로컬 보정 (프라이버시)	imagine-portrait

그리고 뒤에서 같이 움직이는 에이전트들:

• 프롬프트/스타일 보정: prompt-director · style-guardian · visual-critic · character-card-keeper
• image-to-code 파이프라인: vision-analyst → layout-architect · design-token-extractor · asset-extractor · a11y-advisor → code-generator → visual-verifier

각 스킬의 트리거 키워드·출력 경로·금기 규칙은 docs/skills-and-agents.md 참고.

---

⚙️ 조정 가능한 기본값

skills/imagine/config.json 을 고치면 전역 기본값이 바뀝니다.

{
  "default_quality": "medium",
  "default_size": "1024x1536",
  "default_format": "png",
  "output_dir": "./images"
}

키	허용 값
default_quality	low | medium | high
default_size	1024x1024 (1:1) | 1024x1536 (2:3) | 1536x1024 (3:2)
default_format	png | jpeg | webp
output_dir	아무 경로 (절대경로면 글로벌 수집함으로 사용 가능)

---

🧠 동작 원리 (궁금한 분만)

Claude Code
    ↓ "imagine ..." 스킬 트리거
generate.js / edit.js
    ↓ spawn
npx openai-oauth --port 10531   ← ChatGPT 세션 토큰으로 OpenAI API 프록시
    ↓ HTTP
OpenAI gpt-image 엔드포인트
    ↓ PNG stream
./images/gpt-img2_<ts>_<i>.png  ← 자동 저장 + PNG 무결성 검증

프록시는 요청이 끝나는 즉시 자동 종료됩니다. 백그라운드 프로세스 안 남깁니다.

---

🧯 트러블슈팅

증상	해결
No OAuth session found	npx @openai/codex login 다시 실행
Proxy did not respond	lsof -ti:10531 | xargs kill -9 로 포트 비우고 재시도
401 / 403	세션 만료 — 다시 로그인
Rate limit	ChatGPT 티어 한도 초과 — 몇 분 쉬고 --n 줄이기

더 자세한 내용은 skills/imagine/reference/installation.md 참고.

---

🙏 Credits

• 원작: ktkarchive/codex-imagegen-2-skill-for-kimi — Kimi CLI 용 Codex 이미지 생성 스킬. 이 저장소는 해당 스킬의 아이디어와 구조를 참고하여 Claude Code 플러그인 포맷으로 재패키징했습니다.
• OAuth 프록시: openai-oauth
• Codex CLI: @openai/codex

---

📜 License

MIT © Mineru

---

⭐ 도움이 됐다면 레포지토리에 스타 한번만 눌러주세요.

Claude로 코딩 → imagine 한 줄 → 썸네일까지 뽑기. 워크플로우가 끊기지 않습니다.