7K+ Star 的 Claude Code 狀態欄，用過的都說絕了！

大家好，我係小智，專注AI工具、AI智能體同埋編程提效

呢個項目係咩嚟？

ccstatusline 係一個為 Claude Code CLI 設計嘅狀態欄格式化工具。簡單啲講，佢可以喺你個終端入面實時顯示模型資訊、Git 分支、Token 用量、會話數據等關鍵指標。

好多人以為狀態欄就係一行簡單嘅文字，其實唔係咁簡單。一個設計得好嘅狀態欄，可以令你對 Claude Code 嘅運行狀態一目瞭然，同時保持終端嘅整潔同可讀性。呢個就係 ccstatusline 想解決嘅問題。

核心特點

• • 🎨 高度可自訂：透過互動式 TUI 配置界面，唔使寫程式就可以自訂狀態欄
• • ⚡ 實時指標顯示：模型名稱、Git 分支、Token 使用速度、會話時長、Block 計時器等
• • 🎯 Powerline 風格：支援箭頭分隔符同自訂字型，視覺效果專業
• • 📱 多行支援：支援無限制嘅多行狀態欄佈局
• • 🌍 跨平台兼容：同時支援 Bun 同 Node.js 運行環境
• • 🔧 零配置啟動：開箱即用，提供合理嘅默認配置
• • 🎪 智能寬度檢測：自動適配終端寬度，支援彈性分隔符

安裝同快速開始

唔使安裝，直接運行

呢個係一個好好用嘅工具，完全免費。最大嘅好處係唔使安裝，直接經 npx 或 bunx 運行就得：

# 使用 npm
npx -y ccstatusline@latest

# 或使用 Bun
bunx -y ccstatusline@latest

運行之後會啟動一個互動式 TUI 配置界面。你可以喺入面選擇同配置各種 Widget（小部件）、自訂顏色同主題、調整狀態欄嘅佈局同格式。所有配置會自動保存到 ~/.config/ccstatusline/settings.json。

環境要求

• • Node.js v16+ 或 Bun
• • 支援 ANSI 顏色嘅終端
• • 可選：設置 CLAUDE_CONFIG_DIR 環境變數來自訂配置位置
• • 可選：設置 HTTPS_PROXY 嚟配置代理（用於 API 調用）

核心功能詳解

1. 模型與會話資訊 Widget

顯示當前用緊嘅 Claude 模型名稱、會話 ID、賬户郵箱等資訊。呢個對於追蹤你用緊邊個模型版本好有用。

Model: Claude 3.5 Sonnet | Session: abc123 | Email: user@example.com

2. Git 資訊 Widget

實時顯示 Git 倉庫狀態，包括當前分支名稱、暫存/未暫存嘅檔案數、衝突檔案數、最新 commit 嘅 SHA。v2.2.8 新增咗 PR 連結功能，可以直接㩒入去跳轉到 GitHub PR。仲支援 Worktree 資訊顯示。

Branch: main | Staged: 2 | Unstaged: 1 | PR: #123

3. Token 用量 Widget

呢度講多少少，Token 用量嘅實時追蹤真係好重要。你可以睇到輸入 Token 速度（tokens/sec）、輸出 Token 速度（tokens/sec），仲可以配置滾動窗口時間範圍。實測落嚟，呢個對於理解 Claude Code 嘅性能同成本好有幫助。

Input: 150 tok/s | Output: 85 tok/s

4. Block 計時器 Widget

顯示當前 Block 嘅執行時間，幫你監控長時間運行嘅操作。呢個功能睇落唔起眼，但實際用起上嚟可以幫你快速揾出性能瓶頸。

Block Timer: 2m 34s

5. 會話時長 Widget

顯示當前會話已經行咗幾耐。簡單講，就係話你知呢個會話行咗幾耐。

Session: 15m 42s

6. 自訂文字同連結 Widget

支援加任何自訂文字同埋可㩒嘅連結，令你可以喺狀態欄顯示個人化資訊。呢度有個好易中伏嘅位，大家千祈要注意，連結格式一定要符合終端支援嘅標準，如果唔係可能㩒唔到。

7. 系統指標 Widget

