Claude Platform Docs
Model & hargaClaude Opus 5.5

Panduan migrasi Claude Opus 5.5

Beralih ke Claude Opus 5.5 dari model Opus sebelumnya atau Claude Sonnet 5 dengan panduan migrasi ini. Panduan untuk mengaktifkan Claude Opus 5.5 mencakup pengaturan permintaan yang mengembalikan error, blok thinking di setiap respons, dan daftar periksa untuk setiap model awal.

Halaman ini mencantumkan perubahan kode untuk beralih ke Claude Opus 5.5 dari Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 dan model Opus sebelumnya, atau Claude Sonnet 5. Setiap pembaca perlu membaca Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5 dan Menangani thinking di setiap respons. Kemudian buka bagian untuk model Anda saat ini: kalimat pertamanya menyebutkan bagian lain yang berlaku untuk Anda. Daftar periksa migrasi mencantumkan setiap perubahan berdasarkan model awal.

Claude Opus 5.5 lebih murah daripada Claude Opus 5 ($4 / $20 USD per juta token input / output, dibandingkan dengan $5 / $25; lihat harga Claude). Untuk dukungan fitur, lihat Yang baru di Claude Opus 5.5. Untuk perbedaan perilaku dan pola prompting khusus model, lihat Prompting Claude Opus 5.5.

Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5

Dari model mana pun Anda beralih, permintaan ke claude-opus-5-5 harus memenuhi hal-hal berikut. Jika suatu item menyatakan bahwa sebuah pengaturan ditolak, API mengembalikan error 400.

  • ID model: Gunakan claude-opus-5-5, ID model tetap tanpa akhiran tanggal. Di Amazon Bedrock, Claude Platform di AWS, Google Cloud, dan Microsoft Foundry, gunakan ID model platform tersebut; lihat Ketersediaan.
  • Thinking: Jangan kirim field thinking, atau kirim thinking: {"type": "adaptive"}, yang setara: "adaptive thinking" (pemikiran adaptif) selalu aktif. thinking: {"type": "disabled"} dan anggaran thinking manual (thinking: {"type": "enabled", "budget_tokens": N}) ditolak. Lihat sebelum dan sesudah untuk thinking.
  • Effort: Kendalikan kedalaman thinking dengan parameter effort, satu-satunya parameter permintaan yang mengendalikannya. Kelima level (low, medium, high, xhigh, max) didukung, dan defaultnya adalah medium. Lihat Tingkat effort yang direkomendasikan untuk Claude Opus 5.5.
  • Pilihan alat: Gunakan tool_choice {"type": "auto"} (default) atau {"type": "none"}. Memaksa pemanggilan alat dengan {"type": "any"} atau {"type": "tool", "name": "..."} ditolak. Lihat sebelum dan sesudah untuk pilihan alat.
  • Parameter sampling: Hilangkan temperature, top_p, dan top_k, atau biarkan pada nilai defaultnya: nilai lain apa pun ditolak. Gunakan prompting untuk memandu perilaku model.
  • Prefill: Jangan akhiri messages dengan giliran asisten yang di-prefill: hal itu ditolak. Gunakan "structured outputs" (output terstruktur) atau instruksi prompt sistem sebagai gantinya. Di Amazon Bedrock, output terstruktur tidak tersedia untuk Claude Opus 5.5, jadi gunakan instruksi prompt sistem di sana.
  • Computer use: Di Claude API dan Google Cloud, deklarasikan computer use sebagai toolset computer_toolset_20260801; alat computer_20251124 yang lebih lama ditolak di sana. Lihat perubahan yang merusak kompatibilitas pada computer use.
  • Jendela konteks: Tidak diperlukan header beta untuk "context window" (jendela konteks). Jendela konteks 1M token adalah default, dan header yang dikirim untuk model lama tidak berpengaruh.

Permintaan berikut memenuhi setiap item dalam daftar: effort diatur, dan tidak ada field thinking. Tab SDK yang mencetak teks memilihnya berdasarkan tipe blok, karena blok thinking muncul lebih dulu.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Menangani thinking di setiap respons

Thinking berjalan pada setiap permintaan Claude Opus 5.5, sehingga setiap respons dapat diawali dengan blok thinking, dan max_tokens mencakup thinking ditambah teks. Jika kode Anda sudah berjalan dengan thinking aktif, item 1 hingga 3 kemungkinan sudah terpenuhi: periksa item 4 dan 5. Jika kode Anda berjalan tanpa thinking, pada model sebelumnya mana pun, setiap item merupakan perubahan.

  1. max_tokens mencakup thinking ditambah teks: Pada Claude Opus 4.8 dan model Opus sebelumnya, permintaan tanpa field thinking berjalan tanpa thinking. Claude Opus 5 dan Claude Sonnet 5 menerima thinking: {"type": "disabled"}. Pada Claude Opus 5.5, setiap permintaan berjalan dengan pemikiran adaptif. max_tokens tetap menjadi batas keras untuk total output, yaitu thinking ditambah teks respons, jadi tinjau kembali nilainya untuk beban kerja yang sebelumnya berjalan tanpa thinking. Token thinking ditagih sebagai token output bahkan ketika teks thinking tidak dikembalikan kepada Anda, sehingga beban kerja seperti itu dapat menghasilkan lebih banyak token output per permintaan. Lihat Kontrol biaya. Untuk menghabiskan lebih sedikit token pada thinking, turunkan level effort. Jika Anda menjalankan effort xhigh atau max, atur max_tokens yang besar agar model memiliki ruang untuk berpikir dan bertindak; mulailah dari 64k token dan sesuaikan dari sana. Jika prompt Anda disetel untuk berjalan tanpa thinking, lihat Prompt yang ditulis untuk thinking yang dinonaktifkan.

  2. Respons diawali dengan blok thinking: Sebuah respons dapat diawali dengan satu atau lebih blok thinking sebelum blok text pertama. Kode yang membaca balasan berdasarkan posisi, seperti content[0].text atau handler stream yang memperlakukan event content_block_start pertama sebagai teks, akan rusak pada respons ini. Pilih blok konten berdasarkan field type-nya: baca text dari blok yang type-nya adalah "text", dan buat percabangan berdasarkan tipe blok saat menangani event stream.

  3. Kembalikan blok thinking tanpa modifikasi dalam loop penggunaan alat: Jika Anda menjalankan loop "tool use" (penggunaan alat), kirimkan kembali blok thinking dari setiap respons asisten ke API secara lengkap dan tanpa modifikasi saat Anda mengembalikan hasil alat, termasuk blok yang field thinking-nya kosong. Kembalikan pesan asisten persis seperti yang diterima, alih-alih memfilter blok kontennya berdasarkan tipe atau membangunnya ulang: API menolak blok thinking yang diedit, diurutkan ulang, atau sebagian dihapus dengan error 400. Lihat Mempertahankan blok thinking.

  4. Teks thinking dihilangkan secara default: thinking.display secara default bernilai "omitted", sehingga blok thinking tiba dengan field thinking yang kosong bersama signature-nya. Perlakukan field thinking hanya sebagai teks tampilan. Untuk menerima ringkasan yang dapat dibaca, atur thinking.display ke "summarized":

    thinking = {
    "type": "adaptive",
    "display": "summarized",
}

    Jika produk Anda melakukan streaming penalaran kepada pengguna, default ini tampak sebagai jeda panjang sebelum output dimulai; atur display: "summarized" untuk memulihkan progres yang terlihat selama thinking. Lihat Mengontrol tampilan thinking.

  5. Teks di antara pemanggilan alat tiba dalam blok thinking: Catatan singkat yang ditulis model di antara pemanggilan alat dikembalikan sebagai blok thinking, yang kosong pada tampilan default. Lihat Teks di antara panggilan alat dikembalikan dalam blok thinking.

