Konfigurasi model

Konfigurasikan model mana yang digunakan Claude Code, tingkat upaya, konteks yang diperluas, dan jendela auto-compact

Model yang tersedia

Untuk pengaturan model di Claude Code, Anda dapat mengonfigurasi salah satu dari:

alias model
nama model
- Anthropic API: nama model lengkap
- Amazon Bedrock: ARN profil inferensi
- Microsoft Foundry: nama deployment
- Google Cloud's Agent Platform: nama versi

Untuk panduan tentang model dan tingkat effort mana yang sesuai untuk berbagai jenis pekerjaan, lihat Memilih model Claude dan tingkat effort di Claude Code di blog.

Alias model

Gunakan alias model untuk memilih pengaturan model tanpa perlu mengingat nomor versi yang tepat:

Alias model	Perilaku
`default`	Nilai khusus yang menghapus override model apa pun dan kembali ke default runtime untuk akun Anda. Bukan sendiri alias model
`best`	Menggunakan model yang diselesaikan oleh alias `fable` di mana Fable tersedia untuk Anda, jika tidak maka model yang sama dengan `opus`
`fable`	Menggunakan model Fable untuk penyedia Anda untuk tugas-tugas tersulit dan paling lama
`sonnet`	Menggunakan model Sonnet terbaru untuk tugas-tugas pengkodean sehari-hari
`opus`	Menggunakan model Opus terbaru untuk tugas-tugas penalaran kompleks
`haiku`	Menggunakan model Haiku yang cepat dan efisien untuk tugas-tugas sederhana
`sonnet[1m]`	Menggunakan Sonnet dengan context window 1 juta token untuk sesi panjang. Tidak berpengaruh ketika `sonnet` sudah menyelesaikan ke Sonnet 5.5 atau Sonnet 5 dengan window 1M aslinya
`opus[1m]`	Menggunakan Opus dengan context window 1 juta token untuk sesi panjang. Tidak berpengaruh ketika `opus` sudah menyelesaikan ke Opus 4.7 atau lebih baru dengan window 1M aslinya
`opusplan`	Mode khusus yang menggunakan `opus` selama plan mode, kemudian beralih ke `sonnet` untuk eksekusi

Alias opus, sonnet, dan haiku diselesaikan ke versi terbaru di Anthropic API dan ke versi yang lebih awal di beberapa penyedia lain:

Penyedia	`opus`	`sonnet`	`haiku`
Anthropic API	Opus 5.5	Sonnet 5.5	Haiku 5.5
Claude Platform on AWS	Opus 5.5	Sonnet 4.6	Haiku 4.5
Amazon Bedrock, Google Cloud's Agent Platform	Opus 5.5	Sonnet 4.5	Haiku 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5	Haiku 4.5

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.

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 opus atau sonnet 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.

Versi sebelumnya menyelesaikan alias ini ke model yang lebih lama. Untuk versi di mana setiap alias berubah, lihat Riwayat versi.

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-5, atau atur environment variable 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, model Fable muncul di pemilih /model kecuali availableModels atau pembatasan model organisasi mengecualikannya. Ketika organisasi Anda tidak dapat menggunakan Fable sama sekali, misalnya di bawah zero data retention, baris tetap di pemilih berwarna abu-abu, dengan catatan tentang alasannya.

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 "Requires usage credits" 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:

Ketika Anda memilih model Fable dengan /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 dari tim agent, 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 sesi aplikasi lain yang dihosting melalui Agent SDK, apakah prompt muncul tergantung pada aplikasi itu. Jika muncul dan tidak ada yang menjawab sebelum batas waktu dialogExpiry yang sama, Claude Code mengakhiri giliran tanpa mengirim permintaan.

Dalam mode non-interaktif dengan flag -p, dan dalam aplikasi Agent SDK yang tidak menampilkan prompt, Claude Code tidak pernah meminta 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:

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 peralihan
Saat startup: luncurkan dengan claude --model <alias|name>
Environment variable: atur ANTHROPIC_MODEL=<alias|name>
Pengaturan: konfigurasi secara permanen di file pengaturan Anda menggunakan bidang model
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 tombol 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.

Di paket Enterprise, ketika Anda masuk dengan akun claude.ai Anda dan menyimpan default dengan /model, Claude Code juga mencatat pilihan di akun itu. Ini memerlukan Claude Code v2.1.280 atau lebih baru.

Ketika admin Anda belum menetapkan model default organisasi, opsi Default dapat diselesaikan ke model yang dicatat, dan ketika itu terjadi, baris Default di pemilih /model menampilkan nama model itu.
Jika pembatasan model mengecualikan model yang dicatat atau tidak tersedia untuk akun Anda, dan admin Anda belum menetapkan model default organisasi, opsi Default diselesaikan seolah-olah tidak ada yang dicatat.
Jika Anda memilih Default atau opusplan di /model, pilihan yang dicatat tidak berubah.

Jika Anda beralih model dengan /model, peralihan juga mencapai subagent yang mewarisi model percakapan utama, karena Claude Code menyelesaikan model mereka dari yang digunakan sesi Anda ketika Claude memulainya. Beralih ke Opus sebelum Claude mendelegasikan penelitian atau test run ke salah satunya, dan pekerjaan itu berjalan di Opus juga. Untuk menjaga subagent kustom di model yang lebih kecil, atur model dalam definisinya.

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 tetap diutamakan dan diterapkan kembali pada peluncuran berikutnya. Model default organisasi yang telah dikonfigurasi admin Anda untuk menimpa 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 environment variable 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 mem-proxy-nya, dan harga di baris adalah harga model yang dipilih baris itu. Di penyedia pihak ketiga seperti Amazon Bedrock dan di Claude apps gateway, penyedia atau gateway Anda menentukan apa yang Anda bayar, jadi baris pemilih tidak menampilkan harga. Harga adalah label tampilan saja; itu tidak memengaruhi 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. Jika model yang dipulihkan telah pensiun atau dikecualikan oleh availableModels, sesi jatuh melalui urutan prioritas normal. 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.

Jika pengaturan model Anda adalah haiku, sesi yang disimpan pada model Haiku dilanjutkan pada model yang saat ini diselesaikan oleh haiku. Misalnya, setelah haiku diselesaikan ke Haiku 5.5, sesi yang disimpan pada Haiku 4.5 dilanjutkan pada Haiku 5.5.

Model yang Anda pilih untuk peluncuran baru dengan --model atau ANTHROPIC_MODEL tetap diutamakan daripada 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 menimpa; 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 diutamakan daripada pengaturan model terkelola, sementara allowlist availableModels terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; Pengecualian untuk prioritas pengaturan terkelola menjelaskan kunci dan variabel mana yang ditimpa host.

Jika Anda atau organisasi Anda mengonfigurasi PreModelSwitch hooks, mereka berjalan sebelum peralihan yang diminta diterapkan dan dapat memblokirnya 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 peralihan daripada menerapkannya tanpa diperiksa, dan itu memeriksa lagi pada setiap upaya baru. Lihat Model switch was blocked by a PreModelSwitch hook untuk pesan dan pemulihan.

Ketika Anda beralih model melalui metode setModel() Agent SDK, melalui aplikasi seperti Desktop app, atau dari perangkat yang terhubung melalui Remote Control, Claude Code memeriksa nilai pada saat peralihan:

Agent SDK atau aplikasi: dengan Claude Code v2.1.268 atau lebih baru, kecuali Claude Code menerima ID model secara lokal, seperti yang dilakukannya untuk opsi model kustom Anda, itu mengonfirmasi ID dengan penyedia Anda pertama kali sesi beralih ke sana. Konfirmasi berjalan di setiap penyedia, dan ID yang tidak ditawarkan penyedia Anda ditolak pada saat peralihan daripada gagal pada permintaan berikutnya Anda.
Remote Control: di Anthropic API, Claude Code memeriksa nilai secara lokal dan tidak mengirim permintaan.

Lihat Model is not a recognized model id dan Model not found untuk pesannya.

Jika Anda menetapkan model dengan flag --model, environment variable ANTHROPIC_MODEL, atau pengaturan model, Claude Code tidak memeriksanya di muka, dan nilai yang salah ketik menghasilkan There's an issue with the selected model pada permintaan pertama.

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 dari hal-hal berikut 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 diutamakan daripada 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
Pembatasan model organisasi Anda 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 membiarkan default yang disimpan tidak berubah.
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 menimpa pilihan pengguna berlaku lagi di setiap peluncuran. Pilihan /model Anda masih disimpan; itu dikalahkan oleh prioritas yang lebih tinggi. Ketika pengaturan proyek atau terkelola menetapkan model, header startup menyebutkan file tersebut.
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 read-only, 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 mempertahankan model yang digunakannya daripada default Anda saat ini.

Batasi pemilihan model

Administrator 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. Untuk memblokir model yang diizinkan daftar, atau untuk membuat setiap entri ID model hanya memungkinkan versi yang dinamainya, lihat Blokir model atau versi tertentu.

Pada platform yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host mengambil alih pengaturan model terkelola, sementara daftar putih 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 putih 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 perintah
Model advisor: pengaturan advisorModel yang dikonfigurasi dan bendera --advisor
Model agent latar belakang: model yang dipilih dalam pemilih dispatch

Pada API Anthropic dan Claude Platform on AWS, alias keluarga model, opus, sonnet, haiku, atau fable, diselesaikan ke model biasanya ketika daftar putih memungkinkan model itu. Ketika daftar putih memblokir model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan daftar putih 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 putih tidak memungkinkan versi 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, oleh fallback ini atau oleh 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 sebagai gantinya. 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 sebagai gantinya
Pengaturan advisorModel: advisor dinonaktifkan untuk sesi
Bendera --advisor: Claude Code keluar dengan kesalahan saat peluncuran. Dalam sesi latar belakang, itu memulai sesi tanpa advisor sebagai gantinya dari keluar

Claude Code menyembunyikan model yang dikecualikan dari pemilih /model. Apakah ID model yang Anda cantumkan juga mendapatkan barisnya sendiri berbeda menurut penyedia:

API Anthropic, Claude Platform on AWS, gateway aplikasi Claude, atau gateway LLM yang diatur melalui ANTHROPIC_BASE_URL: ID model Anthropic yang Anda cantumkan yang tidak memiliki baris pemilih bawaan muncul sebagai baris berlabel sendiri. Claude Code menambahkan baris seperti itu untuk versi Opus, Sonnet, dan Haiku, seperti versi yang lebih lama yang disematkan daftar. Jika Anda mengatur replaceBuiltInOptions dalam lineup modelPicker, baris tersebut tidak muncul. Sebelum v2.1.199, ID seperti itu hanya dapat dipilih dengan mengetik /model <id>.
Amazon Bedrock, Agent Platform Google Cloud, atau Microsoft Foundry: kecuali ID model yang Anda cantumkan dimulai dengan anthropic., Claude Code tidak menambahkan baris untuknya, baik itu ID model Anthropic maupun ID khusus penyedia. ID model Mantle memiliki awalan tersebut. Untuk menampilkan versi yang tercantum yang tidak memiliki baris bawaan, tambahkan juga ke lineup modelPicker, yang menerima ID dalam format penyedia Anda.

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

Rantai model fallback: entri di luar daftar putih dijatuhkan
Upgrade mode rencana: pada API Anthropic 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 sebagai gantinya
Pengklasifikasi auto mode: default Claude Sonnet 5 untuk pengklasifikasi hanya berlaku ketika allowlist mengizinkan Sonnet 5. Ketika dikecualikan, pengklasifikasi berjalan pada model sesi, yang sudah diatur oleh allowlist, atau pada model Opus ketika sesi berjalan pada model Fable. Pada penyedia selain API Anthropic, fallback Opus tersebut berjalan pada model yang Anda tetapkan dalam ANTHROPIC_DEFAULT_OPUS_MODEL atau, jika tidak, pada Opus 5, tanpa memeriksa allowlist. Memerlukan Claude Code v2.1.210 atau lebih baru
Mode cepat: mengaktifkan mode cepat ditolak ketika model yang akan dijalankan sesi setelahnya berada di luar daftar putih
Fallback ketersediaan pada Amazon Bedrock dan Agent Platform Google Cloud: ketika akun Anda kehilangan akses ke model di tengah sesi, peralihan ke model lain melewati model yang dikecualikan. Pemeriksaan model saat startup pada Amazon Bedrock dan Agent Platform Google Cloud melewati model yang dikecualikan hanya ketika pengaturan terkelola juga menetapkan enforceAvailableModels

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

Cakupan permukaan

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

Mekanisme pengiriman	CLI dan IDE	Sesi lokal desktop	Sesi web, mobile, dan cloud	Agent SDK dan non-interaktif	Cowork
Pengaturan terkelola server dari konsol admin	Diberlakukan	Diberlakukan	Diberlakukan, kecuali dalam sesi Claude Tag	Diberlakukan	Sesi Cowork jarak jauh: server memeriksa model. Di mesin pengguna: tidak dikirimkan.
File MDM atau pengaturan terkelola	Diberlakukan	Diberlakukan	Tidak dikirimkan di lingkungan yang dihosting Anthropic; di lingkungan yang dihosting sendiri, diberlakukan dari gambar runner per bagaimana Claude Code menggabungkan sumber terkelola	Diberlakukan	Diberlakukan di mana diterapkan

Sesi cloud, termasuk yang Anda mulai dari aplikasi Desktop, berjalan pada VM yang dikelola Anthropic secara default: pengaturan yang diterapkan ke perangkat Anda tidak mencapainya, jadi kirimkan daftar putih 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 putih. Ketika daftar availableModels dalam pengaturan terkelola server Anda tidak kosong, server menolak permintaan untuk memulai sesi cloud di claude.ai/code atau dari aplikasi Desktop pada model yang daftar kecualikan.
Sesi Claude Tag berjalan di lingkungan cloud tetapi tidak menerima pengaturan terkelola server; dalam lingkungan yang dihosting sendiri, mereka masih membaca file pengaturan terkelola dalam gambar runner. Untuk menetapkan model untuk sesi tersebut, lihat Pilih model untuk cakupan dalam panduan admin Claude Tag.
Cowork, tab pekerjaan agentic dalam aplikasi Claude Desktop, menjalankan sesinya pada Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. Ketika daftar availableModels dalam pengaturan terkelola server Anda tidak kosong dan pengguna memilih model di luar itu, server menolak model itu untuk sesi Cowork jarak jauh. 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 diterapkan 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 putih melalui file MDM atau pengaturan terkelola di sana.
Pengiriman dari konsol admin juga memerlukan sesi untuk melakukan pengambilan dengan login yang memenuhi syarat ke organisasi Anda atau token OAuth yang diterbitkan untuknya. Untuk armada yang mengautentikasi dengan kunci API, baik yang dikonfigurasi secara langsung maupun yang dihasilkan oleh skrip apiKeyHelper, kirimkan allowlist melalui file MDM atau pengaturan terkelola.
Tab Code Desktop juga menampilkan sesi SSH, yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat Pengaturan terkelola Desktop.
Pemilih model di claude.ai dan dalam aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar putih organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; itu tidak memberlakukan daftar putih.

Perilaku model default

Dengan pencocokan awalan default, availableModels sendiri meninggalkan opsi Default pada default runtime sistem untuk akun sampai Anda juga menetapkan enforceAvailableModels. Jika default itu adalah model yang Anda maksudkan untuk membatasi, atur enforceAvailableModels juga, atau blokir model itu.

Dengan availableModels: [], pemilihan model bernama diblokir dan enforceAvailableModels tidak berpengaruh.

Berlakukan daftar putih untuk model Default

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

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

Untuk anggota tanpa model tercatat di akun mereka, opsi Default diselesaikan ke default tipe akun, atau ke model default organisasi ketika admin telah menetapkan satu. Ketika model itu tidak dalam daftar putih, opsi Default sebagai gantinya 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 dalam /model, kata kunci "default" dalam rantai model fallback, dan fallback yang digunakan ketika pemilihan yang dikecualikan dijatuhkan. Model yang tercatat di akun anggota juga diperiksa terhadap availableModels; Menetapkan model Anda menjelaskan bagaimana opsi Default memperlakukannya.

enforceAvailableModels memetakan ulang opsi Default hanya ketika availableModels tidak kosong. Ketika availableModels tidak kosong tetapi tidak ada entri yang diselesaikan ke model yang diizinkan dan tersedia, penegakan dilewati dengan peringatan yang terlihat hanya di bawah --debug. Pertahankan setidaknya satu entri yang dijamin tersedia dalam daftar untuk menghindari ini.

Terapkan 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 atau kunci yang memblokir versi tertentu berlaku untuk itu.

Untuk sepenuhnya mengontrol pengalaman model, gabungkan pengaturan ini:

availableModels: membatasi model bernama mana yang dapat dialihkan pengguna
enforceAvailableModels: memperluas daftar putih availableModels ke opsi Default, jadi Default tidak dapat diselesaikan ke model di luar daftar
deniedModels dan availableModelsMatch: blokir versi tertentu yang entri availableModels akan memungkinkan sebaliknya
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 diselesaikan alias sonnet, opus, haiku, dan fable, dan versi mana yang digunakan default tipe akun

Contoh ini memulai pengguna pada Sonnet 4.5, membatasi pemilih ke Sonnet dan Haiku, dan memastikan Default diselesaikan ke model dalam daftar putih 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 putih, sementara blok env menyematkan versi mana yang diselesaikan alias yang diizinkan seperti sonnet. Gunakan enforceAvailableModels saja ketika membatasi keluarga model cukup; tambahkan blok env ketika Anda juga perlu menyematkan versi tertentu.

Perilaku penggabungan

Ketika pengaturan terkelola yang diterapkan Claude Code 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 baik; bagaimana Claude Code menggabungkan sumber terkelola mengatakan daftar sumber mana yang berlaku. Jika tidak, daftar dari pengaturan pengguna, proyek, dan lokal adalah digabungkan dan dideduplikasi seperti pengaturan array lainnya. Sebelum Claude Code v2.1.175, entri dari cakupan prioritas lebih rendah digabungkan ke dalam daftar terkelola sebagai gantinya dari 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

Entri dalam availableModels yang dimulai dengan anthropic. ditambahkan ke pemilih /model sebagai opsi kustom. Ini adalah pengecualian untuk pencocokan alias yang dijelaskan dalam Sematkan model untuk deployment pihak ketiga. Dengan endpoint Amazon Bedrock Mantle diaktifkan, Claude Code mengarahkan entri yang cocok dengan format Mantle ke endpoint tersebut. Pengaturan tetap membatasi pemilih ke entri yang tercantum, dan ID Mantle menyematkan nama keluarga, sehingga dihitung sebagai entri tertentu dan menonaktifkan wildcard keluarga itu: bersama dengan ID Mantle apa pun, cantumkan awalan versi atau ID lengkap yang ingin tetap dapat dipilih. Lihat Perilaku penggabungan.

Blokir model atau versi tertentu

Entri availableModels seperti claude-opus-5 juga memungkinkan rilis yang lebih baru yang memperpanjangnya, seperti Opus 5.5, segera setelah Claude Code mendukungnya. Dua pengaturan terkelola memungkinkan Anda menahan rilis, dan keduanya memerlukan Claude Code v2.1.283 atau lebih baru:

deniedModels: daftarkan model yang akan diblokir. Model yang terdaftar diblokir bahkan ketika availableModels memungkinkannya, dan kunci juga bekerja tanpa daftar putih sama sekali. Rilis yang tidak ada entri blok tetap diizinkan
availableModelsMatch: aturnya ke "exact" sehingga setiap ID model dalam availableModels hanya memungkinkan versi yang dinamainya. Versi yang lebih baru dari ID model yang terdaftar kemudian tetap diblokir sampai Anda menambahkannya ke daftar

Versi sebelumnya mengabaikan kedua kunci, jadi juga atur requiredMinimumVersion untuk menjaga versi tersebut agar tidak dimulai.

Contoh ini memungkinkan model Opus dan Sonnet dan memblokir Opus 5.5 dalam setiap ejaan, termasuk ID yang tertanggal dan khusus penyedia:

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

Model yang diblokir, baik deniedModels menyebutkannya atau daftar "exact" menghilangkannya, diperlakukan sebagai pemilihan terblokir di mana pun daftar putih berlaku. Itu disembunyikan dari pemilih /model, dan /model <name> menolaknya. Jika Anda menyebutkan ID model yang diblokir dengan --model, ANTHROPIC_MODEL, atau pengaturan model, Claude Code menjatuhkannya saat startup dan menyelesaikan opsi Default sebagai gantinya. Jika hook atau permintaan latar belakang menyebutkan model yang deniedModels blokir, seperti bidang model hook agent, permintaan itu berjalan pada model sesi sebagai gantinya.

Opsi Default mengikuti kedua kunci juga, baik atau tidak Anda atur enforceAvailableModels. Jika Anda menetapkannya dengan availableModels yang tidak kosong, default yang diblokir dihitung sebagai model di luar daftar putih. Jika tidak, opsi Default yang akan diselesaikan ke model yang diblokir turun dalam urutan ini:

Versi terbaru keluarga yang sama yang diizinkan
Model yang diizinkan terbaru dari setiap keluarga biaya lebih rendah secara bergiliran: Sonnet, kemudian Haiku
Entri availableModels pertama yang menyebutkan model yang diizinkan

Jika tidak ada yang diizinkan, sesi yang dimulai pada opsi Default menolak untuk dimulai dengan kesalahan yang menyebutkan kunci untuk diperbaiki. Daftar "exact" mempengaruhi opsi Default hanya ketika daftar availableModels terkelola menyebutkan setidaknya satu model atau keluarga.

Claude Code membaca kedua kunci dari pengaturan terkelola saja. Jika Anda menetapkan salah satu dalam pengaturan pengguna, proyek, atau lokal atau dengan --settings, Claude Code mengabaikannya dengan peringatan.

Pembatasan model organisasi

Admin organisasi pada paket Claude Enterprise membatasi model mana yang dapat dijalankan anggota dengan menonaktifkan model individual dalam konsol admin claude.ai. Pembatasan ini dikirimkan dengan hak 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 bersifat organisasi, seperti kunci layanan organisasi, tidak terikat pada pengguna, jadi pembatasan tidak berlaku untuk mereka.

Claude Console tidak memiliki kontrol pembatasan model. Organisasi tanpa paket Claude Enterprise, termasuk yang anggotanya mengautentikasi melalui API Anthropic, membatasi model dengan availableModels dalam pengaturan terkelola sebagai gantinya, 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 menyimpan 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 diizinkan organisasi, 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 diizinkan salah satu peran mereka.
Model Haiku selalu tersedia dan tidak dapat dinonaktifkan, jadi setiap anggota menyimpan 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 API Anthropic dan penerapan gateway LLM saja; pada penyedia lain apa pun, gunakan availableModels sebagai gantinya.

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 menimpa pilihan pengguna. Dengan override aktif, ini diutamakan daripada 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. Flag --model, ANTHROPIC_MODEL, pengaturan terkelola, dan --settings tetap diutamakan bahkan dengan override aktif.

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:

Dengan pencocokan awalan default, 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 juga
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
untuk default organisasi yang deniedModels atau daftar "exact" blokir, lihat Blokir model atau versi spesifik
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:

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

Sebelum v2.1.280, default diselesaikan ke Sonnet 5 pada Pro dan Team Standard, dan ke Opus 5 pada Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform dari v2.1.219. 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, atau ke model yang tercatat pada akun Anda.

Ketika tidak ada yang tercatat pada akun Anda, pengaturan terkelola memberlakukan allowlist 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 default organisasi dan penegakan keduanya berlaku, default organisasi menggantikan default jenis akun terlebih dahulu dan penegakan kemudian diterapkan padanya: default organisasi yang ada dalam allowlist 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 context window yang sama dengan pengaturan model opus, dan fase eksekusi menggunakan window yang sama dengan sonnet. Ketika opus dan sonnet diselesaikan ke model yang berjalan dengan context window 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 allowlist 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 deployment-nya 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 tool 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 menggagalkan permintaan. Kesalahan autentikasi, penagihan, rate limit, ukuran permintaan, dan transportasi, serta penolakan oleh pemeriksaan kebijakan organisasi Anda, tidak pernah memicu peralihan; kesalahan tersebut mengikuti penanganan retry dan error normalnya. Claude Code beralih ketika Amazon Bedrock atau Google Cloud's Agent Platform menolak model yang tidak dapat dipanggil oleh akun Anda, yang Claude Code perlakukan sebagai model tidak tersedia daripada sebagai error autentikasi.

Konfigurasikan satu atau lebih model fallback dan Claude Code mencobanya secara berurutan, menampilkan pemberitahuan saat beralih. Peralihan 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 pengaturan sebagai array:

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

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

Claude Code tidak mengonfirmasi rantai saat startup dan /status tidak menampilkannya. Pemberitahuan yang ditampilkan saat peralihan 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 penelusuran itu dimulai:

Di luar allowlist: Claude Code menghapus entri apa pun yang tidak diizinkan oleh availableModels saat membaca rantai.
Context window lebih kecil selama compaction: rantai juga mencakup compaction, tetapi Claude Code tidak akan fallback ke model dengan context window 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 ulang.

Claude Code juga menerapkan rantai ke subagent. 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 dicakup rantai justru mengakhiri subagent.

Fallback model otomatis

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

Model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5 berjalan dengan pengklasifikasi keamanan, yang paling sering menandai konten keamanan siber dan biologi. Untuk dua kategori tersebut, model fallback tergantung pada model mana yang menolak:

Fable 5.1, Fable 5, dan Opus 5.5: permintaan yang ditandai biologi dijalankan kembali pada Opus 5, dan permintaan yang ditandai keamanan siber dijalankan kembali pada Opus 4.8.
Sonnet 5.5: permintaan yang ditandai keamanan siber dijalankan kembali pada Sonnet 5. Permintaan yang ditandai biologi berakhir dengan penolakan, karena Sonnet 5.5 tidak memiliki model fallback biologi.
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 ID model deployment Anda sebagai gantinya. Lihat Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry.

Ketika Claude Code mengalihkan permintaan yang ditandai ke model fallback untuk kategorinya, Claude Code menjalankan kembali permintaan pada model tersebut. Dalam percakapan utama Anda, Claude Code menampilkan pemberitahuan dalam transkrip. Untuk ditanya terlebih dahulu, lihat Tanyakan sebelum beralih.

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.

Tingkat effort setelah fallback

Ketika Claude Code mengalihkan sesi Anda ke model fallback, Claude Code mempertahankan tingkat effort yang digunakan oleh permintaan yang ditandai. Misalnya, sesi pada Opus 5.5 dengan default medium yang fallback ke Opus 4.8 tetap pada medium, meskipun Opus 4.8 default ke high.

Tingkat yang berbeda berlaku dalam kasus seperti berikut:

Perubahan Anda sendiri: setelah Anda memilih tingkat effort, memilih model di /model, atau melanjutkan sesi nanti, tingkat dari permintaan yang ditandai tidak lagi terbawa.
Effort skill: tingkat yang ditetapkan oleh frontmatter effort sebuah skill untuk permintaan yang ditandai berlaku untuk giliran itu, dan giliran berikutnya berjalan pada tingkat yang diberikan urutan resolusi effort untuk model fallback.

Dalam sesi, jalankan /effort status untuk melihat tingkat yang berlaku, atau /effort untuk mengubahnya.

Periksa apa yang memicu fallback

Fallback dapat terpicu pada permintaan pertama sesi, sebelum Anda mengirim apa pun yang tidak biasa, karena permintaan pertama membawa konteks workspace 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, jalankan /config, pilih Switch models when a message is flagged, dan pilih Ask each time. Anda juga dapat mengatur switchModelsOnFlag ke false dalam file pengaturan Anda. Claude Code kemudian berhenti sejenak pada permintaan yang ditandai yang akan mengalihkan model dan memberi Anda dua opsi: beralih ke model fallback, atau edit prompt dan coba lagi.

