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 pemikiran di setiap respons, dan daftar periksa untuk setiap model awal.

Claude Code

Biarkan Claude Code memigrasikan kode Anda

/claude-api migrate proyek ini ke claude-opus-5-5

Halaman ini mencantumkan perubahan kode untuk berpindah 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 memerlukan Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5 dan Menangani pemikiran 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 USD; lihat harga Claude). Untuk dukungan fitur, lihat Yang baru di Claude Opus 5.5. Untuk perbedaan perilaku dan pola prompting khusus model, lihat Menulis prompt untuk Claude Opus 5.5.

Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5

Dari model mana pun Anda berasal, permintaan ke claude-opus-5-5 harus memenuhi hal-hal berikut. Jika suatu item menyatakan 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 on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed), dan Microsoft Foundry, gunakan ID model platform tersebut; lihat Ketersediaan.
  • Pemikiran: 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 Level 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": "..."} akan ditolak. Lihat sebelum dan sesudah untuk pilihan alat.
  • Parameter sampling: Hilangkan temperature, top_p, dan top_k. Gunakan prompting untuk mengarahkan perilaku model.
  • Prefill: Jangan akhiri messages dengan giliran asisten yang di-prefill: ini akan ditolak. Gunakan output terstruktur atau instruksi prompt sistem sebagai gantinya.
  • Penggunaan komputer: Deklarasikan penggunaan komputer sebagai toolset computer_toolset_20260801. Di Amazon Bedrock, computer_20251124 juga berfungsi. Lihat perubahan yang merusak kompatibilitas pada penggunaan komputer.
  • Jendela konteks: Tidak diperlukan header beta 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. Di bagian contoh yang mencetak teks, contoh tersebut menemukan blok teks berdasarkan tipenya, 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 pemikiran di setiap respons

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

  1. max_tokens mencakup pemikiran ditambah teks: Di Claude Opus 4.8 dan model Opus sebelumnya, permintaan tanpa field thinking berjalan tanpa pemikiran. Claude Opus 5 dan Claude Sonnet 5 menerima thinking: {"type": "disabled"}. Di Claude Opus 5.5, setiap permintaan berjalan dengan pemikiran adaptif. max_tokens tetap menjadi batas keras untuk total output, yaitu pemikiran ditambah teks respons, jadi tinjau kembali nilainya untuk beban kerja yang berjalan tanpa pemikiran. Token pemikiran ditagih sebagai token output bahkan ketika teks pemikiran tidak dikembalikan kepada Anda, sehingga beban kerja seperti itu dapat menghasilkan lebih banyak token output per permintaan. Lihat Pengendalian biaya. Untuk menghabiskan lebih sedikit token untuk pemikiran, turunkan level effort. Jika Anda menjalankan pada 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 disesuaikan untuk berjalan tanpa pemikiran, lihat Prompt yang ditulis untuk pemikiran yang dinonaktifkan.

  2. Respons diawali dengan blok pemikiran: 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 "text", dan lakukan percabangan berdasarkan tipe blok saat menangani event stream.

  3. Kembalikan blok pemikiran tanpa modifikasi dalam loop penggunaan alat: Jika Anda menjalankan loop 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 sebagaimana diterima, alih-alih memfilter blok kontennya berdasarkan tipe atau menyusunnya ulang: API menolak blok pemikiran yang diedit, diurutkan ulang, atau sebagian dihapus dengan error 400. Lihat Mempertahankan blok pemikiran.

  4. Teks pemikiran dihilangkan secara default: thinking.display default-nya adalah "omitted", sehingga blok thinking tiba dengan field thinking 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 kemajuan yang terlihat selama pemikiran. Lihat Mengendalikan tampilan pemikiran.

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

Daftar periksa migrasi berdasarkan model awal