Daftar periksa migrasi berdasarkan model awal

Telusuri grup-grup berikut dari atas ke bawah dan berhentilah setelah grup yang menyebutkan model Anda saat ini: setiap item hingga titik itu berlaku untuk Anda. Jika Anda menggunakan Claude Opus 5, grup pertama adalah seluruh daftarnya. Jika Anda menggunakan Claude Sonnet 5, terapkan grup pertama dan grup terakhir.

Setiap model awal

  • Perbarui ID model ke claude-opus-5-5.
  • Hapus thinking: {"type": "disabled"} dan thinking: {"type": "enabled", ...}; pilih level effort sebagai gantinya.
  • Atur effort secara eksplisit: defaultnya adalah medium, sedangkan default Claude Opus 5 adalah high.
  • Ganti tipe tool_choice any dan tool dengan auto ditambah penggunaan alat ketat atau output terstruktur, atau dengan auto saja di Amazon Bedrock.
  • Jika Anda menggunakan computer use di Claude API atau Google Cloud, deklarasikan computer_toolset_20260801 (tanpa header beta) alih-alih computer_20251124 dan perbarui loop agen Anda untuk toolset tersebut. Di Amazon Bedrock, tetap gunakan computer_20251124; periksa bagian Kompatibilitas pada alat computer use untuk platform lain.
  • Jika router atau fallback dapat memindahkan percakapan dari Claude Opus 5.5 ke model lain, perkirakan model tersebut akan berjalan tanpa blok thinking Claude Opus 5.5 (Claude Fable 5.1 dan Claude Mythos 5.1 di Claude API adalah pengecualian dan mempertahankannya). Claude Opus 5.5 sendiri membaca thinking dari Claude Opus 5, dari model Opus, Sonnet, dan Haiku sebelumnya, dan, di Claude API dan Google Cloud, dari Claude Sonnet 5.5 dan Claude Haiku 5.5, tetapi tidak dari model Claude Fable atau Claude Mythos.
  • Baca blok konten berdasarkan type, dan kirimkan kembali blok thinking tanpa modifikasi dalam loop penggunaan alat.
  • Jika antarmuka Anda menampilkan teks di antara pemanggilan alat, atur display: "updates" (beta) atau "summarized" dan tampilkan blok thinking yang tidak kosong.
  • Jika kode Anda mengedit giliran sebelumnya, prompt system, atau tools di tengah percakapan, ikuti Pemikiran yang dipertahankan.
  • Tangani stop_reason: "refusal" dan konfigurasikan fallback.
  • Tetapkan ulang baseline biaya dan latensi pada level effort yang Anda pilih.
  • Jika kode Anda menonaktifkan thinking, tinjau kembali max_tokens, yang mencakup thinking ditambah teks respons; pada effort xhigh atau max, mulailah dari 64k. Lihat Menangani thinking di setiap respons.

Claude Opus 4.8 atau sebelumnya

  • Tinjau beban kerja yang berjalan tanpa field thinking: pada Claude Opus 5.5 beban kerja tersebut berjalan dengan thinking, dan thinking tidak dapat dinonaktifkan. Tinjau kembali max_tokens, yang tetap menjadi batas keras untuk total output (thinking ditambah teks respons), dan turunkan effort jika Anda menginginkan lebih sedikit thinking. Token thinking ditagih sebagai token output, sehingga beban kerja ini dapat menghasilkan lebih banyak token output per permintaan.
  • Pastikan kode apa pun yang mengurai field thinking memperlakukannya hanya sebagai teks tampilan. Atur display: "summarized" untuk menerima ringkasan yang dapat dibaca.
  • Tinjau prompt yang mendekati batas minimum caching: prompt dengan 512 token atau lebih dapat membuat entri cache.
  • Jika organisasi Anda memiliki komitmen Priority Tier, rencanakan kapasitas secara terpisah: Priority Tier tidak didukung pada Claude Opus 5.5.
  • Jika Anda menjalankan effort xhigh atau max, naikkan max_tokens ke setidaknya 64k sebagai titik awal.
  • Untuk beban kerja agentik, pertimbangkan "task budgets" (anggaran tugas) (beta) dan perubahan alat di tengah percakapan (beta).

Claude Opus 4.7 atau sebelumnya

  • Jalankan sweep effort baru pada eval Anda sendiri alih-alih membawa pengaturan yang disetel untuk model sebelumnya.
  • Hapus header beta jendela konteks apa pun.
  • Jika Anda membangun ulang riwayat percakapan untuk memperbarui instruksi, pertimbangkan untuk beralih ke pesan sistem di tengah percakapan untuk mempertahankan hit cache prompt.
  • Pastikan penanganan stop reason Anda membaca stop_details pada penolakan.
  • Jika Anda menginginkan fast mode, yang ditolak oleh Claude Opus 4.7, atur speed: "fast" pada permintaan Claude API Anda. Claude Opus 5.5 tidak memerlukan header beta.

