GaoSSR/best-claude-hud 是什麼？

一個基於 Rust 的最小 Claude Code 狀態列 HUD，顯示模型、推理努力、目錄、Git 與上下文視窗資料，可透過 npm 或 Nix 安裝。聚焦本專案的實際功能、技術入口、部署條件、資料流、版本變化與授權邊界，並依官方 README 所列能力判斷適用工作情境和不適合的替代用途。

GaoSSR/best-claude-hud 可以商用嗎？

可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。

GaoSSR/best-claude-hud 還在維護嗎？

有在維護。儲存庫最近一次提交在 34 天前。

GaoSSR/best-claude-hud 是用什麼程式語言寫的？

主要是 Rust（依據 GitHub 的語言統計）。

best-claude-hud：以 Rust 編寫的 Claude Code 狀態列

秒懂

它是什麼？: 一個基於 Rust 的最小 Claude Code 狀態列 HUD，顯示模型、推理努力、目錄、Git 與上下文視窗資料，可透過 npm 或 Nix 安裝。聚焦本專案的實際功能、技術入口、部署條件、資料流、版本變化與授權邊界，並依官方 README 所列能力判斷適用工作情境和不適合的替代用途。
適合誰用？: best-claude-hud 讀取 Claude Code 的 statusLine 資料並渲染可設定的狀態列。setup 指令會將 statusLine 區塊寫入 ~/.claude/settings.json，專案採用 Apache-2.0 授權。
可以商用嗎？: 可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
還在維護嗎？: 有在維護。儲存庫最近一次提交在 34 天前。
用什麼語言寫的？: 主要是 Rust（依據 GitHub 的語言統計）。

以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。

開源專案深度解析

Hysen Labs 編輯部 · 2026年8月8日 · GaoSSR/best-claude-hud

gaossr-best-claude-hud-deep-analysis｜預設狀態列內容

gaossr-best-claude-hud-deep-analysis｜預設狀態列內容的專案脈絡：best-claude-hud 是一個以 Rust 編寫的程式，作為 Claude Code 的狀態列。其預設顯示包括 Claude 模型名稱（當模型支援時附帶即時推理努力）、Claude Code 啟動目錄（在暫時工作目錄變更時保持穩定）、Git 分支及乾淨/髒/衝突狀態與領先/落後計數，以及從 Claude Code 官方 statusLine 資料中讀取的上下文視窗使用量，並帶有活動轉錄回退。可選區段新增使用量/速率限製、成本、工作階段與輸出樣式資訊。README 將這些列為預設狀態列的重點。

gaossr-best-claude-hud-deep-analysis｜透過 npm 和 Nix 安裝

gaossr-best-claude-hud-deep-analysis｜透過 npm 和 Nix 安裝的專案脈絡：npm 套件 best-claude-hud 捆綁了預編譯的原生二進位檔，因此不需要 Rust。一行設定指令為 `npm install -g best-claude-hud@latest && best-claude-hud --setup`。setup 指令會將 statusLine 區塊寫入 ~/.claude/settings.json，同時保留現有設定，並盡可能將安裝指令解析為絕對路徑。README 也提供了面向中國使用者的 npm 鏡像登錄檔指令。專案同時提供 Nix flake：`nix run github:GaoSSR/best-claude-hud -- --help` 無需全域安裝即可執行，`nix profile install github:GaoSSR/best-claude-hud` 則安裝到 profile。README 中的 home-manager 範例管理整個 settings.json 檔案，因此僅適用於新檔案或所有設定都已在 Nix 中宣告的情況。

gaossr-best-claude-hud-deep-analysis｜設定檔與自訂模型

