Panduan migrasi

Bermigrasi ke Claude Opus 4.7

Claude Opus 4.7 adalah model yang tersedia secara umum paling mampu hingga saat ini. Model ini sangat otonom dan berkinerja luar biasa pada pekerjaan agentic jangka panjang, pekerjaan pengetahuan, tugas visi, dan tugas memori. Claude Opus 4.7 harus memiliki kinerja out-of-the-box yang kuat pada prompt dan eval Claude Opus 4.6 yang ada dengan harga $5 / $25 per MTok yang sama, tetapi ada beberapa perubahan perilaku dan API yang perlu diketahui saat Anda bermigrasi. Model ini mendukung set fitur yang sama dengan Claude Opus 4.6, termasuk jendela konteks 1M token dengan harga API standar tanpa premium konteks panjang, 128k token output maksimal, adaptive thinking, prompt caching, batch processing, Files API, dukungan PDF, visi, dan set lengkap alat sisi server dan sisi klien (bash, eksekusi kode, penggunaan komputer, editor teks, pencarian web, pengambilan web, konektor MCP, memori).

/claude-api migrate this project to claude-opus-4-7

Perbarui nama model Anda

# Migrasi Opus
model = "claude-opus-4-6"  # Sebelum
model = "claude-opus-4-7"  # Sesudah

Perubahan yang merusak

1. Extended thinking dihapus: thinking: {type: "enabled", budget_tokens: N} tidak lagi didukung pada Claude Opus 4.7 atau model yang lebih baru dan mengembalikan kesalahan 400. Beralih ke adaptive thinking (thinking: {type: "adaptive"}) dan gunakan parameter effort untuk mengontrol kedalaman pemikiran. Adaptive thinking dimatikan secara default pada Claude Opus 4.7: permintaan tanpa bidang thinking berjalan tanpa pemikiran, cocok dengan perilaku Opus 4.6. Atur thinking: {type: "adaptive"} secara eksplisit untuk mengaktifkannya.

   Sebelum (Claude Opus 4.6):

   client.messages.create(
       model="claude-opus-4-6",
       max_tokens=64000,
       thinking={"type": "enabled", "budget_tokens": 32000},
       messages=[{"role": "user", "content": "..."}],
   )

Memilih tingkat upaya

Parameter effort memungkinkan Anda untuk menyesuaikan kecerdasan Claude vs. pengeluaran token, menukar kemampuan untuk kecepatan lebih cepat dan biaya lebih rendah. Mulai dengan tingkat upaya xhigh baru untuk kasus penggunaan coding dan agentic, dan gunakan minimum upaya high untuk sebagian besar kasus penggunaan yang sensitif terhadap kecerdasan. Bereksperimen dengan tingkat upaya lain untuk lebih menyesuaikan penggunaan token dan kecerdasan:

• max: Upaya maksimal dapat memberikan peningkatan kinerja dalam beberapa kasus penggunaan, tetapi mungkin menunjukkan hasil yang berkurang dari peningkatan penggunaan token. Pengaturan ini juga kadang-kadang dapat rentan terhadap overthinking. Kami merekomendasikan pengujian upaya maksimal untuk tugas yang menuntut kecerdasan.
• xhigh (baru): Upaya ekstra tinggi adalah pengaturan terbaik untuk sebagian besar kasus penggunaan coding dan agentic.
• high: Pengaturan ini menyeimbangkan penggunaan token dan kecerdasan. Untuk sebagian besar kasus penggunaan yang sensitif terhadap kecerdasan, kami merekomendasikan minimum upaya high.
• medium: Baik untuk kasus penggunaan yang sensitif terhadap biaya yang perlu mengurangi penggunaan token sambil menukar kecerdasan.
• low: Cadangkan untuk tugas pendek dan terbatas serta beban kerja yang sensitif terhadap latensi yang tidak sensitif terhadap kecerdasan.

Kami mengharapkan upaya menjadi lebih penting untuk model ini daripada untuk Opus sebelumnya, dan merekomendasikan bereksperimen dengannya secara aktif saat Anda meningkatkan.

