保姆级claudecode速成教程，2小时带你搞定！

Claude Code 是 Anthropic 推出的终端原生 AI 编程助手，它不是简单的代码补全工具，而是一个能自主规划任务、直接操作文件系统、执行终端命令的 "AI 程序员"。本教程专为国内用户设计，无需海外手机号和信用卡，2 小时带你从安装到实战。

第一部分：前置准备与安装（30 分钟）

1.1 认识 Claude Code（5 分钟）

核心区别：传统 AI 工具是 "你说一步，它做一步"，Claude Code 是 "你说要什么结果，它自己想步骤、自己落地"。

四大核心能力：

• ✅ 直接读写、修改本地文件（无需复制粘贴）
• ✅ 理解整个代码库结构和依赖关系
• ✅ 执行终端命令、运行测试、提交 Git
• ✅ 自主拆解复杂任务并多轮迭代优化

1.2 国内可用模型方案（10 分钟）

强烈推荐方案：使用国产模型 + Claude Code 框架（0 封号风险，无需魔法）

表格

模型	推荐指数	价格	编程能力	获取方式
DeepSeek V3	⭐⭐⭐⭐⭐	0.14 元 / 百万 token	优秀	https://platform.deepseek.com/
豆包 4.0 Ultra	⭐⭐⭐⭐	0.2 元 / 百万 token	优秀	https://console.volcengine.com/ark/
通义千问 3.5	⭐⭐⭐⭐	0.12 元 / 百万 token	良好	https://dashscope.console.aliyun.com/

操作步骤：

1. 访问上述任意平台注册账号
2. 进入 API 密钥管理页面，创建新的 API Key
3. 复制保存你的 API Key（仅显示一次）

1.3 安装 Claude Code（15 分钟）

Windows 系统

1. 安装 Git（必须）：

   powershell

   winget install Git.Git
   

   安装完成后重启终端

2. 安装 Claude Code：

   powershell

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

3. 验证安装：

   powershell

   claude --version
   

Mac 系统

bash

运行

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

Linux 系统

bash

运行

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

1.4 配置国产模型（5 分钟）

1. 创建配置文件目录：

   bash

   运行

   mkdir -p ~/.claude
   

2. 编辑配置文件：

   bash

   运行

   # Windows
   notepad ~/.claude/settings.json
   
   # Mac/Linux
   nano ~/.claude/settings.json
   

3. 粘贴以下内容（以 DeepSeek 为例）：

   json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
       "ANTHROPIC_BASE_URL": "https://api.deepseek.com",
       "ANTHROPIC_MODEL": "deepseek-chat"
     }
   }
   

4. 保存并退出编辑器

第二部分：基础操作与核心功能（45 分钟）

2.1 启动与界面介绍（10 分钟）

基础启动命令：

bash

运行

# 在当前目录启动交互式模式（最常用）
claude

# 带问题直接启动
claude "帮我分析这个项目的结构"

# 恢复上次会话
claude -c

界面说明：

• 左侧：小螃蟹图标 + 版本信息
• 中间：对话区域
• 底部：输入框
• 右上角：权限模式指示器

首次启动设置：

• 选择主题（推荐深色）
• 确认安全提示
• 信任当前目录（输入allow）

2.2 常用命令速查（10 分钟）

表格

命令	功能
/help	显示所有可用命令
/clear	清空当前对话上下文
/compact	压缩历史对话节省 token
/init	生成项目级 CLAUDE.md 文件
/model	切换当前使用的模型
/permission	切换权限模式
/exit 或 Ctrl+D	退出 Claude Code

2.3 权限模式详解（10 分钟）

Claude Code 有三种权限模式，按 Shift+Tab 快速切换：

1. Plan 模式（🔍）：

   • 只能读取文件，不能修改
   • 只能回答问题，不能执行命令
   • 用于探索项目、制定计划

2. Normal 模式（✅）：

   • 可以读取和修改文件
   • 执行命令前会询问确认
   • 日常开发推荐使用