Telusuri grup-grup ini 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 menjadi 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.
  • Jika Anda menggunakan versi alat penggunaan komputer yang lebih lama, deklarasikan computer_toolset_20260801 (tanpa header beta) sebagai gantinya dan perbarui loop agen Anda untuk toolset tersebut. Di Amazon Bedrock, computer_20251124 juga berfungsi.
  • Jika router atau fallback dapat memindahkan percakapan dari Claude Opus 5.5 ke model lain, perkirakan bahwa model tersebut akan berjalan tanpa blok thinking dari 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 Claude Models on Google Cloud (Google managed), 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 kirim kembali blok thinking tanpa modifikasi dalam loop penggunaan alat.
  • Jika antarmuka Anda merender teks di antara pemanggilan alat, atur display: "updates" (beta) atau "summarized" dan render 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 Tangani thinking di setiap respons.

Claude Opus 4.8 atau sebelumnya

  • Tinjau beban kerja yang berjalan tanpa field thinking: di Claude Opus 5.5 beban kerja tersebut berjalan dengan pemikiran, dan pemikiran tidak dapat dinonaktifkan. Tinjau kembali max_tokens, yang tetap menjadi batas keras untuk total output (pemikiran ditambah teks respons), dan turunkan effort di tempat Anda menginginkan pemikiran yang lebih sedikit. Token pemikiran ditagih sebagai token output, sehingga beban kerja ini dapat menghasilkan lebih banyak token output per permintaan.
  • Verifikasi bahwa kode apa pun yang mem-parsing field thinking memperlakukannya hanya sebagai teks tampilan. Atur display: "summarized" untuk menerima ringkasan yang dapat dibaca.
  • Tinjau prompt yang mendekati batas minimum caching: prompt sepanjang 512 token atau lebih dapat membuat entri cache.
  • Jika organisasi Anda memiliki komitmen Priority Tier, rencanakan kapasitas secara terpisah: Priority Tier tidak didukung di Claude Opus 5.5.
  • Jika Anda menjalankan pada effort xhigh atau max, naikkan max_tokens menjadi setidaknya 64k sebagai titik awal.
  • Untuk beban kerja agentik, pertimbangkan 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 disesuaikan untuk model sebelumnya.
  • Hapus header beta jendela konteks apa pun.
  • Jika Anda menyusun ulang riwayat percakapan untuk memperbarui instruksi, pertimbangkan untuk beralih ke pesan sistem di tengah percakapan untuk mempertahankan cache hit prompt.
  • Verifikasi bahwa penanganan alasan berhenti Anda membaca stop_details pada penolakan.
  • Jika Anda menginginkan mode cepat, yang ditolak 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 pemikiran, ikut serta secara eksplisit dalam peringkasan pemikiran.
  • Lakukan benchmark ulang biaya dan latensi end-to-end di bawah tokenisasi yang diperbarui.
  • Sesuaikan 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 penunjukan atau bounding-box dari model, hapus konversi faktor skala apa pun; koordinat bersifat 1:1 dengan piksel gambar sebenarnya di Claude Opus 4.7 dan model yang lebih baru.
  • Tinjau perubahan perilaku yang dimulai di 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.
  • Verifikasi bahwa parsing 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 pemikiran berselang 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 alasan berhenti refusal.
  • Tangani alasan berhenti model_context_window_exceeded.
  • Verifikasi penanganan parameter string alat untuk baris baru di akhir.
  • Hapus beta header token-efficient-tools-2025-02-19 dan output-128k-2025-02-19.
  • Tinjau dan perbarui prompt mengikuti praktik terbaik prompting.

Hanya Claude Sonnet 5

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

Migrasi ke Claude Opus 5.5 dari Claude Opus 5

Pertama, kerjakan Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5 dan Menangani pemikiran di setiap respons. Setiap model awal memerlukan perubahan di bagian ini. Perubahan tersebut adalah pengaturan permintaan yang ditolak 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 on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed), dan Microsoft Foundry, gunakan ID model platform tersebut; lihat Ketersediaan.

Perubahan yang merusak

