Kecuali Anda menetapkan ANTHROPIC_DEFAULT_FABLE_MODEL, alias fable diselesaikan ke Fable 5.1, kecuali dalam sesi Claude apps gateway, di mana fable dan best diselesaikan ke Fable 5. Sebelum v2.1.257, fable diselesaikan ke Fable 5 di setiap penyedia.

Gateway yang tidak dikonfigurasi untuk melayani claude-fable-5-1 menolak permintaan untuk model itu. Untuk menggunakan Fable 5.1 melalui gateway yang melayaninya, pilih dengan /model claude-fable-5-1.

Di mana alias diselesaikan ke model yang lebih lama, model yang lebih baru tersedia dengan memilih nama model lengkap secara eksplisit atau menetapkan ANTHROPIC_DEFAULT_OPUS_MODEL atau ANTHROPIC_DEFAULT_SONNET_MODEL.

Sebelum v2.1.219, opus diselesaikan ke Opus 4.8 di Anthropic API dari v2.1.154, dan di Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform dari v2.1.207. Sebelum v2.1.207, opus diselesaikan ke Opus 4.7 di Claude Platform on AWS dan ke Opus 4.6 di Amazon Bedrock dan Google Cloud's Agent Platform.

Alias menunjuk ke versi yang direkomendasikan untuk penyedia Anda dan diperbarui seiring waktu. Untuk menyematkan ke versi tertentu, gunakan nama model lengkap, misalnya claude-opus-5, atau atur variabel lingkungan yang sesuai seperti ANTHROPIC_DEFAULT_OPUS_MODEL.

Bekerja dengan Fable

Claude Fable 5.1 dan Claude Fable 5 adalah model paling mampu di Claude Code, cocok untuk tugas-tugas yang lebih besar dari satu sesi. Mereka mempertahankan sesi otonomi yang panjang, menyelidiki sebelum bertindak, dan memverifikasi pekerjaan mereka lebih sering daripada model yang lebih kecil. Fable 5.1 adalah rilis yang lebih baru.

Tidak ada model Fable yang merupakan default tipe akun di paket atau penyedia apa pun. Pilih satu secara eksplisit:

• Fable 5.1: jalankan /model fable, atau luncurkan dengan claude --model fable. Dalam sesi Claude apps gateway, di mana alias diselesaikan ke Fable 5, jalankan /model claude-fable-5-1 sebagai gantinya.
• Fable 5: pilih berdasarkan ID model. Di Anthropic API, jalankan /model claude-fable-5 atau luncurkan dengan claude --model claude-fable-5. Di penyedia lain, gunakan ID model Fable 5 penyedia Anda atau sematkan dengan ANTHROPIC_DEFAULT_FABLE_MODEL.

Jika Anda terhubung ke Anthropic API secara langsung dan pengaturan pengguna Anda menyimpan claude-fable-5 atau claude-fable-5[1m] sebagai model, misalnya karena Anda memilih Fable di pemilih /model sebelum v2.1.257, Claude Code mengubah nilai yang disimpan itu ke alias fable atau fable[1m] pertama kali Anda menjalankan v2.1.257 atau lebih baru. Baris model startup menunjukkan (auto-updated) sekali. Nilai claude-fable-5 dalam pengaturan proyek, lokal, atau terkelola tetap apa adanya.

Permintaan yang pengklasifikasi keamanan model Fable tandai, paling sering di domain keamanan siber dan biologi, memicu fallback model otomatis.

Untuk mendapatkan hasil maksimal dari Fable:

• Jelaskan hasilnya, bukan langkah-langkahnya: berikan hasil yang Anda inginkan dan biarkan merencanakan jalurnya. Untuk membuatnya terus bekerja menuju hasil itu, tetapkan tujuan.
• Berikan masalah yang ambigu: investigasi akar penyebab, debugging pemadaman, dan keputusan arsitektur adalah tempat investigasi dan verifikasi tambahan membayar.
• Lewati pengingat verifikasi: ia memverifikasi pekerjaan sendiri dengan prompting yang lebih sedikit, jadi pengingat untuk menguji atau memeriksa biasanya tidak perlu.
• Ukur tugas yang lebih besar: berikan pekerjaan yang biasanya akan Anda pecah menjadi beberapa bagian. Ia mempertahankan sesi panjang tanpa kehilangan benang merah.

Di Anthropic API, pemilih /model mencantumkan model Fable hanya setelah server melaporkan tersedia untuk organisasi Anda. Ketika Anda mengetik /model fable atau ID model Fable, Claude Code memeriksa ketersediaan dengan server secara langsung, jadi pemilihan yang diketik dapat berhasil bahkan ketika pemilih tidak mencantumkan entri.

Fable dan kredit penggunaan

Tergantung pada paket dan tingkat kursi Anda, penggunaan Fable dapat ditagih ke kredit penggunaan alih-alih mengambil dari batas yang disertakan paket Anda. Ketika itu terjadi, pemilih /model menunjukkan "Memerlukan kredit penggunaan" di baris Fable. Untuk mengelola kredit penggunaan, lihat Tambahkan kredit penggunaan ke langganan Anda.

Dalam sesi interaktif, Claude Code menampilkan prompt persetujuan sebelum permintaan Fable menagih kredit penggunaan. Anggota paket Enterprise dengan penagihan organisasi tidak melihat prompt. Anda dapat melanjutkan di Fable menggunakan kredit penggunaan atau beralih ke model default Anda. Anda juga dapat menutup prompt:

• Di pemilih /model, Anda menyimpan model saat ini.
• Pertengahan sesi, Claude Code melanjutkan giliran di model default Anda.

Setelah Anda memilih untuk melanjutkan di Fable menggunakan kredit penggunaan, Claude Code tidak menampilkan prompt lagi.

Dalam sesi dengan Remote Control terhubung, sesi latar belakang, atau sesi rekan tim agent team, mungkin tidak ada yang berada di terminal, jadi Claude Code menahan prompt persetujuan pertengahan sesi untuk batas waktu dialogExpiry, lima menit secara default. Jika tidak ada yang menjawab pada batas waktu, Claude Code mengakhiri giliran tanpa mengirim permintaan dan menambahkan pemberitahuan ke transkrip, yang juga ditampilkan klien Remote Control. Pilihan model Anda tidak berubah, dan Claude Code meminta persetujuan lagi pada pesan berikutnya Anda.

Apa yang dapat Anda lakukan saat prompt menunggu tergantung pada sesi:

• Dengan Remote Control terhubung atau dalam sesi rekan tim, tekan tombol apa pun di terminal untuk membatalkan batas waktu, dan Claude Code menunggu jawaban Anda.
• Dalam sesi latar belakang, jawab sebelum batas waktu.
• Jika Anda mengirim pesan baru dari klien jarak jauh sebelum ada yang mengetik di terminal, Claude Code mengakhiri giliran dengan cara yang sama, dan pesan baru Anda memulai giliran berikutnya. Setelah seseorang mengetik di terminal, Claude Code terus menunggu jawaban dan mengantrekan pesan baru Anda di belakangnya.

Dalam mode non-interaktif dengan flag -p dan melalui Agent SDK, Claude Code tidak pernah menampilkan prompt persetujuan. Ketika permintaan Fable di sana akan ditagih ke kredit penggunaan, Claude Code menagihnya tanpa bertanya.

Mengatur model Anda

Anda dapat mengonfigurasi model Anda dengan beberapa cara, tercantum dalam urutan prioritas:

