ai for designersJune 25, 20269 min read

Claude Code コンテキスト管理: /clear vs /compact とその他すべて

Claude Code のコンテキストウィンドウを管理する方法。/clear と /compact の本当の違い、/context、/rewind、自動コンパクション、そしてすべてのリセットを生き延えるメモリファイルについて。

By Boone
XLinkedIn
claude code context management

実際の仕事をするコマンドは2つだ。/clear は空のウィンドウで新しい会話を始める。/compact は現在の会話を要約に圧縮して、そのまま続ける。Claude Code のその他のコンテキストコマンドは、ウィンドウを埋めているものを確認するか、問題が起きたときに回復するかのどちらかだ。

これが全体像だ。肝心なのは、インジケーターが赤くなる前にどちらが必要かを知ることだ。

まず基礎から知りたいなら、コンテキストウィンドウとは何かを読んでほしい。この記事はオペレーター向けだ: どのコマンドを、いつ使うか、そして何を失うか。

コンテキストウィンドウを実際に埋めるもの

チャットだけではない。Claude Code はファイルの読み込み、プロジェクトの CLAUDE.md、メモリエントリ、呼び出されたスキルの本文、MCP ツール定義、フック出力、そして会話そのものでウィンドウを埋め尽くす。

/context(または /context all)を実行すれば確認できる。カテゴリ別のトークン使用量をカラーグリッドで表示し、最適化のヒントと容量警告も示す。

なぜこれが重要かというと。MCP サーバーとスキル定義が一言も打つ前にウィンドウの半分を食い尽くしているなら、会話をコンパクトにしてもほとんど意味がない。何が重いかを知ってから、どう削るかを決める必要がある。

複数の入力タイプがスタックしてコンテキストウィンドウを埋める様子を示すボクセル図。
複数の入力タイプがスタックしてコンテキストウィンドウを埋める様子を示すボクセル図。

/clear vs /compact、唯一重要な分岐点

/clear は忘れる。/compact は要約を記憶する。

/clear は空のコンテキストウィンドウで全く新しい会話を始める。以前のチャットは消えない。/resume でアクセスできる状態のまま残る。

/clear <name> と名前を渡せば、新しいセッションにラベルを付けられる。プロジェクトの CLAUDE.md とメモリはディスクから新しいセッションに再読み込みされる。

/compact は同じセッションにとどまる。これまでのすべてを凝縮したベースラインにまとめ、そこから続ける。公式の Claude Code ドキュメントによれば、これが分かれ目だ: 新しいタスクには clear、現在のタスク内でトークンを解放するには compact。

デフォルトは /clear であるべきだ。あるタスクから次のタスクへ積み重なったノイズを引きずるより、速くてクリーンだ。Claude Code チームも声高に同意している。「コンパクトするのをやめろ、/clear を使え」と Claude Code チームの @trq212 は書いた。チームの働き方とコミュニティの働き方のギャップは、大部分がどれだけ頻繁にクリアするかの問題だと彼は述べている。

Medium の著者 Mubashar も同じルールに行き着いた:「デフォルトは clear、継続性が重要なときだけ compact を使う。」

Clear は忘れる。Compact は要約を記憶する。どちらが必要かを知ることが、すべてのスキルだ。

デザインの実践に AI を活用したいなら? Brainy はデザイナーがクラフトを失わずにそれを実現するのを助ける。クリエイター向けに私たちが作っているものを見てほしい。

compact を操る方法

/compact はフリーテキストの指示を受け付ける。使うべきだ。

何も指定しない /compact は Claude に何が重要かを決めさせる。/compact focus on the auth bug/compact keep the database schema は何を保護するかを伝える。ガイド付きの要約は、汎用的なものよりはるかに信頼できる。

これが重要なのは、コンパクションは設計上ロスが生じるからだ。盲目的な compact は必要な詳細を削り落とすことがある。だからこそ、ハンドオフはクリーンアップより優れていることが多い: 必要なものを markdown ファイルにダンプし、/clear を実行し、新しいセッションにそのファイルを指定する。

ほとんどの同一タスク作業では、フォーカスされた /compact で十分だ。詳細を失う余裕がない重要なハンドオフには、まず書き留めること。

/clear が空から始まる様子と /compact が要約を保持する様子を示すボクセルの分割図。
/clear が空から始まる様子と /compact が要約を保持する様子を示すボクセルの分割図。

compact を生き延えるものと、静かに消えるもの

要約の後に再注入されるものがある。他は、再びトリガーするまで消えてしまう。

