Claude Code の使用量とコストを監視する方法 (2026年)

Claude Code の使用量とコストの監視方法 (2026年版)

Claude Code は Anthropic のエージェント型コーディング CLI であり、ファイルの編集、コマンドの実行、コードベースの検索、および複雑なマルチステップの開発タスクを実行できます。強力である反面、トークン消費も激しく、1つの複雑なタスクで複数のツール呼び出しや推論ステップを経て、数万トークンを消費することもあります。

予算管理、特に API プランを利用している場合やチームを管理している場合には、使用パターンとコストを把握することが不可欠です。このガイドでは、組み込みコマンドからサードパーティのダッシュボードまで、Claude Code の使用量を監視するあらゆる方法を解説します。

Claude Code の請求体系を理解する

Claude Code には 2 つの請求モデルがあります。

プラン	仕組み	コスト
Max サブスクリプション	Anthropic Max プラン（$100/月 または $200/月）に含まれる	使用制限付きの固定月額料金
API ベース	Anthropic API キーを通じたトークンごとの従量課金	使用量に応じて変動

Max プランをご利用の場合、サブスクリプションに含まれる寛容な Claude Code 使用枠を利用できます。独自の API キーを使用している場合は、すべてのトークンが請求対象となります。

Claude Code のトークンコスト (API プラン)

Claude Code は主に Claude 3.5 Sonnet と Claude 3.5 Haiku を使用します。

モデル	入力 (1Mあたり)	出力 (1Mあたり)	Claude Code での主な用途
Claude 3.5 Sonnet	$3.00	$15.00	主要な推論、コード生成
Claude 3.5 Haiku	$0.80	$4.00	迅速なタスク、ファイル読み取り
Claude 3 Opus	$15.00	$75.00	複雑な推論（有効な場合）

典型的な Claude Code セッションには以下が含まれます：

• ファイル内容の読み取り（入力トークン）
• システムプロンプトとツール定義（毎ターンの入力トークン）
• モデルの推論と回答（出力トークン）
• ツール実行結果のフィードバック（入力トークン）

これは、マルチステップのタスクが 50K〜200K トークンを容易に消費する可能性があることを意味します。

方法 1: 組み込みの使用量表示

Claude Code は、ターミナルにトークン使用量を直接表示します。各レスポンスの後、出力の下部にある使用量サマリーを確認してください。

> claude "refactor the auth module to use middleware pattern"

[Claude Code processes the task...]

───────────────────────────────────────
Cost: $0.24 | Tokens: 42,891 in / 3,204 out | Duration: 34s

`/cost` コマンドの使用

対話型セッション中に /cost コマンドを使用すると、累積使用量を確認できます。

claude

> /cost
Session usage:
  Input tokens:  128,432
  Output tokens:  12,891
  Cache read:     89,204
  Cache write:    31,002
  Total cost:     $0.72
  Duration:       4m 23s

これにより、現在のセッションの実行合計（キャッシュされたトークンを含む。これらは安価です）が表示されます。

セッション終了時の確認

Claude Code を終了するか、セッションが完了すると、最終的なサマリーが表示されます。

claude -p "add error handling to all API routes"

# 完了後:
# Total tokens: 89,234 in / 8,921 out
# Estimated cost: $0.42
# Session duration: 1m 47s

方法 2: Anthropic Console ダッシュボード

Anthropic Console は、API ベースの使用量に関する詳細な分析を提供します。

1. console.anthropic.com にアクセスします。
2. 左サイドバーの Usage に移動します。
3. 以下の項目で使用量を確認できます：
   • 期間（日次、週次、月次）
   • モデル（Sonnet, Haiku, Opus）
   • API キー

ダッシュボードには以下の指標が表示されます：

指標	説明
Total tokens	消費された入力 + 出力トークン
Total cost	支出額 (ドル)
Requests	API 呼び出し回数
Rate limit utilization	レート制限への到達状況
Usage by model	モデルごとの内訳

