Claude Code 配置快速切换工具

什么是 ccswitch？
ccswitch 是 Claude Code 的配置快速切换工具（桌面 GUI）。允许你轻松管理和切换不同的 API 密钥与服务商配置，无需手动修改配置文件。

⚡ 快速安装

方式 1：npm 全局安装（推荐）

最简单的方式，一行命令搞定：

npm install -g @langgenius/cc-switch
cc-switch          # 启动

优点：

• 无需下载文件，自动处理依赖
• 易于更新：npm update -g @langgenius/cc-switch
• 跨平台兼容（Windows / macOS / Linux）

方式 2：从 GitHub Releases 下载

适合网络较差或偏好图形化安装的用户：

1. 访问：https://github.com/langgenius/cc-switch/releases
2. 下载对应系统版本：
   • Windows：.exe 或 .msi
   • macOS：.dmg
   • Linux：.deb 或 .rpm
3. 双击安装或执行安装程序

---

✅ 验证安装

安装完成后，运行以下命令验证：

cc-switch --version

如果显示版本号（如 ccswitch v1.2.0），说明安装成功。

---

🚀 首次使用

启动 ccswitch

使用以下任一方式启动：

• 命令行：cc-switch
• 快捷键：Ctrl+Alt+C（Windows / Linux）或 ⌘+⌥+C（macOS）
• 菜单栏图标：macOS Dock 或 Windows 系统托盘

添加配置

1. 点击 "新增配置" 或 "+" 按钮
2. 填写配置信息：
   • 配置名称：如 "默认"、"测试供应商"、"备用"
   • ANTHROPIC_API_KEY：你的 API 密钥
   • ANTHROPIC_BASE_URL：服务商地址（可选，留空则用默认）
3. 点击 "保存"

切换配置

1. 在 ccswitch 主窗口中，点击要使用的配置
2. 配置立即生效（UI 会显示当前激活的配置）
3. 启动 Claude Code：claude
4. Claude Code 自动使用当前选中的配置

💡 提示：你可以快速切换多个供应商配置，无需重启 Claude Code 或编辑配置文件。

---

❓ 常见问题

Q: npm 找不到 cc-switch 命令
A: 确认以下两点：

• Node.js 版本 ≥ 18：node --version
• npm 全局路径在 PATH 中：npm config get prefix
• 如仍不行，尝试：npm install -g --force @langgenius/cc-switch

Q: Windows 提示"权限拒绝"或"无法执行"
A: 以管理员身份运行 PowerShell，再执行安装命令：

npm install -g @langgenius/cc-switch

Q: macOS 提示"无法验证开发者"或"已损坏"
A: 这是 macOS 的 Gatekeeper 防护。解决方案：

• 系统偏好设置 → 安全与隐私
• 在"通用"标签中，找到 ccswitch 的提示
• 点击 "仍要打开"
• 或运行：xattr -d com.apple.quarantine /Applications/cc-switch.app

Q: 切换配置后 Claude Code 没有生效
A: 重启 Claude Code：

# 杀死现有进程
pkill -f "claude"  # macOS/Linux
taskkill /IM claude.exe  # Windows

# 重新启动
claude

Q: 如何删除某个配置？
A: 在 ccswitch 主窗口中，右键点击配置 → 删除，或找到配置旁的删除按钮。配置数据存储在本地，删除不会影响 API 密钥。

Q: 支持 Linux 吗？
A: 支持。推荐用 npm 方式安装：npm install -g @langgenius/cc-switch，然后 cc-switch 启动。

---

📋 配置对照表

常见服务商的配置示例：

服务商	ANTHROPIC_BASE_URL	备注
Anthropic 官方	（留空）	默认值：api.anthropic.com
FreeModel	https://cc.freemodel.dev	国内代理服务
自建代理	https://your-proxy.com	需兼容 Anthropic API

---

🎯 推荐方案用 npm 安装最方便，一行搞定：npm install -g @langgenius/cc-switch

然后启动 cc-switch，添加你的 API 密钥和服务商配置，以后就能一键切换，无需手动编辑配置文件。

 Claude 、codex API KEY来源分享：FreeModel： Claude 、OpenAI API 中转平台使用指南-CSDN博客