Pengeditan konteks saat ini dalam versi beta dengan dukungan untuk pembersihan hasil tool. Untuk mengaktifkannya, gunakan header beta context-management-2025-06-27 dalam permintaan API Anda. Strategi pengeditan konteks tambahan akan ditambahkan dalam rilis mendatang.Silakan hubungi kami melalui formulir umpan balik untuk berbagi umpan balik Anda tentang fitur ini.

​
Cara kerjanya

Strategi clear_tool_uses_20250919 membersihkan hasil tool ketika konteks percakapan berkembang melampaui ambang batas yang Anda konfigurasi. Ketika diaktifkan, API secara otomatis membersihkan hasil tool tertua dalam urutan kronologis, menggantikannya dengan teks placeholder untuk memberi tahu Claude bahwa hasil tool telah dihapus. Secara default, hanya hasil tool yang dibersihkan. Anda dapat secara opsional membersihkan baik hasil tool maupun panggilan tool (parameter penggunaan tool) dengan mengatur clear_tool_inputs ke true. Pengeditan konteks membatalkan awalan prompt yang di-cache karena membersihkan konten memodifikasi struktur prompt, merusak persyaratan pencocokan untuk cache hits. Untuk memperhitungkan hal ini, kami merekomendasikan membersihkan token yang cukup untuk membuat pembatalan cache menjadi bermanfaat. Gunakan parameter clear_at_least untuk memastikan jumlah minimum token dibersihkan setiap kali. Ketika menggunakan prompt caching dengan pengeditan konteks, Anda akan dikenakan biaya penulisan cache setiap kali konten dibersihkan, tetapi permintaan selanjutnya dapat menggunakan kembali awalan yang baru di-cache.

​
Model yang didukung

Pengeditan konteks tersedia pada:
  • Claude Opus 4.1 (claude-opus-4-1-20250805)
  • Claude Opus 4 (claude-opus-4-20250514)
  • Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
  • Claude Sonnet 4 (claude-sonnet-4-20250514)

​
Penggunaan dasar

Cara paling sederhana untuk mengaktifkan pengeditan konteks adalah dengan menentukan hanya jenis strategi, karena semua opsi konfigurasi lainnya akan menggunakan nilai default mereka: 
curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-sonnet-4-5",
        "max_tokens": 4096,
        "messages": [
            {
                "role": "user",
                "content": "Cari perkembangan terbaru dalam AI"
            }
        ],
        "tools": [
            {
                "type": "web_search_20250305",
                "name": "web_search"
            }
        ],
        "context_management": {
            "edits": [
                {"type": "clear_tool_uses_20250919"}
            ]
        }
    }'

​
Konfigurasi lanjutan

Anda dapat menyesuaikan perilaku pengeditan konteks dengan parameter tambahan: 
curl https://api.anthropic.com/v1/messages \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-sonnet-4-5",
        "max_tokens": 4096,
        "messages": [
            {
                "role": "user",
                "content": "Buat aplikasi kalkulator command line sederhana menggunakan Python"
            }
        ],
        "tools": [
            {
                "type": "text_editor_20250728",
                "name": "str_replace_based_edit_tool",
                "max_characters": 10000
            },
            {
                "type": "web_search_20250305",
                "name": "web_search",
                "max_uses": 3
            }
        ],
        "context_management": {
            "edits": [
                {
                    "type": "clear_tool_uses_20250919",
                    "trigger": {
                        "type": "input_tokens",
                        "value": 30000
                    },
                    "keep": {
                        "type": "tool_uses",
                        "value": 3
                    },
                    "clear_at_least": {
                        "type": "input_tokens",
                        "value": 5000
                    },
                    "exclude_tools": ["web_search"]
                }
            ]
        }
    }'

​
Opsi konfigurasi

Opsi konfigurasiDefaultDeskripsi
trigger100.000 input tokenMenentukan kapan strategi pengeditan konteks diaktifkan. Setelah prompt melebihi ambang batas ini, pembersihan akan dimulai. Anda dapat menentukan nilai ini dalam input_tokens atau tool_uses.
keep3 penggunaan toolMenentukan berapa banyak pasangan penggunaan/hasil tool terbaru yang disimpan setelah pembersihan terjadi. API menghapus interaksi tool tertua terlebih dahulu, mempertahankan yang paling baru.
clear_at_leastNoneMemastikan jumlah minimum token dibersihkan setiap kali strategi diaktifkan. Jika API tidak dapat membersihkan setidaknya jumlah yang ditentukan, strategi tidak akan diterapkan. Ini membantu menentukan apakah pembersihan konteks layak untuk merusak cache prompt Anda.
exclude_toolsNoneDaftar nama tool yang penggunaan dan hasilnya tidak boleh dibersihkan. Berguna untuk mempertahankan konteks penting.
clear_tool_inputsfalseMengontrol apakah parameter panggilan tool dibersihkan bersama dengan hasil tool. Secara default, hanya hasil tool yang dibersihkan sambil menjaga panggilan tool asli Claude tetap terlihat.

​
Format respons

Anda dapat melihat pengeditan konteks mana yang diterapkan pada permintaan Anda menggunakan field respons context_management, bersama dengan statistik yang berguna tentang konten dan input token yang dibersihkan.
Response
{
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "type": "message",
    "role": "assistant",
    "content": [...],
    "usage": {...},
    "context_management": {
        "applied_edits": [
            {
                "type": "clear_tool_uses_20250919",
                "cleared_tool_uses": 8,
                "cleared_input_tokens": 50000
            }
        ]
    }
}
Untuk respons streaming, pengeditan konteks akan disertakan dalam event message_delta terakhir:
Streaming Response
{
    "type": "message_delta",
    "delta": {
        "stop_reason": "end_turn",
        "stop_sequence": null
    },
    "usage": {
        "output_tokens": 1024
    },
    "context_management": {
        "applied_edits": [...]
    }
}

​
Penghitungan token

Endpoint /v1/messages/count_tokens mendukung manajemen konteks, memungkinkan Anda untuk melihat pratinjau berapa banyak token yang akan digunakan prompt Anda setelah pengeditan konteks diterapkan. 
curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "anthropic-version: 2023-06-01" \
    --header "content-type: application/json" \
    --header "anthropic-beta: context-management-2025-06-27" \
    --data '{
        "model": "claude-sonnet-4-5",
        "messages": [
            {
                "role": "user",
                "content": "Lanjutkan percakapan kita..."
            }
        ],
        "tools": [...],
        "context_management": {
            "edits": [
                {
                    "type": "clear_tool_uses_20250919",
                    "trigger": {
                        "type": "input_tokens",
                        "value": 30000
                    },
                    "keep": {
                        "type": "tool_uses",
                        "value": 5
                    }
                }
            ]
        }
    }'
Response
{
    "input_tokens": 25000,
    "context_management": {
        "original_input_tokens": 70000
    }
}
Respons menunjukkan baik jumlah token akhir setelah manajemen konteks diterapkan (input_tokens) maupun jumlah token asli sebelum pembersihan terjadi (original_input_tokens).