Migrasi ke Claude Opus 5.5

Untuk perbedaan perilaku dan pola prompting khusus model, lihat Prompting Claude Opus 5.5.

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). Model ini tetap mempertahankan "context window" (jendela konteks) 1M token dan maksimum 128k token output milik Claude Opus 5. Ada empat "breaking changes" (perubahan yang merusak kompatibilitas) untuk kode yang sudah berjalan di Claude Opus 5, yang dibahas di bagian Perubahan yang merusak kompatibilitas. Untuk dukungan fitur, lihat Yang baru di Claude Opus 5.5.

Migrasi ke Claude Opus 5.5 dari Claude Opus 5

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, Google Cloud, dan Microsoft Foundry, gunakan ID model dari 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 perubahan tersebut.

Thinking tidak dapat dinonaktifkan

thinking: {"type": "disabled"} dan thinking: {"type": "enabled", "budget_tokens": N} sama-sama 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 akan 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 (diterima di Claude Opus 5, ditolak di Claude Opus 5.5):

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 "structured outputs" (output terstruktur), dan nyatakan di dalam prompt kapan alat tersebut berlaku. Lihat Penggunaan alat paksa tidak didukung.

Sebelum:

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 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 dapat membaca blok thinking Claude Opus 5.5; tidak ada model lain yang dapat melakukannya. "Router" (perute) atau "fallback" (cadangan) yang memindahkan percakapan dari Claude Opus 5.5 ke model lain mana pun akan menjalankan giliran tersebut tanpa blok-blok itu. Sebaliknya, Claude Opus 5.5 dapat membaca blok thinking dari Claude Opus 5 serta model Opus, Sonnet, dan Haiku sebelumnya, tetapi tidak dari model Claude Fable atau Claude Mythos. Pertahankan percakapan agar hanya bersifat tambahan (append-only), yaitu tanpa mengedit 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. 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 akan mengembalikan error 400 secara default. Tidak ada perubahan kode untuk integrasi yang bersifat 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 dengan tipe alat yang diterima model). Sebagai gantinya, deklarasikan toolset computer_toolset_20260801: hapus header beta dan kirimkan entri tanpa name atau dimensi tampilan. Dalam loop agen Anda, tangani blok tool_use anggota (aksinya adalah name dari blok tersebut, bukan input.action), yang bisa berjumlah beberapa 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 di Claude Opus 5.5 seperti halnya di 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:

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. "Safety classifiers" (pengklasifikasi keamanan) miliknya mencakup rangkaian kategori yang lebih luas daripada milik Claude Opus 5, jadi perkirakan nilai stop_details.category seperti "bio" dan "reasoning_extraction" selain "cyber"; lihat tabel kategori penolakan. Tangani penolakan dan konfigurasikan fallback sisi server atau mekanisme 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.

Perubahan yang direkomendasikan

1. Jalankan ulang sweep effort Anda. Effort adalah satu-satunya kontrol thinking di Claude Opus 5.5, dan nilai default-nya adalah medium, sedangkan milik 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 disesuaikan untuk perilaku Claude Opus 5 mungkin tidak lagi diperlukan; lihat Prompting Claude Opus 5.5. Jika Anda sebelumnya menjalankan dengan thinking dinonaktifkan, lihat juga Prompt yang ditulis untuk thinking yang dinonaktifkan.
3. Uji di lingkungan pengembangan sebelum mengalihkan lalu lintas produksi.

Daftar periksa migrasi

• Perbarui ID model menjadi claude-opus-5-5.
• Hapus thinking: {"type": "disabled"} dan thinking: {"type": "enabled", ...}; pilih level effort sebagai gantinya.
• Tetapkan effort secara eksplisit: default-nya adalah medium, sedangkan milik Claude Opus 5 adalah high.
• Ganti tipe tool_choice any dan tool dengan auto ditambah penggunaan alat ketat atau output terstruktur.
• 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 bahwa model tersebut akan berjalan tanpa blok thinking Claude Opus 5.5 (Claude Fable 5.1 dan Claude Mythos 5.1 di Claude API merupakan pengecualian dan tetap mempertahankannya). Claude Opus 5.5 sendiri dapat membaca thinking dari Claude Opus 5 serta model Opus, Sonnet, dan Haiku sebelumnya, 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 merender teks di antara panggilan alat, tetapkan 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.

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.8

Kerjakan terlebih dahulu Migrasi ke Claude Opus 5 dari Claude Opus 4.8: panduan tersebut membahas thinking yang aktif secara default dan perubahan bentuk respons yang menyertainya. Kemudian terapkan Migrasi dari Claude Opus 5. Perubahan yang merusak kompatibilitas kedua pada Claude Opus 5 di sana (thinking hanya dapat dinonaktifkan pada effort high atau lebih rendah) tidak berlaku: di Claude Opus 5.5, thinking sama sekali tidak dapat dinonaktifkan.

Daftar periksa migrasi

• Semua yang ada di daftar periksa Claude Opus 4.8 → Claude Opus 5, kecuali bahwa thinking: {"type": "disabled"} bukan merupakan pilihan.
• Semua yang ada di daftar periksa Claude Opus 5 → Claude Opus 5.5.

Migrasi ke Claude Opus 5.5 dari Claude Opus 4.7 dan model Opus sebelumnya

Panduan migrasi Claude Opus 5 membahas perubahan yang merusak kompatibilitas antara model Anda saat ini dan Claude Opus 5: parameter sampling ditolak, pemikiran diperpanjang manual ditolak, prefill dihapus, dan tokenizer yang lebih baru. Kerjakan bagian untuk model Anda di sana, dengan menargetkan claude-opus-5-5 alih-alih claude-opus-5, lalu terapkan Migrasi dari Claude Opus 5. Jika panduan tersebut menyatakan bahwa thinking dapat dinonaktifkan pada effort high atau lebih rendah, hal itu tidak berlaku di Claude Opus 5.5; dan jika panduan tersebut menyatakan bahwa integrasi computer_20251124 yang sudah ada tetap berfungsi, di Claude API dan Google Cloud integrasi tersebut tidak berfungsi di Claude Opus 5.5, yang di sana hanya menerima computer use sebagai toolset computer_toolset_20260801 (lihat perubahan yang merusak kompatibilitas); di Amazon Bedrock integrasi tersebut tetap berfungsi.

Migrasi ke Claude Opus 5.5 dari Claude Sonnet 5

Lihat Migrasi ke Claude Opus 5 dari Claude Sonnet 5 untuk mengetahui apa yang berubah saat beralih ke kelas model yang lebih tinggi, lalu terapkan Migrasi dari Claude Opus 5.