使用量アラートの設定

Anthropic Console で支出アラートを設定します。

1. Settings > Usage Limits に移動します。
2. 月額支出制限（ハードキャップ）を設定します。
3. 通知しきい値を設定します（例：予算の 80% でアラート）。
4. 通知先のメールアドレスを追加します。

設定例:
  Monthly limit: $100
  Alert at: $80 (80%)
  Notification emails: dev@company.com, billing@company.com

方法 3: 詳細ログ出力のための環境変数

環境変数 CLAUDE_CODE_VERBOSE を設定して、詳細なトークンログを取得します。

# シェルプロファイル (.bashrc, .zshrc) に追加
export ANTHROPIC_LOG=debug

# または 1 回のセッションのみ詳細出力で実行
ANTHROPIC_LOG=debug claude "explain this codebase"

これにより、リクエストあたりの正確なトークン数を含む、各 API 呼び出しに関する詳細情報が出力されます。

方法 4: カスタム使用量追跡スクリプト

詳細な追跡が必要なチーム向けに、Claude Code を監視スクリプトでラップできます。

#!/bin/bash
# claude-tracked.sh - Claude Code の使用量をログに記録するラッパー

LOG_FILE="$HOME/.claude-usage.log"
START_TIME=$(date +%s)

# Claude Code を実行し、出力をキャプチャ
claude "$@" 2>&1 | tee /tmp/claude-output.txt

END_TIME=$(date +%s)
DURATION=$((END_TIME - START_TIME))

# 出力からコストを抽出 (正規表現は必要に応じて調整)
COST=$(grep -oP 'Cost: \$[\d.]+' /tmp/claude-output.txt | tail -1 | grep -oP '[\d.]+')
TOKENS=$(grep -oP 'Tokens: [\d,]+ in / [\d,]+ out' /tmp/claude-output.txt | tail -1)

# 使用量をログに記録
echo "$(date -Iseconds) | Duration: ${DURATION}s | Cost: \$${COST:-unknown} | ${TOKENS:-unknown} | Command: $*" >> "$LOG_FILE"

# クリーンアップ
rm -f /tmp/claude-output.txt

実行権限を与え、エイリアスを設定します。

chmod +x ~/claude-tracked.sh
alias claude-t='~/claude-tracked.sh'

ログをレビューします。

# 最近の使用量を確認
tail -20 ~/.claude-usage.log

# 今月のコストを合算
grep "$(date +%Y-%m)" ~/.claude-usage.log | awk -F'Cost: \\$' '{sum+=$2} END {print "Monthly total: $"sum}'

方法 5: プログラム追跡のための Claude Code JSON 出力の利用

Claude Code は JSON 出力モードをサポートしており、使用量データをプログラムで簡単に解析できます。

# 使用量情報を含む構造化された出力を取得
claude -p --output-format json "list all TODO comments in this project" 2>/dev/null | jq '.usage'

Python でより高度なトラッカーを構築することも可能です。

import subprocess
import json
import sqlite3
from datetime import datetime

def run_claude_tracked(prompt, project_dir="."):
    """Claude Code を実行し、SQLite データベースで使用量を追跡する。"""

    result = subprocess.run(
        ["claude", "-p", "--output-format", "json", prompt],
        capture_output=True,
        text=True,
        cwd=project_dir
    )

    try:
        output = json.loads(result.stdout)
        usage = output.get("usage", {})

        # データベースに保存
        conn = sqlite3.connect("claude_usage.db")
        conn.execute("""
            CREATE TABLE IF NOT EXISTS usage (
                id INTEGER PRIMARY KEY,
                timestamp TEXT,
                prompt TEXT,
                input_tokens INTEGER,
                output_tokens INTEGER,
                cost_usd REAL,
                model TEXT,
                project TEXT
            )
        """)

        conn.execute("""
            INSERT INTO usage (timestamp, prompt, input_tokens, output_tokens, cost_usd, model, project)
            VALUES (?, ?, ?, ?, ?, ?, ?)
        """, (
            datetime.now().isoformat(),
            prompt[:200],
            usage.get("input_tokens", 0),
            usage.get("output_tokens", 0),
            usage.get("cost_usd", 0),
            usage.get("model", "unknown"),
            project_dir
        ))

        conn.commit()
        conn.close()

        return output.get("result", "")
    except json.JSONDecodeError:
        return result.stdout

