Claude Code 必装插件 - claude-hud：让你看清 AI 在干什么

大家好，我是讯享网，很高兴认识大家。

上下文快满了？Claude 在读什么文件？子 Agent 跑了多久？现在你能看到了。

用 Claude Code 写代码，最烦的是什么？

你不知道它在干什么。

上下文快满了，等报错才知道。Claude 在后台读文件，你只能干等。子 Agent 跑了 5 分钟，不知道在干嘛。

Claude HUD 解决这个问题。终端底部实时显示：上下文使用率、工具调用、Agent 状态、任务进度。

三条命令：

 
    
     
      /plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

讯享网

完成。无需重启，HUD 立即出现。

Linux 用户：如果遇到 EXDEV: cross-device link not permitted：

讯享网 
    
     
       mkdir&nbsp;-p /.cache/tmp && TMPDIR=/.cache/tmp claude

 
    
     
        [Opus | Max] │ my-project git:(main*)

模型、订阅类型、项目路径、Git 分支。

讯享网 
    
     
        Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

上下文条（绿→黄→红）+ Pro/Max 用户的速率限制。

 
    
     
        ◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2

Claude 正在编辑什么文件，读了几次，搜了几次。

讯享网 
    
     
        ◐ explore [haiku]: Finding auth code (2m 15s)

Agent 名称、模型、任务、运行时长。

 
    
     
        ▸ Fix authentication bug (²⁄₅)

当前任务，完成进度。

运行 /claude-hud:configure：

•  Full ：显示所有信息
•  Essential ：活动行 + Git，减少干扰
•  Minimal ：只显示模型和上下文条

选完预设，还能单独开关每个元素。

编辑 ~/.claude/plugins/claude-hud/config.json：

讯享网 
    
     
          {
&nbsp; “pathLevels”:&nbsp;2
}

•  1 ： my-project
•  2 ： apps/my-project
•  3 ： dev/apps/my-project

 
    
     
          {
&nbsp; “gitStatus”:&nbsp;{
&nbsp; &nbsp; “showDirty”:&nbsp;true,&nbsp; &nbsp; &nbsp; &nbsp; // * 表示未提交
&nbsp; &nbsp; “showAheadBehind”:&nbsp;true,&nbsp; // ↑2 ↓1
&nbsp; &nbsp; “showFileStats”:&nbsp;true&nbsp; &nbsp; &nbsp;// !3 +1 ?2
&nbsp; }
}

符号：! 修改，+ 新增，✘ 删除，? 未跟踪。

讯享网 
    
     
          {
&nbsp; “display”:&nbsp;{
&nbsp; &nbsp; “contextValue”:&nbsp;“percent”&nbsp; // percent | tokens | remaining
&nbsp; }
}

 
    
     
          {
&nbsp; “display”:&nbsp;{
&nbsp; &nbsp; “showTools”:&nbsp;true,
&nbsp; &nbsp; “showAgents”:&nbsp;true,
&nbsp; &nbsp; “showTodos”:&nbsp;true,
&nbsp; &nbsp; “showDuration”:&nbsp;true,
&nbsp; &nbsp; “showSpeed”:&nbsp;true
&nbsp; }
}

Pro/Max/Team 用户会看到速率限制：

讯享网 
    
     
           Usage ██░░░░░░░░ 25% (1h 30m / 5h)

使用率 ≥ 80% 时显示 7 天限制：

 
    
     
           Usage ██░░░░░░░░ 25% (1h 30m / 5h) | ██████████ 85% (2d / 7d)

API 用户按 token 付费，不显示限制。

