最近不少朋友问能不能出一期Claude Code的小白教程。他们也想用上这个号称最牛的Agent产品。
但一搜教程，全是让你开魔法、用国外信用卡、搞实名认证的——门槛高得吓人。其实很多人没搞清楚，Agent产品通常是**框架+模型**的组合。Claude的模型在国内确实难搞，但Claude Code这个框架本身是开放的，你可以给它接任何模型，包括国产的。
所以今天这篇，就是为国内环境量身定制的**Claude Code从零入门教程**。Mac和Windows都有，有魔法和没魔法的方案也分开说。下面的安装流程，是我们团队在不同电脑上反复测试、删掉重装好几轮才敲定的最稳路径。
只希望你跟着走，都能用上这个顶级的AI编程框架。
### 一、Claude Code是什么？为什么选它？

Claude Code是Anthropic推出的**命令行AI编程助手**。它不像网页聊天框，而是直接跑在你的终端里，能读取整个项目、修改代码、运行命令、跟开发工具深度集成。
简单说，它像个**能直接操作你代码库的AI同事**。
为什么推荐它？三个原因：
1. **框架本身足够强**：上下文理解、文件操作、工具调用这些底层能力，Claude Code是目前做得最扎实的。
2. **模型可替换**：你用不了Claude官方模型，没关系。接上GLM-5.1、MiniMax M2.7这些国产模型，效果依然能打。
3. **没有封号风险**：不用国外手机号、不用Visa卡，甚至可以不挂代理。完全本地化的部署路径。

能一步到位，就别在二流工具上浪费时间。
### 二、安装Claude Code（Mac & Windows）

#### 1. macOS安装

**有魔法的情况**（最简单）：
打开终端，粘贴下面命令：
```
curl -fsSL https://claude.ai/install.sh | bash
```等它跑完，如果提示要把 `~/.local/bin` 加到PATH，就按它给的命令执行一下。最后验证：
```
claude --version
```看到版本号就成功了。
**没魔法的情况**（用Homebrew）：
先装Homebrew（如果已有可跳过）：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```装完后，把Homebrew加到PATH（终端会提示你复制哪些命令，照着做就行）。
接着装Claude Code：
```
brew install --cask claude-code@latest
```安装可能有点慢，耐心等。完成后同样用 `claude --version` 验证。
#### 2. Windows安装

Windows必须**先装Git**，因为Claude Code底层用Git Bash执行命令。
**装Git**（如果已有可跳过）：
用WinGet（Windows官方包管理器）装：
```
winget install Git.Git
```**有魔法的情况**：
在终端（PowerShell或CMD）运行：
**powershell**
```
irm https://claude.ai/install.ps1 | iex
```**没魔法的情况**：
```
winget install Anthropic.ClaudeCode
```装完后，**必须配置PATH**，否则系统找不到 `claude` 命令。
Claude Code的可执行文件默认在 `C:\Users\你的用户名\.local\bin`。把这个路径加到系统环境变量的Path里（具体操作：系统属性 → 高级 → 环境变量 → 编辑Path → 新建）。
加完**重启终端**，再运行 `claude --version` 验证。
### 三、接入小豆包中转API大模型

框架装好了，还得给它接个“脑子”。这里推荐用**cc-switch**，一个图形化工具，能让你在Claude Code里一键切换不同模型。
#### 1. 安装cc-switch

**macOS**：
```
brew tap farion1231/ccswitch
brew install --cask cc-switch
```**Windows**：
直接去 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载安装包，双击安装。
#### 2. 配置GLM-5.1

打开cc-switch，点击右上角加号，选择“自定义配置”。
![image](https://developer.qcloudimg.com/http-save/yehe-11254649/958a84e8cd47fafb573260388936cab4.png)
![image](https://developer.qcloudimg.com/http-save/yehe-11254649/b1540ffc84fe39ab4b615c2d0acdcc51.png)
需要填的就两项：
- **URL**：小豆包官方url
- **API Key**：去令牌页申请
- **模型配置**：选自己希望接入的模型

其他选项工具会自动填充，点“添加”就行。
配置好后，在cc-switch里选中这个配置，点“启用”。
#### 3. 解决常见报错

如果你遇到 `400 thinking type should be enabled or disabled` 错误，是因为新版Claude Code默认发送的 `adaptive` 思考类型，第三方API不支持。
解决办法：在Claude Code里运行 `/config` 打开设置，在“环境变量”里添加：
```
{
  "claude_code_disable_adaptive_thinking": "1"
}
```保存后重启Claude Code即可。
### 四、启动与基本使用

#### 1. 第一次启动

在终端输入：
```
claude
```第一次会有些初始化设置：
- 选颜色主题（以后可用 `/theme` 改）
- 安全提示（仔细读，这是保护你代码的）
- 确认当前目录是否可信（选“是”）

然后你就进入Claude Code的对话界面了。
#### 2. 针对项目启动

建议**不要**在根目录直接启动，而是针对具体项目文件夹启动，这样上下文更干净，AI也更专注。
```
cd /你的项目路径
claude
```更推荐用这个命令启动，省去频繁点“允许”：
```
claude --dangerously-skip-permissions
```（注意：这跳过了权限提示，只在你完全信任的目录下用）
#### 3. 切换模型

在cc-switch里配置好多个模型后，在Claude Code里用 `/model` 命令就能实时切换。
### 五、最佳实践：让你的Claude Code更顺手

#### 1. 写CLAUDE.md（最重要的一步）

CLAUDE.md是Claude Code的“宪法”，告诉它你的编码习惯、项目规则、安全红线。
**全局CLAUDE.md**（`~/.claude/CLAUDE.md`）：适用于所有会话，放跨项目的通用规则。
**项目CLAUDE.md**（项目根目录/CLAUDE.md）：针对当前项目的特殊约定。
一个简洁的全局CLAUDE.md模板：
```
## 关于我
[你的身份/职业]。我用Claude Code做[用途1]和[用途2]。

