别等上下文烂掉才换会话:AI 编程的上下文管理实战
上下文窗口不是玄学,是一笔账:启动先装 7850 token,干活涨到 22225,压缩换成 1725 token 的摘要。本文按 Claude Code 官方文档讲 /context、/compact、/rewind、/clear、/autocompact 和子代理分流,附一张上下文账本和五个反模式。

先把这篇的边界说清楚。站里已经有几篇讲“让智能体记得住”的指南,但讲的都不是这篇的东西。《Agent 记忆指南》讲的是跨会话的记忆:会话内、跨会话、项目记忆怎么做。《AGENTS.md 实战》讲的是把规矩写进文件,让每个新会话一进来就读到。《并行开发工作流》讲的是一人指挥多个 Agent,怎么分工、怎么合流。这篇讲的是比它们都更底层、也更容易被忽略的一件事:一个会话进行当中,上下文窗口是怎么被一点点吃掉的,以及吃掉之后该怎么办。记忆解决的是“下次还记得”,这篇解决的是“这次别烂掉”。另外,站里有一条关于 Claude Code 空闲压缩的资讯,讲的是官方新功能本身;这篇是动手指南,讲你每天写代码时具体该敲什么命令、按什么顺序做。
下面用到的“钱袋子”是一个虚构的练手项目:一个人用 AI 帮着写的个人记账应用,能记账、能按月出报表。本文所有以它为例的操作、命令和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于 Claude Code 上下文窗口的规则、命令和默认值,都来自 Anthropic 的官方文档,来源见文末。其他编码工具也有自己的“换个新会话”和“压缩一下”的办法,思路相通,但命令名字和默认值不一样,本文只按 Claude Code 的官方文档写,照搬到别的工具之前先对一下它自己的文档。
上下文窗口里到底装了什么
上下文窗口就是模型一次能看到的全部文字,按 token 算。你在终端里跟 Claude Code 说的每一句话、它读过的每一个文件、它自己的每一段回复、每一次命令输出,全都塞在这个窗口里。窗口不是无限大的,满了之后 Claude Code 不会停下来等你,它会自动把对话压缩成摘要,腾出地方继续干活。压缩能救场,但摘要一定会丢东西——丢掉的可能正好是你最在乎的那条约定。所以第一步是先搞清楚,窗口里的东西都是从哪来的。
官方文档用一个示例会话算了一笔很实在的账。你还没打字,窗口里就已经装了不少东西:系统提示词约 4200 token,自动记忆约 680 token,环境信息约 280 token,MCP 工具名约 120 token,技能描述约 450 token,你个人目录下的 CLAUDE.md 约 320 token,项目根目录的 CLAUDE.md 约 1800 token。加起来约 7850 token,还没开始干活,就已经占掉了一个 20 万 token 窗口的将近二十分之一。这些是“启动成本”,每次新开会话都会重新装进来,躲不掉,只能控制大小。
真正的大头在干活的时候进来。还是那个示例会话:读四个文件花了 2400、1100、1800、1600 token,两条路径规则花了 380 和 290 token,一次搜索花了 600 token,模型自己的分析 800 token,两次改文件 400 和 600 token,两次钩子输出 120 和 100 token,一次跑测试的输出 1200 token,最后的改动总结 400 token。这一轮干下来,窗口从 7850 涨到了 22225 token。规律很明显:文件读得越多、命令输出越长,窗口涨得越快;你让它读的每一个大文件、贴的每一段长日志,都是实打实的 token。
所以别再把“上下文满了”当成玄学。它就是一笔账:启动时装进来的固定开销,加上干活时读文件、跑命令攒下的流水。账算清楚了,后面每一招才有依据。官方文档的示例会话还算了压缩之后的那笔账:压之前窗口里是 22225 token,压之后是 17095 token——省下来的 5130 token,代价是一份 1725 token 的摘要。压完之后窗口里的构成是:启动时装进来的 7850 token照单全收,1725 token 的对话摘要,重新读回来的 4 个文件 6900 token,再加一个 620 token 的技能正文。7850 加 1725 加 6900 再加 620,正好是 17095,账是平的。这组数字也说明了一件事:压缩不是把窗口清空,它是把两万多 token 的流水换成一千七百多 token 的摘要,省下来的部分,全看摘要写得好不好。