Setiap perubahan dijelaskan di bawah Perubahan yang merusak dalam Yang baru di Claude Opus 5.5; bagian ini memberikan perubahan kode untuk masing-masing.

Pemikiran 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; di tempat Anda sebelumnya menonaktifkan pemikiran 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 Pemikiran 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 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. 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,
    # penggunaan alat ketat: setiap panggilan cocok dengan input_schema 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 pemikiran terikat pada model dan percakapan

Di Claude API, Claude Fable 5.1 dan Claude Mythos 5.1 membaca blok pemikiran 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 akan menjalankan giliran-giliran tersebut tanpa blok pemikiran itu. Sebaliknya, Claude Opus 5.5 membaca blok pemikiran dari Claude Opus 5, dari model Opus, Sonnet, dan Haiku sebelumnya, serta, di Claude API dan Claude Models on Google Cloud (Google managed), dari Claude Sonnet 5.5 dan Claude Haiku 5.5, tetapi tidak dari model Claude Fable atau Claude Mythos. Pertahankan percakapan agar bersifat append-only (tanpa pengeditan pada prompt system, tools, atau pesan sebelumnya di tengah percakapan) sehingga blok-blok tersebut tetap valid; Claude Code, claude.ai, Claude Managed Agents, dan Claude Agent SDK sudah melakukannya. Pada akun yang dibuat pada atau setelah 31 Agustus 2026, 00:00 UTC, di Claude API dan di platform cloud, permintaan yang memutar ulang blok pemikiran setelah pengeditan semacam itu dan membiarkan thinking.block_binding.prefix_mismatch_behavior tidak diatur akan mendapatkan error 400. Tidak ada perubahan kode untuk integrasi yang bersifat append-only. Lihat Blok pemikiran terikat pada model dan percakapan dan Pemikiran yang dipertahankan.

Beberapa versi alat penggunaan komputer tidak didukung

Claude Opus 5.5 mendukung penggunaan komputer melalui toolset computer_toolset_20260801. Di Amazon Bedrock, Claude Opus 5.5 juga menerima alat computer_20251124 dengan header beta computer-use-2025-11-24. Claude Opus 5.5 mengembalikan error 400 untuk versi alat penggunaan komputer apa pun yang tidak diterimanya, seperti computer_20251124 di Claude API. Model ini tidak menerima computer_20250124 di platform mana pun. Di Claude API, pesan error diawali dengan 'claude-opus-5-5' does not support tool types: computer_20251124. lalu mencantumkan tipe alat yang diterima model.

Integrasi yang menggunakan toolset tidak memerlukan perubahan. Untuk memindahkan integrasi computer_20251124 ke toolset, hapus header beta dan kirim entri computer_toolset_20260801 tanpa name atau dimensi tampilan. Dalam loop agen Anda, tangani setiap blok tool_use anggota dalam satu giliran dan sertakan kembali toolset_name di setiap hasil. Baca aksi dari name setiap blok, bukan dari input.action. Migrasi dari computer_20251124 mencantumkan perubahan loop agen.

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

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 pemanggilan alat dikembalikan dalam blok pemikiran

Di Claude Opus 5, teks yang ditulis model di antara pemanggilan alat dikembalikan sebagai blok text. Di Claude Opus 5.5, seperti di Claude Fable 5.1, narasi tersebut dikembalikan sebagai blok thinking progress-update, paling banyak satu sebelum setiap pemanggilan alat. Pada thinking.display default "omitted", field thinking mereka kosong. Tidak ada permintaan yang gagal, tetapi aplikasi yang melakukan streaming teks tersebut kepada penggunanya sebagai pembaruan kemajuan menjadi diam di antara pemanggilan alat. Untuk memulihkan pembaruan tersebut, bacalah dari blok thinking dan atur nilai display yang mengembalikan teksnya: "updates" (beta, header thinking-display-updates-2026-08-18) mengembalikan pembaruan kemajuan sementara penalaran tetap tersembunyi, dan "summarized" mengembalikan keduanya, bercampur menjadi satu. 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 kemajuan yang ditampilkan ke pengguna.