1. Selama sesi: gunakan /model <alias|name> untuk beralih segera, atau jalankan /model tanpa argumen untuk membuka pemilih. Lihat ketika Claude Code meminta Anda untuk mengonfirmasi switch
2. Saat startup: luncurkan dengan claude --model <alias|name>
3. Variabel lingkungan: atur ANTHROPIC_MODEL=<alias|name>
4. Pengaturan: konfigurasi secara permanen di file pengaturan Anda menggunakan bidang model
5. Default untuk sesi baru: atur ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model menyimpan pilihan Anda sebagai default untuk sesi baru dengan menulis bidang model di pengaturan pengguna Anda. Di pemilih:

• Enter: alihkan model dan simpan sebagai default Anda
• s: alihkan model hanya untuk sesi ini dan biarkan default Anda tidak berubah. Untuk menggunakan kunci yang berbeda, ikat ulang modelPicker:thisSessionOnly

Mengetik /model <name> langsung berperilaku seperti Enter. Untuk beralih hanya untuk sesi ini, buka pemilih dengan /model dan tekan s di baris model.

Jika Anda menetapkan model dengan /model dalam mode non-interaktif, dengan flag -p, pilihan Anda berlaku hanya untuk sesi saat ini dan tidak disimpan sebagai default Anda; /model dalam mode itu memerlukan Claude Code v2.1.205 atau lebih baru. Pengaturan proyek dan terkelola masih memiliki prioritas dan diterapkan kembali pada peluncuran berikutnya. Model default organisasi yang admin Anda telah dikonfigurasi untuk mengganti pilihan pengguna juga diterapkan kembali pada peluncuran berikutnya.

Dalam v2.1.144 hingga v2.1.152, /model berlaku hanya untuk sesi saat ini dan d di pemilih menyimpan default.

Flag --model dan variabel lingkungan ANTHROPIC_MODEL hanya berlaku untuk sesi yang Anda luncurkan dengannya. Untuk menjalankan model berbeda di terminal berbeda pada waktu yang sama, luncurkan masing-masing dengan flag --model sendiri daripada beralih dengan /model.

Harga di pemilih /model muncul ketika Claude Code berbicara dengan Anthropic API, secara langsung atau melalui gateway LLM yang memproksikannya, dan harga di baris adalah harga model yang dipilih baris itu. Di penyedia pihak ketiga seperti Amazon Bedrock dan di gateway aplikasi Claude, penyedia atau gateway Anda menentukan apa yang Anda bayar, jadi baris pemilih tidak menampilkan harga. Harga adalah label tampilan saja; itu tidak mempengaruhi model mana yang dipilih baris atau apa yang ditagih penyedia Anda. Sebelum v2.1.206, Claude Platform on AWS dan sesi gateway menampilkan harga daftar Anthropic, dan baris dapat menampilkan harga model yang berbeda dari yang dipilihnya.

Sesi yang dilanjutkan dimulai dengan claude --resume, --continue, atau pemilih /resume menyimpan model yang mereka gunakan ketika transkrip disimpan, terlepas dari pengaturan model saat ini. Jika model yang dipulihkan telah pensiun atau dikecualikan oleh availableModels, sesi jatuh melalui urutan prioritas normal. Ini mencegah pilihan /model sesi lain mengubah model pada resume. Di penyedia yang menggunakan ID deployment khusus penyedia daripada ID model Anthropic, seperti Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, model transkrip tidak dipulihkan sama sekali dan sesi menyelesaikan modelnya melalui urutan prioritas normal.

Model yang Anda pilih untuk peluncuran baru dengan --model atau ANTHROPIC_MODEL masih memiliki prioritas atas model yang dipulihkan. Sejak v2.1.195, demikian juga variabel keluarga ANTHROPIC_DEFAULT_OPUS_MODEL. ANTHROPIC_DEFAULT_MODEL juga bisa, di bawah kondisi yang tercantum di bagiannya.

Ketika model aktif saat startup berasal dari pengaturan proyek atau terkelola daripada pilihan Anda sendiri, header startup menunjukkan file pengaturan mana yang menetapkannya. Jalankan /model untuk mengganti; pengaturan proyek atau terkelola diterapkan kembali pada peluncuran berikutnya. Di platform yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host memiliki prioritas atas pengaturan model terkelola, sementara daftar allowlist availableModels terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; Pengecualian untuk prioritas pengaturan terkelola mengatakan kunci dan variabel mana yang diganti host.

Jika Anda atau organisasi Anda mengonfigurasi PreModelSwitch hooks, mereka berjalan sebelum switch yang diminta diterapkan dan dapat memblokir atau meminta Anda untuk mengonfirmasi.

Ketika Claude Code tidak dapat mengetahui hook PreModelSwitch mana yang dikirimkan plugin terkelola organisasi Anda, misalnya karena plugin terkelola gagal dimuat, itu menolak switch daripada menerapkannya tanpa diperiksa, dan itu memeriksa lagi pada setiap upaya baru. Lihat Model switch diblokir oleh hook PreModelSwitch untuk pesan dan pemulihan.

Ketika Anda beralih model melalui metode setModel() Agent SDK atau dari perangkat yang terhubung melalui Remote Control, atau aplikasi seperti Desktop app yang menjalankan Claude Code CLI beralih untuk Anda, Claude Code memeriksa bahwa string adalah yang dikenalinya sebelum menyimpannya. Pemeriksaan ini memerlukan Claude Code v2.1.200 atau lebih baru. Memeriksa pilihan Remote Control memerlukan Claude Code v2.1.260 atau lebih baru di mesin Anda. Di Anthropic API, Claude Code mengenali:

• alias model
• entri dari pemilih /model
• nama apa pun yang dimulai dengan claude-
• nilai yang Anda konfigurasi sendiri sebagai opsi model kustom atau dalam modelOverrides

Claude Code menolak string yang tidak dikenali dengan Model "<name>" is not a recognized model id. dan sesi menyimpan model saat ini, alih-alih menyimpan string dan gagal pada permintaan berikutnya. Lihat referensi kesalahan untuk langkah pemulihan.

Pemeriksaan hanya berjalan di Anthropic API. Di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, dan di balik gateway LLM atau ANTHROPIC_BASE_URL kustom, penyedia atau gateway Anda mendefinisikan nama model, jadi Claude Code melewatkan string apa pun tanpa memeriksanya. Pemeriksaan juga tidak mencakup flag --model, variabel lingkungan ANTHROPIC_MODEL, atau pengaturan model; nilai yang salah ketik di sana menghasilkan Ada masalah dengan model yang dipilih pada permintaan pertama. Claude Code masih dapat menulis baris diagnostik model yang tidak dikenali pada waktu permintaan, di setiap penyedia.

Ketika model yang diminta memiliki tanggal pensiun terjadwal atau secara otomatis dipetakan ulang ke versi yang lebih baru, Claude Code menampilkan peringatan yang menyebutkan model yang diminta. Sesi interaktif menampilkannya sebagai pemberitahuan startup. Dari v2.1.182, peringatan yang sama ditulis ke stderr dalam mode non-interaktif ketika menggunakan format output teks default. Pemeriksaan juga mencakup model yang ditetapkan dalam frontmatter subagent. Peringatan stderr ditekan untuk --output-format json dan stream-json; baca model aktual dari bidang modelUsage dari pesan hasil sebagai gantinya.