Claude Opus 4.6 atau sebelumnya

  • Hapus temperature, top_p, dan top_k dari payload permintaan.
  • Ganti thinking: {"type": "enabled", "budget_tokens": N} dengan thinking: {"type": "adaptive"} ditambah parameter effort, atau hapus field thinking sepenuhnya; pemikiran adaptif selalu aktif.
  • Jika UI Anda menampilkan konten thinking, aktifkan ringkasan thinking secara eksplisit.
  • Lakukan benchmark ulang biaya dan latensi end-to-end dengan tokenisasi yang diperbarui.
  • Setel ulang max_tokens untuk memperhitungkan tokenisasi yang diperbarui, termasuk pemicu compaction.
  • Uji ulang estimasi jumlah token di sisi klien.
  • Jika aplikasi Anda mengirim gambar, anggarkan ulang untuk dukungan gambar resolusi tinggi (hingga sekitar 3x lebih banyak token gambar per gambar resolusi penuh). Lakukan downsample sebelum mengirim jika Anda tidak memerlukan fidelitas tambahan.
  • Jika Anda menggunakan koordinat penunjuk atau bounding box dari model, hapus konversi faktor skala apa pun; koordinat bernilai 1:1 dengan piksel gambar sebenarnya pada Claude Opus 4.7 dan model yang lebih baru.
  • Tinjau perubahan perilaku yang dimulai pada Claude Opus 4.7.
  • Jika produk Anda melakukan pekerjaan keamanan yang sah, ajukan permohonan ke Cyber Verification Program untuk mendapatkan akses ke pembatasan yang lebih rendah pada konten siber.

Claude Opus 4.5 atau sebelumnya

  • Hapus prefill pesan asisten apa pun; Claude Opus 4.6 sudah menolaknya.
  • Pastikan penguraian JSON pemanggilan alat menggunakan parser JSON standar.
  • Pindah dari client.beta.messages.create() ke client.messages.create(): pemikiran adaptif dan effort tidak memerlukan namespace beta.
  • Hapus header beta effort-2025-11-24 (parameter effort tidak memerlukannya).
  • Hapus header beta fine-grained-tool-streaming-2025-05-14.
  • Hapus header beta interleaved-thinking-2025-05-14 (pemikiran adaptif mengaktifkan interleaved thinking secara otomatis).
  • Migrasikan output_format ke output_config.format (jika berlaku).

Claude 4.1 atau sebelumnya

  • Perbarui versi alat (text_editor_20250728, code_execution_20260521).
  • Tangani stop reason refusal.
  • Tangani stop reason model_context_window_exceeded.
  • Pastikan penanganan parameter string alat untuk baris baru di akhir.
  • Hapus header beta lama (token-efficient-tools-2025-02-19, output-128k-2025-02-19).
  • Tinjau dan perbarui prompt dengan mengikuti praktik terbaik prompting.

Hanya Claude Sonnet 5

  • Jika Anda membangun ulang riwayat percakapan untuk memperbarui instruksi, pertimbangkan untuk beralih ke pesan sistem di tengah percakapan untuk mempertahankan hit cache prompt.
  • Tinjau prompt yang mendekati batas minimum caching: prompt dengan 512 token atau lebih dapat membuat entri cache.

Migrasi ke Claude Opus 5.5 dari Claude Opus 5

Pertama, kerjakan Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5 dan Menangani thinking di setiap respons. Setiap model awal memerlukan perubahan di bagian ini. Perubahan tersebut adalah pengaturan permintaan yang ditolak oleh Claude Opus 5.5 dan perubahan respons yang menyertainya. Daftar periksa untuk bagian ini adalah grup pertama dari daftar periksa migrasi.

Perbarui nama model Anda

model = "claude-opus-5"  # Before
model = "claude-opus-5-5"  # After

claude-opus-5-5 adalah ID model tetap tanpa akhiran tanggal, dengan skema yang sama seperti claude-opus-5. Di Amazon Bedrock, Claude Platform di AWS, Google Cloud, dan Microsoft Foundry, gunakan ID model platform tersebut; lihat Ketersediaan.

Perubahan yang merusak kompatibilitas

Setiap perubahan dijelaskan di Yang baru di Claude Opus 5.5; bagian ini memberikan perubahan kode untuk masing-masing.

Thinking tidak dapat dinonaktifkan

thinking: {"type": "disabled"} dan thinking: {"type": "enabled", "budget_tokens": N} keduanya mengembalikan error 400 ("thinking.type.disabled" is not supported for this model. atau "thinking.type.enabled" is not supported for this model.). Hapus field thinking dan pilih level effort; jika sebelumnya Anda menonaktifkan thinking untuk menghemat token, gunakan level yang lebih rendah. Respons kemudian diawali dengan blok thinking, jadi pilih blok konten berdasarkan type dan kirimkan kembali blok thinking tanpa modifikasi bersama hasil alat. Lihat Thinking tidak dapat dinonaktifkan.

Sebelum. Claude Opus 5 menerima permintaan ini, dan Claude Opus 5.5 menolaknya dengan error 400:

client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    thinking={"type": "disabled"},
    messages=[{"role": "user", "content": "..."}],
)

Sesudah:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "low"},  # thinking is always on; effort is the control
    messages=[{"role": "user", "content": "..."}],
)

Penggunaan alat paksa tidak didukung

Tipe tool_choice any dan tool mengembalikan error 400 (tool_choice: type "tool" and "any" are not supported for this model.), termasuk pada endpoint penghitungan token. Gunakan auto dengan "strict tool use" (penggunaan alat ketat) atau output terstruktur, dan sebutkan dalam prompt kapan alat tersebut berlaku. Penggunaan alat ketat menerima subset dari JSON Schema, jadi periksa input_schema setiap alat sebelum Anda menambahkan strict: true. Setiap objek dalam skema harus mengatur additionalProperties: false; lihat Batasan JSON Schema. Di Amazon Bedrock, output terstruktur, yang mencakup penggunaan alat ketat, tidak tersedia untuk Claude Opus 5.5. Di sana, kirim auto tanpa strict, sebutkan dalam prompt kapan alat tersebut berlaku, dan validasi input alat di kode Anda. Lihat Penggunaan alat paksa tidak didukung.

