cost-tracker

コストトラッカー

Claude Code セッションのコストを監視し、最適化します。

トリガー

以下の場合に使用します：

• セッションのコストを確認するとき
• 予算アラートを設定するとき
• トークン消費を最適化するとき
• 複数セッションにまたがる作業を計画するとき

コストを意識する

現在のコストを確認

# Session cost is shown at the end of each session
# Mid-session: check the status bar or run /cost

コスト要因

操作	相対コスト	最適化方法
大きなファイルの読み取り	高	offset／limit パラメーターを使用する
広範な grep 検索	中	特定のディレクトリに絞る
サブエージェントの起動	高（新しいコンテキスト）	SendMessage でエージェントを再利用する
ツールの反復呼び出し	累積	操作をまとめる
MCP ツールの呼び出し	可変	往復回数を最小限にする
モデルの選択	3～10 倍の差	簡単なタスクには haiku を使用する

タスクタイプ別のトークン予算

タスク	通常のコスト	予算アラート
バグ修正	$0.10-0.50	$1.00
機能（小）	$0.50-2.00	$3.00
機能（大）	$2.00-8.00	$10.00
リファクタリング	$1.00-5.00	$7.00
コードレビュー	$0.20-1.00	$2.00

ツール呼び出しの予算

タスクの複雑さに応じて、明示的な予算を設定します。

タスクタイプ	ツール呼び出し予算	まとめに入るタイミング
簡単な修正／検索	20 回	15 回
バグ修正	30 回	25 回
機能（小）	50 回	40 回
機能（大）	80 回	65 回
リファクタリング	50 回	40 回

まとめに入る基準に達したら、進捗をコミットし、残作業を評価して、続行するか新たに開始するかを決めます。

最適化戦略

1. プロンプトの範囲を絞る — 「src/auth/login.ts の認証バグを修正する」ではなく「認証バグを修正する」
2. 適切なモデルを使用する — 簡単な検索には Haiku、機能には Sonnet、アーキテクチャには Opus
3. サブエージェントに委任する — サブエージェントで検索／調査を行うと、メインコンテキストを簡潔に保てます
4. 先を見越して圧縮する — 自動圧縮を待たず、タスクの区切りで圧縮します
5. 必要な箇所だけ読む — 大きなファイルには offset および limit パラメーターを使用します
6. 操作をまとめる — 独立した複数のツール呼び出しを 1 つのメッセージにまとめます
7. 一度で仕上げる — 完全な解決策を書き、テストは一度だけ行い、成功したら終了します
8. 再読み込みしない — 変更されていないファイルは再読込せず、キャッシュされた知識を信頼します
9. 書き込む前に読む — 先に読み込まずにファイルを書き込むことは決してありません
10. 出力の無駄をなくす — こびへつらう書き出しや不要な締めくくり、プロンプトの言い換えは避けます

予算アラート

次の目安を設定します：

• 予算の 50% — 順調に進んでいますか？圧縮するべきですか？
• 予算の 80% — 現在のタスクをまとめ、新たな調査は避けます
• 予算の 100% — 現状の成果をコミットし、新しいセッションを開始します

出力

COST TRACKER
  Session cost: $X.XX
  Token usage: [input]K in / [output]K out
  Cache hit rate: ~XX%

  Top cost drivers:
    1. [operation] — $X.XX
    2. [operation] — $X.XX

  Optimization tips:
    - [specific suggestion]

ルール

• コストは厳格な上限ではなく、意識するために追跡します
• トークンを節約するためにコードの品質を犠牲にしないでください
• タスクの途中ではなく、区切りで圧縮します
• 調査が中心となる作業にはサブエージェントを使用します