随着像 Claude Code
这样强大的代码辅助工具的出现,越来越多的云服务商和平台开始提供兼容 Anthropic
API 规范的第三方接口。开发者们可能因为成本、区域延迟或特定模型(如 qwen
、k2
、glm
)的偏好,需要在不同服务商之间切换。但频繁地修改 ANTHROPIC_BASE_URL
和 ANTHROPIC_AUTH_TOKEN
这两个环境变量,无疑是一件繁琐且容易出错的工作。
为了解决这个痛点,一个名为 ccc
(Claude Code Configuration Switcher)的命令行小工具应运而生。它让开发者能够通过一条简单的命令,快速在预设的多个 API 服务商配置之间进行切换,极大地提升了工作效率。
下载与安装
首先,你需要从项目的官方源码仓库获取它。原始文章提供的网盘链接不利于追踪更新,建议直接从 GitHub
等公开代码平台获取。安装过程非常直接,只需将源码克隆到本地,然后运行安装脚本。
为了方便管理,推荐将其安装在用户个人目录下,这样无需管理员权限。
下载地址1:https://github.com/shushin123/cccs
下载地址2:https://pan.quark.cn/s/4962ab712997
# 假设你已经通过 git clone 获取了源码
cd ccc
./install-user.sh
安装脚本会将 ccc
工具的路径和必要的环境变量设置添加到你的 shell 配置文件中(如 .zshrc
或 .bash_profile
)。为了让配置立即生效,你需要重新加载它。
# 如果你使用 zsh
source ~/.zshrc
# 如果你使用 bash
source ~/.bash_profile
初始化配置
安装完成后,第一步是初始化 ccc
的配置。执行以下命令,工具会引导你为各个预设的服务商设置 API Key
。
ccc init
执行后,终端会逐一询问每个服务商的 API
令牌。你只需将相应的 Key
粘贴进去然后按回车即可。如果暂时没有某个服务商的 Key
,直接按回车跳过,后续可以随时补充。
正在初始化 ccc 配置...
设置 qwen 配置:
基础 URL: https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
请输入 qwen 的 API 令牌 (按回车键跳过): sk-ant-api03-xxxx...
✓ qwen 配置已保存
设置 k2 配置:
基础 URL: https://api.moonshot.cn/anthropic
请输入 k2 的 API 令牌 (按回车键跳过):
已跳过 k2 配置
日常使用
ccc
的核心功能就是切换。它的命令设计得非常直观。
查看可用服务商
你可以随时查看当前支持和配置状态。
ccc list
输出会清晰地列出所有可用的服务商,并用符号标记出哪些已经配置了 API Key
。
可用服务商:
qwen - 已配置 ✓
k2 - 已配置 ✓
glm - 未配置
一键切换
当需要切换到某个服务商时,比如阿里云的 qwen
,只需执行:
ccc qwen
命令执行后,ccc
会立即更新当前终端会话的环境变量,并显示切换结果,让你确认配置已生效。
已切换到 qwen 配置:
ANTHROPIC_AUTH_TOKEN: sk-ant-api03-xxxx...
ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
✅ 环境变量已在当前会话中生效:
ANTHROPIC_AUTH_TOKEN=sk-ant-api03-xxxx...
ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy
现在,你在这个终端中运行的任何 Claude Code
应用都会自动使用 qwen
的接口。切换到其他服务商,如 k2
(Moonshot
) 或 glm
,操作完全相同。
高级用法
添加自定义服务商
如果你使用的 API 服务商不在预设列表中,可以很方便地手动添加。
ccc add myapi https://api.example.com/anthropic
系统会提示你输入该服务商的 API
令牌,完成后即可像使用预设服务商一样进行切换。
添加新服务商: myapi
基础 URL: https://api.example.com/anthropic
请输入 myapi 的 API 令牌: your-custom-key
✓ 服务商 'myapi' 添加成功
手动编辑配置文件
所有的配置都存储在用户主目录下的一个纯文本文件中 (~/.cc-switch-config
)。你可以直接使用文本编辑器进行更灵活的修改,例如批量添加、删除或修改服务商信息。
文件格式很简单,每行代表一个服务商,格式为:服务商名称|Base URL|API Key
。
# cc-switch configuration file
# Format: provider_name|base_url|auth_token
qwen|https://dashscope.aliyuncs.com/api/v2/apps/claude-code-proxy|your-api-key-here
k2|https://api.moonshot.cn/anthropic|your-api-key-here
glm|https://open.bigmodel.cn/api/anthropic|your-api-key-here