Pertama kali permintaan yang ditandai akan mengalihkan model dalam sesi interaktif, Claude Code mungkin bertanya apakah akan beralih secara otomatis sejak saat itu. Claude Code hanya bertanya jika Anda belum menetapkan switchModelsOnFlag, dan menyimpan pilihan Anda sebagai kunci tersebut dalam pengaturan pengguna Anda.

Jika Anda memilih untuk tetap pada model saat ini, nilai yang disimpan adalah false, sama seperti Ask each time. Jika Anda menutup pertanyaan tersebut, Claude Code tidak menyimpan apa pun dan bertanya lagi saat berikutnya permintaan yang ditandai akan mengalihkan model.

Ketika Anda telah memilih Ask each time, beberapa kasus berperilaku berbeda:

Ketika kategori yang ditandai tidak memiliki model fallback, seperti flag biologi pada Opus 5 atau Sonnet 5.5, Claude Code tidak menampilkan prompt dan permintaan berakhir dengan penolakan.
Jika kedua model menandai permintaan yang sama, Anda dapat mengedit prompt dan mencoba ulang, atau memulai sesi baru.
Pada sesi cloud di aplikasi mobile, mengedit dan mencoba ulang 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.
Dalam subagent, Claude Code tidak menampilkan prompt, dan permintaan yang ditandai yang akan mengalihkan model dijalankan kembali pada model fallback.
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 bersifat khusus penyedia, jadi fallback otomatis hanya beroperasi ketika Claude Code dapat mengidentifikasi setiap 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.5, Sonnet 5.5, dan Opus 5 dikenali oleh ID model penyedianya atau pemetaan modelOverrides.
Target Opus harus diselesaikan dalam deployment Anda, model mana pun yang menolak: atur ANTHROPIC_DEFAULT_OPUS_MODEL, atau simpan entri Opus 4.8 dalam daftar model penyedia. Tanpa salah satunya, fallback tetap mati untuk setiap model sumber, termasuk Sonnet 5.5, dan permintaan yang ditandai berakhir dengan penolakan.
Model fallback kategori yang ditandai harus diselesaikan dalam deployment Anda. Dari model Fable, Opus 5.5, atau Opus 5, 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, dan permintaan yang ditandai biologi dari model Fable atau Opus 5.5 pada entri Opus 5. Dari Sonnet 5.5, permintaan yang ditandai keamanan siber dijalankan kembali pada model yang Anda atur dalam ANTHROPIC_DEFAULT_SONNET_MODEL, atau pada entri Sonnet 5 dalam daftar model penyedia jika Anda tidak menetapkannya.

Jika salah satu model tidak dapat diidentifikasi, Claude Code tidak beralih. Permintaan yang ditandai berakhir dengan pesan penolakan, dan Anda dapat beralih model dengan /model dan mencoba ulang. Untuk membuat kedua model dapat diidentifikasi, atur pin untuk model sumber Anda:

Model Fable: atur ANTHROPIC_DEFAULT_FABLE_MODEL ke ID model Fable Anda sehingga Claude Code mengenalinya sebagai sumber fallback.
Setiap model sumber: atur ANTHROPIC_DEFAULT_OPUS_MODEL ke ID model Opus untuk mengaktifkan fallback dan memberikan target bagi kategori yang ditandai. Pin yang menamai model di luar keluarga Opus, atau model yang menolak, membiarkan penolakan tetap berlaku.
Sonnet 5.5: selain pin Opus, atur ANTHROPIC_DEFAULT_SONNET_MODEL atau simpan entri Sonnet 5 dalam daftar model penyedia untuk menyediakan model tempat permintaan dijalankan kembali. Pin Sonnet yang menamai model di luar keluarga Sonnet, atau Sonnet 5.5 itu sendiri, membiarkan penolakan tetap berlaku.

Model fallback juga harus memiliki context window setidaknya sebesar context window sesi, atau Claude Code tidak beralih dan permintaan yang ditandai berakhir dengan penolakan yang sama. Pada penyedia ini, model sumber berjalan dengan context window 1M secara default. Sematkan model yang juga demikian, seperti Opus 4.8 dalam ANTHROPIC_DEFAULT_OPUS_MODEL atau Sonnet 5 dalam ANTHROPIC_DEFAULT_SONNET_MODEL, dengan ID yang dapat dicocokkan Claude Code dengan model tersebut.

Penelitian keamanan dan beban kerja biologi

Beban kerja dalam keamanan ofensif atau biologi, termasuk penetration testing, latihan Capture the Flag (CTF), dan codebase yang berkaitan dengan biologi, sering memicu fallback, sering kali pada permintaan pertama. Untuk pekerjaan biologi substantif pada Fable 5.1, Fable 5, atau Opus 5.5, permintaan pertama yang ditandai yang mengalihkan model memindahkan sesi ke Opus 5, dan permintaan yang ditandai biologi berikutnya berakhir dengan penolakan di sana, karena Opus 5 tidak memiliki fallback biologi. Pada Opus 5 dan Sonnet 5.5, Anda mendapatkan penolakan tersebut sejak 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 effort

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

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

Model	Tingkat
Fable 5.1 dan Fable 5	`low`, `medium`, `high`, `xhigh`, `max`
Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8, dan Opus 4.7	`low`, `medium`, `high`, `xhigh`, `max`
Opus 4.6 dan Sonnet 4.6	`low`, `medium`, `high`, `max`

Jika Anda menetapkan tingkat yang tidak didukung model aktif, 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 atau pengaturan Anda sendiri juga dapat membatasi tingkat yang ditawarkan model; lihat Batas effort organisasi.

Claude Code menyelesaikan tingkat effort sesi dalam urutan ini, mengambil yang pertama yang berlaku:

Pilihan eksplisit: environment variable CLAUDE_CODE_EFFORT_LEVEL, peluncuran dengan --effort, atau /effort dalam sesi (/effort non-interaktif memiliki efek lebih sempit)
Pengaturan Anda: tingkat yang Anda simpan untuk model atau kunci effortLevel, dengan prioritas di antara keduanya dan di seluruh file pengaturan yang dinyatakan pada modelSettings
Effort default model: high pada setiap model yang mendukung effort, kecuali Opus 5.5, Sonnet 5.5, dan Haiku 5.5 default ke medium, Opus 4.7 default ke xhigh, dan, ketika organisasi Anda menetapkan tingkat effort default untuk model default organisasinya, tingkat itu adalah default ketika Anda menjalankan model tersebut

Setelah fallback model otomatis, lihat Tingkat effort setelah fallback untuk tingkat yang berlaku.

Opus 5.5 dimulai pada medium kecuali salah satu sumber di atas menetapkan tingkat untuknya, dan effortLevel tingkat atas dalam file pengaturan pengguna Anda tidak dihitung untuk Opus 5.5. Kunci itu adalah bentuk lama yang ditulis /effort sebelum Claude Code menyimpan tingkat per model: kunci itu terus berlaku di tempat ia berlaku sebelumnya, pada Opus 5, Fable 5.1, dan model sebelumnya, sementara Opus 5.5 dan model yang dirilis setelahnya dimulai pada default mereka sendiri sampai Anda memilih tingkat untuk mereka dengan /effort atau pemilih /model. effortLevel tingkat atas dalam pengaturan proyek, lokal, atau terkelola, atau yang diteruskan dengan --settings, berlaku untuk setiap model.

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

Enter dalam slider /effort atau pemilih /model, atau tingkat yang diketik setelah /effort: simpan tingkat sebagai default Anda dan terapkan dalam sesi berikutnya
s dalam slider /effort atau pemilih /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 environment variable CLAUDE_CODE_EFFORT_LEVEL, Claude Code menerapkan max ke sesi saat ini saja.

Ketika Anda menetapkan tingkat dengan /effort dalam run -p, Claude Code menerapkannya ke sesi itu saja dan tidak menyimpannya sebagai default Anda.

Slider /effort juga memiliki toggle Ultracode. Ultracode adalah pengaturan Claude Code, bukan tingkat effort model: ketika aktif, Claude mengorkestrasi alur kerja dinamis untuk tugas-tugas substantif, pada tingkat effort apa pun sesi berjalan. Untuk tempat pengaturan ini dapat ditetapkan secara persisten, lihat pengaturan ultracode.

Mengaktifkan atau menonaktifkan ultracode dengan /effort atau pengaturan ultracode membiarkan tingkat effort tidak berubah. Flag --effort ultracode dan nilai Agent SDK effortLevel: "ultracode" mengaktifkannya dan juga menetapkan tingkat ke xhigh. Memilih tingkat dalam slider /effort atau pemilih /model membiarkan ultracode seperti semula.

Anda dapat mengaktifkan ultracode melalui salah satu dari berikut ini:

/effort: jalankan /effort ultracode untuk mengaktifkannya untuk sesi saat ini atau /effort ultracode off untuk menonaktifkannya. Dalam slider /effort, tekan Tab untuk membalik toggle Ultracode, kemudian Enter untuk menerapkannya
Flag --effort: luncurkan dengan claude --effort ultracode, yang memulai sesi pada effort xhigh dengan ultracode aktif
Pengaturan ultracode: atur "ultracode": true dalam file pengaturan, dengan --settings, atau dalam permintaan kontrol Agent SDK. Permintaan applyFlagSettings() juga menerima effortLevel: "ultracode", yang mengaktifkannya dan menetapkan tingkat effort ke xhigh

Bentuk /effort ultracode off, toggle slider, dan menjaga ultracode aktif pada tingkat effort selain xhigh memerlukan Claude Code v2.1.284 atau lebih baru. Sebelum v2.1.284, mengaktifkan ultracode menetapkan sesi ke effort xhigh, memilih tingkat lain menonaktifkannya, dan batas effort di bawah xhigh membuatnya tidak tersedia.

Meneruskan ultracode ke flag --effort atau nilai Agent SDK effortLevel memerlukan Claude Code v2.1.203 atau lebih baru. Sebelum v2.1.203, --effort ultracode mencetak Unknown --effort value 'ultracode' dan sesi dimulai pada effort default.

Pengaturan effortLevel yang persisten dan environment variable CLAUDE_CODE_EFFORT_LEVEL tidak menerima ultracode. Jika CLAUDE_CODE_EFFORT_LEVEL atau batas effort menetapkan tingkat sesi, ultracode tetap aktif pada tingkat itu.

Ultracode tidak tersedia ketika:

Workflow dimatikan
Model tidak mendukung effort xhigh

Dalam kasus tersebut --effort ultracode memulai sesi dengan ultracode mati, pada tingkat effort tertinggi yang diizinkan model dan batas apa pun, hingga xhigh.

Pilih tingkat effort

Setiap tingkat menukar pengeluaran token dengan kemampuan. Default cocok untuk sebagian besar tugas pengkodean; sesuaikan ketika Anda menginginkan keseimbangan berbeda.

Tingkat	Kapan menggunakannya
`low`	Pertukaran cepat di mana Anda meninjau setiap hasil, seperti brainstorming, sketsa pertama, atau perubahan kecil seperti rename
`medium`	Default pada Opus 5.5, Sonnet 5.5, dan Haiku 5.5. Pada Opus 5.5 dan Sonnet 5.5, cocok untuk pekerjaan teknik sehari-hari dengan cakupan yang jelas, seperti mengimplementasikan fitur baru. Pada model dengan default lebih tinggi, mengurangi penggunaan token untuk pekerjaan sensitif biaya yang dapat mengorbankan sebagian kecerdasan
`high`	Pekerjaan di mana verifikasi penting atau kasus tepi mungkin muncul, seperti memperbaiki bug dalam codebase yang ada. Default pada setiap model kecuali Opus 5.5, Sonnet 5.5, Haiku 5.5, dan Opus 4.7
`xhigh`	Penalaran lebih dalam pada pengeluaran token lebih tinggi. Default pada Opus 4.7
`max`	Masalah sulit yang Anda ingin Claude kerjakan tanpa Anda, seperti menemukan kerentanan keamanan. `max` mungkin menunjukkan hasil yang semakin berkurang dan rentan terhadap overthinking, jadi uji sebelum mengadopsinya secara luas
`ultracode`	Pengaturan Claude Code, bukan tingkat: merencanakan alur kerja dinamis untuk setiap tugas substantif pada tingkat effort apa pun

Dalam pengujian pada Opus 5.5 dan Fable 5.1, Claude pada tingkat yang lebih tinggi menguji lebih banyak kasus tepi dan memverifikasi lebih banyak pekerjaannya sebelum menjawab. Claude juga membuat lebih banyak pilihan sendiri. Pada tingkat yang lebih rendah, Claude mengembalikan titik awal lebih cepat, yang cocok untuk pekerjaan di mana Anda meninjau setiap hasil dan mengarahkan langkah berikutnya. Untuk melihat tugas yang sama berjalan pada setiap tingkat, baca Using Claude Code: Spending your effort di blog.

Skala effort dikalibrasi per model, jadi nama tingkat yang sama tidak mewakili nilai dasar yang sama di seluruh model.

Opus 5.5 default ke medium, satu tingkat di bawah default Opus 5 yaitu high. Dalam pengujian Anthropic, Opus 5.5 pada medium menyamai atau melebihi Opus 5 pada high pada evaluasi pengkodean dan pekerjaan pengetahuan. Pada tingkat yang sama, Opus 5.5 cenderung berpikir lebih banyak per giliran daripada Opus 5. Ketika Anda pindah dari Opus 5 ke Opus 5.5, mulai pada medium daripada membawa tingkat yang Anda gunakan pada Opus 5. Untuk menguji tingkat terhadap pekerjaan Anda sendiri, lihat Calibrate effort dalam panduan prompting Opus 5.5.

Gunakan ultrathink untuk penalaran mendalam sekali jalan

Sertakan ultrathink di mana saja dalam prompt Anda untuk meminta penalaran lebih dalam pada giliran itu tanpa mengubah pengaturan effort sesi Anda. Claude Code mengenali kata kunci tersebut dan menambahkan instruksi dalam konteks. Tingkat effort yang dikirim ke API tidak berubah. Claude Code meneruskan frasa lain seperti "think", "think hard", dan "think more" sebagai teks prompt biasa dan tidak mengenalinya sebagai kata kunci.

Atur tingkat effort

Anda dapat mengubah effort melalui salah satu dari berikut ini:

/effort: jalankan /effort tanpa argumen untuk membuka slider interaktif, /effort diikuti dengan nama tingkat untuk menetapkannya secara langsung, atau /effort auto untuk menghapus tingkat tersimpan Anda untuk model aktif. Anda dapat menjalankannya saat Claude sedang bekerja, dan setelah Anda mengonfirmasi peringatan cache, jika Claude Code menampilkannya, Claude Code menerapkan tingkat baru ke permintaan berikutnya dalam giliran
Dalam /model: gunakan tombol panah kiri/kanan untuk menyesuaikan slider effort saat memilih model
Flag --effort: teruskan nama tingkat untuk menetapkannya untuk satu sesi saat meluncurkan Claude Code
Environment variable: atur CLAUDE_CODE_EFFORT_LEVEL ke nama tingkat atau auto
Pengaturan: atur tingkat per model dalam modelSettings, atau atur effortLevel ke low, medium, high, atau xhigh sebagai default untuk model yang tidak memilikinya. max tidak diterima sebagai tingkat di kunci mana pun, dan ultracode memiliki kunci ultracode sendiri
Dari perangkat yang terhubung: dalam sesi Remote Control, pilih tingkat dari kontrol effort pada ponsel Anda atau di browser Anda. Tingkat berlaku untuk sesi saat ini saja. Memerlukan Claude Code v2.1.234 atau lebih baru
Frontmatter skill dan subagent: atur effort dalam file markdown skill atau subagent untuk menimpa tingkat effort ketika skill atau subagent itu berjalan

Effort frontmatter berlaku ketika skill atau subagent itu aktif, menimpa tingkat sesi tetapi tidak environment variable. maxEffortLevel atau batas effort organisasi tetap membatasi tingkat tempat skill atau subagent berjalan.

Jika Anda menetapkan effortLevel dalam pengaturan terkelola, Claude Code menerapkannya pada langkah pengaturan dari urutan resolusi effort, dan pengguna masih dapat mengubah tingkat dengan /effort atau --effort. Untuk menjaga pengguna pada atau di bawah suatu tingkat, atur maxEffortLevel.

Slider effort muncul dalam /model ketika model yang didukung dipilih. Tingkat effort saat ini juga ditampilkan dalam header sesi di sebelah nama model, misalnya "with low effort", jadi Anda dapat mengonfirmasi pengaturan mana yang aktif tanpa membuka /model. Footer juga secara singkat menampilkan tingkat effort saat startup dan saat berubah.

Penalaran adaptif dan thinking budget tetap

Penalaran adaptif membuat thinking opsional pada setiap langkah, jadi Claude dapat merespons lebih cepat terhadap prompt rutin dan menyisihkan pemikiran lebih dalam untuk langkah-langkah yang mendapat manfaat darinya. Jika Anda ingin Claude berpikir lebih atau kurang sering daripada yang dihasilkan tingkat saat ini, Anda dapat menyatakannya langsung dalam prompt Anda atau dalam CLAUDE.md; model merespons panduan itu dalam pengaturan effort-nya.

Model Fable, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru selalu menggunakan penalaran adaptif. Mode thinking budget tetap dan CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING tidak berlaku untuk model-model tersebut.

Pada Opus 4.6 dan Sonnet 4.6, Anda dapat menetapkan CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 untuk kembali ke thinking budget tetap sebelumnya yang dikendalikan oleh MAX_THINKING_TOKENS. Lihat environment variable.

Extended thinking

Extended thinking adalah penalaran yang Claude keluarkan sebelum merespons. Pada model yang mendukung penalaran adaptif, tingkat effort adalah kontrol utama untuk seberapa banyak thinking yang terjadi; pengaturan di bawah mengaktifkan atau menonaktifkan thinking dan mengontrol cara penampilannya. Dengan thinking dimatikan pada Anthropic API, Claude Code mengirim effort high alih-alih tingkat lebih tinggi ke model yang diketahuinya tidak menerima kombinasi itu, seperti Opus 5.

Kontrol	Cara menetapkannya
Alihkan untuk sesi saat ini	Tekan `Option+T` pada macOS atau `Alt+T` pada Windows dan Linux
Atur default global	Jalankan `/config` dan alihkan mode thinking. Disimpan sebagai `alwaysThinkingEnabled` dalam `~/.claude/settings.json`
Nonaktifkan melalui environment variable	Atur `MAX_THINKING_TOKENS=0`, yang mematikan thinking pada Anthropic API kecuali pada Opus 5.5, Sonnet 5.5, Haiku 5.5, dan model Fable. Pada penyedia pihak ketiga, Claude Code menghilangkan parameter `thinking` sebagai gantinya, dan model penalaran adaptif mungkin tetap berpikir

Anda tidak dapat mematikan thinking pada Opus 5.5, Sonnet 5.5, Haiku 5.5, atau model Fable. Alihan sesi dan baris /config menampilkan Thinking can't be turned off untuk model-model ini alih-alih menawarkan sakelar, dan alwaysThinkingEnabled: false atau MAX_THINKING_TOKENS=0 yang disimpan tidak berpengaruh di sana. Pada model-model ini, model memutuskan per langkah seberapa banyak berpikir berdasarkan tingkat effort. Pengaturan yang disimpan berlaku lagi ketika Anda beralih ke model yang menerimanya.

Claude Code menciutkan output thinking secara default. Tekan Ctrl+O untuk mengalihkan mode verbose dan melihat penalaran sebagai teks miring abu-abu. Sesi interaktif pada Anthropic API menerima thinking block yang diredaksi secara default, jadi atur showThinkingSummaries: true dalam pengaturan jika Anda menginginkan ringkasan lengkap tersedia saat Anda memperluasnya. Anda dikenakan biaya untuk semua thinking token yang dihasilkan, bahkan ketika diciutkan atau diredaksi.

Konteks diperpanjang

Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, Opus 4.6 dan lebih baru, serta Sonnet 4.6 mendukung context window 1 juta token untuk sesi panjang dengan codebase besar.

Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru berjalan dengan window 1M secara default, tanpa memerlukan sufiks [1m]. Hal ini mencakup sesi pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, serta sesi Claude apps gateway. Untuk menjalankannya dengan window 200K, lihat Matikan konteks 1M.

Opus 4.6 dan Sonnet 4.6 mencapai 1M hanya melalui varian [1m] mereka, dan akses ke varian itu tergantung pada paket Anda. Pada paket Max, Team, dan Enterprise, termasuk kursi Team Standard dan Team Premium, Opus 4.6 dengan konteks 1M disertakan dengan langganan Anda. Sonnet 4.6 dengan konteks 1M memerlukan kredit penggunaan pada setiap paket langganan, termasuk Max.

Paket	Opus 4.6 dengan konteks 1M	Sonnet 4.6 dengan konteks 1M
Max, Team, dan Enterprise	Disertakan dengan langganan	Memerlukan kredit penggunaan
Pro	Memerlukan kredit penggunaan	Memerlukan kredit penggunaan
API dan pay-as-you-go	Akses penuh	Akses penuh

Claude Code memeriksa persyaratan paket ini hanya ketika terhubung ke Anthropic API secara langsung. Jika Anda mengarahkan ANTHROPIC_BASE_URL ke gateway LLM dan login claude.ai tersimpan Anda tetap menjadi kredensial aktif, Claude Code tidak memeriksa kredit penggunaan paket Anda. Opsi [1m] tetap tersedia dalam /model, dan gateway memutuskan apakah permintaan berhasil. Sebelum v2.1.229, Claude Code menolak /model sonnet[1m] dalam konfigurasi itu ketika tidak dapat mengonfirmasi kredit penggunaan pada akun.

Pada Anthropic API, context window 1M menggunakan harga model standar tanpa premium untuk token di atas 200K, kecuali pada Haiku 5.5, yang lebih mahal untuk prompt yang lebih panjang dari 100K token. Untuk paket di mana konteks diperpanjang disertakan dengan langganan Anda, penggunaan tetap tercakup oleh langganan Anda. Untuk paket yang mengakses konteks diperpanjang melalui kredit penggunaan, token ditagih ke kredit penggunaan.

Pilih konteks 1M untuk Opus 4.6 atau Sonnet 4.6

Untuk memilih varian 1M berdasarkan nama, tambahkan sufiks [1m] ke alias model atau nama model lengkap:

# Append [1m] to a full model name
/model claude-opus-4-6[1m]
/model claude-sonnet-4-6[1m]

# Or to an alias: the suffix applies to the model the alias resolves to
/model opus[1m]

Context window di belakang gateway LLM

Jika Anda menetapkan ANTHROPIC_BASE_URL ke gateway LLM atau proxy lainnya, Claude Code memberikan setiap model yang dikenalinya context window yang sama dengan yang dimiliki model tersebut pada Anthropic API. Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru mendapatkan window 1M tanpa varian [1m] untuk dipilih, dan model yang mencapai 1M hanya melalui varian [1m]-nya, seperti Opus 4.6, berjalan pada 200K tanpa varian itu. Claude Code tidak dapat mendeteksi batas yang lebih rendah yang diberlakukan gateway atau server di belakangnya. Jika gateway Anda menolak permintaan di atas 200K token, atur CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 di environment yang menjalankan Claude Code, sehingga sesi pada setiap model melakukan compaction pada batas itu.

Matikan konteks 1M

Untuk menjaga sesi pada window 200K, atur CLAUDE_CODE_DISABLE_1M_CONTEXT=1 di shell Anda atau di file pengaturan. Claude Code menghapus varian model [1m] dari pemilih model. Pada model yang berjalan dengan window 1M secara default, seperti model Fable, Sonnet 5 dan lebih baru, serta Opus 4.7 dan lebih baru, Claude Code juga memperlakukan model sebagai memiliki context window 200K:

Dengan auto-compaction aktif, sesi melakukan compaction pada batas 200K melalui auto-compaction. Menetapkan window auto-compact di atas 200K tidak mencabut batasan ini, karena Claude Code membatasi window itu pada context window model.
Dengan auto-compaction mati, sesi berhenti pada batas 200K dengan error context-limit alih-alih melakukan compaction.

Context window dan harga Haiku 5.5

Pada Anthropic API, Haiku 5.5 berjalan dengan context window 1M pada setiap paket, tanpa sufiks [1m] untuk dipilih. ID modelnya adalah claude-haiku-5-5. Untuk menggunakannya, jalankan /model claude-haiku-5-5 dalam sesi, atau mulai Claude Code dari shell Anda dengan claude --model claude-haiku-5-5.

Permintaan Haiku 5.5 lebih mahal per token ketika prompt-nya lebih panjang dari 100K token. Lihat harga Anthropic untuk kedua tarif.

Sesi auto-compact pada sekitar 967K token secara default. Untuk melakukan compaction lebih awal, atur window auto-compact yang lebih kecil untuk model tersebut.

Context window dan auto-compaction

Jendela auto-compact adalah seberapa penuh context window dapat menjadi sebelum Claude Code melakukan compaction percakapan. Untuk apa yang disimpan dan dihapus compaction per mekanisme, lihat What survives compaction.

Atur jendela auto-compact

Anda dapat mengatur jendela auto-compact di tempat-tempat berikut:

Untuk model saat ini, dalam sesi ini dan sesi berikutnya: jalankan /autocompact dengan nilai, seperti /autocompact 500k. Claude Code menyimpannya ke pengaturan pengguna Anda di bawah model saat ini dalam modelSettings dan menerapkannya ke sesi saat ini. Jika cakupan pengaturan dengan prioritas lebih tinggi seperti pengaturan terkelola menetapkan jendelanya sendiri untuk model tersebut atau untuk setiap model, perintah menyimpan nilai Anda tetapi sesi mempertahankan jendela cakupan tersebut, dan perintah mengatakan demikian. Jalankan /autocompact auto untuk kembali ke jendela yang disesuaikan untuk model Anda. Sebelum v2.1.288, perintah ini menyimpan satu jendela untuk setiap model, sebagai autoCompactWindow tingkat atas.
Untuk setiap model: atur autoCompactWindow dalam file pengaturan, seperti "autoCompactWindow": 200000 di ~/.claude/settings.json. Jendela yang Anda simpan untuk suatu model dengan /autocompact diutamakan daripada kunci ini dalam file yang sama untuk model tersebut.
Untuk satu peluncuran: teruskan --autocompact saat memulai Claude Code. Flag ini menimpa pengaturan tersimpan Anda untuk peluncuran itu tanpa mengubahnya, dan claude --autocompact auto menjalankan sesi pada jendela yang disesuaikan bahkan jika pengaturan tersimpan Anda memiliki nilai. Tidak seperti /autocompact, flag ini tidak didahului oleh cakupan pengaturan dengan prioritas lebih tinggi seperti pengaturan terkelola.
Dalam skrip dan lingkungan cloud: atur CLAUDE_CODE_AUTO_COMPACT_WINDOW. Saat diatur, variabel ini diutamakan daripada perintah, flag, dan pengaturan, dan /autocompact melaporkan override tersebut alih-alih mengubah jendela.

Perintah dan flag menerima ukuran jendela dari 100K hingga 1M token, dalam salah satu bentuk ini:

Hitungan token biasa, seperti 200000
Akhiran k atau M, seperti 500k atau 1M
Angka biasa dari 100 hingga 1000, berarti ribuan, jadi 200 menetapkan 200.000

Environment variable hanya menerima hitungan token biasa. Claude Code membatasi jendela pada context window model.

Ambang batas auto-compact default

Jika Anda tidak mengatur jendela auto-compact, Claude Code melakukan compaction ketika percakapan mencapai batas konteks model, kecuali dalam sesi ini:

