Claude Code のトークン使用量を減らす方法（もう上限に悩まない）

まず、トークンの使い道を確認する

長いセッションで使用量が膨らむ理由

• 長いコンテキスト：リクエストのたびに会話全体が送られ、ツール呼び出しが一巡するごとに新たなリクエストが発生します。キャッシュで再読み込みは安くなりますが、無料にはなりません。
• キャッシュミス：キャッシュの有効期間より長く席を外したあとの最初のメッセージは、コンテキスト全体を処理し直します。
• 放置中に動くもの：セッション単位のスケジュールタスクと /loop、ほかのセッションからのメッセージ、ゴールのチェックイン、セッションの振り返り、アイドル時の自動 compact。
• 並列で動くワーカー：サブエージェント、ワークフローエージェント、agent team のチームメイトは、それぞれ独自にリクエストを送ります。チームメイトがプランモードで動く場合、agent teams は通常のセッションの約 7x のトークンを使います。
• compact そのもの：/compact は要約対象の会話を読む必要があります。/clear はコストゼロです。

Claude Code のトークン使用量を減らす 12 の方法

1. 無関係なタスクの間でクリアする

   /clear で新しい会話を始めれば、古いコンテキストを引きずらずに済みます。あとで /resume で戻りたいなら、先に /rename を実行しておきましょう。

2. 指示を添えて compact する

   /compact Focus on code samples and API usage のように、残すべき内容を Claude に伝えます。常に使う compact の指示を CLAUDE.md に書いておくこともできます。

   # Compact instructions
   
   compact を使うときは、テスト出力とコードの変更を重点的に残してください。

3. 適切なモデルを使う

   Sonnet はほとんどのコーディングをこなせて、Opus より安価です。Opus はアーキテクチャや難しい推論のために取っておきましょう。/model で切り替え、単純なサブエージェントには model: haiku を指定します。

4. 簡単な作業では effort を下げる

   思考トークンは出力として課金され、1 回のリクエストで数万に達することもあります。定型的なタスクでは /effort でレベルを下げましょう。

5. CLAUDE.md を短く保つ

   CLAUDE.md は毎セッション丸ごと読み込まれます。200 行程度に抑え、特定のワークフロー向けの指示は、使うときだけ読み込まれるスキルに移しましょう。CLAUDE.md ガイドと Claude Code のスキルも参照してください。

6. MCP サーバーを絞り込む

   ツール定義はデフォルトで遅延読み込みされますが、サーバーごとに名前と説明は追加されます。使っていないサーバーは /mcp で無効にし、ツールごとの一覧を追加しない gh、aws、gcloud などの CLI を優先しましょう。

7. フックでノイズの多い出力をフィルタする

   PreToolUse フックでテストコマンドを書き換えて失敗だけを残せば、数万トークンのログが数百トークンになります。Anthropic のドキュメントには、そのまま使えるフィルタスクリプトが載っています。

   {
     "hooks": {
       "PreToolUse": [
         {
           "matcher": "Bash",
           "hooks": [
             { "type": "command", "command": "~/.claude/hooks/filter-test-output.sh" }
           ]
         }
       ]
     }
   }

8. 冗長な作業はサブエージェントに任せる

   テストの実行、ドキュメントの読み込み、ログの処理をサブエージェントで行えば、出力はそのコンテキストにとどまり、戻ってくるのは要約だけです。こうしたサブエージェントには小さめのモデルを割り当てましょう。

9. コードインテリジェンスのプラグインを入れる

   型のある言語では、言語サーバーのプラグインが「定義へ移動」を 1 回の呼び出しで済ませます。grep して複数のファイルを読む必要がなくなります。

10. 具体的なプロンプトを書く

    「auth.ts の login 関数に入力バリデーションを追加して」なら数ファイルを読むだけですが、「このコードベースを改善して」ではすべてを走査します。

11. まず計画し、早めに止める

    大きな変更にはプランモードを使い、コードを書く前に方向違いに気づけるようにします。Claude が脱線したらすぐ Escape を押し、/rewind でチェックポイントに戻しましょう。

12. 席を外している間に動くものに注意する

    スケジュールタスク、/loop の実行、アイドル中のメッセージは、どれもコンテキスト全体を送ります。不要なループは止め、crossSessionInbound を hold にしてほかのセッションからのメッセージをキューに溜め、/usage の Loops の行を確認しましょう。

出典：Claude Code ドキュメント、Manage costs effectively

使用量の上限とチームのコスト

Pro、Max、Ultra では、使用量は請求額ではなくプランの上限に対してカウントされます。5時間の制限と週間の制限の仕組みは Claude Code と Codex の比較を参照してください。API では、Anthropic によると企業での平均は開発者 1 人あたり稼働日 1 日で約 $13、月 $150〜$250 で、90% のユーザーは 1 日 $30 未満です。

管理者はチームに支出上限を設定できます。また、マネージド設定に modelPricing テーブルを入れると、/usage に定価ではなく契約料金が表示されます。

スケジュールどおりに働き、夜通しトークンを燃やさないエージェント

セッションを起こすものはすべてコンテキスト全体を送るので、常時稼働のエージェントには歯止めが必要です。Crewmark は、Claude Code、Codex、DeepSeek Harness、OpenCode のセッションを AI 社員に変え、あなたが決めた勤務時間の間だけハートビートで起こします。

1. 勤務時間とリズムを決める

   15 分、30 分、60 分ごとの間隔と、勤務する時間帯を選びます。それ以外の時間は眠っています。Claude Code をプロアクティブにする方法を参照してください。

2. 一度にひとつの issue

   ハートビートのたびにボードから次の issue を取るので、セッションは際限のない探索ではなく、焦点の定まったタスクに取り組みます。

3. 契約中のプランのままで

   AI 社員は既存のサブスクリプションで動き、使用量はプランの上限に対してカウントされます。AI 社員とはをお読みください。

Claude Code のトークン使用量に関するよくある質問