Claude Codeのコスト最適化とセッション管理ガイド

Claude Codeにおけるセッション価値を最大化するための詳細なガイドが公開された。トークン価格の決定要因、キャッシュメカニズム、コンテキスト管理について網羅している。トークン価格はモデル選択、入力対出力(出力は約5倍高価)、プロンプトキャッシュ(キャッシュ読み取りは0.1倍、書き込みは最大2倍)に影響される。キャッシュはモデル、努力度、高速モード、コンパクト、または時間経過によって無効化される。コンテキストは読み取ったファイル、コマンド出力、ツール定義をすべて蓄積し、毎ラウンド再送信される。戦略としては、@メンションを使用したファイル読み取りのスキップ、ノイズの多いコマンドへの静音フラグ追加、ノイズの多いタスクを分離するサブエージェントの活用、タスク間での/clear、離脱前の/compactなどが挙げられる。優先順位付きチェックリストは、コンテキストの監査、モデル/努力度の早期設定、キャッシュ維持のために/compactではなく/rewindを活用することで締めくくられている。
Key insights
トークン価格モデルが最適化の優先順位を決定
トークンコストはモデルサイズ、入力対出力(出力はトークンあたりのデコードにより5倍のコスト)、および/effortで制御される思考トークンによって決まる。出力には思考トークンが含まれ、ルーチンタスクではMAX_THINKING_TOKENS=0で無効化できる。大規模モデルは他のすべてのコストを増幅するため、モデル選択が最初のレバーとなる。
キャッシュは脆弱: セッション中の設定変更で無効化
プロンプトキャッシュはプレフィックスが変更されない場合にコストを大幅に削減するが、/modelや/effortの変更、高速モードの有効化、/compactといった操作はキャッシュを無効化し、フルプライスのプレフィルを強制する。キャッシュはサブスクリプションでは1時間、APIキーでは5分で期限切れとなるが、ENABLE_PROMPT_CACHING_1H=1で延長可能。古いセッションを復元するとほぼ常にキャッシュミスとなる。
コンテキストの蓄積が隠れたコスト要因
コンテキストに読み込まれたすべてのもの(CLAUDE.md、MCP定義、ファイル読み取り、コマンド出力)は、セッションが終了するまで後続の各ラウンドで再送信される。キャッシュがあっても、蓄積されたコンテキストはモデルの推論スペースを消費し、コストがかかる。/contextによる監査、CLAUDE.mdのトリミング、未使用のMCPツールの無効化により、ベースライン負荷を削減できる。
30K文字未満のコマンド出力は静かな予算キラー
30,000文字を超える出力は自動的に要約に切り詰められるが、合格テストの400行のような中程度の出力はコンテキストに残る。ガイドでは、静音フラグの追加、サブエージェントへのリダイレクト、またはフックを使用したノイズの多いコマンドの書き換えを推奨している。
長いセッションはタスク分割よりも高コスト
各ラウンドは以前のすべてのラウンドを再生するため、40ラウンドのセッションは不釣り合いに高コストとなる。タスク間で/clearを使用し、タスク中に/compactで圧縮し、キャッシュを壊さずに最近のミスを破棄する/rewindを活用することが、コスト効率の高い戦略である。
サブエージェントはノイズの多い高出力タスクのコンテキストを分離
サブエージェントは独立したコンテキストで実行され、最終結果以外のすべてを破棄する。ログ解析のように、保持する必要のない大きな出力を生成するタスクに最適である。固定のノイズの多いタスクには、より小規模なモデル(haiku/sonnet)を使用した専用サブエージェントを定義することが推奨される。