Classifier keamanan dan fallback

Claude Opus 5.5 dapat mengembalikan stop_reason: "refusal" dengan kategori stop_details. Classifier-nya mencakup serangkaian kategori yang lebih luas dibandingkan 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 pemikiran di Claude Opus 5.5, dan defaultnya adalah medium sedangkan default Claude Opus 5 adalah high, sehingga permintaan yang menghilangkan effort kini berjalan pada medium. Turunkan level di tempat kualitas tetap terjaga, dan naikkan untuk pekerjaan yang paling menuntut. Lihat Effort.
  2. Evaluasi ulang instruksi prompt khusus model. Instruksi yang disesuaikan untuk perilaku Claude Opus 5 mungkin tidak lagi diperlukan; lihat Menulis prompt untuk Claude Opus 5.5. Jika Anda berjalan dengan pemikiran dinonaktifkan, lihat juga Prompt yang ditulis untuk pemikiran 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 Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani pemikiran 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 di Claude Opus 4.8 sebagaimana tertulis, karena Claude Opus 4.8, seperti Claude Opus 5:

  • Menerima thinking: {"type": "disabled"}, pilihan alat paksa, dan alat computer_20251124.
  • Mengembalikan teks di antara pemanggilan alat sebagai blok text.
  • Menggunakan effort high sebagai 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. Pemikiran berjalan pada permintaan yang menghilangkannya: Di Claude Opus 4.8, pemikiran nonaktif kecuali Anda memintanya. Di Claude Opus 5.5, permintaan tanpa field thinking berjalan dengan pemikiran, sehingga setiap item dalam Menangani pemikiran di setiap respons merupakan perubahan untuk kode tersebut. Jika kode Anda tidak pernah mengirim field thinking, tidak ada yang perlu dihapus di bawah sebelum dan sesudah untuk pemikiran.

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

  3. Priority Tier tidak didukung: Priority Tier tidak didukung di Claude Opus 5.5, sedangkan 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, Claude Platform on AWS, dan Claude Models on Google Cloud (Anthropic managed), kirimkan header beta inline-tools-2026-09-15. Header mid-conversation-tool-changes-2026-07-01 berfungsi untuk perubahan yang menyebut alat berdasarkan referensi, di Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), dan Claude Models on Google Cloud (Google managed).

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.7

