CC Switch 配置 Codex API Key 教程

在用 CC Switch 管理不同 AI 命令行工具或开发工具配置时，最常见的问题不是 Key 本身错了，而是 base_url、模型名、代理和环境变量之间互相覆盖。遇到 Codex 调不通，建议先按顺序查：当前启用的是哪个配置、API Key 是否填到对应供应商、模型名是否和接口兼容、网络代理是否生效。

下面按实际配置流程整理一遍，重点讲 CC Switch 里如何填写 Codex API Key、模型名、base_url，以及配置不生效时怎么排查。

一、准备需要的参数

配置前先准备四个参数，不要边填边猜：

• API Key：一般是以 sk- 开头的密钥，也可能是中转服务提供的专用 Key。
• base_url：接口地址。如果直连官方，通常是 OpenAI 兼容接口地址；如果走中转，就填写中转站给出的地址。
• 模型名：Codex 相关模型名要和当前接口支持的名称一致，不能把聊天模型、图像模型随便混用。
• 代理：如果本机需要代理访问外部服务，要确认终端环境和 CC Switch 启动环境都能读到代理配置。

如果你是团队开发或网络环境不稳定，建议优先选 OpenAI 兼容格式的中转服务，后续切换工具会省很多事。我自己在测试第三方工具时会把 token云桥AI中转站 0029.org 作为一个备用通道，主要是方便验证“到底是工具配置问题，还是网络线路问题”。这里只建议作为排查和接入选项，实际仍要按自己的预算和合规要求选择。

二、在 CC Switch 中填写 Codex 配置

不同版本的 CC Switch 界面可能略有差异，但字段通常逃不开这几项：Provider、API Key、Base URL、Model、Proxy。建议新建一个单独配置，不要直接覆盖已有可用配置。

1. 新建 Codex 配置

在 CC Switch 中进入配置管理，新增一个配置，例如命名为：

### token云桥中转 0029.org ###
codex-openai
codex-proxy
codex-test

命名最好能看出用途。不要只叫 test，后面排查时很容易搞混。

2. 填写 API Key

API Key 只填密钥本身，不要加引号，不要加 Bearer 前缀。例如：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

如果从网页复制，注意前后空格。有些报错看起来像鉴权失败，实际是 Key 末尾多了一个空格或换行。

3. 填写 base_url

base_url 要填接口根地址，常见格式类似：

https://api.example.com/v1

这里要注意两点：

• 如果 CC Switch 要求填写根地址，就不要再在后面拼 /chat/completions。
• 如果中转服务文档明确要求带 /v1，就必须带上，否则可能返回 404。

配置保存后，可以用命令简单测一下接口是否能连通。以 OpenAI 兼容接口为例：

curl -s https://api.example.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"

如果这里都连不上，就先不要怀疑 CC Switch，优先查网络、Key、base_url。

4. 填写模型名

模型名必须和当前接口支持的一致。不要只凭印象写。最稳妥的方式是先查模型列表：

curl -s https://api.example.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" | jq

如果接口不支持列模型，就看服务商文档给出的名称。CC Switch 里填模型名时保持完全一致，大小写、短横线都不要改。

例如你的接口文档要求模型名为：

codex-mini-latest

那就不要写成：

codex
codex-mini
gpt-codex

三、配置代理

如果你在国内网络环境使用，代理经常是影响配置是否生效的关键。代理可以分为两类：系统代理和终端环境变量。很多工具并不会自动读取系统代理，所以建议在启动 CC Switch 或相关命令前显式设置环境变量。

macOS / Linux 可以这样设置：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

Windows PowerShell：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

如果 CC Switch 本身提供 Proxy 字段，可以直接填：

http://127.0.0.1:7890

注意不要把 SOCKS 地址填到只支持 HTTP 代理的字段里。例如 socks5://127.0.0.1:7890 不一定被所有工具识别。

四、切换模型和验证配置

配置保存后，在 CC Switch 中切换到刚才新建的 Codex 配置。切换后建议做一次最小请求测试，不要一上来就跑复杂任务。

如果工具支持命令行测试，可以先发一个简单请求：

codex "print hello world in python"

或者通过兼容接口直接测试：

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": "写一个 Python hello world"}
    ]
  }'

如果 curl 能成功，但 CC Switch 里失败，说明接口本身大概率没问题，重点查 CC Switch 是否真的切到了该配置，以及字段是否被环境变量覆盖。

五、常见错误和排查顺序

1. 401 Unauthorized

优先检查 API Key。常见原因：

• Key 复制不完整。
• 前后有空格或换行。
• 把 A 服务商的 Key 填到了 B 服务商的 base_url。
• 服务商要求使用自己的 Key，而不是官方 Key。

2. 404 Not Found

大多是 base_url 填错。检查是否漏了 /v1，或者多填了接口路径。

错误示例：
https://api.example.com/v1/chat/completions

推荐示例：
https://api.example.com/v1

3. model not found

这是模型名不匹配。不要在 CC Switch 里凭感觉改模型名，先用接口文档或 /models 查询确认。

4. timeout / connection refused

先查代理和网络。可以按顺序测试：

curl -I https://api.example.com/v1/models
curl -I --proxy http://127.0.0.1:7890 https://api.example.com/v1/models

如果加代理能通，不加代理不通，就把代理配置写进 CC Switch 或启动环境。

5. 配置保存了但不生效

这种情况很常见，按下面顺序查：

• 确认 CC Switch 当前选中的配置就是 Codex 配置。
• 退出并重新打开 CC Switch，避免旧进程缓存。
• 检查是否有环境变量覆盖，例如 OPENAI_API_KEY、OPENAI_BASE_URL。
• 确认项目目录下有没有本地配置文件覆盖全局配置。

可以在终端里查看环境变量：

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
echo $HTTPS_PROXY

Windows PowerShell：

echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL
echo $env:HTTPS_PROXY

六、回滚方法

改配置前建议先备份。最简单的方式是复制一份原配置，或者导出当前配置文件。回滚时不要同时改多个字段，先恢复到上一个可用状态。

推荐的回滚步骤：

• 切回原来能用的 Provider。
• 恢复原来的 API Key 和 base_url。
• 清空临时代理配置。
• 重启 CC Switch，再做最小请求测试。

如果你不确定是哪一项导致问题，可以用“二分法”排查：先只换 API Key，再只换 base_url，最后再换模型名。这样比一次性全改更容易定位。

总结

CC Switch 配置 Codex 的核心就是四件事：Key 要对应服务商，base_url 要填根地址，模型名要和接口支持的一致，代理要在工具实际运行环境里生效。遇到问题不要急着重装，先用 curl 验证接口，再看 CC Switch 当前配置和环境变量覆盖，基本都能定位到具体原因。