Claude Code CC-Switch 完整下载、安装与使用教程

CC-Switch 是Claude Code 专用的切换/配置工具，核心作用是快速切换 Claude Code 环境、配置密钥、管理使用权限，是 Claude Code 开发者的高效辅助工具。

一、前置准备

1. 拥有Claude Code 访问权限（Anthropic 官方授权/企业版）
2. 电脑系统：Windows / macOS / Linux 均可
3. 已安装Node.js 16+（推荐 18+）：Node.js 下载
4. 拥有Anthropic API Key（Claude Code 必备）

二、CSwitch 下载

官方推荐下载方式（最安全、最新版）

CSwitch ，直接下载最新发行版：

|下载| ：https://pan.quark.cn/s/d6152047213b

下载步骤：

1. 打开上面链接
2. 找到最新版本（Latest）
3. 根据你的系统下载对应包：
   • Windows：cc-switch-win.exe
   • macOS：cc-switch-macos
   • Linux：cc-switch-linux
     —

三、安装教程（超简单，无需编译）

CC-Switch 是绿色免安装工具，下载后直接可用，只需简单配置。

Windows 安装/配置

1. 把下载的cc-switch-win.exe放到一个固定文件夹（例如D:\Tools\CC-Switch）
2. 添加系统环境变量（方便全局调用）
   • 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
   • 在「系统变量」找到Path→ 编辑 → 新建
   • 粘贴你的 CC-Switch 文件夹路径（如D:\Tools\CC-Switch）
3. 打开CMD / PowerShell，输入测试：

   cc-switch --version

   出现版本号 = 安装成功

macOS / Linux 安装

1. 打开终端，进入下载目录：

   cd~/Downloads

2. 赋予执行权限：

   chmod+x cc-switch-macos

3. 移动到系统命令目录（全局调用）：

   sudomvcc-switch-macos /usr/local/bin/cc-switch

4. 测试：

   cc-switch-v

四、初始化配置（第一次必做）

打开终端，执行初始化命令：

cc-switch init

按提示输入：

1. Anthropic API Key（你的 Claude Code 密钥）
2. 默认环境（一般选claude-code）
3. 代理配置（可选，国内用户建议配置）

配置完成后，会自动生成配置文件：

• Windows：C:\Users\你的用户名\.cc-switch\config.json
• macOS/Linux：~/.cc-switch/config.json

✅ 配置成功提示：

CC-Switch 初始化完成！ 已连接 Claude Code 服务

五、核心使用命令（最常用）

1. 查看当前状态

cc-switch status

显示：当前环境、API 状态、登录信息

2. 切换 Claude Code 环境

cc-switch use<环境名>

示例：

cc-switch use claude-code cc-switch use claude-code-pro

3. 快速切换 API Key

cc-switch keyset<你的新API密钥>

4. 查看所有可用环境

cc-switch list

5. 登录/登出 Claude Code

cc-switch login cc-switchlogout

6. 测试连接是否正常

cc-switchping

返回success说明完全可用。

六、国内用户必备：代理配置

如果你在国内，必须配置代理才能正常使用 CC-Switch + Claude Code。

打开配置文件：

cc-switch config edit

添加代理字段：

"proxy":"http://127.0.0.1:7890"

（改为你自己的代理端口）

保存后重启生效：

cc-switch restart

七、常见问题（必看）

1. 提示 command not found

• 未添加环境变量
• 未执行 chmod +x（mac/Linux）
• 重新打开终端再试

2. 连接超时 / 无法访问

• 未配置代理
• API Key 错误或过期
• 网络问题

3. 无权限使用 Claude Code

• 你的账号未开通 Claude Code 权限
• 联系企业管理员开通

总结

1. CC-Switch 是绿色工具，下载 → 配置环境变量 → 初始化即可用
2. 核心命令：init(初始化)、use(切换环境)、status(查看状态)、key set(改密钥)
3. 国内必须配代理，否则无法连接 Anthropic 服务
4. 全程无需安装，直接命令行使用

需要我给你提供国内专用一键配置脚本吗？我可以直接生成适合你系统的自动配置命令，复制粘贴就能用～