コンテキストウィンドウを探索する
Claude Code のコンテキストウィンドウがセッション中にどのように満たされるかのインタラクティブなシミュレーション。自動的に読み込まれるもの、各ファイル読み込みのコスト、ルールとフックが発火するタイミングを確認できます。
Claude Code のコンテキストウィンドウには、セッションについて Claude が知っているすべてのものが含まれます。つまり、あなたの指示、読み込まれたファイル、Claude 自身の応答、およびターミナルに表示されないコンテンツです。以下のタイムラインは、何が読み込まれ、いつ読み込まれるかを説明します。書かれた説明で同じコンテンツをリストとして確認できます。
タイムラインが示すもの
セッションは、代表的なトークン数を含む現実的なフローを通じて進みます。
- 何も入力する前に: CLAUDE.md、自動メモリ、MCP ツール名、スキルの説明がすべてコンテキストに読み込まれます。あなた自身のセットアップは、出力スタイルや
--append-system-promptからのテキストなど、ここにさらに多くのものを追加する可能性があります。これらはシステムプロンプトと同じ方法で入ります。 - Claude が作業するとき: 各ファイル読み込みがコンテキストに追加され、パススコープ付きルールは一致するファイルと一緒に自動的に読み込まれ、PostToolUse フックは各編集後に発火します。
- フォローアップ プロンプト: サブエージェントは独自の別のコンテキストウィンドウで研究を処理するため、大きなファイル読み込みはあなたのコンテキストウィンドウから外れます。サマリーと小さなメタデータトレーラーだけが戻ってきます。
- 最後に:
/compactは会話をまとめられた構造化されたサマリーに置き換えます。ほとんどのスタートアップコンテンツは自動的に再度読み込まれます。以下の表は、各メカニズムに何が起こるかを示しています。
コンパクション後に残るもの
長いセッションがコンパクションされると、Claude Code は会話履歴をコンテキストウィンドウに収まるようにまとめます。あなたの指示に何が起こるかは、それらがどのように読み込まれたかによって異なります。
| メカニズム | コンパクション後 |
|---|---|
| システムプロンプトと出力スタイル | 変更なし。メッセージ履歴の一部ではありません |
| プロジェクトルート CLAUDE.md とスコープなしルール | ディスクから再度注入されます |
| 自動メモリ | ディスクから再度注入されます |
paths: frontmatter を持つルール |
一致するファイルが再度読み込まれるまで失われます |
| サブディレクトリ内のネストされた CLAUDE.md | そのサブディレクトリ内のファイルが再度読み込まれるまで失われます |
| 呼び出されたスキル本体 | 再度注入されます。スキルあたり 5,000 トークン、合計 25,000 トークンでキャップされます。最も古いものが最初にドロップされます |
| フック | 適用されません。フックはコンテキストではなくコードとして実行されます |
パススコープ付きルールとネストされた CLAUDE.md ファイルは、トリガーファイルが読み込まれるときにメッセージ履歴に読み込まれるため、コンパクションはそれらを他のすべてのものと一緒にまとめます。一致するファイルが Claude によって再度読み込まれるときに再度読み込まれます。ルールがコンパクション全体で永続化する必要がある場合は、paths: frontmatter をドロップするか、プロジェクトルート CLAUDE.md に移動してください。
スキル本体はコンパクション後に再度注入されますが、大きなスキルはスキルあたりのキャップに収まるようにトリミングされ、合計予算を超えると最も古い呼び出されたスキルがドロップされます。トリミングはファイルの開始を保持するため、SKILL.md の上部に最も重要な指示を配置してください。
あなた自身のセッションを確認する
ビジュアライゼーションは代表的な数値を使用しています。任意の時点でのあなたの実際のコンテキスト使用状況を確認するには、/context を実行して、カテゴリ別の詳細な内訳と最適化の提案を取得してください。/memory を実行して、スタートアップ時にどの CLAUDE.md と自動メモリファイルが読み込まれたかを確認してください。
関連リソース
タイムラインに示されている機能の詳細なカバレッジについては、これらのページを参照してください。
- Claude Code を拡張する: CLAUDE.md とスキルとルールとフックと MCP をいつ使用するか
- 指示とメモリを保存する: CLAUDE.md 階層と自動メモリ
- サブエージェント: 研究を別のコンテキストウィンドウに委譲する
- ベストプラクティス: コンテキストを主な制約として管理する
- プロンプト キャッシング: キャッシュされたプレフィックスを無効にするアクション
- トークン使用量を削減する: コンテキスト使用量を低く保つための戦略