CC Switch 怎么接第三方 API：Claude Code 和 Codex 一步步配置（2026）

手上有了第三方服务商给的 key 和接口地址，想让 Claude Code 或 Codex 用上它，最省事的办法是 CC Switch：它把「改配置文件」变成在界面里填几个格子，还能一键切回官方。这篇按 Claude Code 和 Codex 各走一遍，最后列出最常见的几个报错和对应的原因。

动手之前先确认三样东西：

• 接口地址。Claude Code 用的是 Anthropic 格式的地址，一般是根地址，不带 /v1；Codex 用的是 OpenAI 格式的地址，一般以 /v1 结尾。服务商通常会分别给出。
• key。Claude 和 Codex 如果是分开买的，就是两把不同的 key，不能混用。
• CC Switch 已经装好，Claude Code 或 Codex 本身也装好了。

Claude Code：加一个自定义供应商

1. 打开 CC Switch，在顶部选 Claude，点右上角的 +。
2. 配置类型选 自定义，「供应商名称」随便起一个认得出的名字。
3. 「请求地址」填服务商给的 Anthropic 格式地址，「API Key」填 Claude 的 key。
4. 「主模型」可以留空，留空就用服务商的默认模型；想指定的话，先点 获取模型列表 看看有哪些。
5. 点 添加，回到列表，在这个供应商上点 启用。
6. 重开终端，再运行 claude。

CC Switch 实际做的事，是把地址和 key 写进 ~/.claude/settings.json 的 env 里（ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN）。所以想确认有没有生效，打开这个文件看一眼就知道。

Codex：多两个要选对的地方

1. 在顶部选 Codex，点右上角的 +，配置类型选 自定义。
2. 「API 请求地址」填服务商给的 OpenAI 格式地址，通常以 /v1 结尾；「API Key」填 Codex 的 key。
3. 「上游格式」选 Responses（原生）。Codex 走的就是 Responses 接口，服务商支持的话不需要开本地路由；选 Chat Completions 的话，要先在 CC Switch 里开路由。
4. 「模型名称」填一个服务商确实提供的模型，可以点 获取模型列表 从里面选。
5. 点 添加，在列表里 启用，然后重开终端或 Codex 应用。

Codex 的配置写在 ~/.codex/config.toml 里。CC Switch 会把第三方供应商写成一个自定义的 model_providers 表，再把 model_provider 指过去。

报错了先看这几条

• 401 / 认证失败：key 填错了，或者把 Claude 的 key 填进了 Codex（反过来也一样）。重新复制一遍，注意别带上空格。
• 404 / 地址不存在：多半是 /v1 的问题。Codex 的地址一般要带 /v1，Claude Code 的一般不带；带错了，请求就打到了不存在的路径上。
• 模型不存在 / model not found：模型名称跟服务商提供的对不上。用「获取模型列表」里的名字，别凭记忆手打。
• 改了没生效：先重开终端。还不行的话，检查 shell 配置（~/.zshrc 之类）里有没有 export ANTHROPIC_BASE_URL 或 OPENAI_BASE_URL：环境变量的优先级比配置文件高，会把 CC Switch 写的值盖掉。
• Codex 里看不到以前的对话：Codex 按供应商分开存会话记录，换了供应商，codex resume 列出的就是另一份。切回原来的供应商就能看到；新版 CC Switch 也提供了把记录归到一起的迁移。

想切回官方怎么办

在 CC Switch 的列表里启用官方那一项就行（Claude 官方、OpenAI 官方），配置会改回去。不想再用 CC Switch 的话，先切回官方再卸载，免得配置文件里留着第三方的地址。