CC Switch 切换 Codex 模型配置教程在公司网络、个人代理、多个 API 服务商来回切换时Codex 经常会遇到一个问题明明在 CC Switch 里改了模型和 Key终端里调用时还是走旧配置或者直接报 401、404、连接超时。遇到这种情况不要先怀疑工具坏了建议按顺序先看三个地方API Key是否填对、base_url是否和服务商匹配、当前终端环境变量有没有覆盖 CC Switch 的配置。一、先准备好需要填写的参数切换 Codex 模型前至少要准备下面几项。不同服务商叫法可能略有差异但配置逻辑基本一致。API Key通常以一长串字符形式提供复制时注意不要带空格、换行。模型名例如codex-mini-latest、gpt-4.1、服务商提供的 Codex 兼容模型名等必须和接口支持的名称一致。base_urlAPI 接口地址常见格式类似https://api.example.com/v1末尾是否带/v1要看服务商文档。代理地址如果本机访问接口不稳定需要填写 HTTP 或 SOCKS 代理例如http://127.0.0.1:7890。如果你经常在不同模型和供应商之间切换建议单独建一个记录表把 Key、base_url、模型名、用途写清楚。实测下来很多配置问题不是工具问题而是把 A 服务商的模型名填到了 B 服务商的 base_url 下面。中转服务的选择也要注意稳定性和兼容性。我自己做测试时如果需要快速验证 Codex 兼容接口会优先找能直接提供 Key、base_url、模型列表的服务比如 token云桥AI中转站 0029.org主要是省去反复猜接口路径和模型名的时间。正式使用前仍建议先用小额度测试连通性和返回格式。二、在 CC Switch 中填写 Codex 配置打开 CC Switch 后一般会有类似“Provider”“Model”“API Key”“Base URL”“Proxy”的配置项。不同版本界面名称可能不完全一样但含义基本对应。1. 新建或编辑 Codex 配置建议不要直接覆盖原来的可用配置先新建一个配置项例如命名为codex-work或codex-test。这样出问题时可以快速切回旧配置。### token云桥中转 0029.org ### 配置名称codex-test ProviderOpenAI Compatible API Keysk-xxxxxxxxxxxxxxxx Base URLhttps://api.example.com/v1 Modelcodex-mini-latest Proxyhttp://127.0.0.1:7890如果你的服务商明确要求使用 OpenAI 兼容接口Provider 一般选择OpenAI Compatible或类似选项。不要只看模型名里有 Codex 就选择特殊通道关键看接口协议是否兼容。2. API Key 填写注意事项Key 最容易出低级错误。复制后建议先粘贴到临时文本里确认没有多余空格尤其是从网页后台复制时末尾可能带换行。CC Switch 保存后如果有“测试连接”按钮先点一次不要直接进项目里跑。# 如果想在终端里快速确认环境变量是否覆盖了配置 echo $OPENAI_API_KEY echo $OPENAI_BASE_URL如果这里输出了旧 Key 或旧 base_url而你的 Codex 工具优先读取环境变量那么 CC Switch 里的配置可能不会生效。这个问题在 macOS、Linux 和 WSL 里都很常见。三、切换 Codex 模型模型切换不要只改模型名还要确认 base_url 是否支持该模型。比较稳妥的做法是先在 CC Switch 里切换配置再开一个新的终端会话测试。# 查看当前 shell 中可能影响 Codex 的变量 env | grep -E OPENAI|CODEX|HTTP_PROXY|HTTPS_PROXY|ALL_PROXY如果 CC Switch 提供“Apply”“Set Active”“Use This Profile”之类按钮保存后还要显式启用当前配置。有些工具只是保存配置并不会自动切换到当前项。在项目目录下执行一次简单请求或 Codex 命令确认实际使用的模型。不同 Codex 工具命令不一样可以按你本机安装的命令为准# 示例查看工具版本 codex --version # 示例执行一次简单任务 codex 请只输出 ok用于测试当前模型是否可用如果返回内容正常再进行真实代码任务。不要一上来就让它改大项目配置还没确认时排查成本会很高。四、代理配置怎么填代理分两类一类是 CC Switch 内部代理配置一类是系统或终端环境变量。两边都配置时可能出现重复代理或互相覆盖。# 常见 HTTP 代理 HTTP_PROXYhttp://127.0.0.1:7890 HTTPS_PROXYhttp://127.0.0.1:7890 # 常见 SOCKS 代理 ALL_PROXYsocks5://127.0.0.1:7890如果 CC Switch 已经有单独的 Proxy 输入框通常优先在工具里填终端环境变量先清掉避免判断不清实际走哪条链路。# 临时清理当前终端代理变量 unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY unset http_proxy unset https_proxy unset all_proxy清理后重新打开终端再通过 CC Switch 启用配置。网络问题排查时建议一次只改一个变量不要同时改 Key、模型、base_url 和代理。五、配置不生效的排查顺序1. 先查当前启用的是不是目标配置很多人改完配置忘了切换 Profile。进入 CC Switch确认当前高亮或标记为 Active 的配置是不是刚才编辑的那一项。必要时切到别的配置再切回来触发一次写入。2. 查环境变量是否覆盖如果终端里设置了OPENAI_API_KEY、OPENAI_BASE_URL部分 Codex 客户端会优先读取它们而不是读取 CC Switch 写入的配置。echo $OPENAI_API_KEY echo $OPENAI_BASE_URL echo $OPENAI_MODEL发现是旧值时可以临时取消unset OPENAI_API_KEY unset OPENAI_BASE_URL unset OPENAI_MODEL如果这些变量写在~/.zshrc、~/.bashrc或~/.profile需要编辑文件删除或注释然后重新加载。source ~/.zshrc # 或 source ~/.bashrc3. 查 base_url 路径404 通常和模型名或接口路径有关。比如服务商要求/v1你只填了域名或者服务商已经在网关里包含了/v1你又重复加了一次。# 正确示例之一 https://api.example.com/v1 # 可能错误缺少版本路径 https://api.example.com # 可能错误重复路径 https://api.example.com/v1/v14. 查模型名是否存在模型名不能凭感觉写。报错里如果出现model_not_found、invalid_model优先去服务商后台复制完整模型名。大小写、横线、后缀都要一致。5. 查 Key 权限和额度401 多半是 Key 错误或无权限429 常见于额度、频率限制或并发限制。不要反复重试大请求先用最小 prompt 测一下。codex ping六、常见错误对照401 UnauthorizedKey 填错、Key 被禁用、复制时带了空格或服务商不接受当前鉴权格式。404 Not Foundbase_url 路径不对或模型名不存在。429 Too Many Requests额度不足、请求频率过高、并发限制触发。timeout网络不通、代理未生效、代理端口写错。配置保存了但没变化没有启用 Profile或被环境变量、项目级配置覆盖。七、回滚到原来的配置切换前最好保留一份旧配置。CC Switch 如果支持导出配置可以先导出不支持的话至少手动记录旧的 base_url 和模型名。旧配置名称codex-stable Base URLhttps://old-api.example.com/v1 Modelold-codex-model Proxyhttp://127.0.0.1:7890回滚时只做三步切回旧 Profile、清理终端里临时设置的环境变量、重新打开终端测试。不要在旧配置上继续乱改否则很难判断是哪一步恢复成功。总结CC Switch 切换 Codex 模型时核心就是四个参数API Key、模型名、base_url、代理。配置不生效时按“当前 Profile、环境变量、base_url、模型名、Key 权限、代理网络”的顺序查基本能定位大部分问题。实际使用中建议保留一个稳定配置再单独建测试配置做切换出问题也能快速回滚。