◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/API & SDK
⬡ API & SDK/2026-03-24中級

Claude API Token Counting — 事前にトークン数を把握してコストを最適化する方法

Claude APIのToken Counting エンドポイントを活用して、メッセージ送信前にトークン数を正確に見積もる方法を解説。コスト管理、コンテキストウィンドウの最適化、本番環境での実装パターンまで網羅します。

token-counting3api39cost-optimization28claude-api84python23

取り組みの背景 — なぜトークン数の事前把握が重要なのか

Claude APIを使ったアプリケーション開発で、予想外のコスト増加に悩んだ経験はありませんか? 大量の画像やPDFを含むリクエストを送信した後に「思ったよりトークンを消費していた」と気づくのは、開発者にとって大きなストレスです。

Anthropicはこの課題を解決するために、Token Counting エンドポイントを提供しています。このエンドポイントを使えば、メッセージを実際に送信する前にトークン消費量を正確に見積もることができ、コスト管理とコンテキストウィンドウの最適化に大きく役立ちます。

Token Counting エンドポイントの基本

エンドポイントの概要

Token Counting エンドポイントは、Messages APIと同じリクエスト構造を受け取り、入力トークン数を返す専用のAPIです。

主な特徴:

  • 無料で利用可能: トークンカウントの実行自体に料金は発生しません
  • 全モデル対応: Claude Opus 4.6、Sonnet 4.6、Haiku 4.5 など、全てのアクティブなモデルで利用できます
  • マルチモーダル対応: テキスト、画像、PDF、ツール定義を含むリクエストのトークン数を事前に確認できます
  • 独立したレート制限: メッセージ作成APIとは別のレート制限が適用されるため、カウント処理がAPI呼び出しの制限に影響しません

基本的な使い方

Python SDKを使った最もシンプルなトークンカウントの例を見てみましょう。

import anthropic
 
client = anthropic.Anthropic()
 
# メッセージのトークン数をカウント
response = client.messages.count_tokens(
    model="claude-sonnet-4-6-20260320",
    messages=[
        {
            "role": "user",
            "content": "Claude APIのToken Countingについて教えてください。"
        }
    ]
)
 
print(f"入力トークン数: {response.input_tokens}")
# 出力例: 入力トークン数: 28

TypeScript SDKでも同様に利用できます。

import Anthropic from "@anthropic-ai/sdk";
 
const client = new Anthropic();
 
const response = await client.messages.countTokens({
  model: "claude-sonnet-4-6-20260320",
  messages: [
    {
      role: "user",
      content: "Tell me about Claude API token counting.",
    },
  ],
});
 
console.log(`Input tokens: ${response.input_tokens}`);
// 出力例: Input tokens: 22

システムプロンプトとツールを含むトークンカウント

実際のアプリケーションでは、システムプロンプトやツール定義が入力トークンの大部分を占めることがあります。Token Counting エンドポイントはこれらも含めた正確なカウントを提供します。

import anthropic
 
client = anthropic.Anthropic()
 
# システムプロンプト + ツール定義 + メッセージのトークンカウント
response = client.messages.count_tokens(
    model="claude-sonnet-4-6-20260320",
    system="あなたは天気予報アシスタントです。ユーザーの質問に正確な天気情報で答えてください。",
    tools=[
        {
            "name": "get_weather",
            "description": "指定された都市の現在の天気情報を取得します",
            "input_schema": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "天気を調べたい都市名"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "温度の単位"
                    }
                },
                "required": ["city"]
            }
        }
    ],
    messages=[
        {
            "role": "user",
            "content": "東京の今日の天気を教えてください。"
        }
    ]
)
 
print(f"入力トークン数(システム+ツール+メッセージ): {response.input_tokens}")
# 出力例: 入力トークン数(システム+ツール+メッセージ): 384

ツール定義が多いアプリケーションでは、ツールだけで数百〜数千トークンを消費することがあります。この事前確認により、不要なツールを削減してコストを抑える判断ができます。

画像・PDFを含むリクエストのトークンカウント

マルチモーダルなリクエストでは、画像やPDFのトークン消費量が予測しづらいため、事前カウントが特に重要です。

import anthropic
import base64
 
client = anthropic.Anthropic()
 
# 画像ファイルを読み込んでBase64エンコード
with open("screenshot.png", "rb") as f:
    image_data = base64.standard_b64encode(f.read()).decode("utf-8")
 
response = client.messages.count_tokens(
    model="claude-sonnet-4-6-20260320",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": "image/png",
                        "data": image_data
                    }
                },
                {
                    "type": "text",
                    "text": "この画像の内容を説明してください。"
                }
            ]
        }
    ]
)
 
print(f"画像含む入力トークン数: {response.input_tokens}")
# 出力例: 画像含む入力トークン数: 1,584

画像のトークン数は解像度によって大きく変動します。高解像度の画像は数千トークンになることもあるため、事前確認が欠かせません。

本番環境での実践パターン

パターン1: コンテキストウィンドウ管理

長い会話を維持するチャットボットでは、コンテキストウィンドウの上限に達する前に古いメッセージを削除する必要があります。Token Countingを使えば、この管理を正確に行えます。

import anthropic
 
client = anthropic.Anthropic()
 
MODEL = "claude-sonnet-4-6-20260320"
MAX_INPUT_TOKENS = 180_000  # 安全マージンを含めた上限
SYSTEM_PROMPT = "あなたは親切なカスタマーサポートアシスタントです。"
 
