如何避免你的 AI 编码智能体的上下文窗口被填满

每一个 AI 编码智能体都在一个上下文窗口内工作——即它能一次"看到"的有限文本量：你的消息、它的回复、它读取的文件、它运行的命令输出。当这个窗口被填满时，质量会以某些令人费解的方式下降。智能体会忘记你二十分钟前作出的决定，重新读取一个它已经编辑过的文件，或者悄无声息地自相矛盾。在任何超过几分钟的任务上，管理上下文都是你对输出质量掌握的最大杠杆。以下是如何有意识地做到这一点。

为什么填满的窗口有害

当窗口变得拥挤时，模型并不会优雅地降级。会发生两件事。第一，较早的消息会被推向边缘，模型在那里对它们的关注不那么可靠——这就是经典的"迷失在中间"（lost in the middle）问题。第二，大多数智能体在空间不足时会自动进行摘要，而在压力下自动生成的摘要是有损的：它可能会丢掉你所在意的那个确切约束。解决办法是让自己掌控智能体所持有的内容，而不是任由它填满并即兴发挥。

留意窗口有多满

你无法管理看不见的东西。在 Claude Code 中，运行 /context 可以将当前用量以百分比形式打印出来。业内从业者的一条好经验法则是：在复杂任务上，当利用率达到约 60% 时就采取行动——远在触发自动压缩的 ~80% 之前。Cursor 和 Codex 在它们的界面中也呈现了类似的指示器。时不时瞥一眼这个数字，就能把上下文管理从一种模糊的担忧变成一个具体的信号。

在检查点处压缩——不要一路埋头往前

当你到达一个自然的检查点时（某个功能可用、测试通过、某个 bug 被修复），压缩历史记录，而不是任由它膨胀。在 Claude Code 中，/compact 会用模型生成的摘要替换完整的对话记录——一段 70,000 token 的对话可以降到大约 4,000 token。关键在于，你可以引导哪些内容得以保留：

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

主动地压缩——趁着还有余量时——会比在最后一刻触发的自动压缩产生更好的摘要，因为模型在撰写摘要时仍然对整段对话有清晰的记忆。

切换任务时清空

/compact 用于延续同一条工作线索。/clear 用于放弃它。当你转向某件无关的事情时——你完成了一个后端修复，转去做一个前端功能——就重新开始。把旧的上下文带过去毫无帮助；它只会浪费 token，并且有让智能体把当前任务错误匹配到上一个任务的风险。当上下文被"毒化"时，清空也是解药：模型已经锁定了一个错误的假设，无论你如何纠正，它都不断退回到这个假设。

把稳定的知识放进文件，而不是放进对话

如果你发现自己在反复解释同样的东西——你的测试命令、你的命名约定、API 所在的目录——那些信息根本就不该待在对话里。把它放进一个智能体会自动读取的项目文件中：Claude Code 用 CLAUDE.md，Codex 和其他工具用 AGENTS.md，Cursor 用 .cursorrules。它在每次会话开始时加载，因此从第一条消息起智能体就拥有它，并且它能挺过每一次 /clear 和 /compact。不过要保持精简——它在每一次请求上都消耗 token，所以一个臃肿的 CLAUDE.md 本身就是一种上下文浪费。

给智能体更少，而不是更多

那种"把十个文件都倒给它，好让它掌握一切"的本能会适得其反。你粘贴或用 @ 提及的每个文件都会消耗预算，并稀释模型的注意力。**一个精心挑选的文件通常胜过十个文件。**从最少开始，只在智能体确实需要时才添加上下文。如果你不确定哪个文件重要，先让智能体去找它，而不是预先加载整个目录。

把杂乱的探索交给子智能体

有些任务天生就很啰嗦——"在代码库中搜索所有调用支付 API 的地方。"如果你在主会话里运行它，搜索的原始输出会淹没你的窗口。相反，把它委托给一个子智能体（Claude Code 的 Task 工具，或者一个独立的 Cursor 智能体）。子智能体在它自己隔离的窗口里完成这些嘈杂的探索，然后只交回结论——那三个重要的文件——从而保持你的主上下文干净整洁。

一套行之有效的节奏

综合起来，一段健康的长会话看起来是这样的：

1. 以一份简洁的 CLAUDE.md 开始，让智能体了解你的项目。
2. 把每个任务的范围划得窄一些；只引用它会触及的文件。
3. 每隔 30–45 分钟或每完成一个里程碑后，瞥一眼 /context。
4. 在每个检查点用自定义指令执行 /compact。
5. 一旦切换到无关的工作，立刻 /clear。

这些都不玄乎。它决定了一个智能体是能在两小时的会话中始终保持敏锐，还是开局强劲却慢慢地失去头绪——而它所花费的，只是你几秒钟的注意力，而不是一个为它的困惑而神秘消耗的下午调试。