---
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 tahap beta, Compaction sesuai permintaan mencakup lebih banyak kasus penggunaan umum. Untuk menghapus hasil alat lama atau blok thinking 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 token](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold)                                                                                                                                                                         | Peringkas Anda sendiri ([Compaction di sisi klien](https://platform.claude.com/docs/id/build-with-claude/preserved-thinking#custom-compaction-on-the-client)) |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **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 menukarnya masuk                                                | Satu parameter pada permintaan biasa Anda                                                                                                                                                                                                                                          | Panggilan peringkasan, prompt-nya, dan penulisan ulang riwayat                                                                                                |
| **Apa yang Anda kirim kembali setelahnya**                                                                                                                                              | Blok yang dikembalikan, di posisi pertama dalam `messages`, menggantikan pesan-pesan yang diringkasnya                                                                                                            | Respons, ditambahkan seperti biasa. API membuang apa pun 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                                                                                                                                                                                                                           | Ya, di kode Anda sendiri                                                                                                                                      |
| **Giliran yang dipertahankan tetap menyimpan thinking-nya**, 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: pada Claude Fable 5.1, Claude Opus 5.5, Claude Sonnet 5.5, dan Claude Haiku 5.5, hapus atau buang thinking dalam giliran yang Anda masukkan kembali (lihat [contoh compaction ambang](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#examples)) | Tidak: thinking tersebut [gagal dalam pemeriksaan](https://platform.claude.com/docs/id/build-with-claude/preserved-thinking#keep-tail-compaction)             |
| **Header beta, parameter, dan platform**                                                                                                                                                | `compact-2026-09-04` dan parameter `compaction` tingkat atas. Platform: lihat [daftar Kompatibilitas sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#compatibility) | Lihat [daftar Kompatibilitas ambang](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#compatibility) 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 berhenti sejenak selama ringkasan ditulis, atau harus mempertahankan giliran terbaru beserta thinking-nya                                    | Anda ingin API mengelola konteks di dalam permintaan biasa                                                                                                                                                                                                                         | Anda sudah menjalankan peringkas sendiri dan peringkas tersebut 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 thinking 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 thinking pada model dengan preserved thinking 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 menghilangkan 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. Kondisi yang menjaga thinking tetap valid pada 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 tidak ada 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 batas.
* Kompatibilitas: setiap jenis memiliki header beta sendiri, sehingga setiap halaman memiliki daftarnya sendiri. Lihat [daftar Kompatibilitas sesuai permintaan](https://platform.claude.com/docs/id/build-with-claude/compaction-on-demand#compatibility) atau [daftar Kompatibilitas ambang batas](https://platform.claude.com/docs/id/build-with-claude/compaction-threshold#compatibility).

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