Perubahan perilaku

Claude Opus 4.7 memiliki beberapa perbedaan perilaku dari Claude Opus 4.6 yang bukan perubahan API yang merusak tetapi mungkin memerlukan pembaruan prompt atau penghapusan scaffolding.

1. Panjang respons bervariasi menurut kasus penggunaan: Claude Opus 4.7 mengkalibrasi panjang respons ke seberapa kompleks yang dianggapnya tugas tersebut, daripada default ke verbositas tetap. Ini biasanya berarti jawaban lebih pendek pada pencarian sederhana dan jawaban jauh lebih panjang pada analisis terbuka. Jika produk Anda bergantung pada gaya atau verbositas output tertentu, Anda mungkin perlu menyesuaikan prompt Anda. Sebagai contoh, untuk mengurangi verbositas, Anda mungkin menambahkan: "Berikan respons yang ringkas dan terfokus. Lewati konteks yang tidak penting, dan jaga contoh tetap minimal." Jika Anda melihat contoh spesifik tentang jenis verbositas (yaitu penjelasan berlebihan), Anda dapat menambahkan instruksi tambahan dalam prompt Anda untuk mencegahnya. Contoh positif yang menunjukkan bagaimana Claude dapat berkomunikasi dengan tingkat keringkasan yang sesuai cenderung lebih efektif daripada contoh negatif atau instruksi yang memberi tahu model apa yang tidak boleh dilakukan.

2. Penurutan instruksi yang lebih literal: Claude Opus 4.7 menafsirkan prompt lebih literal dan eksplisit daripada Claude Opus 4.6, terutama pada tingkat upaya yang lebih rendah. Model ini tidak akan diam-diam menggeneralisasi instruksi dari satu item ke item lain, dan tidak akan menyimpulkan permintaan yang tidak Anda buat. Sisi positif dari literalisme ini adalah presisi dan lebih sedikit thrash. Model ini umumnya berkinerja lebih baik untuk kasus penggunaan API dengan prompt yang dikalibrasi dengan hati-hati, ekstraksi terstruktur, dan pipeline di mana Anda menginginkan perilaku yang dapat diprediksi. Tinjauan prompt dan harness mungkin sangat membantu untuk migrasi ke Claude Opus 4.7.

3. Nada yang lebih langsung: Seperti halnya model baru apa pun, gaya prosa pada penulisan bentuk panjang mungkin bergeser. Claude Opus 4.7 lebih langsung dan berpendapat, dengan frasa yang lebih sedikit yang berpusat pada validasi dan emoji lebih sedikit daripada gaya yang lebih hangat dari Claude Opus 4.6. Jika produk Anda mengandalkan suara tertentu, evaluasi kembali prompt gaya terhadap baseline baru.

Perubahan yang direkomendasikan

Ini bukan persyaratan tetapi akan meningkatkan pengalaman Anda:

1. Evaluasi kembali max_tokens: Karena teks yang sama menghasilkan jumlah token yang lebih tinggi pada Claude Opus 4.7, kami menyarankan memperbarui parameter max_tokens Anda untuk memberikan ruang tambahan, termasuk pemicu pemadatan. Intervensi prompting, task_budget, dan effort dapat membantu mengontrol biaya dan memastikan penggunaan token yang sesuai.

2. Audit ekspektasi penghitungan token: Jalur kode apa pun yang memperkirakan token sisi klien atau mengasumsikan rasio token-ke-karakter tetap harus diuji ulang terhadap Claude Opus 4.7. Gunakan endpoint Token counting untuk memverifikasi.

3. Adopsi task budgets (beta): Claude Opus 4.7 memperkenalkan task budgets. Anggaran ini memungkinkan Anda untuk menginformasikan Claude berapa banyak token yang dimilikinya untuk loop agentic penuh, termasuk pemikiran, panggilan alat, hasil alat, dan output akhir. Model melihat hitungan mundur yang berjalan dan menggunakannya untuk memprioritaskan pekerjaan dan menyelesaikan tugas dengan anggun saat anggaran dikonsumsi. Untuk menggunakan, atur header beta task-budgets-2026-03-13 dan tambahkan yang berikut ke konfigurasi output Anda:

Daftar periksa migrasi

• Perbarui nama model dari claude-opus-4-6 ke claude-opus-4-7 (atau perbarui alias).
• Hapus temperature, top_p, dan top_k dari muatan permintaan.
• Ganti thinking: {type: "enabled", budget_tokens: N} dengan thinking: {type: "adaptive"} ditambah parameter effort.
• Hapus prefill pesan asisten apa pun.
• Jika UI Anda menampilkan konten pemikiran, secara eksplisit pilih untuk merangkum pemikiran.
• Benchmark ulang biaya dan latensi end-to-end di bawah tokenisasi yang diperbarui.
• Sesuaikan ulang untuk memperhitungkan tokenisasi yang diperbarui.

Bermigrasi ke Claude Opus 4.7 dari Opus 4.5 atau lebih awal

Jika Anda bermigrasi dari Claude Opus 4.5, Opus 4.1, atau model yang lebih awal langsung ke Claude Opus 4.7, terapkan semua perubahan Opus 4.7 di atas ditambah perubahan kumulatif di bagian ini yang berlaku antara Opus 4.5 dan Opus 4.7. Jika Anda bermigrasi dari Opus 4.6, Anda hanya memerlukan bagian Opus 4.7 di atas.

Perbarui nama model Anda

# Migrasi Opus
model = "claude-opus-4-5"  # Sebelum
model = "claude-opus-4-7"  # Sesudah

Perubahan yang merusak

1. Penghapusan prefill tercakup dalam perubahan yang merusak Opus 4.7 di atas.

2. Penawaran parameter alat: Model Claude Opus 4.6 dan yang lebih baru mungkin menghasilkan penghindaran string JSON yang sedikit berbeda dalam argumen panggilan alat (misalnya, penanganan penghindaran Unicode atau penghindaran garis miring yang berbeda). Jika Anda mengurai input panggilan alat sebagai string mentah daripada menggunakan parser JSON, verifikasi logika parsing Anda. Parser JSON standar (seperti json.loads() atau JSON.parse()) menangani perbedaan ini secara otomatis.

Perubahan yang direkomendasikan

Perubahan ini meningkatkan pengalaman Anda pada Opus 4.7. Item yang ditandai (diperlukan pada Opus 4.7) adalah rekomendasi opsional saat Opus 4.6 diluncurkan tetapi sekarang wajib; sisanya tetap direkomendasikan.

1. Migrasi ke adaptive thinking (diperlukan pada Opus 4.7): thinking: {type: "enabled", budget_tokens: N} mengembalikan kesalahan 400 pada Claude Opus 4.7. Beralih ke thinking: {type: "adaptive"} dan gunakan parameter effort untuk mengontrol kedalaman pemikiran. Lihat Adaptive thinking.

Bermigrasi dari Claude 4.1 atau lebih awal

Jika Anda bermigrasi dari Opus 4.1, Sonnet 4 (sudah usang), atau model yang lebih awal langsung ke Claude Opus 4.7, terapkan perubahan Claude Opus 4.7 di bagian atas panduan ini dan perubahan kumulatif di atas ditambah perubahan tambahan di bagian ini.

# Dari Opus 4.1
model = "claude-opus-4-1-20250805"  # Sebelum
model = "claude-opus-4-7"  # Sesudah

# Dari Sonnet 4
model = "claude-sonnet-4-20250514"  # Sebelum
model = "claude-opus-4-7"  # Sesudah

# Dari Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Sebelum
model = "claude-opus-4-7"  # Sesudah

Perubahan yang merusak tambahan