def manage_conversation(messages: list, new_message: dict) -> list:
    """コンテキストウィンドウを超えないよう会話履歴を管理する"""
    candidate = messages + [new_message]
 
    # 現在のトークン数をカウント
    count_response = client.messages.count_tokens(
        model=MODEL,
        system=SYSTEM_PROMPT,
        messages=candidate
    )
 
    # 上限を超えている場合、古いメッセージから削除
    while count_response.input_tokens > MAX_INPUT_TOKENS and len(candidate) > 1:
        # 最初のユーザー・アシスタントのペアを削除
        candidate = candidate[2:]
        count_response = client.messages.count_tokens(
            model=MODEL,
            system=SYSTEM_PROMPT,
            messages=candidate
        )
        print(f"会話を短縮: {count_response.input_tokens} tokens")
 
    return candidate

パターン2: コスト見積もりダッシュボード

バッチ処理の前にコストを事前見積もりする仕組みを構築できます。

import anthropic
 
client = anthropic.Anthropic()
 
# モデルごとの入力トークン単価(per 1M tokens, USD)
PRICING = {
    "claude-opus-4-6-20260205": 15.0,
    "claude-sonnet-4-6-20260320": 3.0,
    "claude-haiku-4-5-20251001": 0.80,
}
 
def estimate_batch_cost(
    model: str,
    tasks: list[dict],
    system: str = ""
) -> dict:
    """バッチ処理のコストを事前見積もり"""
    total_tokens = 0
 
    for task in tasks:
        response = client.messages.count_tokens(
            model=model,
            system=system,
            messages=[{"role": "user", "content": task["content"]}]
        )
        total_tokens += response.input_tokens
 
    price_per_token = PRICING.get(model, 3.0) / 1_000_000
    estimated_cost = total_tokens * price_per_token
 
    return {
        "total_input_tokens": total_tokens,
        "estimated_input_cost_usd": round(estimated_cost, 4),
        "average_tokens_per_task": total_tokens // len(tasks),
        "task_count": len(tasks)
    }
 
# 使用例
tasks = [
    {"content": "この製品レビューの感情分析をしてください: ..."},
    {"content": "次の文章を要約してください: ..."},
    {"content": "以下のコードのバグを見つけてください: ..."},
]
 
estimate = estimate_batch_cost("claude-sonnet-4-6-20260320", tasks)
print(f"合計入力トークン: {estimate['total_input_tokens']:,}")
print(f"推定入力コスト: ${estimate['estimated_input_cost_usd']}")
# 出力例:
# 合計入力トークン: 1,245
# 推定入力コスト: $0.0037

パターン3: プロンプトキャッシュとの併用

プロンプトキャッシュを使用している場合、Token Countingでキャッシュヒット率の最適化に役立てることもできます。キャッシュブレークポイントの配置を検討する際に、各セクションのトークン数を事前に把握しておくと効果的です。

import anthropic
 
client = anthropic.Anthropic()
 
# キャッシュ対象のシステムプロンプトのトークン数を確認
large_system_prompt = "..." * 1000  # 大規模なシステムプロンプト
 
response = client.messages.count_tokens(
    model="claude-sonnet-4-6-20260320",
    system=large_system_prompt,
    messages=[{"role": "user", "content": "テスト"}]
)
 
print(f"システムプロンプトを含む入力トークン: {response.input_tokens}")
# キャッシュの最小要件(1,024トークン)を満たしているか確認
if response.input_tokens >= 1024:
    print("✅ プロンプトキャッシュの対象になります")
else:
    print("⚠️ トークン数が不足しています。キャッシュには1,024トークン以上が必要です")

まとめ — Token Countingで賢くコスト管理

Claude APIのToken Counting エンドポイントは、コスト最適化とコンテキスト管理の両面で欠かせないツールです。特に以下のシナリオで威力を発揮します。

  • バッチ処理のコスト事前見積もり: 大量のリクエストを送る前にコストを把握し、予算オーバーを防ぐ
  • チャットボットの会話管理: コンテキストウィンドウの使用状況をリアルタイムで監視し、適切なタイミングで古いメッセージを削除
  • マルチモーダルリクエストの最適化: 画像やPDFのトークン消費を事前確認し、コンテンツの解像度やサイズを調整

無料で利用できるこのエンドポイントを活用して、APIコストの「見える化」を始めてみてはいかがでしょうか。まずは自分のアプリケーションで最もトークンを消費しているリクエストを特定するところから始めると、最も効果的な最適化ポイントが見えてきます。

より詳しいAPI利用ガイドはAPIクイックスタートを、レート制限の管理についてはレート制限のベストプラクティスをご参照ください。

シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

⬡ API & SDK2026-09-22
PDF の入力トークンは文字数では読めません — 送る前にページ数から上限で挟む
Claude API に PDF を送る前の入力トークンを、文字数ではなくページ数から上限で挟んで見積もる手順です。A4 9 ページの日本語文書で文字数見積もりの 6.6 倍になった実測と、解像度ティアとトークナイザの二重の増分、count_tokens が file_id を数えられない制約までをまとめます。
⬡ API & SDK2026-09-07
キャッシュ読み取りが 75% 安くなっても、請求の下がり方は構成しだいで 10 倍違います
Fable 5.1 と Mythos 5.1 でキャッシュ読み取りの倍率が 0.1 から 0.025 へ変わりました。自分のトークン内訳から削減幅を先に見積もる手順と、倍率を定数で持つコードの直し方をまとめます。
⬡ API & SDK2026-06-12
Claude API の Code Execution ツールに月次の売上CSV集計を任せる — Files API 連携から課金の落とし穴まで
月末に形式の違う売上CSVを突き合わせる作業を、Claude API の Code Execution ツールに任せた実装をまとめます。Files API 連携、コンテナ再利用、5分最小課金やファイルプリロード課金などの注意点を実例ベースで扱います。