Claude Consoleの使用量・コストを確認する方法とレポートの見方

Usage画面とCost画面は何が違うのか

Claude Consoleで使用量を確認するには左ナビゲーションの「Usage」を、コストを確認するには「Cost」を開きます。どちらもコードを書かずに、組織のAPI利用実績をグラフとCSVで追うための画面です。

画面が出ないときはロールを疑う

この2画面を見られるのは、Developer・Billing・Adminの3ロールです。コストレポートのヘルプにはこの3ロールが書かれている一方、ロール一覧のページではLimited Developerにも「使用量とコストデータの閲覧」が挙がっています。2つのページで対象ロールが食い違うため、自分が見られるかどうかはナビゲーションにUsageとCostが出るかで判断します。出なければ、組織のAdminにロール変更を依頼します。

Userロールは、APIキー・使用ログ・請求の詳細を見られないと明記されています。ロール一覧のページでは、Claude Code Userロールに使用量やコストの閲覧に関する記述がありません。

閲覧できるロールの間でも、持っている権限は違います。

• Developer: セッションのトレース閲覧とファイルのダウンロードもできる
• Billing: 請求の詳細を管理できる。Claude Codeのワークスペースには入れない
• Admin: User・Developer・Billingの権限をすべて持ち、メンバーとロールも管理する

ワークスペースを複数運用している組織では、組織レベルのBillingロールがあれば、個別のロール割り当てがなくても全ワークスペースのコスト・利用量・制限値を見られます。組織レベルのロールが土台になり、ワークスペースレベルのロールが権限を上乗せする作りです。たとえば組織ではUserのメンバーに、特定のワークスペースだけAdmin権限を与えられます。ワークスペースごとの制限や支出上限の組み方は、Claudeのワークスペースの仕組みに詳しくあります。

Usage画面でトークン消費を絞り込む

Usage画面を開くと、入力トークンと出力トークンの棒グラフが出ます。バーをクリックすると、時間・分単位まで粒度を掘り下げられます。絞り込みは次の順に選びます。

選ぶたびにグラフと合計トークン数が更新されます。「先月・Opusモデルのみ・特定の1本のAPIキー」と絞れば、そのキーを使っている機能の消費量だけを切り出せます。ブロックされたリクエストの一覧も同じ画面にあり、レート制限に当たった呼び出しを追えます。

レート制限グラフで余力とキャッシュ率を読む

Usage画面には、トークン量のグラフとは別に、モデルごとのレート制限グラフがあります。左上のドロップダウンでモデルを切り替えると、入力トークン用と出力トークン用の2枚が表示されます。

入力トークン側のグラフには、3つの値が重なります。1時間ごとの未キャッシュ入力トークンの最大値(ITPM、1分あたりの入力トークン数)、現在のITPM制限値、そしてキャッシュ率(入力トークンのうちキャッシュから読まれた割合)です。出力トークン側は、1時間ごとの出力トークン最大値と現在のOTPM制限の2つです。

これらのグラフは、組織がピークに達している時間帯や、引き上げが必要な制限、キャッシュ率の上げ方を探すのに使えます。グラフの「未キャッシュ」という言葉は、APIの使用量欄の読み方と対応しています。レスポンスの input_tokens は、最後のキャッシュブレークポイントより後ろのトークンだけを表します。リクエスト全体の入力量は、次の式になります。

total_input_tokens = cache_read_input_tokens + cache_creation_input_tokens + input_tokens

大半のモデルでは、ITPMの制限に数えられるのは input_tokens と cache_creation_input_tokens だけです。キャッシュから読んだ分は数えられません。ITPM制限が200万でキャッシュ率が80%なら、1分あたり最大1,000万トークン(未キャッシュ200万+キャッシュ済み800万)を処理できる計算です。グラフの上限が高く見えても、キャッシュ率が低ければ余力は小さいままです。

制限を上げたいときは、Consoleの「Rate limits」ページの「Request rate limit increase」から申請します。Anthropicのサポートに頼む経路もあります。Claude Platform on AWS経由で使っている組織では、この申請フローが使えません。Anthropicのアカウント担当者かAnthropicサポートに、増やしたいモデルとピーク時のトークン数、キャッシュされた入力の割合を伝える形になります。

429エラーがレート制限か支出上限かを見分ける

制限値は組織単位で、ティアに応じて決まります。新しい組織や利用実績の少ない組織は、標準より低いEvaluationティアから始まることがあり、実績が積み上がると自動で上がります。

429が返ってきたとき、原因は主に2通りあります。Usage画面のレート制限グラフでピークが制限値に張り付いているなら、レート制限です。もう一方が、組織の月次支出上限に達した場合です。Claude Codeのワークスペースの上限を超えたときは、retry-after ヘッダー付きの429になることもあります。

