用途：在终端中用本机已登录的 ChatGPT/Codex 凭证生成和编辑图片。它复用 Codex CLI 存储于 ~/.codex/auth.json 的 OAuth token，直连 ChatGPT 的 Codex 后端，无需 API key、代理或服务器。
主要能力：支持文生图（gpt-image gen）与图生图编辑（gpt-image edit -i，可多图、可加 --mask）；每次生成保存为 6 字符 id 的图片并返回绝对路径，JSON 信封内含 result、error、next_action 和 schema_version。CLI 内置 GENERATE→READ→CRITIQUE→REVISE 循环：生成后须读取图片再决定修改，接近达标时用 edit 改一处并重申不变项，概念错误则重写提示词重新生成。可通过 next_action.command 获取下一步命令，也可用 doctor 检查登录与 token（不消耗额度）。
使用方式：前置条件是已登录 Codex CLI，~/.codex/auth.json 存在；需要 python3（>=3.7），无第三方 pip 包。先运行 scripts/install.sh 安装 gpt-image 到 ~/.local/bin，若不在 PATH 可直接调用 scripts/gpt-image。常用命令：gpt-image "<prompt>"、gpt-image gen "<prompt>" [opts]、gpt-image edit -i <img> "<prompt>" [--mask <m>]、gpt-image doctor。选项含 -r/--ratio（1:1、3:2、2:3、auto）、--size WxH、-q/--quality、-o/--outdir、-m/--model、--auth <path>、--max-wait <s>（默认 60，最大 300，0 关闭）；支持 GPT_IMAGE_RATIO、GPT_IMAGE_QUALITY、GPT_IMAGE_OUTDIR、GPT_IMAGE_MODEL、GPT_IMAGE_MAX_WAIT 环境变量。ratio 与 size 对应：1:1=1024x1024，3:2=1536x1024，2:3=1024x1536，auto 由模型选择。写提示词前须先读 references/prompting.md 及其四个分支（generate、edit、variants、parameters）。
适用场景：终端内的图片生成与迭代编辑，包括信息图、写实图、logo、广告、漫画、UI 稿、科学图、幻灯片、贺卡、周边、翻译、风格迁移、试穿、草图渲染、产品图、图内文字、重打光、移除、合成、室内替换、角色一致性等。
限制：需已登录 Codex；缺少登录会返回 error.class:"auth"，提示 codex login。账户无图片权限返回 4 not_found。存在两层限流：每分钟短时限流由 CLI 自动等待重试（受 --max-wait 约束），账户计划窗口（5 小时与每周）在 result.usage_limits 中报告；若仍返回 7 RATE_LIMITED，需按 retry_after_seconds、plan_reset_at 等待而不是反复调用。CLI 不会修改 ~/.codex/auth.json，刷新的 token 缓存在 ~/.config/gpt-image/token.json。退出码：0 成功、2 用法、3 认证、4 未找到、6 校验、7 暂时性、1 其他。定价与具体收费暂未提供。