ccusage

ccusage とは

ccusage は、Claude Code（と OpenAI Codex CLI）の「トークン使用量」と「概算コスト」をターミナルから確認できる CLI ツールです。Claude Code を毎日使っていると「今月いくら使ったっけ」「このセッション、トークン食いすぎでは？」が気になりますが、ccusage はローカルの使用履歴ファイル（~/.claude/projects/ 以下の JSONL）を集計してターミナル上にレポート表示してくれます。

日本人開発者の ryoppippi 氏が開発・メンテナンスしているコミュニティ製ツールで、外部 API への通信は不要・完全ローカル動作のためプライバシーやコストの心配なしで使えます。npx ccusage で即実行でき、日次 / 月次 / セッション別 / 5 時間課金ブロック別など複数のレポートモードに対応しています。

ccusage × AI でできること

このツールを導入すると、Claude Code の使用量・コストを瞬時に把握できます。

📅 日次レポート

npx ccusage daily
→ 今日のトークン消費量と概算コストを表示

📈 月次トレンド

npx ccusage monthly
→ 月単位の使用量推移 + プラン見直し判断

🔍 セッション別分析

npx ccusage session
→ コスト効率の悪いワークフロー特定

⏱️ 5 時間ブロック管理

npx ccusage blocks
→ 課金ウィンドウ別の消費量管理

主要コマンド

ccusage が公式に提供するコマンド・オプション（README 明記範囲）:

コマンド / オプション	役割
npx ccusage daily	日次レポート（デフォルト）
npx ccusage monthly	月次レポート
npx ccusage session	セッション別レポート
npx ccusage blocks	5 時間課金ブロック別レポート
--since YYYYMMDD / --until YYYYMMDD	日付範囲を絞り込み
--breakdown	モデル別の内訳を表示
--json	JSON 形式で出力（他ツール連携用）
--timezone Asia/Tokyo	日付集計のタイムゾーンを指定（例: JST）
--compact	コンパクト表示
--project <NAME>	特定プロジェクトのみ
--instances	プロジェクト / インスタンス別にグループ化

「日次・月次・セッション・ブロック」の 4 レポートモードと、表示・絞り込み・出力形式のオプションが充実しています。

ccusage について

ccusage は、日本人開発者の ryoppippi 氏が公開するコミュニティ製の Claude Code 使用量集計 CLIです。Claude Code が ~/.claude/projects/ に保存する JSONL ファイルを高速にパースし、日次・月次・セッション別・5 時間課金ブロック別のレポートをターミナル上に表示します。

外部 API への通信は不要で完全にローカルで動作します。コスト計算はオフラインの価格データに基づく概算値ですが、月次プランの見直しや「コスト食いセッション」の特定には十分です。

スペック

• 配布形態: npm パッケージ（ccusage）+ Node.js
• 認証: 不要（ローカル JSONL ファイル読み取りのみ）
• 動作環境: ターミナル CLI（完全ローカル）
• 提供元: コミュニティ実装（ryoppippi / 日本人開発者）/ MIT
• 対応範囲: Claude Code 使用量・コスト集計（日次・月次・セッション・ブロック）
• Codex 対応: ccusage codex daily で OpenAI Codex CLI の使用量も集計（本体に統合）
• 公式リポジトリ: github.com/ryoppippi/ccusage

導入手順

前提条件

• Node.js
• Claude Code の使用履歴（~/.claude/projects/ 以下に JSONL ファイルが存在）

インストールと実行

インストール不要で即実行できます:

# npx で直接実行（推奨）
npx ccusage@latest

# pnpm の場合
pnpm dlx ccusage

# bun の場合
bunx ccusage

グローバルインストールする場合:

npm install -g ccusage

OpenAI Codex を使う場合

OpenAI Codex CLI の使用量も、ccusage 本体のサブコマンドで集計できます（旧 @ccusage/codex パッケージは本体統合に伴い非推奨）:

npx ccusage codex daily

対象 CLI	実行コマンド
Claude Code	npx ccusage daily
OpenAI Codex CLI	npx ccusage codex daily

注意事項

• Claude Code が ~/.claude/projects/ に保存する JSONL ファイルを読み取ります。Claude Code を使用していない環境では動作しません。
• コスト計算はオフラインの価格データに基づく概算値です。正確な請求額は Anthropic のダッシュボードで確認してください。
• 価格データはパッケージに内包されているため、Anthropic 側で価格改定があった場合、最新版へのアップデートが必要です。
• 詳細・最新情報は GitHub リポジトリ を参照してください。
• 本ツールはコミュニティ実装（ryoppippi 氏）です。Anthropic 社が公式に提供するものではありません。