Sebelum. Claude Opus 5 menerima permintaan ini, dan Claude Opus 5.5 menolaknya dengan error 400:

client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)

Sesudah:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    # strict tool use (penggunaan alat ketat): setiap panggilan sesuai dengan input_schema milik alat
    tools=[{**tool, "strict": True} for tool in tools],
    tool_choice={"type": "auto"},
    messages=[
        {
            "role": "user",
            "content": "What's the weather in Paris? Use the get_weather tool.",
        }
    ],
)

Blok thinking terikat pada model dan percakapan

Di Claude API, Claude Fable 5.1 dan Claude Mythos 5.1 membaca blok thinking Claude Opus 5.5; tidak ada model lain yang melakukannya. Router atau fallback yang memindahkan percakapan dari Claude Opus 5.5 ke model lain mana pun menjalankan giliran tersebut tanpa blok itu. Ke arah sebaliknya, Claude Opus 5.5 membaca blok thinking dari Claude Opus 5, dari model Opus, Sonnet, dan Haiku sebelumnya, dan, di Claude API dan Google Cloud, dari Claude Sonnet 5.5 dan Claude Haiku 5.5, tetapi tidak dari model Claude Fable atau Claude Mythos. Pertahankan percakapan agar hanya ditambahkan (append-only, tanpa pengeditan pada prompt system, tools, atau pesan sebelumnya di tengah percakapan) sehingga blok tetap valid; Claude Code, claude.ai, Claude Managed Agents, dan Claude Agent SDK sudah melakukannya. Penegakannya sama dengan Claude Fable 5.1 di setiap platform: untuk akun yang dibuat pada atau setelah 31 Agustus 2026, 00:00 UTC, memutar ulang blok thinking setelah pengeditan semacam itu mengembalikan error 400 secara default. Tidak ada perubahan kode untuk integrasi append-only. Lihat Blok thinking terikat pada model dan percakapan dan Pemikiran yang dipertahankan.

Alat computer use computer_20251124 tidak didukung di Claude API dan Google Cloud

Di Claude API dan Google Cloud, entri tools dengan tipe computer_20251124 mengembalikan error 400 ('claude-opus-5-5' does not support tool types: computer_20251124., diikuti oleh tipe alat yang diterima model). Deklarasikan toolset computer_toolset_20260801 sebagai gantinya: hapus header beta dan kirim entri tanpa name atau dimensi tampilan. Dalam loop agen Anda, tangani blok tool_use anggota (aksinya adalah name blok tersebut, bukan input.action), beberapa di antaranya per giliran, dan sertakan kembali toolset_name pada setiap hasil. Perubahan permintaan ditunjukkan di bawah; perubahan loop agen tercantum di Migrasi dari computer_20251124. Di Amazon Bedrock, alat computer_20251124 yang lebih lama tetap berfungsi pada Claude Opus 5.5 seperti pada Claude Opus 5, sehingga tidak diperlukan perubahan di sana; untuk platform lain, lihat bagian Kompatibilitas pada alat computer use. Lihat Alat computer use computer_20251124 tidak didukung di Claude API dan Google Cloud.

Sebelum. Claude Opus 5 menerima permintaan ini, dan di Claude API dan Google Cloud, Claude Opus 5.5 menolaknya dengan error 400:

client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    tools=[
        {
            "type": "computer_20251124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
        }
    ],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Sesudah:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    # tanpa header beta; entri toolset tidak menerima nama atau ukuran tampilan
    tools=[{"type": "computer_toolset_20260801"}],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Teks di antara panggilan alat dikembalikan dalam blok thinking

Di Claude Opus 5, teks yang ditulis model di antara panggilan alat dikembalikan sebagai blok text. Di Claude Opus 5.5, seperti di Claude Fable 5.1, narasi tersebut dikembalikan sebagai blok thinking pembaruan progres, paling banyak satu sebelum setiap panggilan alat. Dengan thinking.display default "omitted", field thinking pada blok tersebut kosong. Tidak ada permintaan yang gagal, tetapi aplikasi yang melakukan streaming teks tersebut kepada penggunanya sebagai pembaruan progres akan menjadi senyap di antara panggilan alat. Untuk memulihkan pembaruan tersebut, bacalah dari blok thinking dan tetapkan nilai display yang mengembalikan teksnya: "updates" (beta, header thinking-display-updates-2026-08-18) mengembalikan pembaruan progres sementara penalaran tetap tersembunyi, dan "summarized" mengembalikan keduanya secara bercampur. Kemudian render setiap blok thinking yang tidak kosong sebelum blok tool_use yang didahuluinya, dan kirimkan kembali blok-blok tersebut tanpa perubahan bersama sisa giliran asisten. Lihat Pembaruan progres untuk pengguna.

Pengklasifikasi keamanan dan fallback

Claude Opus 5.5 dapat mengembalikan stop_reason: "refusal" dengan kategori stop_details. Pengklasifikasi keamanannya mencakup kumpulan kategori yang lebih luas daripada milik Claude Opus 5, jadi perkirakan nilai stop_details.category seperti "bio" selain "cyber" dan "reasoning_extraction"; lihat tabel kategori penolakan. Tangani penolakan dan konfigurasikan fallback sisi server atau percobaan ulang Anda sendiri (fallback sisi server tidak mencoba ulang permintaan yang ditolak dengan "reasoning_extraction"; penolakan tersebut dikembalikan kepada Anda); lihat Penolakan dan fallback dan Penolakan safeguard.

  1. Jalankan ulang sweep effort Anda. Effort adalah satu-satunya kontrol thinking pada Claude Opus 5.5, dan defaultnya adalah medium sedangkan default Claude Opus 5 adalah high, sehingga permintaan yang tidak menyertakan effort kini berjalan pada medium. Turunkan level jika kualitas tetap terjaga, dan naikkan untuk pekerjaan yang paling menuntut. Lihat Effort.
  2. Evaluasi ulang instruksi prompt khusus model. Instruksi yang disetel untuk perilaku Claude Opus 5 mungkin tidak lagi diperlukan; lihat Prompting Claude Opus 5.5. Jika Anda menjalankan dengan thinking dinonaktifkan, lihat juga Prompt yang ditulis untuk thinking yang dinonaktifkan.
  3. Uji di lingkungan pengembangan sebelum mengalihkan lalu lintas produksi.

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.8

