一张图讲透 CLAUDE.md:三层作用域+What/Why/How 框架与5条铁律

nikola_mr64990 · x · 2026-10-13

一份 Claude Code 的 CLAUDE.md 设计指南（配图为完整架构图）：

• 三层作用域：全局（/.claude/CLAUDE.md，个人编码风格与通用规则）、项目级（./CLAUDE.md，技术栈、构建/测试命令、团队约定）、文件夹级（模块覆盖规则）；冲突时最后作用域生效。
• What/Why/How 框架：What 写上下文（项目用途、技术栈、目录结构、依赖）；Why 写原则（架构决策、命名规范、反模式）；How 写工作流（build/test/lint/deploy 具体命令）。
• 示例：给出 Pixels Connect 项目的实际 CLAUDE.md 写法（camelCase 变量、App Router only、no pages/ 目录等）。
• 5 条铁律：先跑 /init 让 Claude 搭基线再手工整理；控制在 500 行以内否则被忽略；用 Hooks 做 100% 强制执行（CLAUDE.md 只有约 70% 遵循率，Hooks 是绝对的）；每月随架构演进更新；引用文件而非复制内容（指向 package.、tsconfig）。

核心观点：CLAUDE.md 不是给人看的 README，而是给 AI 队友的入职文档。

原文链接 →

「编程与Agent」频道最新

• Anthropic 单日代码合并量自 5 月以来增 10 倍，9 月峰值破 3 万 — inductionheads · 2026-10-14
• Plane 推出工作区 Agent：像团队成员一样分配任务与@协作 — JosephJacks_ · 2026-10-14
• 开发者预言 2027 年软件开发周期坍缩:从提示到上线不到一天 — NickPassig · 2026-10-14
• 20 个免费提示词：把 Claude Cowork 的 SEO 潜力用满 — JaynitMakwana · 2026-10-14
• Agentic 软件工厂:从 AI 辅助编码走向 AI 驱动交付全流程 — Pavan_Belagatti · 2026-10-14
• 提出 GWE 概念:工作区而非模型掌握 Agent 权威 — sull · 2026-10-14

更多「编程与Agent」频道 AI 资讯 →