sirmalloc/ccstatusline

🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

什麼是 ccstatusline？

ccstatusline 是一個 Node.js 套件，為 Claude Code 命令列介面（Anthropic 的 Claude 模型官方 CLI）新增一個高度可自訂的狀態列。它從 Claude Code 讀取資料，例如目前的模型、token 使用量、git 資訊、沙箱狀態等，並以色彩豐富、可設定的方式在終端機底部呈現。

為什麼你需要它

即時 AI 會話指標 – 無需離開終端機即可查看已使用的 token 數量、剩餘的上下文、每週使用量。
Git 整合 – 顯示分支名稱、PR/MR 連結、檔案狀態計數、CI 狀態，與 AI 資訊並列顯示。
高度可調 – 可選擇顯示哪些小工具、它們的順序、顏色、漸層、Powerline 分隔符，甚至最小化模式的原始值。
跨平台 – 支援 macOS、Linux 和 Windows（特殊處理以隱藏輔助視窗）。
可匯出設定 – 設定可儲存或從 JSON 讀取，方便在多台機器間共用佈局。

核心功能（如 README 所述）

類別	小工具 / 功能
模型與使用情況	模型名稱、輸入/輸出 token、總 token 數、使用比例、每週使用量、額外使用（按需付費）小工具、上下文視窗大小、壓縮計數器、快取命中/讀取/寫入率。
Git 與 CI	分支名稱、根目錄、PR/MR 連結（GitHub 與 GitLab）、狀態（領先/落後、衝突、已暫存/未暫存/未追蹤檔案）、CI 檢查摘要、可點擊連結、寬度限制顯示並帶省略號。
環境	目前工作目錄（可選符號）、沙箱狀態、語音輸入狀態、Claude 帳戶郵件、會話名稱、記憶體使用量、終端機寬度覆蓋。
視覺	Powerline 和彈性分隔符、每個小工具或整列的顏色漸層、自訂符號、暗色樣式、極簡原始值模式、漸層預設、自訂 Unicode 分隔符。
控制	用於新增、重新排序、複製或刪除小工具的 TUI 編輯器；模糊小工具選擇器；顏色選擇器；設定匯入/匯出；版本標誌（`ccstatusline --version`）。
效能	使用磁碟快取進行非阻塞 Git/CI 刷新、背景刷新過期資料、快取的區塊計時器指標、可設定的快取 TTL、對無效 `settings.json` 的安全處理。
平台優化	Windows UTF-8 處理、隱藏輔助程序、使用量 API 的環境變數代理支援、對固定全域安裝的安全處理。

如何快速上手

安裝 – npm i -g ccstatusline（或使用 Bun）。該套件附帶支援平台的預先建置二進位檔。
執行 – 安裝後，啟動 Claude Code CLI 時狀態列會自動出現。你也可以直接呼叫 ccstatusline 來預覽設定。
設定 – 在 TUI 中按 e 開啟編輯器，新增或刪除小工具、變更顏色，或切換到 Powerline 模式。設定儲存在 ~/.config/ccstatusline/settings.json（或透過 --config 指定自訂路徑）。
匯出 / 匯入 – 使用 Config import/export 小工具（v2.2.27）將目前佈局匯出為 JSON，編輯後重新匯入。

由誰維護？

該倉儲由 sirmalloc 擁有，顯示活躍維護（頻繁發佈、提交活動圖、以及「Maintained? yes」徽章）。它也被列入 Awesome Claude Code 收集，並被 ClaudeLog 知識庫引用。

授權

MIT – 您可自由使用、修改和重新分發程式碼。

TL;DR

ccstatusline 是一個終端 UI 插件，將 Claude Code CLI 轉化為儀表板，顯示模型使用情況、Git 上下文、CI 狀態和許多其他指標，所有內容均可透過基於 JSON 的 TUI 高度配置。它是開發者在終端中使用 Claude 時真正、活躍維護的開源工具。