1. Hapus parameter sampling

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Mulai dengan Claude Opus 4.7, mengatur temperature, top_p, atau top_k ke nilai non-default apa pun akan mengembalikan kesalahan 400. Jalur migrasi paling aman adalah menghilangkan parameter ini sepenuhnya dari permintaan, dan menggunakan prompting untuk memandu perilaku model. Jika Anda menggunakan temperature = 0 untuk determinisme, perhatikan bahwa itu tidak pernah menjamin output yang identik.

   Python

   # Sebelum - Ini akan error di model Claude 4+
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # Parameter sampling non-default mengembalikan 400 pada Opus 4.7
       # ...
   )
   
   # Sesudah
   response = client.messages.create(
       model="claude-opus-4-7",
       # ...
   )

Perubahan yang direkomendasikan tambahan

• Hapus header beta legacy: Hapus token-efficient-tools-2025-02-19 dan output-128k-2025-02-19. Semua model Claude 4+ memiliki penggunaan alat yang efisien token bawaan dan header ini tidak berpengaruh.

Daftar periksa migrasi (dari Opus 4.5 atau lebih awal)

• Perbarui ID model ke claude-opus-4-7
• Terapkan semua perubahan yang merusak Opus 4.7 (extended thinking dihapus, parameter sampling dihapus, tampilan pemikiran dihilangkan secara default, tokenisasi yang diperbarui)
• BREAKING: Hapus prefill pesan asisten (mengembalikan kesalahan 400); gunakan structured outputs atau output_config.format sebagai gantinya
• BREAKING pada Opus 4.7: Ganti thinking: {type: "enabled", budget_tokens: N} dengan thinking: {type: "adaptive"} ditambah parameter effort (mengembalikan 400 pada Opus 4.7)
• Verifikasi parsing JSON panggilan alat menggunakan parser JSON standar
• Hapus header beta effort-2025-11-24 (effort sekarang GA)
• Hapus header beta

Bermigrasi ke Claude Sonnet 4.6

Claude Sonnet 4.6 menggabungkan kecerdasan yang kuat dengan kinerja cepat, menampilkan kemampuan pencarian agentic yang ditingkatkan dan eksekusi kode gratis saat digunakan dengan pencarian web atau pengambilan web. Model ini ideal untuk tugas coding, analisis, dan konten sehari-hari.

Untuk gambaran lengkap tentang kemampuan, lihat gambaran umum model.

Perbarui nama model Anda:

# Dari Sonnet 4.5
model = "claude-sonnet-4-5"  # Sebelum
model = "claude-sonnet-4-6"  # Sesudah

# Dari Sonnet 4
model = "claude-sonnet-4-20250514"  # Sebelum
model = "claude-sonnet-4-6"  # Sesudah

Perubahan yang merusak

Saat bermigrasi dari Sonnet 4.5

1. Prefilling pesan asisten tidak lagi didukung

   Ini adalah perubahan yang merusak saat bermigrasi dari Sonnet 4.5 atau lebih awal.

   Prefilling pesan asisten mengembalikan kesalahan 400 pada Sonnet 4.6. Gunakan structured outputs, instruksi system prompt, atau output_config.format sebagai gantinya.

   Kasus penggunaan prefill umum dan migrasi:

   • Mengontrol format output (memaksa output JSON/YAML): Gunakan structured outputs atau tools dengan enum fields untuk tugas klasifikasi.

   • Menghilangkan preamble (menghapus frasa "Here is..."): Tambahkan instruksi langsung dalam system prompt: "Respond directly without preamble. Do not start with phrases like 'Here is...', 'Based on...', etc."

   • Menghindari penolakan yang buruk: Claude sekarang jauh lebih baik dalam penolakan yang tepat. Prompting yang jelas dalam pesan pengguna tanpa prefill harus cukup.

Saat bermigrasi dari Claude 3.x

1. Perbarui parameter sampling

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Gunakan hanya temperature ATAU top_p, bukan keduanya.

2. Perbarui versi tool

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Perbarui ke versi tool terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.

3. Tangani alasan stop refusal

   Perbarui aplikasi Anda untuk menangani alasan stop refusal.

Perubahan yang direkomendasikan

