cost-tracker

name	cost-tracker
description	追蹤並計算當前 session 的 Token 使用量和花費（USD）。產出前後對比報告，幫助使用者了解 workspace 優化的實際效益。
disable-model-invocation	true

Cost Tracker — Token 使用量與花費追蹤

依據 Claude Agent SDK Cost Tracking

定價表（2026-05，官方 Opus 4.8 發布後）

模型	Input ($/1M tokens)	Output ($/1M tokens)	Cache Read ($/1M)	Cache Write ($/1M)
Opus 4.8	$5.00	$25.00	$0.50	$6.25
Sonnet 4.6	$3.00	$15.00	$0.30	$3.75
Haiku 4.5	$1.00	$5.00	$0.10	$1.25

來源：Models overview、Pricing。 Cache Read = 0.1× input、Cache Write(5m) = 1.25× input。Opus 4.8 fast mode 為 premium 定價，不在此表。

使用方式

在 session 中執行 /cost-tracker，系統將：

1. 統計當前 session 的 Token 使用量

   • 分別計算 input / output / cache tokens
   • 按模型分層統計（Haiku / Sonnet / Opus）

2. 計算花費（USD）

   • 套用上方定價表
   • 區分主對話 vs Sub Agent 花費

3. 產出前後對比

   • 優化前（假設全部使用 Opus）的預估花費
   • 優化後（Advisor 模式分層）的實際花費
   • 差異百分比

計算公式

花費 = (input_tokens × input_price / 1M)
     + (output_tokens × output_price / 1M)
     + (cache_read_tokens × cache_read_price / 1M)
     + (cache_write_tokens × cache_write_price / 1M)

分層估算模型

依據 CLAUDE.md 的 Advisor 模式，各角色的 Token 分配比例：

角色	模型	預估 Token 佔比
搜尋探索	Haiku	~30%
程式碼實作 + 測試	Sonnet	~55%
架構審查 + 顧問	Opus	~15%

輸出格式

### Session Cost Report

| 指標 | 數值 |
|------|------|
| Total Input Tokens | xxx |
| Total Output Tokens | xxx |
| Cache Read Tokens | xxx |
| Cache Write Tokens | xxx |
| **Total Cost (USD)** | $x.xx |

#### 模型分層花費

| 模型 | Tokens | Cost (USD) | 佔比 |
|------|--------|-----------|------|
| Haiku | xxx | $x.xx | xx% |
| Sonnet | xxx | $x.xx | xx% |
| Opus | xxx | $x.xx | xx% |

#### 優化效益

| 指標 | 全 Opus | Advisor 分層 | 節省 |
|------|---------|-------------|------|
| 預估花費 | $x.xx | $x.xx | -xx% |

Agent SDK 整合範例（TypeScript）

import { query } from "@anthropic-ai/claude-agent-sdk";

let sessionCost = 0;
const modelBreakdown: Record<string, { tokens: number; cost: number }> = {};

for await (const message of query({ prompt: "your task" })) {
  if (message.type === "result") {
    sessionCost += message.total_cost_usd;

    for (const [model, usage] of Object.entries(message.modelUsage)) {
      if (!modelBreakdown[model]) modelBreakdown[model] = { tokens: 0, cost: 0 };
      modelBreakdown[model].tokens += usage.inputTokens + usage.outputTokens;
      modelBreakdown[model].cost += usage.costUSD;
    }
  }
}

console.log(`Session total: $${sessionCost.toFixed(4)}`);
for (const [model, data] of Object.entries(modelBreakdown)) {
  console.log(`  ${model}: ${data.tokens} tokens, $${data.cost.toFixed(4)}`);
}

Gotcha

• Claude Code 的 /usage 是累積值：它顯示從 session 開始到當下的總量，不是「本次操作」的增量。
• Cache write tokens 比 input 貴：cache write = 1.25× input price，計算時不要誤用 input 單價。
• 「優化前」是假設值：以全 Opus 計算的對比數字是估算，實際上你可能原本也不是全 Opus。
• Sub Agent 費用需個別計算：子 agent 的 token 不一定計入主對話的 /usage，需確認 SDK 版本行為。
• 定價表可能已更新：本 skill 的定價以 2026-04 為準，若超過 3 個月請重新確認官方定價。