ccusageの使い方|Claude CodeとCodexの使用量を確認する方法

Claude CodeやCodexを毎日使っていると、使う量は日によって大きく変わります。どの日にどれだけ使ったかが分からないままだと、プランを上げるべきか、使い方を変えるべきかを決められません。
Claude CodeとCodexの画面で分かるのは、主に今の残りの量です。Claude CodeとCodexの使用量を、日ごとや月ごとに同じ形の表で比べたいときは、手元のパソコンに残る記録を集計する道具が必要です。
この記事では、Claude CodeとCodexの使用量を集計するツール「ccusage」の使い方を、実際の画面で1ステップずつ解説します。
この記事を読めば、ccusageで日ごと・月ごと・会話ごとの使用量を確かめる手順と、結果を読むときの注意点が分かります。ccusageは、Node.jsが入っていれば「npx ccusage@latest claude daily」の1行で使えるツールです。
目次
- ccusageで分かること
- ccusageを使う準備
- ccusageでClaude Codeの使用量を確認する手順
- ccusageでCodexの使用量を確認する手順
- ccusageの表示を見やすくする使い方
- ccusageの結果を読むときの注意点
- まとめ
- 参考リンク
ccusageで分かること
ccusageは、Claude CodeやCodexなどのAIのツールが手元のパソコンに残す記録を読み、使用量を表にまとめるツールです。ツール自体は無料で公開されていて、手元のパソコンに残っている記録を読み込みます。
ccusageで確かめられることは、以下の4つです。
- 日ごと・週ごと・月ごとのトークンの数
- 会話ごとのトークンの数
- Claude Codeの5時間ごとの区切りでの使用量
- APIの価格で計算した金額の目安
トークンは、AIが文章を読み書きするときの量の単位です。ccusageの表では、入力・出力のほか、AIが前の内容を使い回したキャッシュの分も別の列に出ます。
ccusageが読めるのは、Claude CodeとCodexのほか、OpenCode・Gemini CLI・GitHub Copilot CLIなどの記録です。ツールごとの記録を1つの表にまとめて表示することもできます。
確かめたいことによって、使う道具が変わります。残りの利用上限とccusageの使い分けは、以下の表のとおりです。
| 確かめたいこと | 使うもの |
|---|---|
| Claude Codeの今の利用上限の残り | Claude Codeの/usage |
| Codexの今の利用上限の残りとリセットの時刻 | Codex CLIの/status |
| 過去の日ごと・月ごと・会話ごとの使用量 | ccusage |
| 使用量をAPIの価格で計算した金額の目安 | ccusage |
Claude Codeの/usageは、今の会話の費用とプランの利用上限、使い方の集計を表示するコマンドです。ccusageは、過去の記録を集計して振り返るための道具として使い分けます。
Claude Code CLIとは?インストールから使い方・コマンドまで解説
ccusageを使う準備
ccusageは、Node.jsに付いてくる「npx」というコマンドで動かせます。事前にパソコンへ入れておく必要はなく、最初に動かすときにccusageが自動で取り込まれます。
ccusageを使う準備の手順は、以下のとおりです。
- ターミナルで「node -v」と入力し、Node.jsが入っているか確かめる
- Node.jsが入っていなければ、Node.jsの公式サイトから入れる
- 「npx ccusage@latest claude daily」と入力し、確認が出たら「y」を入力する
「node -v」で「v22.23.4」のような版の番号が表示されれば、Node.jsは入っています。「command not found」と表示された場合は、Node.jsの公式サイトから入れてください。
初めて動かすときは「Need to install the following packages」と表示され、ccusageを取り込んでよいかを聞かれます。「y」を入力してEnterキーを押すと、取り込みが終わって集計の表が表示されます。
コマンドに付けた「@latest」は、いつも最新の版のccusageを使う指定です。取り込みの確認がもう一度出たときも、同じように「y」を入力します。
ccusageでClaude Codeの使用量を確認する手順
Claude Codeの使用量は「npx ccusage@latest claude」のあとに集計の単位を付けて表示します。日ごとの表から始めて、必要に応じて月ごとや会話ごとに切り替えると、使い方の偏りが見つかります。
ccusageでClaude Codeの使用量を確かめる手順は、以下の5つです。
- 日ごとの使用量を表示する
- 月ごと・週ごとの使用量を表示する
- 会話ごとの使用量を表示する
- 5時間ごとの使用量を表示する
- 期間を絞って表示する
日ごとの使用量を表示する
日ごとの使用量は「npx ccusage@latest claude daily」で表示します。ターミナルの幅が100文字より狭いと一部の列が省かれるため、ターミナルの窓を横に広げてから実行します。
日ごとの表の列の意味は、以下のとおりです。
- Date:日付
- Models:使ったモデル
- Input・Output:AIに渡した量とAIが書いた量のトークン数
- Cache Create・Cache Read:キャッシュに保存した量と使い回した量のトークン数
- Total Tokens:トークン数の合計
- Cost (USD):APIの価格で計算した金額の目安(ドル)
表の一番下の「Total」の行は、表に出た期間の合計です。上の画像は撮影用の会話の記録だけを集計したもので、ふだんの使い方では日付の行が何日分も並びます。
月ごと・週ごとの使用量を表示する
月ごとの使用量は「npx ccusage@latest claude monthly」、週ごとの使用量は「npx ccusage@latest claude weekly」で表示します。列の並びは日ごとの表と同じです。
月ごとの表は、プランを上げるか下げるかを考えるときの材料になります。週ごとの表を並べて見ると、締め切り前の週に使用量が増えるといった偏りが分かります。
会話ごとの使用量を表示する
会話ごとの使用量は「npx ccusage@latest claude session」で表示します。表の1行が、1つの会話(セッション)の使用量です。
会話ごとの表を見ると、使用量の多い会話がすぐに分かります。上の画像では、金額の目安の大きい会話から順に並んでいます。
使用量の多い会話の作業は、次に頼むときに範囲を分けるか、軽いモデルに任せるかを考えるきっかけにするのがおすすめです。
5時間ごとの使用量を表示する
Claude Codeの使用量は「npx ccusage@latest claude blocks」で5時間ごとの区切りに分けて表示できます。blocksは、Claude Codeの記録だけで使える表示です。
5時間ごとの表の読み方は、以下のとおりです。
- Block Start:区切りが始まった時刻と、経過した時間・残りの時間
- ACTIVE:今の区切りで使った量
- PROJECTED:今のペースで使い続けた場合に、区切りの終わりまでに使う見込みの量
表の題名の「Session Blocks」は、5時間ごとの区切りの表を指します。5時間ごとの区切りは、ccusageが手元の記録から割り出したものです。Claude Codeの正確な残りの利用上限は、Claude Codeの/usageで確かめます。
期間を絞って表示する
ccusageの表は、期間を絞って表示することもできます。期間を絞るときに使う指定は、以下の3つです。
- --since 2026-11-01 --until 2026-11-07:始めの日と終わりの日を決めて表示する
- daily --last 1:今日の分だけを表示する
- monthly --last 1:今月の分だけを表示する
たとえば「npx ccusage@latest claude daily --since 2026-11-01」と入力すると、11月1日からの日ごとの使用量だけが表示されます。
ccusageでCodexの使用量を確認する手順
ccusageは、Codexの記録も同じ形の表にまとめられます。Codexの集計は、ccusageの中ではまだ試験段階(Beta)の機能です。Codexは「npx ccusage@latest codex daily」、Claude CodeとCodexをまとめて見るときは「npx ccusage@latest daily」と入力します。
Codexの表だけにあるのが「Reasoning」の列です。Reasoningは、AIが答えを出す前に考えた分のトークン数で、出力の料金に含めて数えます。
Codexの日ごとの表の金額の目安が「$0.00」なのは、撮影で使った量が少なく、1セントに満たないためです。使った量が少ない日は、金額よりトークン数で比べるほうが確実です。
「npx ccusage@latest daily」では、見つかったツールの記録をまとめて集計します。表の上の「Detected」に並ぶのが、記録が見つかったツールの名前です。
Codexの今の残りの利用上限は、ccusageではなくCodex CLIの/statusで確かめます。
Codexの使用量を確認する方法|残りの上限とリセットの時刻をCLIで見る
ccusageの表示を見やすくする使い方
ccusageには、表の形を変える指定があります。人に見せる資料に貼るときや、別の表計算のソフトで集計し直すときに使うと便利です。
ccusageの表示を変えるときに使う主な指定は、以下の4つです。
- --compact:列を減らした短い表にする
- --no-cost:金額の列を表示しない
- --json:表ではなくJSONの形で出す
- --offline:インターネットにつながず、手元の価格の情報で計算する
社内で使用量を共有するときは「--no-cost」で金額の列を外しておくと、請求額と取り違えられずに済みます。JSONの形で出した結果は、表計算のソフトや社内の集計の仕組みに取り込めます。
ccusageの結果を読むときの注意点
ccusageは手元の記録を集計するため、記録の残り方によって数字が変わります。ccusageの数字を社内の判断に使う前に、数字の意味を押さえておきます。
ccusageの結果を読むときの注意点は、以下の4つです。
- 金額はAPIの価格で計算した目安になる
- Claude Codeの記録は既定で30日で消える
- 使用量はパソコンごとに集計される
- 記録には会話の中身も残る
金額はAPIの価格で計算した目安になる
ccusageの「Cost (USD)」は、使ったトークン数をAPIの価格で計算した目安の金額です。ProやMaxなどの月額のプランでClaude Codeを使っている場合、表の金額がそのまま請求されるわけではありません。
月額のプランで使っている場合、表の金額は「APIで同じ量を使ったらいくらか」の目安として読みます。APIで使っている場合も、実際の請求額は請求の画面で確かめてください。
Claude Codeの料金プランを徹底解説!MaxとAPI課金の選び方も紹介
Claude Codeの記録は既定で30日で消える
Claude Codeは、保存期間(既定で30日)より長く使っていない会話の記録を、起動したあとに自動で消します。消えた記録はccusageでも集計できないため、長い期間で比べたいときは記録の保存期間を延ばしておきます。
記録の保存期間を決めるのは、Claude Codeの設定ファイル(settings.json)の「cleanupPeriodDays」に書く日数です。最小の値は1日で、0にすると設定の誤りになります。
使用量はパソコンごとに集計される
ccusageが読むのは、ccusageを動かしたパソコンに残っている記録だけです。会社のパソコンと自宅のパソコンの両方でClaude Codeを使っている場合は、パソコンごとに集計した数字を足し合わせます。
記録には会話の中身も残る
ccusageが読むClaude Codeの記録は、会話の中身も含むファイルです。集計の結果を人に渡すときは表だけを渡し、記録のファイルは渡さないようにします。
まとめ
ccusageは、Claude CodeやCodexが手元のパソコンに残す記録から、使用量を日ごと・月ごと・会話ごとの表にまとめるツールです。今の残りの利用上限は各ツールの画面で、過去の使用量の振り返りはccusageで確かめると、使い分けが分かりやすくなります。
ccusageの主なコマンドは、以下のとおりです。
- npx ccusage@latest claude daily:Claude Codeの日ごとの使用量
- npx ccusage@latest claude monthly:Claude Codeの月ごとの使用量
- npx ccusage@latest claude session:Claude Codeの会話ごとの使用量
- npx ccusage@latest claude blocks:Claude Codeの5時間ごとの使用量
- npx ccusage@latest codex daily:Codexの日ごとの使用量
表の金額はAPIの価格で計算した目安で、月額のプランの請求額ではありません。まずは日ごとの表を1回出して、使用量の多い日と会話を見つけるところから始めましょう。



