新版 Codex App 接入中转站后无法生图、无法联网搜索？一份配置解决

新版 Codex App 接入第三方中转站 API 后，可能出现一种很隐蔽的兼容问题：普通对话和代码任务可以正常完成，但图片生成结果不显示，Web Search 也无法使用。

这通常不是模型不支持生图，也不一定是中转站没有返回图片。问题更可能出在 Codex App 对自定义 Provider 的能力判断上：当客户端把当前服务识别为第三方 Provider 时，部分内置能力不会按官方 Provider 的方式启用。

Codex 的用户级配置文件通常位于：

Windows

C:\Users\你的用户名\.codex\config.toml

macOS、Linux、WSL

~/.codex/config.toml

修改前建议先复制一份备份。然后参考下面的结构配置自定义 Provider：

model_provider = "custom"
model = "你的模型名"
review_model = "你的模型名"
model_reasoning_effort = "high"

[model_providers.custom]
name = "你的中转站名称"
wire_api = "responses"
base_url = "https://app.yylx.io/v1"
requires_openai_auth = false
experimental_bearer_token = "你的中转站 API Key"
http_headers = { "x-openai-actor-authorization" = "http://app.yylx.io" }

不要直接照抄示例中的模型名、Base URL 和 API Key。它们必须替换为中转站实际提供的值，尤其要确认 Base URL 是否需要包含 /v1。

修复办法一：修改 Codex 配置文件 requires_openai_auth

这次修复最关键的是下面两项：

requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "http://app.yylx.io" }

requires_openai_auth = false 表示该 Provider 使用自己的 API Key，不要求再走 OpenAI 官方账号鉴权。

x-openai-actor-authorization 请求头则用于满足新版 Codex App 对相关能力的识别或校验。根据目前的社区测试，补充该请求头后，第三方 Provider 下的图片显示与 Web Search 能力可以恢复。

需要说明的是：这是针对当前客户端行为的兼容性处理，不是 OpenAI 官方承诺的长期配置接口。Codex App 更新后，字段名称或校验逻辑仍可能变化。

修复办法二：修改 Codex 的
CODEX_PROVIDER_NAME

确认 model_providers.custom 下面的 name 为 OpenAI：

model_provider = "custom"
model = "你的模型名"
review_model = "你的模型名"
model_reasoning_effort = "high"

[model_providers.custom]
name = "OpenAI"
...

修改后一定要彻底重启 Codex App

只关闭当前任务或新建对话通常不够。保存 config.toml 后，应完全退出 Codex App，再重新启动，让 Provider 配置重新加载。

总结

新版 Codex App 使用中转站后，出现“文字正常、不能生图、不能联网搜索”，不一定是模型能力缺失，更可能是客户端对第三方 Provider 的能力校验导致的。

当前社区验证的关键配置是：

requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "http://app.yylx.io" }

或：

[model_providers.custom]
name = "OpenAI"

修改后彻底重启 Codex App，再分别验证图片是否真正显示、Web Search 是否真正调用。

如果你正在为 Codex、Claude Code、Cline、Roo Code 等 AI 编程工具寻找统一的 API 接入方式，也可以了解 YYLX.IO 鱼鱼连线，减少重复配置 Base URL、模型映射和客户端兼容问题。