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

Claude Code トークンの使用量を減らすには、モデルが毎ターン何を処理する必要があるかを制御します。 リクエストに長い会話、複数のファイルの読み取り、コマンド出力、プロジェクトの指示、ツール定義、およびその背後にある拡張された考え方が含まれる場合、短い回答でもコストがかかる可能性があります。

有用なターゲットは、1 つの応答内の最小のトークンではありません。 これは、調査、編集、テスト、修正、人間によるレビューを含む、承認された変更にかかる最低の総コストです。

このガイドでは、/usage、/context、/clear、/compact、/model、/effort、/mcp などの現在の Claude Code コントロールを使用します。 これは、API で請求されるセッションに最も直接適用されます。 サブスクリプション プランでは、リクエストごとの請求書ではなく許容範囲が使用されますが、同じコンテキストの習慣により、許容量を長く続けることができます。

Claude Code がチャットの回答よりも多くのトークンを使用する理由

Claude Code はエージェントであり、単一のプロンプトとそれに続く単一の応答ではありません。 作業セッションには次のものが含まれます。

• あなたのプロンプトと関連するすべての以前のターン。
• クロードがリポジトリを探索中に読み取るファイル。
• コマンド、テスト、コンパイラ、ツールの出力。
• CLAUDE.md、適用可能なプロジェクト ルール、および呼び出されるスキル。
• MCP サーバーからのツール定義と結果。
• 計画、拡張思考、生成されたコード、および説明。
• サブエージェントの概要とその後の修正。

コンテキストは累積的です。 古いログや無関係な設計ディスカッションが会話に残っている場合、後のターンで再度処理される可能性があります。 迅速なキャッシュにより、繰り返されるコンテンツの価格が削減され、Claude Code はコンテキストの制限付近で履歴を自動的に圧縮しますが、どちらも無関係な素材を永久に保持する理由にはなりません。

これにより、実際の操作順序が決まります。

1. 代表的なタスクを 1 つ測定します。
2. 無関係なコンテキストを削除します。
3. スタンディング指示とツールのオーバーヘッドを削減します。
4. 広範な探索とノイズの多い出力を防ぎます。
5. モデルと取り組みを慎重に選択します。
6. 完了したタスクを再度測定します。

感情ではなくベースラインから始める

最適化する前に /usage を実行します。 API ユーザーの場合、そのセッション ブロックは、モデルごとのトークン使用量と、標準のリスト レートでのローカル コスト見積もりを報告します。 この見積もりにはゲートウェイのプロモーションや契約料金が含まれていない可能性があるため、プロバイダーの請求書を正確な財務情報源として使用してください。

/context を実行して、現在のコンテキスト ウィンドウを占有しているものを確認します。 ここでは、大きな CLAUDE.md、呼び出されたスキル、またはツールのオーバーヘッドが、推測のままではなく目に見えるようになります。

セッションで OmniaKey を使用する場合は、それらのローカル診断を使用状況ダッシュボードと比較します。 要求されたモデル、入力および出力トークン、キャッシュ メタデータ、待ち時間、および実際の呼び出しごとのコストが記録されます。 残高と使用ガイドでは、アカウント残高、キーキャップ、使用記録について説明します。

前後チェック用に反復可能なタスクを 1 つ選択します。 記録:

無関係な 2 つのセッションを比較しないでください。 タイプミスの修正や不慣れな移行では、有用なトークン ベンチマークは得られません。

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

最も価値の高い習慣は、最も単純でもあります。次のタスクで現在の会話が必要ない場合は、/clear を使用します。

後で必要になる可能性があるセッションをクリアする前に、セッションに名前を付けます。

/rename auth-refresh-investigation
/clear

以前のセッションは、/resume を通じて引き続き利用できます。 現在の Claude Code は、/clear の後に /usage で表示されるセッション合計もリセットします。これにより、次のタスクを個別に測定することが容易になります。

クリアする適切な理由には次のようなものがあります。

