一个让 Claude Code 顺手很多的状态栏插件:claude-hud

0 阅读3分钟

一个让 Claude Code 顺手很多的状态栏插件:claude-hud

用 Claude Code 久了,有两个问题一直让我难受。

一个是不知道当前会话还剩多少上下文。聊着聊着对话越来越长,等到模型自己跑去 compact 了才反应过来已经满了,运气不好关键信息就被截掉。每次都得手动敲一次 /context 才心里有数。

另一个是不知道额度还剩多少。Claude Max 有 5 小时的滚动窗口,还有每周配额,原生界面什么都不显示,经常写到一半被限流打断,特别影响节奏。

后来翻到 jarrodwatts 写的 claude-hud,装上之后这两个问题基本都解决了。

长这样

image-20260415085207633.png

底部那一行就是它加的。三个数字分别是:

  • Context —— 当前会话用掉的上下文百分比。我一般看到 70% 就准备 /compact 了。
  • Usage —— 当前 5 小时窗口的额度用了多少,后面跟着距离重置还有多久(图里是 resets in 4h 9m)。
  • Weekly —— 每周配额用了多少,同样带重置倒计时。

左边还顺带显示了当前模型、项目目录和 git 分支。我经常同时开好几个 worktree,这个挺有用的,至少不会切错窗口在错的分支上瞎改一通。

安装

在 Claude Code 会话里依次跑下面这几条。

添加 marketplace:

/plugin marketplace add jarrodwatts/claude-hud

安装插件:

/plugin install claude-hud

重新加载插件:

/reload-plugins

配置 statusline:

/claude-hud:setup

最后那条 /claude-hud:setup 会引导你把它配成默认 statusline。配完直接生效,不用重启。

Linux 用户在 /plugin install 之前最好先去看一下仓库 README,README 里有专门的说明。

如果你之前装过别的 statusline,可以先 /statusline 看一下当前是什么,再决定要不要换。

看到之后怎么用

数字看到了,还得知道什么时候该做什么动作。我自己的几个习惯:

Context 涨到 70% 上下,如果当前任务还没做完,就 /compact 压一下继续聊;如果手头的事已经做完了,直接 /clear 开新会话,缓存命中率反而更高。

Usage 快撑不住的时候,长任务可以临时 /model 切到便宜点的模型,或者干脆把任务拆成几段分开跑。但中途换模型会让 KV cache 失效,下一轮对话会变贵也变慢,能不切就别切。

Weekly 吃紧的时候,那些不太用脑子的活——重命名、格式化、整理文档——交给 Sonnet 或者 Haiku 就够了,没必要全用 Opus 怼。

最后

claude-hud 没做什么花活,就是把 Claude Code 本来就该让你看见的信息显示出来而已。但装完之后,那种"现在还能不能继续聊下去"的不确定感会消失,写代码的节奏明显顺很多。

如果你也是每天都在用 Claude Code 的人,挺值得装一个。