「ccusage」を叩いたら、AIに使った推定額がドルで出た

ccusage
コーディングエージェントの CLI のログから、トークン使用量と推定コストを集計する CLI
GitHub公式サイト
公開
正式公開 2025-05-29(紹介記事 2025-05-30)
作り手
ryoppippi
対応
CLI(npm)
価格
無料(MIT ライセンス)
評価
GitHub のスター 19,010(2026-10-15)

どんなアプリか

ccusage は、Claude Code や Codex などのコーディングエージェントの CLI が手元に残す利用ログを読み、トークン使用量と推定コストを集計するコマンドラインツールです。2026-10-15時点の公式サイトでは、Claude Code、Codex、OpenCode、Gemini CLI、GitHub Copilot CLI など18の CLI を対応先に挙げています。

Analyze coding (agent) CLI token usage and costs from local data.

ccusage の README(GitHub)

レポートは日別・週別・月別・セッション別に出せます。最初は検出したすべての CLI をまとめて表示し、必要なときは ccusage claude daily のように一つの CLI に絞り込めます。

インストールせずに npx ccusage@latest で実行でき、bunx・pnpm dlx・Nix からも動かせます。

表ではキャッシュの作成と読み取りのトークンを分けて数え、コストは日・月・セッションごとに USD で示します。--breakdown でモデル別の内訳、--json で JSON 形式の書き出し、--compact で画面写真や共有に向いた詰めた表にできます。

料金とデータの置き場所

ccusage は MIT ライセンスで公開されています。

集計に使うのは手元の端末にある各 CLI の利用ログで、データをアップロードせずに読みます。料金表は事前にキャッシュしたものを使う --offline も用意されていて、ネットワークにつながっていなくても集計できます。

同じ分野のアプリ

名前型仕掛け対応料金
ccusage使用量・コスト集計18の CLI のログからトークン数と推定コストを日別・月別・セッション別に集計CLI(npm)無料(MIT)
Claudelytics使用量・コスト集計Claude Code と Codex の利用パターン・トークン消費・コストを日別・セッション別に集計CLI(Rust)無料(OSS, MIT)
agent-walkerダッシュボード直近30日の AI エージェントの使い方をターミナル1画面にまとめるCLI / TUI(bunx・npx)無料(OSS)
ccstatタイムラインいつどのプロジェクトで作業していたかをタイムラインで表示CLI(npm)無料(OSS, MIT)
Claude Code Usage Monitor for macOSメニューバー監視Claude Code のトークン使用量をリアルタイムに監視してメニューバーに表示macOS メニューバーアプリ無料(OSS, MIT)

入れる前に

表示される金額は、トークン数とモデルの価格から見積もった USD の推定値です。金額を出したくないときは --no-cost で表と JSON から外せます。

Claude の5時間ごとの課金枠を追う blocks と、ステータスライン表示の statusline は Claude Code 専用の機能です。statusline は Beta と書かれています。

モデルの価格は ccusage.json でモデル名ごとに上書きできます。