请求已经完成，图片却没有出现在 Codex App 中
使用第三方 API 时，Provider 通常会设置 requires_openai_auth = false。在部分新版 Codex App 中，这会让本地图片生成工具保持关闭：上游可能已经完成生成，但客户端没有接管图片、保存文件并显示预览。
在当前 Provider 配置中加入一个非空的 x-openai-actor-authorization 请求头，然后完全重启 Codex App。
确认你遇到的是“客户端不显示”
这个修复针对的是一类很具体的现象。先核对表现，再决定是否修改配置。
- 普通文字对话可以正常完成
- 使用的是自定义 Provider 或第三方 API
- 生图任务像是已经完成，但对话里没有图片预览
- Provider 配置包含
requires_openai_auth = false
- 请求直接返回
401、403或 API Key 错误 - 模型或接口返回
404、5xx - 普通文字请求也无法完成
- 第三方服务本身没有图片生成能力
找到并备份 config.toml
先完全退出 Codex App，再打开配置文件。保留一份备份，出现 TOML 格式问题时可以立即恢复。
~/.codex/config.toml%USERPROFILE%\.codex\config.toml例如复制为 config.toml.backup。确认新配置可用后，也可以继续保留这份备份。
把非空请求头放进当前 Provider
找到正在使用的 [model_providers.xxx] 段落，在同一个段落中加入下面一行。请求头的值只要非空即可，建议使用清楚、无敏感信息的固定标记。
http_headers = { "x-openai-actor-authorization" = "codex-image-enabled" }完整 Provider 示例展开核对
把示例中的 Provider 名称和地址替换为自己的实际配置。已有的模型设置可以继续保留。
model_provider = "your-provider"
[model_providers.your-provider]
name = "Your Provider"
base_url = "https://your-api.example.com/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "codex-image-enabled" }同一个 Provider 中只保留一个 http_headers。把新键值加入现有的花括号中，避免重复声明导致 TOML 解析失败。
完全重启，再做一次最小生图测试
- 1保存 config.toml
确认引号、花括号和 Provider 段落位置完整。
- 2完全退出 Codex App
结束应用进程后重新打开，让客户端重新读取配置。
- 3新建一个测试任务
先用简单要求验证展示链路，减少模型和提示词变量。
- 4检查图片预览
对话中出现图片，并能正常打开或保存，说明本地展示链路已经恢复。
生成一张 1024 × 1024 的极简蓝色圆形图标，白色背景，不包含文字。完成后在对话中展示生成结果。
图片出现在当前对话中，并且能够正常打开。
只看到“生成成功”的文字提示还不算完成；最终要以客户端真实显示的图片为准。
按照实际现象继续排查
Codex 启动后提示配置文件格式错误01
检查 http_headers 是否位于正在使用的 Provider 段落中，字符串是否使用英文双引号，以及同一段落是否重复声明了 http_headers。
修改后仍然只有文字，没有图片02
确认 Codex App 已经完全退出并重新打开，再核对当前启用的 model_provider 名称是否与修改的 [model_providers.xxx] 一致。
请求变成 401、403 或 40403
这类状态码属于第三方 API 的鉴权或路由问题。检查 API Key、base_url、wire_api 和服务端兼容性；客户端图片开关无法替代这些能力。
第三方服务拒绝这个额外请求头04
让 Provider 或反向代理接受并忽略 x-openai-actor-authorization，同时继续保留现有鉴权方式。这个标记负责客户端能力识别，不承担真实身份认证。
一行配置负责打开能力，最终结果仍要用真实图片验收。
以后升级 Codex App 或调整 Provider 时，可以再次用这套最小测试确认生图链路。