Claude Code

这一课你将能做到

1. 用 CLAUDE.md 文件建立 Claude Code 的项目级记忆
2. 用 Plan 模式让 Claude Code 先规划后执行，避免它一上来就乱改
3. 在终端里完成一次「探索代码库 → 设计方案 → 实现 → 提交」的完整闭环

为什么要学

Claude Code 是 Anthropic 推出的终端 Agent 工具。和 Cursor 这类编辑器不同，它活在命令行里：你描述任务，它自己读文件、跑测试、执行 shell 命令、改代码，全程不需要你切窗口。对习惯终端的开发者，这是目前最接近「真正的 AI 结对工程师」的体验。

人话：Cursor 是「AI 住进了你的编辑器」，Claude Code 是「AI 住进了你的终端」。它特别擅长需要多步骤、跨文件、要跑命令验证的任务——比如「把这个模块从 MySQL 迁到 PostgreSQL」这种打开编辑器都不知道从哪下手的活。

真实场景中它的杀手锏是理解大型陌生代码库：接手一个没人敢动的老项目时，让它先给你画调用链、找关键文件，比自己 grep 一天快得多。

先建立图像

Claude Code 工作循环：
┌────────────────────────────────────────┐
│ 你：描述任务（自然语言）                 │
│   ↓                                    │
│ Claude Code：                          │
│   1. 读 CLAUDE.md（项目记忆）           │
│   2. 探索代码库（读文件、搜索、跑命令）   │
│   3. 制定计划（Plan 模式时可审批）       │
│   4. 执行：改代码、跑测试、看结果        │
│   5. 失败了自我修正，直到通过            │
│   ↓                                    │
│ 你：验收 diff，确认提交                  │
└────────────────────────────────────────┘

跟着做

步骤 1：安装与启动

npm install -g @anthropic-ai/claude-code
cd your-project
claude

首次启动需要登录 Anthropic 账号（或配置 API key）。进入交互界面后，你就面对一个能操作你项目的 AI 会话。

步骤 2：创建 CLAUDE.md

在项目根目录创建 CLAUDE.md——这是 Claude Code 每次启动自动读取的记忆文件：

# 项目说明
Spring Boot 3 + MyBatis-Plus 的文章收藏夹后端。

## 常用命令
- 启动：./mvnw spring-boot:run
- 测试：./mvnw test
- 单测单个类：./mvnw test -Dtest=ArticleServiceTest

## 代码约定
- Controller 只做参数校验和转发，业务在 Service
- 返回统一 Result<T>：{ code, message, data }
- 数据库表字段小写下划线，Java 字段驼峰，MyBatis-Plus 自动映射

## 注意
- 不要修改 application-prod.yml
- 数据库变更只写迁移 SQL，不直接动库

写好后运行 /init 命令，Claude Code 也可以自动分析项目帮你生成初版 CLAUDE.md，你再手工修订。

步骤 3：先用它探索一个陌生项目

找一个你不熟的开源项目（或公司里没人敢动的模块），启动 claude，输入：

这个项目的整体架构是什么？
HTTP 请求从进入到返回经过哪几层？
用户认证的完整调用链画出来。

观察它如何自己搜索文件、读代码、总结。这个能力在接手遗留系统时价值极大。

步骤 4：用 Plan 模式做受控修改

启动时加权限参数，或在会话中切换模式。给一个真实任务：

进入 plan 模式。
任务：给文章列表接口加按标签筛选功能。
要求：先读相关代码，给出修改计划（涉及哪些文件、每个文件改什么），
等我批准后再动手。

Plan 模式下它只读不写，输出计划：