Context Gauge（上下文计量条）
Claude Code 图块标题栏里的填充条，一眼看到该 Agent 的上下文窗口有多满。
Context Gauge 是 Claude Code 图块标题栏里的一根细填充条。它一眼回答一个问题：这个 Agent 离用完上下文还有多远？没有它，你往往是在 Agent 突然压缩或中途截断之后才知道出了事。
当 Agent 在跑一个长任务时留意这条。它从绿色爬到琥珀色再到红色时，你就知道该收尾本轮、开新会话，或把工作交给一个新 Agent，而不是等上下文压力逼出质量下降的结果。
你能用它做什么
- 一眼看到上下文窗口有多满 —— 图块标题栏里的填充条和百分比标签。
- 早发现问题 —— 70% 时变琥珀，90% 时变红，所以在 Agent 撞墙前你就知道。
- 悬停看精确数字 —— 提示框显示 token 数和模型的上下文窗口大小，例如
Context ~42% · 84k of 200k tokens (claude-opus-4-7)。 - 单独跟踪 Dynamic Workflows —— 某图块跑 Claude Code Dynamic Workflow 时，提示框额外加一个聚合的
workflow … tokens数字（子 Agent 仍在运行时带(active)标记），与主百分比分开跟踪，避免误判主会话有多满。
如何使用
- 生成或打开一个 Claude Code Agent 图块。计量条自动出现在标题栏——无需启用任何东西。
- Agent 工作时瞥一眼颜色：
范围 颜色 < 70% 绿色 70–89% 琥珀色 ≥ 90% 红色 - 悬停看精确 token 数和模型。
- 当计量条爬到琥珀或红色，决定是收尾当前轮、开新会话，还是把工作移到新 Agent。
计量条仅在检测到的 Agent 是 Claude Code 且确实检测到 Agent 时渲染。Codex、Amp、OpenCode 或裸 shell 不显示——那些 CLI 不像 Claude Code 那样暴露本地结构化 usage 块。
常见用例
- "这次长重构是不是快压缩了？" —— 留意计量条；变红就收尾本轮或开新会话，免得上下文压力让结果变差。
- "Agent 给下一条指令还剩多少余地？" —— 悬停看精确百分比和 token 数。
- "workflow 的子 Agent 消耗显示出来了吗？" —— 在跑 Dynamic Workflow 的图块上悬停；workflow token 数字与主百分比分开显示。
提示与最佳实践
- 把琥珀色当作"快收尾"，红色当作"现在就决定"。Agent 过了红色还会继续跑，但上下文压力上升时质量可能下降。
- 计量条在 MadoHub 窗口后台时暂停，切回前台时立即刷新，所以你看着它时读数总是当前的。
- 如果一次轮询瞬时失败（最常见是因为还没有会话文件），计量条会保留上次已知读数而不是清空——不必为一时缺失惊慌。
- Workflow 子 Agent 跑在各自上下文中，不是主会话窗口，所以它们的 token 用量单独跟踪，刻意不并入主百分比。
相关功能
- Fleet —— 在每行旁看到 workflow 进展（
workflow · 3/5 agents）和状态。 - Dynamic Workflows —— 提示框显示其子 Agent token 用量的 Claude Code 功能。
- MadoAgent —— 某图块快用完上下文时开一个新 Agent。
局限
- 仅限 Claude Code。计量条不渲染其他 Agent 类型或裸 shell。
- 百分比是基于最近一条 assistant 消息 usage 块的近似值，不是 OS 级实时计数。
- 未识别的模型字符串保守回退到 200,000 token 上下文窗口，所以全新模型的百分比在 MadoHub 的表更新前可能略有偏差。