顯示記憶體用量、思考努力程度等系統級指標。呢啲指標可以幫你更加全面瞭解 Claude Code 嘅運行狀態。

實際效果展示

演示動畫

Emoji 標籤支援

呢個功能令你可以為每個 Widget 加 Emoji 標籤，令狀態欄更加直觀同美觀。與其自己花時間整純文字狀態欄，不如直接用 Emoji 令成個界面更生動。

Powerline 自動對齊

多行狀態欄會自動對齊，箭頭分隔符完美銜接，視覺效果專業。呢個先係一個真正用心設計嘅工具應有嘅樣子。

工作目錄與會話成本

同時顯示當前工作目錄同會話成本資訊。咁你就可以喺一個狀態欄入面睇曬所有關鍵資訊，唔使喺幾個視窗之間切來切去。

Block 計時器

清晰嘅 Block 計時器顯示。唔好睇小呢樣嘢，喺除錯長時間運行嘅任務時，佢可以幫你快速定位問題。

適合邊個用？

如果你係 Claude Code 嘅活躍用戶，呢個工具真係值得試下。無論你想簡單顯示狀態，定係需要複雜嘅多行自訂佈局，ccstatusline 都可以滿足你嘅需求。

• • 🧑‍💻 Claude Code 用戶：想更好地監控 Claude Code 運行狀態
• • 📊 數據分析師：需要實時追蹤 Token 用量同成本
• • 🔧 開發者：希望自訂終端狀態欄，提升工作效率
• • 🎨 終端美化愛好者：鍾意個性化嘅終端體驗

學習資源

• • 官方倉庫：https://github.com/sirmalloc/ccstatusline
• • NPM 包：https://www.npmjs.com/package/ccstatusline
  
  

總結

ccstatusline 就係咁樣一個工具，佢將 Claude Code CLI 嘅複雜資訊以優雅嘅方式呈而家你個終端入面。最重要係，佢開箱即用，唔使複雜配置就可以開始用，但又提供咗足夠嘅靈活性俾高級用戶做深度自訂。

如果你未試過，而家就可以運行 npx -y ccstatusline@latest 體驗下。我夠膽講，用過之後你就唔想返轉頭㗎啦。

如果呢篇文章對你有幫助，都請幫手㩒個讚👍 + 在看 啦！❤️關注小智AI指南公眾號，AI 路上唔迷路

大家好，我是小智，專注 AI 工具、AI 智能體和編程提效

這個項目是什麼？

ccstatusline 是一個為 Claude Code CLI 設計的狀態欄格式化工具。簡單來說，它能在你的終端中實時顯示模型信息、Git 分支、Token 使用情況、會話數據等關鍵指標。

很多人以為狀態欄就是一行簡單的文字，其實不然。一個設計得好的狀態欄，能讓你對 Claude Code 的運行狀態一目瞭然，同時保持終端的整潔和可讀性。這就是 ccstatusline 要解決的問題。

核心特點

• • 🎨 高度可定製：通過交互式 TUI 配置界面，無需編寫代碼即可自定義狀態欄
• • ⚡ 實時指標顯示：模型名稱、Git 分支、Token 使用速度、會話時長、Block 計時器等
• • 🎯 Powerline 風格：支持箭頭分隔符和自定義字體，視覺效果專業
• • 📱 多行支持：支持無限制的多行狀態欄佈局
• • 🌍 跨平台兼容：同時支持 Bun 和 Node.js 運行環境
• • 🔧 零配置啓動：開箱即用，提供合理的默認配置
• • 🎪 智能寬度檢測：自動適配終端寬度，支持彈性分隔符

安裝與快速開始

無需安裝，直接運行

這是一個非常好用的工具，完全免費。最大的優勢就是無需安裝，直接通過 npx 或 bunx 運行：

# 使用 npm
npx -y ccstatusline@latest

# 或使用 Bun
bunx -y ccstatusline@latest

運行後會啓動一個交互式 TUI 配置界面。你可以在其中選擇和配置各種 Widget（小部件）、自定義顏色和主題、調整狀態欄的佈局和格式。所有配置會自動保存到 ~/.config/ccstatusline/settings.json。

環境要求

