Anthropic merilis nomor versi baru Claude API, yakni 2026-10-21. Para pengembang selama ini menulis anthropic-version: 2023-06-01 di header permintaan sejak 2023, dan ini adalah versi resmi baru pertama setelahnya.
Perubahan yang paling mencolok adalah dihapusnya tiga parameter sampling di Messages API: temperature, top_p, dan top_k. Menurut panduan migrasi, permintaan yang dikirim dengan versi baru dan memuat salah satu dari tiga kolom ini langsung mengembalikan error 400, bahkan jika nilainya adalah nilai default. Jika tidak dikirim, permintaan di-sampling dengan nilai default, dengan temperature 1.0, sama seperti efek saat parameter tidak dikirim pada versi lama.
Versi lama tidak dinyatakan usang. Saran dalam dokumentasi cukup lugas: untuk permintaan yang bergantung pada nilai sampling non-default, hapus parameternya atau tetap bertahan di 2023-06-01.
Siapa yang terdampak
Bagi model Claude 4.7 dan setelahnya, penghapusan parameter ini nyaris tidak membawa perubahan nyata; dokumentasi menyebut model-model tersebut memang sejak awal hanya menerima nilai default. Yang terdampak adalah aplikasi yang masih memakai model lama seperti Claude Sonnet 4.6 dan sengaja menurunkan temperature demi output yang lebih stabil. Dokumentasi menulis dengan jelas bahwa permintaan semacam ini kehilangan efek aslinya setelah upgrade, dan tidak ada pengaturan lain yang dapat menggantikannya.
Selain parameter sampling, Messages API memiliki dua perubahan lain yang kini menghasilkan error 400:
- Menaruh blok
documentlangsung di pesan assistant kini menghasilkan error; dokumen harus ditaruh di pesan user. - Menyertakan
citationsyang tidak kosong di blok text pada pesan user juga menghasilkan error.
Di sisi administrasi juga ada penggantian nama. Di Admin API, roles pada grup RBAC menjadi role_ids, workspace_id pada API key dihapus dan diganti dengan scope, sedangkan pada endpoint analitik enterprise actor.email berubah menjadi actor.email_address. Pada versi baru, nama kolom lama tidak lagi dikembalikan.
SDK ikut naik versi mayor bersamaan
SDK resmi di semua bahasa kali ini menaikkan versi mayornya, dan versi barunya mengirim 2026-10-21 secara default: paket Python anthropic ke 2.0.0, @anthropic-ai/sdk untuk TypeScript ke 1.0.0, Go ke v2 (jalur impor perlu ditambah /v2), Java ke 3.0.0, C# ke 13.0.0, PHP ke 1.0.0, dan Ruby ke 2.0.0. Alat baris perintah ant naik ke 2.0.0.
Pengguna Go perlu ekstra waspada. Jalur modul CLI berubah menjadi github.com/anthropics/anthropic-cli/v2, dan dokumentasi secara khusus mengingatkan bahwa menjalankan go install dengan jalur lama akan terus memasang v1 terbaru, tanpa error dan tanpa peringatan apa pun.
Di Amazon Bedrock, versi baru hanya dibuka untuk model Claude 4.7 dan setelahnya. Siapa pun yang masih memanggil Opus 4.6 atau model lama lainnya di Bedrock harus bertahan di versi SDK yang ada, atau mengganti model terlebih dahulu sebelum melakukan upgrade.
API key pindah ke header lain
Perubahan yang mungkin berdampak paling luas bagi pengembang di Tiongkok terselip di dalam pembaruan SDK. SDK dan CLI versi baru tidak lagi menaruh API key di header X-Api-Key, melainkan menyeragamkannya menjadi Authorization: Bearer <key>.
Claude API sendiri menerima kedua header tersebut, sehingga program yang terhubung langsung ke endpoint resmi tidak terpengaruh. Masalahnya ada di lapisan tengah: reverse proxy buatan sendiri, API gateway, dan middleware penghitung kuota yang membaca key dari X-Api-Key untuk autentikasi atau penagihan akan gagal menemukan key begitu SDK di-upgrade. Dokumentasi memberi dua jalan keluar: mengubah gateway agar membaca Authorization, atau secara manual menaruh kembali key ke X-Api-Key di sisi klien.
Perubahan turunan lainnya adalah satu klien kini hanya boleh memegang satu jenis kredensial. Dulu, mengirim api_key dan auth_token sekaligus di Python akan mengirim kedua header sekaligus; sekarang langsung memunculkan ValueError.
Menengok nomor versi yang sudah berusia lebih dari dua tahun
Nomor versi 2023-06-01 mencakup seluruh evolusi Claude, dari era Claude 2 hingga seri Claude 5. Kemampuan yang ditambahkan di sepanjang jalan, seperti pemanggilan alat, prompt caching, dan extended thinking, sebagian besar ditumpuk lewat header beta dan kolom baru, sementara nomor versinya sendiri tidak pernah berubah.
Hilangnya parameter sampling sebenarnya sudah lama didahului tanda-tanda. Sejak Claude 4.7, model hanya mengenali nilai default, sehingga mengubah temperature pada model baru sudah lama tidak berpengaruh. Kali ini aturan tersebut ditulis ke dalam kontrak antarmuka agar permintaan gagal langsung di pintu masuk, supaya pemanggil tidak mengira parameternya masih berlaku.
Berapa lama versi lama akan dipertahankan, panduan migrasi tidak memberikan jadwal, dan Anthropic sejauh ini belum mengumumkan tanggal penghentian 2023-06-01.
Sumber: panduan migrasi Claude Platform, akun resmi pengembang Claude, CocoLoop; nomor versi SDK tiap bahasa, kondisi error, dan cakupan model yang didukung di Bedrock mengacu pada panduan migrasi resmi.