Claude Code 会话压缩全流程概览

源码基线：Claude Code 2.1.88​
文档定位：介绍会话压缩的关键流程与四种策略之间的关系​
阅读方式：先读本文建立整体认知，再进入对应专题查看算法、Prompt 和源码细节​

Claude Code 的会话压缩不是一个单独函数，而是一条分层的上下文管理流水线。它会先尝试成本较低、损失较小的处理；上下文继续增长时再生成或复用摘要；如果客户端预判仍然失手，服务端已经拒绝请求，最后由 Reactive Compact 尝试恢复。​

四篇专题文档：

•
Microcompact：工具结果如何被轻量清理​

•
SM-Compact：Session Memory 如何提取、保存并参与压缩​

•
传统 Compact：LLM 如何生成会话摘要​

•
Reactive Compact：API 拒绝后的响应式恢复​

1. 先建立一个核心认知

会话上下文不只是用户和 Claude 的聊天文字，还包括：

•
system prompt、CLAUDE.md 和运行环境信息；​

•
assistant 的分析、回复和工具调用；​

•
Read、Bash、Grep 等工具返回的大段结果；​

•
图片、PDF、Skill、hook 结果和其他附件；​

•
之前压缩产生的摘要与 compact boundary。​

因此，“压缩会话”更准确的含义是：

重新组织下一次模型请求看到的上下文，在尽量保留任务状态的同时减少 token 占用。​

Claude Code 通常不会删除磁盘上的整段会话记录。压缩主要改变当前活跃消息和下一次 API 请求的输入；持久化记录仍可以保存更完整的历史以及压缩边界。​

2. 四种压缩策略分别解决什么问题

它们不是四个互斥开关，而是按照不同成本和不同触发证据组成的一组接力机制。​

3. 自动会话压缩的关键流程

下面这张图省略了实验开关、精确阈值和重试次数，只保留主流程：​

画板

这条流程可以概括为六步：

1.
确定活跃会话段：从最近一次 compact boundary 之后开始构造本轮上下文。​

2.
先做低成本清理：优先处理旧工具结果等高占用内容，尽量不改写任务叙事。​

3.
检查主动压缩阈值：客户端根据当前用量、估算值和模型窗口判断是否需要 Auto-Compact。​

4.
Auto-Compact 先 SM、后传统摘要：Memory 可用就复用，否则调用 LLM 重新生成摘要。​

5.
压缩成功后重进查询循环：不是在原地裸重发，而是重新执行投影、预算和各层检查。​

6.
真实请求仍溢出时 Reactive 兜底：根据服务端返回的可恢复错误进行响应式恢复。​

Context Collapse 是这条流水线中的相邻辅助机制，但不属于本文讨论的四种压缩策略。总文档只展示它在主流程中的位置，不展开其内部算法。​

4. Microcompact：先处理旧的原始材料

工具结果往往是上下文增长最快的部分。例如一次构建可能返回几千行日志，但 Claude 后续真正需要的只有：​

代码块

构建失败：认证模块第 81 行存在类型不匹配

Microcompact 的目标是让已经被读取和消化的旧工具原始输出退出活跃上下文，同时尽量保留：​

•
用户的目标与约束；​

•
Claude 已经形成的结论；​

•
最近仍可能使用的工具结果；​

•
工具调用与返回结果的配对关系。​

Microcompact 既可能发生在客户端的消息预处理阶段，也可能由请求侧能力完成。不同运行环境和功能开关下，实际启用的方式可能不同。​

总流程中只需要记住：Microcompact 是低成本的第一道减负手段；如果减负后仍然太大，后面的 Auto-Compact 才会接管。​

详细算法、当前开关状态和实例见 Microcompact 专题。

5. Auto-Compact：固定先尝试 SM，再尝试传统摘要

Claude Code 会话压缩全流程概览​