Sesi cloud melakukan compaction saat percakapan mendekati batas model
Sonnet 4.6 dan Opus 4.6 tanpa konteks diperluas melakukan compaction pada batas 200K
Ketika Anda mengatur CLAUDE_CODE_DISABLE_1M_CONTEXT=1, model dengan jendela asli 1M, seperti Sonnet 5 dan model Fable, melakukan compaction pada batas 200K
Model yang berjalan dengan jendela asli 1M melakukan compaction sebelum jendela penuh, pada sekitar 967K token secara default. Ini termasuk model Fable, Sonnet 5 dan yang lebih baru, Haiku 5.5, serta Opus 4.7 dan yang lebih baru. Di balik ANTHROPIC_BASE_URL kustom, lihat the context window behind a gateway
Sesi pada ID model yang tidak dikenali Claude Code, seperti alias gateway LLM, melakukan compaction pada context window yang diasumsikan Claude Code untuk ID tersebut; lihat Correct the window for a gateway or custom model ID

Perbaiki jendela untuk gateway atau ID model kustom

Pada gateway LLM atau deployment kustom lainnya, Claude Code dapat mengasumsikan context window untuk ID model yang berbeda dari jendela asli model, terlepas dari apakah itu menyelesaikan ID ke model Claude. Atur CLAUDE_CODE_MAX_CONTEXT_TOKENS ke jendela yang Claude Code harus asumsikan sebagai gantinya.

Bagaimana variabel diterapkan tergantung pada ID. Claude Code memperlakukan ID sebagai penyedia atau ejaan kustom ketika tidak dimulai dengan claude-, dalam huruf apa pun, atau ketika membawa akhiran yang Claude Code lepaskan saat membaca ID, seperti akhiran tanggal @YYYYMMDD yang digunakan di Agent Platform Google Cloud. Sebelum v2.1.259, Claude Code tidak menghitung akhiran yang dilucuti, jadi ID claude- yang tidak dikenali dengan akhiran tanggal diperlakukan sebagai nama claude- biasa.

Penyedia atau ejaan kustom yang tidak dikenali, ejaan yang sama dengan [1m], dan setiap ID lainnya adalah tiga kasus terpisah:

Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID tidak berisi [1m], variabel diterapkan secara langsung dan compaction proaktif berlanjut pada jendela yang dideklarasikan.
Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID berisi [1m], dalam huruf apa pun, Claude Code mengasumsikan jendela 1M untuk itu dan variabel tidak diterapkan dengan sendirinya. Untuk memperbaiki jendela sambil mempertahankan compaction proaktif, juga atur CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Dengan variabel itu diatur, Claude Code mengukur ID seperti ejaan yang sama tanpa [1m], jadi CLAUDE_CODE_MAX_CONTEXT_TOKENS diterapkan ketika itu akan diterapkan pada ejaan tanpa tag itu.

Dengan jendela yang dideklarasikan di atas 200K, Claude Code kemudian menampilkan peringatan startup bahwa batas 200K tidak diterapkan. Peringatan diharapkan dalam konfigurasi ini.
Jika ID diselesaikan ke model Claude Code yang dikenali, atau ID adalah nama claude- biasa tanpa akhiran untuk Claude Code lepaskan, dalam huruf apa pun, variabel hanya berlaku ketika Anda juga mengatur DISABLE_COMPACT, yang menonaktifkan semua compaction.

Misalnya, ID yang berisi nama model Claude yang Claude Code ketahui, seperti anthropic/claude-opus-4-8, us.anthropic.claude-…-v1:0, atau claude-sonnet-4-5@20250929 yang bertanggal, diselesaikan ke model itu. Ini termasuk ID yang juga berisi [1m]: Claude Code menyelesaikan claude-opus-4-8[1m] ke Opus 4.8 bahkan dengan CLAUDE_CODE_DISABLE_1M_CONTEXT diatur.

Untuk ID model yang Claude Code tidak kenali, atur CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 agar Claude Code melakukan compaction hanya setelah API menolak percakapan dengan kesalahan terlalu panjang yang Claude Code kenali. Claude Code tidak menjalankan pemulihan itu ketika gateway menulis ulang kesalahan ke kata-kata yang Claude Code tidak kenali.

Memeriksa model Anda saat ini

Anda dapat melihat model mana yang sedang Anda gunakan di dua tempat:

Dalam status line, jika Anda memiliki satu yang dikonfigurasi
Dalam /status, yang juga menampilkan informasi akun Anda

Tambahkan opsi model kustom

Gunakan ANTHROPIC_CUSTOM_MODEL_OPTION untuk menambahkan satu entri kustom ke pemilih /model tanpa mengganti alias bawaan. Ini berguna untuk pengujian ID model yang tidak tercantum Claude Code secara default. Untuk deployment gateway LLM, Claude Code dapat mengisi pemilih dari endpoint /v1/models gateway ketika CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 diatur, jadi variabel ini diperlukan hanya ketika penemuan dinonaktifkan atau tidak mengembalikan model yang Anda inginkan. Lihat penemuan model gateway.

Untuk membuat daftar beberapa model sebagai gantinya, dalam urutan Anda sendiri dan di bawah label yang Anda pilih, atur modelPicker. Entrinya mengatakan baris mana yang disimpan pemilih ketika lineup itu menggantikan yang bawaan.

Contoh ini menetapkan ketiga variabel untuk membuat deployment Opus yang dirutekan gateway dapat dipilih. Claude Code membaca variabel lingkungan saat startup, jadi jalankan ekspor sebelum meluncurkan claude, atau mulai ulang sesi yang ada untuk mengambilnya:

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

ANTHROPIC_CUSTOM_MODEL_OPTION_NAME dan ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION bersifat opsional:

Jika Anda menghilangkan nama, entri menampilkan nama model ketika Claude Code mengenali ID, dan ID model sebaliknya.
Jika Anda menghilangkan deskripsi, Claude Code menggunakan Custom model (<model-id>).

Claude Code membuat daftar entri kustom setelah entri bawaan, dan baris modelPicker apa pun yang Anda tambahkan datang setelahnya.

Claude Code melewati validasi untuk ID model yang ditetapkan dalam ANTHROPIC_CUSTOM_MODEL_OPTION, sehingga Anda dapat menggunakan string apa pun yang diterima endpoint API Anda.

Ketika availableModels diatur, sertakan ID model kustom dalam daftar izin juga. Jika tidak, Claude Code menyaring entri kustom dari pemilih dan menolak pemilihan --model darinya seperti model yang dikecualikan lainnya.

ID kustom yang menyematkan nama keluarga, seperti my-gateway/claude-opus-5-5, dihitung sebagai entri spesifik untuk keluarga itu dan menonaktifkan wildcard-nya, jadi juga daftarkan versi yang ingin Anda pertahankan dapat dipilih. Lihat Perilaku penggabungan.

Environment variable

Gunakan environment variable berikut untuk mengontrol nama model yang dipetakan alias. Setiap nilai harus berupa nama model lengkap, atau pengenal setara untuk penyedia API Anda. Untuk memilih model yang dimulai sesi Anda, atur ANTHROPIC_DEFAULT_MODEL, yang tabel ini abaikan.

Environment variable	Deskripsi
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Model yang digunakan untuk `fable`, dan ID model yang dikenali Claude Code sebagai model Fable untuk fallback model otomatis pada penyedia pihak ketiga
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Model yang digunakan untuk `opus`, atau untuk `opusplan` ketika Plan Mode aktif.
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Model yang digunakan untuk `sonnet`, atau untuk `opusplan` ketika Plan Mode tidak aktif.
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Model yang digunakan untuk `haiku`, atau fungsionalitas latar belakang
`CLAUDE_CODE_SUBAGENT_MODEL`	Model default untuk subagent, rekan tim agent, dan agent workflow yang tidak ditugaskan model dengan cara lain. Menerima alias seperti `haiku` atau nama model lengkap. Model per-invocation atau bidang `model` definisi, termasuk `inherit`, diutamakan. Untuk mengubah itu, atur `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`

Pada penyedia pihak ketiga, Sesuaikan tampilan dan kemampuan model yang ditetapkan menjelaskan apa yang ditampilkan baris model yang ditetapkan di pemilih /model.

Catatan: ANTHROPIC_SMALL_FAST_MODEL sudah deprecated dan digantikan oleh ANTHROPIC_DEFAULT_HAIKU_MODEL.

Tetapkan model untuk deployment pihak ketiga

Saat men-deploy Claude Code melalui Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform on AWS, tetapkan versi model sebelum meluncurkan ke pengguna.

Tanpa penetapan, Claude Code menggunakan alias model seperti fable, opus, sonnet, dan haiku yang diselesaikan ke ID model default bawaan untuk setiap penyedia. Default tersebut dapat tertinggal dari rilis Anthropic terbaru, dan model yang ditunjuknya mungkin belum diaktifkan di akun pengguna. Ketika default tidak tersedia, pengguna Amazon Bedrock dan Google Cloud's Agent Platform melihat pemberitahuan dan sesi kembali ke versi sebelumnya dari model default, atau ke model Sonnet default ketika default adalah model Opus dan tidak ada versi Opus yang tersedia. Pengguna Microsoft Foundry melihat kesalahan sebagai gantinya, karena Microsoft Foundry tidak memiliki pemeriksaan startup yang setara.

Di Amazon Bedrock dan Google Cloud's Agent Platform, pengguna yang memulai sesi pada versi Sonnet atau Opus tertentu, misalnya dengan --model, ANTHROPIC_MODEL, atau pengaturan model, menetapkan versi itu sebagai default sesi untuk alias yang cocok: pemeriksaan startup melewati default bawaan yang digantikannya dan tidak menampilkan pemberitahuan fallback. Sebelum v2.1.211, pemeriksaan berjalan dan dapat menampilkan pemberitahuan bahkan ketika model sesi dikonfigurasi secara eksplisit.

Gunakan environment variable berikut dengan ID model spesifik versi untuk penyedia Anda:

Penyedia	Contoh
Amazon Bedrock	`export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'`
Google Cloud's Agent Platform	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`
Microsoft Foundry	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`

Terapkan pola yang sama untuk ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, dan ANTHROPIC_DEFAULT_HAIKU_MODEL. Untuk ID model saat ini dan warisan di semua penyedia, lihat Ikhtisar Model. Untuk meningkatkan pengguna ke versi model baru, perbarui environment variable ini dan deploy ulang.

Model yang ditetapkan dengan window 1M bawaan, seperti Opus 4.8 atau Sonnet 5, berjalan dengan context window 1M tanpa akhiran apa pun ketika Claude Code dapat mencocokkan ID yang ditetapkan dengan model tersebut. ID cocok ketika mengandung ID API Anthropic model tersebut, seperti us.anthropic.claude-opus-4-8 mengandung claude-opus-4-8, atau ketika entri modelOverrides memetakan model tersebut ke ID itu. Pada ID yang ditetapkan yang tidak dapat dicocokkan Claude Code dengan model mana pun, sesi berjalan dengan window 200K secara default kecuali ID tersebut membawa akhiran [1m].

Untuk model yang mencapai 1M melalui varian [1m]-nya, seperti Opus 4.6 atau Sonnet 4.6, aktifkan konteks diperluas dengan menambahkan [1m] ke ID model dalam ANTHROPIC_DEFAULT_OPUS_MODEL atau ANTHROPIC_DEFAULT_SONNET_MODEL:

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

Dengan akhiran [1m], context window 1M berlaku untuk semua penggunaan alias yang ditetapkan, termasuk fase Opus plan mode dari opusplan dan subagent yang model frontmatter mereka menamai alias.

Claude Code menghapus akhiran sebelum mengirim ID model ke penyedia Anda.
Hanya tambahkan [1m] ketika model yang mendasar mendukung konteks 1M.
Akhiran dibaca per variabel, bukan per model. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, ID Opus 4.6 atau Sonnet 4.6 tanpa [1m] dalam satu variabel menggunakan konteks 200K bahkan jika variabel lain menetapkan model yang sama dengan akhiran.

Ketika Anda menetapkan variabel ANTHROPIC_DEFAULT_*_MODEL, pemilih /model menampilkan satu baris untuk model itu menggantikan baris bawaan keluarga, termasuk baris konteks 1M apa pun. Untuk mencapai window 1M tanpa menambahkan akhiran ke variabel itu, pengguna Anda menjalankan /model opus[1m], dan Claude Code menerapkan akhiran ke model yang dinamai variabel. /model sonnet[1m] bekerja dengan cara yang sama.

Sesuaikan tampilan dan kemampuan model yang ditetapkan

Ketika Anda menetapkan model pada penyedia pihak ketiga, barisnya di pemilih /model menampilkan nama model secara default jika Claude Code mengenali ID yang ditetapkan, dan ID mentah sebaliknya:

Dikenali: ID model yang tepat yang dikenal Claude Code, seperti ID API Anthropic-nya atau bentuk penyedia atau gateway Anda, dengan atau tanpa akhiran [1m]. Tetapkan us.anthropic.claude-sonnet-4-5-20250929-v1:0 dan baris membaca Sonnet 4.5.
Tidak dikenali: ID apa pun yang lain, seperti ARN profil inferensi aplikasi atau versi model yang tidak dikenal Claude Code, kecuali entri modelOverrides memetakan model ke string yang tepat itu. Di Microsoft Foundry, nama deployment ditentukan pengguna, jadi Claude Code tidak pernah mengenali ID yang ditetapkan di sana, dipetakan atau tidak, dan baris menampilkan nama deployment secara default.

Ketika baris menampilkan nama model, deskripsi defaultnya mencakup ID yang ditetapkan sehingga Anda masih dapat melihat ID mana yang ditetapkan.

Claude Code juga mungkin tidak mengenali fitur mana yang didukung model yang ditetapkan. Anda dapat menetapkan nama tampilan dan deskripsi sendiri dan mendeklarasikan kemampuan dengan environment variable pendamping untuk setiap model yang ditetapkan.

Variabel ini berlaku pada penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry. Variabel _NAME dan _DESCRIPTION juga berlaku ketika ANTHROPIC_BASE_URL menunjuk ke gateway LLM. Mereka tidak berpengaruh saat menghubungkan langsung ke api.anthropic.com.

Environment variable	Deskripsi
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nama tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan nama model jika Claude Code mengenali ID yang ditetapkan, dan ID yang ditetapkan sebaliknya
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Deskripsi tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan deskripsi default yang dimulai dengan `Custom Opus model`
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Daftar kemampuan yang dipisahkan koma yang didukung model Opus yang ditetapkan

Akhiran _NAME, _DESCRIPTION, dan _SUPPORTED_CAPABILITIES yang sama tersedia untuk ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, dan ANTHROPIC_CUSTOM_MODEL_OPTION.

Claude Code mengaktifkan fitur seperti tingkat effort dan extended thinking dengan mencocokkan ID model terhadap pola yang dikenal. ID spesifik penyedia seperti ARN Amazon Bedrock atau nama deployment kustom sering kali tidak cocok dengan pola ini, meninggalkan fitur yang didukung dinonaktifkan. Atur _SUPPORTED_CAPABILITIES untuk memberi tahu Claude Code fitur mana yang benar-benar didukung model:

Nilai kemampuan	Mengaktifkan
`effort`	Tingkat effort dan perintah `/effort`
`xhigh_effort`	Tingkat effort `xhigh`
`max_effort`	Tingkat effort `max`
`thinking`	Extended thinking
`adaptive_thinking`	Penalaran adaptif yang secara dinamis mengalokasikan thinking berdasarkan kompleksitas tugas
`interleaved_thinking`	Thinking di antara panggilan tool

Ketika _SUPPORTED_CAPABILITIES diatur, Claude Code mengaktifkan kemampuan yang tercantum dan menonaktifkan kemampuan yang tidak tercantum untuk model yang ditetapkan yang cocok. Ketika variabel tidak diatur, Claude Code kembali ke deteksi bawaan berdasarkan ID model.

Contoh ini menetapkan Opus ke ARN model kustom Amazon Bedrock, menetapkan nama yang ramah, dan mendeklarasikan kemampuannya:

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'

Timpa ID model per versi

Di platform yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host diutamakan daripada pengaturan model terkelola, sementara allowlist availableModels terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; Pengecualian untuk prioritas pengaturan terkelola menjelaskan kunci dan variabel mana yang ditimpa host.

Environment variable tingkat keluarga di atas mengonfigurasi satu ID model per alias keluarga. Jika Anda perlu memetakan beberapa versi dalam keluarga yang sama ke ID penyedia yang berbeda, gunakan pengaturan modelOverrides sebagai gantinya.

modelOverrides memetakan ID model Anthropic individual ke string spesifik penyedia yang dikirim Claude Code ke API penyedia Anda. Ketika pengguna memilih model yang dipetakan di pemilih /model, Claude Code menggunakan nilai yang Anda konfigurasi alih-alih default bawaan.

Ini memungkinkan administrator enterprise untuk merutekan setiap versi model ke ARN profil inferensi Amazon Bedrock tertentu, nama versi Google Cloud's Agent Platform, atau nama deployment Microsoft Foundry untuk tata kelola, alokasi biaya, atau perutean regional.

Atur modelOverrides dalam file pengaturan Anda:

{
  "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"
  }
}

Kunci harus berupa ID model Anthropic seperti yang tercantum dalam Ikhtisar Model. Untuk ID model bertanggal, sertakan akhiran tanggal persis seperti yang muncul di sana. Kunci yang tidak dikenal diabaikan.

Untuk menghentikan baris diagnostik [claude-code:unrecognized_model] untuk ID seperti alias gateway, tambahkan entri dengan ID itu sebagai nilainya.

Override menggantikan ID model bawaan yang mendukung setiap entri di pemilih /model. Di Amazon Bedrock, entri modelOverrides diutamakan daripada profil inferensi apa pun yang ditemukan Claude Code secara otomatis saat startup. Claude Code meneruskan nilai yang sudah dalam bentuk asli penyedia, seperti ARN profil inferensi Amazon Bedrock atau nama deployment Microsoft Foundry, ke penyedia apa adanya.

Override juga berlaku ketika Anda meneruskan ID model Anthropic secara langsung melalui --model, environment variable ANTHROPIC_MODEL, atau environment variable ANTHROPIC_DEFAULT_*_MODEL. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Mantle, ID model Anthropic tanpa entri modelOverrides diselesaikan ke ID spesifik penyedia yang sama dengan baris pemilih /model untuk versi itu, ketika penyedia mendukung versi itu. Mantle mendukung subset versi. Untuk ID model Anthropic di luar subset itu, Claude Code mengirim ID mentah ke Mantle tanpa memetakannya, kecuali entri modelOverrides mencakupnya. Sebelum v2.1.200, --model dan nilai environment variable mencapai penyedia apa adanya tanpa melewati peta override.

modelOverrides bekerja bersama availableModels. Allowlist dievaluasi terhadap ID model Anthropic, bukan nilai override, jadi entri seperti "opus" dalam availableModels terus cocok bahkan ketika versi Opus dipetakan ke ARN. Ketika enforceAvailableModels diatur dalam pengaturan terkelola, Default yang diterapkan diselesaikan melalui modelOverrides dari pengaturan terkelola saja. Pemetaan admin, seperti versi yang ditetapkan ke ARN profil inferensi, dihormati dalam Default yang diterapkan. Override dari pengaturan pengguna atau proyek tidak mempengaruhinya.

Ketika availableModels diatur dalam pengaturan terkelola, hanya modelOverrides dari pengaturan terkelola yang berlaku untuk ID model Anthropic yang diteruskan secara langsung melalui --model atau environment variable di atas. Claude Code mengabaikan override dalam pengaturan pengguna atau proyek untuk ID tersebut, dan tidak pernah menyelesaikan ID yang dikecualikan daftar terkelola melalui modelOverrides dari sumber pengaturan apa pun. Pembatasan sumber terkelola ini memerlukan Claude Code v2.1.200 atau lebih baru. Lihat Batasi pemilihan model untuk cara ID yang diblokir ditangani.

Konfigurasi prompt caching

Claude Code secara otomatis menggunakan prompt caching untuk mengoptimalkan kinerja dan mengurangi biaya. Anda dapat menonaktifkan prompt caching secara global atau untuk tingkat model tertentu:

Environment variable	Deskripsi
`DISABLE_PROMPT_CACHING`	Atur ke `1` untuk menonaktifkan prompt caching untuk semua model. Diutamakan daripada pengaturan per-model
`DISABLE_PROMPT_CACHING_HAIKU`	Atur ke `1` untuk menonaktifkan prompt caching untuk model Haiku default
`DISABLE_PROMPT_CACHING_SONNET`	Atur ke `1` untuk menonaktifkan prompt caching untuk model Sonnet default
`DISABLE_PROMPT_CACHING_OPUS`	Atur ke `1` untuk menonaktifkan prompt caching untuk model Opus default
`DISABLE_PROMPT_CACHING_FABLE`	Atur ke `1` untuk menonaktifkan prompt caching untuk model Fable saja

Untuk memilih cache TTL untuk percakapan utama dan untuk subagent secara terpisah, lihat pilih TTL sendiri. Untuk apa yang memicu cache miss, lihat Bagaimana Claude Code menggunakan prompt caching.

Riwayat versi

Tabel ini mencantumkan versi Claude Code di mana setiap alias model mengubah model yang diselesaikannya, yang terbaru terlebih dahulu.

Versi	Perubahan
v2.1.293	`haiku` diselesaikan ke Haiku 5.5 pada Anthropic API
v2.1.284	`sonnet` diselesaikan ke Sonnet 5.5 pada Anthropic API
v2.1.280	`opus` diselesaikan ke Opus 5.5 pada Anthropic API, Claude Platform di AWS, Amazon Bedrock, dan Agent Platform Google Cloud
v2.1.257	`fable` diselesaikan ke Fable 5.1, kecuali dalam sesi gateway aplikasi Claude
v2.1.219	`opus` diselesaikan ke Opus 5 pada Anthropic API, Claude Platform di AWS, Amazon Bedrock, dan Agent Platform
v2.1.207	`opus` diselesaikan ke Opus 4.8 pada Claude Platform di AWS, Amazon Bedrock, dan Agent Platform
v2.1.197	`sonnet` diselesaikan ke Sonnet 5 pada Anthropic API
v2.1.154	`opus` diselesaikan ke Opus 4.8 pada Anthropic API
Sebelumnya	`opus` diselesaikan ke Opus 4.7 pada Claude Platform di AWS dan ke Opus 4.6 pada Amazon Bedrock dan Agent Platform. `fable` diselesaikan ke Fable 5 dan `haiku` diselesaikan ke Haiku 4.5 pada setiap penyedia

model-config.md +203 −192

19 * Microsoft Foundry: nama deployment19 * Microsoft Foundry: nama deployment

20 * Google Cloud's Agent Platform: nama versi20 * Google Cloud's Agent Platform: nama versi

21 21

22Untuk panduan tentang model dan tingkat upaya mana yang sesuai untuk berbagai jenis pekerjaan, lihat [Memilih model Claude dan tingkat upaya di Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) di blog.22Untuk panduan tentang model dan tingkat effort mana yang sesuai untuk berbagai jenis pekerjaan, lihat [Memilih model Claude dan tingkat effort di Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) di blog.

23 23

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` mengubah tempat permintaan dikirim, bukan model mana yang menjawabnya. Untuk merutekan Claude melalui gateway LLM, lihat [LLM gateways](/docs/id/llm-gateway).25 `ANTHROPIC_BASE_URL` mengubah tempat permintaan dikirim, bukan model mana yang menjawabnya. Untuk merutekan Claude melalui gateway LLM, lihat [LLM gateways](/docs/id/llm-gateway).

33 33

34| Alias model | Perilaku |34| Alias model | Perilaku |

35| - | - |35| - | - |

