Claude API利用料を瞬時に確認！ccusageでコスト管理を簡単に

Claude APIを使った開発をしていると、どのくらいトークンを消費して、いくらコストがかかっているか気になりますよね。特に開発が活発になると、思わぬコストが発生することも。そんな悩みを解決してくれる便利なツールが「ccusage」です。

今回は、Claude APIの使用量とコストを簡単に確認できるCLIツール「ccusage」の使い方と活用方法を詳しく紹介します。

ccusageとは？Claude API利用状況の可視化ツール

ccusageは、@ryoppippiさんが開発したオープンソースのCLIツールです¹。Claude Codeを使用している開発者向けに、APIの利用状況とコストを分かりやすく表示してくれます。

ccusageの主な特徴

ccusageが他のツールと違うのは、以下のような特徴があるからです。

1. インストール不要で即利用可能 npmやbunを使って、インストールなしで直接実行できます。npx ccusage@latestまたはbunx ccusageのコマンド一つで使い始められるのは、本当に便利です。

2. 多様なレポート形式

日別レポート：毎日のトークン使用量とコストを表示
月別レポート：月ごとの集計データを確認
セッション別レポート：プロジェクトごとの使用状況を把握
5時間ブロック：課金単位となる5時間ごとの使用量を追跡

3. 詳細な使用量分析 入力トークン、出力トークン、合計トークン、そしてUSD建てのコストまで、必要な情報がすべて一目で分かります。

4. モデル別の内訳表示 Claude 3 Opus、Sonnet、Haikuなど、使用したモデルごとのコスト内訳も確認できます。これにより、どのモデルがコストの大部分を占めているか把握できます。

ccusageの仕組み

ccusageは、Claude Codeがローカルに保存している使用履歴データを読み取って分析します。具体的には、~/.claude/projects/ディレクトリ内のJSONLファイルから情報を取得します²。

このアプローチには以下のメリットがあります：

APIキーが不要（ローカルデータを参照するため）
オフラインでも動作可能
過去のすべての使用履歴を確認可能

実際に使ってみよう：基本的な使い方

ステップ1：日別の使用状況を確認

最も基本的な使い方は、日別の使用状況を確認することです：

npx ccusage@latest daily

このコマンドを実行すると、以下のような表形式で結果が表示されます：

Date       Input Tokens  Output Tokens  Total Tokens  Cost (USD)
2025-06-20     150,000       45,000       195,000       $3.45
2025-06-19     230,000       62,000       292,000       $5.12
2025-06-18      85,000       28,000       113,000       $1.98

ステップ2：月別の集計を確認

月単位でコストを管理したい場合は、monthlyコマンドを使います：

npx ccusage@latest monthly

ステップ3：プロジェクト別の使用状況

どのプロジェクトでAPIを多く使っているか知りたい場合は、sessionコマンドが便利です：

npx ccusage@latest session

これにより、プロジェクトごとの使用量とコストが表示され、リソースの最適化に役立ちます。

高度な使い方：フィルタリングとエクスポート

日付範囲でフィルタリング

特定の期間のデータだけを見たい場合は、--sinceと--untilオプションを使います：

npx ccusage@latest daily --since 20250601 --until 20250620

JSON形式でエクスポート

データを他のツールで分析したい場合は、JSON形式で出力できます：

npx ccusage@latest daily --json > usage_data.json

出力されたJSONは、jqコマンドやPythonスクリプトなどで更に詳細な分析が可能です。

モデル別の詳細分析

--breakdownオプションを使うと、使用したモデルごとのコスト内訳が表示されます：

npx ccusage@latest daily --breakdown

実践的な活用シナリオ

シナリオ1：開発コストの予算管理

ある開発チームでは、ccusageを使って以下のようなワークフローを構築しています：

毎朝、前日のAPI使用量をチェック
月初に前月の合計コストを確認
プロジェクトごとのコスト配分を分析
予算超過の兆候があれば、使用するモデルの見直しを検討

シナリオ2：モデル選択の最適化

コストパフォーマンスを重視する個人開発者の場合：

--breakdownオプションで各モデルの使用状況を確認
簡単なタスクにOpusを使っていないかチェック
HaikuやSonnetで十分なタスクを特定
モデル選択を最適化してコストを削減

シナリオ3：チーム開発での利用状況共有

開発チームでの活用例：

週次ミーティングでccusageのレポートを共有
JSON出力をSlackに自動投稿するスクリプトを作成
異常な使用量があった場合のアラート設定
チーム全体でコスト意識を共有

MCP（Model Context Protocol）との連携

ccusageは最新バージョンでMCP対応も追加されています。これにより、VS CodeやCursorなどのエディタから直接使用状況を確認できるようになりました。

MCPサーバーとして動作させる場合：

ccusage mcp

これにより、開発環境を離れることなく、リアルタイムでAPI使用状況をモニタリングできます。

インストールオプション

ccusageは柔軟なインストール方法を提供しています：

一時的な利用（推奨）

# npmを使う場合
npx ccusage@latest

# bunを使う場合
bunx ccusage

グローバルインストール

頻繁に使う場合は、グローバルインストールも可能です：

npm install -g ccusage

注意点と制限事項

ccusageを使う際の注意点：

非公式ツール: AnthropicやClaude Codeの公式ツールではありません
ローカルデータ依存: Claude Codeがインストールされ、使用履歴が保存されている必要があります
価格データ: 価格情報は定期的に更新されますが、最新の価格体系と異なる可能性があります

Claude APIを使った開発をしているなら、ぜひccusageを試してみてください。きっとコスト管理が楽になり、より効率的なAPI利用ができるようになるはずです。

Sources

ccusageの紹介記事 - Zenn（開発者による詳細解説）
ccusage GitHubリポジトリ - 公式リポジトリ（最新情報とドキュメント）