用途：为没有内置图像生成能力的 Claude Code 提供出图能力，做法是把请求经由 Bash 委托给 Codex CLI 的 image_gen.imagegen 工具（由 gpt-image-2 驱动），生成结果再由 Claude Code 读取展示。链路为 Claude Code → codex exec（Bash）→ image_gen.imagegen → 图片文件 → Claude Code 读取。
前置检查：先运行 codex --version 2>/dev/null 确认已安装；未安装则提示 npm install -g @openai/codex。再用 codex features list 2>/dev/null | grep image_generation 检查认证，未登录需用户交互执行 codex login。
核心命令模式：codex exec --json --skip-git-repo-check --ephemeral -o /tmp/codex-imagegen-lastmsg.txt "<提示词>"。各参数含义：--json 输出 JSONL 事件流；--skip-git-repo-check 允许在非 git 目录运行；--ephemeral 不持久化会话；-o 写出 Codex 最后一条文本消息。
使用要点：提示词必须点名 image_gen.imagegen，否则 Codex 可能自行写代码；需给出明确输出路径（如 /tmp/my-image.png）并让 Codex 复制结果。建议在提示词中写清风格、构图、光线与约束，图上文字要逐字给出。生成通常耗时 15–60 秒，Bash 超时应设为 180000ms（3 分钟）。完成后用 ls -lh 检查目标文件；若缺失可查默认目录 ~/.codex/generated_images/。国内环境可在命令前加 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 环境变量。
透明背景：先让 Codex 在纯色 #00ff00 背景出图，再用其自带脚本 remove_chroma_key.py 在本地去背（需 Pillow，macOS 系统 Python 可用临时 venv）。毛发、玻璃、烟雾等复杂边缘效果不佳时，需改用 Codex CLI 的 gpt-image-1.5 回退方案，且要单独设置 OPENAI_API_KEY。也支持编辑已有图片（可能需先 view_image）与批量生成，批量时在一条提示词中列出多个目标并先建目录。
限制：消耗 Codex/OpenAI 账户配额；无法从 Claude Code 精细控制尺寸（默认 auto/1024x1024）；image_gen 调用在 JSONL 中不可见；编辑需多一步“查看”；每次 codex exec 均为无状态调用，会话间无历史。费用与具体价格暂未提供。