~~36| **`default`** | Nilai khusus yang menghapus penggantian model apa pun dan kembali ke [default runtime untuk akun Anda](#default-model-setting). Bukan sendiri alias model |~~36| **`default`** | Nilai khusus yang menghapus override model apa pun dan kembali ke [default runtime untuk akun Anda](#default-model-setting). Bukan sendiri alias model |

37| **`best`** | Menggunakan model yang diselesaikan oleh alias [`fable`](#fable-alias-resolution) di mana Fable tersedia untuk Anda, jika tidak maka model yang sama dengan `opus` |37| **`best`** | Menggunakan model yang diselesaikan oleh alias [`fable`](#fable-alias-resolution) di mana Fable tersedia untuk Anda, jika tidak maka model yang sama dengan `opus` |

38| **`fable`** | Menggunakan [model Fable untuk penyedia Anda](#fable-alias-resolution) untuk tugas-tugas tersulit dan paling lama |38| **`fable`** | Menggunakan [model Fable untuk penyedia Anda](#fable-alias-resolution) untuk tugas-tugas tersulit dan paling lama |

39| **`sonnet`** | Menggunakan model Sonnet terbaru untuk tugas-tugas pengkodean sehari-hari |39| **`sonnet`** | Menggunakan model Sonnet terbaru untuk tugas-tugas pengkodean sehari-hari |

40| **`opus`** | Menggunakan model Opus terbaru untuk tugas-tugas penalaran kompleks |40| **`opus`** | Menggunakan model Opus terbaru untuk tugas-tugas penalaran kompleks |

41| **`haiku`** | Menggunakan model Haiku yang cepat dan efisien untuk tugas-tugas sederhana |41| **`haiku`** | Menggunakan model Haiku yang cepat dan efisien untuk tugas-tugas sederhana |

42| **`sonnet[1m]`** | Menggunakan Sonnet dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang. Tidak berpengaruh ketika `sonnet` sudah menyelesaikan ke Sonnet 5.5 atau Sonnet 5 dengan jendela 1M aslinya |42| **`sonnet[1m]`** | Menggunakan Sonnet dengan [context window 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang. Tidak berpengaruh ketika `sonnet` sudah menyelesaikan ke Sonnet 5.5 atau Sonnet 5 dengan window 1M aslinya |

~~43| **`opus[1m]`** | Menggunakan Opus dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang |~~43| **`opus[1m]`** | Menggunakan Opus dengan [context window 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang. Tidak berpengaruh ketika `opus` sudah menyelesaikan ke Opus 4.7 atau lebih baru dengan window 1M aslinya |

44| **`opusplan`** | Mode khusus yang menggunakan `opus` selama plan mode, kemudian beralih ke `sonnet` untuk eksekusi |44| **`opusplan`** | Mode khusus yang menggunakan `opus` selama plan mode, kemudian beralih ke `sonnet` untuk eksekusi |

45 45

46Alias `opus`, `sonnet`, dan `haiku` diselesaikan ke versi terbaru di Anthropic API dan ke versi yang lebih awal di beberapa penyedia lain:46Alias `opus`, `sonnet`, dan `haiku` diselesaikan ke versi terbaru di Anthropic API dan ke versi yang lebih awal di beberapa penyedia lain:

62 62

63Versi sebelumnya menyelesaikan alias ini ke model yang lebih lama. Untuk versi di mana setiap alias berubah, lihat [Riwayat versi](#version-history).63Versi sebelumnya menyelesaikan alias ini ke model yang lebih lama. Untuk versi di mana setiap alias berubah, lihat [Riwayat versi](#version-history).

64 64

65Alias 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-5`, atau atur variabel lingkungan yang sesuai seperti `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Alias 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-5`, atau atur environment variable yang sesuai seperti `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66

67<Note>67<Note>

68 Sonnet 5.5 memerlukan Claude Code v2.1.284 atau lebih baru, dan Opus 5.5 memerlukan v2.1.280 atau lebih baru. Jika permintaan untuk salah satunya dari versi yang lebih lama gagal, lihat [Claude Code tidak mendukung model ini](/docs/id/errors#claude-code-does-not-support-this-model). Gunakan v2.1.293 atau lebih baru dengan Haiku 5.5. Jalankan `claude update` untuk upgrade.68 Sonnet 5.5 memerlukan Claude Code v2.1.284 atau lebih baru, dan Opus 5.5 memerlukan v2.1.280 atau lebih baru. Jika permintaan untuk salah satunya dari versi yang lebih lama gagal, lihat [Claude Code tidak mendukung model ini](/docs/id/errors#claude-code-does-not-support-this-model). Gunakan v2.1.293 atau lebih baru dengan Haiku 5.5. Jalankan `claude update` untuk upgrade.

100 Fable dan kredit penggunaan100 Fable dan kredit penggunaan

101</h4>101</h4>

102 102

103Tergantung pada paket dan tingkat kursi Anda, penggunaan Fable dapat ditagih ke [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) 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](/docs/id/costs#add-usage-credits-to-your-subscription).103Tergantung pada paket dan tingkat kursi Anda, penggunaan Fable dapat ditagih ke [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) alih-alih mengambil dari batas yang disertakan paket Anda. Ketika itu terjadi, pemilih `/model` menunjukkan "Requires usage credits" di baris Fable. Untuk mengelola kredit penggunaan, lihat [Tambahkan kredit penggunaan ke langganan Anda](/docs/id/costs#add-usage-credits-to-your-subscription).

104 104

105Dalam 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:105Dalam 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:

106 106

109 109

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

111 111

112Dalam sesi dengan [Remote Control](/docs/id/remote-control) terhubung, [sesi latar belakang](/docs/id/agent-view), atau sesi rekan tim [agent team](/docs/id/agent-teams), mungkin tidak ada yang berada di terminal, jadi Claude Code menahan prompt persetujuan pertengahan sesi untuk batas waktu [`dialogExpiry`](/docs/id/settings-reference#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.112Dalam sesi dengan [Remote Control](/docs/id/remote-control) terhubung, [sesi latar belakang](/docs/id/agent-view), atau sesi rekan tim dari [tim agent](/docs/id/agent-teams), mungkin tidak ada yang berada di terminal, jadi Claude Code menahan prompt persetujuan pertengahan sesi untuk batas waktu [`dialogExpiry`](/docs/id/settings-reference#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.

113 113

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

115 115

127 127

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

129 129

1301. **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](/docs/id/prompt-caching#switching-models)1301. **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 peralihan](/docs/id/prompt-caching#switching-models)

1312. **Saat startup**: luncurkan dengan `claude --model <alias|name>`1312. **Saat startup**: luncurkan dengan `claude --model <alias|name>`

1323. **Variabel lingkungan**: atur `ANTHROPIC_MODEL=<alias|name>`1323. **Environment variable**: atur `ANTHROPIC_MODEL=<alias|name>`

1334. **Pengaturan**: konfigurasi secara permanen di file pengaturan Anda menggunakan bidang `model`1334. **Pengaturan**: konfigurasi secara permanen di file pengaturan Anda menggunakan bidang `model`

1345. **[Default untuk sesi baru](#set-a-default-model-for-new-sessions)**: atur `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1345. **[Default untuk sesi baru](#set-a-default-model-for-new-sessions)**: atur `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

135 135

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

137 137

138* `Enter`: alihkan model dan simpan sebagai default Anda138* `Enter`: alihkan model dan simpan sebagai default Anda

139* `s`: alihkan model hanya untuk sesi ini dan biarkan default Anda tidak berubah. Untuk menggunakan kunci yang berbeda, ikat ulang [`modelPicker:thisSessionOnly`](/docs/id/keybindings#model-picker-actions)139* `s`: alihkan model hanya untuk sesi ini dan biarkan default Anda tidak berubah. Untuk menggunakan tombol yang berbeda, ikat ulang [`modelPicker:thisSessionOnly`](/docs/id/keybindings#model-picker-actions)

140 140

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

142 142

146* Jika [pembatasan model](#restrict-model-selection) mengecualikan model yang dicatat atau tidak tersedia untuk akun Anda, dan admin Anda belum menetapkan model default organisasi, opsi Default diselesaikan seolah-olah tidak ada yang dicatat.146* Jika [pembatasan model](#restrict-model-selection) mengecualikan model yang dicatat atau tidak tersedia untuk akun Anda, dan admin Anda belum menetapkan model default organisasi, opsi Default diselesaikan seolah-olah tidak ada yang dicatat.

147* Jika Anda memilih Default atau `opusplan` di `/model`, pilihan yang dicatat tidak berubah.147* Jika Anda memilih Default atau `opusplan` di `/model`, pilihan yang dicatat tidak berubah.

148 148

149Jika Anda beralih model dengan `/model`, switch juga mencapai [subagent yang mewarisi model percakapan utama](/docs/id/sub-agents#choose-a-model), karena Claude Code menyelesaikan model mereka dari yang digunakan sesi Anda ketika Claude memulainya. Beralih ke Opus sebelum Claude mendelegasikan penelitian atau test run ke salah satunya, dan pekerjaan itu berjalan di Opus juga. Untuk menjaga subagent kustom di model yang lebih kecil, atur `model` dalam definisinya.149Jika Anda beralih model dengan `/model`, peralihan juga mencapai [subagent yang mewarisi model percakapan utama](/docs/id/sub-agents#choose-a-model), karena Claude Code menyelesaikan model mereka dari yang digunakan sesi Anda ketika Claude memulainya. Beralih ke Opus sebelum Claude mendelegasikan penelitian atau test run ke salah satunya, dan pekerjaan itu berjalan di Opus juga. Untuk menjaga subagent kustom di model yang lebih kecil, atur `model` dalam definisinya.

150 150

151Jika Anda menetapkan model dengan `/model` dalam [mode non-interaktif](/docs/id/headless), 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](#organization-default-model) yang admin Anda telah dikonfigurasi untuk mengganti pilihan pengguna juga diterapkan kembali pada peluncuran berikutnya.151Jika Anda menetapkan model dengan `/model` dalam [mode non-interaktif](/docs/id/headless), 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 tetap diutamakan dan diterapkan kembali pada peluncuran berikutnya. [Model default organisasi](#organization-default-model) yang telah dikonfigurasi admin Anda untuk menimpa pilihan pengguna juga diterapkan kembali pada peluncuran berikutnya.

152 152

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

154 154

155Flag `--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`.155Flag `--model` dan environment variable `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`.

156 156

157Harga di pemilih `/model` muncul ketika Claude Code berbicara dengan Anthropic API, secara langsung atau melalui [gateway LLM](/docs/id/llm-gateway) yang memproksikannya, dan harga di baris adalah harga model yang dipilih baris itu. Di [penyedia pihak ketiga](/docs/id/third-party-integrations) seperti Amazon Bedrock dan di [gateway aplikasi Claude](/docs/id/claude-apps-gateway), 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](/docs/id/claude-platform-on-aws) dan sesi gateway menampilkan harga daftar Anthropic, dan baris dapat menampilkan harga model yang berbeda dari yang dipilihnya.157Harga di pemilih `/model` muncul ketika Claude Code berbicara dengan Anthropic API, secara langsung atau melalui [gateway LLM](/docs/id/llm-gateway) yang mem-proxy-nya, dan harga di baris adalah harga model yang dipilih baris itu. Di [penyedia pihak ketiga](/docs/id/third-party-integrations) seperti Amazon Bedrock dan di [Claude apps gateway](/docs/id/claude-apps-gateway), penyedia atau gateway Anda menentukan apa yang Anda bayar, jadi baris pemilih tidak menampilkan harga. Harga adalah label tampilan saja; itu tidak memengaruhi model mana yang dipilih baris atau apa yang ditagih penyedia Anda. Sebelum v2.1.206, [Claude Platform on AWS](/docs/id/claude-platform-on-aws) dan sesi gateway menampilkan harga daftar Anthropic, dan baris dapat menampilkan harga model yang berbeda dari yang dipilihnya.

158 158

159Sesi yang dilanjutkan dimulai dengan `claude --resume`, `--continue`, atau pemilih `/resume` menyimpan model yang mereka gunakan ketika transkrip disimpan. Jika model yang dipulihkan telah pensiun atau dikecualikan oleh [`availableModels`](#restrict-model-selection), sesi jatuh melalui urutan prioritas normal. 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.159Sesi yang dilanjutkan dimulai dengan `claude --resume`, `--continue`, atau pemilih `/resume` menyimpan model yang mereka gunakan ketika transkrip disimpan. Jika model yang dipulihkan telah pensiun atau dikecualikan oleh [`availableModels`](#restrict-model-selection), sesi jatuh melalui urutan prioritas normal. 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.

160 160

161Jika pengaturan `model` Anda adalah `haiku`, sesi yang disimpan pada model Haiku dilanjutkan pada model yang saat ini diselesaikan oleh `haiku`. Misalnya, setelah `haiku` diselesaikan ke Haiku 5.5, sesi yang disimpan pada Haiku 4.5 dilanjutkan pada Haiku 5.5.161Jika pengaturan `model` Anda adalah `haiku`, sesi yang disimpan pada model Haiku dilanjutkan pada model yang saat ini diselesaikan oleh `haiku`. Misalnya, setelah `haiku` diselesaikan ke Haiku 5.5, sesi yang disimpan pada Haiku 4.5 dilanjutkan pada Haiku 5.5.

162 162

163Model 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`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) juga bisa, di bawah kondisi yang tercantum di bagiannya.163Model yang Anda pilih untuk peluncuran baru dengan `--model` atau `ANTHROPIC_MODEL` tetap diutamakan daripada model yang dipulihkan. Sejak v2.1.195, demikian juga variabel keluarga [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) juga bisa, di bawah kondisi yang tercantum di bagiannya.

164 164

165Ketika 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`](/docs/id/env-vars), 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](/docs/id/settings#exceptions-to-managed-settings-precedence) mengatakan kunci dan variabel mana yang diganti host.165Ketika 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 menimpa; pengaturan proyek atau terkelola diterapkan kembali pada peluncuran berikutnya. Di platform yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/id/env-vars), konfigurasi model host diutamakan daripada pengaturan model terkelola, sementara allowlist `availableModels` terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; [Pengecualian untuk prioritas pengaturan terkelola](/docs/id/settings#exceptions-to-managed-settings-precedence) menjelaskan kunci dan variabel mana yang ditimpa host.

166 166

167Jika Anda atau organisasi Anda mengonfigurasi [PreModelSwitch hooks](/docs/id/hooks#premodelswitch), mereka berjalan sebelum switch yang diminta diterapkan dan dapat memblokir atau meminta Anda untuk mengonfirmasi.167Jika Anda atau organisasi Anda mengonfigurasi [PreModelSwitch hooks](/docs/id/hooks#premodelswitch), mereka berjalan sebelum peralihan yang diminta diterapkan dan dapat memblokirnya atau meminta Anda untuk mengonfirmasi.

168 168

169Ketika Claude Code tidak dapat mengetahui hook PreModelSwitch mana yang dikirimkan [plugin terkelola](/docs/id/settings-reference#enabledplugins) 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](/docs/id/errors#model-switch-was-blocked-by-a-premodelswitch-hook) untuk pesan dan pemulihan.169Ketika Claude Code tidak dapat mengetahui hook PreModelSwitch mana yang dikirimkan [plugin terkelola](/docs/id/settings-reference#enabledplugins) organisasi Anda, misalnya karena plugin terkelola gagal dimuat, itu menolak peralihan daripada menerapkannya tanpa diperiksa, dan itu memeriksa lagi pada setiap upaya baru. Lihat [Model switch was blocked by a PreModelSwitch hook](/docs/id/errors#model-switch-was-blocked-by-a-premodelswitch-hook) untuk pesan dan pemulihan.

170 170

171Ketika Anda beralih model melalui metode [`setModel()`](/docs/id/agent-sdk/overview) Agent SDK, melalui aplikasi seperti [Desktop app](/docs/id/desktop), atau dari perangkat yang terhubung melalui [Remote Control](/docs/id/remote-control), Claude Code memeriksa nilai pada switch:171Ketika Anda beralih model melalui metode `setModel()` [Agent SDK](/docs/id/agent-sdk/overview), melalui aplikasi seperti [Desktop app](/docs/id/desktop), atau dari perangkat yang terhubung melalui [Remote Control](/docs/id/remote-control), Claude Code memeriksa nilai pada saat peralihan:

172 172

173* **Agent SDK atau aplikasi**: dengan Claude Code v2.1.268 atau lebih baru, kecuali Claude Code menerima ID model secara lokal, seperti yang dilakukannya untuk [opsi model kustom](#add-a-custom-model-option) Anda, itu mengonfirmasi ID dengan penyedia Anda pertama kali sesi beralih ke sana. Konfirmasi berjalan di setiap penyedia, dan ID yang tidak ditawarkan penyedia Anda ditolak pada switch daripada gagal pada permintaan berikutnya Anda.173* **Agent SDK atau aplikasi**: dengan Claude Code v2.1.268 atau lebih baru, kecuali Claude Code menerima ID model secara lokal, seperti yang dilakukannya untuk [opsi model kustom](#add-a-custom-model-option) Anda, itu mengonfirmasi ID dengan penyedia Anda pertama kali sesi beralih ke sana. Konfirmasi berjalan di setiap penyedia, dan ID yang tidak ditawarkan penyedia Anda ditolak pada saat peralihan daripada gagal pada permintaan berikutnya Anda.

174* **Remote Control**: di Anthropic API, Claude Code memeriksa nilai secara lokal dan tidak mengirim permintaan.174* **Remote Control**: di Anthropic API, Claude Code memeriksa nilai secara lokal dan tidak mengirim permintaan.

175 175

176Lihat [Model bukan ID model yang dikenali](/docs/id/errors#model-is-not-a-recognized-model-id) dan [Model tidak ditemukan](/docs/id/errors#model-not-found) untuk pesan.176Lihat [Model is not a recognized model id](/docs/id/errors#model-is-not-a-recognized-model-id) dan [Model not found](/docs/id/errors#model-not-found) untuk pesannya.

177 177

178Jika Anda menetapkan model dengan flag `--model`, variabel lingkungan `ANTHROPIC_MODEL`, atau pengaturan `model`, Claude Code tidak memeriksanya di muka, dan nilai yang salah ketik menghasilkan [Ada masalah dengan model yang dipilih](/docs/id/errors#theres-an-issue-with-the-selected-model) pada permintaan pertama.178Jika Anda menetapkan model dengan flag `--model`, environment variable `ANTHROPIC_MODEL`, atau pengaturan `model`, Claude Code tidak memeriksanya di muka, dan nilai yang salah ketik menghasilkan [There's an issue with the selected model](/docs/id/errors#theres-an-issue-with-the-selected-model) pada permintaan pertama.

179 179

180Ketika 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](/docs/id/headless) ketika menggunakan format output teks default. Pemeriksaan juga mencakup `model` yang ditetapkan dalam [frontmatter subagent](/docs/id/sub-agents). Peringatan stderr ditekan untuk `--output-format json` dan `stream-json`; baca model aktual dari bidang `modelUsage` dari [pesan hasil](/docs/id/headless#get-structured-output) sebagai gantinya.180Ketika 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](/docs/id/headless) ketika menggunakan format output teks default. Pemeriksaan juga mencakup `model` yang ditetapkan dalam [frontmatter subagent](/docs/id/sub-agents). Peringatan stderr ditekan untuk `--output-format json` dan `stream-json`; baca model aktual dari bidang `modelUsage` dari [pesan hasil](/docs/id/headless#get-structured-output) sebagai gantinya.

181 181

208 208

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

210 210

211Claude Code memulai sesi baru di model variabel hanya ketika tidak ada yang memilih model:211Claude Code memulai sesi baru di model variabel hanya ketika tidak ada dari hal-hal berikut yang memilih model:

212 212

213* Flag `--model`213* Flag `--model`

214* `ANTHROPIC_MODEL`214* `ANTHROPIC_MODEL`

215* Nilai `model` dalam file pengaturan apa pun, termasuk pilihan yang Anda simpan dengan `/model`215* Nilai `model` dalam file pengaturan apa pun, termasuk pilihan yang Anda simpan dengan `/model`

216* [Model default organisasi](#organization-default-model)216* [Model default organisasi](#organization-default-model)

217 217

218Pilihan 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`.218Pilihan yang Anda simpan dengan `/model` diutamakan daripada 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`.

219 219

220Claude 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.220Claude 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.

221 221

223 223

224* Anda menetapkannya ke `default`, `inherit`, `opusplan`, atau `haiku`224* Anda menetapkannya ke `default`, `inherit`, `opusplan`, atau `haiku`

225* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) aktif225* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) aktif

226* Organisasi Anda [pembatasan model](#restrict-model-selection) mengecualikan model226* [Pembatasan model](#restrict-model-selection) organisasi Anda mengecualikan model

227* Model tidak tersedia untuk akun Anda227* Model tidak tersedia untuk akun Anda

228 228

229Ketika 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](#setting-your-model).229Ketika 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](#setting-your-model).

234 234

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

236 236

237* **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.237* **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 membiarkan default yang disimpan tidak berubah.

238* **Sesuatu dengan prioritas lebih tinggi menetapkan model.** Nilai `model` dalam pengaturan proyek atau terkelola, `ANTHROPIC_MODEL` di shell Anda, atau [default organisasi](#organization-default-model) 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.238* **Sesuatu dengan prioritas lebih tinggi menetapkan model.** Nilai `model` dalam pengaturan proyek atau terkelola, `ANTHROPIC_MODEL` di shell Anda, atau [default organisasi](#organization-default-model) yang admin Anda tetapkan untuk menimpa pilihan pengguna berlaku lagi di setiap peluncuran. Pilihan `/model` Anda masih disimpan; itu dikalahkan oleh prioritas yang lebih tinggi. Ketika pengaturan proyek atau terkelola menetapkan model, header startup menyebutkan file tersebut.

239* **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](/docs/id/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).239* **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 read-only, 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](/docs/id/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

240* **Anda melanjutkan sesi.** Sesi yang Anda lanjutkan dengan `claude --resume` atau `--continue` biasanya [menyimpan model yang digunakan](#setting-your-model) daripada default saat ini Anda.240* **Anda melanjutkan sesi.** Sesi yang Anda lanjutkan dengan `claude --resume` atau `--continue` biasanya [mempertahankan model yang digunakannya](#setting-your-model) daripada default Anda saat ini.

241 241

242<h2 id="restrict-model-selection">242<h2 id="restrict-model-selection">

243 Batasi pemilihan model243 Batasi pemilihan model

310* Sesi [Claude Tag](https://claude.com/docs/claude-tag/overview) berjalan di lingkungan cloud tetapi tidak menerima pengaturan terkelola server; dalam [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), mereka masih membaca file pengaturan terkelola dalam gambar runner. Untuk menetapkan model untuk sesi tersebut, lihat [Pilih model untuk cakupan](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) dalam panduan admin Claude Tag.310* Sesi [Claude Tag](https://claude.com/docs/claude-tag/overview) berjalan di lingkungan cloud tetapi tidak menerima pengaturan terkelola server; dalam [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), mereka masih membaca file pengaturan terkelola dalam gambar runner. Untuk menetapkan model untuk sesi tersebut, lihat [Pilih model untuk cakupan](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) dalam panduan admin Claude Tag.

311* Cowork, tab pekerjaan agentic dalam aplikasi Claude Desktop, menjalankan sesinya pada Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. Ketika daftar `availableModels` dalam pengaturan terkelola server Anda tidak kosong dan pengguna memilih model di luar itu, server menolak model itu untuk sesi Cowork jarak jauh. 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 diterapkan perangkat tidak ada.311* Cowork, tab pekerjaan agentic dalam aplikasi Claude Desktop, menjalankan sesinya pada Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. Ketika daftar `availableModels` dalam pengaturan terkelola server Anda tidak kosong dan pengguna memilih model di luar itu, server menolak model itu untuk sesi Cowork jarak jauh. 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 diterapkan perangkat tidak ada.

312* Sesi pada [penyedia pihak ketiga](/docs/id/server-managed-settings#platform-availability) seperti Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws) tidak menerima pengaturan terkelola server, jadi kirimkan daftar putih melalui file MDM atau pengaturan terkelola di sana.312* Sesi pada [penyedia pihak ketiga](/docs/id/server-managed-settings#platform-availability) seperti Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws) tidak menerima pengaturan terkelola server, jadi kirimkan daftar putih melalui file MDM atau pengaturan terkelola di sana.

313* Pengiriman terkelola server juga memerlukan sesi untuk mengautentikasi dengan [login atau kunci yang memenuhi syarat](/docs/id/server-managed-settings#platform-availability). Armada yang menghasilkan kunci hanya melalui skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) harus mengirimkan daftar putih melalui file MDM atau pengaturan terkelola.313* Pengiriman dari konsol admin juga memerlukan sesi untuk melakukan pengambilan dengan [login yang memenuhi syarat](/docs/id/server-managed-settings#platform-availability) ke organisasi Anda atau token OAuth yang diterbitkan untuknya. Untuk armada yang mengautentikasi dengan kunci API, baik yang dikonfigurasi secara langsung maupun yang dihasilkan oleh skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), kirimkan allowlist melalui file MDM atau pengaturan terkelola.

314* Tab Code Desktop juga menampilkan [sesi SSH](/docs/id/desktop#ssh-sessions), yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat [Pengaturan terkelola Desktop](/docs/id/desktop#managed-settings).314* Tab Code Desktop juga menampilkan [sesi SSH](/docs/id/desktop#ssh-sessions), yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat [Pengaturan terkelola Desktop](/docs/id/desktop#managed-settings).

315* Pemilih model di claude.ai dan dalam aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar putih organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; itu tidak memberlakukan daftar putih.315* Pemilih model di claude.ai dan dalam aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar putih organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; itu tidak memberlakukan daftar putih.

316 316

428 428

429Model 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 menyimpan model saat ini.429Model 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 menyimpan model saat ini.

430 430

431Alias keluarga model [](#restrict-model-selection) seperti `opus` diselesaikan ke model biasanya ketika organisasi memungkinkannya. Ketika organisasi membatasi model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan organisasi, 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.431[Alias keluarga model](#restrict-model-selection) seperti `opus` diselesaikan ke model biasanya ketika organisasi memungkinkannya. Ketika organisasi membatasi model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan organisasi, 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.

432 432

433Pembatasan berlaku di seluruh organisasi atau per peran:433Pembatasan berlaku di seluruh organisasi atau per peran:

434 434

500 500

501Ketika admin telah menetapkan [model default organisasi](#organization-default-model), `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`](#set-a-default-model-for-new-sessions), di bawah kondisi yang tercantum di bagiannya, atau ke model [yang tercatat pada akun Anda](#setting-your-model).501Ketika admin telah menetapkan [model default organisasi](#organization-default-model), `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`](#set-a-default-model-for-new-sessions), di bawah kondisi yang tercantum di bagiannya, atau ke model [yang tercatat pada akun Anda](#setting-your-model).

502 502

503Ketika tidak ada yang tercatat pada akun Anda, pengaturan terkelola [memberlakukan daftar yang diizinkan untuk model Default](#enforce-the-allowlist-for-the-default-model), dan default jenis akun tidak ada dalam `availableModels`, `default` diselesaikan ke Default yang diberlakukan alih-alih default jenis akun di atas. Ketika default organisasi dan penegakan 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.503Ketika tidak ada yang tercatat pada akun Anda, pengaturan terkelola [memberlakukan allowlist untuk model Default](#enforce-the-allowlist-for-the-default-model), dan default jenis akun tidak ada dalam `availableModels`, `default` diselesaikan ke Default yang diberlakukan alih-alih default jenis akun di atas. Ketika default organisasi dan penegakan keduanya berlaku, default organisasi menggantikan default jenis akun terlebih dahulu dan penegakan kemudian diterapkan padanya: default organisasi yang ada dalam allowlist dipertahankan, sementara yang di luar daftar diselesaikan ke Default yang diberlakukan.

504 504

505Model 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](#work-with-fable).505Model 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](#work-with-fable).

506 506

510 510

511Alias model `opusplan` menyediakan pendekatan hibrida otomatis:511Alias model `opusplan` menyediakan pendekatan hibrida otomatis:

512 512

513* **Dalam Plan Mode**: menggunakan `opus` untuk penalaran kompleks dan keputusan arsitektur513* **Dalam plan mode**: menggunakan `opus` untuk penalaran kompleks dan keputusan arsitektur

514* **Dalam execution mode**: secara otomatis beralih ke `sonnet` untuk pembuatan kode dan implementasi514* **Dalam execution mode**: secara otomatis beralih ke `sonnet` untuk pembuatan kode dan implementasi

515 515

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

517 517

518Fase 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](#extended-context) 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](#setting-your-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.518Fase Opus plan mode menggunakan context window yang sama dengan pengaturan model `opus`, dan fase eksekusi menggunakan window yang sama dengan `sonnet`. Ketika `opus` dan `sonnet` diselesaikan ke model yang berjalan dengan [context window 1M](#extended-context) 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](#setting-your-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.

519 519

520Ketika [`availableModels`](#restrict-model-selection) 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.520Ketika [`availableModels`](#restrict-model-selection) 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 allowlist mengizinkan yang lebih lama.

521 521

522Substitusi versi yang lebih lama yang diizinkan berlaku pada Anthropic API dan [Claude Platform on AWS](/docs/id/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.522Substitusi versi yang lebih lama yang diizinkan berlaku pada Anthropic API dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws). Pada Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan Mantle, yang deployment-nya menggunakan ID model khusus penyedia, plan mode tetap pada model sesi kapan pun model upgrade dikecualikan.

523 523

524Untuk pendekatan hibrida di mana Claude memutuskan di tengah-tugas kapan harus berkonsultasi dengan model kedua daripada beralih di batas rencana, lihat [alat advisor](/docs/id/advisor).524Untuk pendekatan hibrida di mana Claude memutuskan di tengah-tugas kapan harus berkonsultasi dengan model kedua daripada beralih di batas rencana, lihat [tool advisor](/docs/id/advisor).

525 525

526<h3 id="fallback-model-chains">526<h3 id="fallback-model-chains">

527 Rantai model fallback527 Rantai model fallback

528</h3>528</h3>

529 529

530Ketika 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](/docs/id/errors#automatic-retries), tidak pernah memicu switch; mereka mengikuti penanganan retry dan error normal mereka. Ini beralih ketika [Amazon Bedrock](/docs/id/amazon-bedrock#when-a-model-is-disabled-mid-session) atau [Google Cloud's Agent Platform](/docs/id/google-vertex-ai#when-a-model-is-disabled-mid-session) menolak model yang akun Anda tidak dapat memanggil, yang Claude Code perlakukan sebagai model tidak tersedia daripada sebagai error autentikasi.530Ketika model utama kelebihan beban, tidak tersedia, atau mengembalikan kesalahan server non-retryable lainnya, Claude Code dapat beralih ke model fallback alih-alih menggagalkan permintaan. Kesalahan autentikasi, penagihan, rate limit, ukuran permintaan, dan transportasi, serta [penolakan oleh pemeriksaan kebijakan organisasi Anda](/docs/id/errors#automatic-retries), tidak pernah memicu peralihan; kesalahan tersebut mengikuti penanganan retry dan error normalnya. Claude Code beralih ketika [Amazon Bedrock](/docs/id/amazon-bedrock#when-a-model-is-disabled-mid-session) atau [Google Cloud's Agent Platform](/docs/id/google-vertex-ai#when-a-model-is-disabled-mid-session) menolak model yang tidak dapat dipanggil oleh akun Anda, yang Claude Code perlakukan sebagai model tidak tersedia daripada sebagai error autentikasi.

531 531

532Konfigurasikan 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.532Konfigurasikan satu atau lebih model fallback dan Claude Code mencobanya secara berurutan, menampilkan pemberitahuan saat beralih. Peralihan 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.

533 533

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

535 535

537claude --fallback-model sonnet,haiku537claude --fallback-model sonnet,haiku

538```538```

539 539

540Untuk mempertahankan rantai di seluruh sesi, atur `fallbackModel` dalam [settings](/docs/id/settings) sebagai array:540Untuk mempertahankan rantai di seluruh sesi, atur `fallbackModel` dalam [pengaturan](/docs/id/settings) sebagai array:

541 541

542```json theme={null}542```json theme={null}

543{543{

545}545}

546```546```

547 547

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

549 549

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

551 551

552Ketika 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:552Ketika 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 penelusuran itu dimulai:

553 553

554* **Di luar daftar yang diizinkan**: Claude Code menghapus entri apa pun yang tidak diizinkan oleh [`availableModels`](#restrict-model-selection) saat membaca rantai.554* **Di luar allowlist**: Claude Code menghapus entri apa pun yang tidak diizinkan oleh [`availableModels`](#restrict-model-selection) saat membaca rantai.

555* **Jendela konteks lebih kecil selama compaction**: rantai juga mencakup [compaction](/docs/id/context-window#what-survives-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.555* **Context window lebih kecil selama compaction**: rantai juga mencakup [compaction](/docs/id/context-window#what-survives-compaction), tetapi Claude Code tidak akan fallback ke model dengan context window 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 ulang.

556 556

557Claude Code juga menerapkan rantai ke [subagents](/docs/id/sub-agents). 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.557Claude Code juga menerapkan rantai ke [subagent](/docs/id/sub-agents). 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 dicakup rantai justru mengakhiri subagent.

558 558

559<h3 id="automatic-model-fallback">559<h3 id="automatic-model-fallback">

560 Fallback model otomatis560 Fallback model otomatis

562 562

563Bagian ini mencakup fallback berbasis konten dari model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5. Untuk fallback berbasis ketersediaan ketika model kelebihan beban atau tidak tersedia, lihat [Rantai model fallback](#fallback-model-chains).563Bagian ini mencakup fallback berbasis konten dari model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5. Untuk fallback berbasis ketersediaan ketika model kelebihan beban atau tidak tersedia, lihat [Rantai model fallback](#fallback-model-chains).

564 564

565Model Fable, Opus 5.5, Sonnet 5.5, 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:565Model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5 berjalan dengan pengklasifikasi keamanan, yang paling sering menandai konten keamanan siber dan biologi. Untuk dua kategori tersebut, model fallback tergantung pada model mana yang menolak:

566 566

567* **Fable 5.1, Fable 5, dan Opus 5.5**: permintaan yang ditandai biologi dijalankan kembali pada Opus 5, dan permintaan yang ditandai keamanan siber dijalankan kembali pada Opus 4.8.567* **Fable 5.1, Fable 5, dan Opus 5.5**: permintaan yang ditandai biologi dijalankan kembali pada Opus 5, dan permintaan yang ditandai keamanan siber dijalankan kembali pada Opus 4.8.

568* **Sonnet 5.5**: permintaan yang ditandai keamanan siber dijalankan kembali pada Sonnet 5. Permintaan yang ditandai biologi berakhir dengan penolakan, karena Sonnet 5.5 tidak memiliki model fallback biologi.568* **Sonnet 5.5**: permintaan yang ditandai keamanan siber dijalankan kembali pada Sonnet 5. Permintaan yang ditandai biologi berakhir dengan penolakan, karena Sonnet 5.5 tidak memiliki model fallback biologi.

569* **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.569* **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.

570 570

571Pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, Claude Code menyelesaikan target ini melalui ID model penerapan Anda sebagai gantinya. Lihat [Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).571Pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, Claude Code menyelesaikan target ini melalui ID model deployment Anda sebagai gantinya. Lihat [Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

572

573Ketika Claude Code mengalihkan permintaan yang ditandai ke model fallback untuk kategorinya, Claude Code menjalankan kembali permintaan pada model tersebut. Dalam percakapan utama Anda, Claude Code menampilkan pemberitahuan dalam transkrip. Untuk ditanya terlebih dahulu, lihat [Tanyakan sebelum beralih](#ask-before-switching).

572 574

573Setelah fallback, sesi berlanjut pada model fallback. Untuk kembali ke model asli Anda, jalankan [`/model`](#setting-your-model).575Setelah fallback, sesi berlanjut pada model fallback. Untuk kembali ke model asli Anda, jalankan [`/model`](#setting-your-model).

574 576

580 Tingkat effort setelah fallback582 Tingkat effort setelah fallback

581</h4>583</h4>

582 584

583Ketika Claude Code mengalihkan sesi Anda ke model fallback, Claude Code mempertahankan tingkat effort yang digunakan oleh permintaan yang ditandai sebagai pengganti effort default model tersebut. Misalnya, sesi pada Opus 5.5 dengan default `medium` yang fallback ke Opus 4.8 tetap pada `medium`, meskipun Opus 4.8 default ke `high`.585Ketika Claude Code mengalihkan sesi Anda ke model fallback, Claude Code mempertahankan tingkat effort yang digunakan oleh permintaan yang ditandai. Misalnya, sesi pada Opus 5.5 dengan default `medium` yang fallback ke Opus 4.8 tetap pada `medium`, meskipun Opus 4.8 default ke `high`.

584 586

585Tingkat yang berbeda berlaku dalam kasus seperti berikut:587Tingkat yang berbeda berlaku dalam kasus seperti berikut:

586 588

587* **Pengaturan atau default organisasi**: tingkat dalam pengaturan Anda yang berlaku untuk model fallback, atau effort default yang ditetapkan organisasi Anda untuknya, berlaku sebagai gantinya.

588* **Perubahan Anda sendiri**: setelah Anda memilih tingkat effort, memilih model di `/model`, atau melanjutkan sesi nanti, tingkat dari permintaan yang ditandai tidak lagi terbawa.589* **Perubahan Anda sendiri**: setelah Anda memilih tingkat effort, memilih model di `/model`, atau melanjutkan sesi nanti, tingkat dari permintaan yang ditandai tidak lagi terbawa.

589* **Effort skill**: tingkat yang ditetapkan oleh frontmatter `effort` sebuah skill untuk permintaan yang ditandai berlaku untuk giliran itu, dan giliran berikutnya berjalan pada tingkat yang diberikan [urutan resolusi effort](#adjust-effort-level) untuk model fallback.590* **Effort skill**: tingkat yang ditetapkan oleh frontmatter `effort` sebuah skill untuk permintaan yang ditandai berlaku untuk giliran itu, dan giliran berikutnya berjalan pada tingkat yang diberikan [urutan resolusi effort](#adjust-effort-level) untuk model fallback.

590 591

591Header sesi menampilkan tingkat yang berlaku di sebelah nama model. Untuk mengubahnya, jalankan `/effort` dalam sesi.592Dalam sesi, jalankan `/effort status` untuk melihat tingkat yang berlaku, atau `/effort` untuk mengubahnya.

592 593

593<h4 id="check-what-triggered-fallback">594<h4 id="check-what-triggered-fallback">

594 Periksa apa yang memicu fallback595 Periksa apa yang memicu fallback

595</h4>596</h4>

596 597

597Fallback 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.598Fallback dapat terpicu pada permintaan pertama sesi, sebelum Anda mengirim apa pun yang tidak biasa, karena permintaan pertama membawa konteks workspace seperti konten CLAUDE.md dan status git Anda. Repositori yang berisi materi keamanan atau biologi dapat memicu pengklasifikasi pada konteks itu saja.

598 599

599Untuk 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.600Untuk 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.

600 601

602 Tanyakan sebelum beralih603 Tanyakan sebelum beralih

603</h4>604</h4>

604 605

605Untuk 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`](/docs/id/settings-reference#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.606Untuk memutuskan apa yang terjadi setiap kali permintaan ditandai, jalankan `/config`, pilih **Switch models when a message is flagged**, dan pilih **Ask each time**. Anda juga dapat mengatur [`switchModelsOnFlag`](/docs/id/settings-reference#switchmodelsonflag) ke `false` dalam file pengaturan Anda. Claude Code kemudian berhenti sejenak pada permintaan yang ditandai yang akan mengalihkan model dan memberi Anda dua opsi: beralih ke model fallback, atau edit prompt dan coba lagi.

607

608Pertama kali permintaan yang ditandai akan mengalihkan model dalam sesi interaktif, Claude Code mungkin bertanya apakah akan beralih secara otomatis sejak saat itu. Claude Code hanya bertanya jika Anda belum menetapkan `switchModelsOnFlag`, dan menyimpan pilihan Anda sebagai kunci tersebut dalam pengaturan pengguna Anda.

609

610Jika Anda memilih untuk tetap pada model saat ini, nilai yang disimpan adalah `false`, sama seperti **Ask each time**. Jika Anda menutup pertanyaan tersebut, Claude Code tidak menyimpan apa pun dan bertanya lagi saat berikutnya permintaan yang ditandai akan mengalihkan model.

606 611

607Beberapa kasus berperilaku berbeda:612Ketika Anda telah memilih **Ask each time**, beberapa kasus berperilaku berbeda:

608 613

609* Ketika kategori yang ditandai tidak memiliki model fallback, seperti flag biologi pada Opus 5 atau Sonnet 5.5, Claude Code tidak menampilkan prompt dan permintaan berakhir dengan penolakan.614* Ketika kategori yang ditandai tidak memiliki model fallback, seperti flag biologi pada Opus 5 atau Sonnet 5.5, Claude Code tidak menampilkan prompt dan permintaan berakhir dengan penolakan.

610* Jika kedua model menandai permintaan yang sama, Anda dapat mengedit prompt dan mencoba lagi, atau memulai sesi baru.615* Jika kedua model menandai permintaan yang sama, Anda dapat mengedit prompt dan mencoba ulang, atau memulai sesi baru.

611* Pada [cloud sessions](/docs/id/claude-code-on-the-web) di aplikasi mobile, pengeditan dan pengulangan tidak didukung. Beralih model, atau lanjutkan sesi dari browser desktop atau aplikasi desktop.616* Pada [sesi cloud](/docs/id/claude-code-on-the-web) di aplikasi mobile, mengedit dan mencoba ulang tidak didukung. Beralih model, atau lanjutkan sesi dari browser desktop atau aplikasi desktop.

612* Dalam [mode non-interaktif](/docs/id/cli-reference#cli-flags) dan integrasi SDK yang tidak dapat menampilkan prompt, permintaan yang ditandai mengakhiri giliran dengan penolakan.617* Dalam [mode non-interaktif](/docs/id/cli-reference#cli-flags) dan integrasi SDK yang tidak dapat menampilkan prompt, permintaan yang ditandai mengakhiri giliran dengan penolakan.

618* Dalam [subagent](/docs/id/sub-agents), Claude Code tidak menampilkan prompt, dan permintaan yang ditandai yang akan mengalihkan model dijalankan kembali pada model fallback.

613* Ketika target fallback diblokir oleh [`availableModels`](#restrict-model-selection), Claude Code tidak menampilkan prompt. Permintaan yang ditandai berakhir dengan penolakan, sama seperti fallback otomatis ketika target diblokir.619* Ketika target fallback diblokir oleh [`availableModels`](#restrict-model-selection), Claude Code tidak menampilkan prompt. Permintaan yang ditandai berakhir dengan penolakan, sama seperti fallback otomatis ketika target diblokir.

614 620

615<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">621<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

616 Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry622 Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry

617</h4>623</h4>

618 624

619Pada [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), ID model khusus penyedia, jadi fallback otomatis hanya beroperasi ketika Claude Code dapat mengidentifikasi setiap model yang terlibat:625Pada [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), ID model bersifat khusus penyedia, jadi fallback otomatis hanya beroperasi ketika Claude Code dapat mengidentifikasi setiap model yang terlibat:

620 626

621* 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`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5, dan Opus 5 dikenali oleh ID model penyedianya atau pemetaan [`modelOverrides`](#override-model-ids-per-version).627* 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`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5, dan Opus 5 dikenali oleh ID model penyedianya atau pemetaan [`modelOverrides`](#override-model-ids-per-version).

622* Target Opus harus diselesaikan dalam penerapan Anda, model mana pun yang menolak: atur `ANTHROPIC_DEFAULT_OPUS_MODEL`, atau simpan entri Opus 4.8 dalam daftar model penyedia. Tanpa satu, fallback tetap mati untuk setiap model sumber, termasuk Sonnet 5.5, dan permintaan yang ditandai berakhir dengan penolakan.628* Target Opus harus diselesaikan dalam deployment Anda, model mana pun yang menolak: atur `ANTHROPIC_DEFAULT_OPUS_MODEL`, atau simpan entri Opus 4.8 dalam daftar model penyedia. Tanpa salah satunya, fallback tetap mati untuk setiap model sumber, termasuk Sonnet 5.5, dan permintaan yang ditandai berakhir dengan penolakan.

623* Model fallback kategori yang ditandai harus diselesaikan dalam penerapan Anda. Dari model Fable, Opus 5.5, atau Opus 5, 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, dan permintaan yang ditandai biologi dari model Fable atau Opus 5.5 pada entri Opus 5. Dari Sonnet 5.5, permintaan yang ditandai keamanan siber dijalankan kembali pada model yang Anda atur dalam `ANTHROPIC_DEFAULT_SONNET_MODEL`, atau pada entri Sonnet 5 dalam daftar model penyedia jika Anda tidak menetapkannya.629* Model fallback kategori yang ditandai harus diselesaikan dalam deployment Anda. Dari model Fable, Opus 5.5, atau Opus 5, 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, dan permintaan yang ditandai biologi dari model Fable atau Opus 5.5 pada entri Opus 5. Dari Sonnet 5.5, permintaan yang ditandai keamanan siber dijalankan kembali pada model yang Anda atur dalam `ANTHROPIC_DEFAULT_SONNET_MODEL`, atau pada entri Sonnet 5 dalam daftar model penyedia jika Anda tidak menetapkannya.

624 630

625Jika salah satu model tidak dapat diidentifikasi, Claude Code tidak beralih. Permintaan yang ditandai berakhir dengan pesan penolakan, dan Anda dapat beralih model dengan [`/model`](#setting-your-model) dan mencoba lagi. Untuk membuat kedua model dapat diidentifikasi, atur pin untuk model sumber Anda:631Jika salah satu model tidak dapat diidentifikasi, Claude Code tidak beralih. Permintaan yang ditandai berakhir dengan pesan penolakan, dan Anda dapat beralih model dengan [`/model`](#setting-your-model) dan mencoba ulang. Untuk membuat kedua model dapat diidentifikasi, atur pin untuk model sumber Anda:

626 632

627* **Model Fable**: atur `ANTHROPIC_DEFAULT_FABLE_MODEL` ke ID model Fable Anda sehingga Claude Code mengenalinya sebagai sumber fallback.633* **Model Fable**: atur `ANTHROPIC_DEFAULT_FABLE_MODEL` ke ID model Fable Anda sehingga Claude Code mengenalinya sebagai sumber fallback.

628* **Setiap model sumber**: atur `ANTHROPIC_DEFAULT_OPUS_MODEL` ke ID model Opus untuk mengaktifkan fallback dan memberikan kategori yang ditandai target. Pin yang menamai model di luar keluarga Opus, atau model yang menolak, membiarkan penolakan berdiri.634* **Setiap model sumber**: atur `ANTHROPIC_DEFAULT_OPUS_MODEL` ke ID model Opus untuk mengaktifkan fallback dan memberikan target bagi kategori yang ditandai. Pin yang menamai model di luar keluarga Opus, atau model yang menolak, membiarkan penolakan tetap berlaku.

629* **Sonnet 5.5**: selain pin Opus, atur `ANTHROPIC_DEFAULT_SONNET_MODEL` atau simpan entri Sonnet 5 dalam daftar model penyedia untuk memasok model yang permintaan dijalankan kembali. Pin Sonnet yang menamai model di luar keluarga Sonnet, atau Sonnet 5.5 itu sendiri, membiarkan penolakan berdiri.635* **Sonnet 5.5**: selain pin Opus, atur `ANTHROPIC_DEFAULT_SONNET_MODEL` atau simpan entri Sonnet 5 dalam daftar model penyedia untuk menyediakan model tempat permintaan dijalankan kembali. Pin Sonnet yang menamai model di luar keluarga Sonnet, atau Sonnet 5.5 itu sendiri, membiarkan penolakan tetap berlaku.

636

637Model fallback juga harus memiliki context window setidaknya sebesar context window sesi, atau Claude Code tidak beralih dan permintaan yang ditandai berakhir dengan penolakan yang sama. Pada penyedia ini, model sumber berjalan dengan [context window 1M](#extended-context) secara default. Sematkan model yang juga demikian, seperti Opus 4.8 dalam `ANTHROPIC_DEFAULT_OPUS_MODEL` atau Sonnet 5 dalam `ANTHROPIC_DEFAULT_SONNET_MODEL`, dengan ID yang [dapat dicocokkan Claude Code dengan model tersebut](#pin-models-for-third-party-deployments).

630 638

631<h4 id="security-research-and-biology-workloads">639<h4 id="security-research-and-biology-workloads">

632 Penelitian keamanan dan beban kerja biologi640 Penelitian keamanan dan beban kerja biologi

633</h4>641</h4>

634 642

635Beban 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, Fable 5, atau Opus 5.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 dan Sonnet 5.5, Anda mendapatkan penolakan tersebut dari permintaan pertama yang ditandai.643Beban kerja dalam keamanan ofensif atau biologi, termasuk penetration testing, latihan Capture the Flag (CTF), dan codebase yang berkaitan dengan biologi, sering memicu fallback, sering kali pada permintaan pertama. Untuk pekerjaan biologi substantif pada Fable 5.1, Fable 5, atau Opus 5.5, permintaan pertama yang ditandai yang mengalihkan model memindahkan sesi ke Opus 5, dan permintaan yang ditandai biologi berikutnya berakhir dengan penolakan di sana, karena Opus 5 tidak memiliki fallback biologi. Pada Opus 5 dan Sonnet 5.5, Anda mendapatkan penolakan tersebut sejak permintaan pertama yang ditandai.

636 644

637Ini 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.645Ini 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.

638 646

639<h3 id="adjust-effort-level">647<h3 id="adjust-effort-level">

640 Sesuaikan tingkat usaha648 Sesuaikan tingkat effort

641</h3>649</h3>

642 650

643[Tingkat usaha](https://platform.claude.com/docs/en/build-with-claude/effort) 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.651[Tingkat effort](https://platform.claude.com/docs/en/build-with-claude/effort) mengontrol penalaran adaptif, yang memungkinkan model memutuskan apakah dan berapa banyak untuk berpikir pada setiap langkah berdasarkan kompleksitas tugas. Effort lebih rendah lebih cepat dan lebih murah untuk tugas-tugas sederhana, sementara effort lebih tinggi memberikan penalaran lebih dalam untuk masalah kompleks.

644 652

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

646 654

647| Model | Tingkat |655| Model | Tingkat |

648| :- | :- |656| :- | :- |

652 660

653Jika 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 atau pengaturan Anda sendiri juga dapat membatasi tingkat mana yang tersedia untuk model; lihat [Batas usaha organisasi](#organization-effort-limits).661Jika Anda menetapkan tingkat yang tidak didukung model aktif, 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 atau pengaturan Anda sendiri juga dapat membatasi tingkat yang ditawarkan model; lihat [Batas effort organisasi](#organization-effort-limits).

662

663Claude Code menyelesaikan tingkat effort sesi dalam urutan ini, mengambil yang pertama yang berlaku:

654 664

655Claude Code menyelesaikan tingkat usaha sesi dalam urutan ini, mengambil yang pertama yang berlaku:6651. Pilihan eksplisit: environment variable [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/id/env-vars#variables), peluncuran dengan `--effort`, atau `/effort` dalam sesi ([`/effort` non-interaktif memiliki efek lebih sempit](#non-interactive-effort))

6662. Pengaturan Anda: tingkat yang Anda simpan untuk model atau kunci [`effortLevel`](/docs/id/settings-reference#effortlevel), dengan prioritas di antara keduanya dan di seluruh file pengaturan yang dinyatakan pada [`modelSettings`](/docs/id/settings-reference#modelsettings)

6673. Effort default model: `high` pada setiap model yang mendukung effort, kecuali Opus 5.5, Sonnet 5.5, dan Haiku 5.5 default ke `medium`, Opus 4.7 default ke `xhigh`, dan, ketika organisasi Anda menetapkan tingkat effort default untuk [model default organisasinya](#organization-default-model), tingkat itu adalah default ketika Anda menjalankan model tersebut

656 668

6571. Pilihan eksplisit: variabel lingkungan [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/id/env-vars#variables), peluncuran dengan `--effort`, atau `/effort` dalam sesi ([`/effort` non-interaktif memiliki efek lebih sempit](#non-interactive-effort))669Setelah fallback model otomatis, lihat [Tingkat effort setelah fallback](#effort-level-after-a-fallback) untuk tingkat yang berlaku.

6582. Pengaturan Anda: tingkat yang Anda simpan untuk model atau kunci [`effortLevel`](/docs/id/settings-reference#effortlevel), dengan prioritas di antara mereka dan di seluruh file pengaturan yang dinyatakan pada [`modelSettings`](/docs/id/settings-reference#modelsettings)

6593. Effort default model: `high` pada setiap model yang mendukung effort, kecuali Opus 5.5, Sonnet 5.5, dan Haiku 5.5 default ke `medium`, Opus 4.7 default ke `xhigh`, dan, ketika organisasi Anda menetapkan tingkat effort default untuk [model default organisasinya](#organization-default-model), tingkat itu adalah default ketika Anda menjalankan model tersebut. Setelah fallback model otomatis, lihat [Tingkat effort setelah fallback](#effort-level-after-a-fallback) untuk tingkat yang berlaku.

660 670

661Opus 5.5 dimulai pada `medium` kecuali salah satu sumber di atas menetapkan tingkat untuk itu, dan `effortLevel` tingkat atas dalam file pengaturan pengguna Anda tidak dihitung untuk Opus 5.5. Kunci itu adalah bentuk yang lebih lama `/effort` ditulis sebelum Claude Code menyimpan tingkat per model: itu terus berlaku di mana itu berlaku sebelumnya, pada Opus 5, Fable 5.1, dan model sebelumnya, sementara Opus 5.5 dan model yang dirilis setelahnya dimulai pada default mereka sendiri sampai Anda memilih tingkat untuk mereka dengan `/effort` atau pengambil `/model`. `effortLevel` tingkat atas dalam pengaturan proyek, lokal, atau terkelola, atau yang dilewatkan dengan `--settings`, berlaku untuk setiap model.671Opus 5.5 dimulai pada `medium` kecuali salah satu sumber di atas menetapkan tingkat untuknya, dan `effortLevel` tingkat atas dalam file pengaturan pengguna Anda tidak dihitung untuk Opus 5.5. Kunci itu adalah bentuk lama yang ditulis `/effort` sebelum Claude Code menyimpan tingkat per model: kunci itu terus berlaku di tempat ia berlaku sebelumnya, pada Opus 5, Fable 5.1, dan model sebelumnya, sementara Opus 5.5 dan model yang dirilis setelahnya dimulai pada default mereka sendiri sampai Anda memilih tingkat untuk mereka dengan `/effort` atau pemilih `/model`. `effortLevel` tingkat atas dalam pengaturan proyek, lokal, atau terkelola, atau yang diteruskan dengan `--settings`, berlaku untuk setiap model.

662 672

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

664 674

665* `Enter` dalam slider `/effort` atau pengambil `/model`, atau tingkat yang diketik setelah `/effort`: simpan tingkat sebagai default Anda dan terapkan dalam sesi kemudian675* `Enter` dalam slider `/effort` atau pemilih `/model`, atau tingkat yang diketik setelah `/effort`: simpan tingkat sebagai default Anda dan terapkan dalam sesi berikutnya

666* `s` dalam slider `/effort` atau pengambil `/model`: terapkan tingkat ke sesi ini saja. Memerlukan Claude Code v2.1.257 atau lebih baru676* `s` dalam slider `/effort` atau pemilih `/model`: terapkan tingkat ke sesi ini saja. Memerlukan Claude Code v2.1.257 atau lebih baru

667 677

668Claude Code menyimpan tingkat per model, di bawah kunci [`modelSettings`](/docs/id/settings-reference#modelsettings) dalam pengaturan pengguna Anda, jadi setiap model menyimpan tingkat tersimpannya sendiri.678Claude Code menyimpan tingkat per model, di bawah kunci [`modelSettings`](/docs/id/settings-reference#modelsettings) dalam pengaturan pengguna Anda, jadi setiap model menyimpan tingkat tersimpannya sendiri.

669 679

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

671 681

672<Note>682<Note>

673 Tingkat yang Anda pilih dari kontrol usaha pada ponsel atau browser yang terhubung melalui [Remote Control](/docs/id/remote-control#what-connected-devices-see) berlaku untuk sesi itu saja.683 Tingkat yang Anda pilih dari kontrol effort pada ponsel atau browser yang terhubung melalui [Remote Control](/docs/id/remote-control#what-connected-devices-see) berlaku untuk sesi itu saja.

674</Note>684</Note>

675 685

676<span id="non-interactive-effort" />686<span id="non-interactive-effort" />

677 687

678Ketika Anda menetapkan tingkat dengan `/effort` dalam [run `-p`](/docs/id/headless), Claude Code menerapkannya ke sesi itu saja dan tidak menyimpannya sebagai default Anda.688Ketika Anda menetapkan tingkat dengan `/effort` dalam [run `-p`](/docs/id/headless), Claude Code menerapkannya ke sesi itu saja dan tidak menyimpannya sebagai default Anda.

679 689

680Slider `/effort` juga memiliki toggle **Ultracode**. Ultracode adalah pengaturan Claude Code daripada tingkat usaha model: dengan itu aktif, Claude mengorkestra [alur kerja dinamis](/docs/id/workflows) untuk tugas-tugas substantif, pada tingkat usaha apa pun sesi berjalan. Untuk di mana dapat diatur secara persisten, lihat pengaturan [`ultracode`](/docs/id/settings-reference#ultracode).690Slider `/effort` juga memiliki toggle **Ultracode**. Ultracode adalah pengaturan Claude Code, bukan tingkat effort model: ketika aktif, Claude mengorkestrasi [alur kerja dinamis](/docs/id/workflows) untuk tugas-tugas substantif, pada tingkat effort apa pun sesi berjalan. Untuk tempat pengaturan ini dapat ditetapkan secara persisten, lihat pengaturan [`ultracode`](/docs/id/settings-reference#ultracode).

681 691

682Mengaktifkan atau menonaktifkan ultracode dengan `/effort` atau pengaturan `ultracode` membiarkan tingkat usaha tidak berubah. Flag `--effort ultracode` dan nilai Agent SDK `effortLevel: "ultracode"` mengaktifkannya dan juga menetapkan tingkat ke `xhigh`. Memilih tingkat dalam slider `/effort` atau pengambil `/model` membiarkan ultracode seperti itu.692Mengaktifkan atau menonaktifkan ultracode dengan `/effort` atau pengaturan `ultracode` membiarkan tingkat effort tidak berubah. Flag `--effort ultracode` dan nilai Agent SDK `effortLevel: "ultracode"` mengaktifkannya dan juga menetapkan tingkat ke `xhigh`. Memilih tingkat dalam slider `/effort` atau pemilih `/model` membiarkan ultracode seperti semula.

683 693

684Anda dapat mengaktifkan ultracode melalui salah satu dari berikut ini:694Anda dapat mengaktifkan ultracode melalui salah satu dari berikut ini:

685 695

686* **`/effort`**: jalankan `/effort ultracode` untuk mengaktifkannya untuk sesi saat ini atau `/effort ultracode off` untuk menonaktifkannya. Dalam slider `/effort`, tekan `Tab` untuk membalik toggle **Ultracode**, kemudian `Enter` untuk menerapkannya696* **`/effort`**: jalankan `/effort ultracode` untuk mengaktifkannya untuk sesi saat ini atau `/effort ultracode off` untuk menonaktifkannya. Dalam slider `/effort`, tekan `Tab` untuk membalik toggle **Ultracode**, kemudian `Enter` untuk menerapkannya

687* **Flag `--effort`**: luncurkan dengan `claude --effort ultracode`, yang memulai sesi pada usaha `xhigh` dengan ultracode aktif697* **Flag `--effort`**: luncurkan dengan `claude --effort ultracode`, yang memulai sesi pada effort `xhigh` dengan ultracode aktif

688* **Pengaturan `ultracode`**: atur [`"ultracode": true`](/docs/id/settings-reference#ultracode) dalam file pengaturan, dengan `--settings`, atau dalam permintaan kontrol Agent SDK. Permintaan [`applyFlagSettings()`](/docs/id/agent-sdk/typescript#applyflagsettings) juga menerima `effortLevel: "ultracode"`, yang mengaktifkannya dan menetapkan tingkat usaha ke `xhigh`698* **Pengaturan `ultracode`**: atur [`"ultracode": true`](/docs/id/settings-reference#ultracode) dalam file pengaturan, dengan `--settings`, atau dalam permintaan kontrol Agent SDK. Permintaan [`applyFlagSettings()`](/docs/id/agent-sdk/typescript#applyflagsettings) juga menerima `effortLevel: "ultracode"`, yang mengaktifkannya dan menetapkan tingkat effort ke `xhigh`

689 699

690Bentuk `/effort ultracode off`, toggle slider, dan menjaga ultracode aktif pada tingkat usaha selain `xhigh` memerlukan Claude Code v2.1.284 atau lebih baru. Sebelum v2.1.284, mengaktifkan ultracode menetapkan sesi ke usaha `xhigh`, memilih tingkat lain menonaktifkannya, dan batas usaha di bawah `xhigh` membuatnya tidak tersedia.700Bentuk `/effort ultracode off`, toggle slider, dan menjaga ultracode aktif pada tingkat effort selain `xhigh` memerlukan Claude Code v2.1.284 atau lebih baru. Sebelum v2.1.284, mengaktifkan ultracode menetapkan sesi ke effort `xhigh`, memilih tingkat lain menonaktifkannya, dan batas effort di bawah `xhigh` membuatnya tidak tersedia.

691 701

692Melewatkan `ultracode` ke flag `--effort` atau nilai Agent SDK `effortLevel` memerlukan Claude Code v2.1.203 atau lebih baru. Sebelum v2.1.203, `--effort ultracode` mencetak `Unknown --effort value 'ultracode'` dan sesi dimulai pada usaha default.702Meneruskan `ultracode` ke flag `--effort` atau nilai Agent SDK `effortLevel` memerlukan Claude Code v2.1.203 atau lebih baru. Sebelum v2.1.203, `--effort ultracode` mencetak `Unknown --effort value 'ultracode'` dan sesi dimulai pada effort default.

693 703

694Pengaturan `effortLevel` yang bertahan dan variabel lingkungan `CLAUDE_CODE_EFFORT_LEVEL` tidak menerima `ultracode`. Jika `CLAUDE_CODE_EFFORT_LEVEL` atau [batas usaha](#organization-effort-limits) menetapkan tingkat sesi, ultracode tetap aktif pada tingkat itu.704Pengaturan `effortLevel` yang persisten dan environment variable `CLAUDE_CODE_EFFORT_LEVEL` tidak menerima `ultracode`. Jika `CLAUDE_CODE_EFFORT_LEVEL` atau [batas effort](#organization-effort-limits) menetapkan tingkat sesi, ultracode tetap aktif pada tingkat itu.

695 705

696<span id="when-ultracode-is-available" />706<span id="when-ultracode-is-available" />

697 707

698Ultracode tidak tersedia ketika:708Ultracode tidak tersedia ketika:

699 709

700* [Alur kerja dimatikan](/docs/id/workflows#turn-workflows-off)710* [Workflow dimatikan](/docs/id/workflows#turn-workflows-off)

701* Model tidak mendukung usaha `xhigh`711* Model tidak mendukung effort `xhigh`

702 712

703Dalam kasus tersebut `--effort ultracode` memulai sesi dengan ultracode mati, pada tingkat usaha tertinggi yang model dan batas apa pun izinkan, hingga `xhigh`.713Dalam kasus tersebut `--effort ultracode` memulai sesi dengan ultracode mati, pada tingkat effort tertinggi yang diizinkan model dan batas apa pun, hingga `xhigh`.

704 714

705<h4 id="choose-an-effort-level">715<h4 id="choose-an-effort-level">

706 Pilih tingkat usaha716 Pilih tingkat effort

707</h4>717</h4>

708 718

709Setiap tingkat menukar pengeluaran token terhadap kemampuan. Default cocok untuk sebagian besar tugas pengkodean; sesuaikan ketika Anda menginginkan keseimbangan berbeda.719Setiap tingkat menukar pengeluaran token dengan kemampuan. Default cocok untuk sebagian besar tugas pengkodean; sesuaikan ketika Anda menginginkan keseimbangan berbeda.

710 720

711| Tingkat | Kapan menggunakannya |721| Tingkat | Kapan menggunakannya |

712| :- | :- |722| :- | :- |

714| `medium` | Default pada Opus 5.5, Sonnet 5.5, dan Haiku 5.5. Pada Opus 5.5 dan Sonnet 5.5, cocok untuk pekerjaan teknik sehari-hari dengan cakupan yang jelas, seperti mengimplementasikan fitur baru. Pada model dengan default lebih tinggi, mengurangi penggunaan token untuk pekerjaan sensitif biaya yang dapat mengorbankan sebagian kecerdasan |724| `medium` | Default pada Opus 5.5, Sonnet 5.5, dan Haiku 5.5. Pada Opus 5.5 dan Sonnet 5.5, cocok untuk pekerjaan teknik sehari-hari dengan cakupan yang jelas, seperti mengimplementasikan fitur baru. Pada model dengan default lebih tinggi, mengurangi penggunaan token untuk pekerjaan sensitif biaya yang dapat mengorbankan sebagian kecerdasan |

715| `high` | Pekerjaan di mana verifikasi penting atau kasus tepi mungkin muncul, seperti memperbaiki bug dalam codebase yang ada. Default pada setiap model kecuali Opus 5.5, Sonnet 5.5, Haiku 5.5, dan Opus 4.7 |725| `high` | Pekerjaan di mana verifikasi penting atau kasus tepi mungkin muncul, seperti memperbaiki bug dalam codebase yang ada. Default pada setiap model kecuali Opus 5.5, Sonnet 5.5, Haiku 5.5, dan Opus 4.7 |

717| `max` | Masalah sulit yang Anda ingin Claude kerjakan tanpa Anda, seperti menemukan kerentanan keamanan. `max` mungkin menunjukkan hasil yang berkurang dan rentan terhadap overthinking, jadi uji sebelum mengadopsi secara luas |727| `max` | Masalah sulit yang Anda ingin Claude kerjakan tanpa Anda, seperti menemukan kerentanan keamanan. `max` mungkin menunjukkan hasil yang semakin berkurang dan rentan terhadap overthinking, jadi uji sebelum mengadopsinya secara luas |

718| `ultracode` | Pengaturan Claude Code daripada tingkat: merencanakan [alur kerja dinamis](/docs/id/workflows) untuk setiap tugas substantif pada tingkat usaha apa pun |728| `ultracode` | Pengaturan Claude Code, bukan tingkat: merencanakan [alur kerja dinamis](/docs/id/workflows) untuk setiap tugas substantif pada tingkat effort apa pun |

719 729

720Dalam pengujian pada Opus 5.5 dan Fable 5.1, Claude pada tingkat yang lebih tinggi menguji lebih banyak kasus tepi dan memverifikasi lebih banyak pekerjaan sebelum menjawab. Ini juga membuat lebih banyak pilihan sendiri. Pada tingkat yang lebih rendah, Claude mengembalikan titik awal lebih cepat, yang cocok untuk pekerjaan di mana Anda meninjau setiap hasil dan mengarahkan langkah berikutnya. Untuk melihat tugas yang sama berjalan pada setiap tingkat, baca [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) di blog.730Dalam pengujian pada Opus 5.5 dan Fable 5.1, Claude pada tingkat yang lebih tinggi menguji lebih banyak kasus tepi dan memverifikasi lebih banyak pekerjaannya sebelum menjawab. Claude juga membuat lebih banyak pilihan sendiri. Pada tingkat yang lebih rendah, Claude mengembalikan titik awal lebih cepat, yang cocok untuk pekerjaan di mana Anda meninjau setiap hasil dan mengarahkan langkah berikutnya. Untuk melihat tugas yang sama berjalan pada setiap tingkat, baca [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) di blog.

721 731

722Skala usaha dikalibrasi per model, jadi nama tingkat yang sama tidak mewakili nilai dasar yang sama di seluruh model.732Skala effort dikalibrasi per model, jadi nama tingkat yang sama tidak mewakili nilai dasar yang sama di seluruh model.

723 733

724Opus 5.5 [default ke `medium`](#adjust-effort-level), satu tingkat di bawah default Opus 5 yaitu `high`. Dalam pengujian Anthropic, Opus 5.5 pada `medium` cocok atau melebihi Opus 5 pada `high` pada evaluasi pengkodean dan pekerjaan pengetahuan. Pada tingkat yang diberikan, Opus 5.5 cenderung berpikir lebih per giliran daripada Opus 5. Ketika Anda pindah dari Opus 5 ke Opus 5.5, mulai pada `medium` daripada membawa tingkat yang Anda gunakan pada Opus 5. Untuk menguji tingkat terhadap pekerjaan Anda sendiri, lihat [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) dalam panduan prompting Opus 5.5.734Opus 5.5 [default ke `medium`](#adjust-effort-level), satu tingkat di bawah default Opus 5 yaitu `high`. Dalam pengujian Anthropic, Opus 5.5 pada `medium` menyamai atau melebihi Opus 5 pada `high` pada evaluasi pengkodean dan pekerjaan pengetahuan. Pada tingkat yang sama, Opus 5.5 cenderung berpikir lebih banyak per giliran daripada Opus 5. Ketika Anda pindah dari Opus 5 ke Opus 5.5, mulai pada `medium` daripada membawa tingkat yang Anda gunakan pada Opus 5. Untuk menguji tingkat terhadap pekerjaan Anda sendiri, lihat [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) dalam panduan prompting Opus 5.5.

725 735

726<h4 id="use-ultrathink-for-one-off-deep-reasoning">736<h4 id="use-ultrathink-for-one-off-deep-reasoning">

727 Gunakan ultrathink untuk penalaran mendalam sekali jalan737 Gunakan ultrathink untuk penalaran mendalam sekali jalan

728</h4>738</h4>

729 739

730Sertakan `ultrathink` di mana saja dalam prompt Anda untuk meminta penalaran lebih dalam pada giliran itu tanpa mengubah pengaturan usaha sesi Anda. Claude Code mengenali kata kunci dan menambahkan instruksi dalam konteks. Tingkat usaha yang dikirim ke API tidak berubah. Claude Code melewatkan frasa lain seperti "think", "think hard", dan "think more" sebagai teks prompt biasa dan tidak mengenalinya sebagai kata kunci.740Sertakan `ultrathink` di mana saja dalam prompt Anda untuk meminta penalaran lebih dalam pada giliran itu tanpa mengubah pengaturan effort sesi Anda. Claude Code mengenali kata kunci tersebut dan menambahkan instruksi dalam konteks. Tingkat effort yang dikirim ke API tidak berubah. Claude Code meneruskan frasa lain seperti "think", "think hard", dan "think more" sebagai teks prompt biasa dan tidak mengenalinya sebagai kata kunci.

731 741

732<h4 id="set-the-effort-level">742<h4 id="set-the-effort-level">

733 Atur tingkat usaha743 Atur tingkat effort

734</h4>744</h4>

735 745

736Anda dapat mengubah usaha melalui salah satu dari berikut ini:746Anda dapat mengubah effort melalui salah satu dari berikut ini:

737 747

738* **`/effort`**: jalankan `/effort` tanpa argumen untuk membuka slider interaktif, `/effort` diikuti dengan nama tingkat untuk menetapkannya secara langsung, atau `/effort auto` untuk menghapus tingkat tersimpan Anda untuk model aktif. Anda dapat menjalankannya saat Claude sedang bekerja, dan setelah Anda mengkonfirmasi [peringatan cache](/docs/id/prompt-caching#changing-effort-level), jika Claude Code menampilkan satu, Claude Code menerapkan tingkat baru ke permintaan berikutnya dalam giliran748* **`/effort`**: jalankan `/effort` tanpa argumen untuk membuka slider interaktif, `/effort` diikuti dengan nama tingkat untuk menetapkannya secara langsung, atau `/effort auto` untuk menghapus tingkat tersimpan Anda untuk model aktif. Anda dapat menjalankannya saat Claude sedang bekerja, dan setelah Anda mengonfirmasi [peringatan cache](/docs/id/prompt-caching#changing-effort-level), jika Claude Code menampilkannya, Claude Code menerapkan tingkat baru ke permintaan berikutnya dalam giliran

739* **Dalam `/model`**: gunakan tombol panah kiri/kanan untuk menyesuaikan slider usaha saat memilih model749* **Dalam `/model`**: gunakan tombol panah kiri/kanan untuk menyesuaikan slider effort saat memilih model

740* **Flag `--effort`**: teruskan nama tingkat untuk menetapkannya untuk satu sesi saat meluncurkan Claude Code750* **Flag `--effort`**: teruskan nama tingkat untuk menetapkannya untuk satu sesi saat meluncurkan Claude Code

741* **Variabel lingkungan**: atur `CLAUDE_CODE_EFFORT_LEVEL` ke nama tingkat atau `auto`751* **Environment variable**: atur `CLAUDE_CODE_EFFORT_LEVEL` ke nama tingkat atau `auto`

742* **Pengaturan**: atur tingkat per model dalam [`modelSettings`](/docs/id/settings-reference#modelsettings), atau atur [`effortLevel`](/docs/id/settings-reference#effortlevel) ke `low`, `medium`, `high`, atau `xhigh` sebagai default untuk model tanpa satu. `max` tidak diterima di kunci mana pun, dan `ultracode` memiliki kunci [`ultracode`](/docs/id/settings-reference#ultracode) sendiri752* **Pengaturan**: atur tingkat per model dalam [`modelSettings`](/docs/id/settings-reference#modelsettings), atau atur [`effortLevel`](/docs/id/settings-reference#effortlevel) ke `low`, `medium`, `high`, atau `xhigh` sebagai default untuk model yang tidak memilikinya. `max` tidak diterima sebagai tingkat di kunci mana pun, dan `ultracode` memiliki kunci [`ultracode`](/docs/id/settings-reference#ultracode) sendiri

743* **Dari perangkat yang terhubung**: dalam sesi [Remote Control](/docs/id/remote-control#what-connected-devices-see), pilih tingkat dari kontrol usaha pada ponsel Anda atau di browser Anda. Tingkat berlaku untuk sesi saat ini saja. Memerlukan Claude Code v2.1.234 atau lebih baru753* **Dari perangkat yang terhubung**: dalam sesi [Remote Control](/docs/id/remote-control#what-connected-devices-see), pilih tingkat dari kontrol effort pada ponsel Anda atau di browser Anda. Tingkat berlaku untuk sesi saat ini saja. Memerlukan Claude Code v2.1.234 atau lebih baru

744* **Frontmatter skill dan subagent**: atur `effort` dalam file markdown [skill](/docs/id/skills#frontmatter-reference) atau [subagent](/docs/id/sub-agents#supported-frontmatter-fields) untuk mengganti tingkat usaha ketika skill atau subagent itu berjalan754* **Frontmatter skill dan subagent**: atur `effort` dalam file markdown [skill](/docs/id/skills#frontmatter-reference) atau [subagent](/docs/id/sub-agents#supported-frontmatter-fields) untuk menimpa tingkat effort ketika skill atau subagent itu berjalan

745 755

746Usaha frontmatter berlaku ketika skill atau subagent itu aktif, mengganti tingkat sesi tetapi bukan variabel lingkungan. [`maxEffortLevel`](/docs/id/settings-reference#maxeffortlevel) atau [batas usaha organisasi](#organization-effort-limits) masih membatasi tingkat yang skill atau subagent berjalan.756Effort frontmatter berlaku ketika skill atau subagent itu aktif, menimpa tingkat sesi tetapi tidak environment variable. [`maxEffortLevel`](/docs/id/settings-reference#maxeffortlevel) atau [batas effort organisasi](#organization-effort-limits) tetap membatasi tingkat tempat skill atau subagent berjalan.

747 757

748Jika Anda menetapkan `effortLevel` dalam [pengaturan terkelola](/docs/id/managed-settings), Claude Code menerapkannya pada langkah pengaturan dari [urutan resolusi usaha](#adjust-effort-level), dan pengguna masih dapat mengubah tingkat dengan `/effort` atau `--effort`. Untuk menjaga pengguna pada atau di bawah tingkat, atur [`maxEffortLevel`](/docs/id/settings-reference#maxeffortlevel).758Jika Anda menetapkan `effortLevel` dalam [pengaturan terkelola](/docs/id/managed-settings), Claude Code menerapkannya pada langkah pengaturan dari [urutan resolusi effort](#adjust-effort-level), dan pengguna masih dapat mengubah tingkat dengan `/effort` atau `--effort`. Untuk menjaga pengguna pada atau di bawah suatu tingkat, atur [`maxEffortLevel`](/docs/id/settings-reference#maxeffortlevel).

749 759

750Slider usaha muncul dalam `/model` ketika model yang didukung dipilih. Tingkat usaha saat ini juga ditampilkan dalam header sesi di sebelah nama model, misalnya "with low effort", jadi Anda dapat mengkonfirmasi pengaturan mana yang aktif tanpa membuka `/model`. Footer juga secara singkat menampilkan tingkat usaha saat startup dan saat berubah.760Slider effort muncul dalam `/model` ketika model yang didukung dipilih. Tingkat effort saat ini juga ditampilkan dalam header sesi di sebelah nama model, misalnya "with low effort", jadi Anda dapat mengonfirmasi pengaturan mana yang aktif tanpa membuka `/model`. Footer juga secara singkat menampilkan tingkat effort saat startup dan saat berubah.

751 761

752<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">762<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">

753 Penalaran adaptif dan anggaran pemikiran tetap763 Penalaran adaptif dan thinking budget tetap

754</h4>764</h4>

755 765

756Penalaran adaptif membuat pemikiran opsional pada setiap langkah, jadi Claude dapat merespons lebih cepat ke prompt rutin dan menyisihkan pemikiran lebih dalam untuk langkah-langkah yang mendapat manfaat darinya. Jika Anda ingin Claude berpikir lebih atau kurang sering daripada tingkat saat ini menghasilkan, Anda dapat mengatakan demikian langsung dalam prompt Anda atau dalam `CLAUDE.md`; model merespons panduan itu dalam pengaturan usahanya.766Penalaran adaptif membuat thinking opsional pada setiap langkah, jadi Claude dapat merespons lebih cepat terhadap prompt rutin dan menyisihkan pemikiran lebih dalam untuk langkah-langkah yang mendapat manfaat darinya. Jika Anda ingin Claude berpikir lebih atau kurang sering daripada yang dihasilkan tingkat saat ini, Anda dapat menyatakannya langsung dalam prompt Anda atau dalam `CLAUDE.md`; model merespons panduan itu dalam pengaturan effort-nya.

757 767

758Model Fable, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru selalu menggunakan penalaran adaptif. Mode thinking budget tetap dan `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` tidak berlaku untuk model-model tersebut.768Model Fable, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru selalu menggunakan penalaran adaptif. Mode thinking budget tetap dan `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` tidak berlaku untuk model-model tersebut.

759 769

760Pada Opus 4.6 dan Sonnet 4.6, Anda dapat menetapkan `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` untuk kembali ke mode anggaran pemikiran tetap sebelumnya yang dikendalikan oleh `MAX_THINKING_TOKENS`. Lihat [variabel lingkungan](/docs/id/env-vars).770Pada Opus 4.6 dan Sonnet 4.6, Anda dapat menetapkan `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` untuk kembali ke thinking budget tetap sebelumnya yang dikendalikan oleh `MAX_THINKING_TOKENS`. Lihat [environment variable](/docs/id/env-vars).

761 771

762<h3 id="extended-thinking">772<h3 id="extended-thinking">

763 Pemikiran diperpanjang773 Extended thinking

764</h3>774</h3>

765 775

766Pemikiran yang diperpanjang adalah penalaran yang Claude keluarkan sebelum merespons. Pada model yang mendukung [penalaran adaptif](#adjust-effort-level), tingkat usaha adalah kontrol utama untuk berapa banyak pemikiran yang terjadi; pengaturan di bawah mengaktifkan atau menonaktifkan pemikiran dan mengontrol cara ditampilkan. Dengan pemikiran dimatikan pada Anthropic API, Claude Code mengirim usaha `high` alih-alih tingkat lebih tinggi ke model yang diketahui [tidak menerima kombinasi itu](/docs/id/errors#effort-isnt-available-with-thinking-turned-off), seperti Opus 5.776Extended thinking adalah penalaran yang Claude keluarkan sebelum merespons. Pada model yang mendukung [penalaran adaptif](#adjust-effort-level), tingkat effort adalah kontrol utama untuk seberapa banyak thinking yang terjadi; pengaturan di bawah mengaktifkan atau menonaktifkan thinking dan mengontrol cara penampilannya. Dengan thinking dimatikan pada Anthropic API, Claude Code mengirim effort `high` alih-alih tingkat lebih tinggi ke model yang diketahuinya [tidak menerima kombinasi itu](/docs/id/errors#effort-isnt-available-with-thinking-turned-off), seperti Opus 5.

767 777

768| Kontrol | Cara menetapkannya |778| Kontrol | Cara menetapkannya |

769| :- | :- |779| :- | :- |

771| Atur default global | Jalankan `/config` dan alihkan Thinking Mode. Disimpan sebagai `alwaysThinkingEnabled` dalam `~/.claude/settings.json` |781| Atur default global | Jalankan `/config` dan alihkan mode thinking. Disimpan sebagai `alwaysThinkingEnabled` dalam `~/.claude/settings.json` |

772| Nonaktifkan melalui environment variable | Atur [`MAX_THINKING_TOKENS=0`](/docs/id/env-vars), yang mematikan thinking pada Anthropic API kecuali pada Opus 5.5, Sonnet 5.5, Haiku 5.5, dan model Fable. Pada [penyedia pihak ketiga](/docs/id/third-party-integrations), Claude Code menghilangkan parameter `thinking` sebagai gantinya, dan model penalaran adaptif mungkin tetap berpikir |782| Nonaktifkan melalui environment variable | Atur [`MAX_THINKING_TOKENS=0`](/docs/id/env-vars), yang mematikan thinking pada Anthropic API kecuali pada Opus 5.5, Sonnet 5.5, Haiku 5.5, dan model Fable. Pada [penyedia pihak ketiga](/docs/id/third-party-integrations), Claude Code menghilangkan parameter `thinking` sebagai gantinya, dan model penalaran adaptif mungkin tetap berpikir |

773 783

774Anda tidak dapat mematikan thinking pada Opus 5.5, Sonnet 5.5, Haiku 5.5, atau model Fable. Alihan sesi dan baris `/config` menampilkan `Thinking can't be turned off` untuk model-model ini alih-alih menawarkan sakelar, dan `alwaysThinkingEnabled: false` atau `MAX_THINKING_TOKENS=0` yang disimpan tidak berpengaruh di sana. Pada model-model ini, model memutuskan per langkah seberapa banyak berpikir berdasarkan tingkat effort. Pengaturan yang disimpan berlaku lagi ketika Anda beralih ke model yang menerimanya.784Anda tidak dapat mematikan thinking pada Opus 5.5, Sonnet 5.5, Haiku 5.5, atau model Fable. Alihan sesi dan baris `/config` menampilkan `Thinking can't be turned off` untuk model-model ini alih-alih menawarkan sakelar, dan `alwaysThinkingEnabled: false` atau `MAX_THINKING_TOKENS=0` yang disimpan tidak berpengaruh di sana. Pada model-model ini, model memutuskan per langkah seberapa banyak berpikir berdasarkan tingkat effort. Pengaturan yang disimpan berlaku lagi ketika Anda beralih ke model yang menerimanya.

775 785

776Claude Code meruntuhkan output pemikiran secara default. Tekan `Ctrl+O` untuk mengalihkan mode verbose dan lihat penalaran sebagai teks miring abu-abu. Sesi interaktif pada Anthropic API menerima blok pemikiran yang diredaksi secara default, jadi atur `showThinkingSummaries: true` dalam [pengaturan](/docs/id/settings) jika Anda menginginkan ringkasan lengkap yang tersedia saat Anda memperluas. Anda dikenakan biaya untuk semua token pemikiran yang dihasilkan, bahkan ketika diruntuhkan atau diredaksi.786Claude Code menciutkan output thinking secara default. Tekan `Ctrl+O` untuk mengalihkan mode verbose dan melihat penalaran sebagai teks miring abu-abu. Sesi interaktif pada Anthropic API menerima thinking block yang diredaksi secara default, jadi atur `showThinkingSummaries: true` dalam [pengaturan](/docs/id/settings) jika Anda menginginkan ringkasan lengkap tersedia saat Anda memperluasnya. Anda dikenakan biaya untuk semua thinking token yang dihasilkan, bahkan ketika diciutkan atau diredaksi.

777 787

778<a id="extended-context-with-1m" />788<a id="extended-context-with-1m" />

779 789

790<span id="sonnet-5-5-and-sonnet-5-context-window" />

791

780<h3 id="extended-context">792<h3 id="extended-context">

781 Konteks diperpanjang793 Konteks diperpanjang

782</h3>794</h3>

783 795

784Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, Opus 4.6 dan lebih baru, serta Sonnet 4.6 mendukung [context window 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang dengan codebase besar.796Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, Opus 4.6 dan lebih baru, serta Sonnet 4.6 mendukung [context window 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang dengan codebase besar.

785 797

786Pada Anthropic API, Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru berjalan dengan window 1M pada setiap paket, termasuk Pro. Anda tidak perlu memilih varian `[1m]` atau mengaktifkan kredit penggunaan untuk window 1M pada model-model ini. Penggunaan Fable itu sendiri dapat ditagih ke kredit penggunaan pada beberapa paket; lihat [Fable dan kredit penggunaan](#fable-and-usage-credits).798Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru berjalan dengan window 1M secara default, tanpa memerlukan sufiks `[1m]`. Hal ini mencakup sesi pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, serta sesi [Claude apps gateway](/docs/id/claude-apps-gateway). Untuk menjalankannya dengan window 200K, lihat [Matikan konteks 1M](#turn-off-1m-context).

787 799

788Opus 4.6 dan Sonnet 4.6 mencapai 1M hanya melalui varian `[1m]` mereka, dan akses ke varian itu tergantung pada paket Anda. Pada paket Max, Team, dan Enterprise, termasuk kursi Team Standard dan Team Premium, Opus 4.6 dengan konteks 1M disertakan dengan langganan Anda. Sonnet 4.6 dengan konteks 1M memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pada setiap paket langganan, termasuk Max.800Opus 4.6 dan Sonnet 4.6 mencapai 1M hanya melalui varian `[1m]` mereka, dan akses ke varian itu tergantung pada paket Anda. Pada paket Max, Team, dan Enterprise, termasuk kursi Team Standard dan Team Premium, Opus 4.6 dengan konteks 1M disertakan dengan langganan Anda. Sonnet 4.6 dengan konteks 1M memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pada setiap paket langganan, termasuk Max.

789 801

793| Pro | Memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |805| Pro | Memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Memerlukan [kredit penggunaan](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

795 807

796Claude Code memeriksa persyaratan paket ini hanya ketika terhubung ke Anthropic API secara langsung. Jika Anda menunjuk `ANTHROPIC_BASE_URL` pada [gateway LLM](/docs/id/llm-gateway#subscriptions-and-gateways) dan login claude.ai tersimpan Anda tetap menjadi kredensial aktif, Claude Code tidak memeriksa kredit penggunaan paket Anda. Opsi `[1m]` tetap tersedia dalam `/model`, dan gateway memutuskan apakah permintaan berhasil. Sebelum v2.1.229, Claude Code menolak `/model sonnet[1m]` dalam konfigurasi itu ketika tidak dapat mengkonfirmasi kredit penggunaan pada akun.808Claude Code memeriksa persyaratan paket ini hanya ketika terhubung ke Anthropic API secara langsung. Jika Anda mengarahkan `ANTHROPIC_BASE_URL` ke [gateway LLM](/docs/id/llm-gateway#subscriptions-and-gateways) dan login claude.ai tersimpan Anda tetap menjadi kredensial aktif, Claude Code tidak memeriksa kredit penggunaan paket Anda. Opsi `[1m]` tetap tersedia dalam `/model`, dan gateway memutuskan apakah permintaan berhasil. Sebelum v2.1.229, Claude Code menolak `/model sonnet[1m]` dalam konfigurasi itu ketika tidak dapat mengonfirmasi kredit penggunaan pada akun.

~~797~~

798<span id="context-window-behind-a-gateway" />

~~799~~

800Jika Anda menetapkan `ANTHROPIC_BASE_URL` ke [gateway LLM](/docs/id/llm-gateway) atau proxy lainnya, Claude Code memberikan setiap model yang dikenalinya context window yang sama dengan yang dimiliki model tersebut pada Anthropic API. Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru mendapatkan window 1M tanpa varian `[1m]` untuk dipilih, dan model yang mencapai 1M hanya melalui varian `[1m]`-nya, seperti Opus 4.6, berjalan pada 200K tanpa varian itu. Claude Code tidak dapat mendeteksi batas yang lebih rendah yang diberlakukan gateway atau server di belakangnya. Jika gateway Anda menolak permintaan di atas 200K token, atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/id/env-vars) di environment yang menjalankan Claude Code, sehingga sesi pada setiap model [melakukan compaction pada batas itu](#set-the-auto-compact-window).

~~801~~

802Untuk menonaktifkan konteks 1M, atur `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code menghapus varian model 1M dari pengambil model. Pada model dengan jendela 1M asli, seperti Sonnet 5 dan model Fable, ini juga memperlakukan model sebagai memiliki jendela konteks 200K:

803 809

804* Dengan auto-compaction aktif, sesi compact pada batas 200K melalui [auto-compaction](#set-the-auto-compact-window). Menetapkan jendela auto-compact di atas 200K tidak mengangkat hold, karena Claude Code membatasi jendela itu pada jendela konteks model.810Pada Anthropic API, context window 1M menggunakan harga model standar tanpa premium untuk token di atas 200K, kecuali pada Haiku 5.5, yang [lebih mahal untuk prompt yang lebih panjang dari 100K token](#haiku-5-5-context-window-and-pricing). Untuk paket di mana konteks diperpanjang disertakan dengan langganan Anda, penggunaan tetap tercakup oleh langganan Anda. Untuk paket yang mengakses konteks diperpanjang melalui kredit penggunaan, token ditagih ke kredit penggunaan.

805* Dengan auto-compaction mati, sesi berhenti pada batas 200K dengan [error context-limit](/docs/id/errors#prompt-is-too-long) alih-alih compacting.

806 811

807Sebelum v2.1.223, Claude Code hanya menyimpan sesi Sonnet 5, Opus 4.8, dan Opus 5 ke 200K. Lihat [variabel lingkungan](/docs/id/env-vars).812<h4 id="select-1m-context-for-opus-4-6-or-sonnet-4-6">

~~808~~ 813 Pilih konteks 1M untuk Opus 4.6 atau Sonnet 4.6

809Context window 1M menggunakan harga model standar tanpa premium untuk token di luar 200K, kecuali pada Haiku 5.5, yang [lebih mahal untuk prompt yang lebih panjang dari 100K token](#haiku-5-5-context-window-and-pricing). Untuk paket di mana konteks diperpanjang disertakan dengan langganan Anda, penggunaan tetap tercakup oleh langganan Anda. Untuk paket yang mengakses konteks diperpanjang melalui kredit penggunaan, token ditagih ke kredit penggunaan.814</h4>

~~810~~

811Jika akun Anda mendukung konteks 1M, opsi muncul dalam pengambil `/model` dalam versi terbaru Claude Code. Jika Anda tidak melihatnya, coba mulai ulang sesi Anda, dan pada penyedia pihak ketiga periksa apakah penerapan Anda [menyematkan model](#pin-models-for-third-party-deployments) dengan variabel `ANTHROPIC_DEFAULT_*_MODEL`.

812 815

813Anda juga dapat menggunakan sufiks `[1m]` dengan alias model atau nama model lengkap:816Untuk memilih varian 1M berdasarkan nama, tambahkan sufiks `[1m]` ke alias model atau nama model lengkap:

814 817

815```text theme={null}818```text theme={null}

816# Gunakan alias opus[1m] atau sonnet[1m]819# Append [1m] to a full model name

817/model opus[1m]820/model claude-opus-4-6[1m]

818/model sonnet[1m]821/model claude-sonnet-4-6[1m]

819 822

820# Atau tambahkan [1m] ke nama model lengkap823# Or to an alias: the suffix applies to the model the alias resolves to

821/model claude-opus-4-8[1m]824/model opus[1m]

822```825```

823 826

824<h4 id="sonnet-5-5-and-sonnet-5-context-window">827<span id="context-window-behind-a-gateway" />

825 Jendela konteks Sonnet 5.5 dan Sonnet 5828

829<h4 id="context-window-behind-an-llm-gateway">

830 Context window di belakang gateway LLM

826</h4>831</h4>

827 832

828Pada Anthropic API, Sonnet 5.5 dan Sonnet 5 selalu berjalan dengan jendela konteks 1M. Tidak ada varian 200K, tidak ada sufiks `[1m]` untuk dipilih, dan tidak ada kredit penggunaan yang diperlukan pada paket apa pun. Sesi auto-compact sebelum jendela penuh, pada sekitar 967K token secara default; atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/id/env-vars) untuk memilih ambang batas berbeda.833Jika Anda menetapkan `ANTHROPIC_BASE_URL` ke [gateway LLM](/docs/id/llm-gateway) atau proxy lainnya, Claude Code memberikan setiap model yang dikenalinya context window yang sama dengan yang dimiliki model tersebut pada Anthropic API. Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, Haiku 5.5, serta Opus 4.7 dan lebih baru mendapatkan window 1M tanpa varian `[1m]` untuk dipilih, dan model yang mencapai 1M hanya melalui varian `[1m]`-nya, seperti Opus 4.6, berjalan pada 200K tanpa varian itu. Claude Code tidak dapat mendeteksi batas yang lebih rendah yang diberlakukan gateway atau server di belakangnya. Jika gateway Anda menolak permintaan di atas 200K token, atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/id/env-vars) di environment yang menjalankan Claude Code, sehingga sesi pada setiap model [melakukan compaction pada batas itu](#set-the-auto-compact-window).

829 834

830Claude Code memberikan Sonnet 5.5 dan Sonnet 5 jendela 1M yang sama di belakang [gateway LLM](/docs/id/llm-gateway) atau `ANTHROPIC_BASE_URL` kustom lainnya. Jika gateway Anda memberlakukan batas yang lebih rendah, lihat [jendela konteks di belakang gateway](#context-window-behind-a-gateway).835<h4 id="turn-off-1m-context">

836 Matikan konteks 1M

837</h4>

831 838

832Pengaturan ini menganggarkan jendela pada 200K:839Untuk menjaga sesi pada window 200K, atur `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` di shell Anda atau di [file pengaturan](/docs/id/env-vars#set-environment-variables). Claude Code menghapus varian model `[1m]` dari pemilih model. Pada model yang berjalan dengan window 1M secara default, seperti model Fable, Sonnet 5 dan lebih baru, serta Opus 4.7 dan lebih baru, Claude Code juga memperlakukan model sebagai memiliki context window 200K:

833 840

834* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: menyimpan sesi pada setiap model dengan jendela 1M asli ke jendela 200K; lihat [Konteks diperpanjang](#extended-context) untuk cara hold ditegakkan. Berguna untuk penerapan yang perlu membatasi konteks.841* Dengan auto-compaction aktif, sesi melakukan compaction pada batas 200K melalui [auto-compaction](#set-the-auto-compact-window). Menetapkan window auto-compact di atas 200K tidak mencabut batasan ini, karena Claude Code membatasi window itu pada context window model.

842* Dengan auto-compaction mati, sesi berhenti pada batas 200K dengan [error context-limit](/docs/id/errors#prompt-is-too-long) alih-alih melakukan compaction.

835 843

836<h4 id="haiku-5-5-context-window-and-pricing">844<h4 id="haiku-5-5-context-window-and-pricing">

837 Context window dan harga Haiku 5.5845 Context window dan harga Haiku 5.5

844Sesi auto-compact pada sekitar 967K token secara default. Untuk melakukan compaction lebih awal, [atur window auto-compact yang lebih kecil](#set-the-auto-compact-window) untuk model tersebut.852Sesi auto-compact pada sekitar 967K token secara default. Untuk melakukan compaction lebih awal, [atur window auto-compact yang lebih kecil](#set-the-auto-compact-window) untuk model tersebut.

845 853

846<h2 id="context-window-and-auto-compaction">854<h2 id="context-window-and-auto-compaction">

847 Jendela konteks dan auto-compaction855 Context window dan auto-compaction

848</h2>856</h2>

849 857

850Jendela auto-compact adalah seberapa penuh jendela konteks dapat menjadi sebelum Claude Code melakukan pemadatan percakapan. Untuk apa yang disimpan dan dihapus pemadatan per mekanisme, lihat [What survives compaction](/docs/id/context-window#what-survives-compaction).858Jendela auto-compact adalah seberapa penuh context window dapat menjadi sebelum Claude Code melakukan compaction percakapan. Untuk apa yang disimpan dan dihapus compaction per mekanisme, lihat [What survives compaction](/docs/id/context-window#what-survives-compaction).

851 859

852<h3 id="set-the-auto-compact-window">860<h3 id="set-the-auto-compact-window">

853 Atur jendela auto-compact861 Atur jendela auto-compact

857 865

858* **Untuk model saat ini, dalam sesi ini dan sesi berikutnya**: jalankan `/autocompact` dengan nilai, seperti `/autocompact 500k`. Claude Code menyimpannya ke pengaturan pengguna Anda di bawah model saat ini dalam [`modelSettings`](/docs/id/settings-reference#modelsettings) dan menerapkannya ke sesi saat ini. Jika [cakupan pengaturan](/docs/id/settings#settings-precedence) dengan prioritas lebih tinggi seperti pengaturan terkelola menetapkan jendelanya sendiri untuk model tersebut atau untuk setiap model, perintah menyimpan nilai Anda tetapi sesi mempertahankan jendela cakupan tersebut, dan perintah mengatakan demikian. Jalankan `/autocompact auto` untuk kembali ke jendela yang disesuaikan untuk model Anda. Sebelum v2.1.288, perintah ini menyimpan satu jendela untuk setiap model, sebagai `autoCompactWindow` tingkat atas.866* **Untuk model saat ini, dalam sesi ini dan sesi berikutnya**: jalankan `/autocompact` dengan nilai, seperti `/autocompact 500k`. Claude Code menyimpannya ke pengaturan pengguna Anda di bawah model saat ini dalam [`modelSettings`](/docs/id/settings-reference#modelsettings) dan menerapkannya ke sesi saat ini. Jika [cakupan pengaturan](/docs/id/settings#settings-precedence) dengan prioritas lebih tinggi seperti pengaturan terkelola menetapkan jendelanya sendiri untuk model tersebut atau untuk setiap model, perintah menyimpan nilai Anda tetapi sesi mempertahankan jendela cakupan tersebut, dan perintah mengatakan demikian. Jalankan `/autocompact auto` untuk kembali ke jendela yang disesuaikan untuk model Anda. Sebelum v2.1.288, perintah ini menyimpan satu jendela untuk setiap model, sebagai `autoCompactWindow` tingkat atas.

859* **Untuk setiap model**: atur [`autoCompactWindow`](/docs/id/settings-reference#autocompactwindow) dalam file pengaturan, seperti `"autoCompactWindow": 200000` di `~/.claude/settings.json`. Jendela yang Anda simpan untuk suatu model dengan `/autocompact` diutamakan daripada kunci ini dalam file yang sama untuk model tersebut.867* **Untuk setiap model**: atur [`autoCompactWindow`](/docs/id/settings-reference#autocompactwindow) dalam file pengaturan, seperti `"autoCompactWindow": 200000` di `~/.claude/settings.json`. Jendela yang Anda simpan untuk suatu model dengan `/autocompact` diutamakan daripada kunci ini dalam file yang sama untuk model tersebut.

860* **Untuk satu peluncuran**: teruskan [`--autocompact`](/docs/id/cli-reference#cli-flags) saat memulai Claude Code. Bendera menimpa pengaturan tersimpan Anda untuk peluncuran itu tanpa mengubahnya, dan `claude --autocompact auto` menjalankan sesi pada jendela yang disesuaikan bahkan jika pengaturan tersimpan Anda memiliki nilai. Tidak seperti `/autocompact`, bendera tidak didahului oleh cakupan pengaturan dengan prioritas lebih tinggi seperti pengaturan terkelola.868* **Untuk satu peluncuran**: teruskan [`--autocompact`](/docs/id/cli-reference#cli-flags) saat memulai Claude Code. Flag ini menimpa pengaturan tersimpan Anda untuk peluncuran itu tanpa mengubahnya, dan `claude --autocompact auto` menjalankan sesi pada jendela yang disesuaikan bahkan jika pengaturan tersimpan Anda memiliki nilai. Tidak seperti `/autocompact`, flag ini tidak didahului oleh cakupan pengaturan dengan prioritas lebih tinggi seperti pengaturan terkelola.

861* **Dalam skrip dan lingkungan cloud**: atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/id/env-vars). Saat diatur, itu memiliki prioritas atas perintah, bendera, dan pengaturan, dan `/autocompact` melaporkan penggantian alih-alih mengubah jendela.869* **Dalam skrip dan lingkungan cloud**: atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/id/env-vars). Saat diatur, variabel ini diutamakan daripada perintah, flag, dan pengaturan, dan `/autocompact` melaporkan override tersebut alih-alih mengubah jendela.

862 870

863Perintah dan bendera menerima ukuran jendela dari 100K hingga 1M token, dalam salah satu bentuk ini:871Perintah dan flag menerima ukuran jendela dari 100K hingga 1M token, dalam salah satu bentuk ini:

864 872

865* Hitungan token biasa, seperti `200000`873* Hitungan token biasa, seperti `200000`

866* Akhiran `k` atau `M`, seperti `500k` atau `1M`874* Akhiran `k` atau `M`, seperti `500k` atau `1M`

867* Angka biasa dari 100 hingga 1000, berarti ribuan, jadi `200` menetapkan 200.000875* Angka biasa dari 100 hingga 1000, berarti ribuan, jadi `200` menetapkan 200.000

868 876

869Variabel lingkungan hanya menerima hitungan token biasa. Claude Code membatasi jendela pada jendela konteks model.877Environment variable hanya menerima hitungan token biasa. Claude Code membatasi jendela pada context window model.

870 878

871<h3 id="default-auto-compact-thresholds">879<h3 id="default-auto-compact-thresholds">

872 Ambang batas auto-compact default880 Ambang batas auto-compact default

873</h3>881</h3>

874 882

875Jika Anda tidak mengatur jendela auto-compact, Claude Code melakukan pemadatan ketika percakapan mencapai batas konteks model, kecuali dalam sesi ini:883Jika Anda tidak mengatur jendela auto-compact, Claude Code melakukan compaction ketika percakapan mencapai batas konteks model, kecuali dalam sesi ini:

876 884

877* [Sesi cloud](/docs/id/claude-code-on-the-web) melakukan pemadatan saat percakapan mendekati batas model885* [Sesi cloud](/docs/id/claude-code-on-the-web) melakukan compaction saat percakapan mendekati batas model

878* Sonnet 4.6 dan Opus 4.6 tanpa [konteks diperluas](#extended-context) melakukan pemadatan pada batas 200K, dan begitu juga Opus 4.8 dan yang lebih baru ketika mereka berjalan dengan jendela konteks 200K, seperti di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry886* Sonnet 4.6 dan Opus 4.6 tanpa [konteks diperluas](#extended-context) melakukan compaction pada batas 200K

879* Ketika Anda mengatur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars), model dengan jendela asli 1M, seperti Sonnet 5 dan model Fable, melakukan pemadatan pada batas 200K887* Ketika Anda mengatur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars), model dengan jendela asli 1M, seperti Sonnet 5 dan model Fable, melakukan compaction pada batas 200K

880* Model yang berjalan dengan jendela asli 1M melakukan pemadatan sebelum jendela penuh, pada sekitar 967K token secara default. Di Anthropic API, ini termasuk Sonnet 5, Haiku 5.5, model Fable, dan Opus 4.7 dan yang lebih baru. Di Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry, lihat [Pin models for third-party deployments](#pin-models-for-third-party-deployments) untuk model mana yang berjalan dengan jendela itu. Di balik `ANTHROPIC_BASE_URL` kustom, lihat [the context window behind a gateway](#context-window-behind-a-gateway)888* Model yang berjalan dengan jendela asli 1M melakukan compaction sebelum jendela penuh, pada sekitar 967K token secara default. Ini termasuk model Fable, Sonnet 5 dan yang lebih baru, Haiku 5.5, serta Opus 4.7 dan yang lebih baru. Di balik `ANTHROPIC_BASE_URL` kustom, lihat [the context window behind a gateway](#context-window-behind-a-gateway)

881* Sesi pada ID model yang Claude Code tidak kenali, seperti alias [gateway LLM](/docs/id/llm-gateway), melakukan pemadatan pada jendela konteks yang Claude Code asumsikan untuk ID; lihat [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)889* Sesi pada ID model yang tidak dikenali Claude Code, seperti alias [gateway LLM](/docs/id/llm-gateway), melakukan compaction pada context window yang diasumsikan Claude Code untuk ID tersebut; lihat [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

882 890

883<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">891<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

884 Perbaiki jendela untuk gateway atau ID model kustom892 Perbaiki jendela untuk gateway atau ID model kustom

885</h3>893</h3>

886 894

887Pada [gateway LLM](/docs/id/llm-gateway) atau penyebaran kustom lainnya, Claude Code dapat mengasumsikan jendela konteks untuk ID model yang berbeda dari jendela asli model, terlepas dari apakah itu menyelesaikan ID ke model Claude. Atur [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/id/env-vars) ke jendela yang Claude Code harus asumsikan sebagai gantinya.895Pada [gateway LLM](/docs/id/llm-gateway) atau deployment kustom lainnya, Claude Code dapat mengasumsikan context window untuk ID model yang berbeda dari jendela asli model, terlepas dari apakah itu menyelesaikan ID ke model Claude. Atur [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/id/env-vars) ke jendela yang Claude Code harus asumsikan sebagai gantinya.

888 896

889Bagaimana variabel diterapkan tergantung pada ID. Claude Code memperlakukan ID sebagai penyedia atau ejaan kustom ketika tidak dimulai dengan `claude-`, dalam huruf apa pun, atau ketika membawa akhiran yang Claude Code lepaskan saat membaca ID, seperti akhiran tanggal `@YYYYMMDD` yang digunakan di Platform Agen Google Cloud. Sebelum v2.1.259, Claude Code tidak menghitung akhiran yang dilucuti, jadi ID `claude-` yang tidak dikenali dengan akhiran tanggal diperlakukan sebagai nama `claude-` biasa.897Bagaimana variabel diterapkan tergantung pada ID. Claude Code memperlakukan ID sebagai penyedia atau ejaan kustom ketika tidak dimulai dengan `claude-`, dalam huruf apa pun, atau ketika membawa akhiran yang Claude Code lepaskan saat membaca ID, seperti akhiran tanggal `@YYYYMMDD` yang digunakan di Agent Platform Google Cloud. Sebelum v2.1.259, Claude Code tidak menghitung akhiran yang dilucuti, jadi ID `claude-` yang tidak dikenali dengan akhiran tanggal diperlakukan sebagai nama `claude-` biasa.

890 898

891Penyedia atau ejaan kustom yang tidak dikenali, ejaan yang sama dengan `[1m]`, dan setiap ID lainnya adalah tiga kasus terpisah:899Penyedia atau ejaan kustom yang tidak dikenali, ejaan yang sama dengan `[1m]`, dan setiap ID lainnya adalah tiga kasus terpisah:

892 900

893* Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID tidak berisi `[1m]`, variabel diterapkan secara langsung dan pemadatan proaktif berlanjut pada jendela yang dideklarasikan.901* Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID tidak berisi `[1m]`, variabel diterapkan secara langsung dan compaction proaktif berlanjut pada jendela yang dideklarasikan.

894* Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID berisi `[1m]`, dalam huruf apa pun, Claude Code mengasumsikan jendela 1M untuk itu dan variabel tidak diterapkan dengan sendirinya. Untuk memperbaiki jendela sambil mempertahankan pemadatan proaktif, juga atur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars). Dengan variabel itu diatur, Claude Code mengukur ID seperti ejaan yang sama tanpa `[1m]`, jadi `CLAUDE_CODE_MAX_CONTEXT_TOKENS` diterapkan ketika itu akan diterapkan pada ejaan tanpa tag itu.902* Jika Claude Code tidak dapat menyelesaikan penyedia atau ejaan kustom ke model yang dikenalinya dan ID berisi `[1m]`, dalam huruf apa pun, Claude Code mengasumsikan jendela 1M untuk itu dan variabel tidak diterapkan dengan sendirinya. Untuk memperbaiki jendela sambil mempertahankan compaction proaktif, juga atur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars). Dengan variabel itu diatur, Claude Code mengukur ID seperti ejaan yang sama tanpa `[1m]`, jadi `CLAUDE_CODE_MAX_CONTEXT_TOKENS` diterapkan ketika itu akan diterapkan pada ejaan tanpa tag itu.

895 903

896 Dengan jendela yang dideklarasikan di atas 200K, Claude Code kemudian menampilkan [peringatan startup](/docs/id/errors#the-200k-limit-isnt-enforced) bahwa batas 200K tidak diterapkan. Peringatan diharapkan dalam konfigurasi ini.904 Dengan jendela yang dideklarasikan di atas 200K, Claude Code kemudian menampilkan [peringatan startup](/docs/id/errors#the-200k-limit-isnt-enforced) bahwa batas 200K tidak diterapkan. Peringatan diharapkan dalam konfigurasi ini.

897* Jika ID diselesaikan ke model Claude Code yang dikenali, atau ID adalah nama `claude-` biasa tanpa akhiran untuk Claude Code lepaskan, dalam huruf apa pun, variabel hanya berlaku ketika Anda juga mengatur [`DISABLE_COMPACT`](/docs/id/env-vars), yang menonaktifkan semua pemadatan.905* Jika ID diselesaikan ke model Claude Code yang dikenali, atau ID adalah nama `claude-` biasa tanpa akhiran untuk Claude Code lepaskan, dalam huruf apa pun, variabel hanya berlaku ketika Anda juga mengatur [`DISABLE_COMPACT`](/docs/id/env-vars), yang menonaktifkan semua compaction.

898 906

899 Misalnya, ID yang berisi nama model Claude yang Claude Code ketahui, seperti `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, atau `claude-sonnet-4-5@20250929` yang bertanggal, diselesaikan ke model itu. Ini termasuk ID yang juga berisi `[1m]`: Claude Code menyelesaikan `claude-opus-4-8[1m]` ke Opus 4.8 bahkan dengan `CLAUDE_CODE_DISABLE_1M_CONTEXT` diatur.907 Misalnya, ID yang berisi nama model Claude yang Claude Code ketahui, seperti `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, atau `claude-sonnet-4-5@20250929` yang bertanggal, diselesaikan ke model itu. Ini termasuk ID yang juga berisi `[1m]`: Claude Code menyelesaikan `claude-opus-4-8[1m]` ke Opus 4.8 bahkan dengan `CLAUDE_CODE_DISABLE_1M_CONTEXT` diatur.

900 908

901Untuk ID model yang Claude Code tidak kenali, atur [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/id/env-vars) agar Claude Code melakukan pemadatan hanya setelah API menolak percakapan dengan [kesalahan terlalu panjang yang Claude Code kenali](/docs/id/errors#prompt-is-too-long). Claude Code tidak menjalankan pemulihan itu ketika gateway [menulis ulang kesalahan](/docs/id/llm-gateway-connect#troubleshoot-gateway-errors) ke kata-kata yang Claude Code tidak kenali.909Untuk ID model yang Claude Code tidak kenali, atur [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/id/env-vars) agar Claude Code melakukan compaction hanya setelah API menolak percakapan dengan [kesalahan terlalu panjang yang Claude Code kenali](/docs/id/errors#prompt-is-too-long). Claude Code tidak menjalankan pemulihan itu ketika gateway [menulis ulang kesalahan](/docs/id/llm-gateway-connect#troubleshoot-gateway-errors) ke kata-kata yang Claude Code tidak kenali.

902 910

903<h2 id="checking-your-current-model">911<h2 id="checking-your-current-model">

904 Memeriksa model Anda saat ini912 Memeriksa model Anda saat ini

939ID kustom yang menyematkan nama keluarga, seperti `my-gateway/claude-opus-5-5`, dihitung sebagai entri spesifik untuk keluarga itu dan menonaktifkan wildcard-nya, jadi juga daftarkan versi yang ingin Anda pertahankan dapat dipilih. Lihat [Perilaku penggabungan](#merge-behavior).947ID kustom yang menyematkan nama keluarga, seperti `my-gateway/claude-opus-5-5`, dihitung sebagai entri spesifik untuk keluarga itu dan menonaktifkan wildcard-nya, jadi juga daftarkan versi yang ingin Anda pertahankan dapat dipilih. Lihat [Perilaku penggabungan](#merge-behavior).

940 948

941<h2 id="environment-variables">949<h2 id="environment-variables">

942 Variabel lingkungan950 Environment variable

943</h2>951</h2>

944 952

945Gunakan variabel lingkungan berikut untuk mengontrol nama model yang dipetakan alias. Setiap nilai harus berupa nama model lengkap, atau pengenal setara untuk penyedia API Anda. Untuk memilih model yang dimulai sesi Anda, atur [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), yang tabel ini abaikan.953Gunakan environment variable berikut untuk mengontrol nama model yang dipetakan alias. Setiap nilai harus berupa nama model lengkap, atau pengenal setara untuk penyedia API Anda. Untuk memilih model yang dimulai sesi Anda, atur [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), yang tabel ini abaikan.

946 954

947| Variabel lingkungan | Deskripsi |955| Environment variable | Deskripsi |

948| - | - |956| - | - |

949| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Model yang digunakan untuk `fable`, dan ID model yang dikenali Claude Code sebagai model Fable untuk [fallback model otomatis](#automatic-model-fallback) pada penyedia pihak ketiga |957| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Model yang digunakan untuk `fable`, dan ID model yang dikenali Claude Code sebagai model Fable untuk [fallback model otomatis](#automatic-model-fallback) pada penyedia pihak ketiga |

951| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model yang digunakan untuk `sonnet`, atau untuk `opusplan` ketika Plan Mode tidak aktif. |959| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model yang digunakan untuk `sonnet`, atau untuk `opusplan` ketika Plan Mode tidak aktif. |

952| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model yang digunakan untuk `haiku`, atau [fungsionalitas latar belakang](/docs/id/costs#background-token-usage) |960| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model yang digunakan untuk `haiku`, atau [fungsionalitas latar belakang](/docs/id/costs#background-token-usage) |

953| `CLAUDE_CODE_SUBAGENT_MODEL` | Model default untuk [subagents](/docs/id/sub-agents#choose-a-model), [agent team](/docs/id/agent-teams#specify-teammates-and-models) rekan kerja, dan agen [workflow](/docs/id/workflows) yang tidak ditugaskan model dengan cara lain. Menerima alias seperti `haiku` atau nama model lengkap. Model per-invocation atau bidang `model` definisi, termasuk `inherit`, mengambil prioritas. Untuk mengubah itu, atur [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/id/sub-agents#run-every-subagent-on-one-model) |961| `CLAUDE_CODE_SUBAGENT_MODEL` | Model default untuk [subagent](/docs/id/sub-agents#choose-a-model), rekan [tim agent](/docs/id/agent-teams#specify-teammates-and-models), dan agent [workflow](/docs/id/workflows) yang tidak ditugaskan model dengan cara lain. Menerima alias seperti `haiku` atau nama model lengkap. Model per-invocation atau bidang `model` definisi, termasuk `inherit`, diutamakan. Untuk mengubah itu, atur [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/id/sub-agents#run-every-subagent-on-one-model) |

954 962

955Pada penyedia pihak ketiga, [Sesuaikan tampilan dan kemampuan model yang ditetapkan](#customize-pinned-model-display-and-capabilities) menjelaskan apa yang ditampilkan baris model yang ditetapkan di pemilih `/model`.963Pada penyedia pihak ketiga, [Sesuaikan tampilan dan kemampuan model yang ditetapkan](#customize-pinned-model-display-and-capabilities) menjelaskan apa yang ditampilkan baris model yang ditetapkan di pemilih `/model`.

956 964

957Catatan: `ANTHROPIC_SMALL_FAST_MODEL` sudah usang dan digantikan oleh `ANTHROPIC_DEFAULT_HAIKU_MODEL`.965Catatan: `ANTHROPIC_SMALL_FAST_MODEL` sudah deprecated dan digantikan oleh

966`ANTHROPIC_DEFAULT_HAIKU_MODEL`.

958 967

959<h3 id="pin-models-for-third-party-deployments">968<h3 id="pin-models-for-third-party-deployments">

960 Tetapkan model untuk deployment pihak ketiga969 Tetapkan model untuk deployment pihak ketiga

961</h3>970</h3>

962 971

963Saat menerapkan Claude Code melalui [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), [Microsoft Foundry](/docs/id/microsoft-foundry), atau [Claude Platform on AWS](/docs/id/claude-platform-on-aws), tetapkan versi model sebelum meluncurkan ke pengguna.972Saat men-deploy Claude Code melalui [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), [Microsoft Foundry](/docs/id/microsoft-foundry), atau [Claude Platform on AWS](/docs/id/claude-platform-on-aws), tetapkan versi model sebelum meluncurkan ke pengguna.

964 973

965Tanpa penentapan, Claude Code menggunakan alias model seperti `fable`, `opus`, `sonnet`, dan `haiku` yang diselesaikan ke ID model default bawaan untuk setiap penyedia. Default tersebut dapat tertinggal dari rilis Anthropic terbaru, dan model yang ditunjuknya mungkin belum diaktifkan di akun pengguna. Ketika default tidak tersedia, pengguna Amazon Bedrock dan Google Cloud's Agent Platform melihat pemberitahuan dan sesi kembali ke versi sebelumnya dari model default, atau ke model Sonnet default ketika default adalah model Opus dan tidak ada versi Opus yang tersedia. Pengguna Microsoft Foundry melihat kesalahan sebagai gantinya, karena Microsoft Foundry tidak memiliki pemeriksaan startup yang setara.974Tanpa penetapan, Claude Code menggunakan alias model seperti `fable`, `opus`, `sonnet`, dan `haiku` yang diselesaikan ke ID model default bawaan untuk setiap penyedia. Default tersebut dapat tertinggal dari rilis Anthropic terbaru, dan model yang ditunjuknya mungkin belum diaktifkan di akun pengguna. Ketika default tidak tersedia, pengguna Amazon Bedrock dan Google Cloud's Agent Platform melihat pemberitahuan dan sesi kembali ke versi sebelumnya dari model default, atau ke model Sonnet default ketika default adalah model Opus dan tidak ada versi Opus yang tersedia. Pengguna Microsoft Foundry melihat kesalahan sebagai gantinya, karena Microsoft Foundry tidak memiliki pemeriksaan startup yang setara.

966 975

967Di Amazon Bedrock dan Google Cloud's Agent Platform, pengguna yang memulai sesi pada versi Sonnet atau Opus tertentu, misalnya dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model`, menetapkan versi itu sebagai default sesi untuk alias yang cocok: pemeriksaan startup melewati default bawaan yang digantikannya dan tidak menampilkan pemberitahuan fallback. Sebelum v2.1.211, pemeriksaan berjalan dan dapat menampilkan pemberitahuan bahkan ketika model sesi dikonfigurasi secara eksplisit.976Di Amazon Bedrock dan Google Cloud's Agent Platform, pengguna yang memulai sesi pada versi Sonnet atau Opus tertentu, misalnya dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model`, menetapkan versi itu sebagai default sesi untuk alias yang cocok: pemeriksaan startup melewati default bawaan yang digantikannya dan tidak menampilkan pemberitahuan fallback. Sebelum v2.1.211, pemeriksaan berjalan dan dapat menampilkan pemberitahuan bahkan ketika model sesi dikonfigurasi secara eksplisit.

968 977

969<Warning>978<Warning>

970 Atur variabel lingkungan model ke ID versi spesifik sebagai bagian dari pengaturan awal Anda. Penentapan memungkinkan Anda mengontrol kapan pengguna Anda pindah ke model baru.979 Atur environment variable model ke ID versi spesifik sebagai bagian dari pengaturan awal Anda. Penetapan memungkinkan Anda mengontrol kapan pengguna Anda pindah ke model baru.

971</Warning>980</Warning>

972 981

973Gunakan variabel lingkungan berikut dengan ID model spesifik versi untuk penyedia Anda:982Gunakan environment variable berikut dengan ID model spesifik versi untuk penyedia Anda:

974 983

975| Penyedia | Contoh |984| Penyedia | Contoh |

976| :- | :- |985| :- | :- |

980 989

981Terapkan pola yang sama untuk `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, dan `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Untuk ID model saat ini dan warisan di semua penyedia, lihat [Ikhtisar Model](https://platform.claude.com/docs/en/about-claude/models/overview). Untuk meningkatkan pengguna ke versi model baru, perbarui variabel lingkungan ini dan terapkan kembali.990Terapkan pola yang sama untuk `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, dan `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Untuk ID model saat ini dan warisan di semua penyedia, lihat [Ikhtisar Model](https://platform.claude.com/docs/en/about-claude/models/overview). Untuk meningkatkan pengguna ke versi model baru, perbarui environment variable ini dan deploy ulang.

991

992Model yang ditetapkan dengan window 1M bawaan, seperti Opus 4.8 atau Sonnet 5, berjalan dengan [context window 1M](#extended-context) tanpa akhiran apa pun ketika Claude Code dapat mencocokkan ID yang ditetapkan dengan model tersebut. ID cocok ketika mengandung ID API Anthropic model tersebut, seperti `us.anthropic.claude-opus-4-8` mengandung `claude-opus-4-8`, atau ketika entri [`modelOverrides`](#override-model-ids-per-version) memetakan model tersebut ke ID itu. Pada ID yang ditetapkan yang tidak dapat dicocokkan Claude Code dengan model mana pun, sesi berjalan dengan window 200K secara default kecuali ID tersebut membawa akhiran `[1m]`.

982 993

983Untuk mengaktifkan [konteks diperluas](#extended-context) untuk model yang ditetapkan, tambahkan `[1m]` ke ID model dalam `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, atau `ANTHROPIC_DEFAULT_FABLE_MODEL`:994Untuk model yang mencapai 1M melalui varian `[1m]`-nya, seperti Opus 4.6 atau Sonnet 4.6, aktifkan konteks diperluas dengan menambahkan `[1m]` ke ID model dalam `ANTHROPIC_DEFAULT_OPUS_MODEL` atau `ANTHROPIC_DEFAULT_SONNET_MODEL`:

984 995

985```bash theme={null}996```bash theme={null}

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

987```998```

988 999

989Dengan akhiran `[1m]`, jendela konteks 1M berlaku untuk semua penggunaan alias yang ditetapkan, termasuk fase Opus mode-rencana dari [`opusplan`](#opusplan-model-setting) dan [subagents](/docs/id/sub-agents#choose-a-model) yang `model` frontmatter mereka menamai alias.1000Dengan akhiran `[1m]`, context window 1M berlaku untuk semua penggunaan alias yang ditetapkan, termasuk fase Opus plan mode dari [`opusplan`](#opusplan-model-setting) dan [subagent](/docs/id/sub-agents#choose-a-model) yang `model` frontmatter mereka menamai alias.

990 1001

991* Claude Code menghapus akhiran sebelum mengirim ID model ke penyedia Anda.1002* Claude Code menghapus akhiran sebelum mengirim ID model ke penyedia Anda.

992* Hanya tambahkan `[1m]` ketika model yang mendasar [mendukung konteks 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).1003* Hanya tambahkan `[1m]` ketika model yang mendasar [mendukung konteks 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

993* Akhiran dibaca per variabel, bukan per model. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, ID model tanpa `[1m]` dalam satu variabel menggunakan konteks 200K bahkan jika variabel lain menetapkan model yang sama dengan akhiran. Sonnet 5 selalu berjalan dengan jendela 1M pada penyedia ini dan tidak pernah memerlukan akhiran.1004* Akhiran dibaca per variabel, bukan per model. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, ID Opus 4.6 atau Sonnet 4.6 tanpa `[1m]` dalam satu variabel menggunakan konteks 200K bahkan jika variabel lain menetapkan model yang sama dengan akhiran.

994 1005

995Ketika Anda menetapkan variabel `ANTHROPIC_DEFAULT_*_MODEL`, pemilih `/model` menampilkan satu baris untuk model itu menggantikan baris bawaan keluarga, termasuk baris konteks 1M apa pun. Untuk mencapai jendela 1M tanpa menambahkan akhiran ke variabel itu, pengguna Anda menjalankan `/model opus[1m]`, dan Claude Code menerapkan akhiran ke model yang dinamai variabel. `/model sonnet[1m]` bekerja dengan cara yang sama.1006Ketika Anda menetapkan variabel `ANTHROPIC_DEFAULT_*_MODEL`, pemilih `/model` menampilkan satu baris untuk model itu menggantikan baris bawaan keluarga, termasuk baris konteks 1M apa pun. Untuk mencapai window 1M tanpa menambahkan akhiran ke variabel itu, pengguna Anda menjalankan `/model opus[1m]`, dan Claude Code menerapkan akhiran ke model yang dinamai variabel. `/model sonnet[1m]` bekerja dengan cara yang sama.

996 1007

997<Note>1008<Note>

998 Allowlist `availableModels` yang dikirimkan melalui [MDM atau file pengaturan terkelola](/docs/id/managed-settings#delivery-mechanisms) masih berlaku saat menggunakan penyedia pihak ketiga; [pengaturan yang dikelola server tidak dikirimkan di sana](/docs/id/server-managed-settings#platform-availability).1009 Allowlist `availableModels` yang dikirimkan melalui [MDM atau file pengaturan terkelola](/docs/id/managed-settings#delivery-mechanisms) masih berlaku saat menggunakan penyedia pihak ketiga; [pengaturan yang dikelola server tidak dikirimkan di sana](/docs/id/server-managed-settings#platform-availability).

1011 1022

1012Ketika baris menampilkan nama model, deskripsi defaultnya mencakup ID yang ditetapkan sehingga Anda masih dapat melihat ID mana yang ditetapkan.1023Ketika baris menampilkan nama model, deskripsi defaultnya mencakup ID yang ditetapkan sehingga Anda masih dapat melihat ID mana yang ditetapkan.

1013 1024

1014Claude Code juga mungkin tidak mengenali fitur mana yang didukung model yang ditetapkan. Anda dapat menetapkan nama tampilan dan deskripsi sendiri dan mendeklarasikan kemampuan dengan variabel lingkungan pendamping untuk setiap model yang ditetapkan.1025Claude Code juga mungkin tidak mengenali fitur mana yang didukung model yang ditetapkan. Anda dapat menetapkan nama tampilan dan deskripsi sendiri dan mendeklarasikan kemampuan dengan environment variable pendamping untuk setiap model yang ditetapkan.

1015 1026

1016Variabel ini berlaku pada penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry. Variabel `_NAME` dan `_DESCRIPTION` juga berlaku ketika `ANTHROPIC_BASE_URL` menunjuk ke [gateway LLM](/docs/id/llm-gateway). Mereka tidak berpengaruh saat menghubungkan langsung ke `api.anthropic.com`.1027Variabel ini berlaku pada penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry. Variabel `_NAME` dan `_DESCRIPTION` juga berlaku ketika `ANTHROPIC_BASE_URL` menunjuk ke [gateway LLM](/docs/id/llm-gateway). Mereka tidak berpengaruh saat menghubungkan langsung ke `api.anthropic.com`.

1017 1028

1018| Variabel lingkungan | Deskripsi |1029| Environment variable | Deskripsi |

1019| - | - |1030| - | - |

1020| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nama tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan nama model jika Claude Code mengenali ID yang ditetapkan, dan ID yang ditetapkan sebaliknya |1031| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nama tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan nama model jika Claude Code mengenali ID yang ditetapkan, dan ID yang ditetapkan sebaliknya |

1021| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Deskripsi tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan deskripsi default yang dimulai dengan `Custom Opus model` |1032| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Deskripsi tampilan untuk model Opus yang ditetapkan di pemilih `/model`. Ketika tidak diatur, baris menampilkan deskripsi default yang dimulai dengan `Custom Opus model` |

1023 1034

1024Akhiran `_NAME`, `_DESCRIPTION`, dan `_SUPPORTED_CAPABILITIES` yang sama tersedia untuk `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL`, dan `ANTHROPIC_CUSTOM_MODEL_OPTION`.1035Akhiran `_NAME`, `_DESCRIPTION`, dan `_SUPPORTED_CAPABILITIES` yang sama tersedia untuk `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL`, dan `ANTHROPIC_CUSTOM_MODEL_OPTION`.

1025 1036

1026Claude Code mengaktifkan fitur seperti [tingkat usaha](#adjust-effort-level) dan [extended thinking](#extended-thinking) dengan mencocokkan ID model terhadap pola yang dikenal. ID spesifik penyedia seperti ARN Amazon Bedrock atau nama deployment kustom sering kali tidak cocok dengan pola ini, meninggalkan fitur yang didukung dinonaktifkan. Atur `_SUPPORTED_CAPABILITIES` untuk memberi tahu Claude Code fitur mana yang benar-benar didukung model:1037Claude Code mengaktifkan fitur seperti [tingkat effort](#adjust-effort-level) dan [extended thinking](#extended-thinking) dengan mencocokkan ID model terhadap pola yang dikenal. ID spesifik penyedia seperti ARN Amazon Bedrock atau nama deployment kustom sering kali tidak cocok dengan pola ini, meninggalkan fitur yang didukung dinonaktifkan. Atur `_SUPPORTED_CAPABILITIES` untuk memberi tahu Claude Code fitur mana yang benar-benar didukung model:

1027 1038

1028| Nilai kemampuan | Mengaktifkan |1039| Nilai kemampuan | Mengaktifkan |

1029| - | - |1040| - | - |

1036 1047

1037Ketika `_SUPPORTED_CAPABILITIES` diatur, kemampuan yang tercantum diaktifkan dan kemampuan yang tidak tercantum dinonaktifkan untuk model yang ditetapkan yang cocok. Ketika variabel tidak diatur, Claude Code kembali ke deteksi bawaan berdasarkan ID model.1048Ketika `_SUPPORTED_CAPABILITIES` diatur, Claude Code mengaktifkan kemampuan yang tercantum dan menonaktifkan kemampuan yang tidak tercantum untuk model yang ditetapkan yang cocok. Ketika variabel tidak diatur, Claude Code kembali ke deteksi bawaan berdasarkan ID model.

1038 1049

1039Contoh ini menetapkan Opus ke ARN model kustom Amazon Bedrock, menetapkan nama yang ramah, dan mendeklarasikan kemampuannya:1050Contoh ini menetapkan Opus ke ARN model kustom Amazon Bedrock, menetapkan nama yang ramah, dan mendeklarasikan kemampuannya:

1040 1051

1046```1057```

1047 1058

1048<h3 id="override-model-ids-per-version">1059<h3 id="override-model-ids-per-version">

1049 Ganti ID model per versi1060 Timpa ID model per versi

1050</h3>1061</h3>

1051 1062

1052Di platform yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/id/env-vars), konfigurasi model host mengambil prioritas atas pengaturan model terkelola, sementara allowlist `availableModels` terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; [Pengecualian untuk prioritas pengaturan terkelola](/docs/id/settings#exceptions-to-managed-settings-precedence) mengatakan kunci dan variabel mana yang diganti host.1063Di platform yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/id/env-vars), konfigurasi model host diutamakan daripada pengaturan model terkelola, sementara allowlist `availableModels` terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; [Pengecualian untuk prioritas pengaturan terkelola](/docs/id/settings#exceptions-to-managed-settings-precedence) menjelaskan kunci dan variabel mana yang ditimpa host.

1053 1064

1054Variabel lingkungan tingkat keluarga di atas mengonfigurasi satu ID model per alias keluarga. Jika Anda perlu memetakan beberapa versi dalam keluarga yang sama ke ID penyedia yang berbeda, gunakan pengaturan `modelOverrides` sebagai gantinya.1065Environment variable tingkat keluarga di atas mengonfigurasi satu ID model per alias keluarga. Jika Anda perlu memetakan beberapa versi dalam keluarga yang sama ke ID penyedia yang berbeda, gunakan pengaturan `modelOverrides` sebagai gantinya.

1055 1066

1056`modelOverrides` memetakan ID model Anthropic individual ke string spesifik penyedia yang dikirim Claude Code ke API penyedia Anda. Ketika pengguna memilih model yang dipetakan di pemilih `/model`, Claude Code menggunakan nilai yang Anda konfigurasi alih-alih default bawaan.1067`modelOverrides` memetakan ID model Anthropic individual ke string spesifik penyedia yang dikirim Claude Code ke API penyedia Anda. Ketika pengguna memilih model yang dipetakan di pemilih `/model`, Claude Code menggunakan nilai yang Anda konfigurasi alih-alih default bawaan.

1057 1068

1073 1084

1074Untuk menghentikan [baris diagnostik](/docs/id/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` untuk ID seperti alias gateway, tambahkan entri dengan ID itu sebagai nilainya.1085Untuk menghentikan [baris diagnostik](/docs/id/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` untuk ID seperti alias gateway, tambahkan entri dengan ID itu sebagai nilainya.

1075 1086

1076Penggantian menggantikan ID model bawaan yang mendukung setiap entri di pemilih `/model`. Di Amazon Bedrock, entri `modelOverrides` mengambil prioritas atas profil inferensi apa pun yang ditemukan Claude Code secara otomatis saat startup. Claude Code meneruskan nilai yang sudah bentuk penyedia asli, seperti ARN profil inferensi Amazon Bedrock atau nama deployment Microsoft Foundry, ke penyedia apa adanya.1087Override menggantikan ID model bawaan yang mendukung setiap entri di pemilih `/model`. Di Amazon Bedrock, entri `modelOverrides` diutamakan daripada profil inferensi apa pun yang ditemukan Claude Code secara otomatis saat startup. Claude Code meneruskan nilai yang sudah dalam bentuk asli penyedia, seperti ARN profil inferensi Amazon Bedrock atau nama deployment Microsoft Foundry, ke penyedia apa adanya.

1077 1088

1078Penggantian juga berlaku ketika Anda meneruskan ID model Anthropic secara langsung melalui `--model`, variabel lingkungan `ANTHROPIC_MODEL`, atau variabel lingkungan `ANTHROPIC_DEFAULT_*_MODEL`. Di Amazon Bedrock, Google Cloud's Agent Platform, dan [Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), ID model Anthropic tanpa entri `modelOverrides` diselesaikan ke ID spesifik penyedia yang sama dengan baris pemilih `/model` untuk versi itu, ketika penyedia mendukung versi itu. Mantle mendukung subset versi. Untuk ID model Anthropic di luar subset itu, Claude Code mengirim ID mentah ke Mantle tanpa memetakannya, kecuali entri `modelOverrides` mencakupnya. Sebelum v2.1.200, `--model` dan nilai variabel lingkungan mencapai penyedia apa adanya tanpa melewati peta penggantian.1089Override juga berlaku ketika Anda meneruskan ID model Anthropic secara langsung melalui `--model`, environment variable `ANTHROPIC_MODEL`, atau environment variable `ANTHROPIC_DEFAULT_*_MODEL`. Di Amazon Bedrock, Google Cloud's Agent Platform, dan [Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), ID model Anthropic tanpa entri `modelOverrides` diselesaikan ke ID spesifik penyedia yang sama dengan baris pemilih `/model` untuk versi itu, ketika penyedia mendukung versi itu. Mantle mendukung subset versi. Untuk ID model Anthropic di luar subset itu, Claude Code mengirim ID mentah ke Mantle tanpa memetakannya, kecuali entri `modelOverrides` mencakupnya. Sebelum v2.1.200, `--model` dan nilai environment variable mencapai penyedia apa adanya tanpa melewati peta override.

1079 1090

1080`modelOverrides` bekerja bersama `availableModels`. Allowlist dievaluasi terhadap ID model Anthropic, bukan nilai penggantian, jadi entri seperti `"opus"` dalam `availableModels` terus cocok bahkan ketika versi Opus dipetakan ke ARN. Ketika `enforceAvailableModels` diatur dalam pengaturan terkelola, Default yang diterapkan diselesaikan melalui `modelOverrides` dari [pengaturan terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) saja. Pemetaan admin, seperti versi yang ditetapkan ke ARN profil inferensi, dihormati dalam Default yang diterapkan. Penggantian dari pengaturan pengguna atau proyek tidak mempengaruhinya.1091`modelOverrides` bekerja bersama `availableModels`. Allowlist dievaluasi terhadap ID model Anthropic, bukan nilai override, jadi entri seperti `"opus"` dalam `availableModels` terus cocok bahkan ketika versi Opus dipetakan ke ARN. Ketika `enforceAvailableModels` diatur dalam pengaturan terkelola, Default yang diterapkan diselesaikan melalui `modelOverrides` dari [pengaturan terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) saja. Pemetaan admin, seperti versi yang ditetapkan ke ARN profil inferensi, dihormati dalam Default yang diterapkan. Override dari pengaturan pengguna atau proyek tidak mempengaruhinya.

1081 1092

1082Ketika `availableModels` diatur dalam [pengaturan terkelola](/docs/id/managed-settings), hanya `modelOverrides` dari pengaturan terkelola yang berlaku untuk ID model Anthropic yang diteruskan secara langsung melalui `--model` atau variabel lingkungan di atas. Claude Code mengabaikan penggantian dalam pengaturan pengguna atau proyek untuk ID tersebut, dan tidak pernah menyelesaikan ID yang dikecualikan daftar terkelola melalui `modelOverrides` dari sumber pengaturan apa pun. Pembatasan sumber terkelola ini memerlukan Claude Code v2.1.200 atau lebih baru. Lihat [Batasi pemilihan model](#restrict-model-selection) untuk cara ID yang diblokir ditangani.1093Ketika `availableModels` diatur dalam [pengaturan terkelola](/docs/id/managed-settings), hanya `modelOverrides` dari pengaturan terkelola yang berlaku untuk ID model Anthropic yang diteruskan secara langsung melalui `--model` atau environment variable di atas. Claude Code mengabaikan override dalam pengaturan pengguna atau proyek untuk ID tersebut, dan tidak pernah menyelesaikan ID yang dikecualikan daftar terkelola melalui `modelOverrides` dari sumber pengaturan apa pun. Pembatasan sumber terkelola ini memerlukan Claude Code v2.1.200 atau lebih baru. Lihat [Batasi pemilihan model](#restrict-model-selection) untuk cara ID yang diblokir ditangani.

1083 1094

1084<h3 id="prompt-caching-configuration">1095<h3 id="prompt-caching-configuration">

1085 Konfigurasi prompt caching1096 Konfigurasi prompt caching

1087 1098

1088Claude Code secara otomatis menggunakan [prompt caching](/docs/id/prompt-caching) untuk mengoptimalkan kinerja dan mengurangi biaya. Anda dapat menonaktifkan prompt caching secara global atau untuk tingkat model tertentu:1099Claude Code secara otomatis menggunakan [prompt caching](/docs/id/prompt-caching) untuk mengoptimalkan kinerja dan mengurangi biaya. Anda dapat menonaktifkan prompt caching secara global atau untuk tingkat model tertentu:

1089 1100

1090| Variabel lingkungan | Deskripsi |1101| Environment variable | Deskripsi |

1091| - | - |1102| - | - |

1092| `DISABLE_PROMPT_CACHING` | Atur ke `1` untuk menonaktifkan prompt caching untuk semua model. Mengambil alih pengaturan per-model |1103| `DISABLE_PROMPT_CACHING` | Atur ke `1` untuk menonaktifkan prompt caching untuk semua model. Diutamakan daripada pengaturan per-model |

1093| `DISABLE_PROMPT_CACHING_HAIKU` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Haiku default](/docs/id/prompt-caching#disable-prompt-caching) |1104| `DISABLE_PROMPT_CACHING_HAIKU` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Haiku default](/docs/id/prompt-caching#disable-prompt-caching) |

1094| `DISABLE_PROMPT_CACHING_SONNET` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Sonnet default](/docs/id/prompt-caching#disable-prompt-caching) |1105| `DISABLE_PROMPT_CACHING_SONNET` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Sonnet default](/docs/id/prompt-caching#disable-prompt-caching) |

1095| `DISABLE_PROMPT_CACHING_OPUS` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Opus default](/docs/id/prompt-caching#disable-prompt-caching) |1106| `DISABLE_PROMPT_CACHING_OPUS` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Opus default](/docs/id/prompt-caching#disable-prompt-caching) |

1097 1108

1098Untuk memilih cache TTL untuk percakapan utama dan untuk subagents secara terpisah, lihat [pilih TTL sendiri](/docs/id/prompt-caching#choose-the-ttl-yourself). Untuk apa yang memicu cache miss, lihat [Bagaimana Claude Code menggunakan prompt caching](/docs/id/prompt-caching).1109Untuk memilih cache TTL untuk percakapan utama dan untuk subagent secara terpisah, lihat [pilih TTL sendiri](/docs/id/prompt-caching#choose-the-ttl-yourself). Untuk apa yang memicu cache miss, lihat [Bagaimana Claude Code menggunakan prompt caching](/docs/id/prompt-caching).

1099 1110

1100<h2 id="version-history">1111<h2 id="version-history">

1101 Riwayat versi1112 Riwayat versi

model-config.md 2026-10-07 23:59 UTC to 2026-10-08 21:58 UTC

Konfigurasi model

Model yang tersedia

Alias model

Bekerja dengan Fable

Fable dan kredit penggunaan

Mengatur model Anda

Tetapkan model default untuk sesi baru

Sesi baru dimulai di model yang berbeda dari yang Anda pilih

Batasi pemilihan model

Cakupan permukaan

Perilaku model default

Berlakukan daftar putih untuk model Default

Kontrol model yang dijalankan pengguna

Perilaku penggabungan

ID model Mantle

Blokir model atau versi tertentu

Pembatasan model organisasi

Model default organisasi

Batas upaya organisasi

Perilaku model khusus

Pengaturan model `default`

Pengaturan model `opusplan`

Rantai model fallback

Fallback model otomatis

Tingkat effort setelah fallback

Periksa apa yang memicu fallback

Tanyakan sebelum beralih

Aktifkan fallback pada Bedrock, Agent Platform, dan Foundry

Penelitian keamanan dan beban kerja biologi

Sesuaikan tingkat effort

Pilih tingkat effort

Gunakan ultrathink untuk penalaran mendalam sekali jalan

Atur tingkat effort

Penalaran adaptif dan thinking budget tetap

Extended thinking

Konteks diperpanjang

Pilih konteks 1M untuk Opus 4.6 atau Sonnet 4.6

Context window di belakang gateway LLM

Matikan konteks 1M

Context window dan harga Haiku 5.5

Context window dan auto-compaction

Atur jendela auto-compact

Ambang batas auto-compact default

Perbaiki jendela untuk gateway atau ID model kustom

Memeriksa model Anda saat ini

Tambahkan opsi model kustom

Environment variable

Tetapkan model untuk deployment pihak ketiga

Sesuaikan tampilan dan kemampuan model yang ditetapkan

Timpa ID model per versi

Konfigurasi prompt caching

Riwayat versi