Claude HUD 快速上手指南给 Claude Code 装上一条实时状态栏【免费下载链接】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-hudClaude HUD 是一个为 Claude Code 编写的插件它借助官方的 statusline 机制在输入框下方常驻显示当前会话的上下文占用、正在执行的工具、运行中的子代理和待办任务进度。不需要额外开窗口、不依赖 tmux任何终端里都能用。适合经常长会话使用 Claude Code、希望随时掌握模型正在干什么的开发者。项目定位一条状态栏而不是一个新窗口Claude HUD 的工作方式比较轻Claude Code 把会话数据模型信息、上下文窗口、transcript 记录通过 stdin 交给它它解析后渲染成两到三行文本输出到终端底部。因为走的是原生 statusline 接口所以不占用额外屏幕空间始终在输入框下方可见token 数据来自 Claude Code 本身不是估算值也能适配 1M 上下文的新会话每次交互后自动重绘300ms 防抖包括新消息、/compact、权限变化之后。它解决什么问题长会话里的三个看不见用 Claude Code 跑一个稍长的任务时人很容易失去对全局的掌控上下文快满了才发现。窗口用到多少、还剩多少平时完全没有感知往往等到自动压缩或报错才意识到。HUD 用一条绿→黄→红的进度条把占用比例摊在眼前。工具在忙什么无从判断。Claude 读文件、编辑、搜索是逐条发生的但过程散落在对话流里。HUD 会把最近完成的活动如Edit: auth.ts、Read ×3聚合成一行。子代理和任务进度靠猜。派发了 subagent 之后它跑到哪一步、todo 完成了几项只能在对话里往上翻。HUD 单独给出代理状态行和2/5这样的任务进度。使用后的可见收益默认两行可选行按需开启默认布局只有两行第一行是模型名、项目路径和 git 分支第二行是上下文进度条加上订阅用量限制如25% (1h 30m / 5h)。通过配置还可以打开这些可选行信息带来的收益工具活动行实时看到 Claude 在读/改/搜哪些文件代理状态行知道 subagent 在做什么、跑了多久待办进度行任务完成度一目了然成本、时长、输出速度控制长会话的花费与节奏中文标签简体/繁体界面文案本地化默认仍是英文快速上手四条命令完成安装在 Claude Code 会话内依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /claude-hud:setupsetup是引导式配置选一个预设Full / Essential / Minimal、选语言、微调显示项保存前能看到预览效果。完成后下一条消息开始 HUD 就会出现一般无需重启。两个常见环境问题Linux 旧版本报EXDEV: cross-device link not permitted先升级 Claude Code或安装前设置TMPDIRWindows 提示找不到 JavaScript 运行时先安装 Node.js LTS 再重跑 setup项目要求 Node ≥ 18。如果习惯命令行也可以在会话外用claude plugin marketplace add和claude plugin install完成前两步。关键入口从哪开始看配置和模块配置命令/claude-hud:configure随时重开引导式配置布局、语言、常用开关都在这里命令定义在 commands/configure.md 与 commands/setup.md。配置文件~/.claude/plugins/claude-hud/config.json颜色、路径层级、进度条字符、阈值等高级项直接改这里引导配置不会覆盖手工设置。渲染模块各信息行的绘制逻辑分散在 src/render/ 下tools-line.ts工具行、agents-line.ts代理行、todos-line.ts待办行都各自独立想理解某一行怎么来的可以直接看对应文件。配置读取src/config.ts 与 src/config-reader.ts 负责配置的加载与解析。使用建议与延伸阅读先选Essential预设跑几天确认需要哪些行再逐项开启避免一开始就被 Full 预设的信息量淹没。上下文条到 85% 以上时HUD 会自动展开 token 明细此时是执行/compact的合理时机把它当成压缩提醒来用。团队共用配置时多个 Claude 配置目录可以把公共项放在共享的 config.json差异化项放到各自的claude-hud.json叠加生效。中文界面需显式选择在 configure 里选zh-Hans简体或zh-Hant繁体。进一步阅读README.md完整选项表30 项配置、限流显示、外部用量快照等细节README.zh.md中文文档CLAUDE.md 与 CONTRIBUTING.md项目约定与贡献流程tests/各信息行的测试用例配合 fixtures 可以看到各种渲染形态的样例。【免费下载链接】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），仅供参考 Claude HUD 快速上手指南：给 Claude Code 装上一条实时状态栏
Claude HUD 快速上手指南给 Claude Code 装上一条实时状态栏【免费下载链接】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-hudClaude HUD 是一个为 Claude Code 编写的插件它借助官方的 statusline 机制在输入框下方常驻显示当前会话的上下文占用、正在执行的工具、运行中的子代理和待办任务进度。不需要额外开窗口、不依赖 tmux任何终端里都能用。适合经常长会话使用 Claude Code、希望随时掌握模型正在干什么的开发者。项目定位一条状态栏而不是一个新窗口Claude HUD 的工作方式比较轻Claude Code 把会话数据模型信息、上下文窗口、transcript 记录通过 stdin 交给它它解析后渲染成两到三行文本输出到终端底部。因为走的是原生 statusline 接口所以不占用额外屏幕空间始终在输入框下方可见token 数据来自 Claude Code 本身不是估算值也能适配 1M 上下文的新会话每次交互后自动重绘300ms 防抖包括新消息、/compact、权限变化之后。它解决什么问题长会话里的三个看不见用 Claude Code 跑一个稍长的任务时人很容易失去对全局的掌控上下文快满了才发现。窗口用到多少、还剩多少平时完全没有感知往往等到自动压缩或报错才意识到。HUD 用一条绿→黄→红的进度条把占用比例摊在眼前。工具在忙什么无从判断。Claude 读文件、编辑、搜索是逐条发生的但过程散落在对话流里。HUD 会把最近完成的活动如Edit: auth.ts、Read ×3聚合成一行。子代理和任务进度靠猜。派发了 subagent 之后它跑到哪一步、todo 完成了几项只能在对话里往上翻。HUD 单独给出代理状态行和2/5这样的任务进度。使用后的可见收益默认两行可选行按需开启默认布局只有两行第一行是模型名、项目路径和 git 分支第二行是上下文进度条加上订阅用量限制如25% (1h 30m / 5h)。通过配置还可以打开这些可选行信息带来的收益工具活动行实时看到 Claude 在读/改/搜哪些文件代理状态行知道 subagent 在做什么、跑了多久待办进度行任务完成度一目了然成本、时长、输出速度控制长会话的花费与节奏中文标签简体/繁体界面文案本地化默认仍是英文快速上手四条命令完成安装在 Claude Code 会话内依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /claude-hud:setupsetup是引导式配置选一个预设Full / Essential / Minimal、选语言、微调显示项保存前能看到预览效果。完成后下一条消息开始 HUD 就会出现一般无需重启。两个常见环境问题Linux 旧版本报EXDEV: cross-device link not permitted先升级 Claude Code或安装前设置TMPDIRWindows 提示找不到 JavaScript 运行时先安装 Node.js LTS 再重跑 setup项目要求 Node ≥ 18。如果习惯命令行也可以在会话外用claude plugin marketplace add和claude plugin install完成前两步。关键入口从哪开始看配置和模块配置命令/claude-hud:configure随时重开引导式配置布局、语言、常用开关都在这里命令定义在 commands/configure.md 与 commands/setup.md。配置文件~/.claude/plugins/claude-hud/config.json颜色、路径层级、进度条字符、阈值等高级项直接改这里引导配置不会覆盖手工设置。渲染模块各信息行的绘制逻辑分散在 src/render/ 下tools-line.ts工具行、agents-line.ts代理行、todos-line.ts待办行都各自独立想理解某一行怎么来的可以直接看对应文件。配置读取src/config.ts 与 src/config-reader.ts 负责配置的加载与解析。使用建议与延伸阅读先选Essential预设跑几天确认需要哪些行再逐项开启避免一开始就被 Full 预设的信息量淹没。上下文条到 85% 以上时HUD 会自动展开 token 明细此时是执行/compact的合理时机把它当成压缩提醒来用。团队共用配置时多个 Claude 配置目录可以把公共项放在共享的 config.json差异化项放到各自的claude-hud.json叠加生效。中文界面需显式选择在 configure 里选zh-Hans简体或zh-Hant繁体。进一步阅读README.md完整选项表30 项配置、限流显示、外部用量快照等细节README.zh.md中文文档CLAUDE.md 与 CONTRIBUTING.md项目约定与贡献流程tests/各信息行的测试用例配合 fixtures 可以看到各种渲染形态的样例。【免费下载链接】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），仅供参考