你的团队用Claude Code写代码,但可能正在浪费近一半的生产力。Anthropic内部数据显示,同一套AI工具在不同团队手里,效率差距能拉到40-60%——差距就藏在有没有好好用一个叫CLAUDE.md的文件。
CLAUDE.md不是个人备忘录,是团队的操作系统层。
大多数人把它当随手记。但Anthropic的文档写得明白:这个文件在每次会话开始时自动读取,支持项目级、用户级、组织级三层作用域。换句话说,它是 Claude 接触代码前的"预加载内存",决定了AI是继承你的团队规范,还是每次从零开始猜。
为什么" tribal knowledge "正在吃掉你的团队效率
一个聪明的编码助手,上限取决于它继承的上下文质量。如果每个工程师都要重新描述构建步骤、命名规范、架构决策、审查规则,你们不是在放大智能,是在重复支付 setup cost。
Anthropic 内部的使用案例很能说明问题。新人和老员工都用 Claude Code 导航不熟悉的代码库;基础设施数据科学家依赖 Claude 读取相关的 CLAUDE.md 来解释依赖关系和上游数据源。技术知识原本散落在 wiki、代码注释和人脑子里,现在通过 MCP 和 CLAUDE.md 被整合成可复用的机器可读指南。
团队采纳失败的方式往往很无聊。新人不知道哪些命令安全;外包不知道"完成"的标准是什么;有产品思维的开发者能生成代码,但会漏掉 house style、跳过检查、重复造轮子。CLAUDE.md 给 Claude 一个稳定起点,在任何 prompt 写出来之前。
/init 命令:从0到1的自动化起点
Anthropic 推荐的工作流是 Explore → Plan → Implement → Verify,而 CLAUDE.md 是这个循环的底座。/init 命令能自动分析代码库生成初始版本,如果文件已存在,还会建议改进。
项目级的 CLAUDE.md 应该包含:构建和测试命令、编码标准、架构决策、命名规范、常见工作流。这不是文档洁癖,是把隐性知识显性化的最低成本路径。
一个细节:Anthropic 自己的文档反复强调要"定期修剪指令"。CLAUDE.md 不是越厚越好,而是要保持与代码库同步的活文档。过时的上下文比没有上下文更糟——AI 会自信地执行错误规范。
从个人工具到组织基础设施
CLAUDE.md 的真正价值在团队层面才完全释放。减少 onboarding 摩擦、让标准可复用、降低上下文切换成本——这些才是 executive 故事。
Anthropic 把技术知识描述为"经常散落在 wiki、代码注释和人脑子里"。CLAUDE.md + MCP 的组合,是把这些东西 consolidate 成可用形态的基础设施。不是取代人,而是让人的注意力从"解释规则"转移到"解决真正的问题"。
有个对比值得细想:个人用 Claude Code 是 productivity boost;团队用好了 CLAUDE.md,是 organizational capability。前者是线性的,后者是乘数的。
现在打开你的代码库,检查一下 CLAUDE.md 存在吗?是项目级的还是个人级的?最后更新是什么时候?——这三个问题的答案,大概能解释你们团队 AI 效率的真实水位。
热门跟贴