• • Node.js v16+ 或 Bun
• • 支持 ANSI 顏色的終端
• • 可選：設置 CLAUDE_CONFIG_DIR 環境變量來自定義配置位置
• • 可選：設置 HTTPS_PROXY 來配置代理（用於 API 調用）

核心功能詳解

1. 模型與會話信息 Widget

顯示當前使用的 Claude 模型名稱、會話 ID、賬户郵箱等信息。這對於追蹤你正在使用的模型版本非常有用。

Model: Claude 3.5 Sonnet | Session: abc123 | Email: user@example.com

2. Git 信息 Widget

實時顯示 Git 倉庫狀態，包括當前分支名稱、暫存/未暫存的文件數、衝突文件數、最新提交的 SHA。v2.2.8 新增了 PR 連結功能，可以直接點擊跳轉到 GitHub PR。還支持 Worktree 信息顯示。

Branch: main | Staged: 2 | Unstaged: 1 | PR: #123

3. Token 使用情況 Widget

這裏多說一句，Token 使用情況的實時追蹤確實很重要。你可以看到輸入 Token 速度（tokens/sec）、輸出 Token 速度（tokens/sec），還能配置滾動窗口時間範圍。實測下來，這對於理解 Claude Code 的性能和成本非常有幫助。

Input: 150 tok/s | Output: 85 tok/s

4. Block 計時器 Widget

顯示當前 Block 的執行時間，幫助你監控長時間運行的操作。這個功能看起來不起眼，但在實際使用中能幫你快速定位性能瓶頸。

Block Timer: 2m 34s

5. 會話時長 Widget

顯示當前會話已運行的時間。簡單來說，就是讓你知道這個會話已經跑了多久。

Session: 15m 42s

6. 自定義文本與連結 Widget

支持添加任意自定義文本和可點擊的連結，讓你可以在狀態欄中顯示個性化信息。這裏有個很容易踩坑的地方，大家千萬注意，連結格式必須符合終端支持的標準，否則可能無法點擊。

7. 系統指標 Widget

顯示內存使用情況、思考努力程度等系統級指標。這些指標能幫你更全面地瞭解 Claude Code 的運行狀態。

實際效果展示

演示動畫

Emoji 標籤支持

這個功能讓你可以為每個 Widget 添加 Emoji 標籤，使狀態欄更加直觀和美觀。與其自己費勁折騰純文本狀態欄，不如直接用 Emoji 讓整個界面更生動。

Powerline 自動對齊

多行狀態欄會自動對齊，箭頭分隔符完美銜接，視覺效果專業。這就對了，這才是一個真正用心設計的工具該有的樣子。

工作目錄與會話成本

同時顯示當前工作目錄和會話成本信息。這樣你就能在一個狀態欄裏看到所有關鍵信息，不用在多個窗口之間切換。

Block 計時器

清晰的 Block 計時器顯示。別看這玩意兒不起眼，但在調試長時間運行的任務時，它能幫你快速定位問題。

適合誰用？

如果你是 Claude Code 的活躍用戶，這個工具真的值得試一試。不管你是想要簡單的狀態顯示，還是需要複雜的多行自定義佈局，ccstatusline 都能滿足你的需求。

• • 🧑‍💻 Claude Code 用戶：想要更好地監控 Claude Code 運行狀態
• • 📊 數據分析師：需要實時追蹤 Token 使用和成本
• • 🔧 開發者：希望自定義終端狀態欄，提升工作效率
• • 🎨 終端美化愛好者：喜歡定製化的終端體驗

學習資源

• • 官方倉庫：https://github.com/sirmalloc/ccstatusline
• • NPM 包：https://www.npmjs.com/package/ccstatusline
  
  

總結

ccstatusline 就是這樣一個工具，它將 Claude Code CLI 的複雜信息以優雅的方式呈現在你的終端中。最重要的是，它開箱即用，無需複雜的配置就能開始使用，但又提供了足夠的靈活性讓高級用戶進行深度定製。

如果你還沒試過，現在就可以運行 npx -y ccstatusline@latest 體驗一下。我敢打賭，用過之後你就不想回到沒有它的日子了。

如果本文對您有幫助，也請幫忙點個 贊👍 + 在看 哈！❤️關注小智AI指南公眾號，AI 路上不迷路