什么值得买App下载 App ›
连续签到专享现金活动

500行砍到150行后,Claude Code瞬间听话了

CLAUDE.md 写得越多,Claude Code 反而越不听话。官方明确建议控制在 200 行以内,超过这个长度,上下文消耗会大幅增加,指令遵循率反而下降。这不是危言耸听——有团队把 500 行的配置文件精简到 150 行,执行效果立竿见影。问题的根源在于:CLAUDE.md 的每一行都在占用 Claude 的上下文窗口,塞进去的冗余内容会稀释真正重要的指令。1
删掉 Claude 能自己推断的内容
很多人把 CLAUDE.md 当成项目百科来写,把 README 全文、项目架构图、技术栈说明全塞进去。问题在于,这些 Claude 扫描一遍代码就能自己推导出来。留着它们,每次对话都要多加载几百 token,纯属浪费。/doctor 命令的新检查项就能识别这类冗余内容,并给出裁剪建议。2
真正值得写进去的只有三类:Claude 不知道的项目事实(比如你们用 pnpm 而不是 npm)、与常规做法不同的非直观规则(比如你们不用 console.log 而是用特定日志库)、踩过的坑(比如某库在 TypeScript strict 模式下的类型 bug)。
把流程拆出去,别堆在主文件里
CLAUDE.md 不是唯一的配置文件,它只是 Claude Code 配置体系的一部分。部署流程、代码审查清单、发布步骤这些流程性的内容,应该封装成 Skills;需要跨目录统一的约束,用 .claude/rules/ 下的规则文件,配合 paths 前置声明限定作用范围。3
有个 8 人团队把 500 行 CLAUDE.md 精简到 150 行的做法值得参考:把仿真引擎的详细流程、质量控制参数这类领域相关内容拆分到 .claude/rules/simulation.md,用 paths: 声明只在编辑 app/lib/simulation/** 时加载。CLAUDE.md 缩减了 61%,信息总量却没变。4
文件层级用对地方
  • ~/.claude/CLAUDE.md
    个人偏好,所有项目通用,换电脑还能用
  • ./CLAUDE.md
    项目级,提交到 Git,团队共享
  • ./CLAUDE.local.md
    本地个人偏好,加 .gitignore,不提交
判断标准很简单:这条信息换项目还成立吗?成立就放全局,不成立就放项目。只有你自己用的,放本地配置。
一个判断原则,适用所有配置决策
写任何配置之前先问自己:这条信息 Claude 能从代码库自己推断出来吗?会影响所有任务还是只有特定模块?如果是 Claude 本身就知道的最佳实践、或者只有改某个模块才用得上的细节,就别往 CLAUDE.md 里塞。
CLAUDE.md 精简到位后,Claude Code 的响应速度和指令准确度会有明显提升。工具调用结果才是消耗 token 的大头,优化主配置文件只是减少基础上下文的浪费,任务复杂度的控制同样关键。5

评论

评论区空态插画

当前文章无评论,是时候发表评论了