コンテキスト管理術とは

コンテキスト管理術とは、長いAI作業の途中でコンテキストウィンドウをあふれさせず、応答の質と料金を保つための運用の工夫のことです。読み方は「こんてきすとかんりじゅつ」です。枠の大きさという仕様を前提に、その枠を日々の作業でどう使い回すかを扱います。

管理が要る理由は2つあります。1つは精度です。Anthropic 社の公式ドキュメントは、入力のトークン数が増えるほど精度と想起が落ちると説明しています。もう1つは料金です。AIコーディングエージェントの公式ドキュメント（コスト管理のページ）は、トークンの消費は文脈が大きいほど増え、会話の全体が毎回のリクエストで送られると書いています。一日開きっぱなしのセッションで1行の質問をしても、それまでの履歴全体の分が消費されます。

ここでは、公式ドキュメントに手順がある Claude Code を例に、5つの手を順に並べます。

1. 測る：/context で何が枠を使っているかを見ます。/usage ではセッションのトークン消費が分かります。
2. 区切る：無関係な作業に移るときは /clear で会話を新しくします。公式ドキュメントは、続きを要らない場面では /clear に費用はかからないとしています。
3. 要約して縮める：/compact は古い履歴を要約に置き換えます。/compact テストの出力とコードの変更点を残して のように、残す内容を指定できます。枠の上限が近づくと自動でも要約されます。
4. 外に逃がす：テストの実行やログの読み込みのように出力が大きい作業は、サブエージェントに任せます。長い出力はサブエージェント側の枠にとどまり、要約だけが戻ってきます。フックで ERROR を含む行だけに絞ってから読ませる方法もあります。
5. 引き継ぐ：区切る前に、決まったことと次の一手を progress.txt などに書かせます。Anthropic 社のガイドは、新しい枠で始めるときに進捗ファイル、テスト結果、バージョン管理（git）の履歴を読ませる方法を紹介しています。

API で自作のエージェントを動かす場合も、同じ考え方が使えます。Anthropic 社の API には、古いやり取りをサーバー側で要約に置き換えるコンパクション（2026年9月時点でベータ）や、古いツール結果を消すコンテキスト編集の機能があります。

午前に認証まわりの不具合を直し、午後に別の画面の文言を変える、という1日を考えます。

• 不具合の調査中は、テストの全出力を毎回読ませず、失敗した行だけを見せます。
• 直し終えたら、原因と修正内容を NOTES.md に3行で書かせ、コミットします。
• 午後の作業に入る前に /clear。午前の調査ログは午後の作業には不要です。
• 翌日に続きをするときは、NOTES.md と git log を読ませるところから始めます。

ポイントは、区切りを作業の切れ目に合わせることです。枠がいっぱいになってから慌てて要約するより、話題が変わるたびに区切るほうが、残す情報を自分で選べます。

• 誤解：要約（コンパクション）すれば、中身はそのまま残る
  実際：要約なので、細部は落ちることがあります。Anthropic 社の資料も、既定の要約で後の作業に必要なものが落ちる場合に備えて、要約の指示を自分で書く方法を用意しています。
• 誤解：要約は枠を空けるだけなので、費用はかからない
  実際：要約するには会話全体を読む必要があり、大きな会話の要約はそれ自体が大きなリクエストになると公式ドキュメントは書いています。
• 誤解：枠が100万トークンあれば、管理はいらない
  実際：枠に収まっていても、長くなるほど精度は落ち、1回ごとの消費も増えます。枠の大きさは管理を不要にするものではありません。

• コンテキストウィンドウ
• コンテキストエンジニアリング
• コンテキストキャッシュ
• プロンプトエンジニアリング
• マルチエージェント
• 推論コスト

• AIコーディングエージェントの料金を抑える使い方
• 複数のAIコーディングエージェントをどう役割分担させるか
• AI時代のGit運用｜コミット分割と差分レビューの実践手順を解説

• コストの管理とトークン消費の削減（AIコーディングエージェント公式ドキュメント）：/context、/clear、/compact、サブエージェントやフックへの委譲、長いセッションで消費が増える理由
• コンパクションの概要（API 公式ドキュメント）：古いやり取りを要約に置き換える仕組みと、要約の指示を自分で書く方法
• コンテキストウィンドウと context rot（API 公式ドキュメント）：トークン数が増えるほど精度と想起が落ちるという説明、コンテキスト編集
• 複数の枠にまたがる作業の進め方（API 公式ドキュメント）：新しい枠で始めるときに進捗ファイルや git の履歴を読ませる方法

Q1. コンテキスト管理術とは何ですか？
長いAI作業の途中でコンテキストウィンドウをあふれさせず、応答の質と料金を保つための運用の工夫です。使用量を測る、作業の切れ目で区切る、履歴を要約する、重い出力を外に逃がす、ファイルで引き継ぐ、の組み合わせで行います。

Q2. /clearと/compactはどう使い分けますか？
前の会話の続きが要らないなら /clear、続きの作業で前の流れを保ちたいなら /compact です。/clear は費用がかかりませんが、履歴は残りません。/compact は流れを要約で残せますが、要約そのものに大きなリクエストが必要です。

Q3. 会話を区切ると、それまでの決定事項は失われますか？
会話の中にしかない情報は失われます。区切る前に、決まったことと次の作業をファイルに書かせておけば、新しい会話でそのファイルを読ませて再開できます。プロジェクト全体の約束事は、毎回読み込まれる指示ファイルに書いておきます。