Panduan migrasi Claude Haiku 5.5
Beralih ke Claude Haiku 5.5 dari model Haiku sebelumnya dengan panduan migrasi ini. Panduan untuk mengaktifkan Claude Haiku 5.5 mencakup ID model baru, pengaturan yang mengembalikan error, perubahan pemikiran, dan daftar periksa untuk setiap model awal.
Claude Code
Biarkan Claude Code memigrasikan kode Anda
/claude-api migrate proyek ini ke claude-haiku-5-5Panduan ini membahas pemindahan kode yang memanggil Claude Haiku 4.5 ke Claude Haiku 5.5. Untuk kode yang memanggil Claude Haiku 3.5 atau Claude Haiku 3, lakukan juga perubahan di Migrasi ke Claude Haiku 5.5 dari Claude Haiku 3.5 dan model Haiku sebelumnya. Untuk beralih ke model Sonnet atau Opus sebagai gantinya, lihat Panduan migrasi. Untuk mengetahui berapa lama Claude Haiku 4.5 tetap tersedia, lihat Penghentian model.
Daftar periksa migrasi berdasarkan model awal
Kerjakan grup-grup ini secara berurutan dan berhenti setelah grup yang menyebutkan model Anda saat ini. Jika Anda menggunakan Claude Haiku 4.5, grup pertama adalah seluruh daftarnya. Setiap item adalah satu perubahan yang perlu dilakukan dalam kode Anda.
Setiap model awal
- Ganti ID model dengan ID Claude Haiku 5.5 untuk platform Anda. Lihat Gunakan ID model Claude Haiku 5.5.
- Hitung ulang prompt Anda, dan tinjau kembali batas
max_tokensserta estimasi biaya, karena teks yang sama dihitung sebagai lebih banyak token dan gambar berukuran besar dihitung sebagai lebih banyak token visual. Lihat Hitung ulang token. - Jika permintaan Anda mengirimkan
thinking: {"type": "enabled", "budget_tokens": N}, ubahthinkingmenjadi{"type": "adaptive"}. Lihat Konfigurasikan pemikiran. - Jika kode Anda membaca blok konten pertama sebagai jawaban, pilih blok berdasarkan
typesebagai gantinya. Lihat Konfigurasikan pemikiran. - Hapus
temperature,top_p, dantop_kdari permintaan Anda. Lihat Hapus parameter sampling. - Jika permintaan Anda mengakhiri
messagesdengan giliran asisten agar dilanjutkan oleh model, akhiri dengan giliran pengguna sebagai gantinya. Lihat Ganti prefill asisten. - Jika Anda menggunakan fitur penggunaan komputer, ganti
computer_20250124dengan toolsetcomputer_toolset_20260801. Di Amazon Bedrock,computer_20251124juga berfungsi. Lihat Pindahkan penggunaan komputer ke toolset. - Jika Anda memutar ulang percakapan yang tersimpan melalui akun yang berbeda, putar ulang masing-masing melalui akun yang menghasilkannya. Lihat Putar ulang blok pemikiran melalui akun yang menghasilkannya.
- Jika kode Anda mengubah
system,tools, ataumessagessebelumnya di antara permintaan dalam sebuah percakapan dan mengirimkan kembali blok pemikiran, pertahankan percakapan agar bersifat append-only (hanya ditambahkan). Lihat Pertahankan giliran sebelumnya tidak berubah. - Tangani
stop_reason: "refusal". Claude Haiku 5.5 menjalankan pengklasifikasi keamanan yang dapat menolak permintaan, dan model ini tidak memiliki fallback di sisi server. Lihat Penolakan safeguard. - Jika prompt Anda meminta model untuk menuliskan penalarannya di dalam respons, misalnya di dalam tag
<thinking>atau<reasoning>, hapus instruksi tersebut. Claude Haiku 5.5 mungkin menolak permintaan yang menyertakannya dan mengembalikan kategorireasoning_extraction. Lihat Penolakan safeguard.
Jika organisasi Anda memiliki komitmen Priority Tier pada Claude Haiku 4.5, rencanakan kapasitas secara terpisah: Priority Tier tidak didukung pada Claude Haiku 5.5.
Claude Haiku 3.5 atau sebelumnya
- Ganti ID model Claude Haiku 3.5 atau Claude Haiku 3 dengan ID Claude Haiku 5.5 untuk platform Anda. Lihat Migrasi ke Claude Haiku 5.5 dari Claude Haiku 3.5 dan model Haiku sebelumnya.
- Jika Anda menggunakan alat
code_execution_20250522, pindah kecode_execution_20250825atau yang lebih baru. - Jika Anda menggunakan alat editor teks, pindah ke
text_editor_20250728. - Tangani alasan berhenti
refusaldanmodel_context_window_exceeded. - Jika kode Anda mencocokkan parameter string panggilan alat secara persis, perhitungkan adanya baris baru di akhir (trailing newline).
- Tinjau prompt Anda.
Gunakan ID model Claude Haiku 5.5
Ganti ID model Claude Haiku 4.5 dengan ID Claude Haiku 5.5 untuk platform Anda.
| Platform | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 atau claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Anthropic managed) | claude-haiku-4-5-20251001 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Google managed) | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5 adalah ID model tetap tanpa akhiran tanggal dan tanpa alias terpisah.
Hitung ulang token
Claude Haiku 5.5 menggunakan tokenizer yang sama dengan Claude 4.7 dan model yang lebih baru. Seperti semua model yang menggunakan tokenizer ini, teks input yang sama menghasilkan sekitar 30 persen lebih banyak token pada Claude Haiku 5.5 dibandingkan pada Claude Haiku 4.5. Peningkatan pastinya bergantung pada konten. Permintaan, respons, dan event streaming mempertahankan bentuk yang sama. Yang berubah adalah apa pun yang Anda ukur atau anggarkan dalam token:
- Field
usagedan hasil penghitungan token lebih tinggi untuk teks yang sama. - Sejumlah token tertentu menampung lebih sedikit teks.
- Batas
max_tokensyang disesuaikan untuk Claude Haiku 4.5 mungkin memotong output yang setara. - Estimasi biaya yang dibuat dari jumlah token Claude Haiku 4.5 perlu dihitung ulang dengan jumlah token dan harga Claude Haiku 5.5, termasuk harga yang lebih tinggi untuk prompt panjang. Lihat Harga dan Harga konteks panjang.
Gambar besar juga dapat memakan lebih banyak token. Claude Haiku 5.5 menggunakan tingkat gambar resolusi tinggi, yang memperkecil gambar di atas 2.576 piksel pada sisi terpanjang atau 4.784 token visual. Claude Haiku 4.5 dan model Haiku sebelumnya menggunakan tingkat standar, yang memperkecil gambar di atas 1.568 piksel pada sisi terpanjang atau 1.568 token visual. Gambar berukuran 2.000 kali 1.500 piksel memakan sekitar 2,5 kali lebih banyak token visual pada Claude Haiku 5.5 dibandingkan pada Claude Haiku 4.5. Lihat Resolusi dan biaya token.
Hitung prompt Anda dengan model diatur ke claude-haiku-5-5 alih-alih menggunakan ulang hasil hitungan yang diukur pada Claude Haiku 4.5.
Konfigurasikan pemikiran
Claude Haiku 5.5 mengonfigurasi pemikiran secara berbeda dari Claude Haiku 4.5. Nilai thinking berupa {"type": "enabled", "budget_tokens": N} mengembalikan error 400, sehingga permintaan yang mengirimkannya memerlukan nilai thinking yang baru.
Sebelumnya, permintaan ke Claude Haiku 4.5 mengatur thinking ke enabled dengan anggaran token:
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}Sesudahnya, permintaan yang sama ke Claude Haiku 5.5 menggunakan pemikiran adaptif. Nilai thinking berubah, dan output_config.effort mengatur seberapa banyak model berpikir:
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}Pemikiran adaptif aktif secara default, sehingga respons dapat dimulai dengan satu atau lebih blok thinking bahkan ketika permintaan tidak mengatur thinking. Biarkan thinking tidak diatur atau atur ke {"type": "adaptive"}, dan gunakan effort sebagai kontrolnya: jika Claude Haiku 4.5 berjalan tanpa pemikiran, atau dengan anggaran kecil untuk menghemat token, pilih tingkat effort yang lebih rendah. Pada tingkat yang lebih rendah, model berpikir lebih sedikit, dan dapat melewati pemikiran sepenuhnya pada permintaan yang lebih sederhana. Untuk panduan prompting, lihat Gunakan effort untuk mengontrol pemikiran. Pilih blok konten berdasarkan field type-nya alih-alih berdasarkan posisi, dan kirim balik blok thinking tanpa modifikasi bersama hasil alat.
Token pemikiran dihitung terhadap max_tokens, sehingga permintaan dengan max_tokens kecil dapat berhenti dengan stop_reason: "max_tokens" setelah blok thinking dan sebelum ada teks apa pun. Jika Anda mengatur max_tokens kecil untuk Claude Haiku 4.5, naikkan untuk memberi ruang bagi pemikiran, atau pilih tingkat effort yang lebih rendah.
Blok pemikiran dari giliran asisten sebelumnya tetap berada dalam konteks dan dihitung sebagai token input, sedangkan Claude Haiku 4.5 hanya mempertahankan blok dari giliran terakhir. Karena itu, percakapan multi-giliran membawa lebih banyak token input daripada yang dapat dijelaskan oleh perubahan tokenizer saja. Untuk menghapus blok yang lebih lama, gunakan pembersihan blok pemikiran. Lihat Preservasi blok pemikiran berdasarkan model.
Secara default, Claude Haiku 5.5 mengembalikan setiap blok thinking dengan field thinking kosong dan hanya signature, sedangkan Claude Haiku 4.5 mengembalikan pemikiran yang diringkas. Untuk menerima pemikiran yang diringkas, atur thinking: {"type": "adaptive", "display": "summarized"}.
Claude Haiku 5.5 menerima tool_choice yang dipaksakan (any atau alat bernama), tetapi respons dimulai dengan panggilan alat dan tidak memiliki blok thinking. Untuk membiarkan model berpikir sebelum memanggil alat, gunakan tool_choice: {"type": "auto"} dan sebutkan dalam prompt kapan harus menggunakan alat tersebut.
Percakapan yang Anda alihkan dari Claude Haiku 4.5 ke Claude Haiku 5.5 tetap mempertahankan penalarannya. Untuk peralihan lainnya, hal ini bergantung pada kedua model tersebut:
| Peralihan | Mempertahankan penalarannya |
|---|---|
| Ke Claude Haiku 5.5, dari Claude Haiku 4.5 atau sebelumnya, Claude Sonnet 5 atau sebelumnya, atau Claude Opus 4.8 atau sebelumnya | Ya |
| Ke Claude Haiku 5.5, dari model lain mana pun | Tidak. API tidak menyertakan blok pemikiran model tersebut, tanpa error. |
| Dari Claude Haiku 5.5, ke Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2, atau Claude Mythos 5.2 | Ya, hanya di Claude API dan Claude Models on Google Cloud (Google managed) |
| Dari Claude Haiku 5.5, ke model lain mana pun | Tidak |
Lihat Beralih model dan kembali lagi. Untuk peralihan yang tidak melibatkan Claude Haiku 5.5, lihat Peralihan model mana yang mempertahankan penalaran di Claude API.
Hapus parameter sampling
Pada Claude Haiku 5.5, hilangkan temperature, top_p, dan top_k dan gunakan prompting untuk mengarahkan perilaku model sebagai gantinya.
Ganti prefill asisten
Prefill adalah giliran asisten terakhir dalam messages yang dilanjutkan oleh model. Claude Haiku 4.5 menerimanya ketika pemikiran dinonaktifkan. Claude Haiku 5.5 menolaknya dengan error 400, bahkan ketika pemikiran dinonaktifkan. Akhiri messages dengan giliran pengguna, dan ganti setiap prefill sesuai dengan tujuannya:
- Format output: gunakan output terstruktur, atau alat dengan field enum untuk klasifikasi.
- Pembukaan: minta jawaban langsung dalam prompt sistem.
- Kelanjutan: pindahkan ke pesan pengguna, misalnya “Your previous response was interrupted and ended with
[previous_response]. Continue from where you left off.” - Pengingat konteks: letakkan di giliran pengguna.
Pindahkan penggunaan komputer ke toolset
Claude Haiku 4.5 mendukung penggunaan komputer melalui alat computer_20250124, dengan header beta computer-use-2025-01-24. Claude Haiku 5.5 mendukung penggunaan komputer melalui toolset computer_toolset_20260801. Permintaan ke Claude Haiku 5.5 yang mendeklarasikan computer_20250124 akan mengembalikan error 400.
Untuk memindahkan integrasi ke toolset, jangan sertakan lagi header beta computer-use-2025-01-24 dan ganti entri tools dengan {"type": "computer_toolset_20260801"}. Kemudian lakukan perubahan permintaan dan agent loop lainnya di Migrasi dari computer_20251124. Lakukan dispatch berdasarkan name dan toolset_name dari setiap blok tool_use anggota, bukan berdasarkan input.action. Tangani setiap blok tersebut dalam satu giliran dan sertakan kembali toolset_name pada hasil. Zoom aktif secara default di toolset; jika lingkungan Anda tidak mengimplementasikannya, tambahkan "configs": {"zoom": {"enabled": false}}. Jika Anda mengirimkan header beta fine-grained-tool-streaming-2025-05-14, hapus header tersebut. Bila digunakan bersama entri toolset, header itu akan mengembalikan error 400.
Di Amazon Bedrock, Claude Haiku 5.5 juga menerima alat computer_20251124 dengan header beta computer-use-2025-11-24.
Claude Haiku 5.5 mendukung alat penggunaan browser (browser_toolset_20260801) untuk tugas-tugas di dalam halaman web. Claude Haiku 4.5 tidak mendukungnya.
Putar ulang blok pemikiran melalui akun yang menghasilkannya
Blok pemikiran dari Claude Haiku 5.5 hanya berfungsi di akun yang menghasilkannya atau di akun yang terhubung dengannya. Ketika akun lain mengirimkan salah satu blok ini, API tidak menyertakan blok tersebut sebelum model menerimanya, dan permintaan tetap berhasil tanpa penalaran tersebut. Hal ini memengaruhi kode yang menyimpan percakapan dan memutarnya ulang melalui akun yang berbeda, misalnya layanan yang melayani beberapa pelanggan dari satu penyimpanan percakapan. Putar ulang setiap percakapan melalui akun yang menghasilkannya. Lihat Akun dan platform cloud.
Pertahankan giliran sebelumnya tidak berubah
Pertahankan percakapan agar bersifat append-only (hanya ditambahkan). Blok pemikiran Claude Haiku 5.5 hanya tetap valid selama semua yang dikirim sebelumnya tidak berubah: prompt system, tools, dan setiap pesan sebelumnya.
Gagal dalam pemeriksaan prefiks mungkin menghasilkan atau mungkin tidak menghasilkan error 400. Untuk mengidentifikasi dan menangani kedua kasus tersebut, lihat Pemeriksaan prefiks pada blok pemikiran.
Untuk perubahan yang memicu error dan apa yang harus dilakukan sebagai gantinya, lihat Jika kode Anda mengubah prompt sistem, alat, atau riwayat.
Migrasi ke Claude Haiku 5.5 dari Claude Haiku 3.5 dan model Haiku sebelumnya
Claude Haiku 3.5 telah dipensiunkan di Claude API, Amazon Bedrock, dan Claude Models on Google Cloud (Google managed). Claude Haiku 3 telah dipensiunkan di Claude API dan Claude Models on Google Cloud (Google managed). Lihat Penghentian model.
Dari model mana pun di antara keduanya, terapkan terlebih dahulu setiap bagian sebelumnya, lalu perubahan berikut:
- ID model: Ganti
claude-3-5-haiku-20241022, aliasnyaclaude-3-5-haiku-latest, atauclaude-3-haiku-20240307denganclaude-haiku-5-5. Di Claude Models on Google Cloud (Google managed), ganticlaude-3-5-haiku@20241022denganclaude-haiku-5-5. Di Amazon Bedrock, gunakan ID Claude Haiku 5.5 dari Gunakan ID model Claude Haiku 5.5. - Eksekusi kode: Claude Haiku 5.5 menerima
code_execution_20250825dan versi yang lebih baru. Jika Anda menggunakancode_execution_20250522yang hanya mendukung Python, pindah ke salah satunya. Lihat Upgrade ke versi alat terbaru. - Editor teks: Jika Anda menggunakan alat editor teks, pindah ke
text_editor_20250728(nama alatstr_replace_based_edit_tool), yang tidak memiliki perintahundo_edit. Lihat Alat editor teks. - Alasan berhenti: Tangani
refusaldanmodel_context_window_exceeded. Lihat Alasan berhenti dan fallback. - Baris baru di akhir: Claude 4.5 dan model yang lebih baru mempertahankan baris baru di akhir (trailing newline) dalam parameter string panggilan alat. Jika kode Anda mencocokkan string tersebut secara persis, perhitungkan keberadaannya.
- Prompt: Claude 4 dan model yang lebih baru memiliki gaya komunikasi yang lebih ringkas dan langsung serta memerlukan arahan yang eksplisit. Tinjau prompt Anda berdasarkan Menulis prompt untuk Claude Haiku 5.5 dan Praktik terbaik prompting.
Apakah halaman ini membantu?