Claude Code 保姆级入门教程：零基础到 AI 编程高手，看这一篇就够了

本文面向零编程基础 或初次接触 AI 编程工具的读者，手把手带你从安装到实战，全程无需翻墙、无需海外信用卡。

---

目录

• [一、Claude Code 是什么？能做什么？](#一、Claude Code 是什么？能做什么？ "#%E4%B8%80claude-code-%E6%98%AF%E4%BB%80%E4%B9%88%E8%83%BD%E5%81%9A%E4%BB%80%E4%B9%88")
• 二、安装前的环境准备
• [三、Claude Code 安装（三种方式）](#三、Claude Code 安装（三种方式） "#%E4%B8%89claude-code-%E5%AE%89%E8%A3%85%E4%B8%89%E7%A7%8D%E6%96%B9%E5%BC%8F")
• 四、模型配置：国内用户零门槛方案
• 五、核心功能手把手实操
• 六、斜杠命令大全（收藏备用）
• [七、CLAUDE.md：让 AI 记住你的项目](#七、CLAUDE.md：让 AI 记住你的项目 "#%E4%B8%83claudemd%E8%AE%A9-ai-%E8%AE%B0%E4%BD%8F%E4%BD%A0%E7%9A%84%E9%A1%B9%E7%9B%AE")
• 八、三个实战场景（直接复制可用）
• 九、常见问题与避坑指南
• 十、总结与进阶路线

---

一、Claude Code 是什么？能做什么？

Claude Code 是 Anthropic 推出的终端级 AI 编程助手 。它不是一个简单的代码补全插件，而是一个能理解整个项目、跨文件操作、自主规划执行步骤的智能代理（Agent）。

核心能力一览

能力	说明	适合场景
代码读写	读取整个代码库，编辑多文件	重构项目、批量改代码
命令执行	运行终端命令、构建项目、启动服务	自动化部署、测试
工具集成	Git、MCP 扩展、浏览器、文件系统	全流程开发
主动规划	任务拆解、步骤执行、结果验证	复杂需求开发
持久记忆	跨会话记住项目规则和上下文	长期维护项目

为什么选择 Claude Code？

• 目前最强的 Agent 框架 ：相比 Cursor、GitHub Copilot，Claude Code 的推理规划和跨文件操作能力更强。
• 模型可替换：即使不用 Claude 原生模型，搭配国产大模型（GLM、DeepSeek、Kimi）效果依然顶尖。
• 国内可用：无需海外手机号、无需 Visa 卡、无需魔法上网。

---

二、安装前的环境准备

Claude Code 基于 Node.js 运行，所以你需要先安装两个基础工具：

1. 安装 Node.js（必须）

访问 nodejs.org，下载 LTS 长期支持版（建议 v18.0.0 以上）。

验证安装：

node --version
# 输出类似 v20.12.0 即成功

2. 安装 Git（必须）

• Windows ：访问 git-scm.com 下载安装
• Mac ：终端执行 xcode-select --install 或 brew install git

验证安装：

git --version

---

三、Claude Code 安装（三种方式）

方式一：官方安装（推荐有环境基础的用户）

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

验证：

claude --version

方式二：ZCF 一键安装（推荐小白）

ZCF（Zero-Config Claude-Code Flow）是社区开发的零配置工具，自动处理繁琐步骤。

npx zcf

按提示选择：

1. Install / Update（安装/更新）
2. 选择模型提供商（支持 Anthropic、智谱 GLM、MiniMax 等）
3. 输入 API Key
4. 等待出现 "Setup Complete" 绿色提示

方式三：VS Code 插件版（不习惯命令行选这个）

如果你害怕黑窗口，可以直接在 VS Code 中使用：

1. 下载 VS Code
2. 安装插件：Claude Code 官方插件
3. 重启 VS Code，侧边栏会出现 Claude Code 图标

---

四、模型配置：国内用户零门槛方案

Claude Code 默认需要 Anthropic 官方 API，但国内用户完全可以使用国产模型替代，效果差距不大，且无需翻墙。

推荐国产模型方案

模型	适用场景	配置难度
智谱 GLM-4.7	日常编程，性价比高	⭐ 简单
DeepSeek Coder	代码生成、语法检查	⭐ 简单
Kimi K2	长文档处理、上下文理解	⭐⭐ 中等

以智谱 GLM-4.7 为例配置

步骤 1：获取 API Key

1. 访问 bigmodel.cn 注册账号
2. 右上角账户 → API Keys → 新建 Key
3. 复制 Key（格式类似 your_zhipu_api_key）

步骤 2：配置环境变量

Windows（CMD）：

setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zhipu_api_key"
setx ANTHROPIC_MODEL "GLM-4.7"

Mac/Linux（Terminal）：

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=your_zhipu_api_key
export ANTHROPIC_MODEL=GLM-4.7

💡 提示 ：配置完成后，重新打开一个终端窗口使配置生效。

步骤 3：验证

claude

输入"你好"，如果能正常回复，说明配置成功。

---

五、核心功能手把手实操

启动 Claude Code 后，你会看到一个 > 提示符，这就是你的 AI 编程助手。

5.1 基础对话

直接输入自然语言指令：

> 帮我写一个 Python 函数，计算斐波那契数列前 N 项

5.2 引用文件/文件夹

使用 @ 符号让 Claude 读取项目文件：

> @src/main.py 解释一下这段代码的作用
> @src/ 整个项目的架构是什么样的？

5.3 添加文件到上下文

> /add src/utils.js
> /add README.md

5.4 执行终端命令

Claude 可以直接帮你运行命令：

> 运行测试用例
> 启动开发服务器

5.5 工作模式切换（重要！）

Claude Code 有四种工作模式，点击底部状态栏切换：

模式	说明	适用场景
Plan	先给执行计划，等你确认再操作	不确定的操作，防止误改
Ask before edit	每次编辑前询问	敏感文件修改
Edit automatically	自动执行编辑	信任 Claude 后提速
Bypass permissions	完全自动，不询问	自动化脚本

⚠️ 新手建议 ：前两周使用 Plan 或 Ask before edit 模式，熟悉后再开自动。

---

六、斜杠命令大全（收藏备用）

输入 / 查看所有命令，以下是常用核心命令：

会话管理

命令	功能
/clear	清空当前对话历史
/compact	压缩上下文，释放 Token 空间（长会话必用）
/resume	恢复历史会话
/export	导出对话为 Markdown

配置与信息

命令	功能
/model	切换 AI 模型
/cost	查看当前会话 Token 消耗
/context	可视化上下文使用情况
/config	打开配置面板

项目与代码

命令	功能
/read	读取并分析文件
/edit	编辑指定文件
/memory	编辑 CLAUDE.md 记忆文件
/init	初始化项目配置

特殊模式（2026 新版）

命令	功能
/voice	开启语音对话模式
/computer-use	启用桌面操作能力
/mcp list	查看已连接的 MCP 工具
/team create	创建多智能体团队

---

七、CLAUDE.md：让 AI 记住你的项目

CLAUDE.md 是 Claude Code 最核心的功能 ，它让 AI 记住项目规则，跨会话保持记忆。

7.1 记忆文件层级

文件	位置	作用域
CLAUDE.md	项目根目录	仅本项目（团队共享）
.claude/settings.json	项目目录	个人本地偏好
~/.claude/CLAUDE.md	用户主目录	所有项目（全局）

7.2 如何创建

> /init

或在项目根目录手动创建 CLAUDE.md：

# 项目规则

## 技术栈
- Node.js 18+
- React + TypeScript
- Tailwind CSS

## 代码规范
- 组件文件使用 PascalCase 命名
- 所有 API 调用放在 /api 目录
- 禁止使用 console.log，使用 pino 日志

## 构建命令
- 开发：npm run dev
- 构建：npm run build
- 测试：npm test

7.3 自然语言更新

直接对话告诉 Claude 更新规则：

> 更新 CLAUDE.md：改用 pnpm 作为包管理器
> 在 CLAUDE.md 中添加：所有新页面必须做移动端适配

---

八、三个实战场景（直接复制可用）

场景 1：从零搭建一个 React 项目

> 帮我创建一个 React + TypeScript + Vite 项目，包含：
> 1. 路由配置（react-router-dom）
> 2. 全局状态管理（Zustand）
> 3. 请求封装（axios + 拦截器）
> 4. 登录页面和首页
> 5. 使用 Tailwind CSS 做样式

Claude 会自动：

1. 执行 npm create vite@latest
2. 安装依赖
3. 创建目录结构
4. 编写代码
5. 启动开发服务器

场景 2：代码重构与优化

> @src/ 这个项目的代码耦合太严重了，帮我：
> 1. 把业务逻辑从组件中抽离到 hooks
> 2. 统一错误处理
> 3. 优化类型定义，消除 any
> 4. 给出重构后的文件结构

场景 3：Bug 修复 + 测试

> 运行测试，找出失败的用例
> 分析失败原因并修复
> 修复后重新运行测试，确保全部通过

---

九、常见问题与避坑指南

Q1：提示 "API Key 无效" 怎么办？

• 检查 Key 是否复制完整（不要有多余空格）
• 确认 ANTHROPIC_BASE_URL 配置正确（国产模型必须配中转地址）
• 重新打开终端使环境变量生效

Q2：Claude 修改错了代码，如何回滚？

> /rewind

一键回滚到上次操作前的状态。

Q3：上下文太长，Claude 变傻了？

> /compact

压缩历史对话，保留关键信息但释放 Token 空间。

Q4：如何中断 Claude 的输出？

按 Ctrl + C 即可打断。

Q5：Claude Code 和 Cursor 有什么区别？

特性	Claude Code	Cursor
定位	终端 Agent	IDE 插件
上下文	百万 Token	相对较小
文件操作	跨文件自动操作	单文件实时编辑
适用	复杂任务、全流程	快速编码、小规模修改

建议：两者结合使用，Cursor 写代码，Claude Code 做架构和重构。

---

十、总结

你已经学会了什么？

✅ 安装并配置 Claude Code（国内零门槛方案）

✅ 使用自然语言指挥 AI 编程

✅ 通过 CLAUDE.md 建立项目记忆

✅ 掌握核心斜杠命令

✅ 完成从零搭建、重构、Debug 全流程

写在最后

Claude Code 目前依然是世界上最好的 Agent 编程框架 ，即使搭配国产模型，也能达到原生模型 90% 以上的效果。对于国内开发者来说，这是无需翻墙、无需海外支付就能体验顶尖 AI 编程的最佳路径。

如果你在使用过程中遇到问题，欢迎在评论区留言，我会持续更新这篇教程。