• バックエンドのバグから無関係なマーケティングコピーへの移行。
• 機能を終了し、新しいリポジトリ領域を開始します。
• 前提が間違っていたアプローチを放棄する。
• 決定にもはや影響を及ぼさないいくつかの大きな丸太を運ぶ。

コンテキストメーターが動いたからといってクリアしないでください。 タスクがまだアクティブな場合は、検証された事実と決定を最初に保存するか、明示的な指示で会話をコンパクトにします。

2. 長時間作業時は意図的にコンパクトに

/compact は古い履歴を要約しているため、後のターンはより小さな表現から機能できます。 生き残る必要があるものに名前を付ける命令を追加します。

/compact Preserve the acceptance criteria, changed files, failing test output, and unresolved decisions.

これは、長い実装の一般的な概要よりも安全です。 同じ保存ルールがプロジェクト全体に適用される場合は、CLAUDE.md に短い圧縮ガイダンスを配置することもできます。

圧縮はサブスクリプション使用量のリセットとは異なり、コンテキスト警告は請求制限の警告ではありません。 圧縮は、会話に残っている内容を管理します。 プランの許容量を追加したり、API 残高を補充したりすることはありません。

タスクはまだ一貫性があるが、現在の状態へのパスにノイズが多い場合に使用します。 作品自体が変更された場合は、/clearを使用してください。

3. 作業開始前にロードされるコンテキストを縮小します

Claude Code は、セッション開始時にプロジェクト指示を読み取ります。 役立つ指示により間違いを防ぎます。 すべてのセッションにコピーされたハンドブックは、タスクに必要かどうかに関係なく、コンテキストを消費します。

Anthropic の現在のガイダンスでは、CLAUDE.md を簡潔にし、特殊なワークフローをオンデマンドで読み込まれるスキルに移行することを推奨しています。 適切なルート ファイルには次のものが含まれます。

• 変更を検証するコマンド。
• リポジトリ固有のアーキテクチャ境界。
• 明白ではない環境制約。
• 通常の言語のデフォルトとは異なる規則。

長い API チュートリアル、1 回限りの移行 Runbook、およびドメインのリファレンス資料を別の場所に移動します。 すべてのセッションに埋め込むのではなく、それらにリンクするか、焦点を絞ったスキルとしてパッケージ化します。

MCP サーバーでも同様のトレードオフが発生します。 /mcp を実行し、使用していないサーバーを無効にします。 Claude Code はデフォルトで完全なツール定義を延期しますが、名前と呼び出されたスキーマは引き続きコンテキストを占有します。 単純な操作の場合、gh、aws、または sentry-cli などの焦点を絞った CLI は、広範囲のツール サーフェスを読み込むよりもコンテキスト効率が高くなります。

剪定後に再度/contextを確認してください。 開始フットプリントが変更されなかった場合は、さらに構成を編集する前に、実際の大きな寄与者を見つけてください。

4. 探索ループを回避するためにタスクを十分に狭くします

「このリポジトリを改善する」とスキャンを促します。 境界のあるプロンプトは証拠に直接アクセスできます。

Fix the 401 after token refresh in src/api/auth.ts.
Preserve the public response shape.
Add a regression test for an expired access token with a valid refresh token.
Run the focused auth test and the type checker.

プロンプトは、症状、可能性のあるファイル、契約、証拠を特定します。 クロードは必要に応じて依存関係を検査できますが、コードベース全体を読み取らない理由があります。

本当に複雑な作業の場合は、編集する前に計画を立ててください。 短い調査と計画段階で、間違ったアーキテクチャでの高コストの実装を防ぐことができます。 単一行の適切な場所にある修正の場合、計画にオーバーヘッドがかかる可能性があります。 不確実性が現実的な場合に使用します。

早めに軌道修正。 クロードが間違った問題を解決している場合は、大きなパッチを生成させてからパッチを元に戻さなければならない理由を説明するのではなく、ターンを停止します。 /rewind は、以前の会話とコード チェックポイントを復元できます。

