CLAUDE.md 写得太长,会让 Claude Code 的每个会话都更费额度。Anthropic 官方文档给的建议是每个 CLAUDE.md 控制在 200 行以内:这个文件在会话一开始就整份读进上下文,之后你发的每条消息都带着它,做的事和它无关也一样。
长文件是怎么花钱的
CLAUDE.md 是写给 Claude Code 的项目说明,比如怎么构建,代码按什么规范写。官方文档对它的说法有三点:
- 每个会话都加载。写了 PR 审查流程、数据库迁移步骤这类大段内容,哪怕你今天只是改个错别字,这些 token 也在上下文里。
- 文件越长,Claude 越不容易照做。官方原话的意思是长文件占更多上下文,遵守程度还会下降。
- 用
@导入别的文件不省钱。导入只是方便整理,内容照样全部进上下文。
有使用者反馈,自己项目里几个指令文件太"肥",每次启动额度都掉一截。这是个人反馈,具体掉多少暂时没核实;/usage 可以替你量出来:订阅用户运行它,会看到占最近用量 10% 以上的原因,官方文档里举的例子就有一行"精简某个 CLAUDE.md,每次请求 49k token"。
搬到哪里去
| 内容 | 放哪 | 什么时候才加载 |
|---|---|---|
| 每次都要知道的事实:构建命令、规范、目录结构 | CLAUDE.md | 每个会话 |
| 某个流程的详细步骤 | Skill | 用到时才加载 |
| 只和某类文件有关的规则 | .claude/rules/ 里带路径范围的规则 |
碰到匹配的文件时 |
让 AI Agent 帮你瘦身
把下面这段发给你的 AI Agent:
帮我给这个项目的指令文件瘦身,先出方案,不要直接改:
1. 统计 CLAUDE.md、CLAUDE.local.md、AGENTS.md 和 .claude/rules/ 下每个文件的行数。
2. 把内容分成三类:每个会话都需要的事实;某个流程的详细步骤;只和某个目录或某类文件有关的规则。
3. 第二类建议搬成 Skill,第三类建议搬成带路径范围的规则,各给出新文件名和内容草稿。
4. 找出互相矛盾或已经过时的条目,单独列出来。
5. 给我一张"搬走前后各多少行"的对比表,等我确认后再动手。
官方还提供了一个现成的检查:/doctor prompt-audit 会扫一遍这些指令文件,找出矛盾和过时的内容。
注意
- 会话中途改 CLAUDE.md 不会马上生效,要等下一次
/clear或/compact,或者重启。 - 子目录里的 CLAUDE.md 和团队成员的文件也会被读到,大仓库里可以用
claudeMdExcludes排除不相干的。 - 自动记忆(auto memory)每个会话只加载前 200 行或 25KB,不用为它操心。
官方说明见 Claude 如何记住你的项目 和 管理成本。群里的讨论见 这一期群聊报告。


评论(0)
还没有评论,来说第一句。