Pertama, kerjakan Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani thinking di setiap respons, dan Migrasi ke Claude Opus 5.5 dari Claude Opus 5. Gunakan claude-opus-4-8 sebagai ID model yang Anda ganti. Bagian terakhir tersebut berlaku untuk kode pada Claude Opus 4.8 sebagaimana tertulis, karena Claude Opus 4.8, seperti Claude Opus 5:

  • Menerima thinking: {"type": "disabled"}, pilihan alat secara paksa, dan alat computer_20251124.
  • Mengembalikan teks di antara pemanggilan alat sebagai blok text.
  • Menggunakan effort high secara default.

Bagian ini menambahkan apa yang berubah antara Claude Opus 4.8 dan Claude Opus 5. Untuk daftar periksa, lihat dua grup pertama dari daftar periksa migrasi.

Apa yang berubah

  1. Thinking berjalan pada permintaan yang tidak menyertakannya: Pada Claude Opus 4.8, thinking nonaktif kecuali Anda memintanya. Pada Claude Opus 5.5, permintaan tanpa field thinking berjalan dengan thinking, sehingga setiap item di Menangani thinking di setiap respons merupakan perubahan untuk kode tersebut. Jika kode Anda tidak pernah mengirim field thinking, tidak ada yang perlu dihapus berdasarkan sebelum dan sesudah untuk thinking.

  2. Batas minimum caching prompt yang lebih rendah: Panjang prompt minimum yang dapat di-cache pada Claude Opus 5.5 adalah 512 token, turun dari 1.024 token pada Claude Opus 4.8. Prompt yang terlalu pendek untuk di-cache pada Claude Opus 4.8 dapat membuat entri cache, tanpa memerlukan perubahan kode. Lihat "Prompt caching" (caching prompt) untuk batas minimum per model.

  3. Priority Tier tidak didukung: Priority Tier tidak didukung pada Claude Opus 5.5, sementara Claude Opus 4.8 tetap mendukungnya. Jika organisasi Anda memiliki komitmen Priority Tier, rencanakan kapasitas secara terpisah.

Perubahan ini tidak wajib tetapi akan meningkatkan pengalaman Anda:

  1. Pertimbangkan anggaran tugas (beta): Untuk beban kerja agentik, anggaran tugas memberi tahu model berapa banyak token yang dimilikinya untuk satu loop agentik penuh. Fitur ini memerlukan header beta task-budgets-2026-03-13.

  2. Pertimbangkan perubahan alat di tengah percakapan (beta): Perubahan alat di tengah percakapan memungkinkan Anda menambahkan atau menghapus alat di antara giliran percakapan tanpa membatalkan hit cache prompt pada giliran sebelumnya. Mengubah array tools itu sendiri akan membatalkan prefiks yang di-cache. Di Claude API, kirim header beta inline-tools-2026-09-15. Header mid-conversation-tool-changes-2026-07-01 yang lebih lama masih berfungsi untuk perubahan yang menyebutkan alat berdasarkan referensi, di Claude API, Amazon Bedrock, dan Google Cloud.

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.7

Pertama, kerjakan Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani thinking di setiap respons, Migrasi ke Claude Opus 5.5 dari Claude Opus 5, dan Migrasi ke Claude Opus 5.5 dari Claude Opus 4.8. Gunakan claude-opus-4-7 sebagai ID model yang Anda ganti. Bagian-bagian tersebut berlaku untuk kode pada Claude Opus 4.7 sebagaimana tertulis. Seperti Claude Opus 4.8, model ini menerima thinking: {"type": "disabled"}, pilihan alat secara paksa, dan alat computer_20251124. Model ini menggunakan effort high secara default dan berjalan tanpa thinking kecuali Anda memintanya.

Bagian ini menambahkan apa yang berubah setelah Claude Opus 4.7. Jika kode Anda menggunakan Claude Opus 4.6 atau sebelumnya, lanjutkan dengan Migrasi ke Claude Opus 5.5 dari Claude Opus 4.6 dan model Opus sebelumnya setelah bagian ini. Bagian tersebut menambahkan perubahan yang merusak kompatibilitas yang mulai berlaku pada Claude Opus 4.7. Untuk daftar periksa, lihat tiga grup pertama dari daftar periksa migrasi.

Apa yang berubah

Tidak satu pun dari item ini menambahkan perubahan yang merusak kompatibilitas di luar yang ada di bagian sebelumnya; item-item ini layak diperiksa setelah Anda mengganti ID model.

  1. Level effort dikalibrasi ulang: Alokasi token di balik setiap level effort berubah pada Claude Opus 5.5 dibandingkan dengan Claude Opus 4.7. Defaultnya adalah medium, sedangkan default Claude Opus 4.7 adalah high. Jalankan sweep effort baru pada eval Anda sendiri alih-alih membawa pengaturan yang disetel untuk Claude Opus 4.7. Lihat Effort.

  2. Jendela konteks 1M adalah default: Claude Opus 5.5 menyediakan jendela konteks penuh 1M token secara default tanpa header beta. Jika klien Anda mengirimkan header beta jendela konteks untuk kompatibilitas dengan model lama, hapus header tersebut.

  3. Pesan sistem di tengah percakapan: Di Claude API, Amazon Bedrock, dan Google Cloud, Claude Opus 5.5 menerima pesan role: "system" tepat setelah giliran pengguna dalam array messages (tunduk pada aturan penempatan). Gunakan field system tingkat atas untuk instruksi yang berlaku sejak awal. Claude Opus 4.7 menolak role: "system" dalam messages dengan error 400. Jika Anda memelihara jalur kode yang membangun ulang seluruh riwayat pesan untuk memperbarui instruksi, Anda dapat menyederhanakannya dan mempertahankan hit cache prompt pada giliran sebelumnya.

  4. Detail stop penolakan: Ketika model menolak permintaan, Claude Opus 5.5 mengembalikan objek stop_details yang menyebutkan kategori penolakan, bersama dengan stop reason refusal. Claude Opus 4.7 mengembalikan objek yang sama, jadi hal ini hanya penting jika penanganan stop reason Anda belum membacanya. Tidak diperlukan header beta, dan tidak ada opsi untuk menonaktifkannya. Jika penanganan stop reason Anda belum membacanya, lihat Menangani stop reason. Claude Opus 5.5 menolak dalam lebih banyak kategori; lihat Pengklasifikasi keamanan dan fallback.

  5. Fast mode: Claude Opus 5.5 mendukung fast mode di Claude API. Fast mode tidak tersedia pada Claude Opus 4.7, di mana permintaan dengan speed: "fast" mengembalikan error. Atur speed: "fast" pada permintaan Anda. Claude Opus 5.5 tidak memerlukan header beta.

  6. Toolset computer use dan alat browser use: Di Claude API dan Google Cloud, Claude Opus 5.5 mendukung computer use sebagai toolset computer_toolset_20260801 dan alat browser use untuk tugas di dalam halaman web. Claude Opus 4.7 tidak mendukung keduanya. Di platform tersebut, Claude Opus 5.5 tidak menerima alat computer_20251124 yang lebih lama; lihat perubahan yang merusak kompatibilitas pada computer use.

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.6 dan model Opus sebelumnya