先看一眼:/context 是你的仪表盘
觉得会话开始变味了,先别急着动手,第一步是看一眼仪表盘。在提示词里敲 /context,Claude Code 会画一张彩色的用量网格,告诉你现在窗口用了多少,哪些东西最占地方,还会给出优化建议,包括哪些工具吃上下文、记忆文件是不是臃肿了、有没有容量警告。想改记忆文件里的内容,敲 /memory 就能打开编辑。
养成一个习惯:每个任务做到一半、感觉模型开始“有点不对劲”的时候,先 /context 看一眼,再决定是压缩、清掉还是继续。很多人是反过来的:先跟模型吵两轮,吵不出结果才想起来看窗口。那两轮争吵本身也在烧上下文,越吵越贵,越吵越糊涂。
还想继续这个任务:/compact,带着要求压
同一个任务还没做完,但对话已经很长了,这时候用 /compact。它会把到目前为止的对话换成一份结构化摘要,会话继续,只不过变短了。关键在“带着要求压”:直接敲 /compact,摘要留什么由自动流程猜;带上你的要求,摘要就留你指定的东西。官方文档的例子是这样的:
/compact focus on the auth bug fix and the list of failing tests
也就是说,压缩之前先想清楚,这个任务接下来最需要什么:是正在修的那个 bug 和还没通过的测试,还是已经改过的文件清单和跑测试的命令。把这句话写进压缩指令里,摘要就会优先留住它们。
还有一个更省事的办法:把这句话直接写进项目根目录的 CLAUDE.md,放在一个叫 # Compact instructions 的标题下面。每次压缩——不管是你手动压还是自动压——都会按这条指令来留东西。一劳永逸,适合那些每个任务都离不开的固定信息,比如“保留改过的文件清单和测试命令”。
压缩之后到底留下了什么,官方文档有一张很实在的表。系统提示词和输出风格继续生效;项目根目录的 CLAUDE.md 和无作用域规则从磁盘重新读进来;自动记忆从磁盘重新读进来;技能描述按你现在的技能重建后重新注入;如果会话开始时有 Git 状态快照,会重新读一份新鲜的;计划模式里写好的计划从磁盘重新注入;技能正文重新注入,但每个技能最多留 5000 token,总共最多 25000 token,超出的按最旧的先丢;后台命令和后台子代理继续跑,Claude Code 会提醒模型它们还在跑,别重复启动。
但也有几样东西是留不住的,或者说留得打了折。Claude Code 读过或改过的文件,压缩后最多重新读回 5 个,按最近修改时间排;超过 5000 token 的文件只回来一个路径引用,不带内容,显示成 Referenced file 而不是 Read。带 paths: 的路径规则和子目录里的 CLAUDE.md,平时是读到触发文件时才加载的,压缩时会连同对话一起被摘要掉;如果一条规则必须跨过压缩活下来,要么去掉它的 paths:,要么把它搬进项目根目录的 CLAUDE.md。技能正文也一样,大技能会被截断,只留开头——所以最重要的指令要放在 SKILL.md 的最前面。
还有一条容易踩的坑:只在对话里随口说过的规则,压缩后很可能就没了。官方文档说得很直接:如果一条指令在压缩后消失了,那它就是“只在对话里给过”。重要的规矩别只留在聊天记录里,写进 CLAUDE.md 才算数。
用“钱袋子”走一遍就明白了。你让 Claude Code 给记账应用加“按月出报表”,它读了四个文件、跑了两次测试,对话已经两万多 token。你敲 /compact focus on the monthly report feature and the failing tests,摘要会留住“在做月报表”和“哪些测试还没过”,丢掉的是中间那些来回试错的命令输出。接下来你接着说“继续修测试”,它不用再读一遍文件就能接上。
只想压一半:/rewind
有时候问题不是整段对话都长,而是中间有一段走偏了:你让它试了三个方案,前两个是死胡同,第三个才走通。这时候整段压缩有点浪费,/rewind 更合适。按两次 Esc(空提示词时),或者直接敲 /rewind,选一条你发过的消息,再选一个动作:Summarize from here 是把这条消息之后的内容压成摘要,Summarize up to here 是把这条消息之前的内容压成摘要。走偏的那段被压掉,走通的那段原样留着。
这招最适合“试错”场景。模型在一个方向上越走越远,你已经看出来这条路不通,但对话里全是这条路上的尝试。倒回去、压掉那一段,等于把黑板上走偏的那半边擦掉,留下的半边还是干净的。比整段压缩省,也比直接清空温柔。
换任务就清掉:/clear,不要舍不得
任务做完了,或者要换一件完全不相干的事,敲 /clear。它会清空整个上下文,开一个全新的空会话。项目记忆(CLAUDE.md)还在,对话没了。官方文档的建议很明确:切换到不相关的任务时就清掉,旧对话会挤占下一个任务需要的文件,还会在每条消息上都花 token。
这里有一个成本上的区别,值得记下来。官方的成本文档写得很直白:/compact 要读一遍它正在压缩的对话,所以压缩一个很大的上下文本身就是一次很大的请求;而当你想要的是全新开始而不是接着做,/clear 不花钱。也就是说,压缩是花钱买连续性,清掉是免费换干净。任务已经换了,还留着旧对话不舍得压,是最亏的做法:既占窗口,又烧 token,还拖累新任务的质量。
还有一个判断信号:同一件事你已经纠正了模型两次,它还在犯同一个错。别继续纠正了,清掉重开。错的那段对话已经把模型带偏了,留在窗口里只会让它继续沿着错的方向解释。重开一个干净的会话,把任务说清楚,往往比第三次纠正更快。嫌重开后找不回旧会话?先给会话起个名字再清:/rename login-fix-try-1,以后用 --resume 还能找回来。会话记录一直存在本地,清掉的只是当前窗口,不是历史。
自动压缩的刻度:/autocompact
你不手动压,Claude Code 也会在你接近上限时自己压。自动压缩和手动 /compact 是同一个动作:先清掉旧的工具输出,实在不够再把对话写成摘要。所以即使你什么都不管,会话也不会因为窗口满了就断掉——它会自己腾地方。问题是,自动压的时机和摘要里留什么,都是它猜的。
想自己定这个时机,用 /autocompact 加一个 token 数,比如 /autocompact 500k,就是告诉它:窗口用到 50 万 token 就开始自动压。这个设置按模型保存,不同模型可以设不同的值。官方文档还给了另一个选择:如果你用的模型支持 100 万 token 的上下文——Fable 系列、Sonnet 5 及更新的版本、Haiku 5.5、Opus 4.6 及更新的版本、Sonnet 4.6——窗口本身就大一倍,压缩点也相应往后推。窗口大不是不用管的理由,只是给你多留了一点犯错的空间;100 万 token 的会话一样会烂,只是烂得晚一点。
另外还有一种省心的压缩:人走开之前手动压一次。官方成本文档里的用量建议就有一条是“离开前先压缩”。你去吃饭、去开会,回来接着干,压过的会话比晾了一下午的长对话干净得多,回来第一句就能接上,不用先花几轮把模型从走神里拉回来。顺带一提,成本文档里还提醒过:会话回顾和空闲压缩会在你不在的时候也花 token。也就是说,把一个很长的会话晾在那不管,它可能在你不在的时候自己压一轮,账单上多一笔你没盯着的开销。离开之前顺手压一次,既干净,也省了这笔糊涂账。
窗口不够大,就换个更大的?
有人会问:既然窗口总是不够用,为什么不直接换个 100 万 token 的大窗口?官方文档的答案是:可以,但要分清它解决什么问题。支持 100 万 token 上下文的模型,窗口本身就大一倍,自动压缩的点也往后推,同样的活能撑更久。但窗口大只推迟了问题,没有取消问题:100 万 token 的会话一样会满,一样要压缩,压缩的时候一样会丢东西。更大的窗口适合那种“一个任务本身就很大”的场景——比如第一次接手一个陌生代码库,要读几十个文件才能摸清结构;而不适合拿来当“一个会话干五件事”的借口。任务分得清,20 万窗口也够用;任务混在一起,100 万窗口也一样烂。先分任务,再考虑换大窗口,这个顺序别反了。
把大活推给子代理,别自己扛
有些活天生就费上下文:让模型先把整个代码库翻一遍、把十几个文件都读了、再回来给你结论。如果你让主会话自己去读,这十几个文件就全进了你的窗口。正确的做法是派一个子代理去干:子代理有自己的上下文窗口,大文件都在它自己的窗口里读,最后只把一份摘要和一小段元数据带回来。
官方文档的示例会话里就有这个数:子代理在自己的窗口里用了 9890 token,回来只带了 420 token 的摘要。主会话省下来的不只是那九千多 token,更重要的是主窗口里没有被一堆“读了一遍但用不上”的文件塞满。调研、找代码、翻文档、做对比,这类“先看很多、最后只要结论”的活,都适合推给子代理。
反过来也一样:别在主会话里随手贴大段日志、随手让它读整个目录。贴之前先问一句:这段东西我真的需要它一直留在窗口里吗?如果只是要一个结论,派子代理;如果只是要确认一行报错,贴那一行就够了。
日常习惯:一页纸的纪律
命令都好学,难的是习惯。下面这几条是每天写代码时就能照着做的:
第一,一个会话只做一件事。修登录 bug 的会话,就只修登录 bug;做完清掉,再开新会话做月报表。任务一多,会话就长,会话一长,压缩就丢东西。会话是按任务分的,不是按天分的。
第二,规则写进文件,别只写在对话里。CLAUDE.md 是每次压缩后都会从磁盘重新读进来的,对话不是。重要的约定、项目的结构、测试命令,放在项目根目录的 CLAUDE.md 里;只在某个目录下生效的规则,放在那个目录的 CLAUDE.md 里,但要记住它在压缩后需要重新触发。
第三,CLAUDE.md 本身要瘦。启动时它每次都要装进窗口,写得越长,每个会话的固定开销越大。官方的用量建议里就有这么一条:有个例子是某个 CLAUDE.md 每个请求占 49000 token。写 CLAUDE.md 的时候,删掉那些“写给人看的客套话”,只留模型干活真正需要的指令和事实。
第四,别贴整段日志,别让它读整个目录。报错贴关键的几行,读文件一次读一个,目录先用搜索定位再读目标文件。示例会话里光是读文件和跑测试就占了一万多 token,贴日志只会让这个数更大。
第五,定期看一眼 /context 和 /usage。前者看窗口还剩多少,后者看这个会话已经花了多少。花得多不一定是坏事,但花得多又没进展,就是该停下来想想的信号。
五个反模式
反模式一:一个会话从早用到晚。早上修 bug,中午加功能,下午改样式,晚上又回头改 bug。窗口里混着三件不相干的事,压缩的时候摘要也不知道该留哪件。正确做法是一件事一个会话,做完 /clear。
反模式二:跟模型吵架。同一件事纠正两次还没改对,继续纠正第三次、第四次。每一轮争吵都在烧上下文,模型也越吵越糊涂。纠正两次就停,清掉重开,把任务说得更清楚。
反模式三:压缩不带要求。直接敲 /compact,让自动流程猜什么重要。猜错了,摘要里留的是过程、丢的是结论。压缩前花十秒想一句“留住什么”,或者把这句话写进 CLAUDE.md 的 # Compact instructions 里。
反模式四:重要的约定只说在对话里。“这次先别动数据库结构”这种话,只在聊天记录里说一遍,压缩后就没了。约定要写进 CLAUDE.md,写进文件才算数。
反模式五:什么都往主会话里塞。调研、翻代码、读日志,全在主会话里干,窗口很快就满了。大活派子代理,主会话只留结论和下一步。
检查表:下次开工前过一遍
开工前:CLAUDE.md 是不是瘦的?今天的任务是不是一件?要不要先给会话起个名字,方便以后 --resume 找回来?
干活中:感觉模型开始走神,先 /context 看一眼;要调研、要翻很多文件,派子代理;报错只贴关键几行。
任务快做完:带着要求 /compact,或者 /rewind 压掉走偏的那段;换任务之前 /clear,别留着旧对话进新任务。
人要走开:离开前手动压一次,回来直接接着干。
上下文管理不是什么高深技巧,它就是一笔账加几条纪律。账算明白了,窗口就不会莫名其妙满;纪律守住了,模型就不会莫名其妙变笨。写代码的时候,顺手把这几条做下来,一个会话能顶过去三四个。最值得先养成的是其中两个:一个会话只做一件事,换任务就清掉;压缩的时候带一句“留住什么”,别让自动流程替你猜。这两条做到了,剩下的几条都是顺手的事。等你习惯了这套打法,会发现模型“变笨”的次数少了很多——很多时候不是模型变笨了,是窗口里塞的东西太多,它已经看不清你到底要什么了。
评论 (0)
原始来源
相关文章
网页每天都在做决定:满一百就打折、库存是零就显示售罄。本文按 MDN 的《Making decisions in your code — conditionals》《if...else》《switch》三篇官方文档讲清楚:if 与 else if、比较运算符、真值与假值、逻辑运算符、|| 的经典写错法、嵌套 if 与悬空 else、switch 与穿透、三元运算符与卫语句。
2026 年 11 月 17 日,GitHub 在微软 Ignite 当天为 Copilot 打包升级:浏览器操作进入公开预览,可在已登录的 Chrome 或 Edge 里填表单、调 Web 应用;Copilot 应用接进 Azure DevOps 仓库,智能体可提 PR 甚至代为合并;代码评审新增自适应档位与秘密检测。2 项正式发布、6 项公开预览。
主线程又要画页面又要算账,一算就卡。Worker 是另一条线程、另一个全局上下文,两边只靠消息传话。本文按 MDN 的《Using Web Workers》与《Worker》两篇官方文档讲清楚:new Worker、postMessage 与 onmessage、结构化克隆的复制语义、Worker 里能与不能、onerror 与 terminate()、SharedWorker、Transferable 零拷贝,另附虚构咖啡馆点单页一个月 100 次 Worker 翻车的分布。