状态栏展示上下文使用与任务进度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 跑一个大的重构任务时你会反复惦记三件事上下文窗口还剩多少、它现在正在改哪个文件、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 秒重跑一次倒计时就跟着走。三组场景化调优组合宽屏 多代理并行expanded布局 Full 预设打开showTools/showAgents/showTodospathLevels设为 1。宽屏横向空间够每行承载一类信息切任务时不用移开视线。笔记本 单项目compact布局 Minimal 预设usageCompact: true把用量窗口压成5h: 25%的短文本状态栏只占一行。工作/个人多配置目录共享 plugins 目录加各目录claude-hud.json覆盖用display.customLine写明环境名切终端不会混。先把lineLayout改成compact把上下文条挪到elementOrder最左位用一天。觉得倒计时停住再补refreshInterval觉得字段多余就把它从数组里删掉。【免费下载链接】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），仅供参考
