Claude Code 项目结构最佳实践！

大多数人把 [CLAUDE.md](http://t.cn/AXLo0vJd) 当成提示词文件来用。

这就错了。

如果你想让 Claude Code 像一个常驻在你代码库里的资深工程师，你的项目需要有结构。

Claude 需要随时知道 4 件事：

• 为什么：这个系统是干什么的\
• 地图：东西都放在哪\
• 规则：什么能做，什么不能做\
• 工作流：事情怎么完成

我把这叫做：

Claude Code 项目的解剖学 👇

━━━━━━━━━━━━━━━

1️⃣ [CLAUDE.md](http://t.cn/AXLo0vJd) = 代码库的记忆（保持简短）

这是北极星文件。

不是知识大杂烩，只需要：

• 目的（为什么）\
• 代码库地图（是什么）\
• 规则和命令（怎么做）

如果写得太长，模型就会开始漏掉重要的上下文。

━━━━━━━━━━━━━━━

2️⃣ .claude/skills/ = 可复用的专家模式

别再重复写指令了。

把常见的工作流变成技能：

• 代码审查清单\
• 重构手册\
• 发布流程\
• 调试流程

结果是：\
跨会话和团队成员的一致性。

━━━━━━━━━━━━━━━

3️⃣ .claude/hooks/ = 护栏

模型会忘事。

钩子不会。

用它们来处理那些必须确定性执行的事情：

• 编辑后运行格式化工具\
• 核心改动后运行测试\
• 阻止访问不安全的目录（认证、计费、数据库迁移）

━━━━━━━━━━━━━━━

4️⃣ docs/ = 渐进式上下文

别让提示词变得臃肿。

Claude 只需要知道真相在哪：

• 架构概览\
• ADR（工程决策记录）\
• 运维手册

━━━━━━━━━━━━━━━

5️⃣ 在危险模块放本地 [CLAUDE.md](http://t.cn/AXLo0vJd)

在容易出问题的地方放小文件：

src/auth/CLAUDE.md\
src/persistence/CLAUDE.md\
infra/CLAUDE.md

这样 Claude 在那里工作时，就能准确看到需要注意的坑。

━━━━━━━━━━━━━━━

提示词是临时的。

结构是永久的。

当你的代码库这样组织时，Claude 就不再表现得像个聊天机器人了……

……而是开始像一个真正了解项目的工程师。

#How I AI##科技先锋官#