Migrasi ke Claude 4

Halaman ini memberikan panduan tentang migrasi 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:

1. Perbarui nama model Anda:

   • Dari: claude-3-7-sonnet-20250219
   • Ke: claude-sonnet-4-20250514 atau claude-opus-4-20250514

2. Panggilan API yang ada seharusnya terus berfungsi tanpa modifikasi, meskipun perilaku API telah sedikit berubah dalam model Claude 4 (lihat catatan rilis API untuk detailnya).

​

Apa yang baru di Claude 4

​

Alasan penghentian penolakan baru

Model Claude 4 memperkenalkan alasan penghentian refusal baru untuk konten yang model tolak untuk dihasilkan karena alasan keamanan, karena peningkatan kecerdasan model Claude 4:

{"id":"msg_014XEDjypDjFzgKVWdFUXxZP",
"type":"message",
"role":"assistant",
"model":"claude-sonnet-4-20250514",
"content":[{"type":"text","text":"I would be happy to assist you. You can "}],
"stop_reason":"refusal",
"stop_sequence":null,
"usage":{"input_tokens":564,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":22}
}

Saat bermigrasi ke Claude 4, Anda harus memperbarui aplikasi Anda untuk menangani alasan penghentian refusal.

​

Pemikiran yang dirangkum

Dengan pemikiran yang diperluas diaktifkan, API Pesan untuk model Claude 4 mengembalikan ringkasan dari proses pemikiran lengkap Claude. Pemikiran yang dirangkum memberikan manfaat kecerdasan penuh dari pemikiran yang diperluas, sambil mencegah penyalahgunaan.

Meskipun API konsisten di seluruh model Claude 3.7 dan 4, respons streaming untuk pemikiran yang diperluas mungkin kembali dalam pola pengiriman “chunky”, dengan kemungkinan penundaan antara peristiwa streaming.

Untuk informasi lebih lanjut, lihat dokumentasi Pemikiran yang Diperluas.

​

Pemikiran yang diselang-seling

Model Claude 4 mendukung penyelang-selingan penggunaan alat dengan pemikiran yang diperluas, memungkinkan percakapan yang lebih alami di mana penggunaan alat dan respons dapat dicampur dengan pesan biasa.

Untuk informasi lebih lanjut, lihat dokumentasi Pemikiran yang Diperluas.

​

Alat editor teks yang diperbarui

Alat editor teks telah diperbarui untuk model Claude 4 dengan perubahan berikut:

• Tipe alat: text_editor_20250429
• Nama alat: str_replace_based_edit_tool
• Perintah undo_edit tidak lagi didukung dalam model Claude 4.

Jika Anda bermigrasi dari Claude Sonnet 3.7 dan menggunakan alat editor teks:

# Claude Sonnet 3.7
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4
tools=[
    {
        "type": "text_editor_20250429",
        "name": "str_replace_based_edit_tool"
    }
]

Untuk informasi lebih lanjut, lihat dokumentasi alat editor teks.

​

Penggunaan alat hemat token tidak lagi didukung

Penggunaan alat hemat token hanya tersedia di Claude Sonnet 3.7.

Jika Anda bermigrasi dari Claude Sonnet 3.7 dan menggunakan penggunaan alat hemat token, kami menyarankan untuk 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 yang diperluas tidak lagi didukung

Header beta output-128k-2025-02-19 untuk output yang diperluas hanya tersedia di Claude Sonnet 3.7.

Jika Anda bermigrasi dari Claude Sonnet 3.7, kami menyarankan untuk 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 unggul
• Lebih lambat daripada model Sonnet
• Terbaik untuk tugas kompleks yang memerlukan analisis mendalam

​

Daftar periksa migrasi

• Perbarui id model dalam panggilan API Anda
• Uji permintaan yang ada (seharusnya 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 tipe dan nama alat editor teks jika menggunakannya
• Hapus kode apa pun yang menggunakan perintah undo_edit
• Jelajahi kemampuan penyelang-selingan alat baru dengan pemikiran yang diperluas
• 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.