/compact
システムプロンプトと出力スタイル再注入(メッセージ履歴には存在しない)
プロジェクトルートの CLAUDE.md とスコープなしルール再注入
自動メモリエントリ再注入
呼び出されたスキルの本文再注入
パス制限ルール(paths フィルター付きルール)一致するファイルが再度読まれるまでドロップ
サブディレクトリ内のネストされた CLAUDE.md一致するファイルが再度読まれるまでドロップ
逐語的な会話、正確なツール出力、精密な言い回し失われ、要約に圧縮される

危険な行は静かなものだ。パス制限ルールとネストされた CLAUDE.md ファイルは compact 後にウィンドウから外れ、一致するファイルを再度読んだときだけ戻ってくる。プロジェクトがスコープ付きルールに依存しているなら、compact は告知なしに Claude の動作を変えることがある。

自動コンパクション、オフにできないセーフティネット

会話がコンテキスト制限に近づくと、Claude Code は自動でコンパクトする。手動の /compact と同じ動作だ。

無効にはできない。設定も存在しない。それに逆らうのではなく、それを前提に計画を立てること。

これは問題ない。なぜなら、より良い直感はエッジまで待つのではなく早めにコンパクトすることだからだ。Anthropic の tool-use cookbook は、マルチチケットエージェントの実行で自動コンパクションが入力トークンを約 58% 削減したことを示している。約 204k から 82k まで。hyperdev.matsuoka.com の分析によれば、95% まで待つのではなく 60% 容量前後で積極的にコンパクトし、より良いコンテキスト編集を行うことで、ベースラインと比べて最大 39% のパフォーマンス向上が得られたと報告している。

教訓はシンプルだ。ウィンドウを限界まで使い切るな。クリーンな /clear や早めの /compact は、考えの途中でパニックになった自動コンパクトより優れている。

長い会話スレッドを圧縮されたコンテキスト要約に置き換えるボクセルのイラスト。
長い会話スレッドを圧縮されたコンテキスト要約に置き換えるボクセルのイラスト。

確認と保存: /context、/cost、/export

削る前に確認・保存するための3つのコマンドだ。

/context はカテゴリ別のトークングリッドを表示する。Claude が遅く感じるときはいつでも実行すること。遅さは通常、満杯のウィンドウのせいであって、モデルが鈍いわけではない。

/cost(エイリアス /usage)はセッションコストとプラン使用量の統計を表示する。Pro、Max、Team、Enterprise プランでは、スキル、サブエージェント、プラグイン、MCP サーバー別に使用量を分解して表示する。Max と Pro のサブスクライバーにとって、その金額はプラン使用量であり、別途の請求ではない。

/export [filename] はトランスクリプトをプレーンテキストに書き出す。名前付きファイルへ、またはセーブダイアログを通じて。記録を残したいときは /clear の前に実行すること。

/rewind と /resume、最初からやり直さずに回復する

間違った方向に進んだとき、最初からやり直す必要はない。

/rewind(エイリアス /checkpoint/undo)は以前のチェックポイントにロールバックする。会話の状態、コードの状態、またはその両方を復元したり、選んだメッセージから要約したりできる。キーボードショートカットがある。推測するのではなく /keybindings を実行して現在のバインディングを確認すること。

/resume(エイリアス /continue)は過去の会話を、ピッカー、セッション ID、または名前で呼び戻す。これが /clear の下にあるセーフティネットだ。クリアは決して削除しないので、間違えたクリアは /resume 一つで戻せる。

以前のセッション状態への会話ロールバックを示すボクセルのチェックポイントスタック。
以前のセッション状態への会話ロールバックを示すボクセルのチェックポイントスタック。

メモリファイルは clear と compact の両方を生き延える

CLAUDE.md は耐久性のある層だ。あらゆるものを生き延える。

プロジェクトの CLAUDE.md とメモリファイルは /clear 後に再読み込みされ、/compact 後に再注入される。毎セッション再説明することはそこに属する。チャットではなく。/memory はそれらのファイルを編集用に開き、自動メモリエントリの有効化、無効化、表示を可能にする。

Claude Code のドキュメントによれば、これが CLAUDE.md が不変条件の適切な置き場所である理由だ。「常にテストを実行する」や「スキーマには触れない」といったルールはリセットをまたいで持続し、将来の要約を形成する。事実をそこに押し込めば、毎セッション再説明のコストを払わずに済む。

それでもウィンドウが狭すぎるとき

会話を削ることだけが唯一の手段ではない。他を処理する3つの方法がある。