出力コントラクトは次の場合にも役立ちます。

• 決断を先導する。
• 変更されたファイルと検証結果のみをリストします。
• プロンプトを繰り返さないでください。
• 実装前に不足している情報を尋ねる。
• 切り捨てによって必要な証拠が隠蔽されない場合にのみ、アーティファクトに上限を設けます。

散文を短くすると、出力トークンの一部が節約されます。 通常、探索と再作業を回避すると、より多くのコストを節約できます。

5. ツールとテスト出力に焦点を当て続ける

大きなコマンド出力が作業コンテキストに入ります。 変更を証明できる最も狭いコマンドを優先します。

pnpm vitest run tests/unit/auth.test.ts
rg -n "FAIL|ERROR" test-output.log
git diff --check

トークンを減らすためだけに失敗を隠さないでください。 失敗したアサーション、関連するスタック フレーム、コマンドの終了ステータス、および原因を診断するのに十分な周囲の出力を保持します。 繰り返される進行状況バー、成功したテストのリスト、無関係な何千ものログ行を削除します。

安定した前処理はスクリプトまたはフックに属します。 Anthropic のコスト ガイドには、クロードが見る前に非常に大きなテスト ログをフィルタリングする例が示されています。 実行のたびに同じノイズ パターンを再検出するようにモデルに要求するよりも、小規模で検討されたフィルターの方が信頼性が高くなります。

多くのファイル読み取りを必要とする研究の場合、境界付きサブエージェントは、メインの会話から冗長な探索を排除し、短い結果を返すことができます。 これによりコンテキストが分離されます。 サブエージェントには独自のコンテキストがあるため、合計トークンが少なくなるという保証はありません。 概要がメインタスクで繰り返し読むのを妨げる場合に使用します。

6. モデルと労力を決定に合わせて決定する

モデルの選択により、レートと必要な試行回数の両方が変わります。 Claude Sonnet 5 は実用的な毎日の開始点であり、Claude Haiku 4.5 は狭い反復可能な作業に適しており、アーキテクチャ、曖昧さ、またはエラーのコストが高い場合は Claude Opus 5 の方が正当化されやすくなります。

意図的に切り替えるには、/model を使用します。 Claude Code モデル ガイドには、より完全なタスク ルーティング ポリシーが記載されています。

拡張思考トークンは、API パス上の出力トークンとして課金されます。 単純で明確に指定されたタスクの場合は、/effort を使用して労力を軽減し、それでも結果が合格するかどうかを測定します。 難しい計画や不慣れなデバッグの場合、労力が少なすぎると再試行が発生し、保存が消去される可能性があります。

すべてのタスクを最も安価なモデルにルーティングして、最適化されたポリシーを呼び出すのは避けてください。 修正や負債の見直しなど、承認された結果ごとのコストを比較します。

7. 使用量を減らした後に財務ガードレールを追加します

支出上限はトークンの消費量を減らしません。 これにより、ループ、キーの漏洩、または予期しないワークロードによってリクエストが送信され続けた場合の経済的損害が制限されます。

OmniaKey を使用すると、API キー ダッシュボードでローカル開発、自動化、共有ワークロード用に個別のキーを作成します。 各キーにその役割に合った上限を与え、上限を上げる前に使用法を確認してください。 個別のキーにより、どこにでも 1 つの無制限の認証情報を使用するよりも、帰属と取り消しが明確になります。

順序が重要です:

1. 不要なコンテキストを削除して再試行します。
2. 通常のタスクのコストを測定します。
3. 正当な差異を上回る上限を設定します。
4. ワークロードがその境界を越えたときに警告または停止します。

上限が低すぎると、コストの問題がタスクの途中で失敗するだけになります。 使用レビューのない上限は、上限に達したことだけを示します。

10 分の Claude Code トークン監査

1 つの実際のセッションでこのチェックリストを使用します。

