Claude Code compact 怎么用？长会话压缩、上下文整理和接力技巧

Claude Code 用久了以后，很多人会遇到同一个问题：前面聊了很多需求、读了很多文件、跑了很多命令，后面模型开始忘记细节，或者把已经确认过的约束又问一遍。这时候就需要把长会话压缩成更清晰的上下文，让后续工作继续接得住。

compact 的核心价值不是“省一点 token”这么简单，而是把一次混杂的编程会话整理成下一阶段能执行的任务说明。用得好，它能保留目标、已完成事项、关键文件、未解决问题和验证结果；用得不好，就会把重要边界压掉，后面越改越偏。

什么时候该用 compact？

Claude Code 的长会话不一定越长越好。官方文档也提醒过，随着上下文变长，模型的召回和准确性会受影响。实际使用里，只要出现下面几种情况，就可以考虑 compact 或主动整理上下文。

• 读过很多文件：模型已经看过配置、路由、组件、测试、日志，窗口里堆了大量中间信息。
• 任务已经换阶段：从定位问题进入实现，或从实现进入测试、发布、写说明。
• 中间有多次试错：失败命令、废弃方案、临时假设很多，容易干扰后续判断。
• 你要隔天继续：不希望下一次重新解释项目背景和当前状态。
• 准备交给另一个会话：需要让新的 Claude Code 会话快速接手。

如果你还在比较工具和工作流，可以先看 AI编程工具专题 和 Claude专题。这两个专题能帮你把 Claude Code、Codex、Cursor 的适用边界放到同一个框架里看。

compact 前先做 5 件小事

很多 compact 失败，不是压缩功能不好，而是压缩前的信息太乱。建议在压缩前先让 Claude Code 做一次“工作台清理”。

1. 确认目标：一句话写清楚这次会话最终要完成什么。
2. 列出已完成：哪些文件已改、哪些命令已跑、哪些结论已经确认。
3. 标记废弃方案：哪些思路已经证明不可行，后面不要再重复尝试。
4. 记录风险点：未验证的假设、可能影响旧逻辑的地方、用户特别强调的限制。
5. 留下下一步：压缩后第一件事应该做什么，而不是只写一堆背景。

这一步和老达之前写的 AI编程上下文管理 是同一类问题：AI 编程不是把所有资料都塞进去，而是让模型一直知道“当前最重要的约束是什么”。

一段可直接用的 compact 前提示词

你可以在执行 compact 前，先发这样一段提示词，让会话自己整理成接力材料：

请先不要继续改代码，帮我整理当前会话上下文，准备压缩或接力。
请按以下结构输出：
1. 当前目标：一句话说明最终要完成什么。
2. 已完成事项：列出已读文件、已修改文件、已确认结论。
3. 关键约束：用户明确要求、项目规则、不能破坏的行为。
4. 废弃方案：已经尝试但不再采用的方案和原因。
5. 待办事项：按优先级列出下一步。
6. 验证状态：已经跑过的命令、结果、还没跑的检查。
7. 接力提示：给下一个会话的一段简短指令。

整理完以后再 compact，后续会话更容易抓住重点。尤其是处理跨文件修改、前端验收、测试失败、发布检查这类任务时，这个结构比零散聊天记录可靠得多。

compact 后第一句话怎么写？

压缩完成后，不要马上让模型继续大改。先让它复述当前状态，确认压缩没有丢关键限制。

请基于压缩后的上下文，先复述：
1. 你认为当前任务目标是什么；
2. 哪些文件/模块是关键范围；
3. 下一步你准备怎么做；
4. 哪些地方还需要验证。
先不要编辑文件，等我确认。

如果复述里少了关键约束，比如“不要改公共组件”“不要创建新标签”“正文不能写 h1”，就立刻补充。对于网站维护、WordPress 发布、项目规则这类任务，建议把稳定规则写进项目记忆文件，而不是只靠临时聊天。可以对照 Claude Code 项目记忆怎么写 一起使用。

compact 不适合解决所有上下文问题

compact 是整理会话，不是替你重新理解项目。下面几种情况，单靠压缩并不够：

• 需求本身变了：用户临时改方向，应该重新确认目标，而不是把旧上下文继续压进去。
• 代码已经被别人改过：需要重新读取相关文件和 git 状态，不能只相信压缩摘要。
• 验证结果过期：之前通过的测试，不代表当前改动后仍然通过。
• 会话里有错误假设：如果前面判断错了，压缩可能把错误结论变成“看似确定”的摘要。

所以，compact 后最重要的动作是“重新校准”，不是盲目续写。尤其在多人协作或自动化任务里，最好让 Claude Code 先读当前文件状态，再决定是否继续沿用摘要。

和 Plan Mode、状态栏一起用

Claude Code compact 更适合和另外两个习惯搭配：先用计划模式拆任务，再用状态栏观察当前会话消耗和任务进度。

比如一个前端改版任务，可以这样跑：

1. 用 Plan Mode 先拆出范围、文件、风险和验收步骤。
2. 开始实现，阶段性运行 lint、测试或页面检查。
3. 上下文变长后，先整理当前状态，再 compact。
4. compact 后复述任务，再继续测试、截图、写交付说明。

相关做法可以参考 Claude Code Plan Mode怎么用 和 Claude Code 状态栏怎么设置。这三件事放在一起，才能让长任务更像工程流程，而不是一条越聊越长的聊天记录。

老达建议：把 compact 当成“阶段交接”，不是清空聊天

我更建议把 compact 理解成阶段交接：上一阶段已经完成什么，下一阶段要做什么，中间有哪些风险不能忘。它不是为了让会话看起来更干净，而是为了让 Claude Code 在长任务里继续保持方向感。

普通用户最实用的做法是固定三件事：压缩前先整理、压缩后先复述、继续前先验证。只要坚持这三步，Claude Code 处理长会话、跨天任务和复杂项目时，稳定性会明显好很多。