Claude Code �����̳̣�ͨ�� cc-switch �л�����ģ��
| .gitignore | ||
| README.md | ||
Claude Code + cc-switch 国内部署教程
通过 cc-switch 接入国内模型，零门槛部署 Claude Code。
目录
1. 什么是 cc-switch？
cc-switch 是一款开源桌面工具，用于管理 AI 编程工具的模型供应商配置。
官方资源：
- 官网：https://ccswitch.io
- GitHub：https://github.com/farion1231/cc-switch
- 下载：https://ccswitch.io/download
核心功能：
- 50+ 内置供应商预设（硅基流动、MiniMax、智谱等）
- 可视化界面管理 API 配置
- 一键切换模型供应商
- 支持 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具
- 本地路由转发请求，保护 API Key 安全
2. 准备工作
需要准备
| 软件 | 版本要求 | 用途 |
|---|---|---|
| Node.js | 18+ | Claude Code 运行依赖 |
| Git | 最新版 | 版本控制（可选） |
| 国内模型 API Key | - | 调用模型 |
环境检查
打开终端，输入以下命令验证：
node --version # 应显示 v18 或更高
npm --version # 应显示 9 或更高
3. 安装 Node.js
方式1：官网下载（推荐）
下载地址：https://nodejs.org/
选择 LTS（长期支持版），Windows 用户下载 .msi 安装包。
方式2：winget 安装
winget install OpenJS.NodeJS.LTS
方式3：国内镜像
如果网络慢，使用淘宝镜像：
# 设置 npm 镜像
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
4. 安装 Claude Code
安装命令
npm install -g @anthropic-ai/claude-code
验证安装
claude --version
首次登录
运行 Claude Code 时会提示登录：
claude
按提示完成认证流程。
5. 安装 cc-switch
下载安装
- 访问 https://ccswitch.io/download
- 下载对应系统的安装包（Windows / macOS / Linux）
- 安装并启动
Windows 一键安装包
感谢 @K1evL 提供的 Windows 一键安装包：
- GitHub：https://github.com/K1evL/claudecode-setup
- 自动配置 Node.js 环境
6. 注册国内模型 API
推荐使用以下国内模型服务商：
6.1 硅基流动（SiliconFlow）
官网：https://www.siliconflow.cn/
特点：
- 50+ 内置预设，即插即用
- 覆盖 Claude、GPT、DeepSeek、通义千问等
- 按量计费
注册步骤：
- 访问 https://www.siliconflow.cn/
- 注册账号（可用手机号）
- 进入控制台 → API Keys → 创建新密钥
- 复制保存 API Key
6.2 其他供应商
| 供应商 | 预设支持 | 特点 |
|---|---|---|
| 智谱 AI (GLM) | ✓ | 国产旗舰模型 |
| MiniMax | ✓ | 性价比高 |
| 阿里云通义 | ✓ | 稳定可靠 |
| DeepSeek | ✓ | 代码能力强 |
| 百度文心 | ✓ | 中文优化 |
7. 配置 cc-switch
7.1 添加供应商
- 打开 cc-switch
- 点击左侧 Providers
- 点击 + 添加
- 选择预设或手动配置
7.2 填写 API Key
以硅基流动为例：
- 选择 SiliconFlow 预设
- 填入 API Key
- 设置模型映射：
- Main Model：主力模型（如 glm-4）
- Haiku：快速响应模型
- Sonnet：平衡模型
- Opus：高端模型
7.3 一键切换
配置完成后，点击托盘图标即可在不同供应商之间切换。
8. 验证部署
测试 Claude Code
# 在终端输入
claude
# 测试对话
claude --print "你好，请自我介绍"
验证模型切换
- 在 cc-switch 中切换到不同供应商
- 再次运行 Claude Code
- 观察响应模型是否变化
9. 常见问题
Q1: npm 安装失败怎么办？
A: 尝试切换 npm 镜像源：
npm config set registry https://registry.npmmirror.com
或使用国内加速：
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
Q2: cc-switch 显示连接失败？
A: 检查以下几点：
- API Key 是否正确
- 网络能否访问供应商
- 供应商账户是否余额充足
Q3: Claude Code 提示需要登录？
A: 首次使用需要认证：
claude
# 按提示完成浏览器认证
Q4: 如何查看当前使用的模型？
A: 在 cc-switch 的 Dashboard 中可以看到：
- 当前供应商
- 请求用量
- Token 消耗统计
Q5: 切换供应商后没生效？
A: 尝试：
- 重启 cc-switch
- 完全退出 Claude Code 后重新启动
- 检查 cc-switch 日志
相关资源
贡献
欢迎提交 Issue 和 Pull Request！
最后更新：2026年7月