你用 Claude Code 写代码。
但你打开过项目根目录下的 .claude 文件夹吗？
95%的开发者没有。
他们知道它存在，看它一眼，然后该干嘛干嘛。把它当成一个自动生成的“垃圾箱”，理都不理。
这可能是你在 AI 编程时代，犯的最大的错误。
一个文件夹，凭什么这么重要？
.claude 不是配置目录。
它是 Claude 在你项目里的“行为准则”，是 AI 的“宪法”，是你不在场时的“代言人”。
当你启动一个 Claude Code 会话，它做的第一件事——没有之一——就是读取项目根目录下的 CLAUDE.md。
你写什么，它就执行什么。
你说“每次写代码前先写测试”，它照做。
你说“永远别用 console.log，用我们的 logger 模块”，它服从。
你甚至可以写“TypeScript 严格模式已开启，未使用变量直接报错”，它会记住。
这就是最可怕也最迷人的地方：一个文件，决定了 AI 怎么替你打工。
官方手册没告诉你的事：实际上有“两个”Claude
文章抛出一个很少人注意到的细节：
存在两个 .claude 目录。
一个是项目级的 .claude/，放在你仓库根目录，commit 到 git，全员共享。
另一个是全局级的 ~/.claude/，放在你家目录，只属于你自己。
前者是“团队规则”，后者是“个人偏好”。
有意思的是，很多团队只用项目级配置，完全忽略了个人级配置的存在。这就像公司给你发了统一的工作手册，但你家里那套“个人效率系统”从来没人提过。
CLAUDE.md 到底怎么写？官方给了一套“禁忌清单”
文章列出了实操指南：
应该写：
- 构建、测试、lint 命令（npm run test、make build）
- 关键架构决策（“我们用 Turborepo 做 monorepo”）
- 容易踩坑的约定（“TypeScript 严格模式，unused 变量直接报错”）
- 导入规范、命名风格、错误处理模式
别写：
- linter 和 formatter 配置（那些文件已经存在了）
- 可以直接链接的完整文档
- 长篇大论解释理论
还有一个硬性建议：别超过 200 行。
超过之后，Claude 的指令遵循能力反而会下降。
说实话，这点的反直觉程度拉满——你以为给 AI 的信息越多越好，实际上它会“分心”，会“倦怠，会在海量指令里迷失重点。
当 CLAUDE.md 变成 300 行的垃圾堆，rules/ 来了
一个初创项目可能几十行配置就够用了。
但团队一扩张，情况迅速失控。
300 行的 CLAUDE.md，没人维护，所有人都当它不存在。
这时候 .claude/rules/ 文件夹就是救星。
把一条长指令拆成多个文件：API 规范放 api-conventions.md，测试标准放 testing.md，安全规则放 security.md。
每个人管自己那一摊，互不干扰。
更狠的是 路径作用域——你可以在规则文件里加一段 YAML 前置元数据，让这条规则只在特定目录下生效。
paths:
- src/api/
- src/handlers/
Claude 在写 React 组件时，根本不会加载这个规则。只有它进入 src/api/ 时，才会激活。
这才是真正的“精细化控制”。
斜杠命令、スキル、子代理：三层自动化套件
文章用相当篇幅拆解了三种“进阶玩法”：
commands/：自定义斜杠命令
你在 .claude/commands/ 放一个 review.md，Claude Code 就多了一个 /project:review 命令。文件名就是命令名，简单粗暴。
skills/：自动触发的技能
斜杠命令等你手动输入，技能是 Claude 自己判断时机到了就触发。你说“帮我 review 这个 PR 的安全问题”，它识别到关键词，自动调起安全审查技能。
agents/：子代理
当任务足够复杂，Claude 可以“生出一个子代理”去处理。子代理有自己独立的系统提示、工具权限、模型偏好。干完活压缩结果返回，主会话不会被大量中间过程污染。
这三个层级，构成了一个完整的“AI 工作流生态”。
settings.json：谁在给 AI 递刀？
权限控制是整篇文章最容易被忽略、但最关键的部分。
settings.json 决定 Claude 能干什么、不能干什么。
allow 列表：直接放行，比如 Bash(npm run *)、Bash(git *)、文件读写操作。
deny 列表：彻底封死，比如 rm -rf、curl、任何 .env 和 secrets/ 目录。
中间地带：Claude 会问你确认。
这本质上是一个**“信任协议”**——你得想清楚，哪些权限给 AI，哪些永远握在自己手里。
评论炸了：有人喷配置是“过度工程”
热门评论才是这篇文章的“隐藏剧情”。
“People are spending way too much time over-prescribing these documents, but AI is like a competent but nervous adult. The more you give it, the dumber it gets.”
（人们花太多时间去“过度规定”这些文档了。但 AI 就像一个能力不错但容易紧张的成年人。你给它越多指示，它反而越笨。）
这条评论拿到最高赞。
还有人说：
“You should start with a fresh .claude, empty AGENTS.md, zero skills and MCP and learn to operate the thing first.”
（你应该从空白配置开始，先学会怎么操作这个工具。）
以及这句特别有意思：
“I keep seeing these posts, and here's the most interesting thing, for me. I get the best results with the least number of skills and unnecessary configuration in place.”
（我得到最好结果的时候，恰恰是配置最少的时候。）
这就很微妙了。
文章教你怎么配置、怎么优化、怎么把 .claude 打造成超级武器。但评论区一堆人告诉你：配置越多，AI 越废。
到底该信谁？
我的看法
个人判断：两边都不完全对。
完全不配置，Claude 就是个没头苍蝇。你每次都得手把手教它项目结构、编码规范、测试命令——累死你。
但配置成一本“巨著”，Claude 真的会“过载”。它不是真的“理解”你的规则，只是在做“指令匹配”。匹配越多，命中率越低。
最舒服的状态，可能是 20-50 行核心指令 + 几个高频命令 + 权限设置。
剩下的，让 Claude 自己推导。
它没那么笨。
结尾
.claude 文件夹，本质上是一个“协议”。
你告诉它你是谁、项目是干什么的、规则是什么。
协议越简洁，AI 执行力越强。
别把它写成百科全书。当成一张“便签”——越薄，越有用。
【MiniMax-M2.5锐评】：这篇文章最大的价值不是教你怎么配，而是提醒你：别把 AI 当傻子，也别把它当神仙。 适度配置，剩下交给信任。
参考链接：
https://blog.dailydoseofds.com/p/anatomy-of-the-claude-folder