Yang baru di Claude Opus 5.5

Claude Opus 5.5 dibuat untuk pekerjaan coding agentik dan pekerjaan pengetahuan yang berjalan lama, dengan harga $4 / $20 USD per juta token input / output. Empat perubahan yang merusak kompatibilitas dapat memengaruhi kode yang sudah berjalan di Claude Opus 5:

• Thinking tidak dapat dinonaktifkan.
• Penggunaan alat yang dipaksakan mengembalikan error.
• Blok thinking terikat pada model dan percakapan.
• Beberapa versi alat penggunaan komputer tidak didukung.

Tiga perubahan pertama juga berlaku pada Claude Fable 5.1. Perubahan lainnya mengubah bentuk respons tanpa menggagalkan permintaan apa pun: teks di antara pemanggilan alat dikembalikan dalam blok thinking yang teksnya kosong pada pengaturan display default. Aplikasi yang melakukan streaming teks tersebut kepada penggunanya sebagai pembaruan progres akan diam di antara pemanggilan alat hingga aplikasi tersebut menetapkan nilai display yang mengembalikan teks tersebut.

Model baru

Pemikiran adaptif selalu aktif, dan parameter effort mengontrol kedalaman pemikiran; nilai default-nya pada model ini adalah medium. Untuk “context window” (jendela konteks), batas output, batas pengetahuan, dan harga, lihat halaman model Claude Opus 5.5; untuk semua model saat ini, lihat ikhtisar model.

Perubahan yang merusak kompatibilitas

Pemikiran tidak dapat dinonaktifkan

Di Claude Opus 5, pemikiran aktif secara default dan thinking: {"type": "disabled"} diterima pada effort high atau lebih rendah. Di Claude Opus 5.5, pemikiran selalu aktif: permintaan yang menetapkan thinking: {"type": "disabled"}, atau anggaran manual dengan thinking: {"type": "enabled", "budget_tokens": N}, mengembalikan 400 invalid_request_error. Hilangkan field thinking, atau kirim thinking: {"type": "adaptive"}, yang setara. Tidak ada header beta yang terlibat.

Pesan error-nya adalah:

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Parameter effort adalah kontrol untuk kedalaman pemikiran, latensi, dan biaya: turunkan nilainya di tempat Anda sebelumnya menonaktifkan pemikiran; Mengoptimalkan biaya dan kecerdasan berisi hasil terukur untuk memilih level. Karena setiap respons dapat diawali dengan satu atau lebih blok thinking (dikembalikan dengan field thinking kosong pada default display: "omitted"), pilih blok konten berdasarkan field type-nya, bukan berdasarkan posisi, dan kirimkan kembali blok thinking tanpa modifikasi dalam loop “tool use” (penggunaan alat). Kode yang sudah berjalan di Claude Opus 5 dengan pemikiran aktif tidak memerlukan perubahan. Lihat Pemikiran dan perbandingan sebelum dan sesudah untuk pemikiran di panduan migrasi.

Penggunaan alat paksa tidak didukung

Claude Opus 5.5 tidak mendukung “forced tool use” (penggunaan alat paksa). tool_choice yang ditetapkan ke {"type": "any"} atau {"type": "tool", "name": "..."} mengembalikan 400 invalid_request_error:

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"} (default) dan {"type": "none"} didukung, dan validasi yang sama berlaku untuk endpoint penghitungan token. Untuk JSON yang valid terhadap skema, pertahankan tool_choice: {"type": "auto"} dan tetapkan strict: true dengan penggunaan alat ketat, atau pindahkan skema ke output terstruktur. Agar model memanggil alat alih-alih membalas dengan teks, sebutkan dalam prompt kapan alat tersebut berlaku. Panduan migrasi menunjukkan perbandingan sebelum dan sesudah untuk pilihan alat.

Blok pemikiran terikat pada model dan percakapan

