使用教程
CC Switch
使用 CC Switch 管理 Claude Code 的多套网关配置。
适用说明
CC Switch 适合在多套 Claude Code 配置之间快速切换，比如测试环境、正式环境，或者不同站点。 站点根地址、令牌和模型都由后台决定。
安装思路
CC Switch 的常见用法是维护多套 Claude Code 配置，再按需切换。由于不同安装包或版本的命令名可能存在差异，建议先在当前环境确认实际可执行命令。
检查命令
先确认本地命令可用。
bash
ccs --help
推荐配置内容
无论具体使用哪一个版本，通常都要准备下面几项：
- 配置名称，例如
prod、test - 站点根地址，例如
https://api.example.com - Claude Code 令牌，例如
sk-your-token - 默认模型，例如
claude-3-5-sonnet-latest
示例：为 Claude Code 准备两套配置
正式环境
生产配置示例。
shell
ANTHROPIC_BASE_URL="https://api.example.com" ANTHROPIC_AUTH_TOKEN=sk-prod-token
测试环境
测试配置示例。
shell
ANTHROPIC_BASE_URL="https://api.example.com" ANTHROPIC_AUTH_TOKEN=sk-test-token
CC Switch 的职责是在不同配置之间切换，而不是修改后端本身。
切换后的验证方式
验证切换结果
切换后重新打开终端再运行命令。
bash
claude
如果 Claude Code 能正常发起请求，就说明当前配置已经生效。
使用建议
- 正式和测试环境使用不同令牌，便于审计
- 不同站点可以映射到不同模型列表，避免误用
- 把配置名称和站点用途对应清楚，后续维护会轻松很多
常见排查
1. 切换后仍然连到旧地址
通常是终端环境没有刷新，或者旧变量还残留在当前 shell 里。
2. 切换成功但 Claude Code 报认证错误
检查当前配置引用的令牌是否过期，或者是否被禁用。