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 的输出忽然停了你记不清它刚编辑了哪个文件也说不准上下文是不是快满了终端底部那行小字回答不了这些。这正是 claude-hud 要解决的事输入框下方的实时 HUD展示上下文占用、工具活动、代理状态和待办进度每一块都能按你的习惯调整顺序与详略。⚡ 30 秒跑通默认配置不必先读完所有选项。在 Claude Code 会话里运行/claude-hud:configure向导依次问你布局、预设、语言、要关掉的元素、要打开的元素、自定义短语。一路选保持默认也能得到一个可用的 HUD保存后立即生效无需重启。语言那一步除了英文还支持简体中文、繁体中文zh-Hans与zh-Hans这类别名都会被归一化。默认显示两行第一行是模型徽标、项目路径、git 分支第二行是上下文条与用量进度。上下文条就像汽车油表扫一眼颜色就知道窗口还富余多少旁边的用量条回答订阅额度用了多少、多久重置。所有定制最终都落到一份 JSON~/.claude/plugins/claude-hud/config.json。向导替你写它你也可以手动改如果同时跑多个配置目录CLAUDE_CONFIG_DIR把差异项放进配置目录根部的claude-hud.json它会在共享配置之上逐层覆盖。 认识你的仪表盘元素分三层README 的选项表很长但元素实际分三层。第一层始终可见模型名display.showModel回答现在是哪个大脑在工作上下文条display.showContextBar回答油表还剩多少用量限制display.showUsage回答订阅额度用了多少、何时重置。这三项默认开启向导也倾向保持它们亮着。第二层按需开关默认全关。活动类display.showTools告诉你哪个工具正在跑display.showAgents告诉你子代理在忙什么display.showTodos告诉你任务做到哪一步信息类display.showDuration会话时长、display.showSpeed输出速度、display.showConfigCounts配置计数、display.showCost费用。活动行有个共性——没有活动就不渲染开了开关也看不到空行。第三层是深度定制pathLevels控制项目路径显示几级目录1–3 或fulllineLayout选expanded多行或compact单行showSeparators给紧凑行加分隔符git 有四档详略从git:(main)到带脏标记、前后关系↑2 ↓1、再到文件统计!2 1 ?3colors.*、elementOrder、timeFormat属于手动编辑区向导只保存、不改动。 三种节奏各取所需向导里的三个预设对应三种使用节奏。全开档Full活动行全开——工具、技能、MCP、代理、待办信息行也全开——计数、令牌、费用、时长、缓存倒计时。适合长任务、多子代理并行、需要盯住所有活动部件的人代价是屏幕行数明显变多。日常档Essential保留工具、代理、待办和会话时长关掉计数、令牌明细、用量条。日常编码大多数时候落在这里看得到活动不被信息噪音淹没。极简档Minimal只剩模型名和上下文条活动全关。适合短任务、小终端窗口、或者屏幕本来就紧张的时候。预设只是起点。选定后向导还会问两轮关掉哪些、打开哪些保存前给你预览——所见即所存。 把元素顺序掰成你要的样子展开布局下元素的先后由elementOrder决定。默认值定义在 src/config.ts 的DEFAULT_ELEMENT_ORDER里共 13 项从project排到sessionTime。你只要在config.json里写一个字符串数组就是新的显示顺序列表里省略某项等于在展开模式下隐藏它。第一行内部的段模型、项目、会话名、时长、费用、速度等另由projectLineOrder控制只写前几项其余按渲染器原有顺序补齐。想把工具与代理提到最前改动只有三行{ elementOrder: [tools, agents, project, context, todos, usage] }同样是这 13 个元素两种盯屏习惯排法完全不同位置盯工具流的人盯进度的人打头tools、agentsproject、todos居中project、contextcontext、usage收尾usage、environmenttools、environment盯工具流的人想先确认它卡没卡、动得凶不凶盯进度的人想先确认离做完还有几步。再叠加display.mergeGroups默认把context和usage并成一行和display.rightAlign把某段钉在行尾布局基本就能贴住你的视线习惯。 踩坑与自救改了配置毫无变化→ JSON 里多一个逗号整份文件静默回退到默认值 → 先用语法检查过一遍找不到就删掉config.json重跑/claude-hud:configure重建。保存的设置被顶掉了→ 配置目录根部的claude-hud.json手动覆盖文件在顶层优先生效 → 检查它是否定义了同名键覆盖文件是逃生口不是 bug。git 分支不显示→ 当前目录不在仓库里或gitStatus.enabled是false→ 确认 cwd 是 git 仓库再确认开关。工具/代理/待办行一直缺席→ 三个display开关默认false且只在有活动时才渲染 → 打开showTools、showAgents、showTodos再做点会触发工具的操作。 让屏幕更省心的几个习惯先说开销。每次刷新HUD 都会完整重跑一遍命令解析转录、查 git 状态再按 300 毫秒防抖渲染。所以showSpeed、showMemoryUsage这类实时项各有一份解析成本elementOrder里排进去的元素越多紧凑行越容易折行只开你真正会看的那几个。再说刷新节奏。Claude Code 默认只在你有交互后才重跑状态栏消息之间的倒计时是冻住的。需要用量倒计时走动的话在settings.json的statusLine块里加一个refreshInterval秒最小 15 秒是推荐档位1 秒最顺滑但每一秒都要重跑整条命令机器会有感。最后别急着精调。colors.*支持命名色、256 色编号和#rrggbb十六进制contextWarningThreshold默认 70与contextCriticalThreshold默认 85控制油表何时变黄变红——这些等你对默认观感有了抱怨之后再动比开工前逐项配置省心得多。配置没有标准答案只有你的工作流。打开向导改一处看一眼预览再改下一处等你熟悉之后输入框下方这块小屏幕就成了你习惯的延伸。【免费下载链接】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），仅供参考