Claude Code 架构决策：分清 CLAUDE.md 与 Skill，告别上下文混乱

导语：CLAUDE.md 是项目的大脑，Skill 是双手——本文清晰解析二者区别及配合之道。

在使用 Claude Code 进行开发时，很多人都会困惑：“到底什么信息该写进 CLAUDE.md，什么信息又该写进 Skills？” 这并非小问题，而是影响长期协作的关键架构决策。如果处理不当，规则会互相冲突，流程覆盖混乱，导致 Claude 每次执行都像在不同脑回路里横跳。

先说结论

如果非要用一句话区分：

CLAUDE.md = 项目的大脑，Skill = 项目的双手。

CLAUDE.md 是项目级的“记忆文件”，存放架构原则、编码规范、依赖关系等全局性信息，让模型理解项目的整体上下文。而 Skill 是面向具体任务的“操作手册”，封装可复用的流程，例如代码审查、部署检查、生成测试等，告诉模型如何一步步执行特定工作。

何时用 CLAUDE.md，何时用 Skill？

简而言之，信息如果具有全局性、长期不变、需要被每次会话加载，就放入 CLAUDE.md；如果是某个具体场景的步骤性知识，可复用但并非每次都需要，就封装为 Skill。例如：项目使用的框架版本、命名约定属于 CLAUDE.md；而“如何发布一个新版本”这样包含多个步骤的流程则适合做成 Skill。

两者配合时，CLAUDE.md 提供背景信息，Skill 引用这些背景来完成具体任务，避免重复声明，保持项目条理清晰。切忌把所有内容都往一个文件里堆，否则项目越复杂越失控。