Claude HUD 不显示配置与 Git 状态栏快速排查指南【免费下载链接】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 的状态栏插件实时显示上下文用量、活动工具、运行中的代理和待办进度。装完看不到、改了配置没反应、Git 状态栏空白——按下面从上往下排一遍几分钟就能定位。30 秒快速自检发消息后输入框下方什么都没出现→ 是看「HUD 整个不出现」~/.claude/settings.json里有statusLine这一项吗→ 没有还是看「HUD 整个不出现」HUD 在但 Git 分支不显示→ 是看「Git 状态栏空白排查」想要代理、待办进度但看不到→ 是看「可选信息不显示」数字、倒计时不刷新→ 是看「数字不刷新」HUD 整个不出现statusLine 没写进配置你装好了插件输入框下方却空空如也。最可能的原因没跑 setup或 statusLine 没写进 settings.json。在 Claude Code 里运行/claude-hud:setup打开~/.claude/settings.json确认存在statusLine键且 command 里包含 claude-hud随便发一条消息——HUD 只在一次交互之后才渲染仍然没出现就重启 Claude Code旧版本必须重启才加载 statusLine✅ 修好后你会看到这样的完整 Claude HUD 展开式布局改了配置不生效改了lineLayout界面却纹丝不动。大概率是配置文件位置不对或 JSON 格式坏掉了。确认配置文件路径是~/.claude/plugins/claude-hud/config.json如果设了CLAUDE_CONFIG_DIR环境变量文件在那个目录下的同名位置把文件内容粘进任意 JSON 校验工具查逗号、引号⚠️ 格式错误、文件超过 64KB、或文件是软链接时Claude HUD 会静默回退到默认配置不报任何错检查同目录下有没有claude-hud.json覆盖文件——它优先于 config.json你以为改了其实被它压住了Git 状态栏空白排查分支完全不显示HUD 有了git:(main)就是没有。多半是Git 状态被关掉了或当前目录不在 Git 仓库里。确认配置里gitStatus.enabled是true默认就是开的运行/claude-hud:configure在 Turn On 里勾选 Git status保存在项目目录手动跑git branch确认仓库本身没问题如果你用的是 Jujutsu 而不是 Git要开的是jjStatus.enabled有分支但没脏标记和文件统计分支显示了未提交变更不打星、文件数也不出来是因为默认展示极简。改config.json里这三项gitStatus: { enabled: true, showDirty: true, showFileStats: true }保存后发一条消息验证。showAheadBehind领先/落后提交数同理默认也是关的。可选信息不显示代理和待办不显示你在跑子代理、更新待办HUD 里却看不到。这不是故障——display.showAgents和display.showTodos默认都是 false。运行/claude-hud:configure在 Turn On 里勾选 Agents status 和 Todo progress保存发一条消息确认想看到工具活动的话同一位置开display.showTools。数字不刷新上下文条、重置倒计时看着不动是因为Claude Code 默认只在一次交互后才重跑状态栏命令没有自动刷新。发一条消息触发一次刷新想要自动走动在settings.json的statusLine对象里加refreshInterval: 5秒⚠️ 5 秒足够。设 1 秒意味着每次全量重跑含 git 查询大仓库会明显变卡配置项速查常用字段汇总如下完整定义在 src/types.ts 里字段作用默认值常见错误lineLayout布局expanded / compactexpanded写成 default 等非法值showSeparatorscompact 布局加分隔符false—gitStatus.enabled是否显示 Git 状态true写成 yes 而非 truegitStatus.showDirty未提交变更标记true—gitStatus.showFileStats文件级变更统计false误以为默认开display.showAgents代理状态false误以为默认开display.showTodos待办进度false误以为默认开pathLevels项目路径显示层数1写 0注意任何非法值都会被静默回退为默认值改了没效果先怀疑值本身。性能与精简嫌行数多跑/claude-hud:configure选 Minimal 预设只留模型名和上下文条把pathLevels设回 1长路径反正会被截断白占宽度showMemoryUsage、showPromptCache、showSessionTokens这类元素不用就别开每个都多一分解析和渲染开销还卡住这样求助commands/configure.md完整选项清单和预设定义确认字段名拼写src/config.ts所有配置项的默认值与校验逻辑确认每个字段的合法取值tests/回归测试与样例数据遇到边界行为时对照 fixture 看预期输出求助时附上一份关键信息在终端手动运行 settings.json 里那条 statusLine 命令记得21把输出和错误一起贴出来问题基本就暴露了。【免费下载链接】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 不显示？配置与 Git 状态栏快速排查指南
Claude HUD 不显示配置与 Git 状态栏快速排查指南【免费下载链接】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 的状态栏插件实时显示上下文用量、活动工具、运行中的代理和待办进度。装完看不到、改了配置没反应、Git 状态栏空白——按下面从上往下排一遍几分钟就能定位。30 秒快速自检发消息后输入框下方什么都没出现→ 是看「HUD 整个不出现」~/.claude/settings.json里有statusLine这一项吗→ 没有还是看「HUD 整个不出现」HUD 在但 Git 分支不显示→ 是看「Git 状态栏空白排查」想要代理、待办进度但看不到→ 是看「可选信息不显示」数字、倒计时不刷新→ 是看「数字不刷新」HUD 整个不出现statusLine 没写进配置你装好了插件输入框下方却空空如也。最可能的原因没跑 setup或 statusLine 没写进 settings.json。在 Claude Code 里运行/claude-hud:setup打开~/.claude/settings.json确认存在statusLine键且 command 里包含 claude-hud随便发一条消息——HUD 只在一次交互之后才渲染仍然没出现就重启 Claude Code旧版本必须重启才加载 statusLine✅ 修好后你会看到这样的完整 Claude HUD 展开式布局改了配置不生效改了lineLayout界面却纹丝不动。大概率是配置文件位置不对或 JSON 格式坏掉了。确认配置文件路径是~/.claude/plugins/claude-hud/config.json如果设了CLAUDE_CONFIG_DIR环境变量文件在那个目录下的同名位置把文件内容粘进任意 JSON 校验工具查逗号、引号⚠️ 格式错误、文件超过 64KB、或文件是软链接时Claude HUD 会静默回退到默认配置不报任何错检查同目录下有没有claude-hud.json覆盖文件——它优先于 config.json你以为改了其实被它压住了Git 状态栏空白排查分支完全不显示HUD 有了git:(main)就是没有。多半是Git 状态被关掉了或当前目录不在 Git 仓库里。确认配置里gitStatus.enabled是true默认就是开的运行/claude-hud:configure在 Turn On 里勾选 Git status保存在项目目录手动跑git branch确认仓库本身没问题如果你用的是 Jujutsu 而不是 Git要开的是jjStatus.enabled有分支但没脏标记和文件统计分支显示了未提交变更不打星、文件数也不出来是因为默认展示极简。改config.json里这三项gitStatus: { enabled: true, showDirty: true, showFileStats: true }保存后发一条消息验证。showAheadBehind领先/落后提交数同理默认也是关的。可选信息不显示代理和待办不显示你在跑子代理、更新待办HUD 里却看不到。这不是故障——display.showAgents和display.showTodos默认都是 false。运行/claude-hud:configure在 Turn On 里勾选 Agents status 和 Todo progress保存发一条消息确认想看到工具活动的话同一位置开display.showTools。数字不刷新上下文条、重置倒计时看着不动是因为Claude Code 默认只在一次交互后才重跑状态栏命令没有自动刷新。发一条消息触发一次刷新想要自动走动在settings.json的statusLine对象里加refreshInterval: 5秒⚠️ 5 秒足够。设 1 秒意味着每次全量重跑含 git 查询大仓库会明显变卡配置项速查常用字段汇总如下完整定义在 src/types.ts 里字段作用默认值常见错误lineLayout布局expanded / compactexpanded写成 default 等非法值showSeparatorscompact 布局加分隔符false—gitStatus.enabled是否显示 Git 状态true写成 yes 而非 truegitStatus.showDirty未提交变更标记true—gitStatus.showFileStats文件级变更统计false误以为默认开display.showAgents代理状态false误以为默认开display.showTodos待办进度false误以为默认开pathLevels项目路径显示层数1写 0注意任何非法值都会被静默回退为默认值改了没效果先怀疑值本身。性能与精简嫌行数多跑/claude-hud:configure选 Minimal 预设只留模型名和上下文条把pathLevels设回 1长路径反正会被截断白占宽度showMemoryUsage、showPromptCache、showSessionTokens这类元素不用就别开每个都多一分解析和渲染开销还卡住这样求助commands/configure.md完整选项清单和预设定义确认字段名拼写src/config.ts所有配置项的默认值与校验逻辑确认每个字段的合法取值tests/回归测试与样例数据遇到边界行为时对照 fixture 看预期输出求助时附上一份关键信息在终端手动运行 settings.json 里那条 statusLine 命令记得21把输出和错误一起贴出来问题基本就暴露了。【免费下载链接】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），仅供参考