Claude Code 保姆级安装教程：使用 CC-Switch 接入 DeepSeek、Qwen 等国产大模型

引言

最近几个月，Claude Code 可以说是 AI 编程领域最火的工具之一。

相比 Cursor、Cline 等工具，Claude Code 最大的特点是：

• 深度理解整个项目
• 支持终端操作
• 支持 MCP
• 支持 Agent 工作流
• 可以直接修改项目文件

很多开发者第一次体验 Claude Code 后都会有一种感觉：

这更像一个真正的 AI 开发助手，而不仅仅是代码补全工具。

但对于国内开发者来说，使用 Claude Code 往往会遇到两个问题：

• Claude 官方服务存在地域限制
• 官方 API 成本较高

因此越来越多人开始使用 CC-Switch + 国产大模型 的方案。

例如：

• DeepSeek
• 通义千问 Qwen
• 智谱 GLM
• MiniMax

本文就带大家从零开始完成 Claude Code 的安装，并通过 CC-Switch 接入国产模型。

---

目录

• 什么是 Claude Code
• 什么是 CC-Switch
• 安装 Node.js
• 安装 Claude Code
• 安装 CC-Switch
• 配置国产模型
• Claude Code 接入 CC-Switch
• 常见问题
• 使用体验

---

什么是 Claude Code？

Claude Code 是 Anthropic 推出的命令行 AI 编程工具。

可以简单理解为：

Cursor = IDE中的AI助手

Claude Code = 终端中的AI工程师

例如进入项目目录：

claude

然后直接提问：

分析当前项目结构

帮我修复登录接口报错

增加一个用户管理模块

解释这个异常日志

Claude Code 会自动：

• 阅读项目代码
• 分析依赖关系
• 修改文件
• 执行终端命令

甚至能够完成多步任务。

---

什么是 CC-Switch？

很多人第一次看到 CC-Switch 会有些疑惑。

它到底解决什么问题？

简单理解：

CC-Switch 是 Claude Code 的模型切换器。

默认情况下：

Claude Code
↓
Anthropic API
↓
Claude模型

而使用 CC-Switch 后：

Claude Code
↓
CC-Switch
↓
DeepSeek
Qwen
GLM
MiniMax

这样就可以使用国产模型替代官方模型。

优点非常明显：

• 成本更低
• 配置简单
• 模型选择更多
• 不受官方模型限制

---

安装 Node.js

Claude Code 基于 Node.js 运行。

因此首先需要安装 Node.js。

进入官网下载安装：

https://nodejs.org

推荐安装 LTS 版本。

安装完成后打开终端验证：

node -v
npm -v

如果能够正常输出版本号：

v22.x.x
10.x.x

说明安装成功。

建议安装时勾选自动配置环境变量选项。

---

安装 Claude Code

目前官方推荐两种安装方式。

---

方式一：官方脚本安装（推荐）

Linux/macOS：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

---

方式二：npm安装

npm install -g @anthropic-ai/claude-code

安装完成后验证：

claude --version

输出类似：

1.x.x

表示安装成功。

---

Claude Code 登录

首次运行：

claude

或者：

claude auth login

根据提示完成认证。

如果后续准备通过 CC-Switch 使用国产模型，这一步并不是必须的。

---

安装 CC-Switch

CC-Switch 是目前比较流行的 Claude Code 模型切换工具。

---

Windows

前往 GitHub Release 页面下载：

• .exe 安装版
• .zip 便携版

安装后直接启动即可。

如果出现 SmartScreen 提示：

Windows 已保护你的电脑

点击：

更多信息
↓
仍要运行

即可。

---

macOS

使用 Homebrew：

brew tap farion1231/ccswitch
brew install --cask cc-switch

如果出现：

无法验证开发者

进入：

系统设置
↓
隐私与安全性

手动允许即可。

---

Linux

下载安装包：

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_3.10.x_amd64.deb

安装：

sudo dpkg -i cc-switch_3.10.x_amd64.deb

---

配置国产模型

启动 CC-Switch 后。

点击右上角：

+

添加新的 API 供应商。

---

配置 DeepSeek

填写：

名称：
DeepSeek

API Base URL：
https://api.deepseek.com

API Key：
你的Key

模型：

deepseek-chat

或者：

deepseek-reasoner

---

配置 Qwen

填写：

API Base URL：
https://dashscope.aliyuncs.com/compatible-mode/v1

模型：

qwen-max
qwen-plus

---

配置智谱 GLM

填写：

API Base URL：
https://open.bigmodel.cn/api/paas/v4

模型：

glm-4
glm-4-air

---

Claude Code 接入 CC-Switch

配置完成后：

1. 选择对应供应商
2. 点击启用
3. 打开：

应用到 Claude Code 插件

然后：

重启终端

或者：

重启 IDE

即可生效。

之后执行：

claude

所有请求会自动转发到对应模型。

---

常见问题

1. Claude 命令无法识别

检查：

node -v
npm -v

确认 Node.js 已安装。

然后重新安装：

npm install -g @anthropic-ai/claude-code

---

2. API Key 无效

确认：

API Key 是否复制完整

是否开通对应模型权限

账户余额是否充足

---

3. 模型不存在

很多平台模型名称不同。

例如：

错误：

deepseek-v3

正确：

deepseek-chat

建议查看平台官方文档确认模型名称。

---

4. MCP 工具调用失败

很多情况并不是 Claude Code 的问题。

而是：

MCP Server 没有启动

建议先单独验证 MCP 服务是否正常运行。

---

我的使用建议

经过最近一段时间体验。

如果是：

日常代码开发

推荐：

DeepSeek-V3

性价比非常高。

---

中文项目

推荐：

Qwen-Max

中文理解能力表现不错。

---

企业内部部署

推荐：

Qwen + Xinference

通过 OpenAI 兼容接口接入。

既能保证数据安全，也能控制成本。

---

总结

Claude Code 的核心价值并不是 Claude 模型本身。

真正强大的地方在于：

Agent 化的软件开发体验。

而 CC-Switch 则解决了模型选择的问题。

通过它，我们可以非常方便地接入：

• DeepSeek
• Qwen
• GLM
• MiniMax

等国产模型。

对于个人开发者来说，不仅能降低使用成本，也能获得更灵活的开发体验。

如果你已经在使用 Claude Code，欢迎在评论区分享一下你目前使用的是哪家模型，以及实际体验如何。