CLAUDE.md（核心记忆文件）

CLAUDE.md（核心记忆文件）

CLAUDE.md（核心记忆文件）

CLAUDE.md 是 [[Claude Code]] 的核心配置文件，相当于 Claude 的"宪法"或"行为守则"。它定义了 Claude 在项目中的行为规则、编码风格、测试要求等关键约束。

核心原则

  • 行为守则，不是知识库：CLAUDE.md 定义的是"如何做"，而非"做什么"。
  • 精炼 > 堆砌：控制在 200 行以内（理想 60 行），超过后 Claude 会忽略关键规则。
  • 分层加载：Monorepo 中祖先 + 子目录分层加载。

编写最佳实践

  1. 控制在 200 行以内：理想 60 行，超 200 行即进入"变蠢区间"。
  2. 关键规则用 <important if="..."> 标签包裹：防止文件膨胀时被稀释。
  3. Monorepo 用多个 CLAUDE.md：祖先 + 子目录分层加载。
  4. 大指令拆到 .claude/rules/ 文件夹：避免单文件过大。
  5. 避免 memory.md 或 constitution.md：这些无法保证遵守。
  6. 新人零门槛启动：任何开发者输入"run the tests" 就应立即成功。
  7. 保持代码库整洁：完成所有迁移，避免 Claude 混用旧模式。
  8. 优先用 settings.json 强制行为：如 attribution.commit 而非在 CLAUDE.md 写"NEVER…"。

反模式

相关概念

  • [[上下文预算]] — 上下文管理的核心概念
  • [[agentic-engineering]] — 结构化 AI 编程方法论
  • [[skills-claude-code]] — 技能插件系统
  • [[commands-claude-code]] — 快捷指令系统
分享到