Pertama, kerjakan Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani pemikiran 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 di Claude Opus 4.7 sebagaimana tertulis. Seperti Claude Opus 4.8, model ini menerima thinking: {"type": "disabled"}, pilihan alat paksa, dan alat computer_20251124. Model ini menggunakan effort high sebagai default dan berjalan tanpa pemikiran 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 yang mulai berlaku di 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 di luar yang ada di bagian-bagian sebelumnya; item-item ini layak diperiksa setelah Anda mengganti ID model.

  1. Tingkat effort dikalibrasi ulang: Alokasi token di balik setiap tingkat effort berubah pada Claude Opus 5.5 dibandingkan dengan Claude Opus 4.7. Nilai default-nya adalah medium, sedangkan pada 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 sebesar 1M token secara default tanpa header beta. Jika klien Anda mengirimkan header beta jendela konteks demi kompatibilitas dengan model yang lebih lama, hapus header tersebut.

  3. Pesan sistem di tengah percakapan: Di Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), dan Claude Models on Google Cloud (Google managed), Claude Opus 5.5 menerima pesan role: "system" tepat setelah giliran pengguna dalam array messages (dengan tunduk pada aturan penempatan). Gunakan field system tingkat atas untuk instruksi yang berlaku sejak awal. Claude Opus 4.7 menolak role: "system" di 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 penghentian penolakan: Ketika model menolak suatu permintaan, Claude Opus 5.5 mengembalikan objek stop_details yang menyebutkan kategori penolakan, bersama dengan alasan penghentian refusal. Claude Opus 4.7 mengembalikan objek yang sama, jadi hal ini hanya penting jika penanganan alasan penghentian Anda belum membacanya. Tidak diperlukan header beta, dan tidak ada opsi untuk menonaktifkannya. Jika penanganan alasan penghentian Anda belum membacanya, lihat Menangani alasan penghentian. Claude Opus 5.5 menolak dalam lebih banyak kategori; lihat Pengklasifikasi keamanan dan fallback.

  5. Mode cepat: Claude Opus 5.5 mendukung mode cepat di Claude API. Mode cepat tidak tersedia di 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 penggunaan komputer dan alat penggunaan browser: Claude Opus 5.5 mendukung penggunaan komputer sebagai toolset computer_toolset_20260801 dan alat penggunaan browser untuk tugas di dalam halaman web. Claude Opus 4.7 tidak mendukung keduanya. Untuk memindahkan integrasi computer_20251124 ke toolset, lihat perubahan yang merusak kompatibilitas pada penggunaan komputer.

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 Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani pemikiran 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"}, pemilihan alat paksa (forced tool choice), dan alat computer_20251124. Model ini menggunakan effort high secara default dan berjalan tanpa pemikiran kecuali Anda memintanya. Claude Opus 4.5 dan model Opus sebelumnya juga menerima thinking: {"type": "disabled"} dan pemilihan alat paksa, serta berjalan tanpa pemikiran kecuali Anda memintanya, sehingga bagian-bagian tersebut juga berlaku untuk model-model itu.

