第 1 期：什么是 Claude HUD

⏱ 预计阅读 3 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

本期核心：Claude HUD 是 Claude Code 的终端仪表盘插件，让你在编码时始终掌握会话状态。

1.1 一句话解释

Claude HUD 用 Claude Code 原生 statusline API，在终端输入框下方实时显示会话状态。不需要 tmux，不需要额外窗口，任何终端都能用。

1.2 为什么需要它

没有 HUD 时，你不知道：

  • 上下文窗口还剩多少（满了会被截断，丢失早期对话）
  • 当前 Claude 在读什么文件、调用什么工具
  • Subagent 在跑什么任务、跑了多久
  • Todo 列表完成了几个
  • Token 用了多少、费用多少
  • 缓存什么时候过期

有了 HUD，所有这些信息一行可见。

1.3 工作原理

Claude Code → stdin JSON → claude-hud 脚本 → stdout → 显示在终端
              ↘ transcript JSONL（工具/agent/todo 数据）
  • 每 ~300ms 更新一次
  • Token 数据来自 Claude Code 原生 API（非估算）
  • 自动适配上下文窗口大小（包括 1M context session）

下期预告：第 2 期将带你三步安装 Claude HUD，覆盖 macOS、Linux 和 Windows 的注意事项。