Claude HUD 配置完整指南3 种预设模式与自定义元素顺序实战【免费下载链接】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 布局。 快速上手5 步跑通 Claude HUD添加插件市场/plugin marketplace add jarrodwatts/claude-hud安装插件/plugin install claude-hud重新加载插件/reload-plugins运行/claude-hud:setup向导会自动检测运行时并写入statusline配置发送任意消息HUD 随即出现在输入框下方无需重启/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /claude-hud:setup 核心组成拆解基础层、可配置层与活动层基础层始终渲染模型名称如[Opus]和上下文条绿→黄→红渐变直观显示上下文窗口占用百分比。可配置层按需开关项目路径pathLevels控制 1~3 级目录深度、Git 状态分支、脏标记、前后关系、订阅用量限制、会话时长、输出速度以及 CLAUDE.md / 规则 / MCP / 钩子的计数。活动层解析会话 transcript 后实时呈现正在执行的工具编辑、读取、搜索、子代理的任务与耗时、待办完成进度外加 Skills 与 MCP 的调用情况。 分步配置详解跟随 /claude-hud:configure 向导向导只有 6 问按顺序回答即可生成完整配置选布局扩展布局多行语义分组、紧凑布局单行、紧凑分隔符选预设Full / Essential / Minimal详见下一节选语言英文、简体中文、繁体中文关闭元素从预设已开启的项中挑出不需要的开启元素从预设禁用的项中补开也可顺手配置 Git 显示详细程度预览确认向导展示变更摘要与 HUD 渲染预览确认后才落盘配置写入~/.claude/plugins/claude-hud/config.json之后随时可重跑向导增量调整向导不会覆盖你手动写的颜色、阈值等高级字段。 三种预设模式怎么选预设显示内容适用人群Full全开工具、代理、待办、配置计数、成本、时长等复杂项目、多任务并行开发Essential活动行 Git 状态 会话时长信息类最少日常编码、追求专注的用户Minimal仅模型名 上下文条 Git 状态简单任务、窄终端布局选项与预设正交扩展布局把元素按身份、项目、环境、用量分成语义行信息多时更清晰紧凑布局压成一行横向空间富余时省纵向高度。拿不准就选扩展 Essential之后再按需增减。 自定义元素顺序用 elementOrder 重排 HUD默认顺序定义在 src/config.ts 的DEFAULT_ELEMENT_ORDER中。在config.json里写一个elementOrder数组即可重排——数组中省略的元素在扩展布局下直接隐藏排序与显隐一举两得{ lineLayout: expanded, pathLevels: 2, elementOrder: [tools, project, context, usage, agents, todos], display: { showTools: true, showAgents: true, showTodos: true } }三种实用排布思路开发者优先tools、agents放最前第一时间看到 Claude 在动哪些文件项目管理优先project、todos打头聚焦任务推进与所在目录资源监控优先context、usage靠前盯紧上下文水位与订阅配额️ 场景实战为什么这样配多代理编排长任务开showAgents、showTodos、showDuration用扩展布局。子代理耗时较长你需要随时确认 explore、librarian 等代理是否还在跑、卡在哪个待办上时长行则防止会话无限拉长。窄终端快速会话lineLayout设compact只保留模型、上下文条、项目名与 Git 分支。所有信息压进一行视线不用上下扫适合小屏或分屏场景。团队协作开showSessionName显示/rename起的会话标题再开showConfigCounts确认每位成员加载了相同数量的 CLAUDE.md 与规则——配置不一致往往是行为对不上的第一嫌疑。⚡ 踩坑速查配置改完没反应→ 原因JSON 语法错误会静默回退到默认值 → 解法用 JSON 校验工具检查config.json或删掉文件重跑/claude-hud:configure。Git 状态不显示→ 原因当前目录不在 git 仓库内或gitStatus.enabled被设为false→ 解法确认仓库位置核对配置开关。工具 / 代理 / 待办行迟迟不出现→ 原因活动行默认隐藏且只在有真实活动时渲染 → 解法开启对应showTools/showAgents/showTodos然后让 Claude 干点活。安装后 HUD 不显示→ 原因statusline 只在一次交互之后渲染旧版 Claude Code 需要重启CLAUDE_HUD_DISABLE环境变量也会整体静默 HUD → 解法先发一条消息仍无效则重启 Claude Code 并检查该环境变量。⚙️ 进阶调优自动刷新在~/.claude/settings.json的statusLine中加refreshInterval: 5用量倒计时在消息间隙也不会停摆颜色与阈值colors.*覆盖 8 个语义色位支持 256 色编号与#rrggbbcontextWarningThreshold/contextCriticalThreshold调整上下文条变色时机多配置目录覆盖$CLAUDE_CONFIG_DIR/claude-hud.json会叠加在主配置之上只写要改的键即可适合共享plugins/的团队临时关闭CLAUDE_HUD_DISABLE1 claude即可启动一个无 HUD 的会话{ statusLine: { type: command, command: ..., refreshInterval: 5 } }把最关心的信息排到视线第一行Claude HUD 就从状态栏升级成了你的会话仪表盘。现在就运行/claude-hud:configure给 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude HUD 配置完整指南：3 种预设模式与自定义元素顺序实战
Claude HUD 配置完整指南3 种预设模式与自定义元素顺序实战【免费下载链接】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 布局。 快速上手5 步跑通 Claude HUD添加插件市场/plugin marketplace add jarrodwatts/claude-hud安装插件/plugin install claude-hud重新加载插件/reload-plugins运行/claude-hud:setup向导会自动检测运行时并写入statusline配置发送任意消息HUD 随即出现在输入框下方无需重启/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /claude-hud:setup 核心组成拆解基础层、可配置层与活动层基础层始终渲染模型名称如[Opus]和上下文条绿→黄→红渐变直观显示上下文窗口占用百分比。可配置层按需开关项目路径pathLevels控制 1~3 级目录深度、Git 状态分支、脏标记、前后关系、订阅用量限制、会话时长、输出速度以及 CLAUDE.md / 规则 / MCP / 钩子的计数。活动层解析会话 transcript 后实时呈现正在执行的工具编辑、读取、搜索、子代理的任务与耗时、待办完成进度外加 Skills 与 MCP 的调用情况。 分步配置详解跟随 /claude-hud:configure 向导向导只有 6 问按顺序回答即可生成完整配置选布局扩展布局多行语义分组、紧凑布局单行、紧凑分隔符选预设Full / Essential / Minimal详见下一节选语言英文、简体中文、繁体中文关闭元素从预设已开启的项中挑出不需要的开启元素从预设禁用的项中补开也可顺手配置 Git 显示详细程度预览确认向导展示变更摘要与 HUD 渲染预览确认后才落盘配置写入~/.claude/plugins/claude-hud/config.json之后随时可重跑向导增量调整向导不会覆盖你手动写的颜色、阈值等高级字段。 三种预设模式怎么选预设显示内容适用人群Full全开工具、代理、待办、配置计数、成本、时长等复杂项目、多任务并行开发Essential活动行 Git 状态 会话时长信息类最少日常编码、追求专注的用户Minimal仅模型名 上下文条 Git 状态简单任务、窄终端布局选项与预设正交扩展布局把元素按身份、项目、环境、用量分成语义行信息多时更清晰紧凑布局压成一行横向空间富余时省纵向高度。拿不准就选扩展 Essential之后再按需增减。 自定义元素顺序用 elementOrder 重排 HUD默认顺序定义在 src/config.ts 的DEFAULT_ELEMENT_ORDER中。在config.json里写一个elementOrder数组即可重排——数组中省略的元素在扩展布局下直接隐藏排序与显隐一举两得{ lineLayout: expanded, pathLevels: 2, elementOrder: [tools, project, context, usage, agents, todos], display: { showTools: true, showAgents: true, showTodos: true } }三种实用排布思路开发者优先tools、agents放最前第一时间看到 Claude 在动哪些文件项目管理优先project、todos打头聚焦任务推进与所在目录资源监控优先context、usage靠前盯紧上下文水位与订阅配额️ 场景实战为什么这样配多代理编排长任务开showAgents、showTodos、showDuration用扩展布局。子代理耗时较长你需要随时确认 explore、librarian 等代理是否还在跑、卡在哪个待办上时长行则防止会话无限拉长。窄终端快速会话lineLayout设compact只保留模型、上下文条、项目名与 Git 分支。所有信息压进一行视线不用上下扫适合小屏或分屏场景。团队协作开showSessionName显示/rename起的会话标题再开showConfigCounts确认每位成员加载了相同数量的 CLAUDE.md 与规则——配置不一致往往是行为对不上的第一嫌疑。⚡ 踩坑速查配置改完没反应→ 原因JSON 语法错误会静默回退到默认值 → 解法用 JSON 校验工具检查config.json或删掉文件重跑/claude-hud:configure。Git 状态不显示→ 原因当前目录不在 git 仓库内或gitStatus.enabled被设为false→ 解法确认仓库位置核对配置开关。工具 / 代理 / 待办行迟迟不出现→ 原因活动行默认隐藏且只在有真实活动时渲染 → 解法开启对应showTools/showAgents/showTodos然后让 Claude 干点活。安装后 HUD 不显示→ 原因statusline 只在一次交互之后渲染旧版 Claude Code 需要重启CLAUDE_HUD_DISABLE环境变量也会整体静默 HUD → 解法先发一条消息仍无效则重启 Claude Code 并检查该环境变量。⚙️ 进阶调优自动刷新在~/.claude/settings.json的statusLine中加refreshInterval: 5用量倒计时在消息间隙也不会停摆颜色与阈值colors.*覆盖 8 个语义色位支持 256 色编号与#rrggbbcontextWarningThreshold/contextCriticalThreshold调整上下文条变色时机多配置目录覆盖$CLAUDE_CONFIG_DIR/claude-hud.json会叠加在主配置之上只写要改的键即可适合共享plugins/的团队临时关闭CLAUDE_HUD_DISABLE1 claude即可启动一个无 HUD 的会话{ statusLine: { type: command, command: ..., refreshInterval: 5 } }把最关心的信息排到视线第一行Claude HUD 就从状态栏升级成了你的会话仪表盘。现在就运行/claude-hud:configure给 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考