Misalnya, mulai sesi di Opus:

claude --model opus

Kemudian alihkan model dari dalam sesi:

/model sonnet

File pengaturan contoh:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Tetapkan model default untuk sesi baru

Atur ANTHROPIC_DEFAULT_MODEL=<alias|name> untuk memilih model yang dimulai sesi Anda secara default. Memerlukan Claude Code v2.1.236 atau lebih baru.

Claude Code memulai sesi baru di model variabel hanya ketika tidak ada yang memilih model:

• Flag --model
• ANTHROPIC_MODEL
• Nilai model dalam file pengaturan apa pun, termasuk pilihan yang Anda simpan dengan /model
• Model default organisasi

Pilihan yang Anda simpan dengan /model memiliki prioritas atas variabel pada peluncuran berikutnya juga. Dengan ANTHROPIC_MODEL yang ditetapkan sebagai gantinya, Claude Code kembali ke model variabel itu pada peluncuran berikutnya, apa pun yang Anda simpan dengan /model.

Claude Code juga menyelesaikan opsi Default ke model variabel, kecuali model default organisasi berlaku. Ketika opsi Default diselesaikan ke model variabel, baris Default di pemilih /model menampilkan label Set by ANTHROPIC_DEFAULT_MODEL.

Claude Code mengabaikan variabel dalam kasus-kasus ini, dan opsi Default diselesaikan seolah-olah Anda belum menetapkannya:

• Anda menetapkannya ke default, inherit, opusplan, atau haiku
• enforceAvailableModels aktif
• availableModels atau pembatasan model organisasi mengecualikan model
• Model tidak tersedia untuk akun Anda

Ketika sesi baru akan dimulai di model variabel, sesi yang Anda lanjutkan dengan claude --resume, --continue, atau pemilih /resume dimulai di sana juga. Claude Code tidak memulihkan model yang disimpan dalam transkrip sesi itu. Jika tidak, Claude Code tidak menggunakan variabel ketika Anda melanjutkan sesi.

Sesi baru dimulai di model yang berbeda dari yang Anda pilih

Ketika Anda memilih model dengan /model dan sesi berikutnya Anda dimulai di sesuatu yang lain, ini adalah penyebab biasanya:

• Anda memilihnya untuk satu sesi. Menekan s di pemilih, meluncurkan dengan --model, dan menjalankan /model dalam mode non-interaktif semuanya berlaku untuk sesi saat ini dan meninggalkan default yang disimpan sendirian.
• Sesuatu dengan prioritas lebih tinggi menetapkan model. Nilai model dalam pengaturan proyek atau terkelola, ANTHROPIC_MODEL di shell Anda, atau default organisasi yang admin Anda tetapkan untuk mengganti pilihan pengguna berlaku lagi di setiap peluncuran. Pilihan /model Anda masih disimpan; itu dilampaui. Ketika pengaturan proyek atau terkelola menetapkan model, header startup menyebutkan file.
• Claude Code tidak dapat menyimpan pilihan Anda. /model menulis model ke ~/.claude/settings.json. Jika Anda tidak dapat menulis ke file itu, misalnya karena alat lain menghasilkannya atau menautkannya ke salinan baca-saja, model yang Anda pilih berlangsung untuk sesi dan peluncuran berikutnya membaca nilai lama. Atur model dalam alat yang menghasilkan file, atau buat file dapat ditulis. Lihat Perubahan yang Anda buat di Claude Code hilang di sesi baru.
• Anda melanjutkan sesi. Sesi yang Anda lanjutkan dengan claude --resume atau --continue biasanya menyimpan model yang digunakan daripada default saat ini Anda.

Batasi pemilihan model

Administrator enterprise dapat menggunakan availableModels dalam pengaturan terkelola atau kebijakan untuk membatasi model mana yang dapat dipilih pengguna. Entri cocok dengan keluarga model seperti sonnet, awalan versi seperti claude-sonnet-4-5, atau ID model lengkap seperti claude-sonnet-4-5-20250929. Awalan versi juga cocok dengan ID model yang lebih baru yang memperpanjangnya dengan segmen lain, jadi claude-fable-5 memungkinkan Fable 5 dan Fable 5.1, sementara claude-fable-5-1 memungkinkan Fable 5.1 saja.

Pada platform yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host mengambil alih pengaturan model terkelola, sementara daftar izin availableModels terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; Pengecualian untuk prioritas pengaturan terkelola mengatakan kunci dan variabel mana yang ditimpa host.

Ketika availableModels diatur, daftar izin berlaku di mana pun pengguna dapat menentukan model:

• Model sesi utama: /model, bendera --model, variabel lingkungan ANTHROPIC_MODEL, pengaturan model, ANTHROPIC_DEFAULT_MODEL, dan model yang dipulihkan saat melanjutkan sesi
• Resolusi alias: variabel lingkungan ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, dan ANTHROPIC_DEFAULT_FABLE_MODEL tidak dapat mengarahkan ulang alias yang diizinkan ke model di luar daftar
• Mode cepat: /fast menolak untuk beralih ketika itu akan secara implisit beralih ke model Opus di luar daftar, dengan pesan "is not in your organization's allowed models"
• Model subagent dan rekan kerja: bidang model dalam frontmatter subagent, parameter model alat Agent, model rekan kerja tim agent, CLAUDE_CODE_SUBAGENT_MODEL, dan, pada v2.1.197 dan lebih awal, pemilih model dalam wizard /agents
• Model skill dan perintah: frontmatter model dalam skills dan commands
• Model advisor: pengaturan advisorModel yang dikonfigurasi dan bendera --advisor
• Model agent latar belakang: model yang dipilih dalam pemilih dispatch

Pada Anthropic API dan Claude Platform on AWS, alias keluarga model, opus, sonnet, haiku, atau fable, diselesaikan ke model biasanya ketika daftar izin memungkinkan model itu. Ketika daftar izin memblokir model itu, Claude Code mengganti versi terbaru keluarga yang daftar izin izinkan dan menampilkan pemberitahuan yang menyebutkan model yang diminta dan diganti. Dengan ["sonnet", "claude-opus-4-6"], misalnya, baik /model opus maupun --model opus memilih Claude Opus 4.6, Opus terbaru yang diizinkan. Sebelum v2.1.205, alias yang versi rilis terbarunya berada di luar daftar ditolak atau diganti seperti pemilihan terblokir lainnya, bahkan ketika daftar memungkinkan versi yang lebih lama.

Substitusi membutuhkan versi yang diizinkan untuk mendarat: ketika daftar izin tidak memungkinkan versi apa pun dari keluarga alias, alias mengikuti perilaku penolakan dan penggantian di bawah seperti nilai terblokir lainnya.

Claude Code menangani pemilihan terblokir lainnya sesuai dengan tempat model diatur:

• /model: Claude Code menolak switch dengan kesalahan

• Bendera --model, ANTHROPIC_MODEL, atau pengaturan model: Claude Code mengganti nilai saat startup dengan peringatan yang menyebutkan model yang diminta dan diganti, dan sesi dimulai pada model default

• ANTHROPIC_DEFAULT_MODEL: Claude Code mengabaikan variabel