1. Hapus header beta fine-grained-tool-streaming-2025-05-14: Fine-grained tool streaming sekarang GA pada Sonnet 4.6 dan tidak lagi memerlukan header beta.
2. Migrasikan output_format ke output_config.format: Parameter output_format sudah usang. Gunakan output_config.format sebagai gantinya.

Bermigrasi dari Sonnet 4.5

Pertimbangkan untuk bermigrasi dari Sonnet 4.5 ke Sonnet 4.6, yang memberikan lebih banyak kecerdasan dengan harga yang sama.

Jika Anda tidak menggunakan extended thinking

Jika Anda tidak menggunakan extended thinking pada Sonnet 4.5, Anda dapat melanjutkan tanpanya pada Sonnet 4.6. Anda harus secara eksplisit mengatur effort ke level yang sesuai untuk kasus penggunaan Anda. Pada effort low dengan thinking dinonaktifkan, Anda dapat mengharapkan performa yang sama atau lebih baik relatif terhadap Sonnet 4.5 tanpa extended thinking.

Jika Anda menggunakan extended thinking

Jika Anda menggunakan extended thinking dengan budget_tokens pada Sonnet 4.5, masih berfungsi pada Sonnet 4.6 tetapi sudah usang. Migrasikan ke adaptive thinking dengan parameter effort.

Bermigrasi ke adaptive thinking

Adaptive thinking adalah pengganti yang direkomendasikan untuk budget_tokens pada Sonnet 4.6. Ini sangat cocok untuk pola beban kerja berikut:

• Autonomous multi-step agents: agen coding yang mengubah persyaratan menjadi software yang berfungsi, pipeline analisis data, dan bug finding di mana model berjalan secara independen di banyak langkah. Adaptive thinking memungkinkan model untuk mengkalibrasi penalarannya per langkah, tetap di jalur selama lintasan yang lebih panjang. Untuk beban kerja ini, mulai dengan effort high. Jika latency atau penggunaan token menjadi perhatian, turunkan ke medium.
• Computer use agents: Sonnet 4.6 mencapai akurasi terbaik di kelasnya pada evaluasi computer use menggunakan adaptive mode.
• Bimodal workloads: campuran tugas mudah dan sulit di mana adaptive melewati thinking pada query sederhana dan bernalar mendalam pada yang kompleks.

Saat menggunakan adaptive thinking, evaluasi effort medium dan high pada tugas Anda. Level yang tepat tergantung pada trade-off beban kerja Anda antara kualitas, latency, dan penggunaan token.

Menjaga budget_tokens selama migrasi

Jika Anda perlu menjaga budget_tokens sementara saat bermigrasi, budget sekitar 16k token memberikan ruang untuk masalah yang lebih sulit tanpa risiko penggunaan token yang liar. Konfigurasi ini sudah usang dan akan dihapus dalam rilis model di masa depan.

Kasus penggunaan coding dan agentic

Untuk coding agentic, desain frontend, workflow tool-heavy, dan workflow enterprise yang kompleks, mulai dengan effort medium. Jika Anda menemukan latency terlalu tinggi, pertimbangkan mengurangi effort ke low. Jika Anda memerlukan kecerdasan yang lebih tinggi, pertimbangkan meningkatkan effort ke high atau bermigrasi ke Opus 4.7.

Kasus penggunaan chat dan non-coding

Untuk chat, pembuatan konten, pencarian, klasifikasi, dan tugas non-coding lainnya, mulai dengan effort low dengan extended thinking. Jika Anda memerlukan kedalaman lebih, tingkatkan effort ke medium.

Daftar periksa migrasi Sonnet 4.6

• Perbarui ID model ke claude-sonnet-4-6
• BREAKING: Hapus prefilling pesan asisten; gunakan structured outputs atau output_config.format sebagai gantinya
• BREAKING: Verifikasi parsing JSON parameter tool menangani perbedaan escaping
• BREAKING: Perbarui versi tool ke versi terbaru (text_editor_20250728, code_execution_20250825); versi legacy tidak didukung (jika bermigrasi dari 3.x)
• 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 (jika bermigrasi dari 3.x)

