Claude Code 使用量 確認の6手段｜/usage で見えるもの・見えないものを実測で切り分ける

「claude code 使用量 確認」で調べると /usage を打つ、という答えに行き着きます。それ自体は正しいのですが、この数字がどこから来ていて、何を含んでいないのかまで説明している記事はほとんどありません。Claude Code の使用量を見る窓口は実際には6つあり、それぞれ見えるものが違います。本記事では公式ドキュメントの記述を窓口ごとに整理したうえで、プロンプトを1文字も打つ前に44,519トークンが消えているという当サイト環境での実測値を、計測方法ごと示します。

Claude Code の全体像はClaude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引きにまとめています。本記事はそのうち「自分が今どれだけ使っているかを知る」という一点に絞ります。上限そのものがどう変わるのかはClaude Code 制限まとめ｜9/14に週次上限が恒久+25%＝今日比17%減、一次ソースで検証を参照してください。

Claude Code 使用量 確認の全体像——6つの窓口と守備範囲

まず窓口を並べます。「どれを見ればいいか」は、個人か組織かとサブスクかAPIかで変わります。

公式ドキュメントは、この使い分けを「組織がどうサインインしたかで各開発者の計測方法が決まる」と説明しています。サインイン方法が混在している組織では、開発者ごとに見るべき窓口が違うことになります。

/usage を読む——5つのブロックと、そこに含まれないもの

英語圏で「claude code usage」と呼ばれる話題の中心がこのコマンドです。/usage は1画面に複数のブロックを積んで表示します。それぞれ意味が違うので分解します。

1. Session ブロック。現在のセッションのトークン統計とドル金額です。ここで最も誤解されるのが金額の扱いで、公式ドキュメントはこの数字がトークン数からローカルで定価をもとに計算した見積りであること、Max / Pro 契約者にとっては請求上の意味を持たないことを注記しています。組織が契約レートを持つ場合は modelPricing を管理設定で配布すると表示が契約レートに揃い、Total cost の行に「組織の設定レートによる」という注記が付きます。なお /clear で新しいセッションを始めるとこの合計はリセットされます（v2.1.211 より前は /clear をまたいで累積し続けていました）。

2. Prompt cache ブロック。最初のAPI応答のあとに現れ、リクエスト数・入力トークンのうちキャッシュから読まれた割合・ミス回数・キャッシュが今温かいかを1行にまとめます。ミスの定義が具体的で、キャッシュから読めたはずの内容の5%超かつ2,000トークン以上を再処理したリクエストをミスと数えるとされています。/compact などで会話自体を書き換えた直後のミスは「期待される再構築」として区別されます。

3. Plan usage breakdown。Pro / Max / Team / Enterprise で表示され、ここが実務では一番役に立ちます。

・帰属（Attribution）：スキル・サブエージェント・プラグイン・MCPサーバー別の消費割合。MCPサーバーの取り分は、そのツール結果を実際に消費したリクエストのみを計上する（v2.1.222 より前は、一度呼んだあとの全リクエストをそのサーバーに帰属させて過大表示していた）
・振る舞いフラグ：長すぎるコンテキストやキャッシュミスなど、直近の消費の10%以上を占める振る舞いに立つ
・ループ：/loop などの定期タスクのうち重いものを、発火間隔・実行回数・総トークン・1回あたり・最終実行つきで表示（v2.1.242 以降）

4. usage-credits の行。追加利用分が有効なときだけ出ます。Pro / Max は当月の支出と上限、Team / Enterprise は自分の支出と適用される上限が表示されます。

5. 取得に失敗したとき。使用量エンドポイントがレート制限されると、直近60分以内に読めた最後のバーを「Showing last-known usage」という注記つきで表示します。r で再試行できます。

/usage に含まれないもの

ここが本記事で最も伝えたい点です。公式ドキュメントは /usage の数字について、「概算であり、このマシンのローカルなセッション履歴から計算されている。したがって他のデバイスや claude.ai からの利用は含まれない」と明記しています。

