Claude Code compactとは？自動圧縮のタイミングと/clearとの違い、要約後に何が残るかを実測

Claude Code の compact（/compact）とは？

Claude Code の compact は、ここまでの会話をClaude自身に要約させ、会話の履歴をその要約に置き換えて文脈（コンテキスト）の空きを作る機能です。手で実行する /compact と、文脈が一定量に達すると走る自動圧縮があり、2026年10月からは放置中の自動圧縮も加わりました。要約されたあとも作業は同じ会話の続きとして進みます。

Claude は会話のたびに、それまでのやり取り・読んだファイルの中身・コマンドの出力をまとめて読み直しています。この「一度に読める量」が文脈の窓（コンテキストウィンドウ）で、長く作業するほど埋まっていきます。窓が埋まると続けられないため、古いやり取りを短い要約にまとめ直すのが compact の役割です。

Anthropic で Claude Code の開発に関わる Cal Rueb 氏は、公式カンファレンス Code with Claude の講演で /compact の中身を次のように説明しています。

「/compact を実行すると、『これまでの作業を全部要約して、別の開発者に渡す。その人が続きから引き継ぐ』といったユーザーメッセージが差し込まれるようなものです。その要約が次のセッションの出発点になります。」

"you can run slash compact and what'll happen is basically it's like a user message is inserted and it just says something like hey I need to go summarize everything we've been up to. I'm going to give this to another developer and they're going to pick up where I left off. And then that summary is what kind of seeds the next session."

Cal Rueb（Anthropic・Applied AI、Claude Code コアコントリビューター）— Claude Code best practices | Code w/ Claude 14:24

事務所の仕事に置き換えると、担当者が交代するときの引き継ぎメモに近いものです。メモに書かれたことは次の担当者に伝わり、書かれなかった細部は伝わりません。compact を上手に使うコツは、この「引き継ぎメモに何を書かせるか」を決めることに尽きます。

compact が起きる5つの場面

自動圧縮（auto-compact）はいつ発動する？

2026年10月時点の Claude Code では、100万トークンの文脈を持つモデル（Sonnet 5.5・Opus 5.5・Haiku 5.5・Fable など）は約96.7万トークンに達したところで自動圧縮します。20万トークンの窓で動くモデルや設定では、その上限で圧縮します。発動点は /autocompact で10万〜100万トークンの範囲に下げられ、設定はモデルごとに保存されます。

日本語の解説記事には「上限の80〜95%で自動圧縮が走る」と割合だけで説明したものが今も多く見つかりますが、100万トークン窓が標準になった今は、何トークンで走るかを具体的に押さえておくほうが実用的です。現在の既定値は Anthropic のモデル設定のドキュメントに、次のように整理されています。

この「96.7万」という数字については誤解も生まれました。2026年10月9日、X に「自動圧縮は直近100万トークンをそのまま読み込んでいるのか」という投稿があり、翌10日（日本時間）に Claude Code チームの Lydia Hallie 氏が説明を投稿しています（10月15日時点で54.8万表示・ブックマーク2,300）。

「自動圧縮はちゃんと要約しています。走ると会話全体が短い要約に置き換わり、直近の100万トークンを残すわけではありません。約967Kというのは100万トークン窓のモデルで動くときだけの話です。」

"auto-compact does summarize. When it runs, your whole conversation is replaced by a short summary. It doesn't keep the last 1M tokens around. The ~967K is only when it runs on 1M models."

Lydia Hallie（Anthropic・Claude Code）— X への投稿（2026年10月10日）

同氏は続けて、96.7万まで待つことの本当の問題は圧縮そのものではなく、そこに至るまでの1回1回のやり取りが会話全体を抱えて重くなることだと述べ、/autocompact 400k で40万トークンの時点で要約させる方法を示しています。費用の話は後の節で詳しく扱います。

/autocompact で発動点を変える方法

自動圧縮の発動点（auto-compact window）は、次の4つの方法で変えられます。普段使いなら1つ目の /autocompact だけで足ります。

/autocompact 400k     # 今のモデルは40万トークンで自動圧縮（次回以降も有効）
/autocompact          # 現在の設定を確認
/autocompact auto     # モデルごとの既定値に戻す

