Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Claude Fable 5 adalah model Anthropic paling mumpuni yang dirilis secara luas, tersedia secara umum di Claude API, Amazon Bedrock, Claude Platform on AWS, Google Cloud, dan Microsoft Foundry. Claude Mythos 5 memiliki kemampuan yang sama dan ditawarkan dalam ketersediaan terbatas kepada pelanggan yang disetujui di Project Glasswing.
Pengaturan dasar yang sama-sama dimiliki oleh claude-fable-5 dan claude-mythos-5:
thinking. Baik thinking: {type: "disabled"} maupun extended thinking manual (thinking: {type: "enabled", budget_tokens: N}) mengembalikan error 400.invalid_request_error 400. Organisasi dengan pengaturan ZDR harus menghubungi tim akun Anthropic mereka untuk membahas konfigurasi retensi data. Sebagai alternatif, Anda dapat mengonfigurasi retensi data per workspace. Lihat Persyaratan retensi data spesifik model untuk detail per platform.Perbedaan antara kedua model:
stop_reason: "refusal". Claude Mythos 5 tidak menyertakan classifier ini. Lihat Penolakan dan fallback.Claude Mythos 5 adalah penerus dengan akses terbatas dari Claude Mythos Preview, pratinjau riset khusus undangan. Claude Fable 5 adalah model yang tersedia secara umum dengan kemampuan yang sama, dan perubahan di bagian ini berlaku sama untuk kedua target.
Migrasi sebagian besar bersifat drop-in. Claude Mythos 5 dan Claude Fable 5 menggunakan Messages API yang sama dan pola penggunaan alat yang sama seperti Claude Mythos Preview, dan jumlah token kurang lebih tidak berubah karena ketiga model menggunakan tokenizer yang sama. Perubahan utama yang perlu diperiksa adalah fitur yang tidak lagi tersedia (tercantum di bagian berikutnya) dan output thinking. Jika Anda bermigrasi ke Claude Fable 5, rencanakan juga untuk penolakan safety classifier, yang tidak dimiliki Claude Mythos Preview dan Claude Mythos 5; lihat Penolakan dan fallback.
Untuk linimasa penghentian Claude Mythos Preview, lihat Deprekasi model.
model = "claude-mythos-preview" # Before
model = "claude-mythos-5" # After
# Atau, untuk model yang tersedia secara umum dengan kemampuan yang sama:
model = "claude-fable-5" # AfterExtended thinking dan anggaran token thinking: Extended thinking manual (thinking: {type: "enabled", budget_tokens: N}) tidak didukung di claude-mythos-5 atau claude-fable-5 dan mengembalikan error 400. Adaptive thinking selalu aktif: model menentukan kapan dan seberapa banyak berpikir pada setiap permintaan, dan tidak diperlukan konfigurasi thinking. thinking: {type: "disabled"} mengembalikan error. budget_tokens tidak memiliki pengganti langsung: thinking bersifat adaptif, dan parameter effort adalah kontrol tingkat output yang terpisah, bukan anggaran thinking.
Sebelum (Claude Mythos Preview):
client.messages.create(
model="claude-mythos-preview",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Mythos 5):
client.messages.create(
model="claude-mythos-5",
max_tokens=16000,
messages=[{"role": "user", "content": "..."}],
)Perubahan untuk Claude Fable 5 identik, dengan claude-fable-5 sebagai nama model.
Prefill asisten: Melakukan prefill pada pesan asisten tidak didukung di claude-mythos-5 atau claude-fable-5 dan mengembalikan error 400, sama seperti di Claude Mythos Preview. Gunakan instruksi prompt sistem sebagai gantinya.
Output thinking: Di claude-mythos-5 dan claude-fable-5, chain of thought mentah tidak pernah dikembalikan, tetapi blok thinking tetap membawa teks ringkasan yang dapat dibaca ketika thinking.display diatur ke summarized. Kirim kembali blok thinking tanpa perubahan saat melanjutkan percakapan pada model yang sama. Lihat Output thinking di Claude Fable 5 dan Claude Mythos 5.
claude-mythos-5 dan claude-fable-5 menggunakan tokenizer yang sama dengan claude-mythos-preview (tokenizer yang diperkenalkan dengan Claude Opus 4.7). Jumlah token kurang lebih tidak berubah saat bermigrasi dari claude-mythos-preview. Dibandingkan dengan model sebelum Claude Opus 4.7, konten yang sama dapat ditokenisasi menjadi sekitar 30% lebih banyak token, bervariasi berdasarkan konten dan bentuk beban kerja.
/v1/messages/count_tokens mengembalikan nilai yang kurang lebih tidak berubah untuk claude-mythos-5 dan claude-fable-5 dibandingkan dengan claude-mythos-preview. Lakukan baseline ulang biaya dan latensi pada beban kerja Anda sendiri.
claude-mythos-preview ke claude-mythos-5, atau ke claude-fable-5 untuk model yang tersedia secara umum.thinking: {type: "enabled", budget_tokens: N}). Adaptive thinking selalu aktif, dan tidak diperlukan field thinking.thinking: {type: "disabled"} apa pun. Menonaktifkan thinking mengembalikan error di claude-mythos-5 dan claude-fable-5.budget_tokens. Tidak ada pengganti langsung: thinking bersifat adaptif, dan parameter effort adalah kontrol tingkat output yang terpisah, bukan anggaran thinking.thinking memperlakukannya sebagai teks tampilan saja dan mengirim kembali blok thinking tanpa perubahan saat melanjutkan pada model yang sama. thinking.display secara default adalah "omitted" di claude-mythos-5 dan claude-fable-5, sama seperti di Claude Mythos Preview; atur display: "summarized" untuk menerima ringkasan yang dapat dibaca. Lihat Output thinking di Claude Fable 5 dan Claude Mythos 5.thinking dan redacted_thinking dari giliran asisten sebelumnya terlebih dahulu. Blok thinking dari claude-mythos-5 dan claude-fable-5 terikat pada model yang menghasilkannya, dan model selain Claude Fable 5 dan Claude Mythos 5 mengabaikannya secara diam-diam. Menghapusnya menjaga permintaan lintas model tetap minimal dan seragam.stop_reason: "refusal" dan baca field stop_details.category. Claude Fable 5 menjalankan safety classifier yang tidak dimiliki Claude Mythos Preview dan Claude Mythos 5. Lihat Penolakan dan fallback.claude-mythos-preview.Claude Fable 5 dan Claude Mythos 5 menggunakan Messages API yang sama dan pola penggunaan alat yang sama seperti Claude Opus 5, dengan jendela konteks 1M token yang sama secara default dan 128k token output maksimum yang sama. Pembatasan prefill dan parameter sampling, serta perilaku tampilan thinking, tetap sama seperti di Claude Opus 5 tanpa perubahan. Perubahan yang perlu diperiksa adalah thinking yang selalu aktif, harga, Priority Tier, dan retensi data.
model = "claude-opus-5" # Before
model = "claude-fable-5" # After
# Atau, untuk model Project Glasswing dengan kemampuan yang sama:
model = "claude-mythos-5" # AfterThinking tidak dapat lagi dinonaktifkan: Di Claude Opus 5, thinking aktif secara default dan dapat dimatikan dengan thinking: {type: "disabled"} pada tingkat effort high atau lebih rendah. Di claude-fable-5 dan claude-mythos-5, adaptive thinking selalu aktif, dan thinking: {type: "disabled"} mengembalikan error 400 pada tingkat effort apa pun. Hapus konfigurasi thinking: {type: "disabled"} dan gunakan tingkat effort yang lebih rendah untuk mengontrol pengeluaran token sebagai gantinya.
Harga: Claude Fable 5 dan Claude Mythos 5 dihargai $10 USD per juta token input dan $50 USD per juta token output, dibandingkan dengan $5 USD dan $25 USD untuk Claude Opus 5. Lihat Harga Claude.
Priority Tier: Priority Tier tidak didukung di Claude Opus 5, jadi tidak ada lalu lintas yang ada yang terpengaruh. Jika organisasi Anda memiliki komitmen Priority Tier, Claude Fable 5 mendukungnya; Claude Mythos 5 tidak.
Retensi data: Claude Fable 5 dan Claude Mythos 5 memerlukan retensi data 30 hari dan tidak tersedia di bawah pengaturan zero data retention (ZDR); keduanya ditetapkan sebagai Covered Models. Lihat Persyaratan retensi data spesifik model.
claude-opus-5 ke claude-fable-5 (atau claude-mythos-5).thinking: {type: "disabled"} apa pun; ini mengembalikan error 400 di claude-fable-5 dan claude-mythos-5. Gunakan tingkat effort yang lebih rendah untuk mengontrol pengeluaran token sebagai gantinya, dan tinjau kembali max_tokens untuk beban kerja yang berjalan dengan thinking dinonaktifkan di Claude Opus 5.Migrasi sebagian besar bersifat drop-in. Claude Fable 5 dan Claude Mythos 5 menggunakan Messages API yang sama dan pola penggunaan alat yang sama seperti Claude Opus 4.8, dengan jendela konteks 1M token yang sama secara default dan 128k token output maksimum yang sama. Jumlah token kurang lebih tidak berubah karena model-model tersebut menggunakan tokenizer yang sama. Perubahan utama yang perlu diperiksa adalah adaptive thinking yang selalu aktif, output thinking, penolakan safety classifier (hanya Claude Fable 5), dan harga.
model = "claude-opus-4-8" # Before
model = "claude-fable-5" # After
# Atau, untuk model Project Glasswing dengan kemampuan yang sama:
model = "claude-mythos-5" # AfterItem di bagian ini menjelaskan perbedaan API dan perilaku yang perlu diperiksa setelah Anda mengganti ID model. Kecuali dinyatakan lain, semuanya berlaku sama untuk claude-fable-5 dan claude-mythos-5.
Adaptive thinking selalu aktif: Adaptive thinking adalah satu-satunya mode thinking di claude-fable-5 dan claude-mythos-5. Model menentukan kapan dan seberapa banyak berpikir pada setiap permintaan, dan tidak diperlukan konfigurasi thinking. thinking: {type: "disabled"} mengembalikan error. Gunakan parameter effort untuk mengontrol kedalaman thinking.
Perubahan perilaku yang perlu diperiksa: di Claude Opus 4.8, permintaan tanpa field thinking berjalan tanpa thinking; di claude-fable-5 dan claude-mythos-5, permintaan yang sama berjalan dengan adaptive thinking. max_tokens tetap menjadi batas keras pada total output, thinking ditambah teks respons, jadi tinjau kembali untuk beban kerja yang berjalan tanpa thinking di Claude Opus 4.8. Lihat Kontrol biaya.
Sebelum (Claude Opus 4.8):
client.messages.create(
model="claude-opus-4-8",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Fable 5):
client.messages.create(
model="claude-fable-5",
max_tokens=16000,
output_config={"effort": "high"},
messages=[{"role": "user", "content": "..."}],
)Perubahan untuk Claude Mythos 5 identik, dengan claude-mythos-5 sebagai nama model.
Extended thinking dan anggaran thinking (tidak berubah): Extended thinking manual (thinking: {type: "enabled", budget_tokens: N}) tidak didukung di claude-fable-5 atau claude-mythos-5 dan mengembalikan error 400, sama seperti di Claude Opus 4.8. budget_tokens tidak memiliki pengganti langsung: thinking bersifat adaptif, dan parameter effort adalah kontrol tingkat output yang terpisah, bukan anggaran thinking.
Prefill asisten (tidak berubah): Melakukan prefill pada pesan asisten tidak didukung di claude-fable-5 atau claude-mythos-5 dan mengembalikan error 400, sama seperti di Claude Opus 4.8. Gunakan instruksi prompt sistem sebagai gantinya.
Output thinking: Di claude-fable-5 dan claude-mythos-5, chain of thought mentah tidak pernah dikembalikan, tetapi blok thinking tetap membawa teks ringkasan yang dapat dibaca ketika thinking.display diatur ke summarized. Kirim kembali blok thinking tanpa perubahan saat melanjutkan percakapan pada model yang sama. Lihat Output thinking di Claude Fable 5 dan Claude Mythos 5.
Safety classifier dan stop reason refusal (hanya Claude Fable 5): claude-fable-5 menjalankan safety classifier pada permintaan dan selama pembuatan respons. Claude Mythos 5 tidak menyertakan classifier ini. Ketika classifier menolak permintaan, Messages API mengembalikan stop_reason: "refusal" sebagai respons HTTP 200 yang berhasil, bukan error. Field stop_details.category melaporkan classifier mana yang terpicu, dengan kategori seperti "cyber", "bio", dan "reasoning_extraction", atau null ketika penolakan tidak dipetakan ke kategori bernama apa pun. Lihat tabel kategori penolakan untuk daftar lengkapnya.
Anda tidak ditagih untuk token input dari permintaan yang ditolak sebelum output apa pun dihasilkan. Ketika classifier terpicu di tengah stream, input dan output yang sudah di-stream ditagih; buang output parsial tersebut.
Untuk menjalankan ulang permintaan yang ditolak pada model lain secara otomatis, kirim parameter opt-in fallbacks, yang masih dalam beta di Claude API. Parameter ini tidak tersedia di Message Batches API atau di Amazon Bedrock, Google Cloud, dan Microsoft Foundry; di ketiga platform tersebut, jalankan retry di sisi klien atau gunakan middleware refusal-fallback SDK. Lihat Penolakan dan fallback.
Mulai dengan effort high: Default parameter effort tetap high. Di Claude Opus 4.8, rekomendasi untuk pekerjaan coding dan otonomi tinggi adalah mengatur xhigh secara eksplisit. Di claude-fable-5 dan claude-mythos-5, gunakan high sebagai default untuk sebagian besar tugas dan simpan xhigh untuk beban kerja yang paling sensitif terhadap kemampuan. Pengaturan effort yang lebih rendah tetap berkinerja baik dan sering kali melampaui kinerja xhigh pada model sebelumnya. Kurangi effort jika tugas selesai tetapi memakan waktu lebih lama dari yang diperlukan. Lihat Prompting Claude Fable 5.
Minimum caching prompt yang lebih rendah: Panjang prompt minimum yang dapat di-cache di claude-fable-5 dan claude-mythos-5 adalah 512 token, lebih rendah dari 1.024 token di Claude Opus 4.8. Prompt yang terlalu pendek untuk di-cache di Claude Opus 4.8 sekarang dapat membuat entri cache, tanpa perubahan kode yang diperlukan. Lihat Caching prompt untuk minimum per model.
claude-fable-5 dan claude-mythos-5 memerlukan retensi data 30 hari; di Claude API, permintaan ke claude-fable-5 yang tidak memenuhi persyaratan ini mengembalikan invalid_request_error 400. Claude Opus 4.8 tetap tersedia di bawah ZDR. Lihat Persyaratan retensi data spesifik model.claude-opus-4-8 ke claude-fable-5 (atau claude-mythos-5).thinking: {type: "disabled"} apa pun. Menonaktifkan thinking mengembalikan error di claude-fable-5 dan claude-mythos-5, dan permintaan tanpa field thinking berjalan dengan adaptive thinking.claude-fable-5 dan claude-mythos-5.thinking memperlakukannya sebagai teks tampilan saja dan mengirim kembali blok thinking tanpa perubahan saat melanjutkan pada model yang sama. thinking.display secara default adalah "omitted" di claude-fable-5 dan claude-mythos-5, sama seperti di Claude Opus 4.8; atur display: "summarized" untuk menerima ringkasan yang dapat dibaca. Lihat Output thinking di Claude Fable 5 dan Claude Mythos 5.thinking dan redacted_thinking dari giliran asisten sebelumnya terlebih dahulu. Blok thinking dari claude-fable-5 dan claude-mythos-5 terikat pada model yang menghasilkannya, dan model selain Claude Fable 5 dan Claude Mythos 5 mengabaikannya secara diam-diam. Menghapusnya menjaga permintaan lintas model tetap minimal dan seragam. Pengecualiannya adalah menukarkan kredit fallback, yang memerlukan body permintaan yang di-echo sesuai aturan persis fitur tersebut.stop_reason: "refusal" dan baca field stop_details.category. Untuk menjalankan ulang permintaan yang ditolak pada model lain secara otomatis, pertimbangkan parameter opt-in fallbacks (beta). Lihat Penolakan dan fallback.effort Anda. Mulai dengan high untuk sebagian besar tugas, termasuk beban kerja yang berjalan pada xhigh di Claude Opus 4.8.claude-opus-4-8; harga per token berbeda.Claude Opus 5 adalah peningkatan signifikan dibandingkan Claude Opus 4.8, kuat dalam penalaran mendalam, tugas agentik dan jangka panjang, serta penskalaan komputasi saat pengujian. Untuk perbedaan perilaku dan pola prompting spesifik model, lihat Prompting Claude Opus 5.
Claude Opus 5 adalah upgrade drop-in untuk Claude Opus 4.8 dengan harga yang sama yaitu $5 per juta token input dan $25 per juta token output; lihat Harga Claude. Ada dua breaking change untuk kode yang sudah berjalan di Claude Opus 4.8, dibahas di bawah Breaking changes di bawah ini. Claude Opus 5 mendukung set fitur yang sama dengan Claude Opus 4.8, termasuk jendela konteks 1M token (default, tanpa header beta), 128k token output maksimum, adaptive thinking, caching prompt, pemrosesan batch, Files API, dukungan PDF, vision, serta alat sisi server dan sisi klien, dengan dua pengecualian: web fetch tidak tersedia di Claude Opus 5, dan Priority Tier tidak didukung di Claude Opus 5. Lihat setiap halaman alat untuk ketersediaan model.
# Migrasi Opus
model = "claude-opus-4-8" # Before
model = "claude-opus-5" # Afterclaude-opus-5 adalah ID model tetap tanpa sufiks tanggal, skema yang sama dengan claude-opus-4-8 dan claude-sonnet-5.
Thinking aktif secara default: Di Claude Opus 4.8, permintaan tanpa field thinking berjalan tanpa thinking; di Claude Opus 5, permintaan yang sama berjalan dengan adaptive thinking. max_tokens tetap menjadi batas keras pada total output, thinking ditambah teks respons, jadi tinjau kembali untuk beban kerja yang berjalan tanpa thinking di Claude Opus 4.8. Untuk mempertahankan perilaku lama, kirim thinking: {type: "disabled"}, dengan batasan effort di item berikutnya; perhatikan bahwa dengan thinking dinonaktifkan, model terkadang dapat mengeluarkan panggilan alat sebagai teks biasa atau menyertakan tag XML internal dalam output yang terlihat, jadi lebih baik gunakan tingkat effort yang lebih rendah dengan thinking diaktifkan jika memungkinkan, dan lihat Menjalankan dengan thinking dinonaktifkan untuk mitigasi jika tidak memungkinkan.
Menonaktifkan thinking dibatasi pada effort high: Anda masih dapat mematikan thinking dengan thinking: {type: "disabled"}, tetapi hanya pada tingkat effort high atau lebih rendah. Permintaan yang menggabungkan thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400. Claude Opus 4.8 menerima kombinasi ini, jadi audit permintaan yang menonaktifkan thinking sebelum Anda bermigrasi.
Pemeriksaan diberlakukan pada setiap permintaan: konfigurasi effort dan thinking setiap permintaan divalidasi secara independen, jadi permintaan yang menaikkan effort ke xhigh atau max sementara thinking dinonaktifkan akan ditolak meskipun permintaan sebelumnya dalam percakapan diterima.
Sebelum (diterima di Claude Opus 4.8, ditolak di Claude Opus 5):
client.messages.create(
model="claude-opus-4-8",
max_tokens=16000,
thinking={"type": "disabled"},
output_config={"effort": "xhigh"},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Opus 5), hapus field thinking untuk mengaktifkan kembali thinking:
client.messages.create(
model="claude-opus-5",
max_tokens=16000,
output_config={"effort": "xhigh"}, # thinking is on by default
messages=[{"role": "user", "content": "..."}],
)atau tetap nonaktifkan thinking dan turunkan effort:
client.messages.create(
model="claude-opus-5",
max_tokens=16000,
thinking={"type": "disabled"},
output_config={"effort": "high"}, # or "medium", "low"
messages=[{"role": "user", "content": "..."}],
)Ini tidak wajib tetapi akan meningkatkan pengalaman Anda:
Uji effort max untuk pekerjaan yang kritis terhadap kemampuan: Claude Opus 5 mendukung set lengkap tingkat effort (low, medium, high, xhigh, max). Di mana kemampuan maksimum lebih penting daripada pengeluaran token, uji effort max. Ini dapat memberikan peningkatan pada tugas yang paling menuntut tetapi mungkin menunjukkan hasil yang semakin berkurang dari peningkatan penggunaan token dan dapat rentan terhadap overthinking pada tugas yang lebih sederhana. Jika Anda menjalankan pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak; mulai dari 64k token dan sesuaikan dari sana.
Pertimbangkan fallback otomatis: Claude Opus 5 dilengkapi dengan safety classifier keamanan siber yang penolakan kategori cyber-nya dapat di-fallback ke Claude Opus 4.8. Untuk menjalankan ulang permintaan yang ditolak pada model lain secara otomatis, pertimbangkan parameter fallbacks dengan mode "default" (fallbacks: "default"), yang memilih model fallback yang direkomendasikan berdasarkan kategori penolakan alih-alih daftar model yang dikelola secara manual. Fallback sisi server masih dalam beta; mode "default" memerlukan header beta server-side-fallback-2026-07-01. Lihat Penolakan dan fallback.
Cache prompt yang lebih pendek: Panjang prompt minimum yang dapat di-cache di Claude Opus 5 adalah 512 token, turun dari 1.024 token di Claude Opus 4.8. Prompt yang terlalu pendek untuk di-cache di Claude Opus 4.8 sekarang dapat membuat entri cache, tanpa perubahan kode yang diperlukan. Lihat Caching prompt untuk minimum per model.
Ubah alat di tengah percakapan (beta): Anda dapat menambah atau menghapus alat di antara giliran percakapan tanpa membatalkan hit cache prompt pada giliran sebelumnya. Kirim header beta mid-conversation-tool-changes-2026-07-01. Ini berguna untuk beban kerja agentik yang mengekspos alat secara progresif atau menghentikannya seiring kemajuan tugas; tanpa ini, daftar alat yang berubah membatalkan prefiks yang di-cache.
Sesuaikan ulang prompt panjang dan verbositas: Respons yang terlihat secara default dan hasil tertulis berjalan lebih panjang di Claude Opus 5 dibandingkan di Claude Opus 4.8, dan menurunkan effort mengurangi volume thinking tanpa secara andal memperpendek respons yang terlihat. Berikan prompt secara eksplisit untuk keringkasan atau panjang target sebagai gantinya. Lihat Panjang respons dan verbositas dan Panjang hasil tertulis.
Hapus instruksi verifikasi yang terbawa dan batasi cakupan: Claude Opus 5 memverifikasi pekerjaannya sendiri tanpa diminta, jadi hapus instruksi verifikasi atau pemeriksaan mandiri eksplisit yang terbawa dari prompt yang disesuaikan untuk model sebelumnya; membiarkannya menyebabkan verifikasi berlebihan. Untuk tugas yang sempit, batasi cakupan tugas secara eksplisit. Dalam framework multi-agen, berikan panduan eksplisit tentang skenario mana yang memerlukan delegasi atau batasi jumlah subagen, karena Claude Opus 5 mendelegasikan lebih mudah daripada model sebelumnya. Lihat Cakupan tugas dan verifikasi berlebihan dan Mengontrol pembuatan subagen.
claude-opus-4-8 ke claude-opus-5.thinking: mereka berjalan dengan thinking di Claude Opus 5. Tinjau kembali max_tokens, yang tetap menjadi batas keras pada total output (thinking ditambah teks respons), atau kirim thinking: {type: "disabled"} pada effort high atau lebih rendah untuk mempertahankan perilaku lama. Jika Anda menonaktifkan thinking, tinjau Menjalankan dengan thinking dinonaktifkan untuk artefak output yang dapat muncul dan mitigasi prompting-nya.thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400, diberlakukan pada setiap permintaan. Aktifkan kembali thinking atau turunkan effort ke high atau lebih rendah.effort Anda: jalankan sweep effort baru pada evaluasi Anda sendiri daripada membawa pengaturan yang disesuaikan untuk model sebelumnya. Effort low dan medium layak diuji sebagai kontrol biaya dan latensi, dan uji effort max di mana kemampuan maksimum lebih penting daripada pengeluaran token. Jika Anda menjalankan pada effort xhigh atau max, naikkan max_tokens ke setidaknya 64k sebagai titik awal.stop_reason: "refusal", dan pertimbangkan fallbacks: "default" (beta) untuk menjalankan ulang permintaan yang ditolak pada model fallback yang direkomendasikan secara otomatis.Claude Opus 5 seharusnya memiliki performa yang kuat secara langsung pada prompt dan evaluasi Claude Opus 4.7 yang sudah ada, dengan harga yang sama yaitu $5 per juta token input dan $25 per juta token output. Model ini mendukung rangkaian fitur yang sama dengan Claude Opus 4.7, termasuk jendela konteks 1M token, 128k token output maksimum, pemikiran adaptif, caching prompt, pemrosesan batch, Files API, dukungan PDF, vision, serta alat sisi server dan sisi klien, dengan dua pengecualian: web fetch tidak tersedia di Claude Opus 5, dan Priority Tier tidak didukung di Claude Opus 5. Model ini juga menambahkan pesan sistem di tengah percakapan dan mendokumentasikan secara publik detail stop penolakan.
# Migrasi Opus
model = "claude-opus-4-7" # Before
model = "claude-opus-5" # AfterPemikiran aktif secara default: Pada Claude Opus 4.7, permintaan tanpa field thinking berjalan tanpa pemikiran; pada Claude Opus 5, permintaan yang sama berjalan dengan pemikiran adaptif. max_tokens tetap menjadi batas keras pada total output, yaitu pemikiran ditambah teks respons, jadi tinjau kembali nilai ini untuk beban kerja yang berjalan tanpa pemikiran di Claude Opus 4.7. Untuk mempertahankan perilaku lama, kirimkan thinking: {type: "disabled"}, dengan tunduk pada batas effort di item berikutnya; perhatikan bahwa dengan pemikiran dinonaktifkan, model terkadang dapat mengeluarkan panggilan alat sebagai teks biasa atau menyertakan tag XML internal dalam output yang terlihat, jadi lebih baik gunakan level effort yang lebih rendah dengan pemikiran diaktifkan jika memungkinkan, dan lihat Menjalankan dengan pemikiran dinonaktifkan untuk mitigasi jika tidak memungkinkan.
Menonaktifkan pemikiran dibatasi pada effort high: Anda dapat mematikan pemikiran dengan thinking: {type: "disabled"}, tetapi hanya pada level effort high atau di bawahnya. Permintaan yang menggabungkan thinking: {type: "disabled"} dengan effort xhigh atau max akan mengembalikan error 400. Claude Opus 4.7 menerima kombinasi ini, jadi audit permintaan yang menonaktifkan pemikiran sebelum Anda bermigrasi.
Pemeriksaan ini diterapkan pada setiap permintaan: konfigurasi effort dan pemikiran setiap permintaan divalidasi secara independen, sehingga permintaan yang menaikkan effort ke xhigh atau max saat pemikiran dinonaktifkan akan ditolak meskipun permintaan sebelumnya dalam percakapan diterima.
Sebelum (diterima di Claude Opus 4.7, ditolak di Claude Opus 5):
client.messages.create(
model="claude-opus-4-7",
max_tokens=16000,
thinking={"type": "disabled"},
output_config={"effort": "xhigh"},
messages=[{"role": "user", "content": "..."}],
)Setelah (Claude Opus 5), hapus field thinking untuk berjalan dengan pemikiran:
client.messages.create(
model="claude-opus-5",
max_tokens=16000,
output_config={"effort": "xhigh"}, # thinking is on by default
messages=[{"role": "user", "content": "..."}],
)atau tetap nonaktifkan pemikiran dan turunkan effort:
client.messages.create(
model="claude-opus-5",
max_tokens=16000,
thinking={"type": "disabled"},
output_config={"effort": "high"}, # or "medium", "low"
messages=[{"role": "user", "content": "..."}],
)Item berikut bukan perubahan yang merusak kompatibilitas; item ini menjelaskan perbedaan perilaku yang perlu diperiksa setelah Anda mengganti ID model.
Parameter sampling (tidak berubah): Mengatur temperature, top_p, atau top_k ke nilai non-default akan mengembalikan error 400 di Claude Opus 5, sama seperti di Claude Opus 4.7. Tipe permintaan SDK masih mendefinisikan field ini untuk kompatibilitas dengan model sebelumnya, sehingga kode yang mengaturnya lolos pemeriksaan tipe, tetapi API menolak permintaan di sisi server. Jika Anda sudah menghapus parameter ini saat bermigrasi ke Opus 4.7, tidak ada perubahan lebih lanjut yang diperlukan.
Default effort adalah high: Default parameter effort di Claude Opus 5 adalah high pada Claude API dan Claude Code. Jika Anda sudah mengatur effort secara eksplisit, pengaturan Anda tidak berubah.
Level effort dikalibrasi ulang: Alokasi token di balik setiap level effort berubah di Claude Opus 5 dibandingkan dengan Claude Opus 4.7, dan Claude Opus 5 mendukung rangkaian lengkap level effort (low, medium, high, xhigh, max). Jalankan sweep effort baru pada evaluasi Anda sendiri daripada membawa pengaturan yang disetel untuk Claude Opus 4.7. Effort low dan medium layak diuji sebagai kontrol biaya dan latensi, dan uji effort max di mana kapabilitas maksimum lebih penting daripada pengeluaran token. Jika Anda menjalankan pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak; mulai dari 64k token dan sesuaikan dari sana. Lihat Effort.
Jendela konteks 1M adalah default: Claude Opus 5 menyediakan jendela konteks penuh 1M token secara default tanpa header beta dan tanpa biaya tambahan untuk konteks panjang. Jika klien Anda mengirimkan header beta jendela konteks untuk kompatibilitas dengan model lama, Anda dapat menghapusnya di Claude Opus 5.
Pesan sistem di tengah percakapan: Claude Opus 5 menerima pesan role: "system" segera setelah giliran pengguna dalam array messages (tunduk pada aturan penempatan). Gunakan field system tingkat atas untuk instruksi yang berlaku sejak awal. Claude Opus 4.7 menolak role: "system" dalam messages dengan error 400. Jika Anda memelihara jalur kode yang membangun ulang seluruh riwayat pesan untuk memperbarui instruksi, Anda dapat menyederhanakannya dan mempertahankan hit cache prompt pada giliran sebelumnya.
Detail stop penolakan: Objek stop_details pada respons penolakan (tersedia sejak Claude Opus 4.7) sekarang didokumentasikan secara publik. Ketika model menolak permintaan, model mengidentifikasi kategori penolakan, selain stop reason refusal yang sudah ada. Tidak diperlukan header beta, dan tidak ada opsi untuk menonaktifkannya. Lihat Menangani stop reason.
Minimum caching prompt lebih rendah: Panjang prompt minimum yang dapat di-cache di Claude Opus 5 adalah 512 token, lebih rendah daripada di Claude Opus 4.7. Prompt yang terlalu pendek untuk di-cache di Claude Opus 4.7 sekarang dapat membuat entri cache, tanpa perubahan kode yang diperlukan. Lihat Caching prompt untuk minimum per model.
Fast mode: Claude Opus 5 mendukung fast mode (pratinjau riset); fast mode tidak tersedia di Claude Opus 4.7, di mana permintaan dengan speed: "fast" mengembalikan error. Parameter speed: "fast" dan header beta fast-mode-2026-02-01 berfungsi tanpa perubahan di Claude Opus 5.
Perubahan ini tidak wajib tetapi akan meningkatkan pengalaman Anda:
Pertimbangkan fallback otomatis: Claude Opus 5 dilengkapi dengan pengklasifikasi keamanan siber yang penolakan kategori sibernya dapat di-fallback ke Claude Opus 4.8. Untuk menjalankan ulang permintaan yang ditolak pada model lain secara otomatis, pertimbangkan parameter fallbacks dengan mode "default" (fallbacks: "default"), yang memilih model fallback yang direkomendasikan berdasarkan kategori penolakan alih-alih daftar model yang dikelola secara manual. Fallback sisi server masih dalam beta; mode "default" memerlukan header beta server-side-fallback-2026-07-01. Lihat Penolakan dan fallback.
Ubah alat di tengah percakapan (beta): Anda dapat menambah atau menghapus alat di antara giliran percakapan tanpa membatalkan hit cache prompt pada giliran sebelumnya. Kirim header beta mid-conversation-tool-changes-2026-07-01. Ini berguna untuk beban kerja agentik yang mengekspos alat secara progresif atau menghentikannya seiring kemajuan tugas; tanpa ini, daftar alat yang berubah akan membatalkan prefiks yang di-cache.
Setel ulang prompt panjang dan verbositas: Respons yang terlihat dan hasil tertulis secara default lebih panjang di Claude Opus 5 dibandingkan model Opus sebelumnya, dan menurunkan effort mengurangi volume pemikiran tanpa secara andal memperpendek respons yang terlihat. Sebagai gantinya, berikan prompt secara eksplisit untuk keringkasan atau panjang target. Lihat Panjang respons dan verbositas dan Panjang hasil tertulis.
Hapus instruksi verifikasi yang dibawa dari sebelumnya dan batasi cakupan: Claude Opus 5 memverifikasi pekerjaannya sendiri tanpa diminta, jadi hapus instruksi verifikasi atau pemeriksaan mandiri eksplisit yang dibawa dari prompt yang disetel untuk model sebelumnya; membiarkannya akan menyebabkan verifikasi berlebihan. Untuk tugas yang sempit, batasi cakupan tugas secara eksplisit. Dalam kerangka kerja multi-agen, berikan panduan eksplisit tentang skenario mana yang memerlukan delegasi atau batasi jumlah subagen, karena Claude Opus 5 mendelegasikan lebih mudah daripada model sebelumnya. Lihat Cakupan tugas dan verifikasi berlebihan dan Mengontrol pembuatan subagen.
claude-opus-4-7 ke claude-opus-5 (atau perbarui alias).thinking: beban kerja tersebut berjalan dengan pemikiran di Claude Opus 5. Tinjau kembali max_tokens, yang tetap menjadi batas keras pada total output (pemikiran ditambah teks respons), atau kirimkan thinking: {type: "disabled"} pada effort high atau di bawahnya untuk mempertahankan perilaku lama. Jika Anda menonaktifkan pemikiran, tinjau Menjalankan dengan pemikiran dinonaktifkan untuk artefak output yang dapat muncul dan mitigasi prompting-nya.thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400, diterapkan pada setiap permintaan. Aktifkan kembali pemikiran atau turunkan effort ke high atau di bawahnya.effort Anda: jalankan sweep effort baru pada evaluasi Anda sendiri daripada membawa pengaturan yang disetel untuk Claude Opus 4.7. Uji effort low dan medium sebagai kontrol biaya dan latensi, dan effort max di mana kapabilitas maksimum lebih penting daripada pengeluaran token. Jika Anda menjalankan pada effort xhigh atau max, naikkan max_tokens ke setidaknya 64k sebagai titik awal.stop_details pada penolakan (tersedia sejak Claude Opus 4.7; sekarang didokumentasikan secara publik), dan pertimbangkan fallbacks: "default" (beta) untuk menjalankan ulang permintaan yang ditolak pada model fallback yang direkomendasikan secara otomatis.speed: "fast" dan header beta fast-mode-2026-02-01 berfungsi tanpa perubahan di Claude Opus 5.Claude Opus 5 seharusnya memiliki performa siap pakai yang kuat pada prompt dan evaluasi Claude Opus 4.6 yang sudah ada dengan harga yang sama, tetapi ada beberapa perubahan perilaku dan API yang perlu Anda ketahui saat melakukan migrasi. Sebagian besar perubahan ini mulai berlaku di Claude Opus 4.7; dua lagi, yaitu thinking aktif secara default dan batas effort saat menonaktifkan thinking, mulai berlaku di Claude Opus 5. Semuanya dibahas di bawah ini, sehingga bagian ini lengkap untuk kode yang datang langsung dari Claude Opus 4.6. Claude Opus 5 mendukung kumpulan fitur yang sama dengan Claude Opus 4.6, termasuk:
Dua pengecualian: web fetch tidak tersedia di Claude Opus 5, dan Priority Tier tidak didukung di Claude Opus 5.
# Migrasi Opus
model = "claude-opus-4-6" # Before
model = "claude-opus-5" # AfterExtended thinking dihapus: thinking: {type: "enabled", budget_tokens: N} tidak lagi didukung di Claude Opus 4.7 atau model yang lebih baru dan mengembalikan error 400. Beralihlah ke adaptive thinking (thinking: {type: "adaptive"}) dan gunakan parameter effort untuk mengontrol kedalaman thinking. Di Claude Opus 5, adaptive thinking aktif secara default: thinking: {type: "adaptive"} valid dan setara dengan menghilangkan field thinking sepenuhnya (lihat item berikutnya).
Sebelum (Claude Opus 4.6):
client.messages.create(
model="claude-opus-4-6",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Opus 5):
client.messages.create(
model="claude-opus-5",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "high"}, # or "max", "xhigh", "medium", "low"
messages=[{"role": "user", "content": "..."}],
)Adaptive thinking dapat diarahkan melalui prompting dan parameter effort; lihat Memilih tingkat effort.
Thinking aktif secara default: Di Claude Opus 4.6 dan Claude Opus 4.7, permintaan tanpa field thinking berjalan tanpa thinking; di Claude Opus 5, permintaan yang sama berjalan dengan adaptive thinking. max_tokens tetap menjadi batas keras pada total output, yaitu thinking ditambah teks respons, jadi tinjau kembali nilainya untuk beban kerja yang sebelumnya berjalan tanpa thinking. Untuk mempertahankan perilaku lama, kirimkan thinking: {type: "disabled"}, dengan tunduk pada batas effort di item berikutnya; perhatikan bahwa dengan thinking dinonaktifkan, model terkadang dapat mengeluarkan panggilan alat sebagai teks biasa atau menyertakan tag XML internal dalam output yang terlihat, jadi lebih baik gunakan tingkat effort yang lebih rendah dengan thinking diaktifkan jika memungkinkan, dan lihat Menjalankan dengan thinking dinonaktifkan untuk mitigasi jika tidak memungkinkan.
Menonaktifkan thinking dibatasi pada effort high: Anda dapat mematikan thinking dengan thinking: {type: "disabled"}, tetapi hanya pada tingkat effort high atau lebih rendah. Permintaan yang menggabungkan thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400 di Claude Opus 5, diberlakukan pada setiap permintaan. Audit permintaan yang menonaktifkan thinking sebelum Anda bermigrasi: aktifkan kembali thinking atau turunkan effort ke high atau lebih rendah.
Parameter sampling dihapus: Mengatur temperature, top_p, atau top_k ke nilai non-default apa pun di Claude Opus 4.7 atau model yang lebih baru, termasuk Claude Opus 5, mengembalikan error 400. Jalur migrasi paling aman adalah menghilangkan parameter ini sepenuhnya dari payload permintaan. Prompting adalah cara yang direkomendasikan untuk memandu perilaku model di Claude Opus 5. Jika Anda menggunakan temperature = 0 untuk determinisme, perhatikan bahwa hal itu tidak pernah menjamin output yang identik pada model sebelumnya.
Konten thinking dihilangkan secara default: Blok thinking masih muncul dalam stream respons di Claude Opus 4.7 dan model yang lebih baru, tetapi field thinking-nya kosong kecuali Anda secara eksplisit memilih untuk mengaktifkannya. Ini adalah perubahan senyap dari Claude Opus 4.6, di mana default-nya adalah mengembalikan teks thinking yang diringkas. Untuk mengembalikan konten thinking yang diringkas, atur thinking.display ke "summarized":
thinking = {
"type": "adaptive",
"display": "summarized",
}Default-nya adalah "omitted" di Claude Opus 4.7 dan model yang lebih baru. Jika produk Anda melakukan streaming penalaran ke pengguna, default baru ini muncul sebagai jeda panjang sebelum output dimulai; atur display: "summarized" untuk mengembalikan progres yang terlihat selama thinking. Lihat Mengontrol tampilan thinking untuk detailnya.
Penghitungan token yang diperbarui: Claude Opus 4.7 memperkenalkan tokenizer baru, yang juga digunakan oleh model Opus selanjutnya, termasuk Claude Opus 5. Tokenizer ini berkontribusi pada peningkatan performa di berbagai tugas, dan mungkin menggunakan sekitar 1x hingga 1,35x lebih banyak token saat memproses teks dibandingkan dengan model sebelum Claude Opus 4.7 (hingga ~35% lebih banyak, bervariasi tergantung konten).
/v1/messages/count_tokens mengembalikan jumlah token yang berbeda untuk Claude Opus 5 dibandingkan dengan Claude Opus 4.6. Efisiensi token dapat bervariasi tergantung bentuk beban kerja.
Intervensi prompting, task_budget, dan effort dapat membantu mengontrol biaya dan memastikan penggunaan token yang sesuai. Kontrol ini mungkin menukar kecerdasan model. Perbarui parameter max_tokens Anda untuk memberikan ruang tambahan, termasuk pemicu pemadatan. Claude Opus 5 menyediakan jendela konteks 1 juta token dengan harga API standar tanpa biaya tambahan untuk konteks panjang.
Penghapusan prefill (dibawa dari Opus 4.6): Melakukan prefill pada pesan asisten mengembalikan error 400 di Claude Opus 4.7 dan model yang lebih baru, termasuk Claude Opus 5. Gunakan structured outputs, instruksi prompt sistem, atau output_config.format sebagai gantinya.
Parameter effort memungkinkan Anda menyetel kecerdasan Claude versus pengeluaran token, menukar kapabilitas dengan kecepatan yang lebih tinggi dan biaya yang lebih rendah. Claude Opus 5 mendukung seluruh rangkaian tingkat effort dan default-nya adalah high. Jalankan pengujian effort baru pada evaluasi Anda sendiri daripada membawa pengaturan yang disetel untuk model sebelumnya:
max: Dapat memberikan peningkatan pada tugas yang paling menuntut tetapi mungkin menunjukkan hasil yang semakin berkurang dari peningkatan penggunaan token dan dapat cenderung berpikir berlebihan pada tugas yang lebih sederhana. Uji di mana kapabilitas maksimum lebih penting daripada pengeluaran token.xhigh: Kapabilitas yang diperluas untuk pekerjaan agentic dan coding jangka panjang yang membutuhkan kedalaman lebih dari default.high: Default. Menyeimbangkan penggunaan token dan kecerdasan untuk sebagian besar tugas.medium: Penurunan satu tingkat dari default untuk menghemat biaya, layak diuji sebagai kontrol biaya dan latensi.low: Paling efisien. Simpan untuk tugas yang singkat, terbatas cakupannya, dan beban kerja yang sensitif terhadap latensi.Jika Anda menjalankan pada effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak; mulai dari 64k token dan sesuaikan dari sana. Effort lebih penting untuk model ini dibandingkan Opus sebelumnya. Bereksperimenlah secara aktif dengannya saat Anda melakukan upgrade.
Claude Opus 4.7 memperkenalkan beberapa perbedaan perilaku dari Claude Opus 4.6 yang bukan merupakan perubahan API yang merusak kompatibilitas tetapi mungkin memerlukan pembaruan prompt atau penghapusan scaffolding. Perubahan ini terbawa ke Claude Opus 5, dengan penyesuaian yang dicatat di bawah ini.
Panjang respons bervariasi berdasarkan kasus penggunaan: Claude Opus 4.7 mengkalibrasi panjang respons berdasarkan seberapa kompleks ia menilai tugas tersebut, alih-alih menggunakan tingkat verbositas tetap secara default. Ini biasanya berarti jawaban yang lebih pendek pada pencarian sederhana dan jauh lebih panjang pada analisis terbuka.
Jika produk Anda bergantung pada gaya atau verbositas output tertentu, Anda mungkin perlu menyetel prompt Anda. Misalnya, untuk mengurangi verbositas, tambahkan: "Berikan respons yang ringkas dan terfokus. Lewati konteks yang tidak esensial, dan jaga contoh seminimal mungkin." Jika Anda melihat jenis penjelasan berlebihan tertentu, tambahkan instruksi yang ditargetkan dalam prompt Anda untuk mencegahnya.
Contoh positif yang menunjukkan bagaimana Claude dapat berkomunikasi dengan tingkat keringkasan yang sesuai cenderung lebih efektif daripada contoh negatif atau instruksi yang memberi tahu model apa yang tidak boleh dilakukan. Di Claude Opus 5, respons yang terlihat secara default dan hasil tertulis cenderung lebih panjang daripada model Opus sebelumnya, dan menurunkan effort mengurangi volume thinking tanpa secara andal memperpendek respons yang terlihat; berikan prompt secara eksplisit untuk keringkasan atau panjang target. Lihat Panjang respons dan verbositas.
Mengikuti instruksi secara lebih harfiah: Claude Opus 4.7 menafsirkan prompt secara lebih harfiah dan eksplisit daripada Claude Opus 4.6, terutama pada tingkat effort yang lebih rendah. Model ini tidak secara diam-diam menggeneralisasi instruksi dari satu item ke item lain, dan tidak menyimpulkan permintaan yang tidak Anda buat. Sisi positif dari literalisme ini adalah presisi dan lebih sedikit kekacauan. Model ini umumnya berkinerja lebih baik untuk kasus penggunaan API dengan prompt yang disetel dengan cermat, ekstraksi terstruktur, dan pipeline di mana Anda menginginkan perilaku yang dapat diprediksi. Peninjauan prompt dan harness mungkin sangat membantu untuk migrasi ke Claude Opus 5.
Nada yang lebih langsung: Seperti halnya model baru lainnya, gaya prosa pada penulisan panjang mungkin bergeser. Claude Opus 4.7 lebih langsung dan berpendapat, dengan lebih sedikit frasa yang mengedepankan validasi dan lebih sedikit emoji dibandingkan gaya Claude Opus 4.6 yang lebih hangat. Jika produk Anda bergantung pada suara tertentu, evaluasi ulang prompt gaya terhadap baseline baru.
Pembaruan progres bawaan dalam jejak agentic: Claude Opus 4.7 memberikan pembaruan yang lebih teratur dan berkualitas lebih tinggi kepada pengguna sepanjang jejak agentic yang panjang. Jika Anda telah menambahkan scaffolding untuk memaksa pesan status sementara ("Setelah setiap 3 panggilan alat, ringkas progres"), coba hapus. Jika Anda menemukan bahwa panjang atau isi pembaruan yang ditampilkan ke pengguna dari Claude Opus 4.7 tidak terkalibrasi dengan baik untuk kasus penggunaan Anda, jelaskan secara eksplisit seperti apa pembaruan ini seharusnya dalam prompt dan berikan contoh.
Pembuatan subagent berubah: Claude Opus 4.7 cenderung membuat lebih sedikit subagent secara default dibandingkan Claude Opus 4.6, sementara Claude Opus 5 mendelegasikan ke subagent lebih mudah daripada model sebelumnya. Perilaku ini dapat diarahkan melalui prompting ke arah mana pun; berikan panduan eksplisit tentang kapan subagent diinginkan, atau batasi jumlah subagent. Lihat Mengontrol pembuatan subagent.
Kalibrasi effort yang lebih ketat: Berubah secara signifikan dari Claude Opus 4.6, Claude Opus 4.7 mematuhi tingkat effort secara ketat, terutama di tingkat rendah. Pada low dan medium, model membatasi cakupan pekerjaannya pada apa yang diminta daripada melakukan lebih dari yang diminta.
Ini baik untuk latensi dan biaya, tetapi pada tugas yang cukup kompleks yang berjalan pada effort low ada risiko kurang berpikir. Jika Anda mengamati penalaran yang dangkal pada masalah kompleks, naikkan effort ke high atau xhigh daripada mengatasinya melalui prompting.
Jika Anda perlu mempertahankan effort di low untuk latensi, tambahkan panduan yang ditargetkan: "Tugas ini melibatkan penalaran multi-langkah. Pikirkan masalah ini dengan cermat sebelum merespons." Lihat Tingkat effort yang direkomendasikan untuk Claude Opus 4.7.
Lebih sedikit panggilan alat secara default: Claude Opus 4.7 memiliki kecenderungan untuk menggunakan alat lebih jarang daripada Claude Opus 4.6 dan lebih banyak menggunakan penalaran. Ini menghasilkan hasil yang lebih baik dalam sebagian besar kasus.
Untuk meningkatkan penggunaan alat, naikkan pengaturan effort. Pengaturan effort high atau xhigh menunjukkan penggunaan alat yang jauh lebih banyak dalam pencarian agentic dan coding. Anda juga dapat menyesuaikan prompt Anda untuk secara eksplisit menginstruksikan model tentang kapan dan bagaimana menggunakan alatnya dengan benar.
Pengamanan keamanan siber real-time: Baru ditambahkan di Claude Opus 4.7, permintaan yang melibatkan topik terlarang atau berisiko tinggi dapat menyebabkan penolakan. Untuk pekerjaan keamanan yang sah seperti penetration testing, penelitian kerentanan, atau red-teaming, ajukan permohonan ke Cyber Verification Program untuk meminta pengurangan pembatasan. Lihat Safeguards, warnings, and appeals untuk latar belakang.
Dukungan gambar resolusi tinggi: Claude Opus 4.7 adalah model Claude pertama dengan dukungan gambar resolusi tinggi. Resolusi gambar maksimum adalah 2.576 piksel pada sisi panjang, naik dari 1.568 piksel pada model sebelumnya. Ini membuka peningkatan pada beban kerja yang berat visual dan sangat berharga untuk computer use, pemahaman screenshot, dan analisis dokumen.
Dukungan resolusi tinggi bersifat otomatis dan tidak memerlukan header beta atau opt-in sisi klien. Dua hal yang perlu direncanakan:
max_tokens dan ekspektasi biaya untuk beban kerja yang berat gambar, atau lakukan downsample sebelum mengirim jika Anda tidak memerlukan fidelitas tambahan.Lihat Dukungan gambar resolusi tinggi di Claude Opus 4.7 untuk detailnya.
Perubahan ini tidak wajib tetapi akan meningkatkan pengalaman Anda:
Evaluasi ulang max_tokens: Karena teks yang sama menghasilkan jumlah token yang lebih tinggi di Claude Opus 4.7 dan model yang lebih baru, perbarui parameter max_tokens Anda untuk memberikan ruang tambahan, termasuk pemicu pemadatan. Intervensi prompting, task_budget, dan effort dapat membantu mengontrol biaya dan memastikan penggunaan token yang sesuai.
Audit ekspektasi jumlah token: Setiap jalur kode yang memperkirakan token di sisi klien atau mengasumsikan rasio token-ke-karakter tetap harus diuji ulang terhadap Claude Opus 5. Gunakan endpoint Token counting untuk memverifikasi.
Adopsi task budgets (beta): Claude Opus 4.7 memperkenalkan task budgets. Budget ini memungkinkan Anda memberi tahu Claude berapa banyak token yang dimilikinya untuk satu loop agentic penuh, termasuk thinking, panggilan alat, hasil alat, dan output akhir. Model melihat hitungan mundur yang berjalan dan menggunakannya untuk memprioritaskan pekerjaan dan menyelesaikan tugas dengan baik saat budget habis. Untuk menggunakannya, atur header beta task-budgets-2026-03-13 dan tambahkan yang berikut ke output config Anda:
output_config = {
"effort": "high",
"task_budget": {"type": "tokens", "total": 128000},
}Anda mungkin perlu bereksperimen dengan task budget yang berbeda untuk kasus penggunaan Anda. Jika model diberi task budget yang terlalu ketat, model mungkin menyelesaikan tugas dengan kurang menyeluruh, dengan merujuk budget-nya sebagai kendala.
Untuk tugas agentic terbuka di mana kualitas lebih penting daripada kecepatan, jangan atur task budget. Simpan task budget untuk beban kerja di mana Anda membutuhkan model untuk membatasi cakupan pekerjaannya pada alokasi token. Nilai minimum untuk task budget adalah 20k token.
Task budget bukanlah batas keras; ini adalah saran yang disadari oleh model. Ini berbeda dari max_tokens:
task_budget: batas advisori di seluruh loop agentic penuh. Model melihatnya dan menggunakannya untuk mengatur kecepatannya sendiri.max_tokens: batas keras per permintaan pada token yang dihasilkan. Ini tidak diteruskan ke model, sehingga model tidak menyadarinya.Gunakan task_budget ketika Anda ingin model mengatur dirinya sendiri, dan max_tokens sebagai batas keras untuk membatasi penggunaan.
Atur max_tokens yang besar pada effort max atau xhigh: Jika Anda menjalankan Claude Opus 4.7 atau model yang lebih baru pada effort max atau xhigh, atur budget token output maksimum yang besar agar model memiliki ruang untuk berpikir dan bertindak di seluruh subagent dan panggilan alatnya. Mulai dari 64k token dan sesuaikan dari sana.
Lakukan downsample gambar jika resolusi tinggi tidak diperlukan: Claude Opus 4.7 dan model yang lebih baru mendukung gambar hingga 2576px / 3,75MP. Gambar resolusi tinggi menggunakan lebih banyak token. Jika fidelitas gambar tambahan tidak diperlukan, lakukan downsample gambar sebelum mengirim ke Claude untuk menghindari peningkatan penggunaan token. Lihat Gambar dan vision.
Pertimbangkan fallback otomatis: Claude Opus 5 dilengkapi dengan classifier keamanan siber yang penolakan kategori sibernya dapat di-fallback ke Claude Opus 4.8. Untuk menjalankan ulang permintaan yang ditolak pada model lain secara otomatis, pertimbangkan parameter fallbacks dengan mode "default" (fallbacks: "default"), yang memilih model fallback yang direkomendasikan berdasarkan kategori penolakan alih-alih daftar model yang dikelola secara manual. Fallback sisi server masih dalam beta; mode "default" memerlukan header beta server-side-fallback-2026-07-01. Lihat Penolakan dan fallback.
Cache prompt yang lebih pendek: Panjang prompt minimum yang dapat di-cache di Claude Opus 5 adalah 512 token, lebih rendah daripada model Opus sebelumnya. Prompt yang sebelumnya terlalu pendek untuk di-cache sekarang dapat membuat entri cache, tanpa perubahan kode yang diperlukan. Lihat Caching prompt untuk minimum per model.
Ubah alat di tengah percakapan (beta): Anda dapat menambah atau menghapus alat di antara giliran percakapan tanpa membatalkan hit cache prompt pada giliran sebelumnya. Kirim header beta mid-conversation-tool-changes-2026-07-01. Ini berguna untuk beban kerja agentic yang mengekspos alat secara progresif atau menghentikannya saat tugas berlanjut; tanpa header ini, daftar alat yang berubah membatalkan prefix yang di-cache.
Hapus instruksi verifikasi yang terbawa dan batasi cakupan: Claude Opus 5 memverifikasi pekerjaannya sendiri tanpa diberi tahu, jadi hapus instruksi verifikasi atau pemeriksaan mandiri eksplisit yang terbawa dari prompt yang disetel untuk model sebelumnya; membiarkannya menyebabkan verifikasi berlebihan. Untuk tugas yang sempit, batasi cakupan tugas secara eksplisit. Lihat Cakupan tugas dan verifikasi berlebihan.
claude-opus-4-6 ke claude-opus-5 (atau perbarui alias).temperature, top_p, dan top_k dari payload permintaan.thinking: {type: "enabled", budget_tokens: N} dengan thinking: {type: "adaptive"} ditambah parameter effort, atau hapus field thinking sepenuhnya; adaptive thinking aktif secara default di Claude Opus 5.thinking: beban kerja tersebut berjalan dengan thinking di Claude Opus 5. Tinjau kembali max_tokens, yang tetap menjadi batas keras pada total output (thinking ditambah teks respons), atau kirimkan thinking: {type: "disabled"} pada effort high atau lebih rendah untuk mempertahankan perilaku lama.thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400, diberlakukan pada setiap permintaan. Aktifkan kembali thinking atau turunkan effort ke high atau lebih rendah.max_tokens untuk memperhitungkan tokenisasi yang diperbarui.xhigh atau max, naikkan max_tokens ke setidaknya 64k sebagai titik awal.stop_reason: "refusal", dan pertimbangkan fallbacks: "default" (beta) untuk menjalankan ulang permintaan yang ditolak pada model fallback yang direkomendasikan secara otomatis.Jika Anda bermigrasi dari Claude Opus 4.5, Opus 4.1, atau model sebelumnya langsung ke Claude Opus 5, terapkan semua perubahan di awal bagian ini ditambah perubahan kumulatif berikut, yang mulai berlaku antara Opus 4.5 dan Opus 4.7. Jika Anda bermigrasi dari Opus 4.6, perubahan di awal bagian ini adalah semua yang Anda butuhkan.
# Migrasi Opus
model = "claude-opus-4-5" # Before
model = "claude-opus-5" # AfterPenghapusan prefill dibahas dalam perubahan yang merusak kompatibilitas untuk migrasi dari Claude Opus 4.6.
Quoting parameter alat: Claude Opus 4.6 dan model yang lebih baru mungkin menghasilkan escaping string JSON yang sedikit berbeda dalam argumen panggilan alat (misalnya, penanganan escape Unicode atau escaping forward slash yang berbeda). Jika Anda mem-parse input panggilan alat sebagai string mentah daripada menggunakan parser JSON, verifikasi logika parsing Anda. Parser JSON standar (seperti json.loads() atau JSON.parse()) menangani perbedaan ini secara otomatis.
Perubahan ini meningkatkan pengalaman Anda di Claude Opus 4.7 dan model yang lebih baru. Item yang ditandai (wajib di Opus 4.7) adalah rekomendasi opsional saat Opus 4.6 diluncurkan tetapi sekarang wajib; sisanya tetap direkomendasikan.
Migrasi ke adaptive thinking (wajib di Opus 4.7): thinking: {type: "enabled", budget_tokens: N} mengembalikan error 400 di Claude Opus 4.7 dan model yang lebih baru. Beralihlah ke thinking: {type: "adaptive"} dan gunakan parameter effort untuk mengontrol kedalaman thinking; di Claude Opus 5, thinking: {type: "adaptive"} setara dengan menghilangkan field thinking, yang berjalan dengan adaptive thinking secara default. Lihat Thinking.
response = client.beta.messages.create(
model="claude-opus-4-5",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 32000},
betas=["interleaved-thinking-2025-05-14"],
messages=[{"role": "user", "content": "Your prompt here"}],
)Perhatikan bahwa migrasi ini juga berpindah dari client.beta.messages.create ke client.messages.create. Adaptive thinking dan effort adalah fitur GA dan tidak memerlukan namespace SDK beta atau header beta apa pun.
Hapus header beta effort: Parameter effort sekarang GA. Hapus betas=["effort-2025-11-24"] dari permintaan Anda.
Hapus header beta fine-grained tool streaming: Fine-grained tool streaming sekarang GA. Hapus betas=["fine-grained-tool-streaming-2025-05-14"] dari permintaan Anda.
Hapus header beta interleaved thinking: Adaptive thinking secara otomatis mengaktifkan interleaved thinking di Claude Opus 4.7, Opus 4.6, dan Sonnet 4.6. Hapus betas=["interleaved-thinking-2025-05-14"] dari permintaan Anda. Header ini masih berfungsi di Sonnet 4.6 dengan extended thinking manual, tetapi mode manual sudah deprecated.
Migrasi ke output_config.format: Jika menggunakan structured outputs, perbarui output_format={...} menjadi output_config={"format": {...}}. Parameter lama tetap berfungsi tetapi sudah deprecated dan akan dihapus dalam rilis model mendatang.
Jika Anda bermigrasi dari Opus 4.1 atau model sebelumnya langsung ke Claude Opus 5, terapkan semua perubahan di awal bagian ini, ditambah perubahan tambahan di sub-bagian ini.
# Dari Opus 4.1
model = "claude-opus-4-1-20250805" # Before
model = "claude-opus-5" # After
# Dari Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # Before
model = "claude-opus-5" # AfterHapus parameter sampling
Mulai dari Claude Opus 4.7, mengatur temperature, top_p, atau top_k ke nilai non-default apa pun mengembalikan error 400. Jalur migrasi paling aman adalah menghilangkan parameter ini sepenuhnya dari permintaan, dan menggunakan prompting untuk memandu perilaku model. Jika Anda menggunakan temperature = 0 untuk determinisme, perhatikan bahwa hal itu tidak pernah menjamin output yang identik.
# Before - This will error in Claude 4+ models
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # Non-default sampling params return 400 on Opus 4.7
# ...
)
# After
response = client.messages.create(
model="claude-opus-5",
# ...
)Perbarui versi alat
Perbarui ke versi alat terbaru. Hapus semua kode yang menggunakan perintah undo_edit.
# Sebelum
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# Sesudah
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]text_editor_20250728 dan str_replace_based_edit_tool. Lihat dokumentasi Alat text editor untuk detailnya.code_execution_20260521. Lihat dokumentasi Alat code execution untuk instruksi migrasi.Tangani stop reason refusal
Perbarui aplikasi Anda untuk menangani stop reason refusal:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Tangani penolakan dengan tepat
passTangani stop reason model_context_window_exceeded
Model Claude 4.5+ mengembalikan stop reason model_context_window_exceeded ketika generasi berhenti karena mencapai batas jendela konteks, bukan batas max_tokens yang diminta. Perbarui aplikasi Anda untuk menangani stop reason baru ini:
response = client.messages.create(...)
if response.stop_reason == "model_context_window_exceeded":
# Tangani batas jendela konteks dengan tepat
passVerifikasi penanganan parameter alat (newline di akhir)
Model Claude 4.5+ mempertahankan newline di akhir dalam parameter string panggilan alat yang sebelumnya dihapus. Jika alat Anda bergantung pada pencocokan string yang tepat terhadap parameter panggilan alat, verifikasi bahwa logika Anda menangani newline di akhir dengan benar.
Perbarui prompt Anda untuk perubahan perilaku
Model Claude 4+ memiliki gaya komunikasi yang lebih ringkas dan langsung serta memerlukan arahan eksplisit. Tinjau praktik terbaik prompting untuk panduan optimasi.
token-efficient-tools-2025-02-19 dan output-128k-2025-02-19. Semua model Claude 4+ memiliki penggunaan alat yang efisien token secara bawaan dan header ini tidak memiliki efek.claude-opus-5output_config.format sebagai gantinyathinking: {type: "enabled", budget_tokens: N} dengan thinking: {type: "adaptive"} ditambah parameter effort (mengembalikan 400 di Opus 4.7)effort-2025-11-24 (effort sekarang GA)fine-grained-tool-streaming-2025-05-14interleaved-thinking-2025-05-14 (adaptive thinking mengaktifkan interleaved thinking secara otomatis)output_format ke output_config.format (jika berlaku)temperature, top_p, dan top_k (nilai non-default mengembalikan 400 di Opus 4.7)text_editor_20250728, code_execution_20260521)refusalmodel_context_window_exceededtoken-efficient-tools-2025-02-19, output-128k-2025-02-19)Claude Opus 5 dan Claude Sonnet 5 memiliki permukaan API yang sama: keduanya berjalan dengan adaptive thinking (pemikiran adaptif) yang aktif secara default, keduanya menetapkan parameter effort ke high secara default pada Claude API dan Claude Code, keduanya menyediakan jendela konteks 1 juta token secara default dengan maksimum 128k token output, dan keduanya tidak mendukung Priority Tier. Pemikiran diperpanjang manual dan parameter sampling non-default mengembalikan error 400 pada kedua model, begitu juga dengan prefill asisten.
model = "claude-sonnet-5" # Before
model = "claude-opus-5" # AfterHarga: Claude Opus 5 dihargai $5 per juta token input dan $25 per juta token output. Claude Sonnet 5 dihargai $2/$10 per juta token input/output. Lihat harga Claude untuk harga lengkap.
Menonaktifkan thinking dibatasi pada effort high: Pada Claude Sonnet 5, thinking: {type: "disabled"} diterima pada tingkat effort apa pun. Pada Claude Opus 5, ini hanya diterima pada tingkat effort high atau lebih rendah; permintaan yang menggabungkan thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400, yang diberlakukan pada setiap permintaan. Audit permintaan yang menonaktifkan thinking sebelum Anda melakukan migrasi.
Pesan sistem di tengah percakapan: Claude Opus 5 menerima pesan role: "system" segera setelah giliran pengguna dalam array messages (tunduk pada aturan penempatan); Claude Sonnet 5 tidak. Jika Anda memelihara jalur kode yang membangun ulang seluruh riwayat pesan untuk memperbarui instruksi, Anda dapat menyederhanakannya dan mempertahankan hit cache prompt pada giliran sebelumnya.
Web fetch tidak tersedia: Alat web fetch tersedia pada Claude Sonnet 5 tetapi tidak pada Claude Opus 5.
claude-sonnet-5 ke claude-opus-5.thinking: {type: "disabled"} dengan effort xhigh atau max mengembalikan error 400 pada Claude Opus 5. Aktifkan kembali thinking atau turunkan effort ke high atau lebih rendah.Claude Sonnet 5 menawarkan kombinasi terbaik antara kecepatan dan kecerdasan dalam keluarga model Claude. Model ini dibangun di atas Claude Sonnet 4.6.
Claude Sonnet 5 adalah peningkatan langsung (drop-in upgrade) untuk Claude Sonnet 4.6, dengan harga $2/$10 USD per juta token input/output; lihat Harga untuk detailnya. Ada dua perubahan API yang bersifat breaking untuk kode yang sudah berjalan pada Claude Sonnet 4.6: pemikiran diperpanjang manual (thinking: {type: "enabled", budget_tokens: N}) dan parameter sampling (temperature, top_p, top_k) yang diatur ke nilai non-default tidak lagi diterima dan mengembalikan error 400. Gunakan adaptive thinking dengan parameter effort sebagai gantinya. Claude Sonnet 5 mendukung set fitur yang sama dengan Claude Sonnet 4.6, termasuk jendela konteks 1 juta token, adaptive thinking, caching prompt, pemrosesan batch, Files API, dukungan PDF, vision, dan set lengkap alat sisi server dan sisi klien. Priority Tier tidak tersedia pada Claude Sonnet 5. Claude Sonnet 5 juga menggunakan tokenizer baru.
# Migrasi Sonnet
model = "claude-sonnet-4-6" # Before
model = "claude-sonnet-5" # AfterItem 4 dan 5 dalam daftar berikut adalah perubahan breaking. max_tokens tetap menjadi batas keras pada total output (thinking ditambah teks respons), jadi tinjau kembali untuk beban kerja yang berjalan tanpa thinking pada Claude Sonnet 4.6.
Tokenizer baru: Claude Sonnet 5 menggunakan tokenizer baru. Teks input yang sama menghasilkan sekitar 30% lebih banyak token dibandingkan pada Claude Sonnet 4.6. Peningkatan pastinya bergantung pada konten. Permintaan, respons, dan event streaming mempertahankan bentuk yang sama, dan tidak ada perubahan kode yang diperlukan, tetapi apa pun yang Anda ukur atau anggarkan dalam token akan bergeser: field usage dan hasil penghitungan token untuk teks yang sama lebih tinggi, jendela konteks 1 juta token menampung lebih sedikit teks, dan batas max_tokens yang disesuaikan untuk Claude Sonnet 4.6 mungkin memotong output yang setara. Harga per token lebih rendah ($2/$10 dibandingkan $3/$15 per juta token input/output pada Claude Sonnet 4.6), tetapi biaya permintaan yang setara tidak turun secara proporsional langsung. Jalankan ulang penghitungan token terhadap Claude Sonnet 5 daripada menggunakan kembali hitungan yang diukur terhadap model sebelumnya.
Maksimum 128k token output (tidak berubah): Claude Sonnet 5 mendukung hingga 128k token output, sama dengan Claude Sonnet 4.6. Nilai max_tokens yang ada tetap valid. Perhitungkan tokenizer baru saat menentukan ukurannya.
Prefilling pesan asisten (tidak berubah): Prefilling pesan asisten mengembalikan error 400 pada Claude Sonnet 5, sama seperti pada Claude Sonnet 4.6. Jika Anda menghapus prefill saat bermigrasi ke Claude Sonnet 4.6, tidak ada perubahan lebih lanjut yang diperlukan. Gunakan structured outputs, instruksi prompt sistem, atau output_config.format sebagai gantinya.
Adaptive thinking aktif secara default: Pada Claude Sonnet 4.6, permintaan tanpa field thinking berjalan tanpa thinking; pada Claude Sonnet 5, permintaan yang sama berjalan dengan adaptive thinking. Untuk menonaktifkan thinking, kirimkan thinking: {type: "disabled"}. Pemikiran diperpanjang manual (thinking: {type: "enabled", budget_tokens: N}) tidak didukung dan mengembalikan error 400. Gunakan parameter effort (default high) untuk mengontrol kedalaman thinking.
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=16000,
thinking={"type": "adaptive", "display": "summarized"},
output_config={"effort": "high"},
messages=[
{
"role": "user",
"content": "Are there an infinite number of prime numbers such that n mod 4 == 3?",
}
],
)
# Respons berisi blok pemikiran yang diringkas dan blok teks
for block in response.content:
match block.type:
case "thinking":
print(f"\nThinking summary: {block.thinking}")
case "text":
print(f"\nResponse: {block.text}")Parameter sampling dihapus: Parameter sampling (temperature, top_p, top_k) yang diatur ke nilai non-default tidak diterima dan mengembalikan error 400.
Pengamanan keamanan siber: Claude Sonnet 5 adalah model tingkat Sonnet pertama dengan pengamanan keamanan siber real-time. Permintaan yang melibatkan topik keamanan siber yang dilarang atau berisiko tinggi mungkin ditolak. Penolakan dikembalikan sebagai respons HTTP 200 yang berhasil dengan stop_reason: "refusal", bukan error. Lihat Safeguards, warnings, and appeals untuk latar belakang.
claude-sonnet-4-6 ke claude-sonnet-5.max_tokens yang diatur mendekati panjang output yang Anda harapkan, dan naikkan hingga maksimum 128k (tidak berubah dari Claude Sonnet 4.6) jika berguna.thinking: {type: "enabled", budget_tokens: N} (mengembalikan error 400). Adaptive thinking aktif secara default; kirimkan {type: "disabled"} untuk menonaktifkannya, atau gunakan parameter effort untuk mengontrol kedalaman.temperature, top_p, dan top_k yang diatur ke nilai non-default (mengembalikan error 400 pada Claude Sonnet 5).stop_reason: "refusal" jika beban kerja Anda mungkin menyentuh topik keamanan siber.max_tokens untuk beban kerja yang sebelumnya berjalan tanpa thinking.Jika Anda bermigrasi dari Claude Sonnet 4.5 atau model Sonnet sebelumnya langsung ke Claude Sonnet 5, terapkan perubahan Migrasi ke Claude Sonnet 5 dari Claude Sonnet 4.6 ditambah perubahan di bagian ini.
Prefilling pesan asisten tidak lagi didukung
Prefilling pesan asisten mengembalikan error 400 pada Claude Sonnet 4.6 dan model yang lebih baru, termasuk Claude Sonnet 5. Gunakan structured outputs, instruksi prompt sistem, atau output_config.format sebagai gantinya.
Kasus penggunaan prefill umum dan migrasinya:
Mengontrol format output (memaksa output JSON/YAML): Gunakan structured outputs atau alat dengan field enum untuk tugas klasifikasi.
Menghilangkan pembukaan (menghapus frasa "Here is..."): Tambahkan instruksi langsung dalam prompt sistem: "Respond directly without preamble. Do not start with phrases like 'Here is...', 'Based on...', etc."
Menghindari penolakan yang buruk: Claude sekarang jauh lebih baik dalam penolakan yang tepat. Prompting yang jelas dalam pesan pengguna tanpa prefill seharusnya sudah cukup.
Kelanjutan (melanjutkan respons yang terputus): Pindahkan kelanjutan ke pesan pengguna: "Your previous response was interrupted and ended with [previous_response]. Continue from where you left off."
Hidrasi konteks / konsistensi peran (menyegarkan konteks dalam percakapan panjang): Masukkan apa yang sebelumnya merupakan pengingat asisten yang di-prefill ke dalam giliran pengguna sebagai gantinya.
Escaping JSON parameter alat mungkin berbeda
Escaping string JSON dalam parameter alat mungkin berbeda dari model sebelumnya. Parser JSON standar menangani ini secara otomatis, tetapi parsing berbasis string kustom mungkin perlu diperbarui.
Perubahan pemikiran diperpanjang: Konfigurasi budget_tokens dari Claude Sonnet 4.5 (thinking: {type: "enabled", budget_tokens: N}) tidak didukung pada Claude Sonnet 5 dan mengembalikan error 400. Adaptive thinking aktif secara default, jadi sebagian besar beban kerja tidak memerlukan konfigurasi thinking sama sekali; gunakan parameter effort untuk mengontrol kedalaman thinking. Jika Anda menjalankan Claude Sonnet 4.5 tanpa pemikiran diperpanjang, kirimkan thinking: {type: "disabled"} untuk mempertahankan perilaku tersebut.
Hapus parameter sampling
Parameter sampling (temperature, top_p, top_k) yang diatur ke nilai non-default mengembalikan error 400 pada Claude Sonnet 5. Hapus dari permintaan, dan gunakan prompting untuk memandu perilaku model sebagai gantinya.
Perbarui versi alat
Perbarui ke versi alat terbaru (text_editor_20250728, code_execution_20260521). Hapus kode apa pun yang menggunakan perintah undo_edit.
Tangani stop reason refusal
Perbarui aplikasi Anda untuk menangani stop reason refusal.
Perbarui prompt Anda untuk perubahan perilaku
Model Claude 4 memiliki gaya komunikasi yang lebih ringkas dan langsung. Tinjau praktik terbaik prompting untuk panduan optimasi.
Claude Haiku 4.5 dan Claude Sonnet 5 berbeda lebih banyak pada tingkat API dibandingkan model yang berdekatan dalam satu kelas: Claude Haiku 4.5 menggunakan pemikiran diperpanjang manual (nonaktif secara default), jendela konteks 200k token, dan hingga 64k token output, sementara Claude Sonnet 5 berjalan dengan adaptive thinking aktif secara default, menyediakan jendela konteks 1 juta token secara default, dan mendukung hingga 128k token output.
model = "claude-haiku-4-5-20251001" # Before
model = "claude-sonnet-5" # AfterKonfigurasi thinking: Claude Haiku 4.5 mendukung pemikiran diperpanjang manual (thinking: {type: "enabled", budget_tokens: N}) dan menolak thinking: {type: "adaptive"}. Pada Claude Sonnet 5, dukungannya terbalik: adaptive thinking aktif secara default, dan pemikiran diperpanjang manual mengembalikan error 400. Hapus konfigurasi thinking: {type: "enabled", budget_tokens: N} dan andalkan default, atau kirimkan thinking: {type: "disabled"} untuk menonaktifkan thinking. budget_tokens tidak memiliki pengganti langsung; gunakan parameter effort untuk mengontrol kedalaman thinking. Effort tidak tersedia pada Claude Haiku 4.5 dan default ke high pada Claude Sonnet 5.
Parameter sampling dihapus: temperature dan top_p berfungsi pada Claude Haiku 4.5 (satu per satu, tidak keduanya). Pada Claude Sonnet 5, mengatur temperature, top_p, atau top_k ke nilai non-default mengembalikan error 400. Hapus parameter ini dan gunakan prompting untuk memandu perilaku model.
Prefill asisten dihapus: Prefilling pesan asisten berfungsi pada Claude Haiku 4.5 tetapi mengembalikan error 400 pada Claude Sonnet 5. Gunakan structured outputs, instruksi prompt sistem, atau output_config.format sebagai gantinya.
Jendela konteks dan output yang lebih besar: Claude Sonnet 5 menyediakan jendela konteks 1 juta token secara default, naik dari 200k token pada Claude Haiku 4.5, dan mendukung hingga 128k token output, naik dari 64k. Claude Sonnet 5 juga menggunakan tokenizer yang berbeda, jadi jalankan ulang penghitungan token daripada menggunakan kembali hitungan yang diukur terhadap Claude Haiku 4.5.
Harga: Claude Haiku 4.5 dihargai $1/$5 per juta token input/output. Claude Sonnet 5 dihargai $2/$10 per juta token input/output. Lihat harga Claude.
Pengamanan keamanan siber: Claude Sonnet 5 memiliki pengamanan keamanan siber real-time. Permintaan yang melibatkan topik keamanan siber yang dilarang atau berisiko tinggi mungkin ditolak, dikembalikan sebagai respons HTTP 200 yang berhasil dengan stop_reason: "refusal". Lihat Safeguards, warnings, and appeals untuk latar belakang.
claude-haiku-4-5-20251001 (atau alias claude-haiku-4-5) ke claude-sonnet-5.thinking: {type: "enabled", budget_tokens: N} (mengembalikan error 400). Adaptive thinking aktif secara default; kirimkan thinking: {type: "disabled"} untuk mempertahankan perilaku tanpa thinking, dan tinjau kembali max_tokens untuk beban kerja yang berjalan tanpa thinking.high) untuk mengontrol kedalaman thinking dan pengeluaran token; ini tidak tersedia pada Claude Haiku 4.5, jadi tidak ada pengaturan yang ada yang terbawa.temperature dan top_p (nilai non-default mengembalikan error 400 pada Claude Sonnet 5).max_tokens, yang dapat Anda naikkan hingga maksimum 128k.stop_reason: "refusal" jika beban kerja Anda mungkin menyentuh topik keamanan siber.Claude Haiku 4.5 adalah model Haiku tercepat dan paling cerdas dengan performa mendekati frontier, memberikan kualitas model premium untuk aplikasi interaktif dan pemrosesan volume tinggi.
Untuk gambaran lengkap tentang kemampuan, lihat gambaran umum model.
Perbarui nama model Anda:
# Dari Haiku 3.5
model = "claude-3-5-haiku-20241022" # Before
model = "claude-haiku-4-5-20251001" # AfterTinjau batas laju baru: Haiku 4.5 memiliki batas laju terpisah dari Haiku 3.5. Lihat dokumentasi Batas laju untuk detailnya.
Jelajahi kemampuan baru: Lihat gambaran umum model untuk detail tentang kesadaran konteks, kapasitas output yang ditingkatkan (64k token), kecerdasan yang lebih tinggi, dan kecepatan yang ditingkatkan.
Perubahan breaking ini berlaku saat bermigrasi dari model Claude 3.x Haiku.
Perbarui parameter sampling
Gunakan hanya temperature ATAU top_p, tidak keduanya. Mengatur keduanya mengembalikan error 400 pada Claude Haiku 4.5.
Perbarui versi alat
Perbarui ke versi alat terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.
Tangani stop reason refusal
Perbarui aplikasi Anda untuk menangani stop reason refusal.
Perbarui prompt Anda untuk perubahan perilaku
Model Claude 4 memiliki gaya komunikasi yang lebih ringkas dan langsung. Tinjau praktik terbaik prompting untuk panduan optimasi.
claude-haiku-4-5-20251001text_editor_20250728, code_execution_20250825); versi lama tidak didukungundo_edit (jika berlaku)temperature ATAU top_p, tidak keduanya (mengatur keduanya mengembalikan error 400)refusal baru dalam aplikasi AndaWas this page helpful?