任务型实战
实战 2：写出你的第一份 CLAUDE.md
把项目的长期规则压缩成一张可执行的规则卡，让 Claude Code 每次进入项目时都更稳定。
学完你会得到什么
- 先照着做一遍，再回头理解原理。
- 这篇实战更适合边看边操作，不适合只看不练。
开始前你最好知道
- 看完第 5 章
- 手头有一个能明确说明目标的项目
先看这些风险提醒
- 不要把密钥、密码、私有 token 或证书路径写进去。
- 不要把临时灵感冒充成长期规则。
做完怎么验证
- 你能拿出一份短而清楚的 `CLAUDE.md` 草稿。
- Claude Code 在同一个项目里能更稳定地遵守你的约定。
- 你能指出哪条内容该放入长期规则，哪条只适合留在当前会话。
可视化路线
动手流程
先按这个顺序走一遍，再回头理解为什么这样做。
- 01第 1 步
列出项目的长期规则。
- 02第 2 步
压缩成短句。
- 03第 3 步
写进 `CLAUDE.md`。
- 04第 4 步
让 Claude Code 复述并验证读取结果。
场景
你发现 Claude Code 每次进入项目时都需要重新解释“这个项目是做什么的”“常用命令是什么”“哪些目录不要碰”，这说明项目记忆还没有落地。
目标
写出一份最小可用的 CLAUDE.md，让后续任务更稳定。
前置条件
先确认这个项目至少有三类稳定信息：项目目标、常用命令、不要乱碰的区域。如果这些都还不稳定，先别急着写。
分步操作
- 先列出项目最重要的三到五条长期约定。
- 把每条约定改写成短句，避免背景铺陈。
- 按“项目目标 / 常用命令 / 输出约定 / 禁止区域”组织结构。
- 保存后，让 Claude Code 复述它理解到的规则。
一份最小模板
你可以先写成这样：
# 项目说明
- 项目目标：......
- 常用命令：......
- 输出约定：......
- 禁止区域：......先求可用，再求完整。
风险提醒
如果你写完以后发现里面大部分句子都无法指导行动，例如“保持高质量”“尽量优雅”，说明这份规则卡还不够可执行。
验证结果
Claude Code 在读取后，应该能更自然地遵守你写下的约定，而不是每次都让你重新解释。
失败时先查什么
先看规则是否太长；再看有没有互相矛盾的要求；最后看你写的是“长期规则”还是“本次会话需求”。
学习进度
做完这一章了吗？
你可以把本章标记为已完成，首页和课程列表会记录你的学习进度。