6 min read

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——按关注点拆分的额外的规则类配置文件

**今天,咱们重点讲项目层和模块层。**这是你能掌控的、对效率影响最大的部分。

Image

📄 CLAUDE.md:项目的入职手册

这是最核心的一个文件,放在你项目的根目录下。CC 每次启动都会读它。

它要回答的问题很简单:这个项目是什么,你在这里应该怎么干活。

具体放什么,因项目而异,但一般会包含:

  • 项目是什么,整体结构长什么样
  • 子项目/子目录各自的职责
  • 工作流约定(什么操作要先确认,什么可以直接做)
  • 代码/内容的具体规范
  • Git 规则和隐私红线
  • Skills 管理方式

哦对了,如刚开始不知道该写什么,CC 有一个快捷命令:/init。

它会自动扫一遍你的项目文件,然后生成一个基础版的 CLAUDE.md。不完美,但至少有个起点,你在这个基础上改就行。

一个关键限制:控制在 200 行以内。

超了之后 CC 对指令的遵守率会明显下降。如果内容太多,就用模块层来拆分——这也是我们接下来要讲的。

Image

🧩 .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根本不会去调用这个文件。当能够正常调用后,它的价值会在用的过程中慢慢长出来。

Image

💡 一个让规则效果翻倍的技巧

写规则的时候,大部分人只写【做什么】,不写【为什么】。

比如"不要用 git add -A"——CC 会照做,但它不理解原因,换个类似的场景可能就不守规矩了。但是,如果你写"不要用 git add -A——API keys 和 .env 文件会被静默扫进去",效果完全不同。

CC 理解了原因之后,在相关场景都会自动规避,不只是你写的那一条。

这个原则在社区里有一个说法:

Context over Instruction(为什么比怎么做更重要)

**不是每条规则都需要加 Why,只给那些原因不够直觉的加就行。**方法也简单,直接在规则后面用破折号接上原因,一句话搞定。

Image

✅ 搭完之后你会得到什么

配好这套文件,CC 每次 session 的起点就不再是零了。

它知道这个项目的结构,知道你是谁,知道自己应该用什么语气,知道哪些操作要先问你,知道上次踩过什么坑。

不夸张地说,配好之前和配好之后,体感差距是质变级别的。

如果觉得内容有帮助,点赞转发支持一下,谢谢!

关注 @jiunian ,了解更多Claude Code相关技巧。