Migrasi ke Claude 4
Panduan untuk bermigrasi dari model Claude 3.7 ke model Claude 4.
Halaman ini memberikan panduan untuk bermigrasi dari model Claude 3.7 ke model Claude 4 (Opus 4 dan Sonnet 4).
Dalam kebanyakan kasus, Anda dapat beralih ke model Claude 4 dengan perubahan minimal:
-
Perbarui nama model Anda:
- Dari:
claude-3-7-sonnet-20250219
- Ke:
claude-sonnet-4-20250514
atauclaude-opus-4-20250514
- Dari:
-
Panggilan API yang ada harus tetap berfungsi tanpa modifikasi, meskipun perilaku API telah berubah sedikit pada model Claude 4 (lihat catatan rilis API untuk detail).
Yang baru di Claude 4
Alasan penghentian penolakan baru
Model Claude 4 memperkenalkan alasan penghentian refusal
baru untuk konten yang ditolak model untuk dihasilkan karena alasan keamanan, karena peningkatan kecerdasan model Claude 4:
Saat bermigrasi ke Claude 4, Anda harus memperbarui aplikasi Anda untuk menangani alasan penghentian refusal
.
Pemikiran yang dirangkum
Dengan pemikiran diperpanjang diaktifkan, Messages API untuk model Claude 4 mengembalikan ringkasan dari proses pemikiran lengkap Claude. Pemikiran yang dirangkum memberikan manfaat kecerdasan penuh dari pemikiran diperpanjang, sambil mencegah penyalahgunaan.
Meskipun API konsisten di seluruh model Claude 3.7 dan 4, respons streaming untuk pemikiran diperpanjang mungkin dikembalikan dalam pola pengiriman “chunky”, dengan kemungkinan penundaan antara peristiwa streaming.
Perangkuman diproses oleh model yang berbeda dari yang Anda targetkan dalam permintaan Anda. Model pemikiran tidak melihat output yang dirangkum.
Untuk informasi lebih lanjut, lihat dokumentasi Pemikiran diperpanjang.
Pemikiran yang diselingi
Model Claude 4 mendukung penyisipan penggunaan alat dengan pemikiran diperpanjang, memungkinkan percakapan yang lebih alami di mana penggunaan alat dan respons dapat dicampur dengan pesan biasa.
Pemikiran yang diselingi sedang dalam beta. Untuk mengaktifkan pemikiran yang diselingi, tambahkan header beta interleaved-thinking-2025-05-14
ke permintaan API Anda.
Untuk informasi lebih lanjut, lihat dokumentasi Pemikiran diperpanjang.
Alat editor teks yang diperbarui
Alat editor teks telah diperbarui untuk model Claude 4 dengan perubahan berikut:
- Jenis alat:
text_editor_20250728
- Nama alat:
str_replace_based_edit_tool
- Perintah
undo_edit
tidak lagi didukung dalam model Claude 4.
Alat editor teks str_replace_editor
tetap sama untuk Claude Sonnet 3.7.
Jika Anda bermigrasi dari Claude Sonnet 3.7 dan menggunakan alat editor teks:
Untuk informasi lebih lanjut, lihat dokumentasi alat editor teks.
Penggunaan alat yang efisien token tidak lagi didukung
Penggunaan alat yang efisien token hanya tersedia di Claude Sonnet 3.7.
Jika Anda bermigrasi dari Claude Sonnet 3.7 dan menggunakan penggunaan alat yang efisien token, kami merekomendasikan menghapus header beta token-efficient-tools-2025-02-19
dari permintaan Anda.
Header beta token-efficient-tools-2025-02-19
masih dapat disertakan dalam permintaan Claude 4, tetapi tidak akan berpengaruh.
Output diperpanjang tidak lagi didukung
Header beta output-128k-2025-02-19
untuk output diperpanjang hanya tersedia di Claude Sonnet 3.7.
Jika Anda bermigrasi dari Claude Sonnet 3.7, kami merekomendasikan menghapus output-128k-2025-02-19
dari permintaan Anda.
Header beta output-128k-2025-02-19
masih dapat disertakan dalam permintaan Claude 4, tetapi tidak akan berpengaruh.
Pertimbangan kinerja
Claude Sonnet 4
- Kemampuan penalaran dan kecerdasan yang ditingkatkan dibandingkan dengan Claude Sonnet 3.7
- Akurasi penggunaan alat yang ditingkatkan
Claude Opus 4
- Model paling mampu dengan penalaran dan kecerdasan yang superior
- Lebih lambat dari model Sonnet
- Terbaik untuk tugas kompleks yang memerlukan analisis mendalam
Daftar periksa migrasi
- Perbarui id model dalam panggilan API Anda
- Uji permintaan yang ada (harus berfungsi tanpa perubahan)
- Hapus header beta
token-efficient-tools-2025-02-19
jika berlaku - Hapus header beta
output-128k-2025-02-19
jika berlaku - Tangani alasan penghentian
refusal
baru - Perbarui jenis dan nama alat editor teks jika menggunakannya
- Hapus kode apa pun yang menggunakan perintah
undo_edit
- Jelajahi kemampuan penyisipan alat baru dengan pemikiran diperpanjang
- Tinjau praktik terbaik rekayasa prompt Claude 4 untuk hasil optimal
- Uji dalam pengembangan sebelum penerapan produksi
Butuh bantuan?
- Periksa dokumentasi API kami untuk spesifikasi terperinci.
- Tinjau kemampuan model untuk perbandingan kinerja.
- Tinjau catatan rilis API untuk pembaruan API.
- Hubungi dukungan jika Anda mengalami masalah selama migrasi.