## 思维原则
所有决策从问题本质出发，不因“惯例如此”照搬。
回到问题本身：要解决什么？最直接的路径是什么？
不要谄媚。不要夸我的想法好、不要说“这是个很好的问题”。
给我真实判断，方案有问题直接指出来。

## 约束先行
无论开发项目还是知识管理项目，第一步永远是建规则。
新项目先写CLAUDE.md，新目录先定结构约定。
没有规范的工作空间不动手。

## 沟通方式
- 默认中文，代码、命令、变量名用英文
- 结论先行，再给理由
- 遇到模糊需求，先给最合理的方案，再问要不要调整

## 自主边界（红线，必须先问我）
以下操作即使在auto-accept模式下也必须停下来问我：
- 删除文件、目录或git历史
- 修改.env、密钥、token、CI/CD配置
- 数据库schema变更或数据迁移
- git push、git rebase、git reset --hard、强制推送
- 安装新的全局依赖或修改系统配置
- 公开发布（npm publish、部署到生产、发文章等）
```**核心原则**：CLAUDE.md不是越长越好，超过80行Claude就开始遗漏内容，最多别超过100行。只放它迷糊的那些边界规则。
#### 2. 配置权限

刚装好时，Claude Code每次执行命令都要你确认，很烦。用 `/permissions` 命令，把你信任的工具（比如 `npm run lint`、`git commit`）加入允许列表，以后就不会再问了。
对于需要高度隔离的场景，可以用 `/sandbox` 开启沙箱模式。
#### 3. 使用MCP服务器

Claude Code支持Model Context Protocol，能连外部工具：
```
# 连接Playwright（浏览器自动化）
claude mcp add playwright npx @playwright/mcp@latest

# 连接Sentry（错误监控）
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```连上后，你就能让Claude直接查Sentry错误、用Playwright做自动化测试了。
#### 4. 创建Skills

Skills是Claude Code的“技能包”，把常用工作流固化下来。
在 `.claude/skills/` 下新建目录，里面放 `SKILL.md`：
```
---
name: fix-issue
description: 修复GitHub issue的标准流程
---

