CLAUDE.md 是什么
CLAUDE.md 可以理解成 Claude Code 的项目记忆文件。
它会告诉 Claude：
- 这个项目是干什么的
- 代码怎么组织
- 团队有哪些规范
- 哪些命令最常用
- 哪些事情不能做
写得好的 CLAUDE.md，会显著提升 Claude Code 的稳定性。
为什么它这么重要
因为很多"AI 不听话"的问题，根本不是模型不够聪明，而是系统没有拿到清晰的项目约束。
最推荐写进去的内容
1. 项目基本信息
- 技术栈
- 目录结构
- 关键模块
2. 开发规范
- 命名规则
- 组件风格
- 是否允许引入新依赖
3. 常用命令
- 安装命令
- 开发命令
- 构建命令
- 测试命令
4. 特别约束
- 哪些目录不要动
- 哪些文件修改要谨慎
- 提交信息风格
一个新手可直接用的模板
# 项目说明
- 这是一个 Next.js + TypeScript 项目
- 样式使用 Tailwind CSS
- 页面放在 app/ 目录
- 公共组件放在 components/ 目录
# 开发规范
- 优先复用已有组件
- 不要随意新增依赖
- 变量命名使用 camelCase
- 修改后运行 build 检查
# 常用命令
- 安装依赖：npm install
- 本地开发：npm run dev
- 生产构建：npm run build
# 注意事项
- 不要修改 legacy/ 目录
- 涉及支付逻辑时先给方案，不要直接改写 CLAUDE.md 的一个原则
不要写废话，要写真正会影响行为的内容。
差的写法：
- 这是一个很棒的项目
- 请认真写代码
好的写法：
- 修改后必须运行
npm run build - 不允许新增依赖，除非先说明理由
- 表单组件统一复用
components/forms
小结
一句话总结：
CLAUDE.md写的不是介绍词，而是 Claude Code 在这个项目里的长期工作说明书。
写得越具体、越贴近真实约束，Claude Code 的表现就越稳定。