# 使用例
response = run_claude_tracked(
    "add input validation to the user registration endpoint",
    "/path/to/project"
)

使用量データベースを照会します。

-- 日次コストサマリー
SELECT date(timestamp) as day, SUM(cost_usd) as total_cost,
       SUM(input_tokens) as total_input, SUM(output_tokens) as total_output
FROM usage
GROUP BY date(timestamp)
ORDER BY day DESC;

-- プロジェクト別コスト
SELECT project, SUM(cost_usd) as total_cost, COUNT(*) as requests
FROM usage
GROUP BY project
ORDER BY total_cost DESC;

方法 6: Max プラン使用量の監視

Anthropic Max プランをご利用の場合、Claude Code の使用量はサブスクリプション割当の一部です。監視するには：

1. claude.ai/settings にアクセスします。
2. サブスクリプションセクションで使用量を確認します。
3. Claude Code usage meter を探します。

Max プランの制限は毎月リセットされます。以下の点に注意してください：

Max プラン	月額料金	Claude Code 割当
Max (標準)	$100/月	高使用量制限
Max (スケール)	$200/月	非常に高い使用量制限

制限に近づくと、Claude Code はより小規模なモデルへのスロットリングや、回答の長さを短縮することがあります。開発の重要な時期に制限に達するのを避けるため、月の中盤に使用量を確認してください。

コスト最適化のヒント

戦略	節約効果	方法
ワンショットに -p (print mode) を使用	10-30%	対話型セッション起動のオーバーヘッドを回避
具体的なプロンプトを作成	20-40%	やり取りやリトライの回数を削減
--max-turns フラグを使用	最大 50%	エージェントの暴走ループを制限
特定のファイルにスコープを限定	15-25%	検索させる代わりに @file 参照を使用
単純なタスクに Haiku を使用	70-80%	claude --model haiku "simple question"
キャッシュしやすい会話を心がける	20-30%	新規セッションの代わりに既存セッションを再開

# 暴走コストを防ぐためターン数を制限
claude --max-turns 5 "add tests for the payment module"

# 手短な質問に Haiku を使用
claude --model haiku "what does the handleAuth function do?"

# キャッシュされたコンテキストを利用するため、前のセッションを再開
claude --resume

チーム使用量の監視

チームの場合、開発者ごとに API キーを作成し、個別に監視します。

# Anthropic Console で開発者ごとのキーを作成
# 各開発者の環境に設定:
export ANTHROPIC_API_KEY=sk-ant-developer-specific-key

# Anthropic Console > API Keys > Usage でキーごとの使用量を確認

キーごとの支出制限の設定を検討してください：

開発者	月額制限	アラートしきい値
シニアエンジニア	$200	$160
ジュニアエンジニア	$100	$80
QA/テスト	$50	$40
CI/CD 自動化	$300	$240

まとめ

Claude Code の使用量を監視する方法さえ分かれば、管理は簡単です。日常的な監視には、組み込みの /cost コマンドとセッションサマリーが役立ちます。本格的な追跡には、Anthropic Console ダッシュボードを支出アラートやカスタムロギングソリューションと組み合わせてください。重要なのは、コストに驚かされる前、つまり使い始める前に監視体制を整えることです。

AI 駆動のアプリケーションを構築しており、画像、ビデオ、アバター生成などの複数の AI サービスにわたるコストを監視したい場合は、Hypereal AI を無料でお試しください。35 クレジット付与、クレジットカード不要。弊社のダッシュボードは、リクエストごとの透明なコスト追跡を提供するため、支出を常に把握できます。