Bagian ini menambahkan apa yang berubah di 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. Pemikiran diperpanjang dihapus: thinking: {"type": "enabled", "budget_tokens": N} tidak lagi didukung pada Claude Opus 4.7 dan model yang lebih baru serta mengembalikan error 400. Beralihlah ke pemikiran adaptif (thinking: {"type": "adaptive"}) dan gunakan parameter effort untuk mengontrol kedalaman pemikiran. Pada Claude Opus 5.5, pemikiran adaptif selalu aktif: thinking: {"type": "adaptive"} 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), dengan perbedaan pada baris ID model, thinking, dan output_config:

    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, yang menggantikan anggaran pemikiran sebagai cara untuk mengontrol seberapa banyak model bernalar. Jalankan sweep effort pada eval Anda sendiri alih-alih menerjemahkan nilai budget_tokens. Tabel tingkat effort menjelaskan kapan harus menggunakan setiap tingkat, dan Tingkat effort yang direkomendasikan untuk Claude Opus 5.5 membahas model ini.

  2. Parameter sampling dihapus: Hilangkan temperature, top_p, dan top_k. Prompting adalah cara yang direkomendasikan untuk memandu perilaku model pada Claude Opus 5.5. Jika Anda menggunakan temperature = 0 untuk determinisme, perhatikan bahwa hal itu tidak pernah menjamin output yang identik pada model sebelumnya.

  3. Konten pemikiran dihilangkan secara default: Blok pemikiran masih muncul dalam stream respons pada Claude Opus 4.7 dan model yang lebih baru, tetapi field thinking-nya kosong kecuali Anda secara eksplisit memilih untuk mengaktifkannya. Ini adalah perubahan diam-diam dari Claude Opus 4.6, yang secara default mengembalikan teks pemikiran yang dirangkum. Untuk memulihkannya, lihat butir 4 dari Menangani pemikiran di setiap respons.

  4. Penghitungan token yang diperbarui: Claude Opus 4.7 memperkenalkan tokenizer baru, yang juga digunakan oleh model Opus berikutnya, termasuk Claude Opus 5.5. Tokenizer ini berkontribusi pada peningkatan performa di berbagai tugas, dan mungkin menggunakan sekitar 1x hingga 1,35x lebih banyak token saat memproses teks dibandingkan model sebelum Claude Opus 4.7 (hingga sekitar 35 persen lebih banyak, bervariasi tergantung konten).

    /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 untuk memberikan ruang tambahan, termasuk pemicu compaction, dan uji ulang setiap jalur kode yang memperkirakan token di sisi klien atau mengasumsikan rasio token-ke-karakter yang tetap. Gunakan endpoint Penghitungan token untuk memverifikasi. Intervensi prompting, task_budget, dan effort dapat membantu mengontrol biaya; kontrol-kontrol ini mungkin mengorbankan kecerdasan model.

  5. Penghapusan prefill (sudah berlaku pada Claude Opus 4.6): Prefill pesan asisten mengembalikan error 400 pada Claude Opus 4.6 dan model Opus yang lebih baru, termasuk Claude Opus 5.5, jadi ini hanya merupakan perubahan jika Anda berasal dari Claude Opus 4.5 atau sebelumnya. Gunakan output terstruktur atau instruksi prompt sistem sebagai gantinya.

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:

  1. Pembaruan progres bawaan dalam jejak agentik: Claude Opus 4.7 memberikan pembaruan yang lebih teratur dan berkualitas lebih tinggi kepada pengguna sepanjang jejak agentik yang panjang. Jika Anda telah menambahkan scaffolding untuk memaksa pesan status sementara (“Setelah setiap 3 panggilan alat, rangkum progres”), coba hapus. Pada Claude Opus 5.5, pembaruan ini muncul dalam blok thinking, yang kosong pada thinking.display default. Untuk menerimanya, lihat Teks di antara panggilan alat dikembalikan dalam blok pemikiran. Untuk membentuk panjang dan isinya, lihat Pembaruan progres yang ditampilkan kepada pengguna.

  2. Perlindungan keamanan siber real-time: Perlindungan ini baru di Claude Opus 4.7: permintaan yang melibatkan topik terlarang atau berisiko tinggi dapat menyebabkan penolakan. Untuk pekerjaan keamanan yang sah seperti pengujian penetrasi, riset kerentanan, atau red-teaming, ajukan permohonan ke Cyber Verification Program untuk meminta pembatasan yang dikurangi. Jalur pengajuan bergantung pada cara Anda mengakses Claude.

  3. Dukungan gambar resolusi tinggi: Claude Opus 4.7 adalah model Claude pertama dengan dukungan gambar resolusi tinggi. Resolusi gambar maksimum adalah 2.576 piksel pada sisi panjang, naik dari 1.568 piksel pada model sebelumnya. Hal ini membuka peningkatan pada beban kerja yang banyak menggunakan vision dan sangat berharga untuk penggunaan komputer, pemahaman screenshot, dan analisis dokumen.

    Dukungan resolusi tinggi bersifat otomatis dan tidak memerlukan header beta atau opt-in di sisi klien. Dua hal yang perlu direncanakan:

    • Gambar resolusi penuh dapat menggunakan hingga sekitar 3x lebih banyak token gambar dibandingkan pada model sebelumnya (hingga 4.784 token untuk setiap gambar, dibandingkan batas sebelumnya sekitar 1.600 token). Anggarkan ulang max_tokens dan ekspektasi biaya untuk beban kerja yang banyak menggunakan gambar, atau lakukan downsample sebelum mengirim jika Anda tidak memerlukan fidelitas tambahan.
    • Koordinat penunjukan dan bounding-box yang dikembalikan oleh model bersifat 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 Menulis prompt untuk Claude Opus 5.5 dan Praktik terbaik prompting.

Migrasi dari Claude Opus 4.5 atau sebelumnya

Jika Anda bermigrasi dari Claude Opus 4.5, Claude Opus 4.1, atau model sebelumnya langsung ke Claude Opus 5.5, baca halaman ini dari atas: 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. Kemudian 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 sebelumnya, lanjutkan dengan Migrasi dari Claude 4.1 atau sebelumnya setelah subbagian ini.

Perubahan yang merusak kompatibilitas

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

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