サブスクの枠は Claude チャット・Cowork とも共有されるため、ブラウザで Claude と会話した分も週次枠を減らしますが、/usage のバーには反映されません。ノートPCとデスクトップを併用している場合も、それぞれの /usage は自分の端末分しか見ていません。「思ったより早く上限に当たる」という状況の多くは、この非対称が原因です。

Prompt cache の行にも範囲の制限があります。公式ドキュメントは、この行がメインの会話だけを対象としており、サブエージェント分は含まないことを明記しています。サブエージェントを多用する運用ではキャッシュ効率の実像がここに出ません。

コンテキストの中身を見る /context、傾向を見る /insights

/usage が「どれだけ使ったか」なら、/context は「いま何が場所を取っているか」です。公式ドキュメントは MCP のオーバーヘッド削減の文脈でこのコマンドを挙げており、MCPのツール定義は既定で遅延読み込みされる（Claudeが実際にそのツールを使うまでツール名とサーバー説明だけがコンテキストに入る）としつつ、それでも /context で占有を確認し /mcp から未使用サーバーを無効化することを勧めています。

同時に、gh・aws・gcloud・sentry-cli のようなCLIツールのほうが常にコンテキスト効率が良いとも明言されています。ツール一覧の登録が一切増えないためで、MCPサーバーを入れる前に「CLIで足りないか」を先に考える順序になります。

/insights は毛色が違い、トークン数ではなく働き方のレポートを出します。直近セッションを解析して、何に取り組んでいるか・誤解や不具合といった摩擦点・改善案をHTMLで書き出します。1回の実行で未解析のセッションを最大200件まで扱い、非常に短いものは飛ばします。出力は ~/.claude/usage-data/report.html に置かれ、実行ごとのタイムスタンプ付きコピーも残ります。

なお当サイトの検証環境では ~/.claude/usage-data/ がまだ存在しませんでした。/insights を一度も実行していない環境ではこのディレクトリ自体が作られないという点は、手元で確認できた挙動です。

ls ~/.claude/usage-data/
# → No such file or directory（/insights 未実行の環境）

組織で見る——OpenTelemetry と管理コンソール

個人の窓口では組織全体は見えません。公式ドキュメントが挙げる対応関係は次のとおりです。

なお公式ドキュメントは、クラウド経由での利用者別コスト按分について3つの選択肢を挙げています。各開発者のマシンからメトリクスを流す OpenTelemetry、利用者別の使用量帰属と支出上限を持つセルフホストの Claude apps ゲートウェイ、そして鍵ごとに支出を追うLLMゲートウェイです。3つ目については LiteLLM が実例として挙げられていますが、Anthropic とは無関係のプロジェクトでありセキュリティ監査もされていないと明記されています。

重要なのは最終行です。クラウドプロバイダ経由の利用は Anthropic 側にメトリクスが返らないため、公式のアナリティクスダッシュボードにも Claude Code Analytics API にも出てきません。公式ドキュメントは、契約形態を問わず使え、利用者別のトークンとコストを自前の監視基盤へほぼリアルタイムで流し込める唯一の選択肢が OpenTelemetry エクスポートであるとしています。

自分で測る——投入前に count_tokens で見積もる

ここからは当サイトでの実測です。/usage は「使ったあと」しか見せませんが、Anthropic の count_tokens エンドポイントは課金されずにトークン数を返すため、コンテキストに入れる前に見積もれます。

curl -s https://api.anthropic.com/v1/messages/count_tokens \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "$(jq -Rs '{model:"claude-sonnet-5",messages:[{role:"user",content:.}]}' < CLAUDE.md)"
# → {"input_tokens":44042}

これを使って、セッション開始時に必ず読み込まれるファイル群を測りました（2026-08-30・claude-sonnet-5）。

公式ドキュメントは「CLAUDE.md は200行未満に保つこと」を明示しています。当サイトの CLAUDE.md は491行なので、目安の約2.5倍です。試しに先頭200行だけを測ると 16,085トークンでした。同じ運用ルールを守りながら分量を目安に収めれば、固定費は63%下がるという計算になります。

