用途:在用户要求生成或编辑图像,且明确提到 codex-image、希望使用 ChatGPT 配额,或已存在 codex 登录(~/.codex/auth.json)并想避免使用 OPENAI_API_KEY 时调用。不适用于已设置 OPENAI_API_KEY 并想直接使用、需要 Google/Gemini/Adobe 等其它厂商模型,或纯本地背景移除的场景。
主要能力:通过 OpenAI Responses API 的 image_generation 托管工具生成或编辑图像,复用 ChatGPT 订阅,无需 API Key。
使用方式: codex-image generate "<prompt>" [--output-format png|webp|jpeg] [--out PATH] [--force] codex-image edit --input REF1.png [--input REF2.png ...] "<prompt>" [--out PATH] [--force] codex-image login codex-image logout codex-image status 运行 codex-image --help 查看完整参数。
认证:读取 $CODEX_HOME/auth.json(默认 ~/.codex/auth.json),令牌临近过期时刷新;文件缺失或刷新失败时启动 PKCE OAuth 浏览器流程(绑定 127.0.0.1:1455,回退 :1457),成功后写入 auth.json。
输出:默认写入 $CODEX_HOME/generated_images/codex-image/<UTC>-<slug>.<ext>,文件模式 0o644,可用 --out 指定路径。
退出码:0 成功;2 用户输入错误;3 文件系统错误;4 认证/套餐错误(HTTP 403);5 网络/限流错误;6 部分成功;7 API 业务错误;130 用户中断。
限制:非官方技能,使用前应阅读 LEGAL.md。提示词指南见 references/prompting.md,与 imagegen 技能兼容。其它细节暂未提供。