Setiap “thinking block” (blok pemikiran) mencatat model mana yang menghasilkannya, dan setiap model membaca bloknya sendiri serta hanya blok dari sebagian model lain. Claude Opus 5.5 membaca blok pemikiran dari Claude Opus 5, dari model Opus, Sonnet, dan Haiku yang lebih lama, dan, di Claude API dan Claude Models on Google Cloud (Google managed), dari Claude Sonnet 5.5 dan Claude Haiku 5.5, tetapi tidak dari model Claude Fable atau Claude Mythos. Di Claude API, Claude Fable 5.1 dan Claude Mythos 5.1 membaca blok pemikiran dari Claude Opus 5.5; tidak ada model lain yang melakukannya. Percakapan yang berpindah dari Claude Opus 5 ke Claude Opus 5.5, atau dari Claude Opus 5.5 naik ke Claude Fable 5.1 atau Claude Mythos 5.1 di Claude API, mempertahankan penalarannya. Percakapan yang berpindah dari Claude Opus 5.5 ke model apa pun selain kedua model tersebut, atau berpindah ke Claude Opus 5.5 dari model Claude Fable atau Claude Mythos, menjalankan giliran setelah peralihan tanpa penalaran model sebelumnya. Ketika sebuah permintaan membawa blok yang tidak dapat dibaca oleh model tujuan, API membuangnya sebelum model melihatnya: permintaan tetap berhasil, dan blok yang dibuang tidak ditagih. Dengan header beta thinking-binding-controls-2026-08-01, pembuangan tersebut dilaporkan dalam array input_transformations tingkat atas. Lihat Beralih model di tengah percakapan.

API juga memeriksa apakah ada sesuatu sebelum blok pemikiran Claude Opus 5.5 (prompt system, tools, atau pesan sebelumnya) yang telah berubah sejak blok tersebut dihasilkan. Jaga agar percakapan bersifat append-only (hanya ditambahkan): ubah instruksi atau alat dengan pesan sistem di tengah percakapan alih-alih melakukan pengeditan. Permintaan yang memutar ulang sebuah blok setelah perubahan semacam itu dan membiarkan thinking.block_binding.prefix_mismatch_behavior tidak diatur akan mendapatkan error 400 pada akun yang dibuat pada atau setelah 31 Agustus 2026, 00:00 UTC. Ini berlaku di Claude API dan di platform cloud. Pada akun yang dibuat sebelum tanggal tersebut, permintaan hanya mendapatkan error ketika field tersebut diatur ke "error". Untuk membuang blok yang terdampak sebagai gantinya, kirim header beta thinking-binding-controls-2026-08-01 dan atur field tersebut ke "drop_block". Lihat Pemikiran yang dipertahankan dan catatan tentang blok pemikiran dalam panduan migrasi.

Beberapa versi alat penggunaan komputer tidak didukung

Claude Opus 5.5 mendukung penggunaan komputer melalui toolset computer_toolset_20260801. Di Amazon Bedrock, Claude Opus 5.5 juga menerima alat computer_20251124 dengan header beta computer-use-2025-11-24. Claude Opus 5.5 mengembalikan error 400 untuk versi alat penggunaan komputer apa pun yang tidak diterimanya, seperti computer_20251124 di Claude API. Pesan invalid_request_error dari Claude API menyebutkan tipe yang ditolak dan, setelah Did you mean one of, mencantumkan tipe alat yang diterima model. Pesan tersebut diawali dengan:

'claude-opus-5-5' does not support tool types: computer_20251124.

Integrasi yang menggunakan toolset tidak memerlukan perubahan. Untuk memindahkan integrasi computer_20251124 ke toolset, ikuti Migrasi dari computer_20251124. Hapus header beta dan ganti entri tools dengan {"type": "computer_toolset_20260801"}. Kemudian perbarui loop agen Anda untuk blok tool_use anggota, aksi batch, dan toolset_name pada hasil. Panduan migrasi menampilkan permintaan sebelum dan sesudah.

Dukungan fitur

