Claude Codeトークン使用量を確認する方法: エージェントの支出を確認する4つの方法

Claude Codeを1日に数分以上実行する場合、トークンは実際の通貨です。トークンは、レート制限に達するタイミング、サブスクリプションをどれだけ早く消費するか、長時間のエージェント実行が価値があったかどうかを決定します。問題は、Claude Codeがその数を大声で教えてくれないことです。自分で確認する必要があります。

ここでは、Claude Codeのトークン使用量を確認する4つの方法を紹介します。最も迅速な組み込みコマンドから、リアルタイムで全エージェントを表示するライブメーターまで、必要な深さに応じて選んでください。

1. 最も早い方法: /cost コマンド

任意のClaude Codeセッション内で、次のように入力します:

/cost

Claude Codeは、現在のセッションの総コストとトークン数、さらに実行時間を表示します。これは「このセッションはこれまでにいくら使ったか」という質問に対する最も迅速な回答で、何もインストールする必要はありません。

注意点: /costは、あなたがいるセッションに限定されています。昨日の支出、別のプロジェクトのコスト、特定のエージェントが他のエージェントと比較してどうかは教えてくれません。単発のクイックチェックには完璧ですが、過去の情報が必要な場合は、読み続けてください。

2. ソースを読む: セッションのトランスクリプト

Claude Codeは、すべてのセッションをディスクにJSONLトランスクリプトとして書き込みます。macOSおよびLinuxでは、ここにあります:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

各行は1つのメッセージで、アシスタントメッセージには正確なカウントを持つusageオブジェクトが含まれています: input_tokens, output_tokens, およびキャッシュフィールド（cache_creation_input_tokens, cache_read_input_tokens）。キャッシュの読み取りは興味深い部分です: 新しい入力よりもはるかに安価であるため、キャッシュヒット率が高いセッションは、純粋なトークン数が示すよりもはるかに少ないコストで済みます。

これが真実の根拠です。他のすべてのツール、以下の2つを含めて、これらの同じファイルを読み取ります。独自のレポートをスクリプト化したい場合は、JSONLに対してjqを使用すれば実現できます。

3. 専用CLI: ccusage

独自のパーサーを作成したくない場合、コミュニティのccusageツールがこれらのトランスクリプトを読み取り、日次、月次、セッションごとの合計にまとめます:

npx ccusage@latest

これは良い中間地点です: /costよりも多くの履歴があり、jqを手動で作成するよりも少ない労力で済みます。ただし、ターミナル内に留まるため、「何を使ったか」という質問には答えますが、「どのエージェントが今、支出しているか」には答えません。

4. ライブメーター: AgentsRoomでのセッションごとの使用量

上記の3つの方法には共通の盲点があります: それらは事後的で単一ストリームです。複数のエージェントを並行して実行すると、各エージェントの使用量をリアルタイムで確認したくなります。各ターミナルでコマンドを入力することなく。

それが、AgentsRoomのClaude Codeトークン使用量メーターが行うことです。これは、同じJSONLトランスクリプトをセッションごとに読み取り、次の情報を表示します:

• エージェントごとの入力、出力、キャッシュトークンを、セッションが実行されるにつれて更新
• キャッシュヒット率を表示し、コンテキストが再送信されるのではなく再利用されているときに確認できる
• セッションがレート制限に近づく前に警告を表示

セッションごとに使用量を属性付けするため、複数のClaude Codeアカウントを並行して実行しても正確です: 各アカウントは独自の合計を保持し、クライアントごとの再請求が簡単になります。

どれを使うべきか

• このセッションの数だけが必要ですか？ /cost。
• カスタムレポートをスクリプト化したいですか？ JSONLトランスクリプトを直接読み取ります。
• ターミナルで日次および月次の合計が必要ですか？ ccusage。
• 複数のエージェントを実行しており、エージェントごとおよびアカウントごとに使用量をリアルタイムで確認したいですか？ AgentsRoomのメーターを使用します。

使用量を確認することは第一歩です。数字を見て不快に感じた場合、次のステップはそれを減らすことです: キャッシュ再利用から始めて、実際に重要なレバーについてはClaude Codeトークンコストを削減する方法を参照してください。