Setting Up Claude Code (2): CC Switch

把 Claude Code CLI 接到 TT API 的轻量方案:CC Switch 是个桌面 App,通过 ccswitch:// 协议链接一键导入 provider 配置,不需要常驻代理进程。在 TT API 控制台「API Keys」页点 "CC 切换" 按钮即可生成导入链接。本文对比 CC Switch 与 CCR、给出完整步骤。


CC Switch 是什么

CC Switch 是一个小工具(CLI / 桌面端可选),核心做两件事:

  1. 在多套 ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN 配置之间快速切换
  2. 启动 Claude Code 时把对应配置注入环境变量

适合"主要用官方账号,偶尔切到我们这边"或反过来的用户。


和 CCR 方案的区别

维度 CCR CC Switch
工作机制 本地起代理进程 :3456 改环境变量后启动 claude
是否常驻 是(需要 ccr start 在跑) 否(一次性注入)
多模型路由 强(不同任务路由到不同 provider) 弱(一次只用一个 provider)
切换速度 改 config.json 再重启 一条命令秒切
适用场景 复杂多 provider 编排 简单二/三选一切换

安装

npm install -g cc-switch

配置 profile

每个 profile = 一套 endpoint + key。新增一个指向我们的:

cc-switch add ttapi \
  --base-url https://api.ttapi.cc/v1 \
  --token sk-...

也可以保留原有的官方 profile:

cc-switch add anthropic-official \
  --base-url https://api.anthropic.com \
  --token sk-ant-...

查看已配置的 profile:

cc-switch list

输出示例:

  anthropic-official    https://api.anthropic.com
* ttapi                 https://api.ttapi.cc/v1   (active)

* 的是当前激活的。


切换

切到我们:

cc-switch use ttapi

切回官方:

cc-switch use anthropic-official

切换后直接启动 Claude Code:

claude

无需任何额外步骤——CC Switch 已经把环境变量写到当前 shell 配置(~/.zshrc / ~/.bashrc)里了。


验证当前激活的 profile

cc-switch status

或直接看环境变量:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN | head -c 12

在两套配置间快速来回

典型场景:白天用我们这边(公司账号 / 统一计费),晚上做个人项目切回官方个人账号。

# 白天
cc-switch use ttapi
claude

# 晚上
cc-switch use anthropic-official
claude

切换是 shell 级别的,不影响其他终端窗口。如果想全局生效,重启 terminal 或 source ~/.zshrc


怎么选:CCR 还是 CC Switch?

你的场景 推荐
只用我们一家 直接配 ANTHROPIC_BASE_URL 环境变量,不用 CCR/CC Switch
在我们 + 官方之间切 CC Switch
想在不同任务用不同 provider/model(如 think 用 Claude、coding 用 GPT、long context 用 Gemini) CCR
团队多人共享配置 CCR(config.json 可入 git)

常见问题

Q:CC Switch 把 token 存在哪? A:明文写在 ~/.cc-switch/config.json。注意这个文件不要进 git 仓库(加到 .gitignore)。

Q:切换后老的终端窗口不生效? A:环境变量只对新开的 shell 生效。旧窗口要 source ~/.zshrc 或重开。

Q:能脚本化自动切吗? A:可以。cc-switch use ttapi --silent 适合 CI / 启动脚本。