Claude Opus 5.5 mendukung effort per pesan (beta), pesan sistem di tengah percakapan, anggaran tugas, “prompt caching” (caching prompt) dengan prompt minimum yang dapat di-cache sebesar 512 token, pemrosesan batch, Files API, dukungan PDF, vision, serta alat sisi server dan sisi klien. Lihat halaman masing-masing fitur untuk ketersediaan model.

Mode cepat

Mode cepat tersedia untuk Claude Opus 5.5 di Claude API, di Claude Models on Google Cloud (Anthropic managed), dan di Claude di Microsoft Foundry untuk deployment yang di-host di Azure. Di Claude API dan di Claude Models on Google Cloud (Anthropic managed), tetapkan speed: "fast" pada permintaan Anda. Claude Opus 5.5 tidak memerlukan header beta. Lihat Mode cepat untuk model yang didukung, “rate limit” (batas laju), dan harga.

Mendefinisikan alat dalam pesan (beta)

Dengan header beta inline-tools-2026-09-15, blok tool_addition dalam pesan sistem di tengah percakapan dapat membawa definisi alat lengkap alih-alih referensi, sehingga Anda dapat menambahkan alat, mengubah skemanya, atau memindahkan alat server ke versi yang lebih baru di tengah percakapan tanpa mengedit tools dan tanpa kehilangan cache prompt. Ini berfungsi pada setiap model yang mendukung perubahan alat di tengah percakapan, termasuk Claude Opus 5.5. Lihat Mendefinisikan alat dalam pesan.

Compaction sesuai permintaan (beta)

Dengan header beta compact-2026-09-04, permintaan yang mengirimkan parameter compaction tingkat atas mengembalikan blok compaction bertanda tangan yang merangkum seluruh percakapan, yang kemudian Anda kirim pertama kali sebagai pengganti pesan-pesan yang dirangkum. Fitur ini tersedia pada model yang mendukung compaction, termasuk Claude Opus 5.5. Anda memilih kapan melakukan compaction, dan permintaan dapat berjalan di latar belakang. Dalam kondisi yang dijelaskan di Compaction dan pemikiran yang dipertahankan, blok pemikiran pada giliran yang Anda pertahankan dapat tetap valid setelah penggantian. Hal ini penting di Claude Opus 5.5 karena blok pemikirannya terikat pada percakapan. Lihat Compaction sesuai permintaan untuk ketersediaan platform dan alur permintaan lengkap.

Perbedaan perilaku

Claude Opus 5.5 berbeda dari Claude Opus 5 dalam beberapa hal yang muncul tanpa perubahan kode apa pun. Masing-masing memiliki panduan di Menulis prompt untuk Claude Opus 5.5:

• Effort default adalah medium. Permintaan yang tidak menyertakan effort berjalan pada medium; di Claude Opus 5 permintaan tersebut berjalan pada high. Tetapkan effort secara eksplisit dan jalankan ulang pengujian Anda; lihat Mengkalibrasi effort.
• Lebih banyak pemikiran per giliran pada level effort tertentu. Pada pengaturan effort yang sama, model cenderung berpikir lebih banyak per giliran dibandingkan Claude Opus 5, terutama pada xhigh dan max. Jalankan ulang pengujian effort Anda alih-alih membawa pengaturan lama, dan sisakan ruang di max_tokens untuk pemikiran. Lihat Mengkalibrasi effort.
• Teks di antara panggilan alat dikembalikan dalam blok pemikiran. Catatan singkat yang ditulis model di antara panggilan alat tiba sebagai blok thinking pembaruan progres alih-alih blok text, sehingga pada default display: "omitted" aplikasi yang melakukan streaming catatan tersebut ke penggunanya menjadi senyap di antara panggilan alat, tanpa error. Panduan migrasi menjelaskan cara menerima teks di antara panggilan alat, dan Pembaruan progres untuk pengguna membahas cara meminta lebih banyak pembaruan tersebut.
• Lebih banyak kategori safeguard. Model menjalankan pengklasifikasi keamanan biologi selain pengklasifikasi keamanan siber. Seperti di Claude Opus 5, permintaan yang mendorong model untuk mereproduksi penalaran internalnya dalam teks respons mungkin ditolak dengan kategori reasoning_extraction. Lihat Penolakan dan fallback di Claude Opus 5.5 dan Penolakan safeguard.
• Pembacaan grafik, diagram, dan tangkapan layar yang lebih tajam. Model membaca nilai dari grafik padat dan visual yang bergantung pada tata letak dengan jauh lebih presisi tanpa alat, sehingga solusi vision di sisi prompt yang dibuat untuk model sebelumnya mungkin tidak lagi diperlukan; alat gambar tetap menambah akurasi pada input yang paling padat. Lihat Alat untuk input visual yang kompleks.