サブエージェントが最大の手段だ。自己完結したジョブを、自身のフレッシュなコンテキストで実行して結果だけを返すサブエージェントに渡す。メインスレッドはスリムに保たれ、重い作業は別の場所で行われる。大きなタスクでは、これほどスペースを解放するものは他にない。

パス制限の CLAUDE.md とネストされたメモリは、管理するファイルの近くにルールを保つ。そのため、セッション中ずっとウィンドウに居座るのではなく、関連するときだけ読み込まれる。

より大きなウィンドウは助けになるが、雑さを許す理由にはならない。Claude の最新モデル、Opus 4.x と Sonnet 4.x ファミリーおよび Fable 5 は、最大 1M トークンのコンテキストウィンドウをサポートする。満杯のウィンドウは依然として読むのが遅く、コストも高い。だから管理は依然として重要だ。どれだけ大きくなってもコンテキストウィンドウを効率的に使う価値があるのも同じ理由だ。

1つのテーブルでわかる判断ルール

1つのテーブルだ。コピーしておこう。

状況コマンド
タスクが終わり、無関係な新しいタスクを始める/clear
同じ長いタスクを続ける必要があり、スペースが不足/compact
要約に特定のものを保持させたい/compact <instructions>
動作が遅く、何がウィンドウを食っているかわからない/context
間違った方向に進み、コードや会話を元に戻したい/rewind
以前の会話を戻したい/resume
クリアする前に記録を残したい/export
毎セッション同じ事実を再説明している/memory で CLAUDE.md に書く
スレッドを肥大化させる大きな自己完結ジョブサブエージェントに委任する

デフォルトは /clear/compact は1つのタスク内での継続性が目的のときだけ使う。動作が遅いときは /context を実行すること。MCP サーバーとスキルが問題なら、チャットをいくらコンパクトしても解決しないからだ。

よくある質問

/clear と /compact、どちらをより頻繁に使うべきか?

断然 /clear だ。Claude Code チームの公言している習慣、r/ClaudeCode や jdfiscus の LinkedIn ノートでも共鳴されているのは、タスク完了時にクリアし、/compact は1つの長いタスクの中にとどまるためだけに使うことだ。繰り返しのコンパクションに頼る長期チャットは、毎回詳細を失っていく。

/clear は会話を削除するか?

いや。/clear は新鮮なウィンドウを開始するが、以前の会話はそのまま残り /resume でアクセスできる。何も破壊されない。

自動コンパクションはオフにできるか?

できない。自動コンパクションは会話が制限に近づいたときに実行され、無効にする設定はない。解決策は、そこに達する前に意図的にクリアするかコンパクトすることだ。

/compact は実際に何を失うか?

逐語的な詳細だ。正確なツール出力、長いファイルダンプ、以前の精密な言い回しが要約に圧縮される。盲目的な compact は必要な詳細を失うことがある。だからこそ、ガイド付きの /compact <instructions> や markdown ハンドオフがデフォルトより優れている。

コンテキストを埋めているものを確認するには?

/context(または /context all)を実行する。カテゴリ別のトークン使用量をカラーグリッドで表示する: ファイル読み込み、CLAUDE.md、メモリ、スキル、MCP 定義、フック出力、会話、最適化ヒント付きで。

リセットを生き延えるルールはどこに置くべきか?

/memory で編集する CLAUDE.md だ。プロジェクトの CLAUDE.md とメモリは /clear 後に再読み込みされ、/compact 後に再注入される。つまり、持続が保証される唯一のコンテキストだ。

コンテキストを腐らせるのをやめろ

ウィンドウは管理しようとしまいと埋まる。唯一の問題は、意図的に削るか、考えの途中で自動コンパクトにやらせるかだ。

タスクの間はデフォルトを /clear にする。1つのタスクの中では指示付きで /compact を使う。遅くなったら /context を実行し、耐久性のある事実を CLAUDE.md に押し込み、重いジョブはサブエージェントに任せる。それがすべての規律だ。

デザインの実践に AI を組み込んでいるなら、同じ直感があらゆる場所に適用される: マシンをフォーカスさせ続け、クラフトを自分のものに保つ。それがデザイナーのための Claude Codeの背後にある賭けであり、残りを知りたければデザイナー向けの AI についてもっと読むこともできる。

Brainy はデザイナーがクラフトを失わずに AI を活用するのを助ける。クリエイター向けに私たちが作っているものを見てほしい。

Brainy helps designers put AI to work without losing the craft. See what we are building for creators.

Get Started

More from Brainy Papers

Keep reading