• Penggantian subagent atau rekan kerja: Claude Code menjalankan subagent atau rekan kerja pada model fallback daripada gagal permintaan. Lihat Pilih model untuk fallback subagent dan Tentukan rekan kerja dan model untuk fallback rekan kerja.

  Dalam sesi interaktif, Claude Code memperingatkan Anda ketika mengganti model subagent, dengan fallback ini atau dengan substitusi versi-terbaru-yang-diizinkan di atas, menyebutkan model yang diminta dan diganti; itu tidak melaporkan fallback rekan kerja.

  Di mana substitusi versi-terbaru-yang-diizinkan di atas beroperasi, alias keluarga terblokir mengikutinya. Sebelum v2.1.222, alias jatuh kembali seperti nilai terblokir lainnya di setiap penyedia

• Penggantian skill atau perintah: Claude Code mengabaikan penggantian, termasuk alias keluarga terblokir, dan skill atau perintah berjalan pada model sesi. Skill atau perintah yang berjalan dalam subagent mengikuti perilaku subagent di atas

• Pengaturan advisorModel: advisor dinonaktifkan untuk sesi

• Bendera --advisor: Claude Code keluar dengan kesalahan saat peluncuran. Dalam sesi latar belakang, itu memulai sesi tanpa advisor daripada keluar

Claude Code menyembunyikan model yang dikecualikan dari pemilih /model. ID model lengkap dalam daftar yang tidak memiliki baris pemilih bawaan, seperti versi yang lebih lama yang daftar pin, muncul dalam pemilih /model sebagai baris berlabel miliknya sendiri, kecuali Claude Code mengganti opsi bawaan dengan lineup modelPicker. Sebelum v2.1.199, ID tersebut hanya dapat dipilih dengan mengetik /model <id>.

Perubahan model yang Claude Code buat atas nama Anda diperiksa dengan cara yang sama:

• Rantai model fallback: entri di luar daftar izin dijatuhkan
• Upgrade mode plan: pada Anthropic API dan Claude Platform on AWS, upgrade seperti opusplan ke model yang dikecualikan menggunakan versi terbaru keluarga upgrade yang diizinkan. Pada penyedia dengan ID model khusus penyedia, dan ketika tidak ada versi yang diizinkan, upgrade dilewati dan perencanaan berlanjut pada model sesi
• Fallback model otomatis: fallback yang targetnya dikecualikan tidak berjalan, jadi permintaan yang ditandai berakhir dengan penolakan
• Pengklasifikasi mode otomatis: default Claude Sonnet 5 pengklasifikasi hanya berlaku ketika daftar izin memungkinkan Sonnet 5. Ketika dikecualikan, pengklasifikasi berjalan pada model sesi, yang daftar izin sudah mengatur, atau pada model Opus ketika sesi berjalan pada model Fable. Pada penyedia selain Anthropic API, fallback Opus itu berjalan pada model Opus default penyedia tanpa berkonsultasi dengan daftar izin. Memerlukan Claude Code v2.1.210 atau lebih baru
• Mode cepat: mengaktifkan mode cepat ditolak ketika model yang sesi jalankan setelahnya berada di luar daftar izin

{
  "availableModels": ["sonnet", "haiku"]
}

Cakupan permukaan

Setiap permukaan memberlakukan daftar izin yang diterimanya. Mekanisme pengiriman mana yang mencapai setiap permukaan berbeda:

• Sesi cloud, di Claude Code di web atau di aplikasi Desktop, berjalan pada VM yang dikelola Anthropic secara default: pengaturan yang digunakan pada perangkat Anda tidak mencapainya, jadi kirimkan daftar izin melalui pengaturan terkelola server. Sesi yang organisasi Anda arahkan ke lingkungan yang dihosting sendiri berjalan pada komputasi Anda sendiri dan juga membaca file pengaturan terkelola dalam gambar runner. Bagaimana Claude Code menggabungkan sumber terkelola mengatakan kapan file itu berlaku. Perubahan model pertengahan sesi dalam sesi cloud ditolak ketika model yang diminta dikecualikan oleh daftar izin. Ketika daftar availableModels dalam pengaturan terkelola server Anda tidak kosong, server menolak permintaan pengguna untuk memulai sesi cloud pada model yang daftar kecualikan.
• Cowork, tab pekerjaan agentic di aplikasi Claude Desktop, menjalankan sesinya di Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. File pengaturan terkelola berlaku untuk sesi Cowork ketika ada di mana sesi berjalan; sesi Cowork jarak jauh berjalan pada VM yang dikelola Anthropic, di mana file yang digunakan perangkat tidak ada.
• Sesi pada penyedia pihak ketiga seperti Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, dan Claude Platform on AWS tidak menerima pengaturan terkelola server, jadi kirimkan daftar izin melalui file MDM atau pengaturan terkelola di sana.
• Pengiriman terkelola server juga memerlukan sesi untuk mengautentikasi dengan login atau kunci yang memenuhi syarat. Armada yang menghasilkan kunci hanya melalui skrip apiKeyHelper harus mengirimkan daftar izin melalui file MDM atau pengaturan terkelola.
• Tab Desktop Code juga menghosting sesi SSH, yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat Pengaturan terkelola Desktop.
• Pemilih model di claude.ai dan di aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar izin organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; penegakan terjadi dalam sesi.

Perilaku model default

Dengan sendirinya, availableModels meninggalkan opsi Default pada default runtime sistem untuk akun sampai Anda juga menetapkan enforceAvailableModels. Jika default itu adalah model yang ingin Anda batasi, atur enforceAvailableModels juga.

Array availableModels kosong tidak pernah melibatkan penegakan model Default: dengan availableModels: [], pemilihan model bernama diblokir tetapi model Default untuk tipe akun tetap dapat digunakan terlepas dari enforceAvailableModels.

Berlakukan daftar izin untuk model Default

Atur enforceAvailableModels: true bersama dengan availableModels yang tidak kosong dalam pengaturan terkelola untuk memperluas daftar izin ke opsi Default. Ini memerlukan Claude Code v2.1.175 atau lebih baru.

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

Opsi Default diselesaikan ke default tipe akun, atau ke model default organisasi ketika admin telah menetapkan satu. Ketika model itu tidak dalam daftar izin, opsi Default malah diselesaikan ke entri availableModels pertama yang menyebutkan model yang diizinkan dan tersedia, dan baris Default pemilih /model menunjukkan model itu. Ini berlaku di mana pun default dicapai: startup sesi, memilih Default di /model, kata kunci "default" dalam rantai model fallback, dan fallback yang digunakan ketika pemilihan yang dikecualikan dijatuhkan.

enforceAvailableModels memetakan ulang opsi Default hanya ketika availableModels tidak kosong. Dengan availableModels: [], model Default untuk tipe akun tetap dapat digunakan, jadi pengaturan tidak dapat mengunci pengguna dari setiap model. Ketika availableModels tidak kosong tetapi tidak ada entri yang diselesaikan ke model yang diizinkan dan tersedia, penegakan dilewati dan Default diselesaikan ke default tipe akun, dengan peringatan yang terlihat hanya di bawah --debug. Pertahankan setidaknya satu entri yang dijamin tersedia dalam daftar untuk menghindari ini.

Gunakan kedua kunci bersama dalam sumber terkelola dengan peringkat tertinggi yang Anda kirimkan. Secara default Claude Code hanya membaca sumber itu, jadi pasangan yang ditempatkan dalam file pengaturan terkelola diabaikan ketika konsol admin mengirimkan pengaturan apa pun; di bawah penggabungan opt-in dalam bagaimana Claude Code menggabungkan sumber terkelola, Claude Code masih mengabaikan peta modelOverrides dari sumber yang diperingkat di bawah yang menetapkan availableModels.

