Skip to content

用 Codex 生成图片(gpt-image-2 / gpt-image-2.5) ​

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

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

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

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

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

安装技能 ​

下载技能包,解压到客户端的技能目录(Codex 是 ~/.agents/skills/,Claude Code 是 ~/.claude/skills/):

解压后的目录结构、常见错误和「让 AI 自己装」的提示词见 Agent 技能安装。

新版技能有什么不一样

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

配置 API Key ​

技能需要用你的 CodexZH API Key 调用生图接口。没配 Key 就去生图,会报「未找到 CodexZH API Key」或「无效的令牌」。

API Key 在 CodexZH 控制台复制,以 sk- 开头。推荐写进配置文件,Codex App、CLI 和插件都能读到:

bash
mkdir -p ~/.codexzh
cat > ~/.codexzh/config.json <<'JSON'
{
  "apiKey": "sk-你的密钥"
}
JSON
chmod 600 ~/.codexzh/config.json
powershell
New-Item -ItemType Directory -Force "$HOME\.codexzh" | Out-Null
[IO.File]::WriteAllText("$HOME\.codexzh\config.json", '{ "apiKey": "sk-你的密钥" }')

把 sk-你的密钥 换成你自己的 Key,前后不要多带空格。不想用命令行的话,也可以手动在用户主目录下新建 .codexzh 文件夹,在里面新建 config.json,写入上面的内容。Windows 用记事本保存时,编码选「UTF-8」,不要选「带有 BOM 的 UTF-8」,否则技能读不到 Key。

也可以改用环境变量 CODEXZH_API_KEY,写法见 Agent 技能安装 · 第 4 步。Mac 上从程序坞打开的 Codex App 不会读取 ~/.zshrc 里的环境变量,所以更推荐配置文件。

什么情况下可以不配

技能找 Key 的顺序是:环境变量 CODEXZH_API_KEY → ~/.codexzh/config.json → ~/.codex/.env。

只有 ~/.codex/.env 里同时有 api_key,且 base_url 指向 codexzh,技能才会自动复用。Key 写在 auth.json 或 config.toml 里的不会被读取,仍然要按上面配一次。

配好后重启 Codex再生图。

开始使用 ​

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

codexzh-image 技能调用效果

切换到 gpt-image-2.5 ​

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

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

改图时也一样:

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

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

生图失败怎么办 ​

提示「沙盒内无法解析 api.codexzh.com」或「审核服务返回 503」 ​

沙盒权限不足导致生图失败

这不是密钥或配置的问题。Codex 的沙盒默认是「只读」,不允许命令直接联网,技能里的接口请求发不出去;Codex 转而向官方审核服务申请临时联网权限时又碰上 503,整个流程就卡在这一步,实际并没有调用生图模型,也不会产生扣费。

把权限放开就能跑通,两种方式任选一种:

  1. 在聊天界面切换(推荐):点输入框左下角的权限按钮,选「完全访问权限」(仅对当前会话生效,用完可切回)。 在聊天界面选择完全访问权限
  2. 改默认沙盒设置:打开 Codex 设置 →「配置」→「沙盒设置」,把「只读」改成完全访问(之后新建的会话默认生效)。 在设置里把沙盒改成完全访问

提示「未找到 CodexZH API Key」或「无效的令牌」 ​

  • 未找到 CodexZH API Key:Key 没配,或配置文件路径不对。按上面的 配置 API Key 写入 ~/.codexzh/config.json(注意是 .codexzh,不是 .codex),然后重启 Codex。
  • 无效的令牌:Key 填错了或已经轮换过,到 控制台 重新复制,改好配置文件后重启 Codex。

其他问题见 Agent 技能安装 · 常见问题。