No.1000020新着 ccusage：Claude Codeのトークン使用量とコストをローカルで可視化するCLIツール

Claude Codeを日常的に使っていると、どのくらいトークンを消費し、どのくらいのコストがかかっているのか把握しづらい。今回紹介する「ccusage」は、Claude Codeが手元に残すログファイルを読み込み、日次・週次・月次・セッシ

𝕏 でポストする

登録日時: 2026年10月26日 21:03
出典を確かめた日: 2026年8月12日
分野: AIの仕事
立場: 事実・データ
タグ: Claude新着 Gemini新着
資料の種類: その他
元手の目安: やり方しだい

本文と出典

Claude Codeを日常的に使っていると、どのくらいトークンを消費し、どのくらいのコストがかかっているのか把握しづらい。今回紹介する「ccusage」は、Claude Codeが手元に残すログファイルを読み込み、日次・週次・月次・セッション単位でトークン使用量とコストを集計して表示するコマンドラインツールだ。サーバー運用やコスト管理に関心のある読者、複数プロジェクトでClaude Codeを回している事業者には特に参考になる。

開発元はryoppippi氏で、現在はccusageというGitHub Organization（ccusage/ccusage）で管理されている。README記載時点でスター数は17.9k、ライセンスはMITである。Claude Codeだけでなく、Codex CLI、OpenCode、Amp、Gemini CLIなど複数のコーディングエージェントCLIのログ形式に対応しているのも特徴で、複数のツールを併用している場合はまとめて集計できる。

何ができるツールか

ccusageは、Claude Codeなどが~/.claude/projects/以下などに保存するJSONL形式のログファイルをローカルで解析し、モデル別のコスト内訳、日付範囲によるフィルタリング、プロジェクト（インスタンス）別のグループ集計などを表形式またはJSON形式で出力する。READMEに挙げられている主な機能は次の通り。

・Daily / Weekly / Monthly / Session の各レポート

・5時間の課金ウィンドウ単位で追跡する「Blocks Report」

・モデル別のコスト内訳（per-model cost breakdown）

・--since・--until・--lastによる日付範囲の指定

・--jsonによるJSON出力、--no-costによるコスト列の非表示

・--offlineによるオフライン動作（後述）

・--instances・--projectによるプロジェクト単位の集計

・ccusage.jsonでの価格情報の上書き（Custom Pricing Overrides）

導入方法

npmパッケージとして配布されており、グローバルインストールなしでnpxやbunx経由でそのまま実行できる。Node.js（またはBun）が使える環境であれば追加のセットアップは不要で、Claude Codeがすでにローカルに保存しているログを読みに行くだけである。

# npxで実行（グローバルインストール不要）

npx ccusage@latest

# bunxの場合

bunx ccusage

# pnpmの場合

pnpm dlx ccusage

基本的なレポート表示は以下のコマンドで確認できる。

# 日単位レポート

bunx ccusage daily

# 週単位・月単位・セッション単位

bunx ccusage weekly

bunx ccusage monthly

bunx ccusage session

# 5時間の課金ウィンドウ単位

bunx ccusage blocks

# 期間を指定して絞り込み

bunx ccusage daily --since 2026-08-01 --until 2026-08-12

# JSON出力（他ツールとの連携向け）

bunx ccusage daily --json

Claude Code以外のCLIのログを個別に見たい場合は、ソース名をサブコマンドとして指定する。

bunx ccusage claude daily --instances

bunx ccusage codex daily --speed fast

注意点

いくつか導入前に押さえておきたい点がある。

・実行にはNode.js（npx/bunx利用時）またはNix環境が必要。Claude CodeなどのCLIがローカルに使用ログを残していることが前提で、ログが存在しない環境では集計結果が得られない。

・デフォルトでは、コスト計算に使うモデル価格データ（LiteLLM由来の価格表）をネットワーク経由で取得する。外部通信を避けたい場合は--offlineオプションを付けることで、事前キャッシュされた価格データのみを使い、ネットワーク接続なしで動作させられる。

・読み込むのはローカルのログファイルであり、READMEを見る限りコード内容やプロンプトそのものを外部サーバーへ送信する機能は記載されていない。ただし価格データ取得時の通信先や更新頻度の詳細はREADME単体では確認しきれないため、社内規定で外部通信を制限している環境では事前に挙動を確認したほうがよい。

・bunx実行時はダウンロードしたパッケージがキャッシュされるため、2回目以降の起動は速くなるとREADMEに記載がある。

今後実際に使ってみて、使い勝手を別記事で報告する予定。

（この記事は旧サイト ai.shizuku.net から移しました。元の記事: https://ai.shizuku.net/2026/08/12/ccusage-token-usage-cli/）

この記事を読んで浮かんだ疑問は、運営者ジージが仕事QAでくらさんに質問し、答えをそこに載せていきます。