Panduan ini mencakup dua jalur migrasi utama ke model Claude 4.5:
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.
Claude Sonnet 4.5 adalah model paling cerdas kami, menawarkan performa terbaik di kelasnya untuk penalaran, coding, dan agen otonomi yang berjalan lama. Migrasi ini mencakup beberapa perubahan yang merusak yang memerlukan pembaruan pada implementasi Anda.
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"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
...
)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
passPerbarui 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"}]Lihat dokumentasi alat editor teks untuk detail.
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.
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 beta header 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
...
)Hapus header beta output yang diperpanjang
Header beta output-128k-2025-02-19 beta header untuk output yang diperpanjang 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
...
)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.
Pertimbangkan untuk mengaktifkan extended thinking untuk tugas kompleks
Aktifkan extended thinking untuk peningkatan performa yang signifikan pada tugas coding 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 mempengaruhi efisiensi prompt caching.
Uji implementasi Anda
Uji di lingkungan pengembangan sebelum menerapkan ke produksi untuk memastikan semua perubahan yang merusak ditangani dengan benar.
claude-sonnet-4-5-20250929temperature ATAU top_p, bukan keduanyarefusal yang baru di aplikasi Andatext_editor_20250728 dan str_replace_based_edit_tool (jika berlaku)undo_edit (jika berlaku)code_execution_20250825 (jika berlaku)token-efficient-tools-2025-02-19 (jika berlaku)output-128k-2025-02-19 (jika berlaku)model_context_window_exceeded (spesifik Sonnet 4.5)token-efficient-tools-2025-02-19 hanya berfungsi dengan Claude 3.7 Sonnet dan tidak didukung di model Claude 4 (lihat langkah 6)output-128k-2025-02-19 tidak didukung (lihat langkah 7)Kedua header dapat disertakan dalam permintaan Claude 4 tetapi tidak akan memiliki efek.
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.
Harga Haiku 4.5 $1 per juta token input, $5 per juta token output. Lihat harga Claude untuk detail.
Perbarui nama model Anda:
# Sebelumnya (Haiku 3.5)
model="claude-3-5-haiku-20241022"
# Sesudahnya (Haiku 4.5)
model="claude-haiku-4-5-20251001"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"}]text_editor_20250728 dan str_replace_based_edit_toolcode_execution_20250825undo_editPerbarui parameter sampling
Ini adalah perubahan yang merusak dari Claude Haiku 3.5.
Gunakan hanya temperature ATAU top_p, bukan keduanya:
# Sebelumnya (Haiku 3.5) - Ini akan error di Haiku 4.5
response = client.messages.create(
model="claude-3-5-haiku-20241022",
temperature=0.7,
top_p=0.9, # Tidak dapat menggunakan keduanya
...
)
# Sesudahnya (Haiku 4.5)
response = client.messages.create(
model="claude-haiku-4-5-20251001",
temperature=0.7, # Gunakan temperature ATAU top_p, bukan keduanya
...
)Tinjau batas laju baru
Haiku 4.5 memiliki batas laju terpisah dari Haiku 3.5. Lihat dokumentasi batas laju untuk detail.
Tangani alasan penghentian refusal yang baru
Perbarui aplikasi Anda untuk menangani alasan penghentian refusal.
Pertimbangkan untuk mengaktifkan extended thinking untuk tugas kompleks
Aktifkan extended thinking untuk peningkatan performa yang signifikan pada tugas coding dan penalaran (dinonaktifkan secara default):
response = client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 5000},
messages=[...]
)Extended thinking mempengaruhi efisiensi .
Jelajahi kemampuan baru
Lihat Apa yang baru di Claude 4.5 untuk detail tentang kesadaran konteks, kapasitas output yang meningkat (64K token), kecerdasan yang lebih tinggi, dan kecepatan yang ditingkatkan.
Uji implementasi Anda
Uji di lingkungan pengembangan sebelum menerapkan ke produksi untuk memastikan semua perubahan yang merusak ditangani dengan benar.
claude-haiku-4-5-20251001text_editor_20250728, code_execution_20250825) - versi legacy tidak didukungundo_edit (jika berlaku)temperature ATAU top_p, bukan keduanyarefusal yang baru di aplikasi AndaBaik Claude Sonnet 4.5 maupun Claude Haiku 4.5 adalah model Claude 4 yang kuat dengan kekuatan yang berbeda:
Model Claude 4, khususnya Sonnet dan Haiku 4.5, menunjukkan peningkatan performa yang signifikan ketika menggunakan extended thinking untuk tugas coding dan penalaran kompleks. Extended thinking dinonaktifkan secara default tetapi kami merekomendasikan untuk mengaktifkannya untuk pekerjaan yang menuntut.
Penting: Extended thinking mempengaruhi 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 untuk mengaktifkan thinking ketika manfaat performa melebihi trade-off caching.
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.
Perubahan yang merusak: Tidak dapat menentukan baik temperature maupun 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"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 penalaran terbaik di kelasnya, coding, dan kemampuan agen yang berjalan lama. Ini menawarkan performa superior dibandingkan dengan Opus 4.1 untuk sebagian besar kasus penggunaan.
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, coding, dan penggunaan komputer dengan harga yang lebih terjangkau daripada Opus 4.1. Ideal untuk tugas-tugas khusus yang kompleks dan rekayasa perangkat lunak profesional.
Untuk basis kode dengan banyak referensi model, plugin Claude Code tersedia untuk mengotomatisasi migrasi ke Opus 4.5.
Tidak ada perubahan yang merusak. Semua panggilan API akan berfungsi tanpa modifikasi.
Cukup perbarui ID model Anda.