用 Codex 生成图片（gpt-image-2 / gpt-image-2.5）

codexzh-image 是 CodexZH 提供的画图技能，装好后可以在 Codex 里文生图、图生图（改一张已有的图）和局部重绘，支持 gpt-image-2 和 gpt-image-2.5 两个模型。

费用说明： 生成图片按次从周额度中扣除，具体金额以控制台用量明细为准，各模型价格见支持的模型说明。

⚠️ 风险提示： 这种方式由 Agent 自己调用接口。它生成完会自己检查，觉得不合适就重新生成，所以你只提了一个需求，使用记录里可能有好几条调用。

另外，图片可能已经生成成功，Codex 却等待超时、以为失败了。这时后台正常扣费，但图片没有返回给你。

介意这两种情况的话，改用 AI HUB API 网页生图，一次请求对应一张图。

🔑 使用前请先放开权限： Codex 的沙盒默认是「只读」，不允许命令联网，直接生图大概率会失败，提示「沙盒内无法解析 api.codexzh.com」或审核服务返回 503。生图前先在聊天界面把权限切成「完全访问权限」，或在设置 →「配置」→「沙盒设置」里改成完全访问。图示见常见问题。

安装技能

下载技能包，解压到客户端的技能目录（Codex 是 ~/.agents/skills/，Claude Code 是 ~/.claude/skills/）：

• 下载「图片生成与编辑」技能

详细步骤、API Key 配置和「让 AI 自己装」的提示词见 Agent 技能安装。

新版技能有什么不一样

技能脚本改用 Node 实现，macOS、Linux 和 Windows 用同一份代码，不用再区分平台，参数校验和错误提示也更准确。安装只需解压一个压缩包，不用再手动创建文件。

开始使用

放好技能后重启 Codex，输入 /image 选择 codexzh-image 技能，再描述你想要的图片。也可以不输命令，直接说「帮我画……」，Codex 会自己调用这个技能。效果如下：

切换到 gpt-image-2.5

技能默认用 gpt-image-2。想用 gpt-image-2.5，在描述里写明模型即可：

用 gpt-image-2.5 画一只戴贝雷帽、坐在木桌上的小水獭，柔和光线

改图时也一样：

用 gpt-image-2.5 把这张图的背景换成下雪的雪山          （附上图片路径）

两个模型都支持文生图、图生图和局部重绘，价格不同，以控制台用量明细为准。

生图失败怎么办

提示「沙盒内无法解析 api.codexzh.com」或「审核服务返回 503」，是 Codex 沙盒权限的问题，解决办法见常见问题。

提示「未找到 CodexZH API Key」「无效的令牌」等，见 Agent 技能安装 · 常见问题。