CC Switch 接入 CCSub：选预设填 Key，或手动添加供应商
CC Switch 预设列表里已有 CCSub，选中后填 API Key 即可；也可以用自定义配置手动填请求地址 https://www.ccsub.net。附切换不生效、Codex 需重启等问题。
复制即用的配置
把下面三项填进工具里即可。API Key 在控制台「API 密钥」页面创建。
- 预设
CCSub（在预设列表里选中，填 Key 即可）- API Key
sk-你的CCSub密钥- 请求地址（手动配置时）
https://www.ccsub.net（不勾选「完整 URL」）
model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。 还没有 Key？ 先注册账号。
配置步骤速览
- 1
下载安装 CC Switch
从 GitHub Releases 下载：Windows 用 .msi，macOS 用 .dmg 或 brew install --cask cc-switch，Linux 有 .deb / .rpm / .AppImage。系统要求 Windows 10、macOS 12、Ubuntu 22.04 及以上。
- 2
选择要配置的工具
打开 CC Switch，在侧边栏选 Claude Code（或 Codex、OpenCode 等），点右上角「+」添加供应商。
- 3
选 CCSub 预设并填 Key
在预设列表里搜索或点选 CCSub，把 CCSub 控制台创建的 sk- 开头的 Key 填进 API Key，点「添加」。
- 4
切换到 CCSub
在供应商卡片上点「启用」（新版本按钮叫「切换」），卡片显示「使用中」即表示已写入该工具的配置。
- 5
验证
Claude Code 新开一个会话，Codex 需要重启；发一句话后到 CCSub「使用记录」核对请求。
CC Switch 是一个开源的桌面工具，专门用来在不同 API 服务之间切换 Claude Code、Codex、OpenCode 等工具的配置。它的作用就是替你改配置文件：你在界面上点一下「切换」，它把对应的地址和 Key 写进工具的配置里，省得每次手动改环境变量。
CCSub 已经在 CC Switch 的内置预设里，大多数人只需要三步：选工具、选 CCSub 预设、填 Key。
下载安装
到 CC Switch 的 GitHub Releases 下载对应系统的安装包：
- Windows 10 及以上
.msi也有免安装的 Portable 版，x64 和 arm64 都有- macOS 12 及以上
brew install --cask cc-switch或者下载 Universal 版 .dmg- Linux
.deb / .rpm / .AppImageArch 用户可以 paru -S cc-switch-bin
方法一：用 CCSub 预设（推荐）
- 打开 CC Switch，在侧边栏选择要配置的工具，比如 Claude Code。
- 点右上角的 「+」（添加供应商）。
- 在预设列表里搜索或点选 CCSub。预设已经填好了请求地址，Claude Code 用的是
https://www.ccsub.net。 - 把 CCSub 控制台「API 密钥」页面创建的 Key（
sk-开头）粘贴到 API Key，点 「添加」。 - 在 CCSub 卡片上点 「启用」（新版本按钮文字是「切换」），卡片出现 「使用中」 就完成了。
Codex 和 OpenCode 的流程一样：在侧边栏切到对应工具，再从预设里选 CCSub。CCSub 的 Codex 预设地址是 https://www.ccsub.net/v1、走 Responses 接口，和文档里的 https://www.ccsub.net/api/v1 指向同一个接口，不用改。
方法二：自定义配置（手动填）
如果你用的是老版本、预设里找不到 CCSub，或者想自己控制每个字段，可以手动添加：
- 点 「+」，选择 「自定义配置」。
- 按下面填写：
- 供应商名称
CCSub随便起，方便自己认- 请求地址
https://www.ccsub.net不要带 /v1；不勾选「完整 URL」- API Key
sk-你的CCSub密钥- 主模型（可选）
claude-sonnet-5Sonnet / Opus / Haiku 默认模型也可以分别指定
- 点 「添加」，再在卡片上点 「启用」 / 「切换」。
model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。「完整 URL」开关只在开启本地路由时才起作用，直接使用 CCSub 时保持不勾选即可，和 CCSub 安装文档 里的写法一致。
怎么确认配置成功
- 卡片上的 「检测连通」 只检查地址能不能连上，不会验证 Key 和型号。它通过了只说明网络没问题。
- 「管理与测速」 可以看这个地址的延迟。
- 最准的办法是实际发一条消息：Claude Code 新开会话（它支持热切换），Codex 要先退出再重新启动，然后到 CCSub 控制台的「使用记录」里看有没有这条请求。
CC Switch 改了哪些文件
知道它写到哪里，出问题时才好排查：
- Claude Code：写入
~/.claude/settings.json的env（ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN）。 - Codex：写入
~/.codex/config.toml。切换时原来的~/.codex/auth.json会先备份到~/.cc-switch/codex-login-stash.json。
在工具里用 /model 临时改的型号，下次切换供应商时会被 CC Switch 按卡片配置重写回去。常用的型号最好直接写进卡片的「主模型」字段。
不想装额外工具的话，也可以手动配置：见 Claude Code 接入教程 和 Codex CLI 接入教程，完整安装步骤见 安装配置文档。
常见报错和排查
切换后 Claude Code 仍提示 401
原因：API Key 粘贴时带了空格，或者之前在 shell 里也设置了 ANTHROPIC_AUTH_TOKEN。settings.json 优先级更高，但旧变量容易让人误判。
处理：在 CC Switch 里编辑 CCSub 卡片重新粘贴 Key；用 Claude Code 的 /status 查看实际生效的地址和凭证来源。
在工具里用 /model 改的型号，切换后又变回去了
原因：CC Switch 切换供应商时会按卡片里的配置重写型号字段。
处理：把常用型号写进 CCSub 卡片的「主模型」或各默认模型字段，而不是只在工具里临时修改。
老卡片的地址和预设不一致
原因：以前用旧版预设保存的卡片不会随 CC Switch 升级自动更新。
处理：删除旧卡片，重新从预设列表添加 CCSub。
常见问题
CC Switch 里有 CCSub 预设吗？
有。CCSub 在 Claude Code、Codex、OpenCode 等工具的预设列表里都有，选中后只需要填 API Key，请求地址已经预填好。Gemini CLI 目前没有 CCSub 预设。
手动配置时请求地址填什么？
Claude Code 填 https://www.ccsub.net，不要带 /v1，也不要勾选「完整 URL」。「完整 URL」只在开启本地路由时才有作用。
点了「检测连通」显示成功，为什么还是用不了？
「检测连通」只检查地址能不能连上，不验证 Key 和型号。Key 填错、余额不足都要在实际发消息时才会报出来，看 CCSub「使用记录」最准。
切换供应商后 Codex 没变化？
Claude Code 可以热切换，Codex 需要退出后重新启动才会读取新配置。
CC Switch 会把我的配置写到哪里？
Claude Code 写入 ~/.claude/settings.json 的 env；Codex 写入 ~/.codex/config.toml。切换 Codex 时原来的 auth.json 会先备份到 ~/.cc-switch/codex-login-stash.json。