当研究所の見解では、書類作成やデータ整理のように1件ずつ区切りがある業務なら、発動点を20万〜40万トークンに下げておくのが扱いやすい設定です。96.7万トークンは日本語の文章ならA4で数百〜千ページ規模にあたり（当研究所の概算）、そこまで1つの会話に積み上げる業務はまれです。早めに要約させるほど、1回あたりのやり取りが軽くなります。

compact すると何が残り、何が消える？（実測）

compact のあとも、CLAUDE.md・自動メモリ・直近に読んだファイル・使ったスキル・直近のやり取りは残り、会話の中で伝えた決定事項も引き継がれます。消えやすいのは、Claude が途中で自分で書いた分析や集計の細部です。手元の検証では、指示なしの /compact で最初のまとめの内容が2回とも正確には残らず、「金額を残して」と指示すると2回とも残りました。会話で伝えただけのルールは、圧縮後の書類作成で守られないことがありました。

公式ドキュメントにある「残るもの」の一覧

公式ドキュメントは、会話の初めのほうで伝えた細かな指示は要約で失われることがあるとして、ずっと守らせたいルールは CLAUDE.md に書くよう勧めています（How Claude Code works）。これが実際にどの程度起きるのかを確かめるため、架空の税理士事務所の会話で試しました。

検証：顧問先8社の月次業務の会話を /compact してみた

Claude Code v2.1.300（Sonnet 5.5、Claude Max）で、顧問先8社分の試算表と仕訳帳（各300仕訳）を読ませる会話を5ターン行いました。途中で「K-104 は今月の報告書を作らず11月10日に10月分とまとめて出す」「K-102 の役員報酬は11月支給分から月額60万円を70万円に改定」などの決定事項を伝え、K-101 の報告書の下書きを reports/K-101.md に作らせ、「金額は必ず税抜と明記し、顧問先はコードで書く」というルールも会話の中で指示しています。

この会話を同じ地点から枝分かれさせて、圧縮しない場合・指示なしの /compact・残す内容を指示した /compact・CLAUDE.md に要約の方針を書いた場合を比べました（圧縮しない場合は1回、それ以外は各2回）。圧縮のあとで、まずメール用の文を1つ書かせて書式ルールが守られるかを見て、次にファイルを読まずに7つの質問に答えさせています。

結果から読み取れることは5つです。

当研究所の見解では、業務での使い方は次のようにまとめられます。決定事項は自分の言葉で伝え、守らせたいルールは CLAUDE.md に書き、Claude が出した集計や分析の結果のうち後で使うものはファイルに書き出させる。要約に頼らずファイルに残しておけば、圧縮されても /clear しても失われません。また圧縮の直後に、元のファイルを読み直さず要約の「+17.4%」から前月の金額を逆算して答えた回が1回ありました（本人が概算と明記）。圧縮のあとに数字を使う書類を作らせるときは、「試算表を読み直してから」と一言添えるのが安全です。

自動メモリは便利な反面、同じフォルダで別の顧問先の作業をすると前の顧問先の情報まで読み込まれます。顧問先や案件ごとにフォルダを分けるのが前提です。自動メモリの仕組みと注意点は「Claude Codeの自動メモリの盲点」で解説しています。

/compact と /clear・/rewind の違いと使い分け

/compact は「会話を要約して続ける」、/clear は「会話を空にして新しく始める」コマンドです。同じ作業を続けるなら /compact、無関係な作業や別の顧問先に移るなら /clear を使います。途中で道を間違えた場合は、要約より /rewind で巻き戻すほうが確実です。

士業の業務では、顧問先や案件が変わるときは /compact ではなく /clear が安全です。要約には前の顧問先の金額や氏名も書き込まれるため、次の書類にそれが紛れ込む余地が残ります。/clear で消した会話も、/resume で後から開き直せます。コマンド全体の使い分けは「Claude Code コマンド一覧」にまとめています。

/rewind の「Summarize from here（ここから後を要約）」と「Summarize up to here（ここまでを要約）」は、会話の一部だけを畳む機能です。前半の下調べは要約にして、直近の作業はそのまま残したいときに使えます。入力欄が空のときに Esc を2回押しても同じメニューが開きます。

compact の費用は？トークンの節約になるのはどんなとき？

