cc-switch 配置 Claude Code 完整指南

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，而 cc-switch 则是一个实用的配置管理工具，可以帮你在不同模型之间灵活切换。本文将详细介绍如何配置 cc-switch 来管理 Claude Code。

什么是 cc-switch

cc-switch 是一个开源工具，专门用于管理 Claude Code 的模型配置。通过它，你可以：

• 在多个 Claude 模型之间快速切换
• 管理不同 API Key 的配置
• 一键切换不同的模型参数配置
• 简化 Claude Code 的配置流程

环境准备

在开始之前，确保你的系统满足以下条件：

必备条件

1. Node.js 环境：建议 v18 或更高版本
2. Claude Code 已安装：确保 Claude Code CLI 已正确安装并可用
3. API Key：已获取 Anthropic API Key 或其他支持的 API 密钥

检查环境

# 检查 Node.js 版本
node -v

# 检查 Claude Code 是否安装
claude --version

安装 cc-switch

方式一：全局安装

npm install -g cc-switch

方式二：项目本地安装

npm install cc-switch --save-dev

安装完成后，验证安装是否成功：

cc-switch --version

配置步骤

步骤一：初始化配置

首次使用需要进行初始化配置：

cc-switch init

这会在你的项目根目录或用户目录下创建配置文件。

步骤二：添加 API 配置

添加你的 API 配置信息：

cc-switch add

按提示输入以下信息：

• 配置名称：如 claude-opus、claude-sonnet 等
• API Key：你的 Anthropic API Key
• 模型名称：如 claude-3-opus-20240229
• Base URL（可选）：如使用代理或自定义端点

步骤三：切换模型配置

在不同配置之间切换：

# 列出所有可用配置
cc-switch list

# 切换到指定配置
cc-switch use claude-opus

步骤四：验证配置

验证当前配置是否生效：

cc-switch current

配置文件说明

cc-switch 的配置文件通常位于：

• 全局配置：~/.cc-switch/config.json
• 项目配置：./.cc-switch/config.json

配置文件结构示例：

{
  "configs": [
    {
      "name": "claude-opus",
      "apiKey": "sk-ant-...",
      "model": "claude-3-opus-20240229",
      "baseUrl": "https://api.anthropic.com"
    },
    {
      "name": "claude-sonnet",
      "apiKey": "sk-ant-...",
      "model": "claude-3-5-sonnet-20241022",
      "baseUrl": "https://api.anthropic.com"
    }
  ],
  "current": "claude-opus"
}

常见使用场景

场景一：多账号管理

如果你有多个 Anthropic 账号，可以为每个账号创建独立配置：

# 添加工作账号配置
cc-switch add --name work-account

# 添加个人账号配置
cc-switch add --name personal-account

# 工作时切换到工作账号
cc-switch use work-account

场景二：不同模型快速切换

在不同 Claude 模型之间切换：

# 使用 Opus 模型处理复杂任务
cc-switch use claude-opus

# 使用 Sonnet 模型处理日常任务
cc-switch use claude-sonnet

# 使用 Haiku 模型处理简单任务
cc-switch use claude-haiku

场景三：代理配置

如果你需要通过代理访问 API：

cc-switch add --name proxy-config --baseUrl https://your-proxy.com/v1

常见问题

Q: 配置文件找不到？

检查配置文件路径是否正确，或重新运行 cc-switch init 初始化。

Q: API Key 不生效？

确保 API Key 格式正确，Anthropic API Key 通常以 sk-ant- 开头。

Q: 切换后 Claude Code 没有变化？

Claude Code 可能需要重启才能加载新配置。尝试：

# 退出当前 Claude Code 会话
# 重新启动 Claude Code
claude

Q: 如何删除配置？

cc-switch remove <config-name>

进阶技巧

环境变量方式

除了配置文件，cc-switch 也支持通过环境变量设置：

export ANTHROPIC_API_KEY=sk-ant-...
export ANTHROPIC_MODEL=claude-3-opus-20240229

配置备份

定期备份你的配置文件：

cp ~/.cc-switch/config.json ~/.cc-switch/config.json.backup

配置同步

如果你在多台机器上工作，可以将配置文件同步到云端（注意保护 API Key 安全）。

安全建议

1. 不要提交配置文件到版本控制：将 .cc-switch/ 添加到 .gitignore
2. 定期轮换 API Key：建议每 90 天更换一次
3. 使用环境变量：在生产环境中优先使用环境变量
4. 限制 API Key 权限：在 Anthropic 控制台设置使用限制

总结

cc-switch 是管理 Claude Code 配置的实用工具，通过它你可以：

• 管理多个 API 配置
• 在不同模型间快速切换
• 提高开发效率

按照本文步骤配置后，你就可以在 Claude Code 中灵活使用不同的模型了。