Claude Code のコンテキスト管理：/compact・/clear の使い分けと /context の読み方

コンテキストウィンドウの中身と消費され方

コンテキストは Claude の作業メモリ。あなたのプロンプトも、読んだファイルも、ツール結果も、ここから差し引かれます。

1. 1

   上限のある窓だと考える

   コンテキストウィンドウとは、Claude がプロジェクト作業の間、作業メモリとして保持できる容量のことです。入れられる量には限りがあるからこそ、何を入れるかの最適化が重要になります。

   

2. 2

   Claude のあらゆる動作が積み重なる

   プロンプトを入力するたび、Claude がファイルを読むたび、ツールを呼び出して結果を受け取るたびに、それらがコンテキストウィンドウに追加されていきます。このスクリーンショットのような一連のレビュー——問題リストとファイル読み込み——だけでも、はっきり測れるほどのコンテキストになります。

   

3. 3

   /context で残量をチェック

   /context コマンドを実行すると、コンテキスト使用量の全体像が見えます。カラーのグリッド、使用済み合計——この例では 200k トークンのうち 21k で 11%——そしてシステムプロンプト・システムツール・カスタムエージェント・skills・メッセージのカテゴリ別内訳に、空き容量と自動コンパクト用の予約バッファまで表示されます。

   

自動コンパクトと手動 /compact

ウィンドウが尽きかけると Claude Code が自動で要約します。同じクリーンアップを /compact で好きなタイミングで実行することもできます。

1. 4

   上限接近で自動コンパクトが発動

   上限に近づくと、コンテキストウィンドウは自動的にコンパクトされます。重要な情報は要約され、不要になったツール結果が削除され、多くの空きが生まれます。動画が注意しているのは、この自動処理で会話前半の詳細が失われる可能性があるという点です。

   

2. 5

   /compact で手動コンパクト

   /compact コマンドを使えば、コンパクトを自分で実行できます。その時点までの作業すべてが要約に置き換わるので、コンテキストの空きを作りつつ、これまでの作業の記憶も残したいときに便利です。タスクの途中で自動コンパクトに割り込まれるより、自分でタイミングを選ぶほうが安全です。

   

3. 6

   コンパクト後に残るもの

   コンパクト後、記録には現状の要約が残ります。Current Work（現在の作業）、Optional Next Step（次の一手）、そしてディスク上の完全なトランスクリプト .jsonl ファイルへのパス。圧縮前の正確なコード片やエラーメッセージが必要になったら、そちらを参照できます。

   

4. 7

   要約の上で作業を続ける

   セッションはサマリーの直後から再開します。"Conversation compacted (ctrl+o for history)" の表示、読んだファイルを一覧する /compact ブロック、そして Claude がすぐに「次に何をすべきか」を尋ねてくる——古いツール結果の荷物を下ろしたまま、同じ機能の開発が進みます。

   

クリアすべきタイミング

新機能には白紙が一番。古いコンテキストは新しい作業の邪魔になるだけです。

1. 8

   2つのコマンド、2つの意図

   スラッシュメニューの説明がそのまま違いを語ります。/compact は会話履歴を消しつつサマリーをコンテキストに残し、/clear はコンテキストを丸ごと解放します。動画の経験則：同じ機能を続けていてウィンドウを超えそうなら compact。完成して新機能に移るなら clear。古い会話に新しい作業をバイアスさせないためです。

   

2. 9

   /clear で完全にまっさらに

   /clear を実行するとすべてが削除され、セッションはウェルカム画面に戻ります。内容も最近のアクティビティもありません。以前の会話が次の作業に漏れ出すことは一切ありません。

   

コンテキストを小さく保つ習慣

メモリは CLAUDE.md へ、MCP は取捨選択、skills は必要なときだけ、道中はサブエージェントに任せる。

1. 10

   長期の記憶は CLAUDE.md へ

   別のセッションでも覚えておいてほしいことは、CLAUDE.md ファイルに書きましょう。プロジェクトのコマンド、規約、アーキテクチャメモなどです。そうすれば Claude は毎回ゼロから再発見せずに済みますし、その知識が会話履歴の圧縮で失われることもありません。

   

2. 11

   使わない MCP サーバーはオフに

   MCP サーバーはデフォルトでツール全体をコンテキストに読み込みます。この監査画面では、読み込まれた Slack と Notion のツールが何ページも続いています。プロジェクトに関係のない MCP サーバーがあれば、オフにするだけでコンテキストを大幅に節約できます。

   

3. 12

   常駐ツールより skills を

   skills は MCP サーバーと似た働きをしながら、中身をまるごとコンテキストに投入しません。SKILL.md ファイルはディスク上に留まり、実際に必要になったときだけ読み込まれます。常駐ツールで処理していた定型ワークフローを skills に移せば、そのぶん作業本体にウィンドウを回せます。

   

4. 13

   道のりはサブエージェントへ、答えだけ受け取る

   サブエージェントは完全に独立したコンテキストウィンドウで動き、メインエージェントには要約だけを返します。「認証エンドポイントはどこにある？」のように、答えさえあればいいタスクはサブエージェントに任せましょう。調査の過程がメインの会話を汚すことはありません。

   

関連する Claude Code ガイド