Pertama, kerjakan setiap bagian sebelumnya, sesuai urutan halaman. Bagian-bagian tersebut adalah Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani thinking di setiap respons, dan bagian untuk Claude Opus 5, Claude Opus 4.8, dan Claude Opus 4.7. Bagian-bagian tersebut berlaku untuk kode pada Claude Opus 4.6 sebagaimana tertulis. Seperti Claude Opus 4.7, model ini menerima thinking: {"type": "disabled"}, pilihan alat secara paksa, dan alat computer_20251124. Model ini menggunakan effort high secara default dan berjalan tanpa thinking kecuali Anda memintanya. Claude Opus 4.5 dan model Opus sebelumnya juga menerima thinking: {"type": "disabled"} dan pilihan alat secara paksa, serta berjalan tanpa thinking kecuali Anda memintanya, sehingga bagian-bagian tersebut juga berlaku untuk model-model itu.

Bagian ini menambahkan apa yang berubah pada Claude Opus 4.7, dengan claude-opus-4-6 sebagai ID model yang Anda ganti. Dua subbagiannya menambahkan apa yang berubah sebelum itu, untuk pembaca yang menggunakan Claude Opus 4.5 atau sebelumnya dan Claude 4.1 atau sebelumnya. Untuk daftar periksa, lihat daftar periksa migrasi hingga grup yang menyebutkan model Anda.

Perubahan yang merusak kompatibilitas

  1. "Extended thinking" (pemikiran diperpanjang) dihapus: thinking: {"type": "enabled", "budget_tokens": N} tidak lagi didukung pada Claude Opus 4.7 dan model yang lebih baru, dan akan mengembalikan error 400. Beralihlah ke pemikiran adaptif (thinking: {"type": "adaptive"}), lalu gunakan parameter effort untuk mengontrol kedalaman thinking. Pada Claude Opus 5.5, pemikiran adaptif selalu aktif. thinking: {"type": "adaptive"} tetap valid dan setara dengan menghilangkan field thinking sepenuhnya.

    Sebelum (Claude Opus 4.6):

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

    Sesudah (Claude Opus 5.5). Baris ID model, thinking, dan output_config berbeda:

    client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

    Pemikiran adaptif dapat diarahkan melalui prompting dan parameter effort. Parameter effort menggantikan anggaran thinking sebagai cara untuk mengontrol seberapa banyak model bernalar. Jalankan sweep effort pada eval Anda sendiri alih-alih mengonversi nilai budget_tokens. Tabel tingkat effort menjelaskan kapan setiap tingkat sebaiknya digunakan. Untuk model ini, lihat Tingkat effort yang direkomendasikan untuk Claude Opus 5.5.

  2. Parameter sampling dihapus: Menetapkan temperature, top_p, atau top_k ke nilai non-default pada Claude Opus 4.7 dan model yang lebih baru, termasuk Claude Opus 5.5, akan mengembalikan error 400. Python SDK (v1.0 dan yang lebih baru) tidak mendefinisikan parameter tersebut, sehingga meneruskannya akan memunculkan TypeError. Jalur migrasi paling aman adalah menghilangkan parameter ini sepenuhnya dari payload permintaan. Prompting adalah cara yang direkomendasikan untuk mengarahkan perilaku model pada Claude Opus 5.5. Jika sebelumnya Anda menggunakan temperature = 0 demi determinisme, perlu diketahui bahwa pengaturan itu juga tidak pernah menjamin output yang identik pada model-model sebelumnya.

  3. Konten thinking dihilangkan secara default: Blok thinking tetap muncul dalam stream respons pada Claude Opus 4.7 dan model yang lebih baru. Namun, field thinking di dalamnya kosong kecuali Anda secara eksplisit memilih untuk mengaktifkannya. Perubahan ini terjadi tanpa pemberitahuan dibandingkan Claude Opus 4.6, yang secara default mengembalikan teks thinking yang diringkas. Untuk memulihkannya, lihat item 4 dari Menangani thinking di setiap respons.

  4. Penghitungan token yang diperbarui: Claude Opus 4.7 memperkenalkan "tokenizer" (pemecah token) baru, yang juga digunakan oleh model Opus berikutnya, termasuk Claude Opus 5.5. Tokenizer ini berkontribusi pada peningkatan kinerja di berbagai tugas. Namun, tokenizer ini dapat menggunakan sekitar 1x hingga 1,35x lebih banyak token saat memproses teks dibandingkan model sebelum Claude Opus 4.7 (hingga ~35% lebih banyak, tergantung kontennya).

    /v1/messages/count_tokens mengembalikan jumlah token yang berbeda untuk Claude Opus 5.5 dibandingkan untuk Claude Opus 4.6. Efisiensi token dapat bervariasi tergantung bentuk beban kerja.

    Perbarui parameter max_tokens Anda agar memiliki ruang tambahan, termasuk pemicu compaction. Uji ulang juga setiap jalur kode yang memperkirakan token di sisi klien atau mengasumsikan rasio token-ke-karakter yang tetap. Gunakan endpoint penghitungan token untuk memverifikasinya. Intervensi prompting, task_budget, dan effort dapat membantu mengendalikan biaya, tetapi kontrol ini dapat mengorbankan sebagian kecerdasan model.

  5. Penghapusan prefill (sudah berlaku pada Claude Opus 4.6): Melakukan prefill pada pesan asisten mengembalikan error 400 pada Claude Opus 4.6 dan model Opus yang lebih baru, termasuk Claude Opus 5.5, sehingga ini hanya merupakan perubahan jika Anda berasal dari Claude Opus 4.5 atau yang lebih lama. Gunakan output terstruktur atau instruksi prompt sistem sebagai gantinya. Di Amazon Bedrock, output terstruktur tidak tersedia untuk Claude Opus 5.5, jadi gunakan instruksi prompt sistem di sana.

