你真的了解 Claude Code 在干什么吗用过 Claude Code 的开发者都有一个共同的痛点——你无法直观地知道当前会话的健康状况。上下文窗口用了多少每日配额还剩多少后台有几个 Agent 在并行跑任务这些关键信息过去只能靠经验去猜测。直到我发现了claude-hud这个插件。它就像汽车的仪表盘把 Claude Code 运行时的所有关键指标实时、直观地展示在你的终端输入框下方。装上它之后我再也不会因为上下文爆满导致对话质量下降而浑然不知也不会在配额快用完时还在执行大规模重构任务。一眼看清全局claude-hud 到底展示了什么claude-hud 利用 Claude Code 原生的statusLine API在终端底部渲染一个始终可见的状态面板。默认的精简模式只占两行空间却浓缩了最核心的信息[Opus 4.6] │ workspace-ai Context █████░░░░░ 15% │ Usage ██░░░░░░░░ 13% (resets in 3h 24m)第一行显示当前使用的模型版本和项目目录名称如果你的项目是 Git 仓库还会自动显示当前分支和是否有未提交的改动。第二行是重点——三个颜色编码的进度条Context上下文占用显示当前对话已使用的上下文窗口百分比。当这个数值超过 70% 时进度条变黄超过 90% 变红提醒你该考虑压缩上下文或开启新会话了。Usage配额消耗显示当前时间窗口内的 API 配额使用率以及距离下次重置的倒计时。有了这个信息你可以合理安排工作节奏避免在关键时刻被限速。Weekly周配额显示本周的整体配额消耗情况帮助你从更长的时间维度规划 AI 辅助编程的使用策略。实战建议Context 超过 50% 时果断执行 /clear这里分享一个我在日常使用中总结的经验法则——当你看到 Context 进度条超过 50% 时就应该考虑执行/clear命令来压缩上下文了。为什么是 50% 而不是等到 70% 或 90%原因有三上下文越满AI 的回答质量越差。Claude 的注意力会被大量历史对话稀释对当前问题的理解准确度会明显下降尤其是在涉及多个文件的复杂任务中。越早压缩保留的有效信息越多。/clear会智能压缩历史对话但如果等到 90% 才压缩被迫丢弃的信息量会大得多可能导致 AI忘记之前讨论过的关键决策。避免突然中断工作流。如果在一个关键操作进行到一半时上下文爆满Claude Code 会被迫自动压缩这个时机往往不是最优的。主动在 50% 时清理能让你掌握主动权。有了 claude-hud这个判断变得异常简单——只需要瞟一眼终端底部的 Context 进度条。当绿色进度条走到一半的位置时就是你该执行/clear的信号。Context ██████████░░░░░░░░░░ 50% ← 看到这个果断 /clear这个小习惯看起来不起眼但长期坚持下来你会发现整个会话过程中 AI 的回答质量明显更稳定不再出现聊着聊着就变笨了的尴尬。不止于监控可选的高级功能除了默认的精简显示claude-hud 还提供了多个可选模块你可以根据自己的需求按需开启工具活动追踪Tools Activity开启后你可以实时看到 Claude Code 正在调用哪些工具◐ Edit: src/main.ts | ✓ Read ×3 | ✓ Grep ×2当你提交一个复杂的需求后这行信息能让你清楚地知道 AI 当前在读哪个文件、在编辑哪段代码、搜索了多少次。不再是面对一个旋转的光标干等而是对整个执行过程了然于胸。Agent 与 Todo 状态Agents Todos如果你的任务触发了多个子代理subagent并行工作这个模块会显示每个代理的运行状态和耗时⚡ Agent: code-reviewer (12s) | ◐ Agent: test-runner (5s)同时如果你使用了 Claude Code 的 Todo 功能来拆分任务步骤进度也会实时展示。对于大型重构或多步骤的开发任务这个功能尤其实用。会话信息Session Info显示当前会话的持续时间、加载的配置文件数量等元信息。虽然不是每个人都需要但在排查配置问题或者回顾工作时长时非常有用。三步完成安装零配置即可使用claude-hud 的安装过程极其简单整个过程不超过两分钟第一步添加插件市场/plugin marketplace add jarrodwatts/claude-hud第二步安装插件/plugin install claude-hud第三步运行自动配置/claude-hud:setup执行 setup 命令后插件会自动检测你的运行环境Node.js 或 Bun生成正确的 statusLine 配置并写入~/.claude/settings.json。重启 Claude Code 后HUD 就会出现在输入框下方。整个过程不需要手动编辑任何配置文件不需要安装额外的依赖开箱即用。进阶玩法定制你的专属仪表盘如果默认的两行显示不能满足你的需求claude-hud 提供了丰富的自定义选项。你可以通过编辑~/.claude/plugins/claude-hud/config.json来精细控制每个显示元素。插件内置了三个预设方案预设包含内容适用场景Minimal模型名称 上下文进度追求极简的开发者Essential核心指标 Git 状态 工具活动大多数日常开发场景Full所有模块全开复杂项目调试、多 Agent 并行任务除了预设之外你还可以单独控制颜色阈值、进度条样式、目录显示层级等细节。比如你可以把上下文告警阈值从默认的 70% 调整为 60%提前获得预警。为什么我认为每个 Claude Code 用户都应该装它在使用 claude-hud 之前我经常遇到这些场景上下文悄悄爆满对话进行到一半突然发现 AI 的回答质量骤降才意识到上下文已经快满了。这时候要么手动压缩要么开新会话重新描述需求浪费大量时间。配额意外耗尽在执行一个大型重构任务时配额突然用完被限速只能干等几个小时。如果提前知道配额所剩无几完全可以把大任务拆成小步骤来执行。黑盒等待焦虑提交一个复杂需求后终端只显示一个思考动画你不知道 AI 在读文件还是在写代码不知道进展到哪一步了只能焦虑地等待。claude-hud 完美解决了这三个问题。它让 Claude Code 的运行状态从黑盒变成了透明箱你的每一次决策都有数据支撑。技术实现轻量且优雅从技术角度看claude-hud 的实现非常精巧。它通过 Claude Code 的 statusLine API 接收 JSON 格式的会话数据通过 stdin解析后输出格式化的状态信息到终端。整个过程大约每 300 毫秒刷新一次对性能几乎没有影响。插件支持 Node.js 18 和 Bun 两种运行时兼容 macOS、Linux 和 Windows 三大平台。源码采用 TypeScript 编写MIT 协议开源目前在 GitHub 上已经收获了超过2 万颗星标社区活跃度非常高。项目地址https://github.com/jarrodwatts/claude-hud与同类方案的对比目前 Claude Code 生态中状态监控类的解决方案并不多。在 claude-hud 出现之前开发者通常有两种方式获取会话状态手动查询通过/usage等命令主动查询配额但这会打断工作流程凭经验判断根据对话长度和复杂度来估计上下文占用但往往不准确claude-hud 的优势在于它是被动式、实时的——你不需要做任何操作关键信息始终就在眼前。这种抬头即见的设计理念让状态监控真正融入了开发工作流而不是作为额外的负担。