Claude Code 上下文管理机制深度拆解：超长 Agent 任务如何不崩盘

在一个真正复杂的企业级软件设计与编码任务里，Coding Agent 面对的从来不是一句简单的“帮我写个小游戏”。它要理解用户的原始需求，要读取项目里的既有代码，要遵守架构约束、编码规范、接口协议，还要调用各种工具、加载不同的技能和规则，甚至记住用户十分钟前随口补充的限制条件：“这里需要重用已有的API接口。““这里不能修改现有的表结构。”代码任务越往后推进，上下文就越像滚雪球：需求文档、历史对话、源码片段、报错日志、工具 schema、执行结果、……每一样都重要，但每一样都在消耗上下文窗口（还有 Token）。于是，你很容易看到类似这样的提示：这其实是 Coding Agent 的一个核心矛盾：模型的上下文窗口再大，也不可能把整个项目、全部历史、所有工具和完整推理过程一股脑塞进去。真正决定一个 Coding Agent 能不能跑长任务的，不只是模型有多聪明，而是它有没有一套成熟的“上下文管理机制”；而对于其他企业级 Agent 也是一样。本文尝试一窥 Claude Code 上下文管理的一些关键机制，一方面能帮助我们更好地使用它；另一方面，也能为我们开发自己的复杂 Agent 提供重要参考。当然，它也是当下时髦的“Harness”的重要一环。