Perubahan perilaku

Claude Opus 4.7 memperkenalkan perbedaan perilaku dari Claude Opus 4.6 yang bukan merupakan perubahan API yang merusak kompatibilitas. Tiga perubahan berikut memengaruhi kode atau "scaffolding" (kerangka pendukung):

  1. Pembaruan progres bawaan dalam jejak agentik: Claude Opus 4.7 memberikan pembaruan yang lebih rutin dan berkualitas lebih tinggi kepada pengguna sepanjang jejak agentik yang panjang. Jika Anda telah menambahkan scaffolding untuk memaksa pesan status sementara ("Setelah setiap 3 pemanggilan alat, ringkas progresnya"), coba hapus scaffolding tersebut. Pada Claude Opus 5.5, pembaruan ini dikirim dalam blok thinking, yang kosong pada pengaturan default thinking.display. Untuk menerimanya, lihat Teks di antara panggilan alat dikembalikan dalam blok thinking. Untuk mengatur panjang dan isinya, lihat Pembaruan progres untuk pengguna.

  2. Pengamanan keamanan siber real-time: Pengamanan ini baru ditambahkan di Claude Opus 4.7. Permintaan yang melibatkan topik terlarang atau berisiko tinggi dapat berujung pada penolakan. Untuk pekerjaan keamanan yang sah seperti penetration testing, riset kerentanan, atau red-teaming, ajukan permohonan ke Cyber Verification Program untuk meminta pelonggaran pembatasan. Jalur pengajuannya bergantung pada cara Anda mengakses Claude.

  3. Dukungan gambar resolusi tinggi: Claude Opus 4.7 adalah model Claude pertama yang mendukung gambar resolusi tinggi. Resolusi gambar maksimum adalah 2.576 piksel pada sisi terpanjang, naik dari 1.568 piksel pada model sebelumnya. Peningkatan ini menghasilkan kinerja yang lebih baik pada beban kerja yang banyak melibatkan visi. Manfaatnya terutama terasa untuk computer use, pemahaman tangkapan layar, dan analisis dokumen.

    Dukungan resolusi tinggi aktif secara otomatis dan tidak memerlukan header beta atau pengaktifan di sisi klien. Ada dua hal yang perlu Anda rencanakan:

    • Gambar beresolusi penuh dapat menggunakan hingga sekitar 3x lebih banyak token gambar dibandingkan pada model sebelumnya (hingga 4.784 token per gambar, dibandingkan batas sebelumnya sekitar 1.600 token per gambar). Sesuaikan kembali anggaran max_tokens dan perkiraan biaya untuk beban kerja yang banyak menggunakan gambar. Jika Anda tidak memerlukan ketelitian tambahan, turunkan resolusi gambar sebelum mengirimkannya.
    • Koordinat penunjuk dan bounding box yang dikembalikan model bernilai 1:1 dengan piksel gambar sebenarnya pada Claude Opus 4.7, sehingga tidak diperlukan konversi faktor skala.

    Lihat Dukungan gambar resolusi tinggi pada Claude Opus 4.7 untuk detailnya.

Untuk perbedaan di sisi prompt, lihat Prompting Claude Opus 5.5 dan Praktik terbaik prompting.

Migrasi dari Claude Opus 4.5 atau yang lebih lama

Jika Anda bermigrasi langsung ke Claude Opus 5.5 dari Claude Opus 4.5, Claude Opus 4.1, atau model yang lebih lama, baca halaman ini dari awal: pertama, kerjakan setiap bagian sebelumnya sesuai urutan halaman. Kemudian kerjakan perubahan yang merusak kompatibilitas untuk migrasi dari Claude Opus 4.6 yang ada sebelumnya di bagian ini. Setelah itu, terapkan perubahan kumulatif berikut, yang mulai berlaku antara Claude Opus 4.5 dan Claude Opus 4.7. Jika Anda menggunakan Claude Opus 4.1 atau yang lebih lama, lanjutkan ke Migrasi dari Claude 4.1 atau yang lebih lama setelah subbagian ini.

Perubahan yang merusak kompatibilitas

  1. Penghapusan prefill dibahas dalam perubahan yang merusak kompatibilitas untuk migrasi dari Claude Opus 4.6.

  2. Penggunaan tanda kutip pada parameter alat: Claude Opus 4.6 dan model yang lebih baru dapat menghasilkan escaping string JSON yang sedikit berbeda dalam argumen pemanggilan alat. Contohnya, penanganan escape Unicode atau escape garis miring yang berbeda. Jika Anda mem-parsing input pemanggilan alat sebagai string mentah alih-alih menggunakan parser JSON, verifikasi logika parsing Anda. Parser JSON standar (seperti json.loads() atau JSON.parse()) menangani perbedaan ini secara otomatis.

