CC Switch 接入 Routescope

CC Switch 是一个带界面的配置工具。你在里面点几下、填个表，它就会自动替你把 Routescope 的地址和密钥写进 Claude Code 或 Codex，不用自己编辑配置文件。

本文写给第一次配置的人，跟着每一步做即可。

最后更新：2026-07-13 已核验版本：CC Switch v3.16.5

整个过程只有三步

准备三样东西 → 在 CC Switch 里加一个 Routescope 供应商 → 启用并测试

先想清楚：你用的是哪个工具？

Claude Code 和 Codex 是两个不同的工具，接入地址也不一样。请先确定你用哪个，然后只看对应章节：

• 用 Claude Code：看「配置 Claude Code」。
• 用 Codex：看「配置 Codex」。
• 两个都要：先配好一个、确认成功，再配另一个。

不确定用哪个时，大多数人先选 Claude Code。

两个工具的地址不要填反：

第一步：准备三样东西

开始前，先把下面三样都备齐。

1. 安装 CC Switch 本体

从 CC Switch 官网 或 CC Switch 官方 GitHub 下载安装。

2. 装好你要用的工具

CC Switch 只负责改配置，Claude Code / Codex 本身也要先装好。打开一个能输入命令的窗口：

• Windows：打开 PowerShell。
• macOS：打开「终端」。
• Linux：打开系统终端。

用 Claude Code 就输入：

claude --version

用 Codex 就输入：

codex --version

看到版本号，说明装好了。若提示 command not found 或找不到命令，请先按官方说明安装：

• Claude Code 官方安装说明
• Codex CLI 官方安装说明

3. 拿到 Routescope 密钥和模型名

密钥（API Key）像通行证；模型名（模型 ID）就是你要用哪个 AI。

1. 登录 Routescope 控制台。
2. 进入「令牌管理」，点击「添加令牌」。
3. 令牌名称随便填，比如 CC Switch。
4. 额度、可用模型、有效期等第一次保持默认，点击保存。
5. 在令牌列表点击这条令牌的「复制访问码」，确认复制出来的是 sk- 开头的一串字符。
6. 打开 模型广场，找到这条令牌能用的模型，把它的「模型 ID」完整复制下来。

准备好后，你手上应该有：一串 sk- 开头的密钥，以及一个模型 ID。

第二步：在 CC Switch 里新增一个供应商

“供应商”就是“这个 AI 服务是谁提供的”。这里要加一个 Routescope。

1. 打开 CC Switch。

2. 在主界面顶部选中你要配置的工具：Claude Code 或 Codex。

   

   这一步最关键：先选对工具，后面填的内容才会写进对应工具。

3. 点击右上角的 +。

4. 选择「应用专属供应商」。第一次用不要选「统一供应商」。

5. 在「预设供应商」里选择「自定义配置」。

之后你会看到供应商名称、API Key、API 端点等输入框。接下来只看你所选工具的那一节。

配置 Claude Code

用 Codex 的话，跳到下面的「配置 Codex」。

第一步：填基础信息

照下表填写，表里的地址原样照抄：

填完检查三点：

• API Key 开头的 sk- 没被删掉。
• API 端点末尾没有 /v1，Claude Code 不要带。
• API 端点末尾也没有多一个 /。

第二步：确认两个高级选项

展开「高级选项」，确认这两项是默认值：

除了上面这些字段，其它选项第一次接入时保持默认。

第三步：选模型

1. 找到「模型映射」，点击 获取模型列表。
2. 在 Sonnet 那一行的「实际请求模型」里，选择你准备好的模型 ID。
3. 点击 一键设置，把同一个模型套用到其它角色。
4. 找到「默认兜底模型」，也选择同一个模型 ID。

第一次接入时，所有角色用同一个模型最不容易出错，以后确认可用后再分开调整。

如果「获取模型列表」点了没反应，先检查 API Key 和 API 端点；还不行就在「实际请求模型」里直接手动粘贴模型 ID。

第四步：保存并启用

1. 点击底部的 添加 / 保存。

2. 回到 Claude Code 供应商列表，找到 Routescope 卡片。

   

3. 点击卡片上的 启用，确认卡片显示「当前使用 / 使用中」。

第五步：启动并验证

打开 PowerShell 或终端，输入 claude 回车。进去后随便问一句，例如：

请用一句话介绍你自己。

收到正常回复后，再确认请求真的走了 Routescope：

1. 打开 Routescope 控制台，进入「操作记录」。
2. 找到刚刚那个时间点的新记录。
3. 确认状态成功、模型和你选的一致。

看到这条成功记录，才算真正接入完成。

如果 Claude Code 第一次启动还是要你登录

