Compaction(会話の圧縮)

要約のためのコードを自前で用意する必要はありません。会話が長くなるほど応答の品質が下がるため、長い会話やエージェントのタスクを context window の内に収め、扱う文脈を小さく保つために使います。

Compaction は、会話の古いターンを要約に置き換えて、会話を続けるための機能です。要約は Claude がサーバー側で書くため、要約処理のコードを自前で持つ必要はありません。

会話が長くなるほど応答の品質は下がります。Compaction は、長い会話やエージェントのタスクを context window の内に収めるとともに、実際に扱う文脈を小さく保ちます。

圧縮の方式は 2 つあります。

• threshold compaction(閾値による圧縮): 入力トークンが利用者の設定した trigger に達したときに、API が圧縮の時期を判断します。応答はいつもどおり会話に追加し、compaction ブロックより前の部分は API が取り除きます。
• on-demand compaction(オンデマンドの圧縮): compact-2026-09-04 ベータヘッダーとトップレベルの compaction パラメータを使います。API は送信したメッセージを要約した署名付きの compaction ブロックを返し、利用者は以降のリクエストでそのブロックを messages の先頭に置いて、要約の対象になったメッセージの代わりに送ります。圧縮のタイミングは利用者が選びます。

オンデマンドの圧縮には、次のオプションがあります。

• 直近のターンを残す: 最後の数ターンを一字一句そのまま Claude に届ける必要があるときに使います。要約は古いターンだけを対象にします。preserved thinking に対応したモデルでは、残したターン内の thinking が有効なまま保たれる場合があります。
• バックグラウンドでの圧縮: 作業を続けている間に要約のリクエストを実行し、compaction ブロックが届いた時点で差し替えます。
• 独自の要約プロンプト: 既定の要約が後のターンで必要な情報を落とす場合に、独自の要約プロンプトを書けます。独自のプロンプトは既定のプロンプトを置き換えます。
• 再度の圧縮: すでに compaction ブロックで始まっている会話が再び長くなった場合、もう一度圧縮できます。

オンデマンドの圧縮は、Claude API の Messages API で compact-2026-09-04 ベータヘッダーを付けて使うベータとして、2026 年 9 月 14 日に提供が始まりました。対象となるプランは、公式のリリースノートには記載がありません。

オンデマンドの圧縮はベータとして提供されており、compact-2026-09-04 ベータヘッダーを使います。

1. Messages API へのリクエストに compact-2026-09-04 ベータヘッダーを付け、トップレベルの compaction パラメータを送ります。
2. API は、送信したメッセージを要約した署名付きの compaction ブロックを返します。
3. 以降のリクエストでは、返された compaction ブロックを messages の先頭に置き、要約の対象になったメッセージの代わりに送ります。