Codex 默认的用法是登录 ChatGPT 或 OpenAI 账号，用官方支持的模型。接第三方 API 是进阶配置，适合已经弄明白 config.toml、API Key、Base URL 和模型名的人。刚上手先知道有这么一条路就行。
第三方服务可能牵扯账号安全，也可能让 API Key 泄露出去，账单超额和日志留存这类问题都有人踩过。本文只整理接入思路，不推荐任何具体的中转商或 API 服务。要用就选你能承担责任的那家，密钥别出现在截图、仓库和公开文档里。
三种方案怎么选
| 方案 | 适合谁 | 优点 | 需要注意 |
|---|---|---|---|
| 手动配置 | 想理解底层配置的人 | 透明可控，方便排障 | 要自己维护 config.toml，字段写错就不生效 |
| Codex++ | 主要用桌面 App 的人 | 有图形管理界面 | 第三方启动工具，更新后可能跟不上 |
| CCX 加 CC Switch | 有多个供应商的人 | 网关负责路由，工具负责切换 | 组件更多，要理解本地服务和代理链路 |
第一次配置先只加一个 provider，跑通之后再整理多套 profile。
手动配置：改的是两个文件
核心是编辑用户目录下的 .codex/config.toml。动手前先备份 config.toml 和 auth.json 两份，改坏了能退回来。
登录思路有两种。一种保留官方的 ChatGPT 登录态，provider 只改请求入口，把请求转到兼容地址上。另一种走 API Key，适合用 OpenAI API Key 或者自建兼容 Responses API 的服务。两条路别混着改，先走通一条。
配置里有几个字段决定成败。model 填你要的模型名。model_provider 的名字要和下面方括号里的 provider 名完全一致，差一个字母就不生效。base_url 填服务商的请求地址，通常写到 /v1 为止，别再拼后面的路径。wire_api 固定写 responses。requires_openai_auth 决定是否沿用已有登录态。
密钥走环境变量，不要写死在配置文件里。开一个新终端把密钥导出，再从终端启动 Codex，桌面端才读得到。Mac 上直接从图标启动可能读不到新模型。
验证用一个只读任务，让它说明当前工作区路径和准备使用的模型。认证报错时先切回备份配置，别把真实密钥粘到对话里。
Codex++ 把配置搬进了界面
Codex++ 是面向桌面 App 的外部增强启动器。按它的说明，它不改安装文件，而是从外部拉起 Codex，再往里注入增强脚本。
它适合主要用桌面 App 的人。图形界面里能维护 Base URL 和密钥，也能随时切回官方登录态，代价是要接受第三方启动器的兼容性风险。
流程上有几个容易卡住的点。下载时要分清管理工具和 app 两个安装包。首次打开如果被系统拦下，去设置里的隐私与安全性里有一个”仍要打开”，点了它才进得去。接入方式要选纯 API 那一档。模型列表可以从上游拉取，保存后先测联通再启用。
最后一步最容易漏。要从 Codex++ 的入口启动 Codex，而不是从原版入口。插件功能在这一版里可以直接用。想回官方登录态，在管理工具里清掉 API 模式就可以。
CCX 和 CC Switch 各自负责一段
这套方案把两件事拆给了两个组件。CCX 负责代理与协议转换，对外提供 Responses、Chat Completions 等入口，还带管理页面和渠道编排。CC Switch 管的是供应商配置，MCP、Skills 和会话也归它管，支持一键切换。
它解决的典型问题是手上有多个 Key，或者上游只给 Chat Completions。Codex 要的是 Responses 入口，上游给不了的那部分就得靠网关转。
流程分四步。先把网关部署起来，带上访问密钥启动，本地会开出一个管理页面。接着在管理界面里加上游渠道，填服务类型和 API Key，再补上 Base URL 和模型映射。自带测试确认可用之后，装切换工具并初始化，把网关地址填成中转入口。最后切到配好的供应商，重启 Codex 让配置生效。
切换工具有可能会动到 .codex/config.toml，切完打开核对一次。看 model_provider 指向哪里，base_url 是不是只写到 /v1，原有的 MCP 和 profile 是不是还在。
常见问题
| 现象 | 先检查什么 |
|---|---|
| 切换后没有生效 | 是否完全重启 Codex，model_provider 名称是否一致 |
| 报认证错误 | 密钥是否有效，环境变量有没有被当前终端继承 |
| 国产模型无法响应 | 上游是否支持 Responses API，不支持就得用网关转换 |
| 插件或 Skills 配置不见了 | 切换工具是否覆盖了通用配置，有没有备份 |
| 旧会话不可见 | 先判断是不是桌面端首屏条数限制，再看 provider 元数据 |
这些问题的答案都在文件里，不在对话里。
收尾
第三方 API 这条路线灵活，代价是维护成本落在你自己身上。换了模型提供方之后，缓存命中率和历史会话都可能跟着变，动手前备份才有退路。
