跳到主要内容

ChatGPT / Codex 客户端「生图不显示」修复

适用于：最新版 ChatGPT 桌面客户端 / Codex 客户端（含 Windows 上俗称「Q 版」的最新包）。

现象​

  • 让它生图，文字提示词、回复都正常
  • 模型说「已生成」
  • 对话里不显示图片
  • 本机 generated_images 目录也可能没有文件
  • 不报错，或只显示空图 / 破图占位
这不是额度问题

多数情况是本机客户端配置问题，不是鹊桥欠费、也不是令牌失效。

原因（一句话）​

新版客户端生图走 本机 image_gen 执行器。 如果你的中转 Provider 仍是 requires_openai_auth = true，客户端就不会给第三方中转挂本地生图能力 → 模型以为成功，界面却不出图。

一键修复（按顺序做，约 3 分钟）​

第 1 步：找到配置文件​

系统路径
Windows%USERPROFILE%\.codex\config.toml
macOS / Linux~/.codex/config.toml

Windows 最快打开方式：

  1. 按键盘 Win + R
  2. 粘贴下面这一行，回车：
%USERPROFILE%\.codex
  1. 用记事本打开里面的 config.toml （没有这个文件 → 先正常打开过一次 Codex/ChatGPT 客户端再找）

第 2 步：改你正在用的 Provider​

在文件里找到你的中转站配置段，名字可能是 OpenAI / queqiao / 自定义名，类似：

[model_providers.你的Provider名]

改成下面这样（只改关键几行，base_url 和名称按你自己的保留）：

[model_providers.你的Provider名]
name = "你的Provider名"
base_url = "https://5202828.xyz/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }

如果文件里已有 [features] 段，建议补上：

[features]
image_generation = true

如果没有 [features]，可以在文件末尾直接加上面这段。

注意这三点
  1. requires_openai_auth = false 不会关掉 API Key 鉴权，auth.json 里的 key 不要删
  2. 只改本机配置，不用改服务器
  3. base_url 请保持鹊桥地址：https://5202828.xyz/v1（必须带 /v1）

第 3 步：彻底重启（很关键）​

  1. 完全退出 ChatGPT / Codex 桌面端 （托盘图标也要退出，不要只关窗口）
  2. 如果 VS Code / Cursor 里也开着 Codex 会话，一并关掉
  3. 重新打开客户端
  4. 新建一个会话（旧会话不会重新加载工具表）
  5. 再试：生成一只橘猫的图片

第 4 步：怎样算成功​

  • 对话里能直接看到图
  • 本机出现文件：
    • Windows：%USERPROFILE%\.codex\generated_images\...
    • macOS/Linux：~/.codex/generated_images/...

完整示例（可直接对照）​

假设你的 Provider 名叫 queqiao：

[model_providers.queqiao]
name = "queqiao"
base_url = "https://5202828.xyz/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }

[features]
image_generation = true

保存 → 彻底退出 → 新建会话 → 再试生图。

还不行？按这个清单排查​

A. 用了 CPA / CC-Switch / 路由增强，并开了「图片生成」​

社区高频坑：第三方工具再注册一套生图工具，会和 Codex 自带工具冲突。

常见报错：

Invalid Value: 'tools'. Function 'image_gen.imagegen' conflicts with a hosted tool

处理：

  1. 打开 CPA / 相关增强工具
  2. 关闭「图片生成」能力
  3. 保存
  4. 重启 Codex
  5. 只保留 Codex 自带生图

B. 改完配置但仍在旧会话里试​

必须：

  • 进程杀干净
  • 新建 thread / 新对话
  • 不要在旧对话继续试

C. 客户端版本本身有 bug​

官方侧也曾出现：日志里已有完整 base64 图，但 status 卡在 generating，结果不落盘、不展示。

临时止血：

  • 回退 Codex CLI 到 0.142.5 附近再试；或
  • 先用网页端 / 站内在线绘图通道

D. 图其实生成了，只是界面没展示​

如果会话 JSONL 里已有 image_generation_call.result（base64 有内容），说明上游已出图，只是 UI 没挂上。 可先按上面 A/B 步骤处理；仍不行再联系客服并说明「日志里有图数据但不展示」。

客服可复制话术​

你好，这个是新版 ChatGPT/Codex 客户端的配置问题，不是额度没了。

请按下面改本机配置：
1. 打开 %USERPROFILE%\.codex\config.toml
   （Mac/Linux 是 ~/.codex/config.toml）
2. 把你用的 provider 改成：
   requires_openai_auth = false
   http_headers = { "x-openai-actor-authorization" = "local-image-extension" }
3. 如果有 features，加 image_generation = true
4. 完全退出客户端，新建会话再试生图

如果用了 CPA/CC Switch，请先关掉它的「图片生成」，只保留 Codex 自带生图。

详细图文：https://readme.5202828.xyz/codex/image-fix

和 CC-Switch 的关系​

场景建议
用 CC-Switch 管理供应商先确认启用的是鹊桥配置；若 CC-Switch 会重写 config.toml，改完后检查上述两行是否被覆盖
手改 config.toml改完后暂时不要让其它工具「一键覆盖」配置
只聊天、不生图可不改；生图异常再按本页处理

相关页面​