Claude Code skill · MIT

在 Claude Code 裡生圖
吃你的 ChatGPT 訂閱額度

一個小小的 skill,把生圖跟多圖編輯請求導到 Codex CLI 的 $imagegen, 用你既有的 ChatGPT Plus / Pro 配額去畫圖——不必再為 OpenAI Images API 額外掏錢。

1為什麼需要這個

你已經在付 ChatGPT 訂閱了。你也裝了 Codex CLI。Codex CLI 內建了一個 $imagegen 工具可以生圖。那麼,當你想在 Claude Code 裡讓 AI 幫你生一張圖時, 為什麼還要再花錢去買 OpenAI Images API 的 credits?

這個 skill 就是 Claude Code 和 Codex CLI 中間的橋——Claude 負責寫 prompt, skill 在底層呼叫 codex exec '$imagegen ...',PNG 就落到你指定的位置。 一張圖大約 40–70 秒,相對於訂閱費**沒有額外成本**。

2它能生出什麼樣的圖

這幾張都是同一個腳本生的,共用一段 pastel 插畫風格 prompt,每張再加上專屬的概念描述。 實測 batch 處理 26 張完全沒問題。

3不裝 skill,直接用 Codex 可以嗎?

當然可以。如果你完全不需要 Claude Code 在中間,那直接打 $imagegen 就好:

# 互動式
codex
> $imagegen 一隻戴紅領結的柴犬,水彩,不要文字

# 非互動式(一行從 shell 打)
codex exec -C "$(pwd)" -s workspace-write --skip-git-repo-check \
  '$imagegen 一隻戴紅領結的柴犬,水彩,不要文字'

PNG 都會落在 ~/.codex/generated_images/<session-id>/ig_*.png。這個 skill 存在的意義是把非互動模式自動化——你要解析 codex 的 stdout 找 session id、定位 PNG、複製出來、還要繞過 codex 自己的 bwrap sandbox 把 cp 吃掉的問題,這些都包好了。

支援版本:$imagegenCodex CLI v0.117.0(2026-03-26) 開始正式變成 built-in skill;v0.123.0(2026-04-23)升級到 gpt-image-2。 用 npm i -g @openai/codex 更新到最新。

4安裝

前置:已安裝 Codex CLIcodex login 過。

# 把 repo 直接 clone 進你的 Claude Code skills 目錄
git clone https://github.com/yazelin/codex-imagegen-skill ~/.claude/skills/codex-imagegen
chmod +x ~/.claude/skills/codex-imagegen/codex-imagegen.sh

重啟 Claude Code,codex-imagegen skill 就可以用了。

5驗證

在 Claude Code 裡,直接這樣請求:

幫我生一張水彩風格、戴紅色領結的小柴犬,
存到 /tmp/test-shiba.png

或從 shell 直接跑內附腳本(純生圖、2 個參數):

~/.claude/skills/codex-imagegen/codex-imagegen.sh \
  "a tiny shiba inu with a red bow tie, watercolor, no text" \
  /tmp/test-shiba.png

6多圖編輯 · 新功能

1–4 張參考圖當尾巴位置參數塞給腳本,就能做 composition(合成)/ outfit-swap(換裝)/ scene-merge(場景合併)/ style-transfer(風格轉換)/ text-localization(文字本地化)。腳本會自動組出 gpt-image edit mode 認得的 canonical scaffolding(Use case: image-edit / Input images: Image 1: … / Image 2: …),並對每張參考圖 emit 一個 --image flag 進 codex exec

# 合成:把第一張的主體放進第二張的場景
~/.claude/skills/codex-imagegen/codex-imagegen.sh \
  "place the subject from image 1 into the scene from image 2; match lighting and perspective" \
  /tmp/composite.png \
  ~/Pictures/person.png \
  ~/Pictures/kitchen.png

# 換裝:兩件衣服 reference
~/.claude/skills/codex-imagegen/codex-imagegen.sh \
  "replace the clothing on image 1 with the garment from image 2 and the shoes from image 3; preserve face, body, and pose" \
  /tmp/outfit.png \
  ~/Pictures/model.png \
  ~/Pictures/jacket.png \
  ~/Pictures/shoes.png

多圖 prompt 要用 image 1 / image 2 / … 來指稱每張圖在合成裡的角色。常見用例:

4 張的上限是實作上的保守預設——gpt-image 本身吃得更多,但實測 2-3 張組合品質最好。真有需要可以直接改 script 裡的上限。

7裝箱內容

SKILL.md

給 Claude 讀的觸發 + 用法文件。包含什麼時候用、什麼時候不用、prompt 怎麼寫。

codex-imagegen.sh

獨立的 wrapper。2 個參數做純生圖;尾巴塞 1–4 張參考圖就變多圖編輯。自動定位輸出 PNG、複製到你指定的位置。

跨平台

Linux、macOS、WSL 都跑得起來。檔案複製在 host shell 做,繞過 Codex 自己的 bwrap sandbox 問題。

誠實標註限制

僅供個人 / 開發用途。請勿把這個拿去當 production 多人服務的後端——那違反訂閱條款的精神。