BK 云 / 系统 首页
ZH
English ENDeutsch DEEspañol ES中文 ZHFrançais FRPortuguês (Brasil) PT-BR日本語 JAहिन्दी HINederlands NL
联系我 ↗
← 返回技术笔记

一行状态,让思路更清楚

编程代理工作时,终端往往很热闹:命令接连出现,文件不断修改,消息也一直在更新。但我最想知道的,可能只是几件小事:当前会话用了哪个模型?上下文还剩多少?这是不是我正在关注的那个会话?到现在大概花了多少钱?

转动的图标,回答不了这些问题

之前的 ETA 文章关注时间安排:继续等、换个任务,还是稍后再回来?状态行讨论的是另一个相关问题——决定下一步之前,先看清眼前这个会话。

转动的图标能说明代理还在运行,长长的记录也能告诉我做过什么。但要快速掌握当前情况,仍然可能需要到处翻找。

一行里,哪些信息最有用

终端截图让这个想法更直观:所选路由、实际使用的模型、上下文占用和费用估算,都放在一行里。项目路径和账户标识已换成中性示例。

使用中性示例标识的终端状态栏,显示模型路由、上下文占用和费用估算。
经编辑的截图:项目路径和账户行使用中性示例(/path/to/project 和 example-account)。数值仅代表这一配置在截图时的状态,并非实时数据。

路由选项与最终模型并不是一回事。截图中,请求经 OpenRouter 路由到 OpenAI 模型。这是额外配置,并非 Claude Code 默认界面的样子。

上下文显示为 186,551 / 1,000,000 个 token,对应画面中的 19.0%。数字更容易理解,但上下文占用 19% 不代表任务完成 19%,也不能据此推算还需要几分钟。

费用字段可能是估算,也可能是供应商侧的计数,首先要看清它们各自的含义。状态行中的数字不是经过核实的账单。截图里的预测和自动模式,也属于该配置的其他信号,并不是本文最小显示程序的功能。

费用控制也应该放在这一行里

能随时看到费用,是我想加入状态行的重要原因。代理可以一直在忙,而我未必意识到已经尝试、重试或并行运行了多少次。我希望在账单出来前,就能留意支出的变化。

截图里的“est. $6.61”和“OR today $9.31”标签不同,不能直接作为两笔独立费用相加。使用前应弄清统计范围、参考价格和更新方式。估算可以帮助决定下一步,实际扣费仍以供应商用量记录为准。

  • 开始前设置费用检查点。 先决定何时暂停并评估后续运行。
  • 比较费用增长与有用结果。 如果费用不断增加,同一项测试却反复失败,我会先缩小范围、找出阻碍,再决定是否继续大范围尝试。
  • 有意识地选择下一步。 更小的后续任务、适合的模型或人工检查可能已经足够。更换模型后仍需执行相同的质量检查。

看得见费用,不等于设好了自动预算上限,更不意味着它会自行停止请求。API 用量、订阅费用和供应商余额也要分开理解。目的只是让成本与时间、技术质量一起,进入每次工作决策。

数字应该帮助人作决定

上下文占用升高时,我会问自己:下一步是否已经说清?重要决定有没有留下可长期保存的记录?进入下一阶段前,要不要整理一份简短交接?

没有一个适用于所有任务的比例,一旦超过就说明会话变差。范围清晰的小任务和长时间排查,需要的上下文不同。数字能提供参考,实际工作仍需检查。

上下文占用也看不出代理是否正在等我批准或作决定。那需要单独、明确的提示,留待本系列另一篇讨论。

不知道,就明说不知道

最不可靠的显示方式,是把缺失信息悄悄变成一个让人安心的零。没有数据,就该明确告诉读者。

截图展示的是已有数值。如果某一项取不到,我宁愿看到“不可用”,也不想看到绿色的零。这样至少知道,自己缺少的是哪条信息。

尽量简单,方便检查,也方便移除

Claude Code 支持自定义状态行:由本地命令读取会话 JSON,再输出显示内容。官方文档说明了模型与上下文字段,因此可以从这些信息开始,不必另造一个仪表盘。

最小版本先显示模型和上下文,等费用数据的来源与统计范围明确后,再加入估算。显示程序只处理传入字段,不扫描仓库、不访问网络,也不保存对话。这是本示例的设计取舍,并不适用于所有状态行扩展。

启用前,我会用已知输入测试,并确认缺失值不会被显示成零。起点应该是少量可信、容易看懂的信息,而不是一长串数字。

让脑海里少装几件事

一行状态不能让代理更聪明,也不能替代代码审查。但它能提供一个固定位置,放下那些原本要靠我记住或临时查找的信息。

我更感兴趣的是这样的工具:少打断几次,少费力确认基本状态,把注意力留给真正需要判断的事情。你会在代理会话下面放哪些信息?

参考资料

Claude Code 状态行官方文档,核对日期:2026年10月27日。

试试这个本地运行的小示例

ZIP 内有三个文件:可直接阅读的 Python 格式化脚本、虚构的会话数据和使用说明。脚本输出一行文字后就会退出。

下载示例 ZIP · 查看 Python 源码

使用附带的示例数据运行:

python3 statusline-example.py < sample-session.json

示例输出(虚构数据):

Example model A | context 19% | est. $0.42

需要 Python 3,无需安装额外依赖、管理员权限或任何凭据,也不会发起网络请求。下载后的示例在运行时不会访问本站。

这只是教学示例,不是编程代理插件。它负责格式化 JSON 中提供的值,不会自动识别模型、读取 token 用量或计算账单。若要接入实际代理,还需要单独编写适配器。

ZH
English ENDeutsch DEEspañol ES中文 ZHFrançais FRPortuguês (Brasil) PT-BR日本語 JAहिन्दी HINederlands NL