CLAUDE.md 七大进阶技巧：从能用好到用精

2026-05-14

1. 从项目文档到行为操作系统
2. 控制在 200 行以内
3. 前 30 行要极度优化
4. 分离「硬规则」与「偏好」
5. 建立「反模式」章节
6. 定义「什么样的结果算好」
7. 渐进式暴露：用 imports 代替内联
8. 嵌套 CLAUDE.md 分层控制
思考
总结

1. 从项目文档到行为操作系统

CLAUDE.md 是 Claude Code 启动时读取的第一个文件。大多数人把它当作项目 README 来写——项目名、技术栈、代码规范、提交格式。但真正用好它的人，把它变成了一套行为操作系统、上下文路由器、质量门槛和架构记忆。

这不是夸张。CLAUDE.md 的写法直接决定了 Claude 在你的项目中「表现如何」，而不仅仅是「知道什么」。

本文的 7 条技巧来自一份 GitHub 仓库和一些社区实践，都是被验证过的高阶用法。

2. 控制在 200 行以内

隐藏得最深的一个错误：写超长的 CLAUDE.md。

因为 CLAUDE.md 每次都会被加载到上下文窗口中，文件越长意味着：

Token 浪费：每轮对话都带着这堆文字
指令稀释：规则越多，优先级越不明确
稳定性下降：后面的规则被悄悄忽略

小而精的文件几乎总是更好。200 行是天花板，60-100 行是黄金区间。超过的部分要么是废话，要么应该放到外部引用文件中。

3. 前 30 行要极度优化

Claude 对开头部分投入的关注度不成比例。如果把 CLAUDE.md 看作一个 prompt，前 30 行就是 prompt 的 system message——它塑造了后面一切。

如果前 30 行写的是「这是一个 Python 项目，使用 FastAPI 框架，Python 3.11」，Claude 记住了这些基本信息，但它的行为没有被约束。如果前 30 行写的是：

# 项目身份
内部企业分析平台，面向非技术用户

# 核心约束
- React + TypeScript 前端，Python FastAPI 后端
- 所有 API 返回统一格式：{ code, data, message }
- 不允许引入新的绘图库——所有图表用 ECharts
- 每个新功能必须包含端到端测试

Claude 从一开始就知道边界在哪里。

4. 分离「硬规则」与「偏好」

很多人把铁律和偏好混在一起写：

- 使用 TypeScript
- 尽量用函数组件
- 推荐使用 pnpm
- 禁止引入 lodash
- 变量名用 camelCase

Claude 在这些混在一起的列表里分不清优先级。更好的做法是分两部分：

硬规则（必须遵守）：

- 禁止引入 lodash——用原生 JS 替代
- 所有 API 响应必须包含 request_id
- 不允许使用 any 类型

偏好（建议优先）：

- 推荐函数组件而非类组件
- 优先使用 pnpm 而非 npm/yarn
- 变量名建议 camelCase 而非 snake_case

分开写之后，Claude 对哪些是不能妥协的、哪些是风格建议的理解清晰得多。

5. 建立「反模式」章节

大多数人只描述 Claude 该做什么。高手还会定义它绝对不能做什么。

## 反模式
- 禁止创建通用营销文案
- 禁止使用占位符 lorem ipsum
- 未经审批不得引入新依赖
- 不得重构当前任务无关的文件
- 禁止使用居中 hero 布局（除非被要求）

这种负面约束的效率往往高于正面指令。原因在于 LLM 的生成特性：你告诉它「不要做 X」时，它在生成过程中会主动避开 X；而告诉它「要做 Y」时，它可能做了 Y 但同时也做了你不想要的 Z。

建议在 CLAUDE.md 里专门建一个反模式章节，每次 Claude 做错事就追加一条。

6. 定义「什么样的结果算好」

大多数人只写规则，但更好的做法是同时定义目标。比如：

## 成功标准
好的实现应该：
- 不需要额外解释就能理解
- 一眼能扫描出结构
- 行为可预期
- 认知负担低
- 后续容易修改

这能让 Claude 从「按指令执行」升级到「按标准思考」。当你给它一个模糊的任务时，这些标准会引导它做出符合预期的选择。

7. 渐进式暴露：用 imports 代替内联

不一定把所有内容塞进 CLAUDE.md。可以用引用机制让 Claude 按需加载：

关于设计系统的信息，查阅 @docs/design-system.md
当创建新组件时，确保符合 UX 设计原则 @docs/ux-principles.md

Claude 只有在涉及相关任务时才会去读这些引用文件。核心文件保持精简，细节按需暴露。这和 Agent Skills 规范中的「渐进式暴露」原则是同一个思路。

8. 嵌套 CLAUDE.md 分层控制

很多人不知道：Claude 遵循最近上下文优先原则。你可以在不同的目录放不同的 CLAUDE.md：

/CLAUDE.md              # 全局规则（前后端通用）
/app/CLAUDE.md          # 前端组件规则
/app/dashboard/CLAUDE.md # 数据页面规则

Claude 在对应目录工作时，会自动加载对应层级的规则。例如在 app/dashboard/ 下写代码时，它的生效规则是：

根目录 CLAUDE.md（全局规则）
app/CLAUDE.md（前端规则）
app/dashboard/CLAUDE.md（数据页面规则）

越具体的规则优先级越高。这让大型项目的约束管理变得非常优雅——你不需要把后端的部署规则塞进一个需要处理前端组件的会话里。

思考

这 7 条里我觉得最有价值的是反模式章节和嵌套文件分层。我自己写技能文件时就发现，告诉 AI「不能做什么」比告诉它「要做什么」效果更直接——负面约束像护栏，正面指令像地图，护栏更能防止 Agent 跑偏。

嵌套 CLAUDE.md 也是被很多人低估的。我之前一直把所有的约束塞进根目录一个文件，结果越写越长。改成按目录分层之后，每个文件都精简了，Claude 在各场景下的表现也更稳定——它在处理前端组件时不需要同时记着后端的部署规则，认知负担减轻了不少。

如果只能改一条，我建议先从行数控制开始——把 CLAUDE.md 砍到 200 行以下，再把前 30 行优化成最核心的约束。这一条改完效果最明显。

总结

CLAUDE.md 的七大进阶技巧：限制总行数（200 行天花板，60-100 行黄金区间）、优先优化前 30 行（塑造行为而非描述信息）、分离硬规则与偏好（让优先级一目了然）、建立反模式章节（负面约束效率高于正面指令）、定义成功标准（从按指令执行升级到按标准思考）、用导入实现渐进式暴露（核心精简，细节按需加载）、用嵌套文件分层控制（最近上下文优先原则）。其中反模式章节和嵌套文件两条最值得优先实践。

版权所有，本作品采用知识共享署名-非商业性使用 3.0 未本地化版本许可协议进行许可。转载请注明出处：https://www.wangjun.dev//2026/05/7-advanced-claude-md-tips/