Repolode
GaoSSR

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. 1

    一行命令安装并配置 Claude Code

    npm install -g best-claude-hud@latest && best-claude-hud --setup
  2. 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 数据每日更新。

相关项目