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

圖:本站根據 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_percentage | cost 為標價估算;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 狀態欄怎麼配置:/statusline 一句話生成,顯示模型、上下文佔用和 5 小時 / 7 天用量
- Claude Code 怎麼看花了多少錢和 token:/cost、/context 與訂閱帳號 /status 用量查看區別
- Claude Code settings.json 配置詳解:文件位置、優先級與常用示例
參考資料
- 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
0 條評論
還沒有評論,來搶沙發~