Claude Code：セッション管理と100万コンテキスト

著者: Thariq

本日、/usage コマンドに新たなアップデートを導入しました。これは、Claude Codeにおけるご自身の利用状況をより明確に把握していただくためのものです。この決定の背景には、最近ユーザーの皆様と行った数多くの深い対話があります。

これらの対話の中で、私たちは繰り返しある現象を耳にしました：セッション管理の習慣は実に多様だということです。特に最近、Claude Codeのコンテキストウィンドウ（Context Window）が100万トークンにアップグレードされたことで、この違いはさらに顕著になりました。

ターミナルで開いているセッションを1つか2つだけに保つのが習慣ですか？それとも、プロンプトを入力するたびに新しいセッションを開きますか？普段、いつ圧縮（Compact）、巻き戻し（Rewind）、またはサブエージェント（Subagents）を使用しますか？また、圧縮がうまくいかない原因は何でしょうか？

ここには実は重要なポイントがあります。これらの一見些細な詳細が、Claude Codeの使用体験に大きく影響しているのです。そして、このすべての核心は、一つのことに集約されます：コンテキストウィンドウをどのように管理するかということです。

クイック解説：コンテキスト、コンテキスト圧縮、コンテキスト劣化

「コンテキストウィンドウ（Context Window）」とは、モデルが次の回答を生成する際に、同時に「見る」ことができるすべての情報のことです。これには、システムプロンプト（System Prompt）、これまでのチャット履歴、すべてのツール呼び出し（Tool Call）とその出力結果、さらには読み込んだすべてのファイルが含まれます。現在、Claude Codeは100万トークン（Token）（注：トークンは大規模言語モデルがテキストを処理する基本単位で、通常、英単語1語が約1トークン、漢字1文字が1〜2トークンを占めます）という超大容量のコンテキストウィンドウを備えています。

しかし残念ながら、コンテキストを使用するには少し代償が伴います。私たちは通常、これをコンテキスト劣化（Context Rot）（注：会話履歴が長くなるにつれて、モデルが処理する情報量が大きくなり、注意が散漫になり、初期の重要な情報を忘れたり、無関係な内容に干渉されたりする現象）と呼びます。コンテキストが長くなるにつれて、モデルのパフォーマンスは低下する傾向があります。これは、モデルの注意がより多くのトークンに分散されるためです。初期に残された、すでに関係のない内容が、モデルが現在実行しているタスクを妨げ始めるのです。

コンテキストウィンドウには厳格な容量上限があります。そのため、ウィンドウがいっぱいになりそうなときは、現在取り組んでいるタスクを短い説明にまとめ、その説明を持って新しいコンテキストウィンドウで作業を続ける必要があります。私たちはこのプロセスをコンテキスト圧縮（Compaction）（注：メモリ空間を空けるために、超長い履歴を要約して凝縮するプロセス）と呼びます。もちろん、この圧縮プロセスはいつでも手動で開始することもできます。

想像してみてください。あなたはClaudeに何かをさせ、それが完了しました。今、あなたのコンテキストにはいくつかの情報（例えばツール呼び出し、ツールの出力結果、あなたが与えた指示）が詰め込まれています。次に何をすべきでしょうか？あなたは、自分にこれほど多くの選択肢があることに驚くかもしれません：

継続（Continue） — 同じセッション内で、直接次のメッセージを送信する

巻き戻し（/rewind または Escキーを2回連打） — 時間を巻き戻し、以前のメッセージに戻り、そこから再試行する

クリア（/clear） — 通常、直前の会話から抽出した短い要約を持って、全く新しいセッションを開始する

圧縮（Compact） — 現在の会話を要約し、その要約に基づいて作業を続ける

サブエージェント（Subagents） — 次の段階の作業を、自身のクリーンなコンテキストを持つ別のAIエージェント（AI Agent）に委任し、最終的な作業結果のみを取得する

直接「継続」するのが最も自然な反応ですが、他の4つのオプションは、コンテキストをよりよく管理するために設けられています。

いったいいつ長い古いセッションを維持し、いつ新しく始めるべきでしょうか？私たちの経験則は：新しいタスクを始めるときは、新しいセッションも始めるべきだということです。

100万トークンのコンテキストウィンドウは、より長く、より複雑なタスクを非常に確実に完了できることを意味します。例えば、Claudeにゼロからフルスタックアプリケーションを構築させることなどです。

しかし時には、前後に関連するタスクを行っているかもしれません。この場合、以前のコンテキストの一部を保持する必要がありますが、全部ではありません。例を挙げると、あなたは新しい機能を書き終えたばかりで、それを使用するためのドキュメントを作成しようとしています。もちろん新しいセッションを開くこともできますが、それはClaudeがあなたが書いたすべてのコードファイルを再び読み込まなければならないことを意味します。これは速度が遅く、コストも高くなります。