/compact の要約は、会話全体を読み込む1回の追加リクエストです。ただしキャッシュ（直前に読んだ内容の再利用）が効いている間は大半が安い単価の「キャッシュ読み」になるため、文脈の大きさの割に費用は小さく済みます。節約効果が大きいのは要約のあとで、以降のやり取り1回ごとに読み直す量が減ります。

Claude Code は毎回のやり取りで、システムの指示・CLAUDE.md・それまでの会話をまとめて送り直しています。会話が40万トークンなら、短い質問1つでも40万トークン分を読み直すことになります。その大半はキャッシュから読まれるので通常の入力より安くなりますが、Lydia Hallie 氏が指摘しているとおり、キャッシュ読みも使用量には数えられ、会話が伸びるほど積み上がります。

要約のリクエストはなぜ安いのか

Claude Code の要約は、会話と同じシステムの指示・ツール定義・履歴をそのまま送り、最後に「要約して」という指示を1つ足す形で作られます。先頭が直前のリクエストと一致するのでキャッシュがそのまま使えます。Claude Code チームの Thariq Shihipar 氏は、この設計の理由を Anthropic の開発者ブログで説明しています。

「圧縮を実行するときは、親の会話とまったく同じシステムプロンプト、ユーザー文脈、システム文脈、ツール定義を使います。親の会話のメッセージを前に置き、最後に圧縮の指示を新しいユーザーメッセージとして足します。」

"When we run compaction, we use the exact same system prompt, user context, system context, and tool definitions as the parent conversation. We prepend the parent's conversation messages, then append the compaction prompt as a new user message at the end."

Thariq Shihipar（Anthropic・Claude Code チーム）— Lessons from building Claude Code: Prompt caching is everything（2026年4月30日）

裏を返すと、キャッシュが切れたあとの /compact は高くつきます。Anthropic のドキュメントは、キャッシュの有効期間を過ぎてから要約すると全履歴をキャッシュなしの単価で読み直すことになり、古いセッションを再開して /compact するときが最も費用がかかると説明しています。

手元の計測：13.6万トークンの会話を圧縮すると費用はどう変わるか

前の節の検証（Sonnet 5.5、約13.6万トークンの会話）の記録から、1回ごとの費用を Anthropic の定価で計算し直すと次のようになりました。Claude Max で実行したため実際の請求はなく、プランの使用量として数えられる分を金額に直した目安です。

この規模では、圧縮で1回あたり約0.007ドル安くなる一方、圧縮と直後の1回目で合わせて約0.15〜0.17ドルが上乗せされるため、費用だけで見ると元が取れるのはおよそ20往復先です。13万トークン程度の会話なら、費用を理由に急いで圧縮する必要はあまりありません。

差が大きくなるのは会話が育ってからです。計算上の目安として、60万トークンの会話ではキャッシュ読みだけで1回約0.06ドルかかるため、圧縮して4万トークン前後に戻せば1回あたり約0.05ドル安くなり、数往復で回収できます。Lydia Hallie 氏が /autocompact 400k を勧めているのはこの領域の話で、compact は「費用の節約」より「会話を重くしすぎない」ための機能と捉えるのが実態に合っています。

要約のタイミングで費用を抑える3つのポイント

放置中の自動圧縮とは？止め方と実機で試した結果

放置中の自動圧縮（idle compaction）は、長い会話をしばらく放置したとき、キャッシュが切れる直前に Claude Code が会話を要約しておく機能です。2026年10月14日公開の v2.1.299 の変更履歴で告知されました。戻って最初のメッセージで全履歴を読み直す費用を避けるためのもので、止めたい場合は settings.json に "idleCompaction": false と書きます。

Anthropic の設定リファレンスによると、発動するのは次の5つの条件がすべてそろったときです。

戻ってきたとき、会話には「Compacted while idle, before the prompt cache expired」と表示されます。1時間でキャッシュが切れると、次のメッセージで20万トークン以上の会話をすべて通常の単価で読み直すことになりますが、切れる前の54分の時点で要約しておけば、要約はキャッシュを使って安く作れ、戻ったあとは短い要約から再開できます。

APIキーで使っている場合はキャッシュの有効期間が既定で5分なので、設定 promptCacheTtl を 1h にしていない限り、この機能は働きません。定額プランの人が昼休みや会議で長い会話を置いたまま席を外すと、戻ったときには要約に置き換わっている、という場面が今後は普通に起こります。

実機で試した結果：最後の応答から53分54秒後に発動した

