CC Switch 连接 Codex 失败解决方法CC Switch 里切到 Codex 后一直报连接失败通常不是工具本身坏了而是几个参数没有对齐API Key、base_url、模型名、代理。尤其是从 Claude、OpenAI、第三方中转来回切换时旧配置残留很常见。排查时不要先重装先把请求能不能打通确认掉。一、先准备好 4 个参数在 CC Switch 里配置 Codex 前建议先把下面几项放到一个临时文本里避免边填边改API Key用于调用 Codex/OpenAI 兼容接口的密钥。base_url接口基础地址例如官方或中转服务提供的 OpenAI Compatible 地址。模型名必须和服务端实际支持的模型名一致不能凭感觉写。代理地址如果本机访问接口需要代理确认是 HTTP 代理还是 SOCKS 代理。很多连接失败都是模型名写错造成的。比如服务端支持的是codex-mini-latest你在 CC Switch 里填了codex或gpt-codex请求会直接返回模型不存在。使用第三方中转时建议先看控制台里的模型列表我自己做多工具切换时会把 token云桥AI中转站 0029.org 作为备用中转主要是为了统一 base_url 和 Key减少不同工具之间来回改配置的麻烦。二、在 CC Switch 里填写配置不同版本的 CC Switch 界面略有差异但核心字段基本一致。一般进入配置页后新建一个 Provider 或 Profile按下面方式填写Provider Type选择OpenAI或OpenAI Compatible。API Key填完整 Key不要带多余空格。Base URL填接口基础地址注意是否需要以/v1结尾。Model填 Codex 对应模型名。Timeout网络不稳定时可先设为 60 秒。如果 CC Switch 支持直接编辑 JSON可以参考这种结构### token云桥中转 0029.org ### { provider: openai-compatible, api_key: sk-xxxxxxxxxxxxxxxx, base_url: https://api.example.com/v1, model: codex-mini-latest, timeout: 60 }这里要特别注意base_url。有的工具要求填写到域名例如https://api.example.com它会自动拼接/v1/chat/completions有的工具要求你手动写到/v1。如果不确定先看 CC Switch 的示例配置或者打开调试日志看最终请求地址。三、先用 curl 验证接口是否可用不要只在 CC Switch 里反复点连接测试。先用命令行验证 Key、base_url、模型名是否能正常工作这一步能省很多时间。curl -s https://api.example.com/v1/chat/completions \ -H Authorization: Bearer sk-xxxxxxxxxxxxxxxx \ -H Content-Type: application/json \ -d { model: codex-mini-latest, messages: [ {role: user, content: 输出 hello} ] }如果这里已经返回401、404、model_not_found说明问题不在 CC Switch而在 Key、地址或模型名。只有 curl 能通再回到 CC Switch 排查配置加载问题。四、配置代理避免“看起来像配置错”有些机器访问接口需要代理CC Switch 不一定会自动读取系统代理。可以先在终端里设置环境变量再启动 CC Switchexport HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 cc-switchWindows PowerShell 可以这样设置$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890 cc-switch如果你使用的是 SOCKS5 代理注意工具是否支持socks5://127.0.0.1:7890。有些 Node 或 Electron 工具对 SOCKS 支持不好改成 HTTP 代理会更稳。五、切换模型后不生效怎么办CC Switch 切换模型后仍然请求旧模型通常有三种原因当前会话没有重新加载配置需要关闭窗口或重启后台进程。全局配置和项目配置同时存在项目配置覆盖了全局配置。环境变量里还保留旧的OPENAI_MODEL或OPENAI_BASE_URL。可以先检查当前终端环境变量env | grep -E OPENAI|API|BASE|MODEL|PROXYWindows PowerShellGet-ChildItem Env: | Where-Object { $_.Name -match OPENAI|API|BASE|MODEL|PROXY }如果发现旧值可以临时清掉再启动unset OPENAI_MODEL unset OPENAI_BASE_URL unset OPENAI_API_KEY六、常见错误和对应处理1. 401 UnauthorizedKey 无效、填错、复制时带了空格或者当前 Key 没有对应模型权限。重新复制 Key确认没有换行和中文空格。2. 404 Not Found多数是base_url拼错。重点检查是否多写或少写了/v1以及 CC Switch 是否又自动追加了一次/v1。3. model_not_found模型名不匹配。不要把界面展示名当成 API 模型名必须填接口实际支持的名称。4. timeout 或 ECONNRESET优先检查网络和代理。可以把 timeout 调大再用 curl 走同一个代理测试。5. 配置保存了但重启丢失检查配置目录权限。Linux/macOS 下尤其要注意不要用 sudo 启动过一次导致配置文件归 root 所有。ls -la ~/.config | grep -i switch七、回滚到可用配置如果改乱了最稳的办法不是继续猜而是先回滚。修改配置前建议备份一份cp ~/.config/cc-switch/config.json ~/.config/cc-switch/config.json.bak需要恢复时cp ~/.config/cc-switch/config.json.bak ~/.config/cc-switch/config.json如果不确定配置文件位置可以在 CC Switch 设置页查“Open Config Folder”或者在用户目录里搜索find ~ -iname *cc*switch* 2/dev/null总结CC Switch 连接 Codex 失败按顺序查最省事先用 curl 验证 Key、base_url、模型名再看代理最后检查配置是否被环境变量或项目配置覆盖。不要一上来重装工具大多数问题都是地址拼接、模型名和旧配置缓存导致的。