对话跑到三十多轮,Claude 提示上下文窗口接近上限,自动压缩之后你让它接着写某个 Service 的单元测试,它却像第一次听说这个类一样,从头又创建了一遍。
CSDN 作者 Asama浅间 把上下文管理这条线拆开看,Claude Code 的上下文本质是一个固定容量的工作记忆。底层窗口 200K token,真正吃掉容量的往往不是对话文字,而是工具调用的输出,一次 Read 五百行文件就是几千 token,一次全库 Grep 又是几千,一轮下来轻松上万。(原文有删节)

这篇面向每天用 Claude Code 写业务代码的人:单次会话经常超过二十轮,或者正在做多文件协作的模块,每一步都能直接套用。偶尔问几个语法问题的话,上下文基本不会爆,看看思路就行。
压缩省了空间,也压掉了细节
/compact 的机制是让模型把之前的对话历史总结成一段摘要,用摘要替换原始记录。空间确实省下来了,但细节、决策理由、文件当前状态也一起被压掉。压缩之后它还能继续说话,却可能忘了你强调过的「分页必须用 OFFSET + FETCH」这种硬约束。
作者踩过的一个典型坑是,以为 /compact 是万能解药,结果压缩后 Claude 把已经改过的文件又改了一遍,覆盖掉了之前的修复。压缩解决的是窗口满了不能继续的表面问题,解决不了关键信息为什么会丢的根本问题。真正的解法是从源头把上下文的增长速度压下来,让它尽量不需要压缩。
把稳定约束放进 CLAUDE.md
CLAUDE.md 是每次会话自动加载的外脑,不占对话历史,也不会被 /compact 压缩掉。把稳定不变的约束放进去,等于给模型一份永久记忆。它分三层:项目级放仓库根目录,写技术栈和编码规范,以及目录结构;模块级放子模块目录下,只写这个模块特有的约定;任务进度不写进文件,用 TodoList 管,因为进度是动态的,写进文件反而要频繁改。
项目级的内容举例如下。基于 Spring Boot 3 的电商后台,Java 17;分页统一用 OFFSET + FETCH,禁止 ROW_NUMBER;密码用 bcrypt,轮次 12;SQL 全部参数化,禁止字符串拼接;异常统一抛 BizException,不裸抛 RuntimeException。
模块级只写这个模块特殊的约定。订单模块规定状态只能按 CREATED → PAID → SHIPPED → COMPLETED 走,禁止跨状态跳转;金额一律用 BigDecimal,不用 double;依赖 UserService 的 getUserById,不直接查 user 表。

压缩的时机,和压缩前必做三件事
不要等自动触发。自动压缩往往发生在你正写到关键处,压完模型状态断档最厉害。主动触发的时机有三个:一个完整子任务做完、准备切下一个的时候;一轮长调试结束、bug 已经修好、准备进新阶段的时候;对话超过二十轮、你感觉它开始重复确认的时候。
触发前必须做三件事,这三件决定了压完能不能恢复。让它把当前进度和已改文件清单更新进 CLAUDE.md 的「已完成」部分;确认 TodoList 是最新的;让它列出所有改动过的文件路径和一句话改动摘要。
对应的提示词可以直接这么写:「在压缩上下文之前,请做三件事:把当前已完成的功能和待办更新到根目录 CLAUDE.md 的进度章节,确认 TodoList 每一项的状态,列出本次会话所有修改过的文件路径,每个文件一句话说明改了什么。完成后再执行 /compact。」

让上下文别涨那么快
一是精确读文件。别说「看看 UserService.java」,先 Grep 定位目标方法所在行号,再只读那个行号范围前后各 15 行。同样的信息,全文读五百行约三千 token,精确读三十行约两百 token,差十五倍。
二是用子 Agent 拆分。把互不依赖的文件修改分派出去,每个子 Agent 有独立上下文,完成后只回传摘要。关键约束是「只返回改动摘要」,否则子 Agent 把完整文件塞回主上下文,等于没拆。
三是定期看 /context。每十轮执行一次,看哪一项在涨:对话历史涨得快,说明你在反复确认;工具调用结果涨得快,说明读文件太粗;文件读取涨得快,说明没做精确读取。
作者用同一个任务做过对照。给一个已有的 UserService 补三个方法(分页查询、批量禁用、导出 CSV),每个方法带单元测试。不做管理时,做到第二个方法上下文就到八万 token,第三个方法做完接近十二万;用上 CLAUDE.md、精确读和子 Agent 拆分之后,主上下文峰值约四万五千 token,不到一半。更关键的是质量,前者在第三个方法把分页参数写成了 page 和 size,而约定是 pageNum 和 pageSize,模型忘了;后者三次都守住了约定。
一分钟速查

常见问题
问:/compact 之后它把改过的文件又改一遍?
答:压缩会丢细节。触发前先更新 CLAUDE.md 和文件清单,压完让它复述关键约束再继续。
问:CLAUDE.md 会被一起压缩掉吗?
答:不会。它每次会话自动加载,不占对话历史,也不进 /compact 的摘要。
问:任务进度该写进 CLAUDE.md 吗?
答:进度是动态的,用 TodoList 管。CLAUDE.md 只放稳定不变的约束。
问:怎么知道上下文被什么吃掉了?
答:定期看 /context,按对话历史、工具调用结果、文件读取三类看哪一项在涨。
问:上下文已经爆了还能救吗?
答:让模型重新 Read 关键文件、复述约束,再继续;更稳的做法是平时就精确读、按子任务拆分。
来源与编译
本文转载自CSDN(Asama浅间) 《Claude Code 上下文管理实战:用 /compact 与 CLAUDE.md 把长会话压回可控范围》,原文链接:https://blog.csdn.net/weixin_35826166/article/details/168860337。版权归原作者所有,如需删除请联系我们。