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 就不再表现得像一个聊天机器人，而开始像一个生于项目、长于项目的工程师。