Claude Code使用教程 第2篇：cc-switch配置切换工具

这篇讲 cc-switch — 一个管理 Claude Code 配置文件的工具。

适用场景

如果你：

• 工作一个账号，个人一个账号
• 不同项目用不同的 API Provider
• 经常需要切换配置
• 想根据任务选择不同能力的模型

那 cc-switch 就很有用。

模型切换场景：不同厂商的模型能力不同，根据项目复杂度选择合适的模型：

• 国外模型（Claude、GPT）：推理能力强，适合复杂架构设计、疑难问题排查
• 国内模型（通义千问、GLM-5）：性价比高，适合日常开发、简单任务

通过 cc-switch 可以快速切换不同厂商，复杂项目用国外模型，简单项目用国内模型，省钱又高效。

安装

npm install -g @aravhawk/cc-switch

验证安装：

cc-switch --version

查看当前配置

cc-switch --list

说明还没有创建任何 profile。

创建新 profile

cc-switch --create work

查看：

cc-switch --list

切换 profile

创建另一个 profile：

cc-switch --create personal

切换：

cc-switch work

查看当前状态：

cc-switch --current

删除 profile

cc-switch --delete personal

使用模板创建

cc-switch 支持从模板创建配置：

cc-switch --create my-anthropic --template anthropic --api-key sk-ant-xxx

支持的模板：

• anthropic — 官方 API
• openai — OpenAI API（兼容接口）
• bedrock — AWS Bedrock
• vertex — Google Vertex

典型使用流程

场景：工作用公司 API，个人用官方 API。

# 创建工作配置
cc-switch --create work
cc-switch work
# 配置公司的 API endpoint

# 创建个人配置
cc-switch --create personal
cc-switch personal
# 配置官方 API

日常使用：

# 工作时
cc-switch work
claude

# 个人项目
cc-switch personal
claude

多厂商模型切换

场景：根据项目复杂度选择不同厂商。

# 创建不同厂商的 profile
cc-switch --create claude-api    # 国外模型
cc-switch --create qwen          # 国内模型（通义千问）
cc-switch --create glm5          # 国内模型（GLM-5）

# 分别配置对应厂商的 API
cc-switch claude-api
# 配置 Claude 官方 API 或兼容接口

cc-switch qwen
# 配置通义千问 API

使用示例：

# 复杂架构设计，用 Claude
cc-switch claude-api
claude "帮我设计这个分布式系统的架构"

# 日常功能开发，用国内模型
cc-switch qwen
claude "帮我写一个用户登录接口"

# 简单代码优化，用国内模型
cc-switch qwen
claude "这段代码有什么问题？帮我优化一下"

省钱技巧：大部分日常开发用国内模型，遇到真正棘手的问题再切到 Claude，既保证了效率又控制了成本。

配置文件位置

cc-switch 管理的是：

~/.claude/settings.json

切换 profile 实际上是切换这个文件的内容。

项目级的 CLAUDE.md 不受影响。

最佳实践

• 切换前先创建 profile 保存当前配置
• 用有意义的名字命名 profile（如 work、personal）
• 定期清理不用的 profile

避坑提示

切换前先保存当前配置。

改完配置后，建议先创建一个 profile 保存：

cc-switch --create my-config

然后再切换到其他 profile。