Claude HUD 自定义布局3 档预设 1 行 elementOrder30 秒上手【免费下载链接】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 插件把上下文用量、活动工具、运行中的代理和待办进度压缩到输入框下方的几行里。默认布局能用但不一定合你的胃口——这篇带你把 HUD 配置一次讲透屏幕上各元素是什么、三档预设怎么挑、elementOrder 怎么调序以及配置不生效时最常见的 3 个坑。先跑起来/claude-hud:configure 三十秒走完向导不用先读 JSON。在 Claude Code 会话里输入/claude-hud:configure向导会依次问五个问题选布局expanded 扩展、compact 紧凑、compact 加分隔符、选预设Full / Essential / Minimal、从预设开启的项里关掉不需要的、把预设漏掉的开起来、定 Git 显示档位。保存前它会展示改动摘要和一次 HUD 预览确认后才写入~/.claude/plugins/claude-hud/config.json——以后所有手动修改都是直接编辑这个文件。如果向导的默认选项不合你意别删配置重来往下先看清楚屏幕上到底有什么。屏幕上到底显示了什么元素拆解HUD 的元素分两类。一类是默认就有的模型名如[Opus]和上下文条如████░░░░ 45%这两项对应display.showModel和display.showContextBar向导默认保持开启。另一类都是可选开关项目路径工作目录的最后 1~3 段由pathLevels控制Git 状态分支、脏标记、与上游的前后关系工具活动Claude 此刻在用的工具编辑、读取、搜索等代理状态正在跑的子代理及其任务待办进度当前任务的完成比例使用限制Pro/Max 订阅的用量百分比会话时长、输出速度会话已运行多久、令牌出速配置计数CLAUDE.md、规则、MCP、钩子的数量这些元素背后都是display里的布尔开关而且只在有实际内容时才真的占地方。想搞清楚每一项的位置再谈顺序才有意义。三档预设一张表看完选预设其实就是在选信息密度三档的差异列出来一眼就懂特性FullEssentialMinimal模型名 上下文条开开开工具 / 代理 / 待办开开关配置计数 / 令牌详情 / 使用限制开关关会话时长开开关Git 状态含脏标记开开开Full 和 Essential 的区别只在计数、令牌详情、使用限制这类信息型元素Essential 和 Minimal 的区别则是活动行到底显不出现。日常编码选 Essential 通常不亏想全知道就上 Full屏幕小就 Minimal。elementOrder 怎么排最顺手行内各元素的先后由elementOrder数组决定默认顺序定义在 src/config.ts 的DEFAULT_ELEMENT_ORDER里project → context → usage → environment → tools → agents → todos。想把工具活动顶到最前、把项目路径往后挪重排数组即可{ lineLayout: expanded, pathLevels: 2, elementOrder: [tools, project, context, usage, agents, todos, environment] }这段配置只做一件事把 tools 排到行首同时让路径只显示 2 级。注意改 order 只影响位置不影响显不显示——显示与否归display管。配色是同一个思路colors块里可以给 context、usage、warning、critical 等位置指定颜色可用名称为 red、green、yellow、magenta、cyan、brightBlue、brightMagenta。把 context 改成 cyan就只是上下文条换了颜色其余不动。Git 四档显示和 display 开关Git 信息从粗到细分四档在gitStatus对象里逐档叠加只显分支git:(main)→showDirty加脏标记git:(main*)→showAheadBehind加前后关系↑2 ↓1→showFileStats加文件统计!2 1 ?3Starship 兼容格式。一档都不想要就把enabled设成 false。display 这边给一个藏噪音、留活动的常见组合照着抄再删display: { showTools: true, showAgents: true, showTodos: true, showDuration: true, showConfigCounts: false, showUsage: true, usageBarEnabled: true }改完的效果是活动行和时长出现配置计数和令牌详情消失。要特别记住的一点tools、agents、todos 默认都是关的所以你看不到工具行多半不是坏了而是开关没开、或者当下恰好没有活动。按任务类型抄作业如果你主要跑前端文件操作频繁那就用lineLayout: expanded把 tools 和 todos 排进 elementOrder 前两位再开showDuration。资源密集的数据任务更适合lineLayout: compactcontext 和 usage 排前面开showConfigCounts、showTokenBreakdown、showSpeed盯资源。团队协作则把 project、agents、todos 提到前面开showSessionName方便分辨会话。每种场景只需要动 elementOrder 和两三个 display 开关别整文件重写。配置不生效3 个高频坑JSON 语法错无效的 JSON 不会报错而是静默回退到默认配置先拿校验器过一遍再怀疑别的。字段值不合法pathLevels只接受 1、2、3lineLayout只接受expanded或compact写错同样静默回退。Git 状态缺失先确认当前目录确实在 Git 仓库里且gitStatus.enabled不是 false都不行就删掉 config.json重新跑/claude-hud:configure生成一份干净的。顺带一提性能面HUD 约 300ms 刷新一次使用限制的 API 响应有缓存成功 60 秒、失败 15 秒对应cacheTtlSeconds与failureCacheTtlSeconds。如果嫌刷新频繁或接口压力大优先关掉工具活动这类高频实时元素。第一次别贪多先跑一遍向导落在 Essential然后只加一行 elementOrder 把你盯得最多的元素挪到行首——一次改一处舒服了再动下一处。【免费下载链接】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），仅供参考