新手起步

# Claude Code 新手使用教程：修改代码

既然你已经在工作目录里启动了 `claude`，下面是从零开始改代码的完整流程。

## 第一步：先让 Claude 了解你的项目（推荐）

在做任何修改前，先运行这个斜杠命令：

```
/init
```

它会扫描你的代码库，自动生成一个 `CLAUDE.md` 文件，里面记录了项目结构、技术栈、关键命令（比如怎么 build、怎么 test）。这个文件以后每次启动 Claude Code 都会自动加载，相当于给 Claude 一份"项目说明书"，省得它每次都要重新摸索。

如果你想让 Claude 先简单了解一下，也可以直接问：

```
这个项目是做什么的？主要文件在哪里？
```

## 第二步：用自然语言描述你想改什么

这是最核心的用法——**像跟同事说话一样告诉它需求**，不用记什么特殊语法。

**模糊的提示（不推荐）：**
> 修一下 bug

**清晰的提示（推荐）：**
> 修复 `src/auth/login.js` 里的登录 bug：用户输入错误密码后页面变空白，应该显示"密码错误"提示。

提示越具体越好：包含**文件路径、现象、期望结果**这三要素，Claude 改对的概率会高很多。

你也可以用 `@` 提及具体文件，例如：
```
帮我给 @src/utils/validator.js 增加邮箱格式校验
```

## 第三步：审查并批准修改（关键！）

Claude Code 有个**权限系统**：每次它要修改文件、运行命令时，都会停下来问你是否允许。它会展示一个 **diff（修改对比）**，绿色是新增、红色是删除。

你会看到这样的选项：
- `1. Yes` — 批准这一次
- `2. Yes, and don't ask again` — 这个会话里同类操作都自动允许
- `3. No, tell Claude what to do differently` — 拒绝并告诉它怎么改

新手建议**逐个审查**，养成看 diff 的习惯。看到不对的地方，可以选 3 然后说："不要用 var，改用 const" 或 "把这个函数拆成两个"，它会重新做。

## 第四步：让它自己跑测试 / 验证

改完代码后，可以直接说：

```
跑一下测试，看看有没有问题
```

或者：

```
运行项目，看能不能正常启动
```

它会执行命令、读取报错、自动迭代修复。这是 Claude Code 比网页版 Claude 强的地方——它能**真的执行代码、看到结果**。

## 必须知道的几个快捷操作

| 操作 | 作用 |
|---|---|
| `Shift + Tab`（按两下） | 进入 **Plan Mode（计划模式）**，Claude 只规划不动手，适合复杂改动先看方案 |
| `/clear` | 清空当前对话上下文，开始新任务前用，避免无关历史干扰 |
| `/compact` | 对话太长时压缩历史，节省 token |
| `Esc` | 打断 Claude 正在做的事 |
| `↑` 箭头 | 调出历史命令 |
| `#` 开头的消息 | 自动保存到 CLAUDE.md，用来记项目规则 |

## 给新手的三条实战建议

**1. 改代码前先 `git commit` 一下。** 这是最重要的安全网。即使 Claude 改坏了，你也能 `git reset` 回退。养成"小步提交"的习惯。

**2. 一次只做一件事，做完用 `/clear`。** 不要在同一个对话里又改登录又改支付又改 UI——上下文会越来越乱，Claude 容易出错。任务切换时清空重来。

**3. 复杂改动先用 Plan Mode。** 如果改动会涉及多个文件（比如重构、加新功能），先 `Shift+Tab` 两次进入计划模式，让它先出方案，你确认无误后再让它执行。

## 一个完整的小例子

假设你想给项目加一个新功能：

```
> /init
（等它生成 CLAUDE.md）

> 我想在 utils 目录下新增一个文件 dateFormatter.js，
  导出一个函数 formatDate(date)，把 Date 对象格式化成 "YYYY-MM-DD" 字符串。
  写完后帮我加一个简单的单元测试。

（Claude 展示要创建的文件 → 你按 1 批准）
（Claude 展示测试文件 → 你按 1 批准）

> 跑一下测试

（Claude 执行 npm test，看到结果）
```

整个过程你只需要看 diff、按确认。

---

更详细的官方文档可以参考：[docs.claude.com/en/docs/claude-code/overview](https://docs.claude.com/en/docs/claude-code/overview)