コンテキスト

Claude Codeで長時間の開発セッションを続けていると、回答の精度が落ちたり、直前の指示を無視されたりした経験はないでしょうか。原因の多くはコンテキストウィンドウの枯渇です。Claude Codeが参照できる情報量には200kトークンという上限があり、この枠をどう配分するかが開発効率を左右します。 コンテキストウィンドウの全体像 ─ 200kトークンの内訳 Claude Codeのコンテキストウィンドウは、ユーザーの入力・過去の会話履歴・ツール定義・システム指示などを含む、AIが一度に扱える情報の総枠です（出典: Anthropic公式ドキュメント）。 200kトークンは日本語で約15万〜20万文字、書籍に換算すると文庫本1冊分に相当します。ただし、この200kのすべてがユーザーの会話に使えるわけではありません。 コンテキスト領域の構成 /context コマンドを実行すると、コンテキストウィンドウの内訳が表示されます。 ⛁ System prompt: 2.9k tokens (1.4%) ⛁ System tools: 19.4k tokens (9.7%) ⛁ MCP tools: 18.1k tokens (9.1%) ⛁ Custom agents: 332 tokens (0.2%) ⛁ Memory files: 1.4k tokens (0.7%) ⛁ Autocompact buffer: 45.0k tokens (22.5%) ⛁ Messages: 8 tokens (0.0%) ⛶ Free space: 164.2k (82.1%) セッション開始時点で、システムプロンプトとシステムツールだけで約11%を消費しています。さらにAutocompactバッファが約22.5%を確保しているため、実質的にユーザーが自由に使える領域は全体の約65%前後です。 項目 平均消費量 制御可否 システムプロンプト 約3kトークン（1.4%） 不可（Anthropic側が管理） システムツール 約19kトークン（9.7%） 一部可（deny設定で削減可能） MCPツール 0〜数十kトークン 可（サーバー数で変動） CLAUDE.md 1〜5kトークン 可（記述量で変動） カスタムエージェント 数百トークン 可（定義数で変動） Autocompactバッファ 約45kトークン（22.5%） 不可（自動圧縮用に確保） メッセージ（会話履歴） セッション進行で増加 可（/compact、/clearで管理） 拡張思考モードとコンテキストの関係 Claude Codeでは拡張思考モード（Extended Thinking）を利用でき、settings.json で alwaysThinkingEnabled: true と設定するとデフォルトで有効になります。拡張思考の出力トークンはそのターンのOutputに含まれますが、次のターンのInputには引き継がれません（出典: Claude Code公式ドキュメント）。 つまり、拡張思考で深い推論を行ってもコンテキストウィンドウを累積的に圧迫しない設計です。複雑な問題で ultrathink を使ってもコンテキスト管理上のリスクは低いと言えます。なお、拡張思考のトークン予算は環境変数 MAX_THINKING_TOKENS で調整可能です（デフォルト: 31,999トークン、0で無効化）。 /context・/compact・/clear ─ 3つのコマンドの使い分け Claude Codeにはコンテキストを管理するための3つの主要コマンドがあります。 /context ─ 現在の消費状況を可視化 /context はコンテキストウィンドウの使用状況を項目ごとに可視化するコマンドです。 ...