Claude Code compaction問題とは - 履歴圧縮トラブルの原因と対策

Claude Code compaction問題の正体

Claude Codeには200Kトークンの上限があります。つまり、会話が長くなると限界に達します。そこで自動的に会話履歴を要約する仕組みがあります。これがcompaction（圧縮）です。

具体的には、コンテキストウィンドウの約83.5%に達すると発動します。しかし、この圧縮は非可逆です。つまり、一度圧縮された情報は元に戻りません。そのため、重要な詳細が失われる可能性があります。

まず、技術的な詳細が消えます。たとえば、数値やタイムアウト設定、変数名などです。また、以前に決めた命名規則を忘れることがあります。さらに、完了済みのファイル修正を再度提案することもあります。

特に深刻なのがカスケード圧縮です。圧縮されたコンテンツがさらに圧縮されます。つまり、要約の要約の要約になってしまうのです。その結果、情報品質が急速に劣化します。なお、大量の画像データを含む場合は圧縮処理に12分以上かかることもあります。

最も効果的な対策はセッションの分割です。大規模タスクを小さなセッションに分けます。また、セッション間でハンドオフサマリーを作成すると引き継ぎが円滑です。

さらにCLAUDE.mdファイルの活用も重要です。なぜなら、このファイルは圧縮の影響を受けないからです。具体的には、命名規則や重要な設定をCLAUDE.mdに記載します。加えて、MCPサーバーを使って外部ナレッジベースにコンテキストを保存する方法もあります。

まず、会話は焦点を絞ることが大切です。不要な情報は提供しないようにしましょう。また、圧縮が発生する前に重要な決定事項を確認しておくと安心です。

さらに、古いセッションはquitコマンドで終了して新しく始めるのも有効です。つまり、コンテキストが溜まりすぎる前にリセットするのです。そのため、長時間の作業では定期的なセッション切り替えを心がけてください。特に複雑なプロジェクトでは、この習慣が品質維持につながります。

Claude Code compaction問題は、長時間セッションで発生するコンテキスト消失です。しかし、セッション分割やCLAUDE.mdの活用で対策できます。したがって、重要な情報は永続的なファイルに保存し、焦点を絞った会話を心がけましょう。