CC-Switch 完整下载、安装与使用教程(Claude Code 配置 2026.5.12)
Claude Code CC-Switch 完整下载、安装与使用教程
CC-Switch 是Claude Code 专用的切换/配置工具，核心作用是快速切换 Claude Code 环境、配置密钥、管理使用权限，是 Claude Code 开发者的高效辅助工具。
一、前置准备
- 拥有Claude Code 访问权限（Anthropic 官方授权/企业版）
- 电脑系统：Windows / macOS / Linux 均可
- 已安装Node.js 16+（推荐 18+）：Node.js 下载
- 拥有Anthropic API Key（Claude Code 必备）
二、CSwitch 下载
官方推荐下载方式（最安全、最新版）
CSwitch ，直接下载最新发行版：
|下载| ：https://pan.quark.cn/s/d6152047213b
下载步骤：
- 打开上面链接
- 找到最新版本（Latest）
- 根据你的系统下载对应包：
- Windows：
cc-switch-win.exe - macOS：
cc-switch-macos - Linux：
cc-switch-linux
—
- Windows：
三、安装教程（超简单，无需编译）
CC-Switch 是绿色免安装工具，下载后直接可用，只需简单配置。
Windows 安装/配置
- 把下载的
cc-switch-win.exe放到一个固定文件夹（例如D:\Tools\CC-Switch） - 添加系统环境变量（方便全局调用）
- 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
- 在「系统变量」找到
Path→ 编辑 → 新建 - 粘贴你的 CC-Switch 文件夹路径（如
D:\Tools\CC-Switch）
- 打开CMD / PowerShell，输入测试：
出现版本号 = 安装成功cc-switch --version
macOS / Linux 安装
- 打开终端，进入下载目录：
cd~/Downloads - 赋予执行权限：
chmod+x cc-switch-macos - 移动到系统命令目录（全局调用）：
sudomvcc-switch-macos /usr/local/bin/cc-switch - 测试：
cc-switch-v
四、初始化配置（第一次必做）
打开终端，执行初始化命令：
cc-switch init按提示输入：
- Anthropic API Key（你的 Claude Code 密钥）
- 默认环境（一般选
claude-code） - 代理配置（可选，国内用户建议配置）
配置完成后，会自动生成配置文件：
- 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-pro3. 快速切换 API Key
cc-switch keyset<你的新API密钥>4. 查看所有可用环境
cc-switch list5. 登录/登出 Claude Code
cc-switch login cc-switchlogout6. 测试连接是否正常
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 权限
- 联系企业管理员开通
总结
- CC-Switch 是绿色工具，下载 → 配置环境变量 → 初始化即可用
- 核心命令：
init(初始化)、use(切换环境)、status(查看状态)、key set(改密钥) - 国内必须配代理，否则无法连接 Anthropic 服务
- 全程无需安装，直接命令行使用
需要我给你提供国内专用一键配置脚本吗？我可以直接生成适合你系统的自动配置命令，复制粘贴就能用～