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

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

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

1. 最も早い方法: /usage、/context、ステータスライン

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

/usage

Claude Codeは、現在のセッションのトークン使用量を表示し、Claude.aiのプランなら、クォータの残りも表示します: 5時間と7日間のレート制限、そしてコンテキストウィンドウをどれだけ使っているかです。/costと/statsも引き続き使えます。同じコマンドのエイリアスです。Claudeが回答している最中に実行しても、回答を中断せずに数値が表示されます(v2.1.234より前は、コマンドはターンの終了を待っていました)。

1つのパーセンテージではなく、コンテキストウィンドウの詳細を見たいですか？ /contextと入力してください: ウィンドウが色分けされたグリッドとして描かれ、何がそれを食いつぶしているかが示されます。出力の重いツール、肥大化したメモリファイル、容量に近づいたセッションなどです。

2つのコマンドには共通の注意点があります: 自分で入力する必要があり、今いるセッションしか見えません。昨日いくら使ったか、別のプロジェクトがいくらかかったかは教えてくれません。画面に残り続ける数値が欲しいなら、ステータスラインを使ってください。Claude Codeに書いてもらいましょう:

/statusline show model name and context percentage with a progress bar

~/.claude/にスクリプトが生成され、設定に組み込まれます。自分で書きたい場合は、~/.claude/settings.jsonにstatusLineエントリを追加します。スクリプトはstdinからJSONオブジェクトを受け取ります。含まれるのはcontext_window.used_percentage、cost.total_cost_usd、そしてProとMaxの加入者にはrate_limits.five_hour.used_percentageです。1行あれば十分です:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

ステータスラインはAPIの応答ごとに更新されるので、セッションが動いている間、パーセンテージも動きます。それでもターミナルごとに1セッションです: 過去の情報や、複数のエージェントをまとめて見たい場合は、読み続けてください。

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

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

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

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

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

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

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

どれを使うべきか

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

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