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, coding, dan agen jangka panjang terbaik di kelasnya
  • Claude Haiku 3.5 → Claude Haiku 4.5: Model Haiku tercepat dan paling cerdas kami dengan performa hampir terdepan 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 petunjuk langkah demi langkah dan perubahan yang merusak yang ditandai dengan jelas. Sebelum memulai migrasi Anda, kami merekomendasikan untuk meninjau Apa yang baru di Claude 4.5 untuk memahami fitur dan kemampuan baru yang tersedia dalam model-model ini, termasuk extended thinking, context awareness, dan perbaikan 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, coding, dan agen otonom jangka panjang. Migrasi ini mencakup beberapa perubahan yang merusak yang memerlukan pembaruan pada implementasi Anda.

​
Langkah-langkah migrasi

  1. Perbarui nama model Anda: 
    # Sebelum (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# Sesudah (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: 
    # Sebelum (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 bisa menggunakan keduanya
    ...
)

# Sesudah (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 stop refusal yang baru Perbarui aplikasi Anda untuk menangani alasan stop refusal: 
    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Tangani penolakan dengan tepat
    pass
  4. Perbarui tool text editor (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. 
    # Sebelum (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Sesudah (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    Lihat dokumentasi tool Text editor untuk detail.
  5. Perbarui tool code execution (jika berlaku) Upgrade ke code_execution_20250825. Versi lama code_execution_20250522 masih berfungsi tetapi tidak direkomendasikan. Lihat dokumentasi tool Code execution untuk petunjuk migrasi.
  6. Hapus header beta token-efficient tool use Token-efficient tool use adalah fitur beta di Claude 3.7. Semua model Claude 4 memiliki token-efficient tool use bawaan, jadi Anda tidak perlu lagi menyertakan header beta. Hapus header beta token-efficient-tools-2025-02-19 dari permintaan Anda: 
    # Sebelum (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["token-efficient-tools-2025-02-19"],  # Hapus ini
    ...
)

# Sesudah (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Tidak ada header beta token-efficient-tools
    ...
)
  7. Hapus header beta extended output Header beta output-128k-2025-02-19 untuk extended output hanya tersedia di Claude Sonnet 3.7. Hapus header ini dari permintaan Anda: 
    # Sebelum (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["output-128k-2025-02-19"],  # Hapus ini
    ...
)

# Sesudah (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 yang eksplisit. Tinjau praktik terbaik prompt engineering Claude 4 untuk panduan optimisasi.
  9. Pertimbangkan 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.
  10. Uji implementasi Anda
Uji di lingkungan pengembangan sebelum deploy ke produksi untuk memastikan semua perubahan yang merusak ditangani dengan benar.

​
Checklist migrasi Sonnet 3.7 → 4.5

  • Perbarui ID model ke claude-sonnet-4-5-20250929
  • BREAKING: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya
  • Tangani alasan stop refusal yang baru dalam aplikasi Anda
  • BREAKING: Perbarui tool text editor ke text_editor_20250728 dan str_replace_based_edit_tool (jika berlaku)
  • BREAKING: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
  • Perbarui tool code execution ke code_execution_20250825 (jika berlaku)
  • Hapus header beta token-efficient-tools-2025-02-19 (jika berlaku)
  • Hapus header beta output-128k-2025-02-19 (jika berlaku)
  • Tinjau dan perbarui prompt mengikuti praktik terbaik Claude 4
  • Pertimbangkan mengaktifkan extended thinking untuk tugas penalaran kompleks
  • Tangani alasan stop model_context_window_exceeded (khusus Sonnet 4.5)
  • Pertimbangkan mengaktifkan tool memory untuk agen jangka panjang (beta)
  • Pertimbangkan menggunakan automatic tool call clearing untuk context editing (beta)
  • Uji di lingkungan pengembangan sebelum deployment produksi

​
Fitur yang dihapus dari Claude Sonnet 3.7

  • Token-efficient tool use: Header beta token-efficient-tools-2025-02-19 tidak didukung (lihat langkah 6)
  • Extended output: Header beta output-128k-2025-02-19 tidak didukung (lihat langkah 7)
Kedua header dapat disertakan dalam permintaan 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 hampir terdepan, 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 kemampuan baru, lihat Apa yang baru di Claude 4.5.
Harga Haiku 4.5 1perjutatokeninput,1 per juta token input, 5 per juta token output. Lihat harga Claude untuk detail.

​
Langkah-langkah migrasi

  1. Perbarui nama model Anda: 
    # Sebelum (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# Sesudah (Haiku 4.5)