讯享网 
    
     
              ↘ transcript JSONL" data-show-line-number="false" style="font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;"><span leaf="">Claude Code → stdin JSON → claude-hud → stdout → 终端</span><span leaf=""><br /></span><span leaf="">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;↘ transcript JSONL</span></code></pre><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 原生 token 数据（非估算）</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 解析 transcript 获取活动</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 每 300ms 更新</span></section></li></ul><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><span leaf="">无需额外窗口，无需 tmux。</span></p><hr style="border-style: solid;border-width: 2px 0 0;border-color: rgba(0, 0, 0, 0.1);-webkit-transform-origin: 0 0;-webkit-transform: scale(1, 0.5);transform-origin: 0 0;transform: scale(1, 0.5);height: 0.4em;margin: 1.5em 0;" /><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">配置不生效？</span></strong></p><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 检查 JSON 语法</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• pathLevels 必须是 1/2/3</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 删除配置重新运行&nbsp;</span><code style="font-size: 90%;color: #d14;background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;"><span leaf="">/claude-hud:configure</span></code></section></li></ul><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">Git 不显示？</span></strong></p><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 确认在 git 仓库中</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 检查&nbsp;</span><code style="font-size: 90%;color: #d14;background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;"><span leaf="">gitStatus.enabled</span></code><span leaf="">&nbsp;不是&nbsp;</span><code style="font-size: 90%;color: #d14;background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;"><span leaf="">false</span></code></section></li></ul><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">工具/Agent/Todo 不显示？</span></strong></p><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 默认隐藏，需要启用</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 只在有活动时显示</span></section></li></ul><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">使用限制不显示？</span></strong></p><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 用 Pro/Max/Team 账号登录（非 API key）</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 检查&nbsp;</span><code style="font-size: 90%;color: #d14;background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;"><span leaf="">display.showUsage</span></code><span leaf="">&nbsp;不是&nbsp;</span><code style="font-size: 90%;color: #d14;background: rgba(27, 31, 35, 0.05);padding: 3px 5px;border-radius: 4px;"><span leaf="">false</span></code></section></li></ul><hr style="border-style: solid;border-width: 2px 0 0;border-color: rgba(0, 0, 0, 0.1);-webkit-transform-origin: 0 0;-webkit-transform: scale(1, 0.5);transform-origin: 0 0;transform: scale(1, 0.5);height: 0.4em;margin: 1.5em 0;" /><section style="font-family: -apple-system-font,BlinkMacSystemFont, Helvetica Neue, PingFang SC, Hiragino Sans GB , Microsoft YaHei UI , Microsoft YaHei ,Arial,sans-serif;font-size: 16px;line-height: 1.75;text-align: left;max-width: 100%;overflow: auto;"><table style="color: #3f3f3f;margin-top: 0 !important;"><thead><tr><th style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;background: rgba(0, 0, 0, 0.05);"><section><span leaf="">方案</span></section></th><th style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;background: rgba(0, 0, 0, 0.05);"><section><span leaf="">优势</span></section></th><th style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;background: rgba(0, 0, 0, 0.05);"><section><span leaf="">劣势</span></section></th></tr></thead><tbody><tr><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">原生 Claude Code</span></section></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">无需安装</span></section></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">看不到细节</span></section></td></tr><tr><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">手动查日志</span></section></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">完整信息</span></section></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">要切窗口</span></section></td></tr><tr><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">Claude HUD</span></strong></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><strong style="color: #0F4C81;font-weight: bold;font-size: inherit;"><span leaf="">实时、原生、不碍事</span></strong></td><td style="border: 1px solid #dfdfdf;padding: 0.25em 0.5em;color: #3f3f3f;word-break: keep-all;"><section><span leaf="">要装插件</span></section></td></tr></tbody></table></section><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><span leaf="">核心优势：</span></p><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 用 Claude Code 官方 API</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 300ms 刷新</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 终端底部，不占空间</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 三种预设 + 细粒度配置</span></section></li></ul><hr style="border-style: solid;border-width: 2px 0 0;border-color: rgba(0, 0, 0, 0.1);-webkit-transform-origin: 0 0;-webkit-transform: scale(1, 0.5);transform-origin: 0 0;transform: scale(1, 0.5);height: 0.4em;margin: 1.5em 0;" /><ul style="list-style: circle;padding-left: 1em;margin-left: 0;color: #3f3f3f;" class="list-paddingleft-1"><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• GitHub：https://github.com/jarrodwatts/claude-hud</span></section></li><li style="display: block;margin: 0.2em 8px;color: #3f3f3f;"><section><span leaf="">• 许可证：MIT</span></section></li></ul></section><section style="font-family: -apple-system-font,BlinkMacSystemFont, Helvetica Neue, PingFang SC, Hiragino Sans GB , Microsoft YaHei UI , Microsoft YaHei ,Arial,sans-serif;font-size: 16px;line-height: 1.75;text-align: left;"><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><span leaf="">Claude Code 很强，但不透明。Claude HUD 让你看清它在干什么。</span></p><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><span leaf="">三条命令装完，立即生效：</span></p><pre style="color: #24292e;background: #fff;font-size: 90%;overflow-x: auto;border-radius: 8px;line-height: 1.5;margin: 10px 8px;box-shadow: inset 0 0 10px rgba(0,0,0,0.05);padding: 0 !important;"><span style="display: flex;padding: 10px 14px 0;"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" x="0px" y="0px" width="45px" height="13px" viewbox="0 0 450 130"><ellipse cx="50" cy="65" rx="50" ry="52" stroke="rgb(220,60,54)" stroke-width="2" fill="rgb(237,108,96)"></ellipse><ellipse cx="225" cy="65" rx="50" ry="52" stroke="rgb(218,151,33)" stroke-width="2" fill="rgb(247,193,81)"></ellipse><ellipse cx="400" cy="65" rx="50" ry="52" stroke="rgb(27,161,37)" stroke-width="2" fill="rgb(100,200,86)"></ellipse></svg></span><code style="font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;"><span leaf="">/plugin marketplace add jarrodwatts/claude-hud</span><span leaf=""><br /></span><span leaf="">/plugin install claude-hud</span><span leaf=""><br /></span><span leaf="">/claude-hud:setup</span></code></pre><p style="margin: 1.5em 8px;letter-spacing: 0.1em;color: #3f3f3f;"><span leaf="">上下文、工具、Agent、进度，全在终端底部。</span></p></section><p style="display: none;"><mp-style-type data-value="10000"></mp-style-type></p>

Claude Code 必装插件 - claude-hud：让你看清 AI 在干什么

相关推荐