# 从零开始，在国内用上 Claude Code 保姆教程（含 CC Switch 配置详解）

## 前言

这一周，AI 圈又炸了。
上周，Anthropic 刚刚发布了 **Claude Opus 4.7**，号称推理能力再上一个台阶。还没等大家缓过神来，这周：
- **GPT-5.5** 悄然上线；
- **GPT-image-2** 让文生图卷出了新高度；
- **DeepSeek V4** 带着超长上下文杀回战场；
- 连小米都发布了 **MiMo-V2.5 系列大模型**，手机厂商也来分一杯羹。

一个新模型刚出炉，下一个更强的模型已经在路上了。这种“周更”式的迭代速度，让很多普通用户和开发者感到眼花缭乱：**我到底该学哪个？该用哪个？**
这里有一个很重要的事实：**模型会不断被替代，但好的“Agent 框架”是更持久的基础设施。**
而在目前所有 Agent 框架中，公认最强的就是 **Claude Code**。
好消息是：Claude Code 不绑定 Claude 官方模型，你可以给它换上国内能直接调用的模型（比如智谱 GLM、MiniMax、Kimi 等）。**没有外国手机号、没有特殊网络、没有 Visa 卡，一样能用。**
我们会先讲清楚核心概念（尤其是 **CC Switch** 这个关键工具），然后再由我来补充具体的部署步骤。请耐心看完概念部分，这对后续实操很有帮助。
本教程专门为 **Windows 用户** 打造，从零开始安装 Claude Code，并通过 **CC Switch** 接入国产模型。概念+实操，每一步都有说明，新手也能轻松跟上。

----
## 一、为什么需要 CC Switch？

Claude Code 是一个 Agent 框架 —— 你可以理解成一个能自动干活（读文件、写代码、执行命令）的智能助手外壳。但这个外壳里面需要装一个「大脑」，也就是大语言模型。
原版 Claude Code 默认搭配官方 Claude 模型，国内用户很难直接用。所以我们需要一个工具，给 Claude Code 换上国内能调用的模型。
**CC Switch**（Claude Code Switch）就是做这件事的工具。它是一个图形化小工具，可以让你：
- 添加任意兼容 OpenAI API 格式的模型（包括智谱、MiniMax、Kimi 等国产模型）。
- 一键切换当前 Claude Code 使用的模型。
- 管理多个 API Key 和模型配置。

一句话：**CC Switch = 给 Claude Code 换大脑的遥控器**。


----
## 二、新手需要了解的专业名词

>下面几个词会在后续部署中反复出现，花 3 分钟看完，你会轻松很多。

### 1. Agent 框架

即 Claude Code 本身。它负责接收你的指令，然后自主决定读哪些文件、执行哪些命令、生成哪些代码。它调用背后的「大脑」（大语言模型）来做规划和推理。
### 2. API Key（密钥/令牌）

你用的国产模型（如 GLM）运行在智谱等公司的云端服务器上。你的电脑需要通过网络向服务器发请求。**API Key 就是证明你身份的通行证**。你在模型官网注册账号后可以申请一个 Key，填到 CC Switch 里，Claude Code 就能用它调用模型了。
### 3. PATH 环境变量

你在终端输入 `claude` 命令时，系统需要知道这个命令对应的程序文件放在哪。PATH 就是系统的一个「地图」，记录了多个文件夹路径。如果安装后输入 `claude` 提示 `command not found`，多半是 PATH 没配好。Windows 上通常安装程序会自动配置，如果不行我们手动加一下。
### 4. winget（Windows 包管理器）

Windows 官方的包管理器，可以理解成「命令行版的应用商店」。用一条命令就能安装、更新软件。本教程中我们会用 winget 来安装 Git 和 Claude Code。
### 5. CLAUDE.md

这是 Claude Code 的配置文件，用来设定你和 AI 之间的协作规则。比如：
- 语言风格（直接一点还是客气一点）
- 哪些操作必须停下来问你（删除文件、改密钥等）
- 项目的目录结构约定

它分两种：**全局**（`%USERPROFILE%\.claude\CLAUDE.md`，所有项目生效）和**项目级**（项目文件夹内，只对当前项目生效）。建议新手第一天就把全局 CLAUDE.md 写好，能省掉后续很多麻烦。
### 6. 上下文污染