1. 打开 CC Switch，进入「设置 → 通用」。
2. 打开「跳过 Claude Code 初次安装确认」。
3. 关掉 Claude Code，重新输入 claude 启动。

配置 Codex

Claude Code 已经配好的话，可以稍后再配 Codex。

第一步：填基础信息

照下表填写，地址不要改：

检查两点：sk- 没删；地址末尾有且只有一个 /v1。

第二步：选对上游格式

展开「高级选项」，找到「上游格式」，选择：

Responses（原生）

这里不要选 Chat Completions（需开启路由），也不用开启本地路由。

第三步：改模型名

往下找到 config.toml 编辑框，找到以 model = 开头的那一行，例如：

model = "gpt-5.5"

只把引号里的名字换成你从 Routescope 复制的模型 ID：

model = "你的实际模型ID"

不要删 model =，不要删双引号，其它看不懂的内容保持不动。

再确认这段里能看到这两行：

base_url = "https://api.routescope.ai/v1"
wire_api = "responses"

密钥 CC Switch 会自动保存，不用再粘一次。

第四步：保存并启用

1. 点击底部的 添加 / 保存。
2. 回到 Codex 供应商列表，找到 Routescope 卡片。
3. 点击 启用，确认显示「当前使用 / 使用中」。

第五步：一定要重开终端

Codex 不会立刻读取新配置，必须关掉终端再重开：

1. 关闭当前 PowerShell / 终端窗口。
2. 重新打开一个。
3. 输入 codex 回车，进去后随便问一句。

第六步：验证真的走了 Routescope

1. 打开 Routescope 控制台，进入「操作记录」。
2. 找到刚产生、时间相符的新记录。
3. 确认状态成功、模型和 config.toml 里填的一致。

看到成功记录，才算真正接入完成。

接入成功后如何切换工具

1. 在 CC Switch 顶部选择 Claude Code 或 Codex。
2. 在供应商卡片上点击 启用。
3. Claude Code 一般立即生效；没换过来就关掉当前 claude、重开终端再跑。
4. Codex 需要关掉并重新打开终端。

遇到错误怎么办

排查前先做一个通用动作：改完配置后，回卡片重新点一次「启用」，再新开一个终端测试。

提示找不到 claude 或 codex 命令

对应工具还没装，或装完没重开终端。先装好，关掉终端重开，再运行 claude --version / codex --version。

返回 401 或 403

依次检查：密钥是否完整、sk- 是否保留、令牌是否被禁用或过期、令牌是否还有额度、当前模型是否在令牌允许范围内、是否触发 IP 限制。

如果都没问题还是失败，多半是电脑里以前残留的旧设置在影响。清掉旧环境变量再重开终端：

unset ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL

Windows 请在 Git Bash 里执行这行。清完回卡片重新点 启用。

返回 404

• Claude Code：https://api.routescope.ai，不要加 /v1。
• Codex：https://api.routescope.ai/v1，必须带 /v1。
• 两者末尾都不要多一个 /。

返回 model not found 或模型不可用

1. 回 Routescope 控制台确认令牌能用哪些模型。
2. 复制完整模型 ID。
3. Claude Code：重设「实际请求模型」和「默认兜底模型」；Codex：重改 config.toml 里的 model。
4. 保存后重新启用。

Claude Code 报 context_management: Extra inputs are not permitted

这不是密钥填错。编辑 Claude Code 的 Routescope 供应商，在配置 JSON 的 env 里加一行：

"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

别删已有的密钥、地址和模型配置。保存后重新启用、重启 Claude Code。没遇到这个错就不用加。

AI 能回复，但操作记录里没有请求

多半是当前生效的不是 Routescope，或旧环境变量把请求指到了别处。

1. 回 CC Switch 确认顶部选的工具没错。
2. 确认 Routescope 卡片显示「当前使用 / 使用中」，必要时重新点 启用。
3. 按上面 401 那节清掉旧环境变量。
4. Codex 用户还要重开终端。

Codex 进阶：改完还是认证失败

极少数情况下，Codex 的自定义供应商要把 config.toml 里的 requires_openai_auth 改成 false 才能连通。这属于进阶排查，改之前建议先联系 Routescope 支持确认。

第一次接入时，这些保持默认别动

• 完整 URL 模式：关闭。
• Claude Code · API 格式：Anthropic Messages（原生）。
• Claude Code · 认证字段：ANTHROPIC_AUTH_TOKEN（默认）。
• Codex · 上游格式：Responses（原生）。
• 本地路由接管：不需要开启。

参考资料

• CC Switch 官方仓库
• CC Switch 官方手册：添加供应商
• CC Switch 官方手册：切换供应商