Claude Codeの使用量・トークン消費を確認する方法 完全ガイド 2026 — /usageからccusage・ステータスラインまで
Claude Codeの使用量をどう確認すればいいか迷ったら読む記事。公式の/usage・/insights・ステータスラインと、サードパーティのccusageをシーン別に整理し、複数クライアント案件を掛け持ちするフリーランス視点での使い分けまで公式ドキュメントベースで解説する。
エンジニアのゆとです。
作業に集中してるとき、頭の片隅にずっと「これ、今どれくらい使ってるんだっけ」という不安がある人は多いと思う。僕もそうだった。特に複数のクライアント案件を掛け持ちしてると、A社の作業で使った分とB社の作業で使った分がごっちゃになって、月末に「あれ、今月そんなに動かしたっけ」となる。
Claude Codeの使用量を確認する方法は、実はひとつじゃない。公式コマンドだけでも/usage・/insights・/usage-creditsと3つあるし、常時表示させたいならステータスラインの設定が要る。もっと踏み込んで日別・案件別に分析したいなら、サードパーティのCLIツールccusageが定番になっている。
この記事では、それぞれの機能が「何のためにあるのか」「どういう場面で使うべきか」を公式ドキュメントベースで整理する。断片的に紹介してる記事は結構あるんだけど、「今すぐ知りたい」「常時見たい」「過去の傾向を分析したい」「案件ごとに分けたい」というシーン別に一枚の地図にまとめた記事は見当たらなかったので、そこを埋める形で書いた。
まず結論 — シーン別の使い分け
| やりたいこと | 使うもの |
|---|---|
| 今このセッションでどれだけ使ったかすぐ知りたい | /usageコマンド（Session block） |
| Pro/Max/Team/Enterpriseでプラン上限に対する消費割合を知りたい | /usageコマンド（Plan usage breakdown） |
| 常に画面の下に使用量・コンテキスト残量を表示させたい | ステータスライン（settings.jsonのstatusLine） |
| 自分の作業の傾向（詰まりやすいポイント等）を分析したい | /insightsコマンド |
| 追加の使用量枠（credits）を有効化・確認したい | /usage-creditsコマンド |
| 日別・月別・セッション別に過去の使用量を集計したい | ccusage（サードパーティOSS） |
| クライアント案件ごとにコストを分けて把握したい | ccusage --instances / --project |
| 組織全体・チームメンバー別の支出を管理したい | Claude Console / admin settings（個人プランでは対象外） |
/usageコマンド — まずここを叩く
対話セッション中に/usageと打つと、2つの情報が表示される。
Session block — このセッションの消費量
Total cost: $0.55
Total duration (API): 6m 20s
Total duration (wall): 6h 33m 10s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-sonnet-4-6: 1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)ここで注意したいのが、このドル表示はローカルで計算された概算だということ。標準料金で機械的に計算しているだけなので、プロモーション価格や契約割引は反映されない。しかもPro/Maxのサブスク契約者にとっては、この金額自体が請求と直接関係ない。公式ドキュメントにもはっきり「Session blockのコスト表示はAPI利用者向けのもので、サブスク契約者の請求には関係ない」と明記されている。サブスク契約者が見るべきなのは次に説明するPlan usage breakdownのほうだ。
このセッションの合計は/clearで新しいセッションを始めるとゼロにリセットされる。地味に重要な仕様変更があって、v2.1.211より前のバージョンでは/clearをまたいでもプロセスが生きてる限り合計が積み上がり続けていた。今のバージョンではセッションが切り替わるたびにきれいにリセットされる。
Plan usage breakdown — プラン上限に対する消費割合
Pro・Max・Team・Enterpriseプランでは、/usageにもう1つのブロックが追加で表示される。プランの利用枠に対して、直近の使用量が何にどれだけ使われているかの内訳だ。
- Attribution: 直近の使用量が、skills・subagents・plugins・個別のMCPサーバーそれぞれに何%割り当てられているかを表示する。MCPサーバーの割合は「そのサーバーのツール結果を実際に使ったリクエスト」だけをカウントする仕様で、v2.1.222より前のバージョンには、1回MCPサーバーを呼ぶとそれ以降の全リクエストがそのサーバーの消費として過大計上されるバグがあった
- Behavior flags: 長いコンテキストやキャッシュミスが直近使用量の10%以上を占めている場合に警告として表示される
dキーで直近24時間、wキーで直近7日間の表示に切り替えられる。ここで覚えておきたいのは、この数字はあくまでこのマシン上のローカルなセッション履歴から計算された近似値だということ。別のPCやclaude.aiでの利用は含まれない。複数のマシンで作業してる場合、/usageだけでは全体像がつかめない点は頭に入れておいたほうがいい。
VS Code拡張機能を使っている場合も同じ内訳が「Account & usage」ダイアログで見られる。Day/Weekの切り替えつきで、Claude Code v2.1.174以降が必要になる。
使用量の取得に失敗したとき
使用量エンドポイントがレート制限にかかっていると、/usageは直近60分以内に取得できた最後のデータを「Showing last-known usage」という注記付きで表示する。rキーで再取得を試せる。60分以内のスナップショットすらない場合は、エンドポイントがレート制限中である旨と再試行のショートカットが表示される。
/insights — 「何にどれだけ使ったか」より「どう詰まったか」
/usageが量の話だとすると、/insightsは質の話だ。このマシン上の直近のセッションを分析して、何に取り組んでいたか・意図を誤解された箇所やバグの出た箇所といった詰まりポイント・より効率的に使うための提案を、HTMLレポートとしてまとめてくれる。
1回の実行で、まだ分析していない最大200セッションを対象にする（短すぎるセッションはスキップされる）。分析対象から漏れたセッションがある場合、レポートのヘッダーに200 sessions (412 total)のような形で分析数と全体数が両方表示される。
レポートは~/.claude/usage-data/report.htmlに最新版が書き出され、実行のたびにタイムスタンプ付きのコピーも同じディレクトリに保存される。過去のレポートが上書きされることはない。ただし他のセッションデータと同じ削除ルールが適用され、起動時にcleanupPeriodDays（デフォルト30日）より古いファイルは自動で削除される。
/insightsはどのプラン・どのプロバイダーでも実行できる。分析自体もClaude Codeとして通常のセッションと同じプロバイダー・アカウントを通るので、その分のトークンはプランやAPI使用量に加算される。「使用量を見るために使用量を消費する」という若干皮肉な仕組みだけど、消費量自体は小さい。
/usage-credits — 上限を超えて作業を続けたいとき
プランの利用枠を使い切っても作業を続けたい場合、使用量クレジット（usage credits）という仕組みがある。/loginでclaude.aiのサブスクにサインインした状態で/usage-creditsを実行すると管理画面が開く。APIキー認証では使えないコマンドだ。
ロールによって開く画面が変わる。
| 自分の立場 | /usage-creditsの挙動 |
|---|---|
| Pro/Maxの個人契約者 | claude.aiの「Settings > Usage」がブラウザで開く。クレジットのオン/オフ、残高、今月の支出、月次の支出上限を確認・設定できる |
| 請求権限を持つTeam/Enterpriseメンバー | 組織の「Admin settings > Usage」が開く |
| 請求権限を持たないTeam/Enterpriseメンバー | 確認後、組織の管理者にリクエストが送信される |
Pro/Maxプランで、クレジットが有効な状態のまま自分で設定した支出上限に達すると、CLIを離れずにその場で上限の引き上げ・解除を促すプロンプトが出る仕組みも用意されている。
「使用量制限にすぐ引っかかる原因そのもの」を深掘りした記事は上のものにまとめてあるので、/usage-creditsをオンにするかどうかを迷ってる場合はそちらも参考にしてほしい。
ステータスラインに常時表示する
セッションのたびに/usageを打つのが面倒なら、画面下部に常時表示させる方法がある。~/.claude/settings.json（またはプロジェクト設定）にstatusLineフィールドを追加する。
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"padding": 2
}
}commandにはスクリプトのパスか、インラインのシェルコマンドを指定できる。もっと手早く試したいなら、jqだけでワンライナーも組める。
{
"statusLine": {
"type": "command",
"command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
}
}ステータスラインのスクリプトには、セッションのJSONデータが標準入力から渡ってくる。使用量まわりで使える主なフィールドはこのあたりだ。
| フィールド | 内容 |
|---|---|
cost.total_cost_usd | セッションの推定コスト（USD）。ローカル計算のため実際の請求とは異なる場合がある。/clearでリセット |
cost.total_duration_ms | セッション開始からの経過時間（ミリ秒） |
cost.total_api_duration_ms | API応答待ちに費やした時間 |
context_window.used_percentage | コンテキストウィンドウの使用率（%） |
context_window.context_window_size | コンテキストウィンドウの上限（通常200,000、拡張モデルは1,000,000） |
自作するのが面倒なら、後述するccusageにもステータスライン用の出力モードがベータで用意されている。設定を消したくなったら/statuslineコマンドで「delete」「clear」などと伝えれば、settings.jsonのstatusLineフィールドごと削除してくれる。
ccusage — 過去の使用量を日別・案件別に分析する
/usageはあくまで「今のセッション」と「直近24時間・7日間」しか見せてくれない。もっと長いスパンで「先月はどれくらい使ったか」「どのプロジェクトが一番トークンを食っているか」を知りたい場合、サードパーティのOSS CLIツールccusage（GitHub上で4,800以上のスターがついている）が実質的な定番になっている。
ccusageはローカルに保存されているセッションのJSONLファイルを読んで集計するだけのツールなので、APIキーもネットワーク接続も不要。インストールも要らず、npxでそのまま実行できる。
npx ccusage@latest主なサブコマンドはこう。
npx ccusage daily # 日別の使用量とコスト
npx ccusage weekly # 週別
npx ccusage monthly # 月別
npx ccusage session # 会話セッション単位
npx ccusage blocks # Claude Codeの5時間課金ウィンドウ単位
npx ccusage statusline # ステータスライン用の出力（ベータ）期間を絞りたいときは--since/--until、直近だけ見たいなら--last 1が使える。
npx ccusage daily --since 2026-07-01 --until 2026-07-31
npx ccusage monthly --last 1 # 今月分だけフリーランス向け — 案件ごとにコストを分ける
複数クライアントの案件を並行してる場合に地味に効くのが--instancesと--projectだ。Claude Codeはプロジェクトディレクトリごとにセッション履歴を分けて保存しているので、ccusageはそのディレクトリ単位で集計を出し分けられる。
# プロジェクト（案件）ごとに使用量を分けて表示
npx ccusage claude daily --instances
# 特定の案件だけに絞り込む
npx ccusage claude daily --project client-a-app
# 案件別集計をJSONで出力（月末の請求資料作成に流用しやすい）
npx ccusage claude daily --instances --project client-a-app --jsonAPIキー課金で複数クライアントの案件を回してる場合、これで「A社の案件にどれだけAPIコストがかかったか」を月末に一目で出せる。サブスクプランで請求には直結しない場合でも、「今月どの案件にどれだけ時間とトークンを使ったか」を可視化しておくと、見積もりの精度を上げる材料になる。
そのほか、--jsonでJSON出力、--no-costでコスト列を非表示、--compactでスクリーンショット向けの省スペース表示、--breakdownでモデル別の内訳表示にも対応している。
Desktop版の「Usage ring」とCLIの情報格差
2026年4月にClaude Code Desktopアプリが刷新されて、使用量を視覚化する「Usage ring」という機能が追加された。CLIの/usageがテキストベースなのに対して、Desktop版はリング状のプログレス表示で直感的に残量が分かるようになっている。
ただし機能面では対応していない部分もある。CLIの/usageが持っているAttribution（skills/subagents/plugins/MCPサーバー別の内訳）やBehavior flags（長いコンテキスト・キャッシュミスの警告）が、Desktop版のUsage ringにそのまま同じ粒度で出るわけではない。細かい原因分析まで踏み込みたい場合は、結局CLIの/usageかccusageに戻ることになる。CLIとDesktop版、両方使い分けてる人は、この情報格差を覚えておくと「あれ、さっき見えてた内訳どこ行った」と迷わずに済む。
組織・チームで使ってる場合
個人のPro/Maxプランなら、ここまでの内容でだいたい足りる。ただしTeam/Enterpriseプラン・Claude Console（APIキー）・クラウドプロバイダー経由（Bedrock/Vertex/Foundry）で使ってる場合は、見るべき場所が変わってくる。
| 契約形態 | 支出の確認場所 | 上限の設定場所 |
|---|---|---|
| Claude for Teams/Enterprise | 組織analyticsの支出レポート | admin settingsの支出上限 |
| Claude Console（API） | Consoleの使用量ページ | ワークスペースの支出上限 |
| クラウドプロバイダー経由 | 各クラウドの請求コンソール | 各クラウドの予算管理機能 |
Team/Enterpriseの場合、各メンバーの利用枠は個人プランと同じく5時間のローリングウィンドウと週次ウィンドウでリセットされる仕組みだけど、上限に達したときの対応は管理者側の設定次第になる。チームメンバーから「使用量制限にすぐ達する」と相談されたときは、まずどの種類の上限（セッション/週次/Opus専用/ゲートウェイの支出上限）に当たっているかを切り分けたほうが早い。
そもそも消費量自体を減らしたい場合は、CLAUDE.mdの肥大化を防ぐ・不要なMCPサーバーを/mcpで無効化する・/effortで推論の強度を落とす、といった節約側のテクニックも合わせて効いてくる。具体的な手順は上の記事にまとめてある。
FAQ
/usageの金額表示は実際の請求額と一致する？
一致しない。ローカルで標準料金から機械的に計算した概算で、プロモーション価格や契約割引は反映されない。正確な請求額はサブスクならclaude.ai/settings/usage、APIキーならClaude Consoleの使用量ページで確認するのが確実だ。
/usageとccusage、どっちを見ればいい？
「今すぐこのセッションの状況を知りたい」「プラン上限に対する消費割合を知りたい」なら/usage。「先月の推移を見たい」「案件ごとに集計したい」「複数のマシンで作業した分もまとめて分析したい」ならccusageに軍配が上がる。両方インストール不要・ログイン不要で使えるので、状況に応じて使い分ければいい。
ステータスラインを設定すると重くなったりしない？
ステータスラインのスクリプトはセッションのやり取りのたびに呼び出されるが、jqのような軽量なコマンドで済む処理なら体感できるほどの遅延にはならない。重い処理（外部APIを叩く、大きなファイルを読むなど）をスクリプトに入れると話は別なので、表示内容はシンプルに保ったほうがいい。
複数のPCで作業してるけど、使用量は合算で見れる？
CLIの/usageもccusageも、基本的には実行しているマシンのローカルなセッション履歴しか見ていない。複数マシンの合算値が必要な場合、個人プランでは正確に把握する手段が限られる。Team/Enterpriseプランなら組織analyticsの支出レポートやEnterprise Analytics APIで、ユーザー単位の集計がサーバー側から取得できる。
まとめ
Claude Codeの使用量確認は、「今すぐ知りたい」なら/usage、「常時見たい」ならステータスライン、「作業の傾向を知りたい」なら/insights、「過去の推移や案件別の内訳がほしい」ならccusage、と役割がはっきり分かれている。どれか1つだけ覚えるより、この4つを状況に応じて使い分けたほうが早い。
フリーランスで複数案件を掛け持ちしてるなら、ccusageの--instancesで案件別に切り分けて見る習慣をつけておくと、月末に「今月何にどれだけ使ったか分からない」という不安からは解放される。まずは/usageを1回叩いてみて、自分がどのプランのどの上限に近いのかを把握するところから始めるのがいちばん手っ取り早い。