如果你在电脑根目录（如 `C:\`）启动 Claude Code，它会看到你整个电脑的所有文件夹，信息量太大，容易导致分析变慢、误操作。正确做法是：为每个项目建独立文件夹，`cd` 进去再启动 Claude Code，这样它只关注当前项目，更干净、更聪明。


----
## 三、部署实操（Windows 版）

### 准备工作

- 操作系统：Windows 10 / Windows 11 均可。
- 终端：使用系统自带的 **PowerShell** 或 **命令提示符（CMD）**。推荐 PowerShell。
- 全程不需要特殊网络环境，但速度可能稍慢，请耐心等待。


----
### 3.1 安装 Git（必须）

Claude Code 在 Windows 上依赖 Git Bash 来执行部分命令，所以必须先装 Git。
打开 PowerShell（任务栏搜索「PowerShell」，右键「以管理员身份运行」更好，但不是必须）。
执行：
```
winget install Git.Git
```
![image-20260425190714108](https://developer.qcloudimg.com/http-save/yehe-11910509/e26ef7f88289f5b001815bec01f7f0df.png)
等待完成，看到「已成功安装」即可。
验证 Git 是否装好：
```
git --version
```
输出版本号（如 `git version 2.42.0`）即成功。

----
### 3.2 安装 Claude Code

#### 情况A：有特殊网络条件

在 PowerShell 中执行：
```
irm https://claude.ai/install.ps1 | iex
```
等待片刻，安装完成。
#### 情况B：没有特殊网络条件（推荐）

使用 winget 安装：
```
winget install Anthropic.ClaudeCode
```
![ee57276e92962489d9ff935d6d6ca88f](https://developer.qcloudimg.com/http-save/yehe-11910509/058efad0deaafd16905f8b9b0c46be6e.png)
安装完成后，验证：
```
claude --version
```
看到版本号即成功。如果提示「claude 不是可识别的命令」，关闭 PowerShell 重新打开再试一次。

----
### 3.3 安装 CC Switch

CC Switch 是图形化工具，需要下载安装包。
打开浏览器，访问：
```
https://github.com/farion1231/cc-switch/releases
```
（如果打不开 GitHub，可以在公众号回复：：”CC Switch安装包“ 获取。）
![image-20260425191723977](https://developer.qcloudimg.com/http-save/yehe-11910509/48dd44c05382f5b9c6ad7cb8de9f6f40.png)
下载后双击运行，一路 Next 完成安装（这里安装路径根据自己习惯决定）。
安装完成后，可以在开始菜单找到 **CC Switch** 并打开。


----
### 3.4 获取国产模型的 API Key（以 deepseek 为例）

1. 打开deepseek开放平台官网：https://platform.deepseek.com/transactions ，注册账号。
2. 登录后进入「API Keys」页面，点击「创建 API Key」。
3. 复制生成的 Key（形如 `xxxxxxxx.yyyyyyyyyy`）。

![image-20260425193541386](https://developer.qcloudimg.com/http-save/yehe-11910509/4a184b65e6451c85aeca3d1c98b2d4a3.png)
>其他模型（MiniMax、Kimi、智谱 等）类似，找对「开放平台」→「API 管理」即可。
智谱还有一种官方提供的不用CC Switch的更简单的方法：（这里选看）
```
npx @z_ai/coding-helper
```


----
### 3.5 在 CC Switch 中配置模型

1. 打开 **CC Switch** 应用。在「Claude」选项，点击右上角的 **加号** → 新增模型配置。
	![image-20260425193852712](https://developer.qcloudimg.com/http-save/yehe-11910509/3c5e2c0d95937af893125a21566f3553.png)
2. 选择你要用的模型。
	![image-20260425194102292](https://developer.qcloudimg.com/http-save/yehe-11910509/11f414dd167033897805a2587ba93a04.png)
3. 填写：
	- **API Key**：粘贴上一步复制的 Key。
	- 选择对应的模型，其他参数默认即可。
	点击「添加」。然后在主界面点击你刚添加的模型，使其变为「启用」状态。
	![image-20260425194800834](https://developer.qcloudimg.com/http-save/yehe-11910509/0640ea7ec277c747f1033378153498a7.png)
	![image-20260425194909856](https://developer.qcloudimg.com/http-save/yehe-11910509/3f21a0fec4277e712ef2c8a5a46accae.png)

至此，模型已经接入完毕。


----
### 3.6 启动 Claude Code

**重要：不要在根目录启动，先创建一个工作文件夹。**
#### 第一步：创建项目文件夹

在电脑上任意位置新建一个文件夹，比如 `D:\MyCode` 或 `C:\Users\你的用户名\Code\project1`。
#### 第二步：打开 PowerShell 并进入该文件夹

方法一：在文件夹地址栏输入 `powershell` 然后回车。
方法二：先打开 PowerShell，输入 `cd `（cd后面有空格），然后把文件夹拖进窗口，路径会自动填充，按回车。
#### 第三步：启动 Claude Code

在终端中执行：
```
claude
```
出现小螃蟹图标，说明启动成功！
![image-20260425195205326](https://developer.qcloudimg.com/http-save/yehe-11910509/c17f064448fc7d89efb4b92db44d086e.png)
>如果不想每次都点权限确认，可以用开发模式启动（注意风险）：
```
claude --dangerously-skip-permissions
```
注意：删除文件、改密钥等高风险操作依然会询问你。

----
### 3.7 配置 CLAUDE.md

上面其实已经安装和启动成功，可以让其干活了，这一步是能让 Claude Code 更懂你的习惯，避免很多不必要的麻烦。
#### 配置全局 CLAUDE.md（一次配置，所有项目生效）

在 PowerShell 中执行（创建文件夹）：
```
mkdir $env:USERPROFILE\.claude -Force
```
然后用记事本创建文件：
```
notepad $env:USERPROFILE\.claude\CLAUDE.md
```
粘贴下面的模板（可根据自己喜好修改）：
```
## 关于我
[你的称呼，例如：新手开发者 / 产品经理 / 学生]
我用 Claude Code 做 [主要用途，比如：写 Python 脚本 / 学习代码 / 开发小工具]