3. Auto 模式（⚡）：

   • 自动执行所有操作无需确认
   • 危险！仅在完全信任的环境使用

2.4 第一个实战任务：创建待办事项应用（15 分钟）

1. 创建项目文件夹并进入：

   bash

   运行

   mkdir todo-app && cd todo-app
   

2. 启动 Claude Code：

   bash

   运行

   claude
   

3. 输入以下指令：

   plaintext

   帮我创建一个简单的Python待办事项应用，要求：
   1. 使用命令行界面
   2. 支持添加、删除、查看待办事项
   3. 数据保存到本地JSON文件
   4. 代码要有注释
   

4. Claude 会自动：

   • 创建 main.py 文件
   • 编写完整代码
   • 告诉你如何运行

5. 测试应用：

   plaintext

   运行这个应用，帮我测试一下所有功能
   

第三部分：高级技巧与最佳实践（45 分钟）

3.1 CLAUDE.md 配置文件详解（15 分钟）

CLAUDE.md 是 Claude Code 的 "行为准则"，分为全局和项目级两种。

生成项目级 CLAUDE.md：

bash

运行

claude /init

CLAUDE.md 核心内容模板：

markdown

# 项目配置

## 技术栈
- 前端：React + TypeScript + Tailwind CSS
- 后端：Node.js + Express
- 数据库：MongoDB

## 代码规范
- 使用2空格缩进
- 变量名使用驼峰命名法
- 每个函数必须有JSDoc注释
- 提交信息格式：type(scope): message

## 禁止事项
- 不要修改package.json中的依赖版本
- 不要删除现有的测试文件
- 不要使用any类型

## 验证标准
- 所有测试必须通过
- 代码必须通过ESLint检查
- 构建不能有警告

3.2 四步高效工作流（15 分钟）

官方推荐工作流：探索→计划→实现→提交

第一步：探索（Plan 模式）

plaintext

进入计划模式，帮我分析src/auth目录的代码结构，理解登录流程和会话管理方式

第二步：制定计划

plaintext

我想添加Google OAuth登录功能。请列出需要修改的文件、具体步骤和注意事项

第三步：实现（Normal 模式）

plaintext

按照上面的计划实现Google OAuth功能。为每个修改的部分编写测试，运行测试并修复所有失败

第四步：提交

plaintext

将所有修改提交到Git，提交信息为"feat: 添加Google OAuth登录支持"

3.3 实用技巧与避坑指南（15 分钟）

技巧 1：参考文件法

plaintext

看src/auth/login.ts里鉴权的实现方式，按完全相同的模式实现密码重置功能

技巧 2：截图调试 UI

• 直接 Ctrl+V 粘贴截图到终端
• 输入："按钮和输入框没对齐，卡片间距不一致，修复一下"

技巧 3：先测试后实现

plaintext

先写一个计算折扣价格的函数的测试用例，覆盖：正常折扣、零折扣、100%折扣、负价格、字符串输入。然后实现这个函数让所有测试通过

技巧 4：增量构建

plaintext

第一步：只创建数据库schema，其他什么都不做
确认ok后：
第二步：创建使用这个schema的API端点

避坑指南：

• ❌ 不要在同一个对话里又修 bug 又加功能又重构
• ❌ 不要使用 Auto 模式在生产环境操作
• ✅ 每次改完要求查看 diff："展示你修改过的所有文件的 diff"
• ✅ 频繁提交 Git，保留回退能力

总结与下一步

恭喜你！现在你已经掌握了 Claude Code 的核心使用方法。它能帮你：

• 快速搭建项目骨架
• 理解陌生代码库
• 修复 bug 和重构代码
• 自动化重复性工作

下一步建议：

1. 在你现有的项目中尝试使用 Claude Code
2. 完善你的项目级 CLAUDE.md 文件
3. 探索 Skills 系统，创建自定义技能
4. 学习 MCP 协议，连接更多工具