嘉宾观点 / T SALON

编辑内容

如何用固定预算跑通长链路 Agent 重构而不触发 5 小时限流:Claude Code 与 Codex 实战手册

面向使用 $20 Pro 或 $100/$200 Max 订阅的一线工程师,拆解多文件重构中最容易吃空 5 小时滑动窗口的 3 类上下文黑洞,并给出分阶段 Checkpoint、子任务隔离与周度配额排期方案。

长链路 Agent 重构防 5 小时限流与预算控制实战手册
长链路 Agent 重构防 5 小时限流与预算控制实战手册

TL;DR

  • 跨 20+ 文件的长链路重构之所以在 90 分钟内吃满 5 小时配额,核心原因不是模型生成的代码太多,而是单会话上下文膨胀到 120K+ 后每轮工具调用都在全量重放历史。
  • 将一次大型重构拆成「只读清单生成 → 分批编辑(每批 ≤5 个文件)→ 独立验证」三个短会话,可将总 Token 消耗降低 55%–70%。
  • 建议在每日首个请求发出时记录窗口起点,并用 T Salon 5 小时窗口计算器与周限额规划器锁死单日安全消耗上限(约 14%/天)。

几乎所有重度使用 Claude Code 或 Codex 做架构级重构的工程师,都遭遇过“重构改到一半、代码还编不过,5 小时限额却突然见底”的窘境。 很多人以为是自己的项目太大、固定月费订阅不够用;但对照 T Salon 真实消耗基准报告 的遥测数据会发现,超过 65% 的配额浪费来自单次会话过长引发的“上下文复利膨胀”。

本文给出经过实战验证的长链路重构配额控制法,帮你在固定预算下稳稳跑完跨模块大重构。

一、长链路重构吃空 5 小时窗口的 3 个黑洞

  1. 全量文件扫描与巨型会话堆积:让 Agent 在同一个会话里既做全仓检索、又改 20 个文件、再跑全量测试。当上下文突破 100K Token 后,哪怕只让它改一行变量名,底层也会把前 100K Token 重新处理一遍。
  2. 未截断的终端日志灌入:测试或编译失败时,几千行 Webpack/Vite/TypeScript 报错输出直接进入对话历史,并在此后每一轮对话中被反复重发。
  3. 跨越缓存 TTL 的断续操作:聊了 80K 上下文后离开座位半小时,回来继续在同一会话追问——此时前缀缓存已过期,整段 80K 历史会按高成本的新输入重新计入窗口配额。

二、三段式 Checkpoint 拆解法(省 60% 配额)

不要试图用一个 Prompt 让 Agent 跑完整个重构,而是以本地文件(如 REFACTOR_PLAN.md)为状态媒介,拆成三个独立短会话:

阶段 会话职责 目标上下文上限 完成后动作
阶段 1:只读盘点 扫描受影响文件,把待改文件清单与接口契约写入 REFACTOR_PLAN.md ≤ 35K Tokens 立即关闭会话
阶段 2:分批实施 每次新开会话只读取 REFACTOR_PLAN.md 并修改 3–5 个文件,勾选进度 ≤ 45K Tokens 每完一批执行 /clear 或新开会话
阶段 3:定点验证 仅针对失败的单测或类型检查运行修复,用 tail -n 40 限制日志长度 ≤ 40K Tokens 全部通过后删除临时计划文件

通过把状态固化到磁盘上的 Markdown 清单而非留在聊天窗口里,每一批修改的输入 Token 都保持在线性水平,彻底切断指数级膨胀。

三、结合 5 小时窗口与周限额做排期

在启动大型重构前,建议花 30 秒做一次配额排期:

  • 锁定 5 小时滑动窗口起点:发出当天第一条指令时,在 Claude 5 小时滑动窗口计算器 中记下起点。比如 09:00 发首条消息,14:00 就会迎来第一轮窗口重置;把最耗额度的核心批次安排在 09:00–13:30,14:00 后即可满血进入验证阶段。
  • 控制周度日均水位:在 WhenReset 每周额度规划器 中输入当前已用百分比。7 天周期的理想日均预算约为 14.2%/天;如果周三已消耗超过 55%,应立即将重构切换为小批次模式或结合 AI 成本计算器 评估按量 API 兜底成本。
  • 遇到突发报错速查:若途中弹出 You've reached your limit 或 Context window is full,可直接查阅 AI 编程限流与报错速查库 获取一行命令级的恢复方案。

常见问题(FAQ)

为什么同样改 15 个文件,分 3 个会话跑比在 1 个会话里跑省一半以上额度?
在单会话中,第 15 个文件的修改会携带前 14 个文件的完整 diff 和终端报错日志作为输入上下文;拆成 3 个独立会话并把进度写入本地 Markdown 任务单后,每个会话只需加载当前批次文件。
跑自动化测试报错时,怎么防止 Agent 陷入死循环把额度烧光?
只把失败用例的最后 30 行堆栈粘贴或传给 Agent,禁止直接把数千行完整构建日志原样灌入对话;连续 2 次未修好同一报错时立即手动介入或 `/compact`。
遇到 5 小时限流锁死但重构只剩收尾工作怎么办?
先用 T Salon 5 小时窗口计算器按本轮第一条消息推算准确恢复时间;若急需收尾,可基于本地任务清单无缝切换到备用工具(如 Codex CLI 或 API 按量模式)继续最后一步。
⚡ T SALON 开发者工具箱