成本追蹤 是做什麼的？
使用這項技能來分析來自 ECC 的 stop:cost-tracker 掛鉤所寫入的指標日誌，以取得 Claude Code 的成本與用量歷史。
資料存放位置
追蹤器在每次工作階段結束時，會附加一個 JSON 物件到 ~/.claude/metrics/costs.jsonl。每一列是該工作階段的累積快照，因此要計算總花費時，應取每個 session_id 最新的那一列，再跨工作階段加總——若對每一列都加總會造成重複計算。
各欄位說明：
| 欄位 | 意義 |
|---|---|
timestamp | 快照的 ISO 時間戳記 |
session_id | Claude Code 工作階段識別碼 |
transcript_path | 工作階段逐字稿的路徑 |
model | 使用的模型 |
input_tokens / output_tokens | 代幣數量 |
cache_write_tokens / cache_read_tokens | 提示快取代幣數量 |
estimated_cost_usd | 預先計算的該工作階段累積成本（美元） |
建議優先使用 estimated_cost_usd，而不是手動計算價格——模型與快取價格會變動，追蹤器才是可靠的真實來源。
使用時機
- 使用者詢問「我花了多少錢？」、「這個工作階段花了多少？」或「我的代幣用量是多少？」
- 使用者提及預算、花費上限、超支或成本控制。
- 使用者想要依模型、工作階段或日期分類的成本明細，或是 CSV 匯出。
運作方式
首先確認日誌檔案是否存在（使用 node，不要用 sqlite3——追蹤器寫入的是 JSONL，且 node 是跨平台的）：
node -e 'const fs=require("fs"),os=require("os"),p=require("path");const f=p.join(os.homedir(),".claude","metrics","costs.jsonl");console.log(fs.existsSync(f)?"cost log found":"cost log not found: "+f)'
如果日誌不存在，請不要偽造用量資料。告知使用者必須先完成一個工作階段並啟用 stop:cost-tracker 掛鉤，成本追蹤才會開始記錄。
範例——摘要、依模型分類、最近 7 天
node -e '
const fs=require("fs"),os=require("os"),path=require("path");
const f=path.join(os.homedir(),".claude","metrics","costs.jsonl");
if(!fs.existsSync(f)){console.log("cost log not found: "+f);process.exit(0);}
const rows=fs.readFileSync(f,"utf8").split(/\r?\n/).filter(Boolean).map(l=>{try{return JSON.parse(l)}catch{return null}}).filter(Boolean);
const bySession=new Map();
for(const r of rows){const k=r.session_id||r.transcript_path||r.timestamp;const p=bySession.get(k);if(!p||String(r.timestamp)>String(p.timestamp))bySession.set(k,r);}
const latest=[...bySession.values()];
const cost=r=>Number(r.estimated_cost_usd)||0, day=r=>String(r.timestamp||"").slice(0,10), sum=a=>a.reduce((s,r)=>s+cost(r),0), f4=n=>"$"+n.toFixed(4);
const today=new Date().toISOString().slice(0,10), yest=new Date(Date.now()-864e5).toISOString().slice(0,10);
console.log("today: "+f4(sum(latest.filter(r=>day(r)===today)))+" | yesterday: "+f4(sum(latest.filter(r=>day(r)===yest)))+" | total: "+f4(sum(latest))+" ("+latest.length+" sessions)");
const m=new Map();for(const r of latest){const k=r.model||"(unknown)";m.set(k,(m.get(k)||0)+cost(r));}
console.log("by model:");[...m.entries()].sort((a,b)=>b[1]-a[1]).forEach(([k,v])=>console.log(" "+f4(v)+" "+k));
'
若要取得單一工作階段的明細或 CSV 匯出，請對相同的 latest 集合（或原始列）進行迭代，並輸出所需的欄位。
報告指南
呈現成本資料時，應包含當日花費 vs 昨日、所有工作階段的總和、依模型分類的明細，以及工作階段數量。金額小於 1 美元時格式化成四位小數，較大金額則使用兩位小數。
反模式
- 不要對每一列都加總——它們是每個工作階段的累積值；應先歸約至每個
session_id的最新一列。 - 如果
estimated_cost_usd存在，不要使用原始代幣數量來估算成本。 - 不要未經檢查就假設日誌檔案存在。
- 不要在回覆中使用使用者目前看到的模型定價（請勿硬編碼）。
- 不要建議安裝未經審查的掛鉤或會執行任意程式碼的插件。
相關
/cost-report- 基於相同指標日誌的命令列報告。cost-aware-llm-pipeline- 模型路由與預算設計模式。token-budget-advisor- 上下文與代幣預算規劃。strategic-compact- 情境壓縮以減少重複的代幣花費。