Claude Code 自定義狀態欄腳本進階:底部實時顯示 Git 分支、未提交改動數、當前模型與累計花費

不止 /statusline 預設一行字:本文按 Claude Code 官方狀態欄文檔,提供跨平台 Python 與 Bash 進階腳本模板,實時在終端底部顯示當前模型、上下文佔比、Git 分支、未提交文件數與會話估算花費。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Pro 帳號

結論先說

  1. 狀態欄是本地標準輸入輸出管道,不消耗任何 API Token:Claude Code 在消息更新時把會話 JSON 從 stdin 傳給腳本,腳本向 stdout 打印什麼,底部就顯示什麼。
  2. 查 Git 狀態務必加上 --no-optional-locks 參數:狀態欄高頻觸發,不加該參數容易與手動執行的 git commit 爭搶 .git/index.lock 文件鎖。
  3. 跨平台推薦用 Python 標準庫腳本代替 jq + bc:Windows 預設沒裝 jq,一段 20 多行的 Python 腳本在三大系統上都能直接運行。
  4. 所有讀取字段都要做空值兜底:首輪對話收到響應前,上下文與限額字段可能為 null,不兜底會導致狀態欄整行空白。
  5. 盯緊底部窗口占比,高頻開發提前備足訂閱:看到 5 小時限額頻繁逼近高位時,國內無外幣卡用戶可通過本站 Claude Code 訂閱專區 或 Claude Max 訂閱服務 升級配額。

Claude Code 狀態欄從 stdin JSON 到終端渲染的數據流

圖:本站根據 Claude Code 官方文檔:Customize your status line 整理的示意圖

本文根據 Claude Code 官方文檔《Customize your status line》《Claude Code settings》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 同時開多個終端窗口或工作樹寫代碼,想一眼看清當前在哪個分支、還有幾個文件未提交的開發者;
  • 覺得 /statusline 預設生成樣式資訊太少,想自己拼裝模型名、上下文進度、累計花費與窗口占比的人;
  • 在 Windows 或 macOS 手寫狀態欄腳本後遇到空白不顯示、路徑反斜槓報錯或爭搶 .git/index.lock 的用戶。

一、核心字段與 settings.json 掛載寫法

/statusline 一句話自動生成的基礎用法見 Claude Code 狀態欄怎麼配置。進階手寫腳本時,在 ~/.claude/settings.json 中指向腳本路徑(優先級規則見 Claude Code settings.json 配置詳解):

json
{
  "statusLine": {
    "type": "command",
    "command": "python3 ~/.claude/statusline.py",
    "padding": 1
  }
}

拼裝研發狀態欄最常用的四個官方 stdin JSON 字段如下:

展示項官方 JSON 字段路徑空值與統計口徑說明
當前模型名model.display_name如 Opus、Sonnet,缺省可兜底為 "Claude"
當前目錄workspace.current_dir傳給 git -C 查詢當前分支與未提交改動數
上下文佔比context_window.used_percentage僅含輸入與緩存 token,首輪響應前可能為 null
估算花費與限額cost.total_cost_usd / rate_limits.five_hour.used_percentagecost 為標價估算;Pro/Max 訂閱才返回 rate_limits

關於 /cost 與訂閱額度統計差異,可對照 Claude Code 怎麼看花了多少錢和 token。

二、直接複製可用:跨平台 Python 狀態欄模板

將下面腳本儲存為 ~/.claude/statusline.py(Windows 儲存在用戶目錄 .claude/statusline.py,把配置裏的 python3 改為 python,路徑統一用正斜槓 /):

python
#!/usr/bin/env python3
import json, subprocess, sys

d = json.load(sys.stdin)
model = (d.get("model") or {}).get("display_name") or "Claude"
cwd = (d.get("workspace") or {}).get("current_dir") or "."
ctx = int((d.get("context_window") or {}).get("used_percentage") or 0)
cost = float((d.get("cost") or {}).get("total_cost_usd") or 0.0)
fh = ((d.get("rate_limits") or {}).get("five_hour") or {}).get("used_percentage")