Jika integrasi Claude Opus 5 Anda berjalan dengan pemikiran dinonaktifkan, lihat Prompt yang ditulis untuk pemikiran yang dinonaktifkan bersama dengan perubahan yang merusak kompatibilitas Pemikiran tidak dapat dinonaktifkan. Untuk peningkatan kemampuan dalam coding agentik dan tinjauan kode, pekerjaan berbasis pengetahuan, komunikasi, input visual, dan penggunaan komputer, lihat Kemampuan yang relevan untuk prompting.

Penolakan dan fallback

Claude Opus 5.5 dilengkapi dengan pengklasifikasi keamanan, dan semua yang ada di Penolakan dan fallback berlaku. Permintaan yang ditolak mengembalikan HTTP 200 dengan stop_reason: "refusal" dan objek stop_details yang menyebutkan area kebijakan, jadi tangani penolakan dan konfigurasikan fallback: coba ulang di model lain dengan fallback sisi server (fallbacks: "default", dalam beta, mencoba ulang pada model yang direkomendasikan Anthropic untuk kategori tersebut), middleware SDK, atau mekanisme percobaan ulang Anda sendiri. Apakah penolakan yang tiba sebelum output apa pun ditagih bergantung pada kategori penolakannya, dan penolakan tersebut tetap dihitung terhadap batas laju Anda dalam kedua kasus; lihat Bagaimana penolakan ditagih.

Harga

Claude Opus 5.5 berharga $4 USD per juta token input dan $20 USD per juta token output, lebih rendah dari $5 dan $25 USD pada Claude Opus 5, dengan penulisan cache 5 menit sebesar $5 USD, penulisan cache 1 jam sebesar $8 USD, dan pembacaan cache sebesar $0,20 USD per juta token (0,05x harga input dasar). Pemrosesan batch setengah harga: $2 dan $10 USD. Lihat Harga untuk residensi data dan harga alat.

Ketersediaan

Claude Opus 5.5 tersedia di:

• Claude API: semua pelanggan, sebagai claude-opus-5-5
• AWS: Claude di Amazon Bedrock, sebagai anthropic.claude-opus-5-5, dan Claude Platform on AWS, sebagai claude-opus-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), sebagai claude-opus-5-5, dan Claude Models on Google Cloud (Google managed), sebagai claude-opus-5-5
• Microsoft Foundry: Claude di Microsoft Foundry, sebagai claude-opus-5-5

Migrasi dari Claude Opus 5

Perbarui ID model Anda:

model = "claude-opus-5"  # Before
model = "claude-opus-5-5"  # After

Kemudian hapus pengaturan thinking: {"type": "disabled"} atau thinking: {"type": "enabled", ...} apa pun dan pilih level effort sebagai gantinya. Ganti tipe tool_choice any dan tool dengan auto ditambah penggunaan alat ketat. Jika Anda menggunakan alat penggunaan komputer melalui computer_20251124, pindahlah ke toolset. Di Amazon Bedrock, computer_20251124 juga berfungsi. Jika antarmuka Anda menampilkan teks di antara pemanggilan alat, tetapkan juga thinking.display; lihat Teks di antara pemanggilan alat dikembalikan dalam blok thinking. Lihat panduan migrasi untuk petunjuk langkah demi langkah dari Claude Opus 5 dan model sebelumnya, serta daftar periksa lengkapnya.

Langkah selanjutnya