本文面向零编程基础或初次接触 AI 编程工具的读者，手把手带你从安装到实战，全程无需翻墙、无需海外信用卡。
目录
- 一、Claude Code 是什么？能做什么？
- 二、安装前的环境准备
- 三、Claude Code 安装（三种方式）
- 四、模型配置：国内用户零门槛方案
- 五、核心功能手把手实操
- 六、斜杠命令大全（收藏备用）
- 七、CLAUDE.md：让 AI 记住你的项目
- 八、三个实战场景（直接复制可用）
- 九、常见问题与避坑指南
- 十、总结与进阶路线
一、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
按提示选择：
- Install / Update（安装/更新）
- 选择模型提供商（支持 Anthropic、智谱 GLM、MiniMax 等）
- 输入 API Key
- 等待出现 "Setup Complete" 绿色提示
方式三：VS Code 插件版（不习惯命令行选这个）
如果你害怕黑窗口，可以直接在 VS Code 中使用：
- 下载 VS Code
- 安装插件：Claude Code 官方插件
- 重启 VS Code，侧边栏会出现 Claude Code 图标
四、模型配置：国内用户零门槛方案
Claude Code 默认需要 Anthropic 官方 API，但国内用户完全可以使用国产模型替代，效果差距不大，且无需翻墙。
推荐国产模型方案
| 模型 | 适用场景 | 配置难度 |
|---|---|---|
| 智谱 GLM-4.7 | 日常编程，性价比高 | ⭐ 简单 |
| DeepSeek Coder | 代码生成、语法检查 | ⭐ 简单 |
| Kimi K2 | 长文档处理、上下文理解 | ⭐⭐ 中等 |
以智谱 GLM-4.7 为例配置
步骤 1：获取 API Key
- 访问 bigmodel.cn 注册账号
- 右上角账户 → API Keys → 新建 Key
- 复制 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 会自动：
- 执行
npm create vite@latest - 安装依赖
- 创建目录结构
- 编写代码
- 启动开发服务器
场景 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 编程的最佳路径。
如果你在使用过程中遇到问题，欢迎在评论区留言，我会持续更新这篇教程。