Butir pertama wajib diterapkan pada Claude Opus 5.5, sedangkan sisanya direkomendasikan.

  1. Migrasi ke pemikiran adaptif (wajib): thinking: {"type": "enabled", "budget_tokens": N} mengembalikan error 400 pada Claude Opus 4.7 dan model yang lebih baru. Contoh sebelum dan sesudahnya ada di butir 1 dari perubahan yang merusak kompatibilitas untuk migrasi dari Claude Opus 4.6. Migrasi ini juga mencakup peralihan dari client.beta.messages.create() ke client.messages.create(): pemikiran adaptif dan effort tidak memerlukan namespace SDK beta atau header beta apa pun.

  2. Hapus header beta effort: Parameter effort tidak memerlukan header beta. Hapus beta effort-2025-11-24 dari permintaan Anda.

  3. Hapus header beta fine-grained tool streaming: Fine-grained tool streaming tidak memerlukan header beta. Hapus beta fine-grained-tool-streaming-2025-05-14 dari permintaan Anda.

  4. Hapus header beta interleaved thinking: Dengan pemikiran adaptif, interleaved thinking bersifat otomatis pada setiap model yang mendukung pemikiran adaptif. Hapus beta interleaved-thinking-2025-05-14 dari permintaan Anda.

  5. Migrasi ke output_config.format: Jika Anda menggunakan output terstruktur, perbarui output_format={...} menjadi output_config={"format": {...}}. Parameter output_format sudah deprecated dan akan dihapus di masa mendatang. Untuk tetap menggunakannya, tambahkan header beta structured-outputs-2025-11-13. Tanpa header tersebut, API mengembalikan error 400. Python SDK (v1.0 dan yang lebih baru) tidak menerima output_format={...} pada client.beta.messages.create() atau count_tokens(). Argumen output_format=Model dari helper parse() dan stream() tidak berubah.

Migrasi dari Claude 4.1 atau yang lebih lama

Jika Anda bermigrasi langsung ke Claude Opus 5.5 dari Claude Opus 4.1 atau model yang lebih lama, terapkan terlebih dahulu semua yang ada di Migrasi dari Claude Opus 4.5 atau yang lebih lama. Subbagian tersebut dimulai dengan semua bagian sebelumnya, sehingga pada dasarnya Anda membaca halaman ini dari awal. Setelah itu, terapkan perubahan tambahan di subbagian ini.

Perubahan tambahan yang merusak kompatibilitas

  1. Hapus parameter sampling: Dibahas dalam Parameter sampling dihapus.

  2. Perbarui versi alat

    Perbarui ke versi alat terkini. Hapus semua kode yang menggunakan perintah undo_edit.

    # Sebelum
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Sesudah
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • Text editor: Gunakan text_editor_20250728 dan str_replace_based_edit_tool. Lihat dokumentasi Alat text editor untuk detailnya.
    • Code execution: Tingkatkan ke code_execution_20260521. Lihat dokumentasi Alat code execution untuk instruksi migrasi.
    • Computer use: Di Claude API dan Google Cloud, Claude Opus 5.5 hanya menerima computer use dalam bentuk toolset computer_toolset_20260801. Alat computer_20250124 dan computer_20251124 yang lebih lama ditolak di sana. Lihat perubahan yang merusak kompatibilitas pada computer use.

  3. Tangani stop reason refusal

    Perbarui aplikasi Anda untuk menangani stop reason refusal:

    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Tangani penolakan dengan tepat
    pass

  4. Tangani stop reason model_context_window_exceeded

    Claude 4.5 dan model yang lebih baru mengembalikan stop reason model_context_window_exceeded ketika pembuatan teks berhenti karena mencapai batas "context window" (jendela konteks), bukan karena batas max_tokens yang diminta. Perbarui aplikasi Anda untuk menangani stop reason baru ini:

    response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # Tangani batas jendela konteks dengan tepat
    pass

  5. Verifikasi penanganan parameter alat (baris baru di akhir)

    Claude 4.5 dan model yang lebih baru mempertahankan baris baru di akhir pada parameter string pemanggilan alat, yang sebelumnya dihapus. Jika alat Anda mengandalkan pencocokan string yang persis terhadap parameter pemanggilan alat, pastikan logika Anda menangani baris baru di akhir dengan benar.

  6. Perbarui prompt Anda untuk perubahan perilaku

    Claude 4 dan model yang lebih baru memiliki gaya komunikasi yang lebih ringkas dan langsung, serta memerlukan arahan yang eksplisit. Tinjau praktik terbaik prompting untuk panduan optimasi.

  • Hapus header beta lama: Hapus token-efficient-tools-2025-02-19 dan output-128k-2025-02-19. Semua model Claude 4 dan yang lebih baru sudah memiliki penggunaan alat yang hemat token secara bawaan, sehingga header ini tidak berpengaruh.

Migrasi ke Claude Opus 5.5 dari Claude Sonnet 5

Kerjakan Persyaratan yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani thinking di setiap respons, dan Migrasi ke Claude Opus 5.5 dari Claude Opus 5. Gunakan claude-sonnet-5 sebagai ID model yang Anda ganti. Bagian terakhir tersebut berlaku untuk kode pada Claude Sonnet 5 sebagaimana tertulis, karena Claude Sonnet 5, seperti Claude Opus 5:

  • Berjalan dengan thinking aktif secara default dan menerima thinking: {"type": "disabled"}, yang pada Claude Sonnet 5 berlaku di tingkat effort mana pun.
  • Menerima pilihan alat secara paksa dan alat computer_20251124.
  • Mengembalikan teks di antara pemanggilan alat sebagai blok text.
  • Menggunakan effort high secara default.

Pemikiran diperpanjang manual, parameter sampling non-default, dan prefill asisten mengembalikan error 400 pada kedua model, sehingga tidak ada yang berubah dalam hal tersebut. Tidak ada perubahan wajib di bagian untuk Claude Opus 4.8, Claude Opus 4.7, dan Claude Opus 4.6 yang berlaku bagi Anda.

Apa yang berubah

  1. Pesan sistem di tengah percakapan: Di Claude API, Amazon Bedrock, dan Google Cloud, Claude Opus 5.5 menerima pesan role: "system" tepat setelah giliran pengguna dalam array messages (dengan mengikuti aturan penempatan). Fitur ini tidak tersedia di Claude Sonnet 5. Jika Anda memelihara jalur kode yang membangun ulang seluruh riwayat pesan untuk memperbarui instruksi, Anda dapat menyederhanakannya. Dengan begitu, Anda juga mempertahankan hit cache prompt pada giliran-giliran sebelumnya.

  2. Batas minimum caching prompt yang lebih rendah: Panjang prompt minimum yang dapat di-cache pada Claude Opus 5.5 adalah 512 token, turun dari 1.024 token pada Claude Sonnet 5. Prompt yang sebelumnya terlalu pendek untuk di-cache pada Claude Sonnet 5 kini dapat membuat entri cache tanpa perlu perubahan kode. Lihat "Prompt caching" (caching prompt) untuk batas minimum per model.

Was this page helpful?