Migrasi ke Claude 4.5

Panduan ini mencakup dua jalur migrasi utama ke model Claude 4.5:

• Claude Sonnet 3.7 → Claude Sonnet 4.5: Model paling cerdas kami dengan kemampuan penalaran, pengkodean, dan agen jangka panjang terbaik di kelasnya
• Claude Haiku 3.5 → Claude Haiku 4.5: Model Haiku tercepat dan paling cerdas kami dengan performa mendekati frontier untuk aplikasi real-time dan pemrosesan cerdas volume tinggi

Kedua migrasi melibatkan perubahan yang merusak yang memerlukan pembaruan pada implementasi Anda. Panduan ini akan memandu Anda melalui setiap jalur migrasi dengan instruksi langkah demi langkah dan perubahan yang merusak yang jelas ditandai.

Sebelum memulai migrasi Anda, kami merekomendasikan untuk meninjau Apa yang baru di Claude 4.5 untuk memahami fitur dan kemampuan baru yang tersedia di model ini, termasuk extended thinking, kesadaran konteks, dan peningkatan perilaku.

Migrasi dari Claude Sonnet 3.7 ke Claude Sonnet 4.5

Claude Sonnet 4.5 adalah model paling cerdas kami, menawarkan performa terbaik di kelasnya untuk penalaran, pengkodean, dan agen otonomi jangka panjang. Migrasi ini mencakup beberapa perubahan yang merusak yang memerlukan pembaruan pada implementasi Anda.

Langkah-langkah migrasi

1. Perbarui nama model Anda:

   # Sebelumnya (Claude Sonnet 3.7)
   model="claude-3-7-sonnet-20250219"
   
   # Sesudahnya (Claude Sonnet 4.5)
   model="claude-sonnet-4-5-20250929"

2. Perbarui parameter sampling

   Ini adalah perubahan yang merusak dari Claude Sonnet 3.7.

   Gunakan hanya temperature ATAU top_p, bukan keduanya:

   # Sebelumnya (Claude Sonnet 3.7) - Ini akan error di Sonnet 4.5
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # Tidak dapat menggunakan keduanya
       ...
   )
   
   # Sesudahnya (Claude Sonnet 4.5)
   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       temperature=0.7,  # Gunakan temperature ATAU top_p, bukan keduanya
       ...
   )

3. Tangani alasan penghentian refusal yang baru

   Perbarui aplikasi Anda untuk menangani alasan penghentian refusal:

   response = client.messages.create(...)
   
   if response.stop_reason == "refusal":
       # Tangani penolakan dengan tepat
       pass

4. Perbarui alat editor teks (jika berlaku)

   Ini adalah perubahan yang merusak dari Claude Sonnet 3.7.

   Perbarui ke text_editor_20250728 (type) dan str_replace_based_edit_tool (name). Hapus kode apa pun yang menggunakan perintah undo_edit.

   # Sebelumnya (Claude Sonnet 3.7)
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # Sesudahnya (Claude Sonnet 4.5)
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

5. Perbarui alat eksekusi kode (jika berlaku)

   Tingkatkan ke code_execution_20250825. Versi legacy code_execution_20250522 masih berfungsi tetapi tidak direkomendasikan. Lihat dokumentasi alat eksekusi kode untuk instruksi migrasi.

6. Hapus header beta penggunaan alat yang efisien token

   Penggunaan alat yang efisien token adalah fitur beta yang hanya berfungsi dengan Claude 3.7 Sonnet. Semua model Claude 4 memiliki penggunaan alat yang efisien token bawaan, jadi Anda tidak lagi harus menyertakan header beta.

   Hapus header beta token-efficient-tools-2025-02-19 dari permintaan Anda:

   # Sebelumnya (Claude Sonnet 3.7)
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["token-efficient-tools-2025-02-19"],  # Hapus ini
       ...
   )
   
   # Sesudahnya (Claude Sonnet 4.5)
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # Tidak ada header beta token-efficient-tools
       ...
   )

7. Hapus header beta output yang diperluas

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

   Hapus header ini dari permintaan Anda:

   # Sebelumnya (Claude Sonnet 3.7)
   client.messages.create(
       model="claude-3-7-sonnet-20250219",
       betas=["output-128k-2025-02-19"],  # Hapus ini
       ...
   )
   
   # Sesudahnya (Claude Sonnet 4.5)
   client.messages.create(
       model="claude-sonnet-4-5-20250929",
       # Tidak ada header beta output-128k
       ...
   )

