1.4 初始化项目
预计耗时：10 分钟
本关任务简报
很多人学会 claude 怎么启动之后，就直接开始让它干活了。
这当然也能用，但只要你开始连续做任务，很快就会遇到两个问题：
- Claude 不知道你是谁、你希望它怎么跟你协作
- Claude 不知道这个项目的技术栈、目录结构和约定
所以这一关要解决的就是：
在你真正开始长期使用之前，先把最基本的协作规则立起来。
通关奖励：解锁以下技能
- 理解 CLAUDE.md 是什么、为什么值得尽早配
- 分清全局 CLAUDE.md 和项目 CLAUDE.md 各管什么
- 用
/init自动生成项目级 CLAUDE.md 的第一版
机制解析
为什么建议尽早配 CLAUDE.md
你可以把 CLAUDE.md 理解成 Claude Code 启动时会自动读取的一份“协作说明书”。
它不是普通文档，而是会直接影响 Claude 后续行为的上下文文件。
如果你一开始不配，也不是不能用。
但你会很快发现：
- 每次都要重复解释你是谁、偏好什么
- 每进一个新项目都要重新解释技术栈和约定
- 时间一长，协作会越来越乱
所以更稳妥的做法是：尽早把全局 CLAUDE.md 和项目 CLAUDE.md 定下来。
先理解两层最重要的 CLAUDE.md
刚上手时，你最需要先理解的是这两层：
| 位置 | 作用范围 | 解决什么问题 |
|---|---|---|
~/.claude/CLAUDE.md | 全局，所有项目都会生效 | 你是谁、你喜欢怎样协作、哪些事情必须先问你 |
./CLAUDE.md（项目根目录） | 当前项目 | 这个项目怎么做、有哪些命名和工程约定 |
如果你只记一句话，那就是：
- 全局 CLAUDE.md 管“你这个人”的长期协作方式
- 项目 CLAUDE.md 管“这个项目”的具体做法
更完整的层次说明和模板，可以继续看：2.7 CLAUDE.md 与项目配置 →
开始闯关
用 /init 自动生成项目级 CLAUDE.md
在项目根目录启动 Claude Code 后运行：
text
> /initClaude 会自动分析当前项目，生成一份基础的 CLAUDE.md，通常包含：
- 项目概述
- 检测到的技术栈
- 常用命令（build / test / dev）
- 文件结构说明
这非常适合作为项目级 CLAUDE.md 的第一版起点。生成后检查一遍，把不准确的地方改掉，再加上这个项目特有的约定即可。
通关检定
- [ ] 说得清全局 CLAUDE.md 和项目 CLAUDE.md 各管什么
- [ ] 在项目根目录运行过
/init，生成了一份CLAUDE.md - [ ] 检查并修正了生成内容里不准确的地方
全部点亮就算通关 ✓
完整模板和进阶用法
快速上手阶段不需要把 CLAUDE.md 写得很完整。如果你后面想深入了解：
- 三层文件结构（全局 / 项目内 / 项目根）
- 全局 CLAUDE.md 应该写什么
- 项目级 CLAUDE.md 的完整模板
- 长度建议和敏感信息注意事项
可以进入 2.7 CLAUDE.md 与项目配置 → 继续学。
先跑起来，再慢慢迭代
CLAUDE.md 最重要的是先把最关键的约束定下来，而不是一次写到面面俱到。 后续在实际使用中发现缺什么，随时可以补。
下一关
配好 CLAUDE.md 后，进入 1.5 如何更新与排错 →，了解版本管理和常见报错的处理方式。