1. /usage を実行し、モデルごとの使用状況を記録します。
2. /context を実行し、回避可能な最大の要因を特定します。
3. 現在のタスクが以前の会話と無関係な場合は、/clear を使用します。
4. CLAUDE.md を短縮します。 専門的な指示をオンデマンドのスキルに移行します。
5. 未使用の MCP サーバーを /mcp で無効にします。
6. 広範なプロンプトをファイル、症状、境界、および受け入れチェックに置き換えます。
7. 焦点を絞ったテストを実行し、失敗を隠すことなく反復的な出力をフィルター処理します。
8. タスクの難易度に応じて、/model と /effort を使用します。
9. 同じタスク クラスを繰り返し、完了したタスクのコストを比較します。
10. 通常の範囲がわかったら、キーごとのキャップを追加します。

一度に 1 つまたは 2 つの変数を変更します。 セッションをクリアし、モデルを変更し、作業量を減らし、同時にタスクを書き直すと、どの変更が役に立ったかわかりません。

よくある間違い

短い答えだけを求める

これにより、目に見える出力は減りますが、ファイルの読み取り、履歴、ツール、思考はそのまま残ります。 それは便利ですが、まれに最大のレバーです。

タスクにまだ必要なコンテキストを削除する

制約が欠落していると、推測とやり直しが発生します。 クリアまたは圧縮する前に、検証済みの決定を保存します。

キャッシュ ヒットを使用量ゼロとして扱う

即時キャッシュを使用すると、繰り返し入力する料金を下げることができますが、キャッシュされたトークンは引き続き使用量アカウンティングに表示されます。 繰り返されるコンテキストを有効に保ち、実際の請求記録を確認します。

あらゆる小さな質問にサブエージェントを使用する

各サブエージェントには独自の起動コンテキストと作業コンテキストがあります。 デリゲート限定の大量探索。 現在のセッションでローカルな小さな質問に答えます。

上限と最適化を混同する

キーキャップは境界で支出を停止します。 その境界を下回るリクエストの効率が向上するわけではありません。

よくある質問

答えが短い場合、Claude Code トークンの使用率が高くなるのはなぜですか?

リクエストには、最終的なテキストよりもはるかに長い会話履歴、プロジェクトの指示、ファイル、コマンド出力、ツール、考え方が含まれる場合があります。 回答の長さで判断するのではなく、/context と /usage を確認してください。

/clear は以前の Claude Code セッションを削除しますか?

新しいセッションが開始されます。 最初に重要な作業の名前を変更し、後で /resume を使用して保存されたセッションに戻ります。

/compact は常に請求額を減らしますか?

これにより、将来のターンに引き継がれる履歴が減少し、その後の入力使用量を減らすことができます。 最終的な効果は、セッションの継続時間と概要が保持する内容によって異なるため、/usage と請求ダッシュボードで確認してください。

トークンを節約するには常に Haiku を使用する必要がありますか?

いいえ、安価なモデルは狭い範囲の作業には経済的ですが、失敗を繰り返すと、SonnetやOpusの 1 ターンが成功するよりもコストがかかる可能性があります。 タスクごとにルーティングし、受け入れられた結果を測定します。

API キーの使用上限により、トークンの使用量を減らすことができますか?

いいえ。リクエストが使用量を消費した後、支出が制限されます。 キャップを、より小さなコンテキスト、焦点を絞ったプロンプト、意図的なモデルの取り組み、およびコールごとのレビューと組み合わせます。

情報源

• Anthropic: Claude Code コストを管理
• Anthropic: Claude Code コンテキスト ウィンドウを探索する
• Anthropic: Claude Code ベスト プラクティス
• Anthropic: Claude Code モデルと作業量の構成
• Anthropic: プロンプト キャッシュ
• OmniaKey の残高と使用方法に関するドキュメント

事実確認済み 2026年8月8日. Claude Code コマンド、モデルの動作、および請求対象の変更。 制作予算を設定する前に、リンクされたファーストパーティのドキュメントと実際の使用記録を確認してください。