用途：Claude HUD 为 Claude Code 添加常驻终端状态栏，实时展示上下文窗口用量、正在调用的工具、运行中的子智能体以及待办完成进度，始终显示在输入提示下方。
主要能力：以进度条显示上下文健康度（绿→黄→红）；实时显示文件读取、编辑与搜索等工具活动；跟踪子智能体及其当前动作；跟踪待办进度；显示订阅用量限额；显示 Git 当前分支、脏状态及领先/落后远端。默认 2 行布局，可选择开启更多活动行。
要求与安装：需 Claude Code v1.0.80+、Node.js 18+ 或 Bun。在 Claude Code 会话内依次执行： /plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup 然后重启 Claude Code 加载新的 statusLine 配置。Linux 若报 EXDEV: cross-device link not permitted，先执行 mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude；Windows 若提示无 JavaScript 运行时，先执行 winget install OpenJS.NodeJS.LTS。
使用方式：可用 /claude-hud:configure 打开交互配置，提供 Full、Essential、Minimal 预设；也可手动编辑 ~/.claude/plugins/claude-hud/config.json。可配置 lineLayout（expanded/compact）、pathLevels、elementOrder、contextValue（percent/tokens/remaining/both）、gitStatus 各项及颜色等。
工作原理与限制：通过 Claude Code 原生 statusline API，无需独立窗口或 tmux，token 数据来自 Claude Code 而非估算，约每 300ms 更新。工具、智能体、待办行默认隐藏，需开启对应开关且仅在有活动时渲染。用量限额需 Claude 订阅账户，仅用 API 密钥不显示；AWS Bedrock 用户显示 Bedrock 标签，用量在 AWS 控制台管理；新会话首次模型响应前用量数据可能为空。