在使用Claude Code等AI编程工具时,你是否曾经好奇过:AI正在使用哪些工具?消耗了多少上下文?当前有哪些子任务正在运行?Claude HUD 就是来解决这个痛点的——它是一个Claude Code插件,将AI编程过程中的所有关键信息直观地展示在输入框下方。
项目简介
Claude HUD 由开发者 jarrodwatts 创建,是一个专门为 Claude Code 设计的可视化插件。它在Claude Code界面的底部添加一个常驻面板,实时展示上下文使用量、活跃工具、运行中的子Agent、Todo进度等关键信息,让用户对AI的”思考过程”有完全透明的了解。目前在GitHub上已获得超过1.8万颗星标,是Claude Code生态中非常受欢迎的工具类插件。
核心特色功能
1. 上下文用量可视化:实时显示当前消耗的上下文窗口用量,以百分比和具体数字呈现,帮助判断何时需要总结或压缩上下文。
2. 活跃工具展示:AI当前正在调用的工具会高亮显示,工具调用历史也可以查看,方便理解AI的行动轨迹。
3. 子Agent状态追踪:当Claude Code启动多个子Agent并行工作时,HUD会显示每个Agent的状态和进度。
4. Todo进度面板:实时展示当前任务列表中每项的完成状态,已完成、进行中、待处理的分别以不同颜色标注。
5. 成本估算:集成API调用成本估算功能(需配置API密钥),让用户对每次会话的实际花费有清晰认知。
6. 轻量级设计:HUD以最小侵入性的方式嵌入Claude Code界面,不影响正常操作,却能提供丰富信息。
7. 主题适配:自动适配Claude Code的明暗主题,保持界面协调统一。
安装步骤
前提条件:已安装 Claude Code(Claude Desktop 或通过 npm 安装的 CLI 版本)
第一步,确认Claude Code版本:
claude –version
确保版本支持插件系统(v0.3.0及以上)。
第二步,安装Claude HUD插件:
claude plugins install jarrodwatts/claude-hud
或者通过npm单独安装:
npm install -g @jarrodwatts/claude-hud
第三步,在Claude Code中启用:
在Claude Code设置中,找到Plugins选项,启用Claude HUD。
第四步,配置(如需要):
在 ~/.claude/commands/ 目录下创建 hud.config.json 以进行个性化配置:
{
“showCost”: true,
“showContextPercent”: true,
“showTools”: true,
“theme”: “auto”
}
使用方法
安装完成后,每次启动Claude Code,HUD面板会自动显示在界面底部。
查看上下文状态:面板左侧显示当前上下文用量百分比。
监控工具调用:AI执行命令时,工具名称会实时跳动高亮。
追踪子Agent:启动多Agent任务时,可看到各Agent的独立状态。
管理Todo:在HUD中可以直接查看和更新Todo列表。
查看成本:配置API密钥后,可实时看到会话成本消耗。
适用场景
1. 学习AI编程:新手开发者通过HUD了解AI编程工具的工作原理,加深对Agent系统的理解。
2. 复杂任务监控:处理大型代码重构或复杂功能开发时,监控AI的工作状态和进度。
3. 成本控制:开启成本估算功能,防止意外超支,特别适合需要精打细算的个人开发者。
4. 调试提示词:观察工具调用序列,帮助优化自己的提示词设计。
5. 团队协作教学:团队leader可以通过HUD状态向新人演示AI编程的工作过程。
开源协议
Claude HUD采用MIT开源协议,完全免费可商用。
总结
Claude HUD解决了一个很实际的问题:AI编程过程对人类来说往往是黑箱。HUD以最小的认知负担,将最关键的信息呈现出来,让用户既能享受AI编程的效率,又能保持对过程的掌控感。对于频繁使用Claude Code的开发者来说,Claude HUD是一个提升体验的利器。
项目地址:https://github.com/jarrodwatts/claude-hud








暂无评论内容