「ccusage」を叩いたら、AIに使った推定額がドルで出た
- 公開
- 正式公開 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 でモデル名ごとに上書きできます。