gaossr-best-claude-hud-deep-analysis｜設定檔與自訂模型的專案脈絡：設定檔位於 ~/.claude/best-claude-hud/ 下。重要檔案包括 config.toml（HUD 與區段設定）、models.toml（模型顯示名稱與上下文限製）、themes/*.toml（自訂主題預設），以及 .api_usage_cache.json 與 .update_state.json。使用 `best-claude-hud --config` 開啟 TUI 設定器。models.toml 在首次執行時自動建立，控製模型顯示名稱與上下文限製。Claude 模型系列自動識別，第三方模型可透過 pattern、display_name 與 context_limit 條目自訂。README 提供了 Kimi、GLM、Qwen 以及類似 [1m] 的上下文修飾符範例，該修飾符新增後綴並改變限製。

gaossr-best-claude-hud-deep-analysis｜狀態列如何讀取 Claude Code 資料

gaossr-best-claude-hud-deep-analysis｜狀態列如何讀取 Claude Code 資料的專案脈絡：Claude Code 透過標準輸入向指令傳送 statusLine 資料。best-claude-hud 讀取 model、effort.level、workspace.project_dir（回退到 workspace.current_dir）、transcript_path、session_id、context_window、cost、output_style 與 rate_limits。努力項跟隨模型名稱，帶有一個大腦圖示，顯示 low、medium、high、xhigh、max 或 ultracode。README 解釋，官方負載將 Ultracode 回報為 xhigh，因此 HUD 僅交叉檢查目前 Claude Code 處理程序中成功的 /effort 事件。對於上下文視窗使用量，它優先使用官方的 context_window 欄位，僅當這些欄位缺失、為空或暫時為零時才使用活動轉錄作為回退。回應中斷後寫入的全零佔位符會被忽略，因此按 Esc 不會抹掉最後一個有效上下文讀數。

gaossr-best-claude-hud-deep-analysis｜Git 指示符與 cli.js 修補工具

gaossr-best-claude-hud-deep-analysis｜Git 指示符與 cli.js 修補工具的專案脈絡：Git 狀態符號包括：勾號表示乾淨工作樹，實心圓表示髒工作樹，警告表示衝突，上/下箭頭帶數字表示領先/落後於上游提交數。Git 指令使用 --no-optional-locks 執行，避免 .git/index.lock 競爭。該工具也包含一個修補程式，可修改 Claude Code 的 cli.js 以減少上下文警告噪音。指令為 `best-claude-hud --patch /path/to/claude-code/cli.js`。README 展示了 fnm node 版本下的範例路徑。修補程式在寫入前會在目標檔案旁建立備份。

gaossr-best-claude-hud-deep-analysis｜支援的平台與需求

gaossr-best-claude-hud-deep-analysis｜支援的平台與需求的專案脈絡：README 列出支援的平台包括 macOS arm64 與 x64、Linux x64 musl 與 Windows x64，每個平台由 npm 自動選擇對應的原生二進位。Linux arm64 與 Windows arm64 尚在計畫中。需求包括支援 statusLine 的 Claude Code、用於分支與狀態顯示的 Git、支援 ANSI 顏色的終端，以及使用 Nerd Font 或 Powerline 主題時所需的 Nerd Font。README 未指定 Claude Code 或 Git 的最低版本。

gaossr-best-claude-hud-deep-analysis｜授權與維護工作流程

gaossr-best-claude-hud-deep-analysis｜授權與維護工作流程的專案脈絡：該專案採用 Apache-2.0 授權。授權文字授予永久的、全球性的、非排他性的、免費的、免版稅的版權授權，允許複製、準備衍生作品、公開展示、表演、再授權與分發作品及衍生作品。它也根據特定條件授予專利授權。授權不提供任何擔保或安全保證。對於維護者，README 列出了 cargo fmt、cargo clippy -- -D warnings、cargo test、cargo build --release 以及 npm 檢查指令。發布流程記錄在 RELEASING.md 中，涵蓋版本更新、Git 標籤、GitHub Releases、npm 發布與安裝升級。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出的專案脈絡：第1項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第2項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第3項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第4項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第5項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第6項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第7項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第8項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第9項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

gaossr-best-claude-hud-deep-analysis｜以專案指令核對實際輸出：第10項檢查：best-claude-hud 的核心輸入是 Claude Code statusLine 透過標準輸入傳來的 JSON。安裝後執行 best-claude-hud --setup，檢查 ~/.claude/settings.json 是否保留原設定並寫入 statusLine，再重新啟動 Claude Code。以 config.toml、models.toml 和 themes/*.toml 分別測試區段、第三方模型名稱、上下文限制及主題。Git 狀態則要在乾淨、未提交、衝突和 ahead/behind 四種工作樹確認。README 沒有指定 Claude Code 或 Git 最低版本，這些相容性仍需在團隊環境確認。

編輯結論

best-claude-hud 讀取 Claude Code 的 statusLine 資料並渲染可設定的狀態列。setup 指令會將 statusLine 區塊寫入 ~/.claude/settings.json，專案採用 Apache-2.0 授權。

官方來源

社群筆記