CLAUDE.md 怎么写？
简短回答多位博主的实测经验指向同一个方向：CLAUDE.md 要短。只写项目是做什么的、用哪个包管理器、几个关键命令，再加上仓库里特殊、不容易从代码里看出来的坑。规则太多会互相冲突，也会占掉每次请求的上下文。不建议直接用 /init 自动生成，因为里面很多内容 Agent 自己就能从代码里发现。另外也有人把具体的行为规则写进去，比如不熟悉的功能先去 GitHub 搜开源项目。
具体怎么做
点头像看对应的原帖- 1
先写最基本的三样：一句话说清项目做什么、用哪个包管理器、有哪几个关键命令，其余内容拆出去，用到时再让 Agent 自己翻。
- 2
不要直接用 /init 自动生成，它会把项目结构、技术栈、代码路径都塞进去，这些多半能自己发现，还容易过期。
- 3
只保留仓库里真正特殊、很难从代码里直接发现的坑。过多的规则容易互相冲突，Claude 还得先判断该听哪一条。
- 4
可以直接抄现成的规则，比如 OpenCode 的 4 条：外部数据只在入口校验一次、只用一次的逻辑不提前抽成函数等。
- 5
加一条按需搜索的规则也有效：不熟悉的功能别从零写，先去 GitHub 搜开源项目对比思路再动手，作者说写代码更顺了。
- 6
团队里同时用多种 Agent 时要注意，Claude Code 目前主要读 CLAUDE.md，不读 AGENTS.md，两套规则需要保持同步。
X 上的人怎么说按有用程度排
01鸟哥08-19中规则文件别写太长，只留项目简介、包管理器和命令#1看了篇《完整的 AGENTS.md 指南》，越读越觉得很多人搞反了。 你是不是也觉得，AGENTS.md 写得越长越细，Agent 就越听话？恰恰相反。Claude Code图原帖11.1万赞 4
鸟哥08-19中规则文件别写太长，只留项目简介、包管理器和命令#1看了篇《完整的 AGENTS.md 指南》，越读越觉得很多人搞反了。 你是不是也觉得，AGENTS.md 写得越长越细，Agent 就越听话？恰恰相反。Claude Code图原帖11.1万赞 402Kevin Ma08-13中不要用 /init 自动生成，只写难以从代码推断的信息#2如果你也在考虑精简自己的 AGENTS.md，很推荐读一下 @mattpocockuk 的这篇文章，里面还附了一个可以直接让 Agent 帮你重构 AGENTS.md 的 Prompt：Claude Code原帖7.0万赞 619
Kevin Ma08-13中不要用 /init 自动生成，只写难以从代码推断的信息#2如果你也在考虑精简自己的 AGENTS.md，很推荐读一下 @mattpocockuk 的这篇文章，里面还附了一个可以直接让 Agent 帮你重构 AGENTS.md 的 Prompt：Claude Code原帖7.0万赞 61903Xudong Han07-25中CLAUDE.md 只保留仓库里很难发现的特殊坑#3这篇文章，我真心建议所有使用 Claude Code 或者 Codex 的人都看一遍。 我之前写过几次类似的感受：模型能力提升后，我们还在沿用旧模型时代的提示习惯，给 Agent 塞满规则、示例和各种「不要做什么」，很多时候反而会限制它。Claude Code原帖13.6万赞 558
Xudong Han07-25中CLAUDE.md 只保留仓库里很难发现的特殊坑#3这篇文章，我真心建议所有使用 Claude Code 或者 Codex 的人都看一遍。 我之前写过几次类似的感受：模型能力提升后，我们还在沿用旧模型时代的提示习惯，给 Agent 塞满规则、示例和各种「不要做什么」，很多时候反而会限制它。Claude Code原帖13.6万赞 55804越川10-25中OpenCode 规则四条，可直接抄进 CLAUDE.md用 Codex 写代码，最烦的就是它爱加防御代码：改一个小功能，加了十几层判空和 try/catch，再防一个几乎不可能发生的并发问题，代码量翻一倍。 OpenCode（开源的编程 agent）仓库里有一份 AGENTS.md，专门有一条治这个。Claude Code原帖12.7万赞 1474
越川10-25中OpenCode 规则四条，可直接抄进 CLAUDE.md用 Codex 写代码，最烦的就是它爱加防御代码：改一个小功能，加了十几层判空和 try/catch，再防一个几乎不可能发生的并发问题，代码量翻一倍。 OpenCode（开源的编程 agent）仓库里有一份 AGENTS.md，专门有一条治这个。Claude Code原帖12.7万赞 147405琳小航10-26中在 CLAUDE.md 加一条先搜 GitHub 开源项目的规则最近用ClaudeCode写代码越来越丝滑 很大部分原因是我在CLAUDE.md加了这条规则Claude Code原帖14.3万赞 1680
琳小航10-26中在 CLAUDE.md 加一条先搜 GitHub 开源项目的规则最近用ClaudeCode写代码越来越丝滑 很大部分原因是我在CLAUDE.md加了这条规则Claude Code原帖14.3万赞 168006Max For AI08-26中Claude Code 只读 CLAUDE.md，多工具团队要同步🚨突发，Shopify CEO Tobi Lütke 公开向 Anthropic 施压！ Tobi称 如果 Claude Code 继续拒绝读取 AGENTS.md 和 .agents/skills，Claude Code原帖15.3万赞 508
Max For AI08-26中Claude Code 只读 CLAUDE.md，多工具团队要同步🚨突发，Shopify CEO Tobi Lütke 公开向 Anthropic 施压！ Tobi称 如果 Claude Code 继续拒绝读取 AGENTS.md 和 .agents/skills，Claude Code原帖15.3万赞 508没有找到匹配的推文或博主
这里的做法都来自 X 上用户的实测，规则和产品经常变，以最新的情况为准。看到更好的做法，欢迎提交给我们。