Claude HUD:让 Claude Code 的上下文进度一目了然
整理时间: 2026-03-26
来源: 群友分享 + 实战经验
整理人: AI助手(小开)
摘要
Claude HUD 是一款 Claude Code 终端插件,通过底部状态栏实时显示上下文占用百分比、模型信息、子 Agent 状态等关键数据。它解决了 AI 编程中”信息不对称”的核心问题——让开发者清楚知道 AI 在干什么、token 花了多少、什么时候该开新会话。
一、问题背景
上下文爆了,AI 就变”傻”
很多人在用 Claude Code 时会遇到这种情况:
- 写着写着突然变笨
- 前面说好的逻辑不认了
- 开始自相矛盾
其实不是模型抽风,是上下文早就爆了。
Claude Code 的上下文窗口是有限的,当 context 快满时:
- 早期对话内容会被”挤压”出去
- AI 丢失了关键背景信息
- 表现出来的就是”变笨”或”健忘”
二、Claude HUD 是什么
核心功能
在终端底部加一行状态栏,实时显示:
- 上下文占用百分比
- 当前使用模型
- 工具调用状态
- 子 Agent 进度
安装方法
在 Claude Code 中执行:
/plugin marketplace add jarrodwatts/claude-hud/plugin install claude-hud/claude-hud:setup
重启即可使用。
三、核心亮点
上下文进度条
这是最有价值的功能:
- 实时显示:不是估算,是 Claude Code 原生 token 数据
- 颜色预警:绿色→黄色→红色,渐进式提醒
- 自动展开:85% 以上自动显示明细
- 输入 token 用量
- 输出 token 用量
- 费用明细
进度含义
| 颜色 | 状态 | 建议 |
|---|---|---|
| 🟢 绿色 | 安全 | 正常继续使用 |
| 🟡 黄色 | 注意 | 开始考虑压缩/备份 |
| 🔴 红色 | 警告 | 立即压缩或开新会话 |
四、解决的问题
信息不对称
AI 工具能力都很强,但真正卡效率的是:
❌ 不知道的事:
- 上下文悄悄满了
- 子 Agent 跑偏了
- Token 烧了多少钱
✅ Claude HUD 让你知道的事:
- 实时上下文占用
- 各工具调用状态
- Token 费用明细
决策支持
有了这些数据,你可以判断:
1. 继续推进 - 上下文还充足
2. 压缩上下文 - 到了黄色警戒区
3. 开新会话 - 红色必须行动
五、评价与启示
这款插件的价值
它解决的不是高深技术问题,而是信息差问题。
好的工具不只是帮你干活,还得让你清楚它在干什么。
给我们的启示
- 数据可视化很重要 - 把抽象的 token 消耗变成可见的进度条
- 渐进式预警 - 绿→黄→红比弹窗更友好
- 让用户掌控全局 - 不是工具在用你,而是你在用它
六、相关技巧回顾
Claude Code 权限优化
每次启动不用确认的方法:
# 加一行到 ~/.bashrc 或 ~/.zshrc
echo "alias claude='claude --dangerously-skip-permissions'" >> ~/.bashrc
source ~/.bashrc
Codex 省钱攻略
50元的 Codex 5.4 比肩 100美金 Claude Opus 的技巧:
1. 优化提示词
2. 闲鱼购入团队空间套餐(关键词:codex拼车)
3. 购入多个团队空间
资源链接
- Claude HUD:https://github.com/claude-hud/claude-hud
- Claude Code 官方:https://github.com/anthropics/claude-code