支出上限に達すると、翌月1日の00:00 UTCまでAPI利用が止まり、リクエストは429になります。エラーの種類は rate_limit_error でレート制限と同じですが、見分ける手がかりが2つあります。retry-after ヘッダーが付かないこと、Messages APIでは error.details.error_code が enforced_spend_limit_reached になることです。SDKの自動リトライも、アクセスが戻るまで失敗し続けます。

自分の組織の上限は、Consoleの「Billing」ページで見られ、自分で下げた上限も設定できます。ティア上限は、上位のティアへ移るか引き上げを申請して解除します。自分で設定した上限は、Billingページで上げるか外すと戻ります。到達したときの応答は429ではなく、HTTP 400です。

Cost画面で月次の支出を読む

Cost画面は、Usage画面とは別のページです。手順に挙がる絞り込みはWorkspace・モデル・月の3つで、Usage画面にあるAPIキーの選択肢は含まれません。選んだ条件に応じて、日次の支出グラフ、トークン料金、ツール利用料が更新されます。

コストを人単位で分けることは、いまのところできません。使用量もコストも、個人別の内訳は用意されていないとヘルプに書かれています。組織・ワークスペース・モデル(Usageならキーも)までが、画面で追える粒度です。

月内の数字が想定と違うときは、Usage画面で同じ月・同じモデルに絞り、トークン量が増えたのか単価の高いモデルへ寄ったのかを切り分けます。コストの突き合わせは、Usage and Cost APIの用途にも挙がっています。

画面だけでは足りない場面を見分ける

ダッシュボードとして眺めるだけなら、Usage/Costの2画面で足ります。次のような場面では、画面操作の限界に当たります。

最後の行のとおり、Usage/Cost画面はAPI組織の利用実績を扱う画面です。claude.aiのPro/Maxプラン(個人向けサブスクリプション)の請求とは別物で、混同すると見るべきデータにたどり着けません。

プログラムで取るときの注意点は、画面と少し違います。

• 使用量とコストのデータは、リクエスト完了から通常5分以内に反映されます。長引くこともあります
• Cost APIはUSDのみ、1日単位のみです。金額は最小単位(セント)の10進文字列で返ります
• Priority Tierの料金はCost APIに含まれません。Usage APIで service_tier が priority の行を見ます
• コード実行の料金はCost APIの説明欄に「Code Execution Usage」として出ます。Usage APIには出ません
• キーはAdmin APIキーなどの管理用認証情報が必要で、組織を作っていない個人アカウントでは使えません
• Claude Platform on AWSでは、Usage/Cost APIもClaude Code Analytics APIも使えません。Consoleの画面で見ます

Claude Code Analytics APIは、日次に集計した利用データをユーザー単位で返します(ユーザーはメールアドレスのほか、APIキー名で示される場合もあります)。Console内のClaude Codeダッシュボードより詳細な指標が取れ、Admin APIが使える組織なら無料です。対象はあくまでClaude Codeの利用分で、Console全体のAPI利用を人単位に分ける機能ではありません。

リクエストそのものを画面で試したい場合は、Usage/Costとは別にClaude ConsoleのPlayground使い方が実行と検証の画面を扱っています。

CSVエクスポートで手元に持ち出す

UsageとCostのどちらの画面にも「CSV Export」があり、現在の絞り込み条件で表示しているデータをそのまま書き出せます。条件を変えてから書き出せば、絞り込んだ分だけが入ります。

月次の数字を社内のスプレッドシートへ転記する程度なら、CSVで足ります。ただし書き出しは手動です。毎時・毎日の取り込みが必要になったら、Usage API・Cost APIへ切り替えたほうが運用の手間は小さくなります。

Usage/Cost画面でつまずきやすい点

• ナビゲーションに項目が出ない: UserロールかClaude Code Userロールの可能性があります。Developer・Billing・Adminのいずれかへの変更をAdminに頼みます
• 人単位の内訳が見つからない: 画面に個人別の分解はありません。Claude Code分に限り、Claude Code Analytics APIでユーザー単位の数字が取れます
• ワークスペースを絞っても数字が変わらない: フィルタが「All Workspaces」のままになっていないかを見ます
• AdminやBillingのロールを外したのに請求メールが変わらない: ロールを外しても、決済代行側の請求先メールは自動で更新されません。変更や追加の連絡先は、Anthropicのサポートに依頼します

まとめ

Usage画面はトークン消費とレート制限の余力を、Cost画面は月次のUSD建て支出を映します。429が出たら、レート制限グラフのピークと月次支出上限のどちらが原因かを切り分けるところから始めると、対処先を取り違えずに済みます。