Claude Code的CLAUDE.md本事

如果你想让 Claude Code 像一位常驻在你代码库里的资深工程师，你的项目就必须要有结构。
Claude 在任何时间都必要四样东西：
• 目标（Why）→ 体系是做什么的
• 舆图（Map）→ 东西都在哪儿
• 规则（Rules）→ 允许/克制什么
• 工作流（Workflows）→ 事变怎样完成

CLAUDE.md = 代码库影象（保持简短）这是你的北极星文件。不是知识堆砌，只需包罗：
• 项目目标（WHY）
• 代码库舆图（WHAT）
• 规则与指令（HOW）
如果写得太长，模子反而会忽略紧张上下文


.claude/skills/ = 可复用的专家模式别再重复写指令了。把常用工作流封装成“技能”：
• 代码查察清单
• 重构操纵手册
• 发布流程
• 调试步调
结果：跨对话、跨成员，都能保持同等性。


.claude/hooks/ = 防护栏模子会忘。
钩子不会。用它们来处置惩罚必须确定的事变：
• 编辑后自动运行格式化
• 核心改动时运行测试
• 克制访问敏感目次（如认证、计费、数据迁徙）


docs/ = 渐进式上下文别把提示词塞爆。 Claude 只必要知道“究竟存放在那里”：
• 架构概述
• 架构决议记录
• 运维操纵手册


为高风险模块设置局部 CLAUDE.md 在关键位置放置小型指引文件：
src/auth/CLAUDE.md
src/persistence/CLAUDE.md
infra/CLAUDE.md
如许，Claude 在处置惩罚这些模块时，能立刻看到具体的留意事项。


总结
提示词是临时的，结构是永世的，当你的代码库按这种方式构造起来时，Claude 就不再表现得像一个谈天呆板人，而开始像一个生于项目、长于项目标工程师。