cc-switch
English README | 中文文档
一个简单的 CLI 工具,用于管理多个 Claude API 配置。
在不同项目或环境中使用 Claude API 时,经常需要切换 API 令牌和设置。cc-switch 让这个过程变得轻松:
- 用易记的名称存储多个配置
- 在它们之间即时切换
- 自动启动带有正确环境变量的 Claude
- 保持 API 密钥的安全和组织
快速开始
# 安装
# 添加你的第一个配置
# 添加另一个配置
# 切换到工作配置
# 切换到个人配置
# 查看所有配置
安装
Cargo(推荐)
Homebrew
主要命令
| 命令 | 作用 |
|---|---|
cc-switch add <名称> <令牌> <URL> |
添加新配置 |
cc-switch use <名称> |
切换到配置 |
cc-switch list |
显示所有配置 |
cc-switch remove <名称> |
删除配置 |
cc-switch current |
交互菜单 |
高级用法
交互模式
# 进入交互模式(无需参数)
# 或通过 current 命令访问
添加模型配置
# 添加自定义模型配置
# 添加后台任务用的快速模型
Shell 集成
# 生成 Shell 补全
# 创建便捷别名
# 现在可以使用:
工作原理
cc-switch 将配置存储在 ~/.cc-switch/configurations.json 中,并启动带有适当环境变量的 Claude。这意味着:
- ✅ 不修改全局配置
- ✅ 配置之间完全隔离
- ✅ 安全的 API 密钥管理
- ✅ 适用于任何 Claude 安装
环境变量
工具在启动 Claude 时设置这些环境变量:
ANTHROPIC_AUTH_TOKEN- 你的 API 令牌ANTHROPIC_BASE_URL- API 端点 URLANTHROPIC_MODEL- 自定义模型(可选)ANTHROPIC_SMALL_FAST_MODEL- 后台任务快速模型(可选)
开发
# 克隆
# 构建
# 测试
许可证
MIT 许可证 - 详见 LICENSE 文件。
由 Linuxdazhao 用 ❤️ 制作