model="claude-haiku-4-5-20251001"
  2. Perbarui versi tool (jika berlaku)
    Ini adalah perubahan yang merusak dari Claude Haiku 3.5.
    Haiku 4.5 hanya mendukung versi tool terbaru: 
    # Sebelum (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Sesudah (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • Text editor: Gunakan text_editor_20250728 dan str_replace_based_edit_tool
    • Code execution: Gunakan code_execution_20250825
    • Hapus kode apa pun yang menggunakan perintah undo_edit
  3. Perbarui parameter sampling
    Ini adalah perubahan yang merusak dari Claude Haiku 3.5.
    Gunakan hanya temperature ATAU top_p, bukan keduanya: 
    # Sebelum (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 bisa menggunakan keduanya
    ...
)

# Sesudah (Haiku 4.5)
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # Gunakan temperature ATAU top_p, bukan keduanya
    ...
)
  4. Tinjau rate limit baru Haiku 4.5 memiliki rate limit terpisah dari Haiku 3.5. Lihat dokumentasi Rate limits untuk detail.
  5. Tangani alasan stop refusal yang baru Perbarui aplikasi Anda untuk menangani alasan stop refusal.
  6. Pertimbangkan 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 prompt caching.
  7. Jelajahi kemampuan baru Lihat Apa yang baru di Claude 4.5 untuk detail tentang context awareness, peningkatan kapasitas output (64K token), kecerdasan yang lebih tinggi, dan peningkatan kecepatan.
  8. Uji implementasi Anda Uji di lingkungan pengembangan sebelum deploy ke produksi untuk memastikan semua perubahan yang merusak ditangani dengan benar.

​
Checklist migrasi Haiku 3.5 → 4.5

  • Perbarui ID model ke claude-haiku-4-5-20251001
  • BREAKING: Perbarui versi tool ke yang terbaru (mis., text_editor_20250728, code_execution_20250825) - versi lama tidak didukung
  • BREAKING: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
  • BREAKING: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya
  • Tinjau dan sesuaikan untuk rate limit baru (terpisah dari Haiku 3.5)
  • Tangani alasan stop refusal yang baru dalam aplikasi Anda
  • Pertimbangkan mengaktifkan extended thinking untuk tugas penalaran kompleks (kemampuan baru)
  • Manfaatkan context awareness untuk manajemen token yang lebih baik dalam sesi panjang
  • Bersiap untuk respons yang lebih besar (output maksimum meningkat dari 8K ke 64K token)
  • Tinjau dan perbarui prompt mengikuti praktik terbaik Claude 4
  • Uji di lingkungan pengembangan sebelum deployment produksi

​
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 otonom jangka panjang: Performa superior untuk agen yang bekerja secara independen untuk periode yang diperpanjang
  • Tugas coding lanjutan: Model coding terkuat kami dengan perencanaan lanjutan dan security engineering
  • Workflow konteks besar: Manajemen konteks yang ditingkatkan dengan tool memory dan kemampuan context editing
  • Tugas yang memerlukan kemampuan maksimum: Ketika kecerdasan dan akurasi adalah prioritas utama

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

  • Aplikasi real-time: Waktu respons cepat untuk pengalaman pengguna interaktif dengan performa hampir terdepan
  • Pemrosesan cerdas volume tinggi: Kecerdasan yang cost-effective dalam skala dengan peningkatan kecepatan
  • Deployment yang sensitif terhadap biaya: Performa hampir terdepan pada titik harga yang lebih rendah
  • Arsitektur sub-agent: Agen cepat dan cerdas untuk sistem multi-agent
  • Computer use dalam skala: Otomasi desktop dan browser otonom yang cost-effective
  • Tugas yang memerlukan kecepatan: Ketika latensi rendah sangat penting sambil mempertahankan kecerdasan hampir terdepan

​
Rekomendasi extended thinking

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 mengaktifkannya untuk pekerjaan yang menuntut. Penting: Extended thinking mempengaruhi efisiensi prompt caching. Ketika konten non-tool-result ditambahkan ke percakapan, thinking block dihapus dari cache, yang dapat meningkatkan biaya dalam percakapan multi-turn. Kami merekomendasikan mengaktifkan thinking ketika manfaat performa lebih besar daripada trade-off caching.

​
Skenario migrasi lainnya

Jalur migrasi utama yang dibahas di atas (Sonnet 3.7 → 4.5 dan Haiku 3.5 → 4.5) mewakili upgrade yang 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: 
# Sebelum (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# Sesudah (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: 
# Sebelum (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Sesudah (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Claude Sonnet 4.5 adalah model paling cerdas kami dengan kemampuan penalaran, coding, dan agen jangka panjang terbaik di kelasnya. Ini menawarkan performa superior dibandingkan Opus 4.1 untuk sebagian besar kasus penggunaan.

​
Butuh bantuan?