1. 用 `gh issue view` 获取issue详情
2. 理解问题
3. 搜索相关代码文件
4. 实现修复
5. 写测试验证
6. 确保代码通过lint和类型检查
7. 写清晰的commit信息
8. 推送并创建PR
```以后遇到issue，直接运行 `/fix-issue 1234` 就行。
### 六、避坑指南

1. **Windows提示“bash不是内部命令”**：重新安装Git for Windows，安装时**务必选择“Use Git from the command line”**。
2. **环境变量设置了但没生效**：Windows要用 `setx` 设置，设置后**必须重启终端**。macOS/Linux写进 `~/.zshrc` 或 `~/.bashrc` 后记得 `source`。
3. **返回401 Unauthorized**：检查cc-switch里的API Key格式，确保目标平台支持Bearer Token认证。
4. **终端频繁断连**：可能是网关超时，在cc-switch配置里调高 `timeout` 到120秒，开启 `keep_alive`。
5. **代码块不闭合/格式错乱**：在CLAUDE.md里强化格式约束，或换用qwen-coder、deepseek-coder等针对代码优化的模型。

### 七、写在最后

Claude Code是我目前最推荐的AI编程工具，没有之一。
它可能不是最简单的，但绝对是上限最高的。一旦跑通安装、接上模型、定好规范，你会发现很多原本需要几小时的工作，现在几分钟就能搞定。
这套方案的核心优势就三个字：**可控性**。你不用依赖任何不稳定服务，所有组件都在自己手里。模型效果不好？换一个。框架更新了？自己决定升不升。
这才是AI时代开发者该有的姿势——不是被动等喂饭，而是主动搭建自己的生产力基础设施。
希望这篇保姆教程，能帮你顺利上车。做出你自己的作品。

最近不少朋友问能不能出一期Claude Code的小白教程。他们也想用上这个号称最牛的Agent产品。但一搜教程，全是让你开魔法、用国外信用卡、搞实名认证的——门槛高得吓人。其实很多人没搞清楚，Agent产品通常是框架+模型的组合。Claude的模型在国内确实难搞，但Claude Code这个框架本身是开放的，你可以给它接任何模型，包括国产的。所以今天这篇，就是为国内环境量身定制的Claude Code从零入门教程。Mac和Windows都有，有魔法和没魔法的方案也分开说。下面的安装流程，是我们团队在不同电脑上反复测试、删掉重装好几轮才敲定的最稳路径。只希望你跟着走，都能用上这个顶级的AI编程框架。

3步搞定Claude Code国内安装：2026最新保姆教程（附cc-switch配置）

Claude Code是我目前最推荐的AI编程工具，没有之一。
它可能不是最简单的，但绝对是上限最高的。一旦跑通安装、接上模型、定好规范，你会发现很多原本需要几小时的工作，现在几分钟就能搞定。
这套方案的核心优势就三个字：可控性。你不用依赖任何不稳定服务，所有组件都在自己手里。模型效果不好？换一个。框架更新了？自己决定升不升。
这才是AI时代开发者该有的姿势——不是被动等喂饭，而是主动搭建自己的生

人工智能

开发工具

编程语言

ClaudeCode是强大的AI编程助手框架，支持国产模型接入。本教程提供Mac/Windows详细安装指南，无需魔法或国外信用卡，包含小豆包API配置、权限设置及最佳实践。教你从零搭建本地化AI编程环境，解决常见报错，实现高效代码开发。

数据迁移

包管理器

数据库

服务器

Windows

Linux

Agent

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

tencentdb-catalog

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

datainlong

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯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编辑器全新改版上线，欢迎大家体验!

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

社区新版编辑器体验调研

3步搞定Claude Code国内安装：2026最新保姆教程（附cc-switch配置）-腾讯云开发者社区-腾讯云

3步搞定Claude Code国内安装：2026最新保姆教程（附cc-switch配置）

3步搞定Claude Code国内安装：2026最新保姆教程（附cc-switch配置）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