ClaudeCodeのコンテキストとは？仕組み・管理方法・上手な使い方を徹底解説
テックジム東京本校では、情報科目の受験対策指導やAI駆動開発コースもご用意しております。
目次
この記事でわかること
- Claude Code における「コンテキスト」の意味と仕組み
- コンテキストウィンドウに何が入っているか
- コンテキストが満杯になったときの対処法
- パフォーマンスを落とさないコンテキスト管理のベストプラクティス
Claude Code のコンテキストとは？
Claude Code を使い始めると、必ず目にするのが「コンテキスト」という概念です。コンテキストとは、AIモデルが一度に処理・参照できるすべての情報のまとまりのことです。言い換えると、Claude Code が「今見ている」情報の総量です。
会話の履歴、読み込んだソースファイルの中身、実行したコマンドの出力、設定ファイル（CLAUDE.md）の内容――これらはすべてコンテキストとして扱われます。コンテキストの外側にある情報は、Claude Code には見えません。どれだけ重要な情報であっても、コンテキストに含まれていなければ存在しないのと同じです。
コンテキストウィンドウとは？
コンテキストが収まる「器」のことをコンテキストウィンドウと呼びます。Claude Code のコンテキストウィンドウは最大 20万トークン（200,000 tokens）で、これは小説一冊分に相当する膨大な量です。
ただし、このウィンドウは1セッション限りです。セッションを閉じると、コンテキストウィンドウの内容はすべて消去されます。次のセッションを開いたとき、Claude Code は何も記憶していない状態からスタートします。
ポイント：コンテキストウィンドウは「短期記憶」、CLAUDE.md などのファイルは「長期メモ」と考えると理解しやすいです。
コンテキストウィンドウの中身
/context コマンドを実行すると、コンテキストウィンドウの占有状況を視覚的に確認できます。ウィンドウの中には大きく分けて以下の要素が含まれています。
1. システムプロンプトとシステムツール（固定）
Anthropic が Claude Code の動作を制御するために組み込んでいる部分で、ユーザーが変更することはできません。これだけで全体の約30%を占めています。
2. 会話履歴
ユーザーの入力（メッセージ）と Claude の返答が交互に積み重なります。ターンが増えるほど、この部分が膨らんでいきます。
3. ファイルコンテンツ
Claude Code が読み込んだソースファイルやドキュメントの内容が入ります。大きなファイルを読ませるとコンテキストを大量に消費します。
4. コマンド出力
ターミナルで実行されたコマンドの標準出力・エラー出力もコンテキストに含まれます。
5. CLAUDE.md（メモリファイル）
プロジェクトルートや ~/.claude/ に置いた CLAUDE.md の内容が読み込まれます。ここに書いたルールや指示は常にコンテキストに存在します。
6. MCPサーバーのスキーマ
接続している MCP サーバーのツール定義（スキーマ）が自動的に保持されます。使わないサーバーを接続し続けると、無駄なコンテキストを消費するため注意が必要です。
なぜコンテキスト管理が重要なのか
コンテキストウィンドウは有限のリソースです。単に「大きければ良い」というわけではありません。
コンテキストが増えるとパフォーマンスが落ちる
「Context Rot（コンテキスト腐敗）」と呼ばれる現象が報告されています。コンテキストウィンドウ内のトークン量が増えるにつれ、タスクの成功確率が低下する傾向があります。推論が必要なタスクでは、この劣化がより顕著です。また、関連しているようで実は正しくない情報に引きずられやすくなるという問題も指摘されています。
「中間で失われる」問題
LLMには、長いコンテキストの先頭と末尾の情報は正確に記憶する一方で、中間に埋もれた情報を見落としやすいという特性があります。500ページの文書の真ん中に書かれた重要な仕様は、コンテキストに含まれていても読み飛ばされる可能性があります。
コストへの影響
API のコストは処理するトークン数に比例します。コンテキストを無駄に大きくすると、それだけ費用がかかります。
コンテキスト管理の実践テクニック
/context でリアルタイム確認
現在のコンテキスト占有状況を視覚的に確認できます。どの要素が何%を使っているかが一目でわかります。
/compact で手動圧縮
会話の要点を維持しながらトークンを削減するコマンドです。会話の文脈は保たれるため、作業を継続できます。
推奨タイミング：
- 使用率が 80〜90% に達したとき
- 会話のテーマが切り替わる前
- 複雑なタスクを依頼する前
auto-compact（自動圧縮）
使用率が 95% を超えると自動で発動します。ただし、作業の途中で発動すると文脈が途切れるリスクがあります。/config の Auto-compact 設定から有効・無効を切り替えられます。
/clear で完全リセット
会話履歴をすべてクリアして、コンテキストを空にします。CLAUDE.md の内容は保持されます。テーマが大きく変わるときや、まっさらな状態で新しいタスクを始めたいときに使います。
CLAUDE.md に永続ルールを書く
コンテキストがリセットされても残したい指示やルールは、CLAUDE.md に記録しておきます。たとえば「パッケージマネージャには uv を使う」「テストは pytest で書く」といったプロジェクト固有のルールをここに集約します。
# CLAUDE.md の例
## 開発ルール
- パッケージ管理: uv を使うこと
- テスト: pytest で記述すること
- コメント: 日本語で書くこと
## Summary instructions
コンパクトを使用する時は、コードの変更内容にフォーカスしてください。
Plan Mode を活用する
Shift+Tab を2回押すか /plan コマンドで Plan Mode を起動します。Claude Code が実装計画を立ててからタスクを実行するモードで、コンテキストをリセットした状態で「必要最小限の計画」に基づいて作業を進められます。
サブエージェントで分離する
Claude Code は内部的にサブエージェントを使い、コードベースの調査などトークンを大量消費するタスクを別のコンテキストウィンドウに分離します。サブエージェントは作業完了後に「要約」だけをメインセッションに返すため、メインのコンテキストを肥大化させません。長いセッションでは、この分離が品質維持に大きく貢献しています。
MCPサーバーは必要なものだけ接続する
MCPサーバーを追加するたびに、そのスキーマ定義（使わないメソッドも含む）がコンテキストに常駐し続けます。本当に必要なサーバーだけを有効にし、不要なものは無効化しておきましょう。
コンテキストとセッション間の「記憶」の違い
よくある誤解として、「Claude Code はセッションをまたいで記憶してくれる」というものがあります。しかし実際には、セッションが終了するとコンテキストウィンドウの内容はすべて消去されます。
| 種類 | 保持期間 | 具体例 |
|---|---|---|
| コンテキストウィンドウ | セッション中のみ | 会話履歴、読み込んだファイル |
| CLAUDE.md | 永続（ファイルが存在する限り） | ルール、指示、プロジェクト情報 |
| トレーニングデータ | 永続（モデルに組み込み済み） | プログラミング知識、一般常識 |
セッションをまたいで情報を引き継ぐには、CLAUDE.md に重要な決定事項・方針・進捗を記録しておくことが基本的な対策です。
まとめ：Claude Code のコンテキストを使いこなすポイント
Claude Code のコンテキストを正しく理解することで、AI の出力品質を安定させ、API コストも抑えられます。以下のポイントを押さえておきましょう。
- コンテキストウィンドウは有限：最大20万トークンだが、使いすぎると品質が落ちる
- システム側が約30%を占有：ユーザーが使えるのは残りの70%程度
/compactを使う：使用率80〜90%になったら手動で圧縮する- CLAUDE.md に永続情報を書く：セッションをまたいで残したいルールはここへ
- MCPサーバーは絞る：不要なスキーマがコンテキストを圧迫する
- Plan Mode を活用：クリーンなコンテキストで計画的に作業する
コンテキスト管理を意識するだけで、Claude Code のパフォーマンスは大きく変わります。ぜひ日々の開発に取り入れてみてください。
参考リンク
■ゼロから始めるClaudeCode講座のご案内
テックジム東京本校では「ClaudeCode」の体験講座を開催。
「その日のうちに動かす」 をゴールに、環境構築から実践まで。
毎週土曜日15時。参加は無料です。対面・ハンズオンだから初心者でも安心。
■らくらくPython塾 – 読むだけでマスター
共通テスト「情報I」対策解説講座
実践で学ぶPython速習講座
■テックジム東京本校
格安のプログラミングスクールといえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
対面型でより早くスキル獲得、月額2万円のプログラミングスクールです。
情報科目の受験対策指導やAI駆動開発コースもご用意しております。
