AIツール活用

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

中島大介(なかじ)読了時間 約15分
ccusageの使い方を解説する記事のアイキャッチ

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は、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を使う準備の手順は、以下のとおりです。

  1. ターミナルで「node -v」と入力し、Node.jsが入っているか確かめる
  2. Node.jsが入っていなければ、Node.jsの公式サイトから入れる
  3. 「npx ccusage@latest claude daily」と入力し、確認が出たら「y」を入力する
「node -v」でNode.jsの版が表示されれば、準備はできている

「node -v」で「v22.23.4」のような版の番号が表示されれば、Node.jsは入っています。「command not found」と表示された場合は、Node.jsの公式サイトから入れてください。

初めて動かすときは、ccusageを取り込んでよいかの確認が出る

初めて動かすときは「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つです。

  1. 日ごとの使用量を表示する
  2. 月ごと・週ごとの使用量を表示する
  3. 会話ごとの使用量を表示する
  4. 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」で表示します。列の並びは日ごとの表と同じです。

月ごとの使用量の表。1行が1か月分
週ごとの使用量の表。Weekの列は週の始まりの日付

月ごとの表は、プランを上げるか下げるかを考えるときの材料になります。週ごとの表を並べて見ると、締め切り前の週に使用量が増えるといった偏りが分かります。

会話ごとの使用量を表示する

会話ごとの使用量は「npx ccusage@latest claude session」で表示します。表の1行が、1つの会話(セッション)の使用量です。

会話ごとの使用量の表。Sessionの列は会話のIDの先頭

会話ごとの表を見ると、使用量の多い会話がすぐに分かります。上の画像では、金額の目安の大きい会話から順に並んでいます。

使用量の多い会話の作業は、次に頼むときに範囲を分けるか、軽いモデルに任せるかを考えるきっかけにするのがおすすめです。

5時間ごとの使用量を表示する

Claude Codeの使用量は「npx ccusage@latest claude blocks」で5時間ごとの区切りに分けて表示できます。blocksは、Claude Codeの記録だけで使える表示です。

5時間ごとの使用量の表。「ACTIVE」が今の区切り「PROJECTED」が今のペースで使い続けた場合の見込み

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の日ごとの使用量の表。Codexの表には推論(Reasoning)の列もある

Codexの表だけにあるのが「Reasoning」の列です。Reasoningは、AIが答えを出す前に考えた分のトークン数で、出力の料金に含めて数えます。

Codexの日ごとの表の金額の目安が「$0.00」なのは、撮影で使った量が少なく、1セントに満たないためです。使った量が少ない日は、金額よりトークン数で比べるほうが確実です。

まとめた表では「All」の行にツール全体の合計、その下にツールごとの内訳が並ぶ

「npx ccusage@latest daily」では、見つかったツールの記録をまとめて集計します。表の上の「Detected」に並ぶのが、記録が見つかったツールの名前です。

Codexの今の残りの利用上限は、ccusageではなくCodex CLIの/statusで確かめます。

Codexの使用量を確認する方法|残りの上限とリセットの時刻をCLIで見る

ccusageの表示を見やすくする使い方

ccusageには、表の形を変える指定があります。人に見せる資料に貼るときや、別の表計算のソフトで集計し直すときに使うと便利です。

ccusageの表示を変えるときに使う主な指定は、以下の4つです。

  • --compact:列を減らした短い表にする
  • --no-cost:金額の列を表示しない
  • --json:表ではなくJSONの形で出す
  • --offline:インターネットにつながず、手元の価格の情報で計算する
「--compact」を付けると、キャッシュと合計の列を省いた短い表になる

社内で使用量を共有するときは「--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の主なコマンドは、以下のとおりです。

  1. npx ccusage@latest claude daily:Claude Codeの日ごとの使用量
  2. npx ccusage@latest claude monthly:Claude Codeの月ごとの使用量
  3. npx ccusage@latest claude session:Claude Codeの会話ごとの使用量
  4. npx ccusage@latest claude blocks:Claude Codeの5時間ごとの使用量
  5. npx ccusage@latest codex daily:Codexの日ごとの使用量

表の金額はAPIの価格で計算した目安で、月額のプランの請求額ではありません。まずは日ごとの表を1回出して、使用量の多い日と会話を見つけるところから始めましょう。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る