---
name: gpt-image
description: 需要圖片時（情境插畫、示意圖、封面、背景、圖文選單底圖），用本機 Codex CLI 呼叫 GPT 生圖（gpt-image-2），並存進專案資料夾。使用者說「用 GPT 生圖」「圖片找 GPT」「幫我配圖」「需要插畫」時使用。品牌 logo、官方徽章、後台真實截圖不可用這個方法生成。
---

# 用 GPT 生成圖片（透過 Codex CLI）

## 前置（每台電腦只要做一次，由 Claude 執行，使用者不用打指令）
1. 找 Codex：先試 `codex --version`。找不到就到 ChatGPT 桌面版裡搜尋內建的 Codex：
   `find /Applications/ChatGPT.app -type f -name codex -perm -u+x 2>/dev/null`
   會找到兩個，用 `…/codex-cli/bin/codex`（命令列入口），以完整路徑執行並記下來。
2. 都沒有才安裝：有 Node.js 就 `npm install -g @openai/codex`；沒有就請使用者安裝 ChatGPT 桌面版（https://chatgpt.com/download/ ），裡面內建 Codex。官方安裝檔 `install.sh` 中途會問問題，不適合由 Claude 執行。
3. 檢查登入：以 `codex login status` 顯示 `Logged in using ChatGPT` 為準（在 ChatGPT 桌面版登入過通常已經登入）。
   沒登入：在背景執行 `codex login --device-auth`，把網址和代碼轉給使用者（15 分鐘內有效，過期重跑），等使用者說好了再確認。網頁說不能用代碼登入時，改在背景執行 `codex login`（會開瀏覽器登入頁）。
4. 確認 `codex features list` 裡 `image_generation` 是 `true`；是 `false` 就執行 `codex features enable image_generation`。需要 ChatGPT Plus 以上，免費版不能生圖。

## 生圖步驟
1. 決定輸出資料夾，例如 `<專案>/_素材/gpt/`，在裡面寫 `prompt.txt`：
   - 開頭固定寫：「請使用你的圖片生成工具（image generation）產生以下 N 張圖，存成目前資料夾下的 PNG（檔名如下），完成後回報每張的路徑與尺寸。」
   - 用途：這些圖要放在哪裡、給誰看。
   - 風格：例如「扁平向量編輯插畫，乾淨線條＋平塗色塊」。
   - 配色：直接寫色碼。
   - 人物：臉部極簡（五官省略）、同一角色每張造型一致；不要寫實人像。
   - 一定要寫：「所有畫面都不要出現任何可讀文字、字母、數字、logo」。
   - 逐張列出：檔名、尺寸（1536x1024 橫式／1024x1024 方形／1024x1536 直式）、畫面內容。
2. 在背景執行（每張約 1 分鐘，不要讓對話卡住）：

   ```bash
   cd "<輸出資料夾>" && codex exec --skip-git-repo-check -s workspace-write -C "<輸出資料夾>" - < prompt.txt > codex_log.txt 2>&1
   ```

3. 完成後逐張打開檢查：有沒有冒出文字、手指或臉部怪異、配色跑掉、角色不一致。
   不合格的只重生那幾張：新的 prompt 只列那幾張，檔名加 `-v2`，不要覆蓋原檔。
4. 放進網頁或簡報前，轉成 1200px 寬的 WebP 或 JPG，減少檔案大小。

## 規則
- 中文字不要讓 GPT 畫（常寫錯字）。文字用 HTML 或簡報文字框疊上去。
- 品牌 logo、認證徽章、Omnichat 後台畫面：一律用官方原圖或 docs.omnichat.ai 的真實截圖，不可生成。
- 要同一角色連貫：在 prompt 寫「以 xxx.png 當角色參考」，並把參考圖放在同一個資料夾；也可以直接附上參考圖，`-i` 要緊接在 `exec` 後面：`codex exec -i xxx.png --skip-git-repo-check -s workspace-write -C "<輸出資料夾>" - < prompt.txt`
- 生圖會用掉 ChatGPT 方案的 Codex 額度（官方說明：約為一般對話的 3–5 倍）。一次要生上百張時，改設定 `OPENAI_API_KEY` 走 API 計費。