Kontrol model yang dijalankan pengguna

Pengaturan model adalah pemilihan awal, bukan penegakan. Ini menetapkan model mana yang aktif ketika sesi dimulai, tetapi pengguna masih dapat membuka /model dan memilih Default, yang diselesaikan ke default runtime sistem terlepas dari apa yang model diatur, kecuali enforceAvailableModels mengarahkan ulangnya.

Untuk sepenuhnya mengontrol pengalaman model, gabungkan pengaturan ini:

• availableModels: membatasi model bernama mana yang dapat dialihkan pengguna
• enforceAvailableModels: memperluas daftar izin availableModels ke opsi Default, jadi Default tidak dapat diselesaikan ke model di luar daftar
• model: menetapkan pemilihan model awal ketika sesi dimulai
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: mengontrol apa yang alias sonnet, opus, haiku, dan fable diselesaikan, dan versi mana yang default tipe akun gunakan

Contoh ini memulai pengguna di Sonnet 4.5, membatasi pemilih ke Sonnet dan Haiku, dan memastikan Default diselesaikan ke model dalam daftar izin daripada default tier:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Tanpa enforceAvailableModels atau blok env, pengguna yang memilih Default dalam pemilih mendapatkan default runtime daripada versi yang disematkan dalam model. Dua pengaturan mencakup cakupan berbeda: enforceAvailableModels membuat Default mematuhi daftar izin, sementara blok env menyematkan versi mana alias yang diizinkan seperti sonnet diselesaikan. Gunakan enforceAvailableModels saja ketika membatasi keluarga model cukup; tambahkan blok env ketika Anda juga perlu menyematkan versi tertentu.

Perilaku penggabungan

Ketika pengaturan terkelola yang Claude Code terapkan mendefinisikan availableModels, daftar itu saja berlaku, terlepas dari platform host yang menyediakan miliknya sendiri: entri dalam pengaturan pengguna, proyek, atau lokal tidak dapat memperpanjangnya, dan Claude Code tidak pernah menggabungkan availableModels di seluruh sumber terkelola; bagaimana Claude Code menggabungkan sumber terkelola mengatakan daftar sumber mana yang berlaku. Jika tidak, daftar dari pengaturan pengguna, proyek, dan lokal digabungkan dan dideduplikasi seperti pengaturan array lainnya. Sebelum Claude Code v2.1.175, entri dari cakupan prioritas lebih rendah digabungkan ke dalam daftar terkelola daripada diganti olehnya.

Dalam daftar efektif, entri yang menyebutkan model tertentu dalam keluarga, baik awalan versi atau ID model lengkap, menonaktifkan entri wildcard keluarga itu: ["sonnet", "claude-sonnet-4-5"] memungkinkan hanya versi Sonnet 4.5, bukan setiap model Sonnet.

ID model Mantle

Ketika titik akhir Amazon Bedrock Mantle diaktifkan, entri dalam availableModels yang dimulai dengan anthropic. ditambahkan ke pemilih /model sebagai opsi khusus dan dialihkan ke titik akhir Mantle. Ini adalah pengecualian untuk pencocokan alias yang dijelaskan dalam Sematkan model untuk penyebaran pihak ketiga. Pengaturan masih membatasi pemilih ke entri yang terdaftar, dan ID Mantle menyematkan nama keluarga, jadi itu dihitung sebagai entri tertentu dan menonaktifkan wildcard keluarga itu: bersama ID Mantle apa pun, daftarkan awalan versi atau ID lengkap yang ingin Anda pertahankan dapat dipilih. Lihat Perilaku penggabungan.

Pembatasan model organisasi

Admin organisasi pada rencana Claude Enterprise membatasi model mana yang dapat dijalankan anggota dengan menonaktifkan model individual dalam konsol admin claude.ai. Pembatasan ini dikirimkan dengan hak akses akun ketika Claude Code mengautentikasi, terpisah dari daftar availableModels apa pun dalam pengaturan, dan server memberlakukan pembatasan yang sama secara independen ketika sesi dibuat. Memerlukan Claude Code v2.1.187 atau lebih baru.

Pembatasan berlaku ketika anggota masuk atau menggunakan kunci API mereka sendiri. Kredensial yang dicakup organisasi, seperti kunci layanan organisasi, tidak terikat pada pengguna, jadi pembatasan tidak berlaku untuk mereka.

Claude Console tidak memiliki kontrol pembatasan model. Organisasi tanpa rencana Claude Enterprise, termasuk yang anggotanya mengautentikasi melalui Anthropic API, membatasi model dengan availableModels dalam pengaturan terkelola, menambahkan enforceAvailableModels untuk mencakup opsi Default. Cakupan permukaan mengatakan bagaimana setiap permukaan menerima dan memberlakukan pengaturan ini.

Model yang dibatasi disembunyikan dari pemilih /model. Memilihnya berdasarkan nama dengan --model, variabel lingkungan ANTHROPIC_MODEL, atau pengaturan model menunjukkan pemberitahuan Model "<name>" is restricted by your organization's settings. Using <model> instead. dan sesi dimulai pada model yang diizinkan. Mengetik /model <name> untuk model yang dibatasi ditolak dengan Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. dan sesi mempertahankan model saat ini.

Alias keluarga model seperti opus diselesaikan ke model biasanya ketika organisasi memungkinkannya. Ketika organisasi membatasi model itu, Claude Code mengganti versi terbaru keluarga yang organisasi izinkan, dengan pemberitahuan substitusi yang sama. /model <alias> ditolak hanya ketika setiap versi keluarganya dibatasi; alias yang diatur dengan --model, ANTHROPIC_MODEL, atau pengaturan model masih diganti saat startup dalam hal itu. Sebelum v2.1.205, alias keluarga diganti atau ditolak berdasarkan versi rilis terbarunya saja, bahkan ketika versi yang lebih lama diizinkan.

Pembatasan berlaku di seluruh organisasi atau per peran:

• Menonaktifkan model di tingkat organisasi menghapusnya untuk setiap anggota.
• Akses tingkat peran memberikan model berbeda ke peran khusus yang berbeda, dan anggota yang memiliki beberapa peran dapat menggunakan model apa pun yang salah satu peran mereka berikan.
• Model Haiku selalu tersedia dan tidak dapat dinonaktifkan, jadi setiap anggota mempertahankan setidaknya satu model yang dapat digunakan.
• Perubahan akses berlaku di seluruh organisasi dalam waktu sekitar satu menit; pemilih /model mencerminkannya saat sesi berikutnya dimulai.

Kedua pembatasan berlaku bersama: model dapat dipilih hanya ketika diizinkan oleh availableModels dan tidak dibatasi oleh organisasi. Pembatasan organisasi mencapai sesi pada Anthropic API dan penyebaran gateway LLM saja; pada penyedia lain apa pun, gunakan availableModels.

Model default organisasi

Admin organisasi pada paket Claude Enterprise dapat menetapkan model default untuk anggota Claude Code dari konsol admin claude.ai, untuk seluruh organisasi atau per peran kustom. Ketika satu ditetapkan, opsi Default akan diselesaikan ke model tersebut. Memerlukan Claude Code v2.1.196 atau lebih baru.

Baris Default dalam pemilih /model menampilkan nama default organisasi dengan label Org default. Label membaca Org default apakah admin menetapkan default untuk seluruh organisasi atau untuk peran Anda. Default peran mencakup anggota peran kustom tersebut dan mengambil alih dari default organisasi-lebar; ketika beberapa peran Anda menetapkan default yang berbeda, model yang paling mampu diterapkan.

