Day 9:几个基础配置文件让 Claude Code 真正懂你
Source: http://x.com/i/article/2032961620670824448
用 Claude Code 这么久,有没有发现一个问题?
每次开一个新 session,它又不认识你了。重要文件放在哪?哪些操作不能做?你的偏好流程是什么样的?这些全忘了。
你得重新解释一遍,它才能理解上下文并开始干活。用久了你会有一种感觉:这东西记性也太差了吧,一点都不懂我!
等等,其实...我想说,你可能是误会cc了;它不是不懂你,而是你没有给它机会。
CC 本身有一套配置文件体系,搭好了之后,它每次开 session 都会自动加载。
相当于你给它写了一本【入职手册】,以后每次上班第一件事就是翻一遍这本手册,然后带着完整的上下文开始干活。
今天这篇文章就是讲:这套配置文件(简易版)到底该怎么搭。
🗂️ 先说全貌:配置文件
CC 的配置文件其实有四层,让我们来快速过一遍:
全局层 ~/.claude/CLAUDE.md——跨所有项目生效
项目层 项目根目录/CLAUDE.md——仅针对当前项目有效
本地层 .claude/local.CLAUDE.md——仅针对本地项目有效
模块层 .claude/rules/*.md——按关注点拆分的额外的规则类配置文件
**今天,咱们重点讲项目层和模块层。**这是你能掌控的、对效率影响最大的部分。
📄 CLAUDE.md:项目的入职手册
这是最核心的一个文件,放在你项目的根目录下。CC 每次启动都会读它。
它要回答的问题很简单:这个项目是什么,你在这里应该怎么干活。
具体放什么,因项目而异,但一般会包含:
- 项目是什么,整体结构长什么样
- 子项目/子目录各自的职责
- 工作流约定(什么操作要先确认,什么可以直接做)
- 代码/内容的具体规范
- Git 规则和隐私红线
- Skills 管理方式
哦对了,如刚开始不知道该写什么,CC 有一个快捷命令:/init。
它会自动扫一遍你的项目文件,然后生成一个基础版的 CLAUDE.md。不完美,但至少有个起点,你在这个基础上改就行。
一个关键限制:控制在 200 行以内。
超了之后 CC 对指令的遵守率会明显下降。如果内容太多,就用模块层来拆分——这也是我们接下来要讲的。
🧩 .claude/rules/:把关注点拆开
CLAUDE.md 负责大方向,但有些东西塞进去会让它变得太长,比如你的个人画像、Agent 的人格设定、决策原则。
官方的解法是 .claude/rules/ 目录。你在里面放 .md 文件,没有 paths 前缀的会自动全局加载——跟 CLAUDE.md 一起注入,不需要手动 import。
我自己的拆法是这样的:
markdown
.claude/rules/
├── identity.md ← Agent 是谁:语气、态度、底线
├── principles.md ← 决策原则:模糊时怎么判断
├── user.md ← 用户画像:我是谁、在做什么、偏好
└── regression.md ← 回归记录:踩过的坑、修正的规则
那么,我来逐个说一下。
identity.md — 给 Agent 一个人格
这个文件的目的是让它的输出风格稳定。
你可以定义它说话的语气,跟你的关系(助手?同事?朋友?),什么时候该主动说话,什么时候闭嘴。
没有这个文件,CC 就是一个通用的、客客气气的助手。有了之后,它会变成一个你用起来顺手的、有一致性的协作对象。
principles.md — 做决策不确定时该怎么办
规则不可能覆盖所有情况。
而当 CC 遇到没有明确指令的场景,它按什么逻辑决策呢?比如:要快还是要稳?改一个文件还是三个?不确定的时候是猜还是问?
这些写清楚,它在边界情况下的行为就会可预期得多。
user.md — 告诉它你是谁
你的背景、领域、工作风格、优先级。
这些信息能帮 CC 在回答时自动校准,知道你是什么水平。这样,它就不会在你问一个进阶问题的时候从零科普。
regression.md — 这个是加分项,跟principles.md配套着用
它的逻辑是:每次 CC 犯了一个你不得不纠正的错误,记一条进去——发生了什么,违反了哪条原则,以后怎么改。
然后定期把这些教训喂回 principles.md,形成一个闭环。
重要的一点!记得去设置触发条件,不然很可能cc根本不会去调用这个文件。当能够正常调用后,它的价值会在用的过程中慢慢长出来。
💡 一个让规则效果翻倍的技巧
写规则的时候,大部分人只写【做什么】,不写【为什么】。
比如"不要用 git add -A"——CC 会照做,但它不理解原因,换个类似的场景可能就不守规矩了。但是,如果你写"不要用 git add -A——API keys 和 .env 文件会被静默扫进去",效果完全不同。
CC 理解了原因之后,在相关场景都会自动规避,不只是你写的那一条。
这个原则在社区里有一个说法:
Context over Instruction(为什么比怎么做更重要)
**不是每条规则都需要加 Why,只给那些原因不够直觉的加就行。**方法也简单,直接在规则后面用破折号接上原因,一句话搞定。
✅ 搭完之后你会得到什么
配好这套文件,CC 每次 session 的起点就不再是零了。
它知道这个项目的结构,知道你是谁,知道自己应该用什么语气,知道哪些操作要先问你,知道上次踩过什么坑。
不夸张地说,配好之前和配好之后,体感差距是质变级别的。
如果觉得内容有帮助,点赞转发支持一下,谢谢!
关注 @jiunian ,了解更多Claude Code相关技巧。