Claude HUD：给Claude Code加装实时仪表盘

大家好，我是苍一，一个干了13年的后端开发，正在探索AI编程，从产品到开发的全生命周期最佳实践，如果您感兴趣，欢迎关注👇，看我如何自我革命。

问题：你在Claude Code里是盲开的

用Claude Code写代码，有几个信息一直看不到：上下文窗口用了多少、模型正在处理什么文件、子agent跑了多久、用量配额还剩多少。你只能盯着终端文字一行行滚动，整体节奏和资源消耗完全是黑箱。

上下文窗口不管是200K还是1M，总有用完的时候。一旦接近上限，Claude Code会自动压缩历史消息，之前讨论的细节可能丢掉。如果你能提前看到上下文使用率到了85%，完全可以主动开新会话把关键信息带过去。

配额管理也是类似困境。Max订阅有5小时和7天两个窗口限制，但终端里看不到剩余时间，每次想确认都得切到网页上查。

Claude HUD是什么

Claude HUD是一个Claude Code插件，在终端输入框下方常驻显示状态面板。基于Claude Code原生statusline API构建，不需要额外终端窗口，不依赖tmux。

1️⃣ 默认面板：两行关键数据

第一行是当前模型名称、项目路径和git分支。第二行是上下文窗口使用率和用量配额，进度条直观反映消耗程度。这两行信息解决了80%的日常需求。

2️⃣ 扩展面板：工具、子agent和任务进度

开启扩展模式后多出几行信息：工具活动行显示Claude在读哪个文件、编辑哪个文件；子agent状态行显示每个子agent的名字、当前动作和运行时长；Todo进度行显示当前任务完成情况。

技术架构

上下文使用率和用量配额来自Claude Code通过stdin传入的JSON，是官方原生数据，不是估算值。工具活动、子agent状态和Todo进度来自解析本地transcript JSONL文件。整个面板每300ms刷新一次。

安装和配置

在Claude Code里依次执行：

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

三种预设模式：Full模式开启所有信息行；Essential模式只保留活动行和git状态；Minimal模式只显示模型名和上下文进度条。

配置细节

上下文显示支持百分比、token数、剩余量或组合。用量配额支持倒计时、绝对时间或两者都显示。Git状态可显示ahead/behind计数、文件变更统计。还可开启费用显示、输出速度、prompt cache倒计时、系统内存使用率等。所有颜色支持自定义。

适合谁用

每天用Claude Code超过一小时的人装一个HUD是划算的。它解决的问题很小：让你实时看到会话状态。但看不到的时候你总是在猜，HUD把这些信息变成扫一眼就能获取的东西。

GitHub地址：https://github.com/jarrodwatts/claude-hud

如果嫌文章太长、怕后面走丢，可以关注下面的ima知识号，让这篇文章成为你的知识顾问，随时随地等候你的提问。

知识号中内容会以笔记形式分享，可以根据大家反馈和实测情况，实时更新，保证最新方案的稳定、可用。

【ima 知识库】