Bermigrasi ke Claude Sonnet 4.5

Claude Sonnet 4.5 menggabungkan kecerdasan yang kuat dengan performa cepat, menjadikannya ideal untuk tugas coding, analisis, dan konten sehari-hari.

Untuk gambaran lengkap kemampuan, lihat models overview.

Perbarui nama model Anda:

# Dari Sonnet 4
model = "claude-sonnet-4-20250514"  # Sebelum
model = "claude-sonnet-4-5-20250929"  # Sesudah

# Dari Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Sebelum
model = "claude-sonnet-4-5-20250929"  # Sesudah

Perubahan yang merusak

Perubahan yang merusak ini berlaku saat bermigrasi dari model Claude 3.x Sonnet.

1. Perbarui parameter sampling

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Gunakan hanya temperature ATAU top_p, bukan keduanya.

2. Perbarui versi tool

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Perbarui ke versi tool terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.

3. Tangani alasan stop refusal

   Perbarui aplikasi Anda untuk menangani alasan stop refusal.

Daftar periksa migrasi Sonnet 4.5

• Perbarui ID model ke claude-sonnet-4-5-20250929
• BREAKING: Perbarui versi tool ke versi terbaru (text_editor_20250728, code_execution_20250825); versi legacy tidak didukung (jika bermigrasi dari 3.x)
• 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 (jika bermigrasi dari 3.x)
• Tangani alasan stop refusal baru dalam aplikasi Anda
• Tinjau dan perbarui prompt mengikuti prompting best practices

Bermigrasi ke Claude Haiku 4.5

Claude Haiku 4.5 adalah model Haiku tercepat dan paling cerdas dengan performa mendekati frontier, memberikan kualitas model premium untuk aplikasi interaktif dan pemrosesan volume tinggi.

Untuk gambaran lengkap kemampuan, lihat models overview.

Perbarui nama model Anda:

# Dari Haiku 3.5
model = "claude-3-5-haiku-20241022"  # Sebelum
model = "claude-haiku-4-5-20251001"  # Sesudah

# Dari Haiku 3
model = "claude-3-haiku-20240307"  # Sebelum
model = "claude-haiku-4-5-20251001"  # Sesudah

Tinjau batas laju baru: Haiku 4.5 memiliki batas laju terpisah dari Haiku 3.5 dan Haiku 3. Lihat dokumentasi Rate limits untuk detail.

Jelajahi kemampuan baru: Lihat models overview untuk detail tentang context awareness, peningkatan kapasitas output (64k token), kecerdasan lebih tinggi, dan kecepatan yang ditingkatkan.

Perubahan yang merusak

Perubahan yang merusak ini berlaku saat bermigrasi dari model Claude 3.x Haiku.

1. Perbarui parameter sampling

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Gunakan hanya temperature ATAU top_p, bukan keduanya.

2. Perbarui versi tool

   Ini adalah perubahan yang merusak saat bermigrasi dari model Claude 3.x.

   Perbarui ke versi tool terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.

3. Tangani alasan stop refusal

   Perbarui aplikasi Anda untuk menangani alasan stop refusal.

Daftar periksa migrasi Haiku 4.5

• Perbarui ID model ke claude-haiku-4-5-20251001
• BREAKING: Perbarui versi tool ke versi terbaru (text_editor_20250728, code_execution_20250825); versi legacy 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
• Tangani alasan stop refusal baru dalam aplikasi Anda
• Tinjau dan sesuaikan untuk batas laju baru (terpisah dari Haiku 3.5)
• Tinjau dan perbarui prompt mengikuti

Dapatkan bantuan

• Periksa dokumentasi API untuk spesifikasi detail
• Tinjau model capabilities untuk perbandingan performa
• Tinjau API release notes untuk pembaruan API
• Hubungi dukungan jika Anda mengalami masalah apa pun selama migrasi