三分钟装上 Claude Code 实时状态栏：用 Claude HUD 一眼看清上下文、工具与代理进度

三分钟装上 Claude Code 实时状态栏用 Claude HUD 一眼看清上下文、工具与代理进度【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud如果你正在用 Claude Code 跑任务多半遇到过这样的瞬间它开始读文件、改代码你却只能干等不知道上下文还剩多少、子代理在忙什么、待办完成了几项。Claude HUD 就是为了解决这个问题——它是一个 Claude Code 插件通过原生 statusline 接口把上下文占用、活动工具、运行中的代理和 todo 进度实时画在输入框下方让你不用打断会话就能掌握全局。先看看它长什么样默认情况下 HUD 只有两行非常克制第一行是模型名如[Opus]、项目路径和 git 分支第二行是上下文进度条颜色会从绿变黄再到红旁边是订阅额度的使用率。开启可选项后会多出三行实况行内容你能得到什么工具活动看着 Claude 实时读、改、搜索哪些文件代理状态哪个子代理在跑、跑了多久、在干什么Todo 进度任务完成了几比几进度一目了然下图是更紧凑的 5:2 布局效果适合屏幕空间紧张的终端三步完成安装不需要单独开窗口也不依赖 tmux任何终端都能用。在 Claude Code 会话里依次执行三条命令即可添加插件市场/plugin marketplace add jarrodwatts/claude-hud安装插件/plugin install claude-hud配置状态栏/claude-hud:setup装完后重新加载插件/reload-plugins下一条消息之后 HUD 就会出现无需重启。如果你习惯命令行也可以先 clone 仓库地址https://gitcode.com/GitHub_Trending/cl/claude-hud再执行claude plugin marketplace add和claude plugin install对应的 CLI 命令效果相同。两个新手常踩的坑提前说Linux 上安装报EXDEV: cross-device link not permitted升级 Claude Code 即可旧版本可先设置TMPDIRWindows 上提示找不到 JavaScript 运行时装一个 Node.js LTSwinget install OpenJS.NodeJS.LTS后重开 shell 再来一次。最省事的配置方法跟随向导选预设想调整显示内容运行/claude-hud:configure它会用一个引导式流程问你布局、预设、语言等几个问题保存前还能预览最终效果。预设分三档Full全开——工具、代理、todo、git、用量、时长都有Essential活动信息 git 状态信息密度适中Minimal只留模型名和上下文条极致干净选完预设后还能逐项开关。语言支持英文默认、简体中文zh/zh-Hans和繁体中文zh-Hant/zh-TW对中文用户很友好。进阶手动改配置文件向导没暴露的选项直接编辑~/.claude/plugins/claude-hud/config.json就能设自定义颜色、路径显示层级pathLevels、终端宽度兜底maxWidth、上下文告警阈值等。放心手动改过的键在下次运行向导时会被保留不会被覆盖。它是怎么做到的源码速览原理其实很干净Claude Code 把会话数据以 JSON 形式通过 stdin 喂给 HUD同时附带 transcript 记录文件HUD 解析出工具、代理、todo 信息再把渲染结果写到 stdout 显示在终端里。几个值得称道的细节上下文数据取自 Claude Code 原生 token 统计不是估算值1M 上下文的长会话也能正确换算每次交互后自动重绘新消息、/compact、权限变更等并做了 300ms 防抖不会闪烁上下文条颜色会随占用率变化快满之前就给你信号想读代码的话渲染逻辑集中在 src/render/ 目录各信息行工具、代理、上下文等都拆成了独立文件配置读取在 src/config-reader.ts多语言文案在 src/i18n/。整体结构清晰很适合当插件开发的学习样本。更多细节可以看仓库里的 README.zh.md 中文文档。下一步打开你的 Claude Code把上面三步跑完再用/claude-hud:configure挑一个预设——下次再看到那条绿转红的上下文进度条你就知道什么时候该/compact了。【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考