公式ドキュメントが勧める対処も同じ方向で、特定の作業でしか使わない手順はスキルへ移すことです。スキルは呼び出されたときだけ読み込まれるため、無関係な作業の間はコンテキストを占めません。削減手段そのものの比較はClaude Code トークン節約プラグイン比較｜削減率と導入コストで選ぶ5ツールにまとめてあります。

日本語で使うとトークンは増えるのか——実測で再検証

「日本語はトークンを食う」はよく言われますが、測り方によって結論が変わります。当サイトでは以前、短い日英プロンプト4組で日本語が1.57倍という値を出しました（Claude Code 日本語化ガイド）。今回、より厳密な対訳コーパスで測り直したところ、逆の結果が出ました。

使ったのは Claude Code 公式ドキュメントの Manage costs effectively ページで、同一内容の英語版と日本語版が公式に用意されています（/docs/en/costs と /docs/ja/costs）。コードブロック・URL・表は両版で同一なので除去し、散文だけを比較しました。

1文字あたりの倍率（2.3〜2.8倍）はどちらのコーパスでも安定しています。動くのは総トークン比のほうです。日本語は同じ内容をより少ない文字数で書けるため、その圧縮率が高いほど1文字あたりの不利を打ち消します。プロっぽく訳された長い散文では圧縮率が0.40まで上がり、総量は英語を下回りました。

つまり 「日本語はトークンを食う」は1文字あたりの話としては正しく、総量の話としては書くものによる、というのが実測から言えることです。以前の1.57倍という値は短文コーパスでの測定として正しく、今回の0.90倍と矛盾しません。同じ方法を短文で再現したら1.47倍になり、両者の差がコーパス由来であることも確認できました。

Claude Code 使用量 確認の実践——「早く上限に当たる」を切り分ける

窓口を知っていても、実際に困るのは「思ったより早く枠が減る」という状況です。ここまでに出た制約を踏まえると、切り分けは次の順序になります。

最初に見るのは /usage のバーと体感の一致です。ここがずれているなら、原因は使い方ではなく計測範囲の問題である可能性が高くなります。前述のとおり /usage は他端末と claude.ai を含まないため、複数環境で使っている人ほどバーは実態より少なく出ます。この場合、いくら使い方を絞っても /usage の数字は改善しません。

バーと体感が合っているなら、次は振る舞いフラグです。公式ドキュメントによれば、直近の消費の10%以上を占める振る舞いにフラグが立ちます。long context が立っていれば、話題が変わっても /clear せずに会話を伸ばしていることが疑われます。公式ドキュメントは「Claude Code は毎回のリクエストで会話全体を送る」ため、一日開きっぱなしのセッションでは一行の質問でも会話全体ぶんの枠を消費すると説明しています。

cache misses が立つ場合は間隔の問題です。キャッシュ有効期間より長く空けた最初のリクエストはコンテキスト全体を再処理します。有効期間はサブスクで1時間ですが、usage credits を使い始めると5分に落ちるため、追加利用分を有効にした途端にミスが増えることがあります。なお公式ドキュメントは、Pro / Max で大きなセッションを長い休憩後に再開する場合、要約からの再開が提案されると記しています。

フラグが立っていないなら内訳を見ます。帰属表示でMCPサーバーが突出しているなら /context で占有を確認し、/mcp から未使用サーバーを止めます。「claude code コンテキスト 確認」で行き着くのはこの経路です。サブエージェントが突出しているなら、エージェントチームが plan モードで通常セッションの約7倍を使うという公式の記述が該当します。

どれも突出していないときに残るのが固定費です。ここは /usage の内訳には「スキル」「サブエージェント」といった帰属としてしか出てこないため、「claude code トークン 確認」の答えとしては前節の count_tokens による直接計測が確実です。何を頼んでも一定量が先に消えている状態は、内訳表示では平坦に見えてしまい気づきにくいという性質があります。

参照ソース

・Claude Code 公式ドキュメント — Manage costs effectively
・Claude Code 公式ドキュメント（日本語版）— コストを効果的に管理する
・Anthropic API — Token counting（count_tokens）
・Anthropic Help Center — Extra usage for paid Claude plans