我的 CLAUDE.md 里都放了什么

Thu, 19 Feb 2026 16:20:00 +0000

最讽刺的事情是什么? 你一边抱怨"每次新会话都要重新跟 Claude 解释项目背景", 一边项目根目录里根本没有 CLAUDE.md。

别笑, 我之前就是这个状态。

后来发现有个偷懒的办法——直接跑 /init。Claude 会自动分析你的项目结构、检测构建工具和测试框架, 生成一份初始的 CLAUDE.md。如果已经有 CLAUDE.md 了, /init 不会覆盖, 而是建议改进。

CLAUDE.md 的本质

Claude Code 启动的时候会自动读这个文件, 把它当作用来理解项目的起点。你项目怎么跑测试、目录结构是什么、有哪些不能碰的约定——写进去, 它自己就知道了。

最常见的用法——把命令写进去, 省得每次说:

## Commands
- 测试: npm test
- 构建: npm run build
- 单文件测试: npx jest src/xxx.test.ts
- Lint: npx eslint src/

有了这些, Claude 自己知道该跑什么, 不用你再说"跑一下测试"。

有些东西 Claude 看代码看不出来:

## Architecture
- 状态管理用 Zustand, 不用 Redux
- API 请求统一走 src/api/ 下的封装
- 不要直接改 src/core/ 里的文件, 只能通过扩展接口

Linter 管不了, 但 review 的时候一定会被说的: