Compaction

コンパクションとは何ですか？

コンパクションは、コンテキストウィンドウが上限に近づいたときにClaude Codeが行う処理で、古い会話を短い要約に置き換え、その上で作業を続ける。自動で発生し、/compactで手動実行もできる。関連する設定に/autocompactと環境変数CLAUDE_CODE_AUTO_COMPACT_WINDOWがある。圧縮後にClaudeが見るのは要約であり、元の逐語的な会話ではない。

なぜコンパクションが必要ですか？

モデルが一度に読める量には上限があり、長いセッションはいずれ埋まる。圧縮がなければ、やり直すか、古い内容に新しい内容を押し出させるしかない。コンパクションは折衷案で、要点を残して空きを取り戻す。代償は細部の喪失で、公式のauto mode設定ページも、「確認するまでpushしないで」のように会話で述べた一時的な境界は、圧縮でそのメッセージが消えると失われうると注意している。確実にするにはaskまたはdenyルールを使う。

どう動き、何が残りますか？

公式changelogの要点：v2.1.304以降、圧縮後にスキル一覧がClaudeへ再送され、/reload-skillsは新規・変更分だけを送る。v2.1.309以降、サイズ超過のネストしたCLAUDE.mdは先頭だけ読み込まれ、読んだ後の繰り返し圧縮を防ぐ。v2.1.307では大量のPDFページや画像を読むターンで出る「Autocompact is thrashing」を修正。v2.1.296以降、サブエージェントのfrontmatterでautoCompactWindow（100000〜1000000）を設定できる。第三者の解説（claudefa.st）は、プロジェクトルートのCLAUDE.mdはディスクから再注入され、ネストしたものは再注入されず、呼び出し済みスキルは1つ5,000・合計25,000トークンが上限だと述べる。起動時のスキル一覧は再読み込みされないという別の記述は、公式のv2.1.304の記述と矛盾するので古い情報として扱う。

私にとってどういう意味ですか？

実務上は3点。長期のルールは会話だけでなくCLAUDE.mdや権限ルールに書く。サイズの大きいCLAUDE.mdや大量のツール出力は圧縮を頻発させるので簡潔に保つ。Claudeが直前に言ったことを忘れたように見えたら、まず圧縮が起きたばかりではないかを疑う。この3点は公式情報に対する私の整理であり、公式の運用助言ではない。