もし私が「優れたコンテキスト管理能力」を代表する良い習慣を一つ選ばなければならないなら、それは間違いなく「巻き戻し（Rewind）」をうまく使うことです。

Claude Codeでは、Escキーをダブルクリックすることで巻き戻しが可能です。

AIの誤りを修正する際、「巻き戻し」はより賢明な方法であることが多いです。例を挙げます：Claudeが5つのファイルを読み、ある方法を試みましたが、失敗しました。あなたの本能的な反応は、チャットボックスに「この方法はうまくいかない、X方法を試してみて」と打ち込むことかもしれません。しかし、より賢い方法は、Claudeがちょうどその5つのファイルを読み終えた時点に巻き戻し、あなたが学んだ教訓を持って「A方法を使わないでください。fooモジュールはそれをサポートしていません。直接B方法を試してください」と指示し直すことです。

あなたは「ここから要約（summarize from here）」機能を使用して、Claude自身に学んだ教訓を「引き継ぎメッセージ」としてまとめさせることもできます。これは、ちょうど失敗を経験した「未来のClaude」が、まだ行動を始めていない過去の自分自身にメモを残したような感覚です。

セッションがどんどん長くなるにつれて、それを「軽くする」ための2つの方法があります：/compact を使用するか、/clear を使用するかです。

圧縮（Compact）は、モデルにこれまでの会話を要約させ、その要約で冗長な履歴を置き換えることです。このプロセスは「損失あり」で、あなたは「何が重要か」を決定する権限をClaudeに委ねていることを意味します。利点は、あなたが何も書く必要がなく、Claudeが重要な教訓やファイル記録を保持する際に、あなたが考えるよりも適切に行う可能性があることです。また、指示を与えることで圧縮の方向性をコントロールすることもできます（例：/compact 認証モジュールのリファクタリングに焦点を当て、テストデバッグに関する内容は捨てる）。

もしあなたが頻繁に超長いセッションを開いたままにしているなら、おそらく「圧縮」の効果が極めて悪い状況に遭遇したことがあるでしょう。私たちは、このような「失敗」が通常、特定の瞬間に起こることを発見しました：それは、大規模言語モデル（LLM）があなたの次の作業の方向性を予測できないときです。

例を挙げると、長いコードデバッグの後、システムが自動圧縮を開始し、以前の調査プロセスをまとめました。その直後、あなたが「さて、前にbar.tsで見た別の警告も修正しよう」と発言したとします。

しかし、直前のセッションの焦点が前のバグのデバッグに完全に当てられていたため、まだ修正されていない警告は、おそらくすでに無関係な情報として扱われ、要約時に直接捨てられてしまったのです。

これは非常に厄介な問題です。なぜなら、コンテキスト劣化の制限により、モデルが圧縮を行う瞬間は、しばしばその「知能」が最も低下しているときだからです。幸いなことに、100万トークンのコンテキスト容量があれば、あなたは今、より豊富なスペースを持ち、「次に何をしたいか」の説明を積極的に添えて、事前に /compact を実行することができます。

サブエージェントもまた、コンテキストを管理する優れた手段です。あなたが事前に、ある作業が大量の「使い捨て」（後で二度と使わない）中間結果を生み出すと予測するとき、この方法は特に有効です。

Claudeがエージェントツール（Agent tool）を通じてサブエージェントを派生させるとき、この小さな存在は完全に新しいコンテキストウィンドウを獲得します。それはその中で自由に作業し、いくらでも作業を行うことができます。作業が完了すると、結果を抽出し、最終的なレポートのみを「親」Claudeに返します。

私たちがサブエージェントを使用すべきかどうかを判断する「核心的な問い」は：今後、これらのツール実行の詳細な出力を見る必要があるか、それとも最終的な結論だけが欲しいか？です。

Claude Codeは背後で自動的にサブエージェントを呼び出すことがありますが、時にはあなたが非常に明確に指示することもできます。例えば、次のように言うことができます：

「サブエージェントを派遣して、以下の仕様ファイルに基づいて、私たちが行った作業が正しいかどうかを検証させてください」

「サブエージェントを派遣して、別のコードベースを読み通し、それがどのように認証フローを実装しているかをまとめさせ、それからあなた自身がそれを参考に、こちらでも実装してください」

「サブエージェントを派遣して、私のGit変更履歴に基づいて、この新機能の説明ドキュメントを作成させてください」

要するに、Claudeが一連の回答を完了し、あなたが新しいメッセージを送信しようとしているとき、あなたは決断の岐路に立っています。

私たちは将来、Claudeが十分に賢くなり、これらすべてをあなたに代わって管理してくれることを期待しています。しかし現時点では、これらの決断を習得することこそが、Claudeを導いて高品質の結果を生み出すための必須の道なのです。