8. Perbarui prompt Anda untuk perubahan perilaku

   Claude Sonnet 4.5 memiliki gaya komunikasi yang lebih ringkas dan langsung serta memerlukan arahan eksplisit. Tinjau praktik terbaik prompt engineering Claude 4 untuk panduan optimasi.

9. Pertimbangkan mengaktifkan extended thinking untuk tugas kompleks

   Aktifkan extended thinking untuk peningkatan performa yang signifikan pada tugas pengkodean dan penalaran (dinonaktifkan secara default):

   response = client.messages.create(
       model="claude-sonnet-4-5-20250929",
       max_tokens=16000,
       thinking={"type": "enabled", "budget_tokens": 10000},
       messages=[...]
   )
   Extended thinking berdampak pada efisiensi .

10. Uji implementasi Anda

Uji di lingkungan pengembangan sebelum menerapkan ke produksi untuk memastikan semua perubahan yang merusak ditangani dengan benar.

Daftar periksa migrasi Sonnet 3.7 → 4.5

• Perbarui ID model ke claude-sonnet-4-5-20250929
• MERUSAK: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya
• Tangani alasan penghentian refusal yang baru di aplikasi Anda
• MERUSAK: Perbarui alat editor teks ke text_editor_20250728 dan str_replace_based_edit_tool (jika berlaku)
• MERUSAK: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
• Perbarui alat eksekusi kode ke code_execution_20250825 (jika berlaku)
• Hapus header beta (jika berlaku)

Fitur yang dihapus dari Claude Sonnet 3.7

• Penggunaan alat yang efisien token: Header beta token-efficient-tools-2025-02-19 hanya berfungsi dengan Claude 3.7 Sonnet dan tidak didukung di model Claude 4 (lihat langkah 6)
• Output yang diperluas: Header beta output-128k-2025-02-19 tidak didukung (lihat langkah 7)

Kedua header dapat disertakan dalam permintaan Claude 4 tetapi tidak akan berpengaruh.

Migrasi dari Claude Haiku 3.5 ke Claude Haiku 4.5

Claude Haiku 4.5 adalah model Haiku tercepat dan paling cerdas kami dengan performa mendekati frontier, memberikan kualitas model premium dengan performa real-time untuk aplikasi interaktif dan pemrosesan cerdas volume tinggi. Migrasi ini mencakup beberapa perubahan yang merusak yang memerlukan pembaruan pada implementasi Anda.

Untuk gambaran lengkap tentang kemampuan baru, lihat Apa yang baru di Claude 4.5.

Langkah-langkah migrasi

1. Perbarui nama model Anda:

   # Sebelumnya (Haiku 3.5)
   model="claude-3-5-haiku-20241022"
   
   # Sesudahnya (Haiku 4.5)
   model="claude-haiku-4-5-20251001"

2. Perbarui versi alat (jika berlaku)

   Ini adalah perubahan yang merusak dari Claude Haiku 3.5.

   Haiku 4.5 hanya mendukung versi alat terbaru:

   # Sebelumnya (Haiku 3.5)
   tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # Sesudahnya (Haiku 4.5)
   tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

Daftar periksa migrasi Haiku 3.5 → 4.5

• Perbarui ID model ke claude-haiku-4-5-20251001
• MERUSAK: Perbarui versi alat ke versi terbaru (misalnya, text_editor_20250728, code_execution_20250825) - versi legacy tidak didukung
• MERUSAK: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
• MERUSAK: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya
• Tinjau dan sesuaikan untuk batas laju baru (terpisah dari Haiku 3.5)
• Tangani alasan penghentian refusal yang baru di aplikasi Anda
• Pertimbangkan mengaktifkan extended thinking untuk tugas penalaran kompleks (kemampuan baru)

Memilih antara Sonnet 4.5 dan Haiku 4.5

Baik Claude Sonnet 4.5 maupun Claude Haiku 4.5 adalah model Claude 4 yang kuat dengan kekuatan yang berbeda:

Pilih Claude Sonnet 4.5 (paling cerdas) untuk:

