Claude API（Anthropic が提供する大規模言語モデルの呼び出し基盤）を複数チーム・複数プロジェクトで使っている組織に向けた内容です。2026年10月29日、Anthropic は Usage and Cost Analytics API をベータ公開しました。トークン使用量とコストをAPI経由で取得し、モデル別・ワークスペース別に分析できる仕組みです。
LLM（大規模言語モデル）をプロダクションで使い始めると、必ずぶつかるのがコスト可視化の問題です。どのモデルが、どのチームで、どれだけ消費されているか。これが見えないと、予算超過に気づくのが請求書が届いたときになってしまいます。今回のアップデートは、この可視化をダッシュボードではなくAPIとして提供する点が技術的なポイントです。
何が追加されたのか
新しく追加されたのは /v1/organizations/analytics/usage と /v1/organizations/analytics/cost という2つのエンドポイントです。
前者はトークン使用量、後者はコストを返します。呼び出す際は analytics-usage-cost-2026-08-24 というベータヘッダー（まだ正式版ではない機能を有効化するための識別子）をリクエストに付与する必要があります。
対象は Claude Console（開発者向けのAPI管理画面）と Claude Enterprise（企業向け契約プラン）の組織です。個人開発者向けのプランでは使えない点に注意してください。
フィルタとグループ化の粒度
このAPIの実用性を左右するのは、集計の粒度です。公開情報によると、以下の次元でフィルタ・グループ化ができます。
- モデル（例: Claude Opus、Claude Sonnet など、どのモデルを使ったか）
- ワークスペース（Claude Console上でプロジェクトごとに分けられる作業単位）
- APIキー（発行した鍵ごとの識別）
- リクエストの背後にいるユーザーまたはサービスアカウント
これは、社内で複数チームが同じ組織契約の下でClaude APIを共有しているケースを想定した設計です。たとえば、検索拡張生成（RAG、外部データベースから関連情報を取得してLLMに渡す手法）を使う検索チームと、エージェント型の自動化を回す運用チームが同じ契約を使っている場合、どちらがコストを押し上げているかをAPIキー単位で切り分けられます。
旧エンドポイントは「レガシー」扱いに
技術的に見逃せないのが、既存のコスト集計の仕組みが同時に「レガシーAPI」に格下げされた点です。対象は次の4つです。
- Usage and Cost API（旧来の集計API）
usage_reportエンドポイント（Claude Enterprise Analytics APIの一部）cost_reportエンドポイント（同上）user_usage_report/user_cost_reportエンドポイント（同上）
「レガシー」とはいえ、現時点ではすべて動作し続けます。いきなり廃止されるわけではありません。
ただし、レガシー指定は多くの場合、新規開発の対象から外れ、将来的な廃止ロードマップに乗る前触れです。社内のコスト集計バッチや、BI（ビジネスインテリジェンス）ツール連携がこれらの旧エンドポイントに依存している場合、棚卸しをしておく価値があります。
既存のコスト監視パイプラインとの比較
LLMのコスト管理は、クラウドインフラのコスト管理（AWS Cost Explorer や GCPの請求レポートなど）と似た課題を抱えています。
違いは、LLMの場合「トークン数」という独自の単位が間に入る点です。入力トークンと出力トークンで単価が異なり、モデルごとにも単価が違います。さらにプロンプトキャッシュ（繰り返し使うプロンプト部分を保存して再利用し、コストを削減する仕組み）を使っていると、同じリクエスト数でも実際の課金額が変動します。
このため、クラウドコストの監視をTerraform（IaC、インフラ構成をコードで管理するツール）やDatadogで一元化している組織でも、LLM部分だけは別途Claude側のAPIから数値を引っ張り、既存のダッシュボードに統合する作業が必要になります。今回のベータAPIは、この統合作業をしやすくする土台と見てよさそうです。
今日確認できること
実際に影響を受けるかどうかは、次の手順で確認できます。
# 現在使っているAPIバージョンとエンドポイントの棚卸し例
# 社内のコスト集計コードに以下の文字列が含まれていないか検索する
grep -r "usage_report\|cost_report\|user_usage_report\|user_cost_report" ./srcこのコマンドで該当箇所が見つかった場合、Anthropicの移行ガイド（Migrate from the Usage and Cost API / Migrate from the Claude Enterprise usage and cost reports）を確認する価値があります。
新しいベータAPIを試す場合は、リクエストヘッダーに以下を追加します。
curl https://api.anthropic.com/v1/organizations/analytics/usage \
-H "x-api-key: $ANTHROPIC_ADMIN_API_KEY" \
-H "anthropic-beta: analytics-usage-cost-2026-08-24"Admin APIキー（組織管理者権限を持つ鍵）が必要になる点も確認しておいてください。通常の開発用APIキーでは権限不足でエラーになります。
導入前に確認すること
今回のアップデートは、LLM運用のコスト管理をAPI駆動で自動化したいチームにとって実用的な一歩です。
- 自組織が Claude Console または Claude Enterprise 契約かどうかをまず確認する
- 既存のコスト集計コードがレガシー指定された4エンドポイントに依存していないか
grepなどで棚卸しする - 新しい分析APIをベータ版として試す場合は、Admin APIキーの権限とベータヘッダーの付与を忘れない
- モデル別・ワークスペース別の粒度が、社内のコスト按分ルール（チーム間でのコスト配分方法）と合っているか設計段階で検討する
ベータ版である以上、エンドポイント仕様が今後変わる可能性も残っています。本番のコスト監視基盤に組み込む前に、まずは検証環境でレスポンス構造を確認しておくのが堅実な進め方です。