この記事の目次
そもそもトークン使用量はどこで確認できるのか？
Claude Codeでトークン使用量を確認する基本の入口は/usageコマンドだが、画面に表示される内容は契約形態によって変わる。まず自分がPro/Maxのようなサブスクリプション契約なのか、API従量課金（Console経由の利用）なのかを確認するのが最初の一歩になる。
サブスクリプション契約の場合、/usageではセッションや週次といった利用枠に対する消費率が中心に表示される。これは「あとどれくらい使えるか」を把握するための表示で、金額そのものは前面に出てこない。一方でAPI従量課金の場合は、実際に消費したトークン数と、それに応じた概算コストが表示の中心になる。両者は同じコマンドを入り口にしていても、見るべき数値の意味がそもそも違う。
自分の契約がどちらか分からない場合は、Claude Codeを導入した際にAnthropicアカウントでサブスクリプションプランに加入したのか、それともAPIキーを発行してConsole経由で従量課金を設定したのかを思い出すと判断しやすい。契約形態そのものを見直したくなったときは、Claude Codeの料金体系を整理した記事でプランごとの特徴を比較できる。
/usage コマンドを実行すると何が表示され、何を意味するのか？
/usageを実行すると、Input（入力トークン）・Output（出力トークン）・Cache Writes（キャッシュ書き込み）・Cache Reads（キャッシュ読み込み）といった項目ごとの数値が表示される。これらは会話やコード読み込みでやり取りされたトークンの種類別の内訳だと理解しておけば十分だ。
Inputは指示やコード、これまでの会話履歴として送られたトークン、Outputはモデルが生成した応答のトークンを指す。Cache関連の項目は、同じファイルや会話履歴を繰り返し読み込む際に発生するプロンプトキャッシュの利用状況を示すもので、キャッシュがうまく効いていればCache Readsの比率が高くなり、無駄な再読み込みが減っていることの目安になる。
表示のされ方は前節で触れた契約形態の違いがそのまま反映される。サブスクリプション契約では、これらの内訳に加えて利用枠に対する消費率（パーセンテージ）が示され、API従量課金では内訳の数値がそのままコスト計算の元になる。細かい項目の定義や最新の仕様は公式ドキュメント（code.claude.com/docs/ja/costs）で随時更新されるため、表示内容に迷ったときの一次情報として使える。/statsや/contextなど関連コマンドもあるが、本記事が扱うのは使用量そのものの確認に限る。
表示されたトークン数は、実際どれくらいのコストになるのか？
コストの概算は「モデルごとの単価×消費したトークン数」というシンプルな計算で求められる。単価は入力トークンと出力トークンで異なり、キャッシュの読み書きにも別の単価が設定されているため、内訳を分けて計算する必要がある。
具体的な単価は使用しているモデル（例えばSonnetやOpusなど）によって異なり、しかも改定される可能性があるため、本記事では固定の金額を示さない。代わりに、次のような手順で自分の消費コストを見積もる方法を押さえておくと、料金改定があっても同じやり方で計算し続けられる。
/usageでInput・Output・Cache Writes・Cache Readsそれぞれのトークン数を確認する- 使用中のモデルの単価を公式の料金ページで確認する
- 項目ごとにトークン数×単価を計算し、合計する
比較軸を揃えて整理すると、サブスクリプションとAPI従量課金では「見るべき数値」と「コスト計算の必要性」が次のように異なる。
| 比較軸 | サブスクリプション契約（Pro/Max） | API従量課金 |
|---|---|---|
/usageで中心的に見る指標 |
セッション・週次の消費率（%） | トークン数（Input/Output/Cache別） |
| 金額換算の必要性 | 基本的に不要（定額のため） | 必要（単価×トークン数で概算） |
| 上限の考え方 | 利用枠のリセットタイミングが判断軸 | 予算やクレジット残高が判断軸 |
| コストが気になったときの確認先 | 消費率の推移 | 単価表と内訳の掛け算 |
使用量の上限に近づいている・使い切ったことにはどう気づけるのか？
上限が近づくと、Claude Codeの実行中にその旨を知らせるメッセージが表示される。サブスクリプション契約ではセッションや週次の枠が尽きた際に一時的に利用が制限され、API従量課金では予算やクレジットの残高不足として現れる。
サブスクリプション契約の利用枠は一定時間ごと(セッション単位)や週単位でリセットされる仕組みになっており、上限に達しても永続的に使えなくなるわけではない。回復のタイミングは公式ドキュメントに記載があり、体感だけで判断すると誤解が生じやすい部分でもある。
上限メッセージが出た際に「なぜこのタイミングで出たのか」「単なる一時的な制限かエラーか」を切り分けたい場合、エラーの原因を切り分ける記事とログの保存場所を扱った記事に判断の手がかりをまとめている。
CLI以外（VS Code拡張など）でも使用量は確認できるのか？
VS Code拡張などのエディタ統合環境からも、アカウントに紐づく使用状況を確認できる導線が用意されている場合がある。ただし表示される粒度がCLIの/usageと完全に一致するかは、利用しているバージョンや環境によって変わりうるため、断定は避けたい。
CLIを開かずにエディタ内で完結させたい場合は、VS Code拡張の使い方を扱った記事で具体的な操作手順を確認できる。Web版のClaude Codeについても使用量に関する表示が用意されている可能性はあるが、CLIとまったく同じ情報が得られるとは限らない。環境ごとの正確な仕様は公式ドキュメントに載っている。
チームや組織で使用量をまとめて把握したい場合はどう違うのか？
法人や企業のチームでClaude Codeを導入している場合、個人の/usageとは別に、Console側で組織全体の利用状況を分析・エクスポートする機能が用意されている。個人利用者が自分の消費を確認する話とは目的も画面も異なる。
組織単位での利用状況の把握は、誰がどれだけ使っているかの可視化や、コストの部門配分といった管理業務に近く、本記事が対象とする「個人が自分の使用量を確認する」というスコープからは外れる。企業としての導入検討やセキュリティ・権限管理の設計は、企業導入を扱った記事とセキュリティ面を整理した記事のテーマだ。
使用量を把握した後、無駄な消費を減らすにはどう考えればいいか？
使用量を確認できるようになったら、次に考えるべきは「何が消費を増やしているか」という判断軸を持つことであり、コマンドを網羅的に覚えることではない。代表的な判断軸は次の三つに整理できる。
一つ目は会話履歴の長さで、/clearで不要な文脈をリセットすれば、以降のやり取りで毎回送信されるInputトークンを減らせる。二つ目は読み込むファイルの範囲で、.claudeignoreのような仕組みで不要なファイルの読み込みを制限すれば、意図しないコンテキストの肥大化を防げる。三つ目はモデル選択で、タスクの複雑さに見合わないモデルを使い続けると単価の高い消費が積み重なりやすい。
コンテキストの仕組みや自動・手動での圧縮はコンテキストウィンドウを解説した記事、モデルごとの使い分けの判断基準はモデルの違いを解説した記事で解説している。
まとめ
ここまでの内容を押さえれば、自分の契約がサブスクリプションなのかAPI従量課金なのかを判断し、/usageで表示される数値のどこを見ればよいかを自分の言葉で説明できる状態になっているはずだ。消費率を見るのか、トークン数とコストを見るのか、その違いが分かっているだけで、以降の確認作業は迷いなく進められる。
ただし使用量の確認と節約の工夫は、一度やって終わりにできる作業ではない。プロジェクトの規模やモデルの使い方が変わるたびに、同じ判断を繰り返す必要が出てくる。そのたびに公式ドキュメントを読み直して独学で対応し続けるのは、決して非効率ではないものの、体系立てて学ぶ機会があれば負担は小さくなる。月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」（lab.no-wave.jp）では、こうしたClaude Codeの運用にまつわる工夫を自分の手で使えるようになるための場として学べる。使用量の確認を一歩目として、継続的な運用の型を身につけたい人は覗いてみてほしい。