Claude Code 自訂狀態列產生器（cc-statusline 模式）

開著 Claude Code 卻不知道現在燒了多少錢、context 還剩多少、跑哪個模型？這個食譜替你生一條塞滿即時資訊的狀態列，目錄 / 分支 / 模型 / context 進度條 / 花費燃燒率 / 重置倒數一目了然。

[ Log in to see the full prompt ]

## 這是什麼／解決什麼痛點 Claude Code 在終端機跑，但預設的狀態資訊很少——你常常不知道「現在跑哪個模型、context 還剩多少、這個 session 已經燒了多少錢、距離用量重置還有多久」。等到 context 爆掉或額度用完才發現，已經來不及。這個食譜的作法是：替你的專案產生一條**自訂狀態列（statusline）**，把這些即時資訊全部塞進 Claude Code 介面底部那一行，隨時看得到。 ## 為什麼這來源值得用 蒸餾自 chongdashu/cc-statusline（MIT 授權），它把「狀態列產生」做成一行 `npx` 互動式 init：問你兩個偏好問題、產生一支最佳化過的 bash 腳本、自動寫進 Claude Code 的 `settings.json`，重啟就生效。值得借鏡的點有三個：①它用**原生 shell 執行**追求速度，不拖慢每次刷新；②它串接 `ccusage` 拿即時花費與 token 燃燒率，且用**檔案鎖**避免多支狀態列同時觸發、生出一堆 ccusage 行程；③它對沒裝 `jq` 的系統有 fallback，不會直接壞掉。這三點正是自己手刻狀態列最容易踩雷的地方。 ## 怎麼用（步驟／要點） 1. **設定範圍**：決定要全域（`~/.claude/`，所有專案共用）還是只在這個專案（`./.claude/`）。 2. **注入 settings.json**：在 `settings.json` 加一個 `statusLine` 區塊，`type` 設 `command`、`command` 指向你的 `statusline.sh`、`padding` 設 0。注意要「合併」進既有設定，不要整檔覆蓋。 3. **理解輸入**：Claude Code 每次刷新會把一段 JSON 從 stdin 餵給腳本，裡面有 `model`、`workspace`、`cost` 等欄位。腳本就是讀這段 JSON、解析、再輸出單行字串。 4. **裝 jq**：context 百分比、token 統計、session timer 這幾個進階欄位都靠 `jq` 解析 JSON；沒裝會降級成基本 fallback。腳本應自己偵測並給出對應平台的安裝指令。 5. **接 ccusage（選用）**：要顯示即時花費與燃燒率就透過 `npx ccusage`（免另裝），務必加檔案鎖。 6. **重啟 Claude Code** 才會套用。 最快的上手法是直接跑 `npx @chongdashu/cc-statusline@latest init` 走互動流程，再依本食譜的欄位清單微調你要顯示什麼。 ## 何時用 - 你常開長 session、想隨時盯 context 與花費，避免無預警爆掉。 - 多專案切換，想用分支 / 目錄 / 模型一眼確認「我現在在哪、用哪個模型」。 - 想要一套可重現、可進版控的團隊狀態列設定（把 `statusline.sh` 跟 `settings.json` 一起 commit）。 不適用：你只是偶爾短暫用 Claude Code、不在意用量細節，那預設就夠了，多裝反而是噪音。 📎 來源：chongdashu/cc-statusline（作者 Chong-U Lim / AIOriented，MIT 授權）— 本篇為繁中改寫整理，原始內容見上方連結。