使用第三方 API 时保留 Codex 远程操作和官方插件CC Switch 配置攻略适用版本CC Switch v3.16.1 及以上。本文根据当前代码、用户手册和 v3.16.1 Release Note 整理截图使用去敏示例数据不包含真实 Access Token 或 API Key。资源地址cc-switch客户端https://pan.quark.cn/s/3c34f79a51d8codex客户端https://codexdown.cc/这篇攻略解决什么问题很多人使用 Codex 时有两个需求模型使用 DeepSeek、Kimi、GLM、MiniMax、硅基流动等第三方 API或者在中转站使用 gpt 模型。保留 Codex 官方 App 的手机远程操作、官方插件等能力。之前切换第三方供应商时旧行为会把第三方 API Key 写进 Codex 的auth.json从而覆盖原来的官方 ChatGPT / Codex 登录缓存。这样第三方模型能用了但依赖官方登录态的功能会消失。v3.16.1 新增的Codex 应用增强开关就是为了解决这个矛盾让官方 Access Token 继续留在auth.json而第三方供应商信息写入config.toml。这样 Codex App 仍然认为你登录的是官方账号但实际模型请求会走 CC Switch 当前选中的第三方供应商。v3.16.0 就有这个功能并且默认开启但是部分用户反映并不想要这个功能所以在 v3.16.1 中把这个功能做成了开关。先看结论推荐顺序是在 CC Switch 的 Codex 面板切换到OpenAI Official。启动 Codex并用官方 ChatGPT / Codex 账号登录一次Free 订阅也可以。回到 CC Switch打开设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录。添加或切换到第三方 Codex 供应商。如果该供应商是 Chat Completions 协议例如 DeepSeek / Kimi / MiniMax需要同时开启本地路由并启用 Codex 接管。重启 Codex让config.toml和模型目录重新加载。准备工作你需要准备CC Switch v3.16.1 或更新版本。已安装并能启动的 Codex建议 app 和 cli 都安装。一个可以登录 Codex 的官方 ChatGPT / Codex 账号Free 订阅即可。一个第三方 API Key例如 DeepSeek、Kimi、GLM、MiniMax、OpenRouter、硅基流动等。请不要手动复制或分享~/.codex/auth.json的内容。里面保存的是官方登录缓存和 Access Token属于敏感信息。第一步先切回 OpenAI Official 并完成官方登录打开 CC Switch切到顶部的Codex标签页。先选择OpenAI Official供应商如果没有的话就在预设供应商当中添加一个并把它设为当前供应商。接着启动 Codex建议启动 cli按 Codex 的官方登录流程登录你的 ChatGPT / Codex 账号。这个账号可以是 Free 订阅在这个方案里它主要负责保留 Codex 官方 App 需要识别的登录身份不负责第三方模型的计费。登录完成后Codex 会在~/.codex/auth.json中保存官方登录缓存。后面的关键点就是不要再让第三方供应商切换覆盖这个文件。第二步开启 Codex 应用增强回到 CC Switch进入设置 → 通用 → Codex 应用增强打开切换第三方时保留官方登录这个开关默认关闭是因为部分用户并不想要这个功能。只有在你明确需要“第三方 API 官方远程操作 / 官方插件”同时存在时才需要开启它。开启后后端切换 Codex 第三方供应商时会走 config-only 写入路径auth.json继续保留官方 ChatGPT / Codex 登录缓存。config.toml写入当前第三方供应商的模型、endpoint、model_provider和 provider-scopedexperimental_bearer_token。第三步添加第三方 Codex 供应商回到 Codex 面板点击右上角的加号添加供应商。推荐优先使用内置预设例如 DeepSeek、Kimi、MiniMax、GLM、SiliconFlow 等。以 DeepSeek 为例选择预设后只需要填 API Key。预设会自动配置 base URL、默认模型、模型映射表和“需要本地路由映射”。如果你的第三方供应商原生支持 OpenAI Responses API比如提供 gpt 模型的中转站可以不启用本地路由。如果它只支持 OpenAI Chat Completions例如常见的 DeepSeek / Kimi / MiniMax 路径就必须启用本地路由让 CC Switch 把 Codex 的 Responses 请求转换成 Chat Completions 请求。第四步需要时开启本地路由并接管 Codex进入设置 → 路由 → 本地路由完成两件事打开路由总开关启动本地服务。默认地址通常是127.0.0.1:15721。在路由启用中打开Codex。接管后Codex 的 liveconfig.toml会临时指向 CC Switch 本地路由。真实第三方 API Key 仍然存储在 CC Switch 的供应商配置中切换供应商时再投影到config.toml的experimental_bearer_token。第五步切换第三方供应商并重启 Codex回到 Codex 供应商列表启用你刚添加的第三方供应商。切换完成后建议重启 Codex原因有两个Codex 在启动时读取config.toml。Codex 的/model菜单通常需要重启后才会重新加载model_catalog_json。重启后你可以做一个简单验证在 Codex App 里账号信息仍然显示官方账号这是预期行为。在 CC Switch 里当前 Codex 供应商显示为第三方供应商。如果开启了本地路由请求日志或路由统计会看到 Codex 请求经过本地路由。第三方供应商后台或余额记录会出现实际模型请求。背后的原理Codex 的配置主要分成两个文件~/.codex/auth.json ~/.codex/config.toml这两个文件承担的职责不同auth.json保存官方 ChatGPT / Codex 登录缓存也就是 Codex App 识别官方账号、远程操作和官方插件所需的登录材料。config.toml保存当前模型供应商、base URL、模型、模型目录和 provider-scoped token 等运行配置。开启切换第三方时保留官方登录后CC Switch 的切换逻辑会把第三方供应商 API Key 从供应商配置中取出写到config.toml的当前 provider 下model_provider custom [model_providers.custom] name DeepSeek base_url https://api.deepseek.com wire_api responses experimental_bearer_token sk-...同时auth.json保持官方登录缓存不变。于是 Codex App 侧依然能识别官方账号而模型请求会根据config.toml的当前 provider 和 base URL 走第三方 API。如果供应商是 Chat Completions 协议CC Switch 本地路由会再做一层转换Codex Responses 请求 ↓ CC Switch 本地路由 ↓ 第三方 Chat Completions API ↓ 转换回 Codex Responses 响应这就是为什么你既能继续使用官方插件 / 手机远程操作又能把模型流量切到第三方 API。需要理解的副作用Codex 里显示的账号始终是官方账号这是最容易误解的一点。开启该能力后Codex App 看到的是auth.json里的官方登录态所以它会继续显示官方账号信息。但这不代表模型请求还在走官方 OpenAI。实际流量以 CC Switch 当前 Codex 供应商、config.toml和本地路由日志为准。不要用 Codex 账号信息判断计费方如果你切到 DeepSeekCodex 里仍然显示官方账号但模型请求会走 DeepSeek API。计费、限额、错误码和数据策略都应按第三方供应商理解。可以查看设置用量面板里的具体请求信息。修改模型映射后要重启 CodexCodex 的模型目录是启动时读取的。即使 CC Switch 已经生成了新的模型目录正在运行的 Codex 也不一定会热加载所以修改模型映射后请重启 Codex。关闭开关会回到旧行为如果关闭切换第三方时保留官方登录第三方供应商切换会沿用兼容旧版本的行为可能重新写入auth.json。如果你的目标是长期保留官方远程操作和官方插件建议保持该开关开启。常见问题我已经切到第三方 API为什么 Codex 还显示官方账号这是预期行为。官方账号信息来自auth.json模型请求的实际供应商来自config.toml和 CC Switch 当前供应商。Free 订阅真的可以吗可以。这里的官方账号主要用于获取并保留 Codex App 需要的官方登录态。第三方模型请求使用的是你在 CC Switch 里配置的第三方 API Key。开启后官方插件或手机远程操作还是不可用怎么办先切回OpenAI Official重新启动 Codex 并完成一次官方登录然后确认 CC Switch 的设置 → 通用 → Codex 应用增强 → 切换第三方时保留官方登录已开启再切回第三方供应商。第三方请求 404、模型列表不对或流式响应异常怎么办如果该供应商是 Chat Completions 协议请确认供应商表单里开启了需要本地路由映射并且设置 → 路由里已经启动路由总开关、启用 Codex 接管。可以在本地路由模式下切回 OpenAI Official 吗不建议。CC Switch 会尽量阻止在本地路由接管模式下切到官方供应商因为用代理访问官方 API 可能带来账号风险。建议官方登录只用于保留auth.json模型流量则切到第三方供应商。为什么流程做的这么复杂可以简化吗因为 Codex 增强开关和路由接管等一系列功能如果用户并不需要的话默认打开会带来不必要的麻烦所以都做成了开关形式。
