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:

  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 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:

{"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 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:

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

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

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?