Default organisasi adalah titik awal, bukan pembatasan. Pilihan-pilihan ini mengambil alih darinya:

• bendera --model dan variabel lingkungan ANTHROPIC_MODEL
• nilai model dalam pengaturan terkelola atau disediakan melalui --settings
• nilai model dalam pengaturan pengguna, proyek, atau lokal Anda, termasuk model yang Anda simpan dengan /model

Admin juga dapat mengonfigurasi default organisasi untuk mengganti pilihan pengguna. Dengan override aktif, ini mengambil alih dari nilai model dalam pengaturan pengguna, proyek, dan lokal, sehingga model yang Anda simpan dengan /model berlaku untuk sesi saat ini dan default organisasi kembali pada peluncuran berikutnya. Ketika pilihan Anda berbeda, /model menampilkan Your organization's default (<model>) applies on restart. Bendera --model, ANTHROPIC_MODEL, pengaturan terkelola, dan --settings masih mengambil alih bahkan dengan override aktif. Override tersedia untuk serangkaian organisasi terbatas; tanyakan kepada tim akun Anthropic Anda tentang ketersediaan.

Untuk membatasi model mana yang dapat dipilih anggota, gunakan pembatasan model organisasi atau availableModels sebagai gantinya.

Claude Code membaca default organisasi sekali saat startup, jadi default yang diubah admin di tengah-sesi berlaku pada peluncuran berikutnya.

Ketika default organisasi tidak mengganti pilihan pengguna, peluncuran interaktif pertama setelah admin mengubahnya menghapus kunci model dari pengaturan pengguna Anda sekali, sehingga default baru berlaku. Ini tidak mengubah apa pun di file, dan model yang Anda simpan dengan /model setelah peluncuran itu disimpan.

Default organisasi melewati pemeriksaan pembatasan ini sebelum diadopsi:

• availableModels sendiri tidak berlaku untuk default organisasi, jadi default organisasi di luar daftar izin masih berlaku. Ketika enforceAvailableModels juga diatur, default organisasi di luar daftar izin dipetakan ulang ke entri daftar izin pertama, seperti Default lainnya
• default organisasi yang pembatasan model organisasi tolak untuk akun Anda diganti dengan model terbaru yang diizinkan dalam keluarganya, atau keluarga biaya lebih rendah ketika setiap versinya dibatasi
• default organisasi yang tidak tersedia untuk akun Anda sama sekali dilewati, dan opsi Default diselesaikan seperti yang akan terjadi tanpa default organisasi

Mulai dari v2.1.199, ketika default organisasi adalah keluarga model yang berbeda dari default biasa tipe akun Anda, pemilih /model menyimpan baris terpisah untuk keluarga biasa itu, sehingga Anda masih dapat beralih ke itu untuk sesi. Dalam v2.1.196 hingga v2.1.198 baris itu hilang dari pemilih.

Default organisasi hanya mencapai sesi yang diautentikasi dengan API Anthropic. Untuk menetapkan default di tempat lain, termasuk penyebaran LLM gateway, gunakan kunci model dalam pengaturan terkelola sebagai gantinya.

Batas upaya organisasi

Organisasi Anda dapat membatasi tingkat upaya dengan dua cara. Pada paket Claude Enterprise, admin organisasi menetapkan batas upaya per peran, dijelaskan di bawah. Pada paket apa pun dan penyedia apa pun, termasuk Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, pengaturan terkelola maxEffortLevel membatasi upaya pada klien sebagai gantinya. Ketika keduanya berlaku untuk model, batas yang lebih rendah diterapkan.

Admin organisasi pada paket Claude Enterprise dapat menetapkan tingkat upaya maksimum per model untuk setiap peran kustom, bersama dengan pembatasan model organisasi tingkat peran. Level di atas batas tidak ditawarkan dalam pemilih /effort, dan menamai level yang lebih tinggi dengan --effort atau /effort berjalan pada batas sebagai gantinya. Dalam sesi interaktif dan --print teks biasa, peringatan menyebutkan level yang diminta dan diterapkan; dengan output json atau stream-json atau dalam agen latar belakang, penjepit diterapkan secara diam-diam. Batas adalah per model, jadi beralih model dapat mengubah level mana yang tersedia. Ketika beberapa peran Anda memberikan model yang sama, batas paling tidak ketat berlaku. Memerlukan Claude Code v2.1.195 atau lebih baru.

Batas upaya disampaikan bersama dengan pembatasan model organisasi dan mencapai sesi yang sama.

Perilaku model khusus

Pengaturan model `default`

Perilaku default tergantung pada jenis akun Anda:

• Max, Team Premium, Enterprise, dan Anthropic API: default ke Opus 5
• Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform: default ke Opus 5
• Pro dan Team Standard: default ke Sonnet 5
• Microsoft Foundry: default ke Sonnet 4.5

Sebelum v2.1.219, default diselesaikan ke Opus 4.8 pada Anthropic API, Max, Team Premium, dan Enterprise pay-as-you-go dari v2.1.154, dan pada Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform dari v2.1.207. Sebelum v2.1.207, default diselesaikan ke Opus 4.7 pada Claude Platform on AWS dan ke Sonnet 4.5 pada Amazon Bedrock dan Google Cloud's Agent Platform.

Ketika admin telah menetapkan model default organisasi, default diselesaikan ke model tersebut alih-alih default jenis akun di atas. Memerlukan Claude Code v2.1.196 atau lebih baru. default juga dapat diselesaikan ke model yang Anda atur dengan ANTHROPIC_DEFAULT_MODEL, di bawah kondisi yang tercantum di bagiannya.

Ketika pengaturan terkelola memberlakukan daftar yang diizinkan untuk model Default dan default jenis akun tidak ada dalam availableModels, default diselesaikan ke Default yang diberlakukan alih-alih default jenis akun di atas. Ketika keduanya berlaku, default organisasi menggantikan default jenis akun terlebih dahulu dan penegakan kemudian diterapkan padanya: default organisasi yang terdaftar dipertahankan, sementara yang di luar daftar diselesaikan ke Default yang diberlakukan.

Model Fable bukan default jenis akun pada paket atau penyedia apa pun. Memilih salah satu dengan /model menyimpannya sebagai model yang dipilih dalam pengaturan pengguna Anda, sehingga sesi berikutnya dimulai padanya. Untuk perubahan satu kali yang Claude Code buat pada pilihan Fable 5 yang disimpan di v2.1.257, lihat Bekerja dengan Fable.

Pengaturan model `opusplan`

Alias model opusplan menyediakan pendekatan hibrida otomatis:

• Dalam plan mode: menggunakan opus untuk penalaran kompleks dan keputusan arsitektur
• Dalam execution mode: secara otomatis beralih ke sonnet untuk pembuatan kode dan implementasi

Ini menggabungkan penalaran Opus untuk perencanaan dengan efisiensi Sonnet untuk eksekusi.

Fase Opus plan-mode menggunakan jendela konteks yang sama dengan pengaturan model opus, dan fase eksekusi menggunakan jendela yang sama dengan sonnet. Ketika opus dan sonnet diselesaikan ke model yang berjalan dengan jendela konteks 1M secara default, seperti model saat ini pada Anthropic API, kedua fase berjalan dengannya. Untuk meminta konteks 1M untuk kedua fase di mana mereka tidak, atur model ke opusplan[1m], misalnya dengan /model opusplan[1m]. Menetapkannya dengan /model memerlukan Claude Code v2.1.265 atau lebih baru; pada versi sebelumnya, gunakan flag --model atau pengaturan model sebagai gantinya.

