Claude Code 项目结构**实践

大家好，我是讯享网，很高兴认识大家。

大多数人把 CLAUDE.md 当成提示词文件来用。

这就错了。

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

Claude 需要随时知道 4 件事：

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

我把这叫做：

Claude Code 项目的解剖学 👇

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

1️⃣ CLAUDE.md = 代码库的记忆（保持简短）

这是北极星文件。

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

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

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

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

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

别再重复写指令了。

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

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

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

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

3️⃣ .claude/hooks/ = 护栏

模型会忘事。

钩子不会。

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

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

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

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

别让提示词变得臃肿。

Claude 只需要知道真相在哪：

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

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

5️⃣ 在危险模块放本地 CLAUDE.md

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

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

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

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

提示词是临时的。

结构是永久的。

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

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

最后，给大家说件事，我的星球社群持续更新中，很多同学问，你在社群都更新什么内容呢？举个例子，比如，前天，更新了第十五期视频教程：《如何创建一个 AI 漫剧的 Skill ，以及高效的实现 AI 漫剧视频创作？》

我制作了一个 1 分钟的迪士尼风格的动画短片，就是使用我制作的 AI 漫剧 Skill 制作的，使用这个 skill 就会自动帮你把故事或者小说内容制作成编剧分镜脚本，然后根据编剧分镜脚本制作成 AI 生图脚本提示词和图生视频的脚本提示词。拿到这两个提示词之后，你就可以将提示词发到对应的生图模型和视频模型之中就行了。

全程不需要你写文案，不需要你制作脚本和提示词，最后你只负责把生成的视频放到剪辑软件拼接起来就行。

讯享网

其实，不止，我星球里有各种教程，从今年开始，录制视频教程就接近 20 期了。最近非常火的 Agent Skill 视频教程也录制了 15 期了。加入我的星球社群「AIGC·掘金成长研习社」即可获取视频链接学习。

最后，介绍一下，我的星球：「AIGC·掘金成长研习社」（可点击链接查看星球全面介绍），主要分享三个板块的内容：

1、副业赚钱领域的内容。我做自媒体十几年了，有很多副业赚钱方面的经验和干货，而且每周都会定期详细带大家拆解一个副业赚钱案例，持续更新的那种，目前，已经分享了上百篇跟副业赚钱相关的帖子和文章了。

2、AI 落地和实操相关的内容。我在里面也分享了很多 AI的各种玩法和落地场景，包括用 AI 做副业的案例也都有。

3、个人成长。我会分享很多我做超级个体和自由职业的一些思考和成长类的内容，目前我已经做自由职业 5 年了，有太多的感慨和内容分享。

如果你想学习如何搞副业，如何使用 AI ，甚至如何使用 AI 搞副业，那一定要加入我这个超值的星球。目前，已经更新了 1800 多条干货和文章了，加入成员 1300+。感兴趣的可以加入。

限时优惠中，原价 199 元，今天加入可以立减 30 元，只需要 169 元，优惠券仅剩 20 多个优惠名额。我认为我的星球是目前副业和 AI 领域最超值和具有性价比的星球，价格不贵，同时内容也不比几千块钱的星球差。

大家可以扫码，查看，支持 3 天无理由退款，内容好不好，先进来看看再说，不适合自己退了也没毛病。

Claude Code 项目结构**实践

相关推荐