git_tag = ""
try:
    br = subprocess.check_output(
        ["git", "-C", cwd, "--no-optional-locks", "branch", "--show-current"],
        stderr=subprocess.DEVNULL, text=True, timeout=0.4
    ).strip()
    if br:
        st = subprocess.check_output(
            ["git", "-C", cwd, "--no-optional-locks", "status", "--porcelain", "-uno"],
            stderr=subprocess.DEVNULL, text=True, timeout=0.4
        ).splitlines()
        mark = f" *{len(st)}" if st else ""
        git_tag = f" | {br}{mark}"
except Exception:
    pass

q_tag = f" | 5h:{int(fh)}%" if fh is not None else ""
print(f"[{model}]{git_tag} | ctx:{ctx}% | ${cost:.3f}{q_tag}")

儲存後 Claude Code 會自動重載配置,底部會實時渲染形如 [Sonnet] | feat/login 2 | ctx:28% | $0.064 | 5h:15% 的狀態條,其中 2 表示有 2 個已跟蹤文件待提交。

訂閱與帳號準備提示:當底部狀態欄的 5h 用量百分比經常衝高受限,說明單份基礎配額已跟不上高頻編碼節奏。國內開發者無需境外信用卡,可在本站選購 Claude Pro iOS 免上號自助卡密(無需交出密碼)或升級更高倍率的 Claude Max 訂閱服務。

三、狀態欄空白或報錯的四步排查決策

自定義狀態欄空白或報錯的四步排查決策

圖:本站根據 Claude Code 官方文檔:Customize your status line 整理的排錯示意圖

若儲存後底部沒有顯示任何內容,先在終端單獨喂一段測試數據驗證腳本能否正常打印:

bash
echo '{"model":{"display_name":"Sonnet"}}' | python3 ~/.claude/statusline.py

若終端報錯 jq: command not found 或 Python 找不到路徑,補裝對應解釋器或改用絕對路徑即可;若在大倉庫裏感覺刷新卡頓,保留模板裏的 -uno(忽略未跟蹤文件掃描)與 timeout=0.4 超時保護就能徹底解決。

常見問題

問:為什麼在 Windows 的 settings.json 裏寫反斜槓路徑不生效?

答:官方文檔說明,Windows 安裝了 Git Bash 時預設通過 Git Bash 調用狀態欄命令,未轉義的反斜槓 \ 會被當作轉義符吞掉。統一寫成 python ~/.claude/statusline.py 正斜槓格式即可。

問:狀態欄裏的 $0.120 會從我的 Pro 訂閱裏額外扣錢嗎?

答:不會。官方寫明 cost.total_cost_usd 只是按公開 API 標價在本地估算的參考數字;Pro 和 Max 訂閱按時間窗口計算配額,未開啟額外按量付費時不會產生單筆扣款。

問:想暫時關掉自定義狀態欄怎麼操作?

答:在對話裏輸入 /statusline remove 讓它自動清理,或者直接刪掉 settings.json 裏的 statusLine 字段儲存即可立即恢復預設介面。

問:國內沒有外幣卡,或者公司採購 Claude Code 需要報銷開增值稅發票怎麼辦理?

答:可通過本站 AI 會員充值總覽 或 Claude Code 訂閱頁 辦理,支持支付寶、微信支付及 AlipayHK,提供免交密碼的自助卡密兌換與團隊方案,並可按需開具國內報銷用的增值稅發票。實時價格以頁面展示為準;訂閱期內若掉訂閱按剩餘天數折退,因違反官方條款導致的封號不在質保範圍內。

相關教學

參考資料

  • Claude Code 官方文檔:Customize your status line — https://code.claude.com/docs/en/statusline
  • Claude Code 官方文檔:Claude Code settings — https://code.claude.com/docs/en/settings

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~