当研究所でも v2.1.300（Sonnet 5.5、Claude Max）で試しました。発動する量の下限を10万トークンに下げ（CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=100000）、約16.7万トークンの会話をターミナルに表示したまま放置したところ、最後の応答（10時42分03秒）から53分54秒後に PreCompact フックが動き、約10秒で要約が終わって、画面に「Compacted while idle, before the prompt cache expired」と表示されました。会話の量は約16.7万トークンから約5,200トークンに減り、フックに渡された種別は「auto」（自動圧縮と同じ扱い）でした。

読み込んでいた仕訳データ（5,000トークン超）は、要約のあと「Referenced file journal.csv」と表示され、中身ではなくファイル名だけが戻っていました。公式ドキュメントにある「5,000トークンを超えるファイルはファイル名だけで戻る」という動きのとおりです。なお1回目の試行では放置中に Mac がスリープしていたとみられ、発動しませんでした。「その時点でパソコンが起きていること」という条件は実際に効いています。

放置中の自動圧縮を止める・調整する方法

{
  "idleCompaction": false
}

• 止める："idleCompaction": false（v2.1.290 以降で有効）。自動圧縮全体を止める "autoCompactEnabled": false や環境変数 DISABLE_AUTO_COMPACT=1 でも一緒に止まります
• 発動する量を変える：CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=300000 のように指定（10万未満は10万に引き上げ）
• 要約の記録を残す：後述の PostCompact フックは放置中の自動圧縮でも動きます

当研究所の見解では、多くの人は初期設定のままで問題ありません。止めたほうがよいのは、席を外す前の細かな経緯（途中の数字や検討の過程）を戻ってからもそのまま参照したい場合です。その場合も、止めるより先に、後で使う結果をファイルへ書き出させておくほうが、費用と確実さの両方で有利です。

compact できないときの対処と、要約を記録に残す設定

/compact が使えない・自動圧縮が止まるときは、表示されたメッセージで原因を切り分けられます。多いのは「会話のターン数が少なすぎる」「大きなファイルの読み込みで要約直後にまた満杯になる」の2つです。業務で使うなら、要約の内容をファイルに残すフックも合わせて設定しておくと、後から経緯を確かめられます。

CLAUDE.md に「要約の方針」を書いておく

毎回 /compact に指示を添えなくても、プロジェクトの CLAUDE.md に要約の方針を書いておけます。Anthropic のドキュメントは「Compact instructions」という見出しで書く例を示しています。CLAUDE.md の書き方そのものは「CLAUDE.mdとskillsの使い分け」で解説しています。

# 顧問先月次業務のルール
- 金額は必ず「税抜」と明記する
- 顧問先は必ず顧問先コード（K-101 形式）で書く

# Compact instructions
要約するときは、顧問先ごとの決定事項・期日・金額、作成したファイルのパス、未了の作業を省略せずに残すこと。

PostCompact フックで要約をファイルに残す

Claude Code の hooks には、要約の直前に動く PreCompact と、直後に動く PostCompact があります。PostCompact には生成された要約の全文（compact_summary）が渡されるので、案件フォルダに書き出せば「どの時点で何が要約されたか」の記録になります。手動の /compact、自動圧縮、放置中の自動圧縮のいずれでも動きます。

{
  "hooks": {
    "PostCompact": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "cat >> $CLAUDE_PROJECT_DIR/compact-log.jsonl; echo >> $CLAUDE_PROJECT_DIR/compact-log.jsonl" }
        ]
      }
    ]
  }
}

当研究所の検証でも、同じ形の PostCompact フック（保存先は絶対パスで指定）で、/compact を実行するたびに要約の全文（約3,700〜8,500字）がファイルに追記されました。前の節で紹介した要約の9つの見出しや「ユーザーの全発言」の欄は、こうして取り出したものです。

反対に、要約されては困る作業中は PreCompact フックを終了コード2で終わらせると圧縮を止められます。ただし文脈が上限に達してから走る圧縮を止めると、そのリクエスト自体が失敗します。また、要約後に毎回必ず思い出させたいルールは、SessionStart フックのマッチャーを compact にして出力させる方法もあります（Automate actions with hooks）。hooks で作業の確認を自動化する例は「Claude Codeの検証ループとは？」でも紹介しています。

まとめ