• Penalaran dan analisis kompleks: Kecerdasan terbaik di kelasnya untuk tugas-tugas canggih
• Agen otonomi jangka panjang: Performa superior untuk agen yang bekerja secara independen untuk periode yang diperpanjang
• Tugas pengkodean lanjutan: Model pengkodean terkuat kami dengan perencanaan lanjutan dan rekayasa keamanan
• Alur kerja konteks besar: Manajemen konteks yang ditingkatkan dengan alat memory dan kemampuan pengeditan konteks
• Tugas yang memerlukan kemampuan maksimal: Ketika kecerdasan dan akurasi adalah prioritas utama

Pilih Claude Haiku 4.5 (tercepat dan paling cerdas Haiku) untuk:

• Aplikasi real-time: Waktu respons cepat untuk pengalaman pengguna interaktif dengan performa mendekati frontier
• Pemrosesan cerdas volume tinggi: Kecerdasan hemat biaya dalam skala besar dengan kecepatan yang ditingkatkan
• Penerapan sensitif biaya: Performa mendekati frontier dengan harga yang lebih rendah
• Arsitektur sub-agen: Agen cepat dan cerdas untuk sistem multi-agen
• Penggunaan komputer dalam skala besar: Otomasi desktop dan browser otonomi yang hemat biaya
• Tugas yang memerlukan kecepatan: Ketika latensi rendah sangat penting sambil mempertahankan kecerdasan mendekati frontier

Rekomendasi extended thinking

Model Claude 4, khususnya Sonnet dan Haiku 4.5, menunjukkan peningkatan performa yang signifikan ketika menggunakan extended thinking untuk tugas pengkodean dan penalaran kompleks. Extended thinking dinonaktifkan secara default tetapi kami merekomendasikan mengaktifkannya untuk pekerjaan yang menuntut.

Penting: Extended thinking berdampak pada efisiensi prompt caching. Ketika konten non-tool-result ditambahkan ke percakapan, blok thinking dihapus dari cache, yang dapat meningkatkan biaya dalam percakapan multi-turn. Kami merekomendasikan mengaktifkan thinking ketika manfaat performa melebihi trade-off caching.

Skenario migrasi lainnya

Jalur migrasi utama yang tercakup di atas (Sonnet 3.7 → 4.5 dan Haiku 3.5 → 4.5) mewakili upgrade paling umum. Namun, Anda mungkin bermigrasi dari model Claude lain ke Claude 4.5. Bagian ini mencakup skenario tersebut.

Migrasi dari Claude Sonnet 4 → Sonnet 4.5

Perubahan yang merusak: Tidak dapat menentukan temperature dan top_p dalam permintaan yang sama.

Semua panggilan API lainnya akan berfungsi tanpa modifikasi. Perbarui ID model Anda dan sesuaikan parameter sampling jika diperlukan:

# Sebelumnya (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# Sesudahnya (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

Migrasi dari Claude Opus 4.1 → Sonnet 4.5

Tidak ada perubahan yang merusak. Semua panggilan API akan berfungsi tanpa modifikasi.

Cukup perbarui ID model Anda:

# Sebelumnya (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Sesudahnya (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

Claude Sonnet 4.5 adalah model paling cerdas kami dengan kemampuan penalaran, pengkodean, dan agen jangka panjang terbaik di kelasnya. Ini menawarkan performa superior dibandingkan Opus 4.1 untuk sebagian besar kasus penggunaan.

Migrasi dari Claude Opus 4.1 → Opus 4.5

Tidak ada perubahan yang merusak. Semua panggilan API akan berfungsi tanpa modifikasi.

Cukup perbarui ID model Anda:

# Sebelumnya (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Sesudahnya (Claude Opus 4.5)
model="claude-opus-4-5-20251101"

Claude Opus 4.5 adalah model paling cerdas kami, menggabungkan kemampuan maksimal dengan performa praktis. Ini menampilkan peningkatan perubahan langkah dalam visi, pengkodean, dan penggunaan komputer dengan harga yang lebih terjangkau daripada Opus 4.1. Ideal untuk tugas-tugas khusus yang kompleks dan rekayasa perangkat lunak profesional.

Migrasi antara model Claude 4.5

Tidak ada perubahan yang merusak. Semua panggilan API akan berfungsi tanpa modifikasi.

Cukup perbarui ID model Anda.

Butuh bantuan?

• Periksa dokumentasi API kami untuk spesifikasi terperinci
• Tinjau kemampuan model untuk perbandingan performa
• Tinjau catatan rilis API untuk pembaruan API
• Hubungi dukungan jika Anda mengalami masalah apa pun selama migrasi