## 沟通风格
- 使用中文交流，代码和命令用英文
- 直接给我答案，不要夸我“这是个好问题”
- 如果我的想法有问题，直接指出来

## 红线（必须问我）
以下操作必须先问我才能执行：
- 删除任何文件或文件夹
- 修改 .env、密钥、token
- 修改数据库结构
- git push、强制重置代码
- 安装全局依赖

## 工程习惯
- 改动代码后，自动运行测试或验证命令
- 不要把密钥、密码写进代码里
- 大改动之前，先给我方案确认
```
保存记事本（Ctrl+S，关闭）。以后每次启动 Claude Code，这些规则都会自动生效。
#### 配置项目级 CLAUDE.md（可选）

进入你的项目文件夹，启动 Claude Code，然后直接输入：
>「请根据这个项目的结构，帮我生成一份 CLAUDE.md」

它会自动扫描并创建。你只需要确认或稍作修改即可。

----
## 四、日常使用小贴士

### 切换模型

在 Claude Code 对话中输入 `/model`，会列出你所有已配置的模型，用方向键选择即可切换。
### 查看所有命令

输入 `/help`。
### 退出

输入 `exit` 或按 `Ctrl+C` 两次。


----

这一周，AI 圈又炸了。上周，Anthropic 刚刚发布了 Claude Opus 4.7，号称推理能力再上一个台阶。还没等大家缓过神来，这周：

从零开始，在国内用上 Claude Code 保姆教程（含 CC Switch 配置详解）

本教程专门为 Windows 用户打造，从零开始安装 Claude Code，并通过 CC Switch接入国产模型。概念+实操，每一步都有说明，新手也能轻松跟上。

公众号 | b站 | csdn同名

人工智能

开发工具

客户端

国内用户如何轻松使用ClaudeCode？本教程详解Windows环境下从零安装ClaudeCode，通过CCSwitch工具连接国产大模型（如智谱GLM、MiniMax等），无需国外账号和特殊网络。包含Git安装、CCSwitch配置、APIKey获取等详细步骤，手把手教你搭建智能开发助手，提升编程效率。

包管理器

数据库

服务器

API管理

Windows

Python

GitHub

Agent

4核4G3M云服务器 新用户低至38元/年！

2026采购季 | AI焕新·智启新局

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从零开始，在国内用上 Claude Code 保姆教程（含 CC Switch 配置详解）-腾讯云开发者社区-腾讯云

从零开始，在国内用上 Claude Code 保姆教程（含 CC Switch 配置详解）

从零开始，在国内用上 Claude Code 保姆教程（含 CC Switch 配置详解）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