大企业 monorepo 怎么拆 CLAUDE.md 和 Cursor Rules

2026 年 9 月 Medium 长文讨论超大规模仓库的 CLAUDE.md 与 .cursorrules 分层。本文给出与 AGENTS.md 2.1.277 并存的目录策略，避免双端指令打架。

大企业 monorepo 怎么拆 CLAUDE.md 和 Cursor Rules

JEV 在 2026-09-21 分拣中给 Medium 文 How to Structure CLAUDE.md and .cursorrules for Enterprise and Large-Scale Codebases（9 月 18 日）较高 fit（≈0.87）。背景是 Claude Code 2.1.277 已支持 AGENTS.md fallback，Cursor 仍读 .cursor/rules；monorepo 若每层都堆满指令，Agent 会在冲突规则间浪费 token，甚至误触发危险命令。

作者：CodePass 技术编辑

三层文件各自干什么

层 文件 读者
全员 baseline 根 AGENTS.md Claude Code（无 CLAUDE.md 时）、Codex、Copilot
Claude 专用 根或服务 CLAUDE.md 仅 Claude Code
IDE 专用 .cursor/rules 或 .mdc Cursor Tab/Agent

/config 若设 claude-md-and-agents-md，同目录先 CLAUDE 后 AGENTS：把「仅 Claude 需要的 MCP 审批」放 CLAUDE，把「禁 force push、测试命令」放 AGENTS。

目录遍历规则

Claude Code 从 cwd 向上合并 instruction 文件；Cursor rules 有 alwaysApply 与 glob。实践上：

  1. 根 AGENTS.md 只写 15 行内「宪法级」约束。

  2. 每个 deployable 子目录最多一个 CLAUDE.md 补充服务上下文。

  3. Cursor 侧用 .cursor/rules/service-payment.mdc 绑定路径，避免全局 alwaysApply 污染 unrelated 包。

  4. PR 检查 instruction diff，与 不可信仓库 intake 同一审批。

与 9 月 20 日 hub 升级对齐

Builders Weekly 周同时有代理 400 修复与 auto 分类变更；企业 gateway 团队应在 staging 验证「长 CLAUDE.md + 代理」不 400，再推广 monorepo 模板。

参考资料