Skip to content

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 账号,画图工具不会出现

两处容易漏掉的旧配置

  1. 如果之前按疑难解答在 [features] 里加过 image_generation = false,要删掉这一行,否则画图功能是关着的。
  2. experimental_bearer_token 是明文写在配置文件里的,不要把 config.toml 发给别人或传到网上。

使用 ​

直接用自然语言描述:

text
给我画一张 Q 版的小猫,暖色调,适合做头像

改图时把图片拖进对话,再说明要改的地方:

text
把这张图的背景换成夜晚的星空,其他保持不变

一张图通常要几十秒到两三分钟,期间对话里会显示「正在生成」,耐心等待即可。

尺寸、质量和文件名

Codex 自带画图工具不提供尺寸、质量参数,也不能指定文件名:

  • 尺寸:写进描述里,例如「横版 16:9」「竖版手机壁纸」
  • 文件名:图默认存成 .png,名字是一串编号;需要的话让模型「把图另存为 cat.png」,它会复制一份过去

常见问题 ​

模型说「没有设置 OPENAI_API_KEY,无法生成图片」,或者改画成 SVG ​

说明画图工具没有启用,模型找不到它。依次检查:

  1. config.toml 里是否还留着 requires_openai_auth = true(删掉)
  2. 是否有 http_headers = { "x-openai-actor-authorization" = "..." },值不能为空
  3. [features] 里是否有 image_generation = false(删掉)
  4. 是否完全退出后重启了 Codex,并新开了对话
  5. ~/.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/ 下,按会话分目录存放。对话里模型一般也会告诉你具体路径。