10分钟上手best-claude-hud从安装到自定义的快速入门指南【免费下载链接】best-claude-hudMinimal Claude Code statusline HUD powered by Rust.项目地址: https://gitcode.com/gh_mirrors/be/best-claude-hudbest-claude-hud是一款用Rust编写的高性能Claude Code状态栏工具它能在终端中显示使用Claude Code时真正需要的状态信息包括模型和实时推理工作量、工作区、Git分支/状态、上下文窗口使用情况以及可选的使用/速率限制元数据。快速了解best-claude-hudbest-claude-hud作为一款Minimal Claude Code statusline HUD默认状态栏专注于以下核心功能显示Claude模型并在可用时显示实时推理工作量Claude Code启动目录在临时工作目录更改时保持稳定Git分支、干净/脏/冲突状态以及超前/落后计数来自Claude Code官方statusLine数据的上下文窗口使用情况带有活动转录本回退可选的使用/速率限制、成本、会话和输出样式段一键安装步骤best-claude-hud通过npm分发npm包使用预构建的原生二进制文件用户无需安装Rust。使用npm安装一行命令安装并配置Claude Codenpm install -g best-claude-hudlatest best-claude-hud --setup安装完成后需要重启Claude Code现有会话不会自动重新加载~/.claude/settings.json。仅安装npm install -g best-claude-hudlatest使用yarn或pnpm安装yarn global add best-claude-hudlatest pnpm add -g best-claude-hudlatest中国用户专用安装命令npm install -g best-claude-hudlatest --registry https://registry.npmmirror.com best-claude-hud --setup更新现有安装npm update -g best-claude-hud卸载npm uninstall -g best-claude-hudNix安装方法best-claude-hud还提供了Nix flake用于声明式和可重现的环境。无需全局安装即可运行nix run github:GaoSSR/best-claude-hud -- --help安装到Nix配置文件nix profile install github:GaoSSR/best-claude-hud best-claude-hud --setup配置Claude Codenpm install -g best-claude-hudlatest仅安装命令在配置statusLine之前Claude Code不会显示HUD。推荐使用以下命令进行配置best-claude-hud --setupsetup命令将statusLine块写入~/.claude/settings.json并保留现有设置。它会在可能的情况下将已安装的命令解析为绝对路径{ statusLine: { type: command, command: /path/to/best-claude-hud, padding: 0 } }如果Claude Code会话继承与shell相同的PATH手动配置也可以使用command: best-claude-hud。如果statusLine已存在--setup会在替换之前在settings.json旁边创建带时间戳的备份。更改此文件后重启Claude Code。常用命令速查表best-claude-hud # 在终端中运行时打开交互式菜单 best-claude-hud --help # 打印命令帮助 best-claude-hud --version # 打印版本 best-claude-hud --setup # 配置Claude Code statusLine best-claude-hud --config # 打开TUI配置界面 best-claude-hud --theme minimal # 使用内置主题临时渲染 best-claude-hud --patch cli.js # 修补Claude Code cli.js上下文警告主题自定义打造个性化状态栏临时覆盖已配置的主题best-claude-hud --theme cometix best-claude-hud --theme minimal best-claude-hud --theme gruvbox best-claude-hud --theme nord best-claude-hud --theme powerline-dark best-claude-hud --theme powerline-light best-claude-hud --theme powerline-rose-pine best-claude-hud --theme powerline-tokyo-night使用自定义主题自定义主题可以存储在以下目录~/.claude/best-claude-hud/themes/然后使用best-claude-hud --theme my-custom-theme配置文件位置与结构配置文件存储在~/.claude/best-claude-hud/重要文件config.toml主要HUD和段配置models.toml模型显示名称和上下文窗口限制themes/*.toml自定义主题预设.api_usage_cache.json可选的使用API缓存.update_state.json更新检查状态运行TUI配置器best-claude-hud --config可用的段系列modeldirectorygitcontext_windowusagecostsessionoutput_styleupdate模型配置自定义模型显示与上下文限制models.toml在首次运行时自动创建~/.claude/best-claude-hud/models.toml它控制模型显示名称和上下文限制。Claude模型系列会自动识别而第三方模型可以自定义[[models]] pattern kimi-k2.7 display_name Kimi K2.7 context_limit 262144 [[models]] pattern glm-5 display_name GLM-5 context_limit 200000 [[models]] pattern qwen3-coder display_name Qwen Coder context_limit 256000 [[context_modifiers]] pattern [1m] display_suffix 1M context_limit 1000000Git状态指示器说明✓: 干净的工作树●: 脏的工作树⚠: 冲突↑n: 提交超前于上游↓n: 提交落后于上游Git命令使用--no-optional-locks运行因此HUD在您工作时不会创建不必要的.git/index.lock争用。系统要求支持statusLine的Claude Code用于分支/状态显示的Git支持ANSI颜色的终端如果选择Nerd Font或Powerline主题则需要Nerd Font项目资源变更日志贡献指南发布流程安全政策上游分类【免费下载链接】best-claude-hudMinimal Claude Code statusline HUD powered by Rust.项目地址: https://gitcode.com/gh_mirrors/be/best-claude-hud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考