为 Claude Code CLI 提供可高度定制的状态栏,显示模型、Git 分支、Token 用量等信息。
GaoSSR/best-claude-hud
用 Rust 编写的 Claude Code 极简状态栏,在终端中显示模型、Git 状态、工作目录和上下文用量。
- Star
- 1,074
- Fork
- 34
- 未关闭 Issue
- 0
- 最近提交
- 2个月前
这是什么?
best-claude-hud 是一个为 Claude Code(终端编程助手)设计的状态栏工具,显示在界面底部。它可以展示当前模型及推理强度、启动目录、Git 分支与干净、未提交或冲突状态,以及上下文窗口的使用比例。
该工具使用 Rust 编写,通过 npm 分发预编译的原生二进制文件,用户无需安装 Rust。运行 `best-claude-hud --setup` 即可把 statusLine 配置写入 ~/.claude/settings.json,并保留原有设置。支持 macOS(arm64、x64)、Linux x64(musl)和 Windows x64。
可通过 TUI 配置界面、config.toml 文件以及内置或自定义主题进行调整,主题包括 Nerd Font 和 Powerline 风格。可选模块涵盖用量与速率限制、费用、会话和输出风格。第三方模型的显示名称和上下文上限也可以自定义。
核心功能
- 01显示当前模型及实时推理强度
- 02展示 Git 分支、干净/未提交/冲突状态及领先落后提交数
- 03基于 Claude Code 的 statusLine 数据显示上下文窗口用量
- 04通过 npm 安装预编译二进制,无需 Rust 环境
- 05提供内置主题和 TUI 配置界面
适用场景
- 在较长的 Claude Code 会话中监控上下文窗口用量
- 无需离开终端即可查看 Git 分支和工作区状态
- 为多个模型(包括第三方模型)自定义状态栏显示
快速上手
- 1
一行命令安装并配置 Claude Code
npm install -g best-claude-hud@latest && best-claude-hud --setup - 2
重启 Claude Code 以加载新设置
使用前须知
- 需要支持 statusLine 的 Claude Code,并需要 Git 来显示分支信息。
- 使用 Nerd Font 或 Powerline 主题时,终端需要安装 Nerd Font。
- 暂不支持 Linux arm64 和 Windows arm64。
标签
常见问题
- best-claude-hud 是什么?
- 用 Rust 编写的 Claude Code 极简状态栏,在终端中显示模型、Git 状态、工作目录和上下文用量。 best-claude-hud 是一个为 Claude Code(终端编程助手)设计的状态栏工具,显示在界面底部。它可以展示当前模型及推理强度、启动目录、Git 分支与干净、未提交或冲突状态,以及上下文窗口的使用比例。
- best-claude-hud 可以免费使用吗?用的什么许可证?
- best-claude-hud 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- best-claude-hud 还在维护吗?
- 半年内有更新。best-claude-hud 最近一次提交是在 2026年8月13日。
- best-claude-hud 适合用来做什么?
- 在较长的 Claude Code 会话中监控上下文窗口用量 无需离开终端即可查看 Git 分支和工作区状态 为多个模型(包括第三方模型)自定义状态栏显示
- best-claude-hud 怎么安装和运行?
- 一行命令安装并配置 Claude Code: npm install -g best-claude-hud@latest && best-claude-hud --setup 重启 Claude Code 以加载新设置
- 在哪里获取 best-claude-hud?
- 源代码和安装说明在 GitHub 上:https://github.com/GaoSSR/best-claude-hud
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
Claude Code 插件,在输入框下方实时显示上下文用量、速率限制、工具、子代理和待办进度。
基于 libghostty 的 macOS 原生终端,提供垂直标签页、AI 编程代理通知和可编程 CLI,适合并行运行多个编程代理。
类似 btop 的终端监控工具,实时查看 Claude Code、Codex CLI 和 OpenCode 会话的 token、上下文和端口。
带 vim 键位的终端代码审查工具,可将评论推送到主流代码托管平台或复制到剪贴板。