// usage

约束先行

用好 Claude Code 的核心,不是 Skills,不是 Prompt 技巧,
而是这四个字:约束先行。

工作区乱了

有人新建了一个给 Claude Code 用的 Skills 开发文件夹,几天后打开一看:

根目录散了十几个东西。打包文件跟源码混在一起,测试图片随便丢,评估报告找不到归属。

最离谱的是命名——test_batch 是哪个 Skill 的测试?test_v2 又是谁的 v2?自己做的东西,放了两天自己都看不出来。

让 Claude Code 收拾完之后,他反思了一个问题:

"为什么 Claude Code 进到新文件夹,自己不会给自己定规范?一定要我给它定?"

因为顶层约束没做好

对于 AI 来说,你脑子里知道的东西,如果没有写进文档,就是不存在的。

Agent 的短期记忆会丢失,对话框一关全忘了。下次打开,它唯一能看到的就是你留下来的文档和记忆文件。

你的文档里写了什么,是不是足够清晰,直接决定了 Agent 每一次醒来的时候,是清醒的还是懵的。

CLAUDE.md 四层结构

约束从上往下穿透,一层管一层。跟治理公司一样:制度在最上面,部门规范在中间,操作流程在最下面。

01 全局 CLAUDE.md
02 项目 CLAUDE.md
03 规范文档
04 记忆文件
hover 查看各层详解
layer_01 · 最高指令

全局 CLAUDE.md

放在 ~/.claude/CLAUDE.md,无论打开什么项目都会加载。

解决:你是谁、你做事的原则、你希望 AI 用什么方式跟你协作。

layer_02 · 项目宪法

项目 CLAUDE.md

放在项目根目录 项目目录/CLAUDE.md,只在打开这个项目时加载。

解决:目录结构、命名规范、什么文件放哪里。

layer_03 · 操作说明

规范文档

项目里的各种规范文档、设计文档、架构说明。

解决:具体的操作流程和技术细节。

layer_04 · 临时笔记

记忆文件

Auto Memory、对话记录、Claude 自己给自己做的笔记。

解决:跨对话的上下文延续。

~/.claude/ CLAUDE.md project-a/ project-b/ project-c/ 规范文档 规范文档 规范文档 记忆文件 memory/
游戏前期最重要的不是赶紧建建建,而是先把路网规划好。路网一旦规划歪了,后面再怎么优化都没招,只能推倒重来。

你的 CLAUDE.md 就是你的路网。全局 CLAUDE.md 是城市主干道,项目 CLAUDE.md 是片区支路。

全局 CLAUDE.md 模板

一共 30 多行,分成六个部分。每个块都跨项目通用。在「关于我」里写上你自己的内容,其他基本可以直接复用。

关键数字

CLAUDE.md 不是越长越好。超过 80 行,Claude 开始遗漏内容。最多最多,不要超过 200 行

CLAUDE.md
展开全部

项目 CLAUDE.md 怎么写

全局定好了,项目级的更简单——你甚至不用自己写。

需求、聊想法、聊规划,把你的思路和 Claude Code 畅快地聊出来。

有了项目 CLAUDE.md 之后,它就会自动判断这是不是一个新产品,如果是的话,直接帮你新建文件夹开始做,整个文件管理井井有条。

约束定好了,就可以开始——

做网站、玩小程序、玩笔记整理。全局 CLAUDE.md 是你的主干道,项目 CLAUDE.md 是你的支路。主干道规划好了,支路自然就顺了。

你花一个小时写好 CLAUDE.md,
后面能省无数个小时的返工。

引导 Agent,跟管理公司没什么两样。

你也要制度、要规范、要 SOP、要规矩。

先想清楚你要什么,定好规则,然后在规则框架里做出最优解。

这就是最棒的方法。