CLAUDE.md 配置笔记
整理自 Claude Code 会话 | 2026-05-12
Q: CLAUDE.md 是项目维度的吗？有没有全局维度的？
A: 有，CLAUDE.md 分三个层级，追加加载（不互相覆盖）：
| 层级 | 路径 | 作用域 | 提交到 Git |
|---|---|---|---|
| 全局 | ~/.claude/CLAUDE.md | 所有项目通用 | 否 |
| 项目 | ./CLAUDE.md | 当前项目 | 是 |
| 本地覆写 | ./CLAUDE.local.md | 个人偏好 | 否（加入 .gitignore） |
行数建议：
| 层级 | 推荐上限 |
|---|---|
| 全局 | 15 行以内 |
| 项目 | 200 行以内（理想 60-80 行） |
全局文件适合放的内容：
- “修改代码后运行测试”
- “提交前先问我”
- “偏爱简洁方案，别过度工程”
- 终端/工具偏好
项目文件适合放的内容：
- 技术栈描述、目录结构
- 精确的构建/测试命令
- 非默认约定（如"用 Zustand，别用 Redux"）
- 已知坑点（weird retry logic 等）
Q: GitHub 上最火的 CLAUDE.md 有哪些？
A: 两个最值得参考的：
| 仓库 | Stars | 核心内容 |
|---|---|---|
| forrestchang/andrej-karpathy-skills | 120K+ | 四条行为原则，~70 行 |
| abhishekray07/claude-md-templates | 187+ | 三层配置模板 + 最佳实践 |
Karpathy 四条原则：
- Think Before Coding— 不假设，不确定就问
- Simplicity First— 最少代码解决问题
- Surgical Changes— 只改必须改的
- Goal-Driven Execution— 定义验收标准，循环验证
核心习惯：每次纠正 Claude 后说 “Update CLAUDE.md so you don’t make that mistake again.”
