手动配置第三方 API¶
Codex 默认最稳妥的使用方式，是通过官方 ChatGPT / OpenAI 账号登录，并使用官方支持的模型与服务。连接第三方 API 属于进阶配置，适合已经理解 config.toml、API Key、Base URL、模型名和代理网关含义的用户。
第三方 API 风险
本文只整理接入思路，不推荐任何具体中转商或 API 服务。第三方 API 可能涉及账号安全、API Key 泄露、账单超额、服务稳定性、日志留存、数据跨境、模型能力降级和合规风险。请只使用你信任、能承担责任的服务，并避免把密钥写进截图、仓库和公开文档。
这种方式是直接编辑本机 Codex 配置。它透明、可控、方便排障，但要自己维护 config.toml，字段写错就不生效。
这种是没办法使用 Codex APP 的插件功能的，可以看看 Codex++ 方案。
手动配置的核心，是编辑本机的：
改之前先备份：
两类登录思路¶
| 思路 | 怎么理解 | 适合场景 |
|---|---|---|
| ChatGPT 登录 | Codex 仍使用 ChatGPT / OpenAI 登录态，provider 只改请求入口或中转地址 | 想保留官方账号能力，同时把请求转到兼容入口 |
| API Key 登录 | Codex 使用环境变量里的 API Key，按 provider 配置请求接口 | 用 OpenAI API Key 或自建兼容 Responses API 的服务 |
不要同时混着改太多东西。第一次配置时，先只新增一个 provider，确认能跑通后再整理多套 profile。
ChatGPT 登录态示例¶
也就是你的 Codex 先要登录到 ChatGPT 先。
第一步，手动修改文件配置文件：
在 ~/.codex/config.toml 文件下添加如下配置。
下面只展示示例，字段和值要按你实际服务填写：
model = "gpt-5-codex" #这里填你想要的模型
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.ciyuan]
name = "ciyuan" # 填你的模型提供商名字或者中转站名字，这里以词元为例
base_url = "https://ciyuan.today/v1" # 填你的模型提供商的请求 URL
wire_api = "responses" # 这里不要变
env_key = "OPENAI_API_KEY" # 这里将会通过环境变量的方式注入并启动Codex APP
requires_openai_auth = false
这里的重点是：
model_provider要和[model_providers.xxx]里的xxx完全一致。base_url通常写到/v1，不要把/v1/responses整段写进去。wire_api = "responses"表示 Codex 以 Responses API 的请求形态访问。requires_openai_auth = true表示使用已有 OpenAI / ChatGPT 登录态。
第二步，打开终端输入环境变量
第三步，终端中启动 Codex APP
这里如果是 mac，你要用终端启动，不然可能读不到模型。要特别注意，在启动前要先彻底关闭 Codex APP。
终端输入以下命令启动：
第四步，打开 Codex APP
你就可以看到已经应用到新模型了：
API Key 登录示例¶
如果你的服务使用 API Key，推荐把密钥放在环境变量里，不要写死在 config.toml：
对应配置示例：
model = "gpt-5.1-codex-max"
model_provider = "my-api-provider"
[model_providers.my-api-provider]
name = "My API Provider"
base_url = "https://example.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
requires_openai_auth = false
如果上游只支持 Chat Completions，而不支持 Responses API，通常不能只靠 config.toml 解决，需要使用 CCX 这类网关做协议转换。
修改鉴权文件
打开 ~/.codex/auth.json，然后添加 OPENAI_API_KEY 为你模型服务商的 API KEY：
手动配置后怎么验证¶
- 完全退出并重新打开 Codex。
- 让 Codex 执行一个只读任务，例如总结当前目录结构。
- 如果失败，先检查
model_provider名称、base_url、wire_api、环境变量和 API Key 权限。 - 出现认证错误时，先切回备份配置，不要反复把真实 Key 粘贴到对话里。