Butir pertama wajib pada Claude Opus 5.5; 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 berpindah dari client.beta.messages.create() ke client.messages.create(): pemikiran adaptif dan effort tidak memerlukan namespace SDK beta atau beta header 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 streaming alat fine-grained: Streaming alat fine-grained tidak memerlukan header beta. Hapus beta fine-grained-tool-streaming-2025-05-14 dari permintaan Anda.

  4. Hapus header beta pemikiran berselang: Dengan pemikiran adaptif, pemikiran berselang 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 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 sebelumnya

Jika Anda bermigrasi dari Claude Opus 4.1 atau model sebelumnya langsung ke Claude Opus 5.5, pertama terapkan semua yang ada di Migrasi dari Claude Opus 4.5 atau sebelumnya. Subbagian tersebut dimulai dengan setiap bagian sebelumnya, sehingga pada dasarnya Anda membaca halaman ini dari atas. Kemudian terapkan perubahan tambahan dalam subbagian ini.

Perubahan tambahan yang merusak kompatibilitas

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

  2. Perbarui versi alat

    Perbarui ke versi alat terkini. Hapus kode apa pun 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"}]
    • Editor teks: Gunakan text_editor_20250728 dan str_replace_based_edit_tool. Lihat dokumentasi Alat editor teks untuk detailnya.
    • Eksekusi kode: Tingkatkan ke code_execution_20260521. Lihat dokumentasi Alat eksekusi kode untuk instruksi migrasi.
    • Penggunaan komputer: Gunakan toolset computer_toolset_20260801 sebagai pengganti computer_20250124, yang tidak diterima oleh Claude Opus 5.5. Di Amazon Bedrock, computer_20251124 juga berfungsi. Lihat perubahan yang merusak kompatibilitas pada penggunaan komputer.

  3. Tangani alasan berhenti refusal

    Perbarui aplikasi Anda untuk menangani alasan berhenti refusal:

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

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

  4. Tangani alasan berhenti model_context_window_exceeded

    Model Claude 4.5 dan yang lebih baru mengembalikan alasan berhenti model_context_window_exceeded ketika pembuatan berhenti karena mencapai batas jendela konteks, bukan batas max_tokens yang diminta. Perbarui aplikasi Anda untuk menangani alasan berhenti 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)

    Model Claude 4.5 dan yang lebih baru mempertahankan “trailing newline” (baris baru di akhir) dalam parameter string pemanggilan alat yang sebelumnya dihapus. Jika alat Anda bergantung pada pencocokan string yang persis terhadap parameter pemanggilan alat, verifikasi bahwa logika Anda menangani baris baru di akhir dengan benar.

  6. Perbarui prompt Anda untuk perubahan perilaku

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

  • Beta header: Hapus token-efficient-tools-2025-02-19 dan output-128k-2025-02-19. Semua model Claude 4 dan yang lebih baru memiliki “tool use” (penggunaan alat) hemat token bawaan dan header-header ini tidak berpengaruh.

Migrasi ke Claude Opus 5.5 dari Claude Sonnet 5

Kerjakan Yang harus dipenuhi setiap permintaan ke Claude Opus 5.5, Menangani pemikiran 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 pemikiran aktif secara default dan menerima thinking: {"type": "disabled"}, dalam kasusnya pada tingkat effort apa pun.
  • Menerima pemilihan alat paksa dan alat computer_20251124.
  • Mengembalikan teks di antara panggilan alat sebagai blok text.
  • Menggunakan effort high secara default.

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

Apa yang berubah

  1. Pesan sistem di tengah percakapan: Di Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), dan Claude Models on Google Cloud (Google managed), Claude Opus 5.5 menerima pesan role: "system" tepat setelah giliran pengguna dalam array messages (dengan tunduk pada 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 dan mempertahankan hit cache prompt pada 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 memerlukan perubahan kode. Lihat “Prompt caching” (caching prompt) untuk batas minimum per model.

Apakah halaman ini membantu?