---
title: Ikhtisar compaction
url: https://platform.claude.com/docs/id/build-with-claude/compaction
description: Pelajari apa yang dilakukan compaction, perbedaan antara compaction sesuai permintaan dan compaction pada ambang batas token, serta halaman mana yang membahas tugas Anda.
---

“Compaction” (pemadatan) menggantikan giliran-giliran lama dalam percakapan dengan ringkasan yang ditulis Claude di server, sehingga Anda tidak memerlukan kode peringkasan sendiri. Compaction menjaga percakapan panjang atau tugas agen tetap berada di dalam “context window” (jendela konteks), dan menjaga konteks aktif tetap kecil, karena kualitas respons menurun seiring bertambah panjangnya percakapan.

Jika Anda ingin melewati ikhtisar ini, mulailah dengan [Compaction sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand) untuk menambahkan compaction ke aplikasi Anda. Meskipun fitur tersebut dan [Compaction pada ambang batas token](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold) sama-sama masih dalam beta, Compaction sesuai permintaan mencakup lebih banyak kasus penggunaan umum. Untuk membersihkan hasil alat lama atau blok pemikiran lama berdasarkan aturan alih-alih meringkasnya, lihat [Pengeditan konteks](https://platform.claude.com/docs/id/build-with-claude/context-editing).

## Pilih cara melakukan compaction

Gunakan compaction sesuai permintaan di mana pun fitur tersebut tersedia.

|                                                                                                                                                                                         | [Compaction sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand)                                                                                                                     | [Compaction pada ambang batas token](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold)                                                                                                                                                              | [Peringkas Anda sendiri](https://platform.claude.com/docs/id/build-with-claude/compaction-thinking-blocks#own-summary)                                    |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Siapa yang menentukan kapan**                                                                                                                                                         | Anda, dengan mengirim permintaan                                                                                                                                                                                               | API, ketika token input mencapai pemicu yang Anda tetapkan                                                                                                                                                                                                                    | Anda                                                                                                                                                      |
| **Kode yang Anda tulis**                                                                                                                                                                | Sebuah [loop compaction](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#compact-in-a-loop) yang meminta ringkasan dan menggantikannya ke dalam riwayat                                             | Satu parameter pada permintaan biasa Anda                                                                                                                                                                                                                                     | Panggilan peringkasan, prompt-nya, dan penulisan ulang riwayat                                                                                            |
| **Apa yang Anda kirim kembali setelahnya**                                                                                                                                              | Blok yang dikembalikan di urutan pertama dalam `messages`, menggantikan pesan-pesan yang diringkasnya                                                                                                                          | Respons, ditambahkan seperti biasa. API tidak menyertakan apa yang ada sebelum blok tersebut                                                                                                                                                                                  | Ringkasan Anda, sebagai pesan Anda sendiri                                                                                                                |
| **Giliran terbaru tetap kata demi kata**                                                                                                                                                | Ya: [Compaction yang mempertahankan giliran terbaru](https://platform.claude.com/docs/id/build-with-claude/compaction-keep-recent-turns)                                                                                       | Ya, dengan [menjeda setelah compaction](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#pausing-after-compaction) dan memasukkannya kembali                                                                                                        | Ya                                                                                                                                                        |
| **Berjalan di latar belakang**                                                                                                                                                          | Ya: [Compaction di latar belakang](https://platform.claude.com/docs/id/build-with-claude/compaction-background)                                                                                                                | Tidak: berjalan di dalam permintaan yang mencapai ambang batas                                                                                                                                                                                                                | Ya, di kode Anda sendiri                                                                                                                                  |
| **Giliran yang dipertahankan tetap menyimpan pemikirannya**, pada model dengan [pemikiran yang dipertahankan](https://platform.claude.com/docs/id/build-with-claude/preserved-thinking) | Ya, dengan ketentuan dalam [Compaction dan pemikiran yang dipertahankan](https://platform.claude.com/docs/id/build-with-claude/compaction-thinking-blocks)                                                                     | Tidak: hapus pemikiran dari giliran yang Anda masukkan kembali, atau biarkan API tidak menyertakannya dengan `prefix_mismatch_behavior: "drop_block"` (lihat [contoh compaction ambang](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#examples)) | Tidak: pemikiran tersebut [gagal dalam pemeriksaan prefiks](https://platform.claude.com/docs/id/build-with-claude/compaction-thinking-blocks#own-summary) |
| **Header beta, parameter, dan platform**                                                                                                                                                | `compact-2026-09-04` dan parameter `compaction` tingkat atas. Platform: lihat [bagian dukungan API sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#availability-feature-support) | Lihat [bagian dukungan API ambang](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#availability-feature-support) dan [Penggunaan dasar](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#basic-usage)                    | Tidak ada. Berjalan di kode Anda                                                                                                                          |
| **Pilih ini ketika**                                                                                                                                                                    | Aplikasi Anda perlu mengontrol kapan compaction terjadi, tidak dapat menjeda saat ringkasan sedang ditulis, atau harus mempertahankan giliran terbaru beserta pemikirannya                                                     | Anda ingin API mengelola konteks di dalam permintaan biasa                                                                                                                                                                                                                    | Anda sudah menjalankan peringkas sendiri dan peringkas itu mengganti seluruh riwayat dengan ringkasan                                                     |

## Opsi compaction sesuai permintaan

[Compaction sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand) menunjukkan loop yang meringkas seluruh percakapan sementara aplikasi Anda menunggu. Dua halaman pertama dalam daftar ini mengubah cara loop tersebut berjalan, dan Anda dapat menggabungkan keduanya. Halaman ketiga berlaku jika Anda mengirim kembali blok pemikiran dan melakukan salah satu dari keduanya.

* [Compaction yang mempertahankan giliran terbaru](https://platform.claude.com/docs/id/build-with-claude/compaction-keep-recent-turns): ketika beberapa giliran terakhir harus sampai ke Claude kata demi kata. Ringkasan hanya mencakup giliran-giliran yang lebih lama.
* [Compaction di latar belakang](https://platform.claude.com/docs/id/build-with-claude/compaction-background): ketika percakapan tidak dapat berhenti sejenak untuk menunggu ringkasan. Permintaan berjalan sementara pekerjaan berlanjut, dan Anda menukarkan blok tersebut ke dalam percakapan saat blok itu tiba.
* [Compaction dan pemikiran yang dipertahankan](https://platform.claude.com/docs/id/build-with-claude/compaction-thinking-blocks): jika Anda mengirim kembali blok pemikiran pada model dengan pemikiran yang dipertahankan dan Anda mempertahankan giliran terbaru atau melakukan compaction di latar belakang. Jika tidak, lewati halaman ini.
* [Menulis prompt peringkasan Anda sendiri](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#write-your-own-summarization-prompt): ketika ringkasan default tidak menyertakan sesuatu yang dibutuhkan oleh giliran berikutnya. Prompt Anda menggantikan prompt default.
* [Melakukan compaction lagi](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#compact-again): ketika percakapan yang sudah diawali dengan blok compaction kembali menjadi panjang.

Temukan topik-topik berikut di halaman lain:

* [Meminta ringkasan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#request-a-summary) ada di Compaction sesuai permintaan.
* [Melanjutkan dari ringkasan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#continue-from-the-summary) ada di Compaction sesuai permintaan. Ketentuan yang menjaga pemikiran tetap valid dalam giliran yang Anda pertahankan ada di [Compaction dan pemikiran yang dipertahankan](https://platform.claude.com/docs/id/build-with-claude/compaction-thinking-blocks).
* Ketika tidak ada ringkasan yang dikembalikan: lihat [Menangani ringkasan yang hilang atau error](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#when-no-summary-comes-back) di Compaction sesuai permintaan.
* Bagaimana fitur ini berpadu dengan bagian API lainnya: lihat [Batasan dan interaksi dengan fitur lain](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#how-it-fits-with-the-rest-of-the-api) di Compaction sesuai permintaan.
* Memahami penggunaan: lihat [Menghitung penggunaan compaction](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#understanding-usage) untuk compaction sesuai permintaan, atau [Memahami penggunaan](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#understanding-usage) untuk compaction ambang.
* Kompatibilitas: setiap jenis memiliki header beta sendiri, sehingga setiap halaman memiliki bagiannya sendiri: [Dukungan API untuk compaction sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#availability-feature-support) dan [Dukungan API untuk compaction ambang](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#availability-feature-support).

Compaction ambang batas memiliki halamannya sendiri: [Compaction pada ambang batas token](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold).