Ketika availableModels mengecualikan Opus terbaru tetapi mengizinkan versi yang lebih lama, misalnya ["sonnet", "claude-opus-4-6"], opusplan menggunakan Opus terbaru yang diizinkan untuk perencanaan dan tetap pada Sonnet hanya ketika setiap Opus dikecualikan. Sesi Haiku yang biasanya akan ditingkatkan ke Sonnet dalam plan mode juga menggunakan Sonnet terbaru yang diizinkan, dan tetap pada Haiku hanya ketika setiap Sonnet dikecualikan. Sebelum v2.1.205, plan mode tetap pada model sesi kapan pun versi terbaru dari keluarga upgrade dikecualikan, bahkan ketika daftar yang diizinkan mengizinkan yang lebih lama.

Substitusi versi yang lebih lama yang diizinkan berlaku pada Anthropic API dan Claude Platform on AWS. Pada Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan Mantle, yang penerapannya menggunakan ID model khusus penyedia, plan mode tetap pada model sesi kapan pun model upgrade dikecualikan.

Untuk pendekatan hibrida di mana Claude memutuskan di tengah-tugas kapan harus berkonsultasi dengan model kedua daripada beralih di batas rencana, lihat alat advisor.

Rantai model fallback

Ketika model utama kelebihan beban, tidak tersedia, atau mengembalikan kesalahan server non-retryable lainnya, Claude Code dapat beralih ke model fallback alih-alih gagal permintaan. Kesalahan autentikasi, penagihan, rate-limit, ukuran permintaan, dan transportasi, serta penolakan oleh pemeriksaan kebijakan organisasi Anda, tidak pernah memicu switch; mereka mengikuti penanganan retry dan error normal mereka.

Konfigurasikan satu atau lebih model fallback dan Claude Code mencobanya secara berurutan, menampilkan pemberitahuan saat beralih. Switch berlangsung untuk giliran saat ini saja, jadi pesan berikutnya Anda mencoba model utama terlebih dahulu lagi. Claude Code membatasi rantai pada tiga model setelah penghapusan duplikat dan mengabaikan entri tambahan.

Atur rantai untuk satu sesi dengan flag --fallback-model, yang menerima daftar yang dipisahkan koma:

claude --fallback-model sonnet,haiku

Untuk mempertahankan rantai di seluruh sesi, atur fallbackModel dalam settings sebagai array:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Flag --fallback-model mengambil alih pengaturan fallbackModel. Setiap entri menerima nama model atau alias, dan "default" berkembang ke model default.

Claude Code tidak mengkonfirmasi rantai saat startup dan /status tidak menampilkannya. Pemberitahuan yang ditampilkan saat switch terjadi adalah tanda pertama yang terlihat bahwa fallback dikonfigurasi.

Ketika permintaan gagal, Claude Code mencoba setiap entri secara berurutan sampai salah satu menerimanya. Entri yang juga tidak dapat dijangkau, seperti model yang pensiun yang disematkan dalam pengaturan, gagal ke entri berikutnya dengan cara yang sama. Claude Code menghapus dua jenis entri sebelum walk itu dimulai:

• Di luar daftar yang diizinkan: Claude Code menghapus entri apa pun yang tidak diizinkan oleh availableModels saat membaca rantai.
• Jendela konteks lebih kecil selama compaction: rantai juga mencakup compaction, tetapi Claude Code tidak akan fallback ke model dengan jendela konteks lebih kecil dari model utama, karena merangkum di sana akan memotong bagian percakapan terlebih dahulu. Jika setiap fallback lebih kecil, compaction menampilkan error asli dan Anda dapat mencoba lagi.

Claude Code juga menerapkan rantai ke subagents. Ketika permintaan subagent gagal, Claude Code mencoba model fallback yang dikonfigurasi secara berurutan, dan subagent melanjutkan pada model yang menerima permintaan. Model sesi Anda tidak berubah. Sebelum v2.1.247, kegagalan yang rantai tutupi mengakhiri subagent.

Fallback model otomatis

Bagian ini mencakup fallback berbasis konten dari model Fable dan Opus 5. Untuk fallback berbasis ketersediaan ketika model kelebihan beban atau tidak tersedia, lihat Rantai model fallback.

Model Fable dan Opus 5 berjalan dengan pengklasifikasi keamanan, yang paling sering menandai konten keamanan siber dan biologi. Ketika pengklasifikasi menandai permintaan dan kategori yang ditandai memiliki model fallback, Claude Code menjalankan kembali permintaan pada model tersebut dan menampilkan pemberitahuan dalam transkrip. Untuk dua kategori tersebut, model fallback tergantung pada model mana yang menolak:

• Fable 5.1 dan Fable 5: permintaan yang ditandai biologi dijalankan kembali pada Opus 5, dan permintaan yang ditandai keamanan siber dijalankan kembali pada Opus 4.8.
• Opus 5: permintaan yang ditandai keamanan siber dijalankan kembali pada Opus 4.8. Permintaan yang ditandai biologi berakhir dengan penolakan, karena Opus 5 menjalankan pengklasifikasi biologi sendiri tanpa model fallback.

Pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, Claude Code menyelesaikan target ini melalui penerapan Anda, dan jika Anda menetapkan ANTHROPIC_DEFAULT_OPUS_MODEL, kategori yang memiliki fallback dijalankan kembali pada model yang disematkan; lihat Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry.

Setelah fallback, sesi berlanjut pada model fallback. Untuk kembali ke model asli Anda, jalankan /model.

Fallback berbasis kategori memerlukan Claude Code v2.1.219 atau lebih baru. Sebelum v2.1.219, setiap permintaan Fable 5 yang ditandai dijalankan kembali pada model Opus default penyedia Anda, dan Opus 5 bukan sumber fallback.

Model fallback diperiksa terhadap availableModels. Ketika diblokir, tidak ada fallback yang terjadi. Penolakan ditampilkan sebagai error normal dan model sesi tidak berubah.

Periksa apa yang memicu fallback

Fallback dapat memicu pada permintaan pertama sesi, sebelum Anda mengirim apa pun yang tidak biasa, karena permintaan pertama membawa konteks ruang kerja seperti konten CLAUDE.md dan status git Anda. Repositori yang berisi materi keamanan atau biologi dapat memicu pengklasifikasi pada konteks itu saja.

Untuk memeriksa apakah kustomisasi adalah pemicunya, mulai sesi dengan claude --safe-mode, yang menonaktifkan kustomisasi seperti CLAUDE.md, skills, server MCP, dan hooks. Status git dan nama direktori bukan kustomisasi dan masih disertakan.

Tanyakan sebelum beralih

Untuk memutuskan apa yang terjadi setiap kali permintaan ditandai, daripada beralih secara otomatis, jalankan /config dan matikan Switch models when a message is flagged, atau atur switchModelsOnFlag ke false dalam file pengaturan Anda. Permintaan yang ditandai kemudian menjeda sesi dengan dua opsi: beralih ke model fallback, atau edit prompt dan coba lagi pada model saat ini.

Beberapa kasus berperilaku berbeda:

• Ketika kategori yang ditandai tidak memiliki model fallback, seperti flag biologi pada Opus 5, Claude Code tidak menampilkan prompt dan permintaan berakhir dengan penolakan.
• Jika kedua model menandai permintaan yang sama, Anda dapat mengedit prompt dan mencoba lagi, atau memulai sesi baru.
• Pada sesi mobile Claude Code on the web, pengeditan dan pengulangan tidak didukung. Beralih model, atau lanjutkan sesi dari browser desktop atau aplikasi desktop.
• Dalam mode non-interaktif dan integrasi SDK yang tidak dapat menampilkan prompt, permintaan yang ditandai mengakhiri giliran dengan penolakan.
• Ketika target fallback diblokir oleh availableModels, Claude Code tidak menampilkan prompt. Permintaan yang ditandai berakhir dengan penolakan, sama seperti fallback otomatis ketika target diblokir.

Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry

Pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, ID model khusus penyedia, jadi fallback otomatis hanya beroperasi ketika Claude Code dapat mengidentifikasi kedua model yang terlibat:

• Claude Code harus mengenali model saat ini sebagai sumber fallback. Fable 5.1 dan Fable 5 dikenali ketika ID model berisi claude-fable-5, cocok dengan nilai ANTHROPIC_DEFAULT_FABLE_MODEL, atau dipetakan dengan modelOverrides. Opus 5 dikenali oleh ID model penyedianya atau pemetaan modelOverrides.
• Model fallback harus diselesaikan dalam penerapan Anda. Jika Anda menetapkan ANTHROPIC_DEFAULT_OPUS_MODEL, permintaan yang ditandai dijalankan kembali pada model tersebut untuk setiap kategori yang memiliki fallback; flag biologi pada Opus 5 masih berakhir dengan penolakan. Jika Anda tidak menetapkannya, permintaan yang ditandai keamanan siber dijalankan kembali pada entri Opus 4.8 dalam daftar model penyedia, dan permintaan yang ditandai biologi dari model Fable pada entri Opus 5.

Jika salah satu model tidak dapat diidentifikasi, Claude Code tidak beralih secara otomatis. Permintaan yang ditandai berakhir dengan pesan penolakan, dan Anda dapat beralih model dengan /model dan mencoba lagi. Menetapkan ANTHROPIC_DEFAULT_FABLE_MODEL ke ID model Fable Anda memungkinkan pengenalan Fable. Menetapkan ANTHROPIC_DEFAULT_OPUS_MODEL ke ID model Opus memberikan kategori yang ditandai target fallback, kecuali pin menamai model di luar keluarga Opus atau model yang menolak; kemudian Claude Code tidak beralih dan penolakan berdiri.

Penelitian keamanan dan beban kerja biologi

Beban kerja dalam keamanan ofensif atau biologi, termasuk penetration testing, latihan Capture the Flag (CTF), dan codebase yang berdekatan dengan biologi, memicu fallback sering, sering pada permintaan pertama. Untuk pekerjaan biologi substantif pada Fable 5.1 atau Fable 5, Claude Code memindahkan sesi ke Opus 5 pada permintaan pertama yang ditandai, dan permintaan yang ditandai biologi kemudian berakhir dalam penolakan di sana, karena Opus 5 tidak memiliki fallback biologi. Pada Opus 5, Anda mendapatkan penolakan tersebut dari permintaan pertama yang ditandai.

Ini adalah routing yang diharapkan untuk domain ini, bukan flag akun. Jika organisasi Anda memerlukan kemampuan kelas Fable untuk pekerjaan ini, tanyakan kepada tim akun Anthropic Anda tentang program akses terpercaya.

Sesuaikan tingkat usaha

Tingkat usaha mengontrol penalaran adaptif, yang memungkinkan model memutuskan apakah dan berapa banyak untuk berpikir pada setiap langkah berdasarkan kompleksitas tugas. Usaha lebih rendah lebih cepat dan lebih murah untuk tugas-tugas langsung, sementara usaha lebih tinggi memberikan penalaran lebih dalam untuk masalah kompleks.

Tingkat usaha yang tersedia tergantung pada model. Model yang tidak tercantum di sini tidak mendukung usaha:

Jika Anda menetapkan tingkat yang model aktif tidak mendukung, Claude Code kembali ke tingkat tertinggi yang didukung pada atau di bawah yang Anda tetapkan. Misalnya, xhigh berjalan sebagai high pada Opus 4.6. Organisasi Anda juga dapat membatasi tingkat mana yang tersedia untuk model; lihat Batas usaha organisasi.

Dengan pengaturan ultracode mati, Claude Code menyelesaikan tingkat usaha sesi dalam urutan ini, mengambil yang pertama yang berlaku:

1. Pilihan eksplisit: variabel lingkungan CLAUDE_CODE_EFFORT_LEVEL, peluncuran dengan --effort, atau /effort dalam sesi (/effort non-interaktif memiliki efek lebih sempit)
2. Tingkat usaha default model, pada Fable 5, Opus 4.8, atau Opus 4.7: dari pertama kali Anda menjalankan salah satu model ini, Claude Code menyimpan usaha default model tersebut di seluruh sesi, bahkan ketika pengaturan Anda menyelesaikan tingkat berbeda. Opus 5 dan Fable 5.1 tidak memiliki hold seperti itu. Apakah tingkat yang Anda tetapkan mengakhiri hold tergantung pada cara Anda menetapkannya, misalnya:
   • Mengakhiri hold: mengkonfirmasi tingkat secara interaktif, dengan Enter dalam slider /effort atau pengambil /model atau dengan tingkat yang diketik setelah /effort, atau memilih tingkat dari kontrol usaha Remote Control perangkat yang terhubung
   • Meninggalkan hold untuk sesi kemudian: --effort saat peluncuran, atau s dalam slider /effort atau pengambil /model
3. Pengaturan Anda: tingkat yang Anda simpan untuk model atau kunci effortLevel, dengan prioritas di antara mereka dan di seluruh file pengaturan yang dinyatakan pada modelSettings
4. Tingkat usaha default model: high pada setiap model yang mendukung usaha, kecuali Opus 4.7 default ke xhigh dan, ketika organisasi Anda menetapkan tingkat usaha default untuk model default organisasinya, tingkat itu adalah default ketika Anda menjalankan model tersebut

Ketika Anda menetapkan low, medium, high, atau xhigh dalam sesi interaktif pada mesin Anda, Anda memilih berapa lama itu berlangsung dengan cara Anda mengkonfirmasinya:

• Enter dalam slider /effort atau pengambil /model, atau tingkat yang diketik setelah /effort: simpan tingkat sebagai default Anda dan terapkan dalam sesi kemudian
• s dalam slider /effort atau pengambil /model: terapkan tingkat ke sesi ini saja. Memerlukan Claude Code v2.1.257 atau lebih baru

Claude Code menyimpan tingkat per model, di bawah kunci modelSettings dalam pengaturan pengguna Anda, jadi setiap model menyimpan tingkat tersimpannya sendiri.

max adalah tingkat penalaran terdalam. Kecuali Anda menetapkannya melalui variabel lingkungan CLAUDE_CODE_EFFORT_LEVEL, Claude Code menerapkan max ke sesi saat ini saja.

# Gunakan alias opus[1m] atau sonnet[1m]
/model opus[1m]
/model sonnet[1m]

# Atau tambahkan [1m] ke nama model lengkap
/model claude-opus-4-8[1m]

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}