Appearance
用 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.jsonpowershell
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 会自己调用这个技能。效果如下:

切换到 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,整个流程就卡在这一步,实际并没有调用生图模型,也不会产生扣费。
把权限放开就能跑通,两种方式任选一种:
- 在聊天界面切换(推荐):点输入框左下角的权限按钮,选「完全访问权限」(仅对当前会话生效,用完可切回)。

- 改默认沙盒设置:打开 Codex 设置 →「配置」→「沙盒设置」,把「只读」改成完全访问(之后新建的会话默认生效)。

提示「未找到 CodexZH API Key」或「无效的令牌」
- 未找到 CodexZH API Key:Key 没配,或配置文件路径不对。按上面的 配置 API Key 写入
~/.codexzh/config.json(注意是.codexzh,不是.codex),然后重启 Codex。 - 无效的令牌:Key 填错了或已经轮换过,到 控制台 重新复制,改好配置文件后重启 Codex。
其他问题见 Agent 技能安装 · 常见问题。