主题
Codex 画图
在 Codex 对话里直接说「画一张……」,图片会显示在对话里,同时保存到本地。桌面版、CLI、IDE 插件读的是同一份配置,配好一次都能用。
效果
- 用 Codex 自带的画图工具出图,图片直接显示在对话中
- 图片自动保存到
~/.codex/generated_images/(Windows 为C:\Users\用户名\.codex\generated_images\) - 支持改图:附上一张图片,说明要改哪里即可
- 画图按张单独计费,对话本身照常按 token 计费,两者在使用日志里各占一条
配置
打开 ~/.codex/config.toml,把本站的 provider 改成下面这样(sk-*** 换成你的令牌):
toml
model_provider = "wow3_codex"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
supports_websockets = false
[model_providers.wow3_codex]
name = "wow3_codex"
base_url = "https://api.wow3.top/v1"
wire_api = "responses"
http_headers = { "x-openai-actor-authorization" = "wow3" }
experimental_bearer_token = "sk-***"保存后完全退出并重启 Codex,再新开一个对话。
和常规配置相比,有三处不同,缺一不可:
| 配置项 | 说明 |
|---|---|
http_headers = { "x-openai-actor-authorization" = "wow3" } | 打开 Codex 自带画图工具的开关。值填任意非空内容即可 |
experimental_bearer_token = "sk-***" | 令牌直接写在这里,不再从 auth.json 读取 |
删掉 requires_openai_auth = true | 有这一行时,Codex 会认为画图必须登录 OpenAI 账号,画图工具不会出现 |
两处容易漏掉的旧配置
- 如果之前按疑难解答在
[features]里加过image_generation = false,要删掉这一行,否则画图功能是关着的。 experimental_bearer_token是明文写在配置文件里的,不要把config.toml发给别人或传到网上。
使用
直接用自然语言描述:
text
给我画一张 Q 版的小猫,暖色调,适合做头像改图时把图片拖进对话,再说明要改的地方:
text
把这张图的背景换成夜晚的星空,其他保持不变一张图通常要几十秒到两三分钟,期间对话里会显示「正在生成」,耐心等待即可。
尺寸、质量和文件名
Codex 自带画图工具不提供尺寸、质量参数,也不能指定文件名:
- 尺寸:写进描述里,例如「横版 16:9」「竖版手机壁纸」
- 文件名:图默认存成
.png,名字是一串编号;需要的话让模型「把图另存为cat.png」,它会复制一份过去
常见问题
模型说「没有设置 OPENAI_API_KEY,无法生成图片」,或者改画成 SVG
说明画图工具没有启用,模型找不到它。依次检查:
config.toml里是否还留着requires_openai_auth = true(删掉)- 是否有
http_headers = { "x-openai-actor-authorization" = "..." },值不能为空 [features]里是否有image_generation = false(删掉)- 是否完全退出后重启了 Codex,并新开了对话
~/.codex/skills/下是否有旧版的imagegen技能。旧版技能会要求本地OPENAI_API_KEY,会把模型带偏。把这个目录移到别处即可,Codex 自带的同名技能不受影响
用 cc-switch 切换配置后,画图又不行了
cc-switch 切换供应商时会重写 config.toml,可能把 requires_openai_auth = true 加回来、把 http_headers 去掉。切换后打开文件核对上面三处配置。
装了其他画图技能,模型不用自带画图工具
旧版的 WOW3 画图技能 描述是「有画图需求就用」,会抢在自带工具前面。这类技能出的图不会显示在 Codex 对话里。
重新下载新版技能包覆盖即可,新版在 Codex 里只在明确点名 WOW3 时才启用。其他画图技能同理,把 SKILL.md 开头的 description 改成只在明确点名时使用,例如:
text
description: Use ONLY when the user explicitly asks to use WOW3. For ordinary image generation requests, use the built-in image_gen tool instead.报错 401 Unauthorized
令牌写错或已失效。检查 experimental_bearer_token 的值,改完重启 Codex。
图片保存在哪?
~/.codex/generated_images/ 下,按会话分目录存放。对话里模型一般也会告诉你具体路径。

