状态栏展示上下文使用与任务进度：claude-hud 的展示定制实践

状态栏展示上下文使用与任务进度：claude-hud 的展示定制实践

【免费下载链接】claude-hudA Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud

让 Claude Code 跑一个大的重构任务时，你会反复惦记三件事：上下文窗口还剩多少、它现在正在改哪个文件、todo 列表做到第几条。靠翻聊天记录确认，打断思路。claude-hud 把这些信息放进输入框下方的状态栏，随每次交互实时重绘。

状态栏里展示上下文使用与工具活动

Claude Code 有原生的 statusline 机制，但默认内容很单薄。claude-hud 接管的正是这个槽位：token 数据直接读 Claude Code 通过 stdin 传来的负载，是准确值而不是估算；工具、子代理和 todo 的状态从会话 transcript（记录整段对话的 JSONL 日志文件）里解析；每次交互后状态栏重新渲染。它不开独立窗口、不依赖 tmux、不发出任何网络请求，这点和需要另起窗口的方案不同。

三条命令让状态栏出效果

在 Claude Code 会话里先添加插件源，再安装并重载：

/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins

随后运行/claude-hud:setup。这一步会把 statusLine 写进你本地的~/.claude/settings.json，并先备份已有配置。下一条消息之后 HUD 就会出现，默认两行：第一行是模型、项目路径和 git 分支，第二行是上下文进度条与用量窗口。

状态栏字段怎么排、布局怎么选

展示层的改动集中在你本地配置目录的~/.claude/plugins/claude-hud/config.json，可写的字段由仓库里的 src/config.ts 定义。

• 布局：lineLayout取expanded按语义分行，取compact压成一行。切到 compact 后，状态栏从三四行收成一行，终端纵向空间让给正文。
• 字段顺序：elementOrder是个数组，排列顺序即展示顺序，想把 todo 进度放在上下文条前面，把"todos"往前挪就行；把某个字段从数组里删掉，该字段直接隐藏。
• 信息取舍：pathLevels控制项目路径显示 1-3 级目录或full完整路径；display.showUsage关掉就隐藏订阅用量窗口；display.showTools、display.showAgents打开后能看见正在改的文件和运行中的子代理。
• 配置计数：CLAUDE.md、rules、MCP 服务器的数量由 src/render/lines/environment.ts 渲染，打开display.showConfigCounts后这行在数量超过阈值时出现。

如果你用多个CLAUDE_CONFIG_DIR配置目录并共享同一份 plugins 目录，可以在每个目录下放claude-hud.json，只写你想改的键，加载时它盖在共享配置之上，比如各写一个display.customLine区分环境。

状态联动与定时刷新怎么开

引导式入口是/claude-hud:configure，工具、agents、todos、成本等字段逐项勾选，保存前会先给你看渲染预览，字段语义可对照 commands/configure.md。

状态颜色由阈值驱动：上下文条平时是绿色，到display.contextWarningThreshold变色，到display.contextCriticalThreshold转红，条子红了就该考虑压缩对话了。工具状态靠符号区分：◐表示进行中，✓表示完成，×N是次数。

状态栏只在交互后重绘，用量倒计时这类时间字段在消息之间会停住。在~/.claude/settings.json的statusLine对象里加"refreshInterval": 5，每 5 秒重跑一次，倒计时就跟着走。

三组场景化调优组合

1. 宽屏 + 多代理并行：expanded布局 + Full 预设，打开showTools/showAgents/showTodos，pathLevels设为 1。宽屏横向空间够，每行承载一类信息，切任务时不用移开视线。
2. 笔记本 + 单项目：compact布局 + Minimal 预设，usageCompact: true把用量窗口压成5h: 25%的短文本，状态栏只占一行。
3. 工作/个人多配置目录：共享 plugins 目录加各目录claude-hud.json覆盖，用display.customLine写明环境名，切终端不会混。

先把lineLayout改成compact，把上下文条挪到elementOrder最左位，用一天。觉得倒计时停住再补refreshInterval，觉得字段多余就把它从数组里删掉。

【免费下载链接】claude-hudA Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud