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:

• Sebuah alias model
• Sebuah nama model
  • Anthropic API: nama model lengkap
  • Amazon Bedrock: ARN inference profile
  • Microsoft Foundry: nama deployment
  • Google Cloud's Agent Platform: nama versi

Untuk panduan tentang model dan tingkat effort mana yang cocok untuk berbagai jenis pekerjaan, lihat Choosing a Claude model and effort level in Claude Code di blog.

[!NOTE]

ANTHROPIC_BASE_URL mengubah ke mana permintaan dikirim, bukan model mana yang menjawabnya. Untuk merutekan Claude melalui LLM gateway, lihat LLM gateway.

Alias model

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

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

Kecuali Anda mengatur ANTHROPIC_DEFAULT_FABLE_MODEL, alias fable mengarah ke Fable 5 dalam sesi Claude apps gateway dan ke Fable 5.2 di tempat lain.

Gateway yang tidak dikonfigurasi untuk menyajikan claude-fable-5-2 akan menolak permintaan untuk model tersebut. Untuk menggunakan Fable 5.2 melalui gateway yang menyajikannya, pilih dengan /model claude-fable-5-2.

Jika opus atau sonnet mengarah ke model yang lebih lama, model yang lebih baru tersedia dengan memilih nama model lengkap secara eksplisit atau mengatur ANTHROPIC_DEFAULT_OPUS_MODEL atau ANTHROPIC_DEFAULT_SONNET_MODEL.

Versi sebelumnya mengarahkan alias ini ke model yang lebih lama. Untuk versi saat setiap alias berubah, lihat Riwayat versi.

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

[!NOTE]

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 does not support this model. Gunakan v2.1.293 atau lebih baru dengan Haiku 5.5. Jalankan claude update untuk memperbarui.

Bekerja dengan Fable

Model Claude Fable adalah model paling mumpuni di Claude Code, cocok untuk tugas yang lebih besar dari satu kali duduk. Model ini mampu mempertahankan sesi otonom yang panjang, menyelidiki sebelum bertindak, dan memverifikasi pekerjaannya lebih sering daripada model yang lebih kecil.

Tidak ada model Fable yang menjadi default tipe akun di paket atau penyedia mana pun. Pilih salah satunya secara eksplisit:

• Fable 5.2: jalankan /model fable, atau luncurkan dengan claude --model fable. Dalam sesi Claude apps gateway, jalankan /model claude-fable-5-2 sebagai gantinya.
• Fable 5.1 atau Fable 5: pilih berdasarkan ID model. Di Anthropic API, jalankan /model claude-fable-5-1 atau /model claude-fable-5, atau luncurkan dengan claude --model claude-fable-5-1. Di penyedia lain, gunakan ID model penyedia Anda atau kunci dengan ANTHROPIC_DEFAULT_FABLE_MODEL.

Pada paket Pro, Max, Ultra, Team, dan Enterprise, model claude-fable-5-1 yang disimpan di pengaturan pengguna Anda dipindahkan ke alias fable:

• Paket Pro, Max, atau Ultra: pemindahan terjadi saat pertama kali Anda menjalankan v2.1.321 atau lebih baru. Di terminal, baris model saat startup dapat menampilkan (auto-updated) satu kali.
• Paket Team atau Enterprise: pemindahan menunggu pengaturan organisasi Anda, sehingga dapat terjadi pada startup berikutnya, atau tidak sama sekali. Pemindahan berlaku mulai sesi berikutnya, tanpa baris (auto-updated). Untuk memeriksa model Anda, jalankan /model.

Setelah pemindahan, sesi dimulai pada effort default Fable 5.2 kecuali Anda telah mengatur tingkat untuknya. Akun Console, penyedia pihak ketiga, serta pengaturan proyek, lokal, atau terkelola tetap menggunakan claude-fable-5-1.

Permintaan yang ditandai oleh pengklasifikasi keamanan model Fable, 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 model merencanakan jalannya. Agar model tetap bekerja menuju hasil tersebut, tetapkan tujuan.
• Berikan masalah yang ambigu: investigasi akar masalah, debugging gangguan layanan, dan keputusan arsitektur adalah area di mana investigasi dan verifikasi tambahan memberikan hasil.
• Lewati pengingat verifikasi: model memverifikasi pekerjaannya sendiri dengan lebih sedikit arahan, sehingga pengingat untuk menguji atau memeriksa biasanya tidak diperlukan.
• Perbesar ukuran tugas: berikan pekerjaan yang biasanya Anda pecah menjadi beberapa bagian. Model ini dapat mempertahankan sesi panjang tanpa kehilangan alur.

[!NOTE]

Fable 5.2 memerlukan Claude Code v2.1.321 atau lebih baru, dan Fable 5.1 memerlukan v2.1.257 atau lebih baru. Jika permintaan untuk salah satunya dari versi yang lebih lama gagal, lihat Claude Code does not support this model. Jalankan claude update untuk memperbarui. Untuk ketersediaan di bawah zero data retention, lihat Ketersediaan model di bawah ZDR.

Di Anthropic API, model Fable muncul di pemilih /model kecuali availableModels atau pembatasan model organisasi mengecualikannya. Ketika organisasi Anda sama sekali tidak dapat menggunakan Fable, misalnya di bawah zero data retention, barisnya tetap ada di pemilih dalam keadaan berwarna abu-abu, dengan catatan mengenai alasannya.

Fable dan kredit penggunaan

Tergantung pada paket dan tingkat seat Anda, penggunaan Fable dapat ditagihkan ke kredit penggunaan alih-alih menggunakan batas yang disertakan dalam paket Anda. Jika demikian, pemilih /model menampilkan "Requires usage credits" pada baris Fable. Untuk mengelola kredit penggunaan, lihat Menambahkan kredit penggunaan ke langganan Anda.

Dalam sesi interaktif, Claude Code dapat menampilkan dialog persetujuan kredit penggunaan Fable. Anda dapat melanjutkan di Fable menggunakan kredit penggunaan atau beralih ke model default Anda. Anda juga dapat menutup dialog tersebut:

• Ketika Anda memilih model Fable dengan /model, Anda tetap menggunakan model Anda saat ini.
• Di tengah sesi, Claude Code melanjutkan giliran dengan model default Anda.

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

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

Apa yang dapat Anda lakukan saat dialog menunggu tergantung pada sesinya:

• Dengan Remote Control terhubung atau dalam sesi rekan tim, tekan tombol apa pun di terminal untuk membatalkan batas waktu, dan Claude Code akan 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 tetap menunggu jawaban dan mengantrekan pesan baru Anda di belakangnya.

Dalam sesi yang di-host oleh aplikasi lain melalui Agent SDK, apakah dialog muncul atau tidak tergantung pada aplikasi tersebut. Jika dialog 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 dialog, Claude Code tidak pernah meminta persetujuan. Ketika permintaan Fable di sana akan ditagihkan ke kredit penggunaan, Claude Code menagihkannya tanpa bertanya.

Mengatur model Anda

Anda dapat mengonfigurasi model dengan beberapa cara, yang diurutkan berdasarkan prioritas:

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

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

• Enter: beralih model dan simpan sebagai default Anda
• s: beralih model hanya untuk sesi ini dan biarkan default Anda tidak berubah. Untuk menggunakan tombol lain, ubah pintasan keyboard modelPicker:thisSessionOnly

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

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

• Ketika admin Anda belum mengatur model default organisasi, opsi Default dapat mengarah ke model yang tercatat, dan jika demikian, baris Default di pemilih menampilkan nama model tersebut.
• Jika pembatasan model mengecualikan model yang tercatat atau model tersebut tidak tersedia untuk akun Anda, dan admin Anda belum mengatur model default organisasi, opsi Default diselesaikan seolah-olah tidak ada yang tercatat.
• Jika Anda memilih Default atau opusplan di /model, pilihan yang tercatat tidak berubah.

Jika Anda beralih model dengan /model, peralihan tersebut juga berlaku untuk subagent yang mewarisi model percakapan utama, karena Claude Code menentukan model mereka dari model yang digunakan sesi Anda saat Claude memulainya. Beralihlah ke Opus sebelum Claude mendelegasikan riset atau menjalankan tes ke salah satunya, dan pekerjaan itu juga berjalan di Opus. Untuk mempertahankan subagent kustom pada model yang lebih kecil, atur model dalam definisinya.

Jika Anda mengatur model dengan /model dalam mode non-interaktif, dengan flag -p, pilihan Anda hanya berlaku untuk sesi saat ini dan tidak disimpan sebagai default Anda; /model dalam mode tersebut 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 dikonfigurasi admin Anda untuk menimpa pilihan pengguna juga diterapkan kembali pada peluncuran berikutnya.

Di v2.1.144 hingga v2.1.152, /model hanya berlaku 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 yang berbeda di terminal yang berbeda secara bersamaan, luncurkan masing-masing dengan flag --model sendiri alih-alih beralih dengan /model.

Harga di pemilih /model muncul ketika Claude Code berkomunikasi dengan Anthropic API, secara langsung atau melalui LLM gateway yang mem-proxy-nya, dan harga pada sebuah baris adalah harga model yang dipilih oleh baris tersebut. Pada penyedia pihak ketiga seperti Amazon Bedrock dan pada Claude apps gateway, penyedia atau gateway Anda menentukan berapa yang Anda bayar, sehingga baris pemilih tidak menampilkan harga. Harga hanyalah label tampilan; harga tidak memengaruhi model mana yang dipilih sebuah baris atau apa yang ditagihkan penyedia Anda. Sebelum v2.1.206, sesi Claude Platform on AWS dan gateway menampilkan harga daftar Anthropic, dan sebuah baris dapat menampilkan harga model yang berbeda dari model yang dipilihnya.

Sesi yang dilanjutkan dengan claude --resume, --continue, atau pemilih /resume mempertahankan model yang digunakan saat transkrip disimpan. Jika model yang dipulihkan telah dihentikan atau dikecualikan oleh availableModels, sesi beralih ke urutan prioritas normal. Pada penyedia yang menggunakan ID deployment khusus penyedia alih-alih ID model Anthropic, seperti Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, model transkrip tidak dipulihkan sama sekali dan sesi menentukan modelnya melalui urutan prioritas normal.

Jika pengaturan model Anda adalah haiku, sesi yang disimpan pada model Haiku dilanjutkan pada model yang sekarang dituju oleh haiku. Misalnya, setelah haiku mengarah 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. Mulai v2.1.195, hal yang sama berlaku untuk variabel keluarga ANTHROPIC_DEFAULT_OPUS_MODEL. ANTHROPIC_DEFAULT_MODEL juga dapat diutamakan, dengan kondisi yang tercantum di bagiannya.

Ketika model aktif saat startup berasal dari pengaturan proyek atau terkelola alih-alih pilihan Anda sendiri, header startup menampilkan file pengaturan mana yang mengaturnya. Jalankan /model untuk menimpanya; pengaturan proyek atau terkelola diterapkan kembali pada peluncuran berikutnya. Pada platform yang menyematkan Claude Code dan mengatur CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host diutamakan daripada pengaturan model terkelola, sementara allowlist availableModels terkelola tetap berlaku kecuali host menyediakan allowlist sendiri; Pengecualian terhadap prioritas pengaturan terkelola menjelaskan key dan variabel mana yang ditimpa oleh host.

Jika Anda atau organisasi Anda mengonfigurasi hook PreModelSwitch, hook tersebut berjalan sebelum peralihan yang diminta diterapkan dan dapat memblokirnya atau meminta Anda untuk mengonfirmasi. Untuk mengetahui mengapa hook memblokir peralihan dan apa yang harus dilakukan, lihat Model switch was blocked by a PreModelSwitch hook.

Jika plugin terkelola atau hook-nya gagal dimuat, Anda tetap dapat beralih model. Hook PreModelSwitch milik plugin tersebut tidak berjalan, sehingga peralihan yang seharusnya diblokir oleh salah satunya dapat dilanjutkan. Hook PreModelSwitch lain yang berhasil dimuat tetap berjalan dan dapat memblokirnya. Jika Claude Code sebelum v2.1.323 menolak peralihan dengan so organization-managed PreModelSwitch hooks could not be checked, perbarui Claude Code.

Untuk melihat apa yang gagal, jalankan /plugin di sesi Anda dan buka tab Errors. Jika tidak ada yang tercantum di sana, mulai sesi baru dengan claude --debug dari shell Anda dan beralih ke model lain, lalu baca log debug. Setelah Anda memperbaiki plugin, atau pembaruan plugin membawa perbaikan dari admin Anda ke mesin Anda, jalankan /reload-plugins di sesi Anda agar hook-nya berjalan.

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

• Agent SDK atau aplikasi: dengan Claude Code v2.1.268 atau lebih baru, kecuali Claude Code menerima ID model secara lokal, seperti untuk opsi model kustom Anda, Claude Code mengonfirmasi ID tersebut dengan penyedia Anda saat pertama kali sesi beralih ke ID tersebut. Konfirmasi berjalan di setiap penyedia, dan ID yang tidak ditawarkan penyedia Anda ditolak saat peralihan alih-alih gagal pada permintaan Anda berikutnya.
• 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 mengatur model dengan flag --model, environment variable ANTHROPIC_MODEL, atau pengaturan model, Claude Code tidak menolak nilai yang salah ketik sejak awal. Sesi dimulai, dan permintaan pertama menghasilkan There's an issue with the selected model. Di Anthropic API, Anda dapat melihat peringatan yang menyarankan nama terdekat jika nilai tersebut hampir sama dengan nama model atau alias dan tidak diawali dengan claude-.

Ketika model yang diminta memiliki tanggal penghentian terjadwal atau secara otomatis dipetakan ulang ke versi yang lebih baru, Claude Code menampilkan peringatan yang menyebutkan nama model yang diminta. Sesi interaktif menampilkannya sebagai pemberitahuan startup. Mulai v2.1.182, peringatan yang sama ditulis ke stderr dalam mode non-interaktif saat menggunakan format output teks default. Pemeriksaan ini juga mencakup model yang diatur di frontmatter subagent. Peringatan stderr disembunyikan untuk --output-format json dan stream-json; baca model yang sebenarnya dari field modelUsage pada pesan hasil sebagai gantinya.

Misalnya, mulai sesi di Opus:

claude --model opus

Lalu beralih model dari dalam sesi:

/model sonnet

Contoh file pengaturan:

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

Memperbaiki nama model yang salah ketik

Salah satu dari peringatan berikut berarti Claude Code tidak mengenali ID model yang Anda atur, dan ID tersebut hampir sama dengan nama model atau alias yang dikenalinya:

⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?
Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

• Anda salah mengetik ID: ubah ke saran tersebut di mana pun Anda mengatur model
• ID tersebut disengaja: biarkan apa adanya. Sesi mengirimkannya persis seperti yang Anda tulis. Jika context window yang diasumsikan Claude Code untuknya salah, perbaiki window tersebut

Mengatur model default untuk sesi baru

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

Claude Code memulai sesi baru pada model variabel tersebut hanya ketika tidak ada satu pun dari berikut ini yang memilih model:

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

Pilihan yang Anda simpan dengan /model juga diutamakan daripada variabel tersebut pada peluncuran berikutnya. Jika ANTHROPIC_MODEL yang diatur, Claude Code kembali ke model variabel tersebut pada peluncuran berikutnya, apa pun yang Anda simpan dengan /model.

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

Claude Code mengabaikan variabel tersebut dalam kasus berikut, dan opsi Default diselesaikan seolah-olah Anda tidak mengaturnya:

• Anda mengaturnya ke default, inherit, opusplan, atau haiku
• enforceAvailableModels aktif
• Pembatasan model organisasi Anda mengecualikan model tersebut
• Model tersebut tidak tersedia untuk akun Anda

Ketika sesi baru akan dimulai pada model variabel tersebut, sesi yang Anda lanjutkan dengan claude --resume, --continue, atau pemilih /resume juga dimulai pada model tersebut. Claude Code tidak memulihkan model yang disimpan di transkrip sesi tersebut. Selain itu, Claude Code tidak menggunakan variabel tersebut saat Anda melanjutkan sesi.

Sesi baru dimulai pada model yang berbeda dari yang Anda pilih

Ketika Anda memilih model dengan /model dan sesi berikutnya dimulai pada model lain, berikut adalah penyebab umumnya:

• 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 tidak mengubah default yang Anda simpan.
• Sesuatu dengan prioritas lebih tinggi mengatur model. Nilai model di pengaturan proyek atau terkelola, ANTHROPIC_MODEL di shell Anda, atau default organisasi yang diatur admin Anda untuk menimpa pilihan pengguna diterapkan lagi pada setiap peluncuran. Pilihan /model Anda tetap tersimpan; hanya saja kalah prioritas. Ketika pengaturan proyek atau terkelola mengatur model, header startup menyebutkan nama filenya.
• Claude Code tidak dapat menyimpan pilihan Anda. /model menulis model ke ~/.claude/settings.json. Jika Anda tidak dapat menulis ke file tersebut, misalnya karena tool lain membuatnya atau menautkannya ke salinan read-only, model yang Anda pilih hanya berlaku selama sesi dan peluncuran berikutnya membaca nilai lama. Atur model di tool yang membuat file tersebut, atau buat file tersebut 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 alih-alih default Anda saat ini.

Membatasi pemilihan model

Admin dapat menggunakan availableModels dalam pengaturan terkelola atau kebijakan untuk membatasi model mana yang dapat dipilih pengguna. Setiap entri cocok dengan salah satu dari berikut ini:

• Keluarga model seperti sonnet
• Prefiks versi seperti claude-sonnet-4-5. Prefiks ini juga cocok dengan ID model yang lebih baru yang memperluasnya dengan segmen lain. Misalnya, claude-fable-5 mengizinkan Fable 5, Fable 5.1, dan Fable 5.2, sedangkan claude-fable-5-1 hanya mengizinkan Fable 5.1
• ID model lengkap seperti claude-sonnet-4-5-20250929

Untuk memblokir model yang diizinkan oleh daftar, atau untuk membuat setiap entri ID model hanya mengizinkan versi yang disebutkannya, lihat Memblokir model atau versi tertentu.

Pada platform yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model milik host diutamakan daripada pengaturan model terkelola, sementara allowlist availableModels terkelola tetap berlaku kecuali host menyediakan allowlist-nya sendiri; Pengecualian terhadap prioritas pengaturan terkelola menjelaskan kunci dan variabel mana yang ditimpa oleh host.

Ketika availableModels ditetapkan, allowlist berlaku di mana pun pengguna dapat menentukan model:

• Model sesi utama: /model, flag --model, environment variable ANTHROPIC_MODEL, pengaturan model, ANTHROPIC_DEFAULT_MODEL, dan model yang dipulihkan saat melanjutkan sesi
• Resolusi alias: environment variable ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, dan ANTHROPIC_DEFAULT_FABLE_MODEL tidak dapat mengalihkan alias yang diizinkan ke model di luar daftar
• Fast mode: /fast menolak untuk beralih ketika hal itu secara implisit akan berpindah ke model Opus di luar daftar, dengan pesan "is not in your organization's allowed models"
• Model subagent dan rekan tim: field model dalam frontmatter subagent, parameter model pada tool Agent, model rekan tim tim agent, CLAUDE_CODE_SUBAGENT_MODEL, dan, pada v2.1.197 dan sebelumnya, pemilih model di wizard /agents
• Model skill dan perintah: frontmatter model dalam skill dan perintah
• Model advisor: pengaturan advisorModel yang dikonfigurasi dan flag --advisor
• Model agent latar belakang: model yang dipilih di pemilih dispatch

Pada Anthropic API dan Claude Platform on AWS, alias keluarga model, opus, sonnet, haiku, atau fable, di-resolve ke model biasanya ketika allowlist mengizinkan model tersebut. Ketika allowlist memblokir model tersebut, Claude Code menggantinya dengan versi terbaru dari keluarga itu yang diizinkan allowlist dan menampilkan pemberitahuan yang menyebutkan model yang diminta maupun model pengganti. Dengan ["sonnet", "claude-opus-4-6"], misalnya, /model opus dan --model opus sama-sama memilih Claude Opus 4.6, yaitu Opus terbaru yang diizinkan. Sebelum v2.1.205, alias yang versi rilis terbarunya berada di luar daftar ditolak atau diganti seperti pilihan terblokir lainnya, bahkan ketika daftar mengizinkan versi yang lebih lama.

Penggantian ini memerlukan versi yang diizinkan sebagai tujuan: ketika allowlist tidak mengizinkan versi apa pun dari keluarga alias tersebut, alias mengikuti perilaku penolakan dan penggantian di bawah ini seperti nilai terblokir lainnya.

Claude Code menangani pilihan terblokir lainnya sesuai dengan tempat model ditetapkan:

• /model: Claude Code menolak peralihan dengan error

• Flag --model, ANTHROPIC_MODEL, atau pengaturan model: Claude Code mengganti nilainya saat startup dengan peringatan yang menyebutkan model yang diminta maupun model pengganti, dan sesi dimulai pada model default

• ANTHROPIC_DEFAULT_MODEL: Claude Code mengabaikan variabel tersebut

• Override subagent atau rekan tim: Claude Code menjalankan subagent atau rekan tim pada model fallback alih-alih menggagalkan permintaan. Lihat Memilih model untuk fallback subagent dan Menentukan rekan tim dan model untuk fallback rekan tim.

  Dalam sesi interaktif, Claude Code memperingatkan Anda ketika mengganti model subagent, baik melalui fallback ini maupun melalui penggantian versi terbaru yang diizinkan di atas, dengan menyebutkan model yang diminta dan model pengganti; Claude Code tidak melaporkan fallback rekan tim.

  Di mana penggantian versi terbaru yang diizinkan di atas berlaku, alias keluarga yang terblokir mengikuti penggantian tersebut sebagai gantinya. Sebelum v2.1.222, alias beralih ke fallback seperti nilai terblokir lainnya pada setiap penyedia

• Override skill atau perintah: Claude Code mengabaikan override tersebut, termasuk alias keluarga yang 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 tersebut

• Flag --advisor: Claude Code keluar dengan error saat peluncuran. Dalam sesi latar belakang, Claude Code memulai sesi tanpa advisor alih-alih keluar

• CLAUDE_CODE_AUTO_MODE_MODEL: Claude Code mengabaikan variabel tersebut dan memilih model untuk permintaan pengklasifikasi auto mode seolah-olah Anda tidak menetapkannya

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

• Anthropic API, Claude Platform on AWS, Claude apps gateway, atau LLM gateway yang ditetapkan melalui ANTHROPIC_BASE_URL: ID model Anthropic yang Anda cantumkan dan tidak memiliki baris pemilih bawaan muncul sebagai baris berlabelnya sendiri. Claude Code menambahkan baris seperti itu untuk versi Opus, Sonnet, dan Haiku, seperti versi lama yang disematkan oleh daftar. Jika Anda menetapkan replaceBuiltInOptions dalam susunan modelPicker, baris tersebut tidak muncul. Sebelum v2.1.199, ID seperti itu hanya dapat dipilih dengan mengetik /model <id>.
• Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry: kecuali ID model yang Anda cantumkan diawali dengan anthropic., Claude Code tidak menambahkan baris untuknya, baik itu ID model Anthropic maupun ID khusus penyedia. ID model Mantle memiliki prefiks tersebut. Untuk menampilkan versi tercantum yang tidak memiliki baris bawaan, tambahkan juga ke susunan 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 allowlist dihapus
• Peningkatan plan mode: pada Anthropic API dan Claude Platform on AWS, peningkatan seperti opusplan ke model yang dikecualikan menggunakan versi terbaru yang diizinkan dari keluarga peningkatan tersebut. Pada penyedia dengan ID model khusus penyedia, dan ketika tidak ada versi yang diizinkan, peningkatan dilewati dan perencanaan berlanjut pada model sesi
• Fallback model otomatis: fallback yang targetnya dikecualikan tidak dijalankan, sehingga permintaan yang ditandai berakhir dengan penolakan sebagai gantinya
• Pengklasifikasi auto mode: ketika allowlist mengecualikan model pengklasifikasi default, permintaan pengklasifikasi yang seharusnya menggunakan model tersebut berjalan pada model sesi, atau model Opus dalam sesi Fable. Pada penyedia selain Anthropic API, fallback Opus tersebut berjalan pada model yang Anda tetapkan di ANTHROPIC_DEFAULT_OPUS_MODEL atau jika tidak, pada Opus 5, tanpa memeriksa allowlist. Memerlukan Claude Code v2.1.210 atau lebih baru
• Fast mode: pengaktifan fast mode ditolak ketika model yang akan digunakan sesi setelahnya berada di luar allowlist
• Fallback ketersediaan pada Amazon Bedrock dan Google Cloud's Agent Platform: ketika akun Anda kehilangan akses ke suatu model di tengah sesi, peralihan ke model lain melewati model yang dikecualikan. Pemeriksaan model saat startup pada Amazon Bedrock dan Google Cloud's Agent Platform melewati model yang dikecualikan hanya ketika pengaturan terkelola juga menetapkan enforceAvailableModels

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

Cakupan surface

Setiap surface menegakkan allowlist yang diterimanya. Mekanisme pengiriman yang menjangkau setiap surface berbeda-beda:

• Sesi cloud, termasuk yang Anda mulai dari aplikasi Desktop, berjalan di VM yang dikelola Anthropic secara default: pengaturan yang di-deploy ke perangkat Anda tidak menjangkaunya, jadi kirimkan allowlist melalui pengaturan yang dikelola server. Sesi yang dirutekan organisasi Anda ke lingkungan yang di-host sendiri berjalan di komputasi Anda sendiri dan juga membaca file pengaturan terkelola di image runner. Cara Claude Code menggabungkan sumber terkelola menjelaskan kapan file tersebut berlaku. Peralihan model di tengah sesi dalam sesi cloud ditolak ketika model yang diminta dikecualikan oleh allowlist. Ketika daftar availableModels dalam pengaturan yang dikelola server Anda tidak kosong, server menolak permintaan untuk memulai sesi cloud di claude.ai/code atau dari aplikasi Desktop pada model yang dikecualikan oleh daftar tersebut.
• Sesi Claude Tag berjalan di lingkungan cloud tetapi tidak menerima pengaturan yang dikelola server; di lingkungan yang di-host sendiri, sesi tersebut tetap membaca file pengaturan terkelola di image runner. Untuk menetapkan model bagi sesi tersebut, lihat Choose the model for a scope dalam panduan admin Claude Tag.
• Cowork, tab kerja agentik di aplikasi Claude Desktop, menjalankan sesinya di Claude Code tetapi, secara desain, tidak menerima pengaturan yang dikelola server dari konsol admin claude.ai. Ketika daftar availableModels dalam pengaturan yang dikelola server Anda tidak kosong dan pengguna memilih model di luar daftar tersebut, server menolak model itu untuk sesi Cowork jarak jauh. File pengaturan terkelola berlaku untuk sesi Cowork ketika file tersebut ada di tempat sesi berjalan; sesi Cowork jarak jauh berjalan di VM yang dikelola Anthropic, tempat file yang di-deploy ke perangkat tidak ada.
• Sesi pada penyedia pihak ketiga seperti Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan Claude Platform on AWS tidak menerima pengaturan yang dikelola server, jadi kirimkan allowlist melalui MDM atau file pengaturan terkelola di sana.
• Pengiriman dari konsol admin juga mengharuskan sesi mengambil pengaturan dengan login yang memenuhi syarat ke organisasi Anda atau token OAuth yang diterbitkan untuknya. Untuk armada yang melakukan autentikasi dengan kunci API, baik yang dikonfigurasi secara langsung maupun yang dihasilkan oleh skrip apiKeyHelper, kirimkan allowlist melalui MDM atau file pengaturan terkelola.
• Tab Code di Desktop juga menampung sesi SSH, yang membaca file pengaturan terkelola dari host jarak jauh tempat sesi tersebut berjalan. Lihat Pengaturan terkelola Desktop.
• Pemilih model di claude.ai dan di aplikasi Desktop menyembunyikan atau menonaktifkan tampilan model yang dikecualikan oleh allowlist organisasi Anda. Status pemilih hanyalah kemudahan bagi pengguna; status tersebut tidak menegakkan allowlist.

Perilaku model default

Dengan pencocokan prefiks default, availableModels saja membiarkan opsi Default tetap pada default runtime sistem untuk akun tersebut sampai Anda juga menetapkan enforceAvailableModels. Jika default tersebut adalah model yang ingin Anda batasi, tetapkan juga enforceAvailableModels, atau blokir model tersebut.

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

Menegakkan allowlist untuk model Default

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

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

Untuk anggota yang tidak memiliki model yang tercatat di akunnya, opsi Default di-resolve ke default jenis akun, atau ke model default organisasi ketika admin telah menetapkannya. Ketika model tersebut tidak ada dalam allowlist, opsi Default sebagai gantinya di-resolve ke entri availableModels pertama yang menyebutkan model yang diizinkan dan tersedia, dan baris Default pada pemilih /model menampilkan model tersebut. Ini berlaku di mana pun default dicapai: startup sesi, memilih Default di /model, kata kunci "default" dalam rantai model fallback, dan fallback yang digunakan ketika pilihan yang dikecualikan dihapus. 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 di-resolve ke model yang diizinkan dan tersedia, penegakan dilewati dengan peringatan yang hanya terlihat di bawah --debug. Pertahankan setidaknya satu entri yang dijamin tersedia dalam daftar untuk menghindari hal ini.

Deploy kedua kunci bersama-sama dalam sumber terkelola dengan peringkat tertinggi yang Anda kirimkan. Secara default Claude Code hanya membaca sumber tersebut, sehingga pasangan yang ditempatkan dalam file pengaturan terkelola diabaikan ketika konsol admin mengirimkan pengaturan apa pun; di bawah penggabungan opt-in dalam cara Claude Code menggabungkan sumber terkelola, Claude Code tetap mengabaikan peta modelOverrides dari sumber dengan peringkat di bawah sumber yang menetapkan availableModels.

Mengontrol model yang digunakan pengguna

Pengaturan model adalah pilihan awal, bukan penegakan. Pengaturan ini menetapkan model mana yang aktif saat sesi dimulai, tetapi pengguna tetap dapat membuka /model dan memilih Default, yang di-resolve ke default runtime sistem terlepas dari nilai model, kecuali enforceAvailableModels atau kunci yang memblokir versi tertentu berlaku untuknya.

Untuk mengontrol pengalaman model sepenuhnya, gabungkan pengaturan berikut:

• availableModels: membatasi model bernama mana yang dapat dipilih pengguna
• enforceAvailableModels: memperluas allowlist availableModels ke opsi Default, sehingga Default tidak dapat di-resolve ke model di luar daftar
• deniedModels dan availableModelsMatch: memblokir versi tertentu yang sebenarnya akan diizinkan oleh entri availableModels
• model: menetapkan pilihan model awal saat sesi dimulai
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: mengontrol ke mana alias sonnet, opus, haiku, dan fable di-resolve, serta versi mana yang digunakan oleh default jenis akun

Contoh ini memulai pengguna pada Sonnet 4.5, membatasi pemilih ke Sonnet dan Haiku, dan memastikan Default di-resolve ke model dalam allowlist, bukan default tingkat:

{
  "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 di pemilih mendapatkan default runtime, bukan versi yang disematkan di model. Kedua pengaturan mencakup cakupan yang berbeda: enforceAvailableModels membuat Default mematuhi allowlist, sedangkan blok env menyematkan versi ke mana alias yang diizinkan seperti sonnet di-resolve. Gunakan enforceAvailableModels saja ketika membatasi keluarga model sudah cukup; tambahkan blok env ketika Anda juga perlu menyematkan versi tertentu.

Perilaku penggabungan

Ketika pengaturan terkelola yang diterapkan Claude Code mendefinisikan availableModels, hanya daftar tersebut yang berlaku, kecuali platform host yang menyediakan daftarnya sendiri: entri dalam pengaturan pengguna, proyek, atau lokal tidak dapat memperluasnya, dan Claude Code juga tidak pernah menggabungkan availableModels antar sumber terkelola; cara Claude Code menggabungkan sumber terkelola menjelaskan daftar dari sumber mana yang berlaku. Jika tidak, daftar dari pengaturan pengguna, proyek, dan lokal digabungkan dan dihapus duplikatnya seperti pengaturan array lainnya. Sebelum Claude Code v2.1.175, entri dari cakupan dengan prioritas lebih rendah digabungkan ke dalam daftar terkelola alih-alih digantikan olehnya.

Di dalam daftar efektif, entri yang menyebutkan model tertentu dalam suatu keluarga, baik prefiks versi maupun ID model lengkap, menonaktifkan entri wildcard keluarga tersebut. Misalnya, dengan ["sonnet", "claude-sonnet-4-5"], pengguna hanya dapat memilih ID model yang cocok dengan claude-sonnet-4-5, bukan setiap model Sonnet.

ID model Mantle

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

Memblokir model atau versi tertentu

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

• deniedModels: cantumkan model yang akan diblokir. Model yang tercantum diblokir bahkan ketika availableModels mengizinkannya, dan kunci ini juga berfungsi tanpa allowlist sama sekali. Rilis yang tidak diblokir oleh entri mana pun tetap diizinkan
• availableModelsMatch: tetapkan ke "exact" agar setiap ID model dalam availableModels hanya mengizinkan versi yang disebutkannya. Versi yang lebih baru dari ID model yang tercantum kemudian tetap diblokir sampai Anda menambahkannya ke daftar

Versi sebelumnya mengabaikan kedua kunci tersebut, jadi tetapkan juga requiredMinimumVersion untuk mencegah versi tersebut dimulai.

Contoh ini mengizinkan model Opus dan Sonnet serta memblokir Opus 5.5 dalam setiap penulisan, termasuk ID bertanggal dan ID khusus penyedia:

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

Model yang diblokir, baik karena disebutkan oleh deniedModels maupun dihilangkan dari daftar "exact", diperlakukan sebagai pilihan terblokir di mana pun allowlist berlaku. Model tersebut disembunyikan dari pemilih /model, dan /model <name> menolaknya. Jika Anda menyebutkan ID model yang diblokir dengan --model, ANTHROPIC_MODEL, atau pengaturan model, Claude Code menghapusnya saat startup dan me-resolve opsi Default sebagai gantinya. Jika hook atau permintaan latar belakang menyebutkan model yang diblokir oleh deniedModels, seperti field model pada hook agent, permintaan tersebut berjalan pada model sesi sebagai gantinya.

Opsi Default juga mengikuti kedua kunci, baik Anda menetapkan enforceAvailableModels maupun tidak. Jika Anda menetapkannya dengan availableModels yang tidak kosong, default yang diblokir dihitung sebagai model di luar allowlist. Jika tidak, opsi Default yang akan di-resolve ke model yang diblokir turun dengan urutan berikut:

1. Versi terbaru yang diizinkan dari keluarga yang sama
2. Model terbaru yang diizinkan dari setiap keluarga berbiaya lebih rendah secara bergiliran: Sonnet, lalu Haiku
3. Entri availableModels pertama yang menyebutkan model yang diizinkan

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

Claude Code membaca kedua kunci hanya dari pengaturan terkelola. Jika Anda menetapkan salah satunya 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 satu per satu di konsol admin claude.ai. Pembatasan ini dikirimkan bersama hak akses akun ketika Claude Code melakukan autentikasi, terpisah dari daftar availableModels apa pun dalam pengaturan, dan server menegakkan 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 dengan cakupan organisasi, seperti kunci layanan organisasi, tidak terikat pada pengguna, sehingga pembatasan tidak berlaku untuknya.

Claude Console tidak memiliki kontrol pembatasan model. Organisasi tanpa paket Claude Enterprise, termasuk yang anggotanya melakukan autentikasi melalui Anthropic API, membatasi model dengan availableModels dalam pengaturan terkelola sebagai gantinya, dengan menambahkan enforceAvailableModels untuk mencakup opsi Default. Cakupan surface menjelaskan bagaimana setiap surface menerima dan menegakkan pengaturan ini.

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

Alias keluarga model seperti opus di-resolve ke model biasanya ketika organisasi mengizinkannya. Ketika organisasi membatasi model tersebut, Claude Code menggantinya dengan versi terbaru dari keluarga itu yang diizinkan organisasi, dengan pemberitahuan penggantian yang sama. /model <alias> ditolak hanya ketika setiap versi dari keluarganya dibatasi; alias yang ditetapkan dengan --model, ANTHROPIC_MODEL, atau pengaturan model tetap diganti saat startup dalam kasus tersebut. Sebelum v2.1.205, alias keluarga diganti atau ditolak hanya berdasarkan versi rilis terbarunya, bahkan ketika versi yang lebih lama diizinkan.

Pembatasan berlaku untuk seluruh organisasi atau per peran:

• Menonaktifkan model di tingkat organisasi menghapusnya untuk setiap anggota.
• Akses tingkat peran memberikan model yang berbeda kepada peran kustom yang berbeda, dan anggota yang memegang beberapa peran dapat menggunakan model apa pun yang diberikan oleh salah satu perannya.
• Model Haiku selalu tersedia dan tidak dapat dinonaktifkan, sehingga setiap anggota tetap memiliki setidaknya satu model yang dapat digunakan.
• Perubahan akses berlaku untuk permintaan baru dalam waktu sekitar satu menit; pemilih /model mencerminkannya pada saat sesi berikutnya dimulai.

Kedua pembatasan berlaku bersamaan: model hanya dapat dipilih ketika diizinkan oleh availableModels dan tidak dibatasi oleh organisasi. Pembatasan organisasi hanya menjangkau sesi pada Anthropic API dan deployment LLM gateway; pada penyedia lain, 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. Jika model default ditetapkan, opsi Default akan di-resolve ke model tersebut. Memerlukan Claude Code v2.1.196 atau yang lebih baru.

Baris Default di pemilih /model menampilkan nama model default organisasi dengan label Org default. Label tersebut bertuliskan Org default baik admin menetapkan default untuk seluruh organisasi maupun untuk peran Anda. Default peran berlaku bagi anggota peran kustom tersebut dan diutamakan daripada default tingkat organisasi; jika beberapa peran Anda menetapkan default yang berbeda, model yang paling mumpuni yang berlaku.

Default organisasi merupakan titik awal, bukan pembatasan. Pilihan-pilihan berikut diutamakan daripada default organisasi:

• flag --model dan environment variable ANTHROPIC_MODEL
• nilai model di pengaturan terkelola atau yang diberikan melalui --settings
• nilai model di 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, default organisasi diutamakan daripada nilai model di pengaturan pengguna, proyek, dan lokal, sehingga model yang Anda simpan dengan /model berlaku untuk sesi saat ini dan default organisasi kembali berlaku pada peluncuran berikutnya. Jika pilihan Anda berbeda, /model menampilkan Your organization's default (<model>) applies on restart. Flag --model, ANTHROPIC_MODEL, pengaturan terkelola, dan --settings tetap diutamakan bahkan ketika override aktif.

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

Claude Code membaca default organisasi satu kali saat startup, sehingga default yang diubah admin di tengah sesi akan berlaku pada peluncuran berikutnya.

Jika default organisasi tidak menimpa pilihan pengguna, peluncuran interaktif pertama setelah admin mengubahnya akan menghapus kunci model dari pengaturan pengguna Anda satu kali, sehingga default baru berlaku. Peluncuran tersebut tidak mengubah apa pun lainnya di file tersebut, dan model yang Anda simpan dengan /model setelah peluncuran itu akan dipertahankan.

Default organisasi melewati pemeriksaan pembatasan berikut sebelum diterapkan:

• Dengan pencocokan prefiks default, availableModels saja tidak berlaku untuk default organisasi, sehingga default organisasi di luar allowlist tetap berlaku. Jika enforceAvailableModels juga ditetapkan, default organisasi di luar allowlist juga dipetakan ulang ke entri pertama allowlist
• default organisasi yang ditolak oleh pembatasan model organisasi untuk akun Anda digantikan oleh model terbaru yang diizinkan dalam keluarganya, atau keluarga dengan biaya lebih rendah jika setiap versinya dibatasi
• untuk default organisasi yang diblokir oleh deniedModels atau daftar "exact", lihat Memblokir model atau versi tertentu
• default organisasi yang sama sekali tidak tersedia untuk akun Anda akan dilewati, dan opsi Default di-resolve seperti halnya tanpa default organisasi

Mulai v2.1.199, jika default organisasi merupakan keluarga model yang berbeda dari default biasa untuk jenis akun Anda, pemilih /model mempertahankan baris terpisah untuk keluarga biasa tersebut, sehingga Anda tetap dapat beralih ke keluarga itu untuk suatu sesi. Pada v2.1.196 hingga v2.1.198, baris tersebut tidak ada di pemilih.

Default organisasi hanya menjangkau sesi yang diautentikasi dengan Anthropic API. Untuk menetapkan default di tempat lain, termasuk deployment LLM gateway, gunakan kunci model di 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 effort maksimum per model untuk setiap peran kustom, bersama dengan pembatasan model organisasi tingkat peran. Memerlukan Claude Code v2.1.195 atau lebih baru.

• Level di atas batas tidak ditawarkan dalam pemilih /effort, dan menyebutkan level yang lebih tinggi dengan --effort atau /effort akan berjalan pada batas sebagai gantinya. Jika Anda memulai proses --print teks biasa dengan --effort di atas batas, peringatan pada stderr menyebutkan level yang diminta dan yang diterapkan. Dalam sesi interaktif, dengan output json atau stream-json, atau dalam agent latar belakang, peringatan tersebut dikirim ke log debug sebagai gantinya.
• Batas berlaku per model, jadi beralih model dapat mengubah level mana yang tersedia.
• Ketika beberapa peran Anda memberikan model yang sama, batas yang paling tidak ketat yang berlaku.

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

Perilaku model khusus

Pengaturan model default

Perilaku default bergantung pada jenis akun Anda:

• Pro, Max, Ultra, 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 di-resolve ke Sonnet 5 pada Pro dan Team Standard, dan ke Opus 5 pada Max, Ultra, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform sejak v2.1.219. Sebelum v2.1.219, default di-resolve ke Opus 4.8 pada Anthropic API, Max, Ultra, Team Premium, dan Enterprise pay-as-you-go sejak v2.1.154, serta pada Claude Platform on AWS, Amazon Bedrock, dan Google Cloud's Agent Platform sejak v2.1.207. Sebelum v2.1.207, default di-resolve 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 di-resolve ke model tersebut alih-alih ke default jenis akun di atas. Memerlukan Claude Code v2.1.196 atau yang lebih baru. default juga dapat di-resolve ke model yang Anda tetapkan dengan ANTHROPIC_DEFAULT_MODEL, dengan kondisi yang tercantum di bagiannya, atau ke model yang tercatat di akun Anda.

Ketika tidak ada yang tercatat di akun Anda, pengaturan terkelola memberlakukan allowlist untuk model Default, dan default jenis akun tidak ada di availableModels, default di-resolve ke Default yang diberlakukan alih-alih ke default jenis akun di atas. Ketika default organisasi dan pemberlakuan sama-sama berlaku, default organisasi menggantikan default jenis akun terlebih dahulu, lalu pemberlakuan diterapkan padanya: default organisasi yang ada di allowlist dipertahankan, sedangkan yang berada di luar daftar di-resolve ke Default yang diberlakukan.

[!NOTE]

Model Fable bukan default jenis akun pada paket atau penyedia mana pun. Memilih salah satunya dengan /model akan menyimpannya sebagai model terpilih di pengaturan pengguna Anda, sehingga sesi berikutnya dimulai dengan model tersebut, kecuali untuk perubahan satu kali pada pilihan Fable 5.1 yang tersimpan.

Pengaturan model opusplan

Alias model opusplan menyediakan pendekatan hibrida otomatis:

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

Ini memadukan kemampuan penalaran Opus untuk perencanaan dengan efisiensi Sonnet untuk eksekusi.

Fase Opus dalam plan mode menggunakan context window yang sama dengan pengaturan model opus, dan fase eksekusi menggunakan window yang sama dengan sonnet. Ketika opus dan sonnet di-resolve ke model yang berjalan dengan context window 1M secara default, seperti model-model saat ini di Anthropic API, kedua fase berjalan dengan window tersebut. Untuk meminta konteks 1M bagi kedua fase jika tidak demikian, tetapkan model ke opusplan[1m], misalnya dengan /model opusplan[1m]. Menetapkannya dengan /model memerlukan Claude Code v2.1.265 atau yang 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 semua Opus dikecualikan. Sesi Haiku yang biasanya ditingkatkan ke Sonnet dalam plan mode juga menggunakan Sonnet terbaru yang diizinkan, dan tetap pada Haiku hanya ketika semua Sonnet dikecualikan. Sebelum v2.1.205, plan mode tetap pada model sesi setiap kali versi terbaru dari keluarga peningkatan dikecualikan, bahkan ketika allowlist mengizinkan versi yang lebih lama.

Penggantian dengan versi lama yang diizinkan berlaku di Anthropic API dan Claude Platform on AWS. Di 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 setiap kali model peningkatan dikecualikan.

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

Rantai model fallback

Ketika model utama kelebihan beban, tidak tersedia, atau mengembalikan error server lain yang tidak dapat di-retry, Claude Code dapat beralih ke model fallback alih-alih menggagalkan permintaan. Error autentikasi, penagihan, rate limit, ukuran permintaan, dan transport, serta penolakan oleh pemeriksaan kebijakan organisasi Anda, tidak pernah memicu peralihan; error tersebut mengikuti penanganan retry dan error normalnya. Peralihan tetap terjadi ketika Amazon Bedrock atau Google Cloud's Agent Platform menolak model yang tidak dapat dipanggil oleh akun Anda, yang diperlakukan Claude Code sebagai model yang tidak tersedia, bukan sebagai error autentikasi.

Konfigurasikan satu atau beberapa model fallback dan Claude Code akan mencobanya secara berurutan, sambil menampilkan pemberitahuan saat beralih. Peralihan hanya berlaku untuk giliran saat ini, sehingga pesan Anda berikutnya akan mencoba model utama terlebih dahulu lagi. Claude Code membatasi rantai hingga tiga model setelah duplikat dihapus dan mengabaikan entri tambahan.

Tetapkan 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, tetapkan fallbackModel di 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" diperluas menjadi model default.

Claude Code tidak mengonfirmasi rantai saat startup dan /status tidak menampilkannya. Pemberitahuan yang muncul saat peralihan terjadi adalah tanda pertama yang terlihat bahwa fallback telah dikonfigurasi.

Ketika permintaan dialihkan, Claude Code mencoba setiap entri secara berurutan hingga salah satunya menerimanya. Entri yang juga tidak dapat dijangkau, seperti model yang sudah dipensiunkan tetapi disematkan di pengaturan, dialihkan ke entri berikutnya dengan cara yang sama. Claude Code menghapus dua jenis entri sebelum penelusuran itu dimulai:

• Di luar allowlist: Claude Code membuang setiap entri yang tidak diizinkan oleh availableModels saat membaca rantai.
• Context window lebih kecil selama compaction: rantai juga mencakup compaction, tetapi Claude Code tidak akan melakukan fallback ke model dengan context window yang lebih kecil daripada milik model utama, karena meringkas di sana akan memotong sebagian percakapan terlebih dahulu. Jika semua fallback lebih kecil, compaction menampilkan error asli dan Anda dapat mencoba ulang.

Claude Code juga menerapkan rantai ini pada subagent. Ketika permintaan subagent dialihkan, Claude Code mencoba model fallback yang Anda konfigurasikan secara berurutan, dan subagent melanjutkan dengan model yang menerima permintaan tersebut. Model sesi Anda tidak berubah. Sebelum v2.1.247, kegagalan yang dicakup rantai justru mengakhiri subagent.

Fallback model otomatis

Bagian ini membahas fallback berbasis konten dari model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5. Untuk fallback berbasis ketersediaan saat 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 kedua kategori tersebut, model fallback bergantung pada model mana yang menolak:

• Model Fable dan Opus 5.5: permintaan yang ditandai biologi dijalankan ulang di Opus 5, dan permintaan yang ditandai keamanan siber dijalankan ulang di Opus 4.8.
• Sonnet 5.5: permintaan yang ditandai keamanan siber dijalankan ulang di 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 ulang di Opus 4.8. Permintaan yang ditandai biologi berakhir dengan penolakan, karena Opus 5 menjalankan pengklasifikasi biologinya sendiri tanpa model fallback.

Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, Claude Code me-resolve target-target ini melalui ID model deployment Anda. Lihat Aktifkan fallback di Bedrock, Agent Platform, dan Foundry.

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

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

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

Model fallback diperiksa terhadap availableModels. Ketika diblokir, fallback tidak terjadi. Penolakan ditampilkan sebagai error biasa 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 di Opus 5.5 dengan default medium yang beralih ke Opus 4.8 tetap pada medium, meskipun Opus 4.8 memiliki default high.

Tingkat yang berbeda berlaku dalam kasus-kasus seperti berikut:

• Perubahan Anda sendiri: begitu Anda memilih tingkat effort, memilih model di /model, atau melanjutkan sesi di lain waktu, tingkat dari permintaan yang ditandai tidak lagi terbawa.
• Effort yang ditetapkan untuk satu giliran: jika Anda menaikkan giliran yang ditandai dengan ultrathink, atau frontmatter effort dari sebuah skill menetapkan tingkatnya, tingkat tersebut berlaku untuk giliran itu. Giliran berikutnya berjalan pada tingkat yang diberikan urutan resolusi effort untuk model fallback.

Untuk melihat tingkat yang ditetapkan untuk sesi Anda setelah fallback, jalankan /effort status. Untuk mengubahnya, jalankan /effort.

Periksa apa yang memicu fallback

Fallback dapat terpicu pada permintaan pertama sebuah sesi, sebelum Anda mengirim sesuatu yang tidak biasa, karena permintaan pertama membawa konteks workspace seperti isi CLAUDE.md dan status git Anda. Repositori yang berisi materi keamanan atau biologi dapat memicu pengklasifikasi hanya dari konteks tersebut.

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

Tanyakan sebelum beralih

Untuk memutuskan apa yang terjadi setiap kali permintaan ditandai, jalankan /config, pilih Switch models when a message is flagged, lalu pilih Ask each time. Anda juga dapat menetapkan switchModelsOnFlag ke false di file pengaturan Anda. Claude Code kemudian berhenti sejenak pada permintaan yang ditandai yang akan beralih model dan memberi Anda dua opsi: beralih ke model fallback, atau mengedit prompt dan mencoba ulang.

Saat pertama kali permintaan yang ditandai akan beralih model dalam sesi interaktif, Claude Code mungkin menanyakan apakah akan beralih secara otomatis sejak saat itu. Claude Code hanya bertanya jika Anda belum menetapkan switchModelsOnFlag, dan menyimpan pilihan Anda sebagai key tersebut di 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 akan bertanya lagi saat berikutnya permintaan yang ditandai akan beralih model.

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

• Ketika kategori yang ditandai tidak memiliki model fallback, seperti tanda biologi di Opus 5 atau Sonnet 5.5, Claude Code tidak menampilkan pertanyaan dan permintaan berakhir dengan penolakan.
• Jika kedua model menandai permintaan yang sama, Anda dapat mengedit prompt dan mencoba ulang, atau memulai sesi baru.
• Dalam sesi cloud di aplikasi seluler, mengedit dan mencoba ulang tidak didukung. Beralihlah model, atau lanjutkan sesi dari browser desktop atau aplikasi desktop.
• Dalam mode non-interaktif dan integrasi SDK yang tidak dapat menampilkan pertanyaan, permintaan yang ditandai akan mengakhiri giliran dengan penolakan.
• Dalam subagent yang dimulai Claude dengan Agent tool, Claude Code tidak berhenti untuk bertanya, dan subagent gagal alih-alih beralih model. Lihat Subagent beralih atau gagal tanpa bertanya.
• Ketika target fallback diblokir oleh availableModels, Claude Code tidak menampilkan pertanyaan. Permintaan yang ditandai berakhir dengan penolakan, sama seperti fallback otomatis ketika target diblokir.

Subagent beralih atau gagal tanpa bertanya

Dalam subagent bawaan atau kustom yang dimulai Claude dengan Agent tool, Claude Code tidak berhenti untuk bertanya pada permintaan yang ditandai. Jika model fallback tersedia, permintaan dijalankan ulang di model tersebut atau subagent gagal, sesuai pilihan Switch models when a message is flagged Anda di /config:

• Switch automatically, atau belum ada pilihan: permintaan dijalankan ulang di model fallback, dan model sesi Anda tidak berubah
• Ask each time: subagent gagal dengan Agent terminated early due to an API error dan pesan penolakan. Claude menerima error tersebut dan memutuskan apa yang harus dilakukan terhadap tugas yang belum selesai. Untuk mengizinkan subagent beralih model, pilih Switch automatically. Percakapan utama Anda kemudian juga akan beralih tanpa bertanya.

Ketika tidak ada model fallback yang tersedia, subagent gagal dengan cara yang sama pada kedua pilihan. Sebelum v2.1.318, permintaan subagent yang ditandai dijalankan ulang di model fallback yang tersedia apa pun pilihan Anda.

Aktifkan fallback di Bedrock, Agent Platform, dan Foundry

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

• Claude Code harus mengenali model saat ini sebagai sumber fallback. Model Fable dikenali ketika ID model mengandung claude-fable-5, cocok dengan nilai ANTHROPIC_DEFAULT_FABLE_MODEL, atau dipetakan dengan modelOverrides. Opus 5.5, Sonnet 5.5, dan Opus 5 dikenali melalui ID model penyedianya atau pemetaan modelOverrides.
• Target Opus harus dapat di-resolve dalam deployment Anda, model mana pun yang menolak: tetapkan ANTHROPIC_DEFAULT_OPUS_MODEL, atau pertahankan entri Opus 4.8 di daftar model penyedia. Tanpa salah satunya, fallback tetap nonaktif untuk setiap model sumber, termasuk Sonnet 5.5, dan permintaan yang ditandai berakhir dengan penolakan.
• Model fallback untuk kategori yang ditandai harus dapat di-resolve dalam deployment Anda. Dari model Fable, Opus 5.5, atau Opus 5, jika Anda menetapkan ANTHROPIC_DEFAULT_OPUS_MODEL, permintaan yang ditandai dijalankan ulang di model tersebut untuk setiap kategori yang memiliki fallback; tanda biologi di Opus 5 tetap berakhir dengan penolakan. Jika Anda tidak menetapkannya, permintaan yang ditandai keamanan siber dijalankan ulang di entri Opus 4.8, dan permintaan yang ditandai biologi dari model Fable atau Opus 5.5 dijalankan ulang di entri Opus 5. Dari Sonnet 5.5, permintaan yang ditandai keamanan siber dijalankan ulang di model yang Anda tetapkan di ANTHROPIC_DEFAULT_SONNET_MODEL, atau di entri Sonnet 5 di 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 lalu mencoba ulang. Agar kedua model dapat diidentifikasi, tetapkan pin untuk model sumber Anda:

• Model Fable: tetapkan ANTHROPIC_DEFAULT_FABLE_MODEL ke ID model Fable Anda agar Claude Code mengenalinya sebagai sumber fallback.
• Setiap model sumber: tetapkan ANTHROPIC_DEFAULT_OPUS_MODEL ke ID model Opus untuk mengaktifkan fallback dan memberi kategori yang ditandai sebuah target. Pin yang menyebut model di luar keluarga Opus, atau model yang menolak, membuat penolakan tetap berlaku.
• Sonnet 5.5: selain pin Opus, tetapkan ANTHROPIC_DEFAULT_SONNET_MODEL atau pertahankan entri Sonnet 5 di daftar model penyedia untuk menyediakan model tempat permintaan dijalankan ulang. Pin Sonnet yang menyebut model di luar keluarga Sonnet, atau Sonnet 5.5 itu sendiri, membuat penolakan tetap berlaku.

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

Beban kerja riset keamanan dan biologi

Beban kerja di bidang keamanan ofensif atau biologi, termasuk pengujian penetrasi, latihan Capture the Flag (CTF), dan codebase yang terkait biologi, sering memicu fallback, sering kali pada permintaan pertama. Ini adalah perutean yang diharapkan untuk domain-domain tersebut, bukan penandaan akun. Jika organisasi Anda memerlukan kemampuan setingkat Fable untuk pekerjaan ini, tanyakan kepada tim akun Anthropic Anda tentang program akses tepercaya.

Untuk pekerjaan biologi yang substansial di model Fable atau Opus 5.5, permintaan pertama yang ditandai dan beralih model memindahkan sesi ke Opus 5. Permintaan berikutnya yang ditandai biologi berakhir dengan penolakan di sana, karena Opus 5 tidak memiliki fallback biologi. Di Opus 5 dan Sonnet 5.5, penolakan tersebut dimulai sejak permintaan pertama yang ditandai.

Sesuaikan tingkat effort

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

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

Jika Anda menetapkan tingkat yang tidak didukung oleh model aktif, Claude Code beralih ke tingkat tertinggi yang didukung yang sama dengan atau di bawah tingkat yang Anda tetapkan. Misalnya, xhigh berjalan sebagai high di Opus 4.6. Organisasi Anda atau pengaturan Anda sendiri juga dapat membatasi tingkat yang ditawarkan sebuah model; lihat Batas effort organisasi.

Claude Code me-resolve tingkat effort sesi dengan urutan berikut, mengambil yang pertama berlaku:

1. Environment variable CLAUDE_CODE_EFFORT_LEVEL
2. Tingkat yang Anda pilih dalam sesi, misalnya dengan /effort, pemilih /model, atau applyFlagSettings()
3. Meluncurkan dengan --effort
4. Pengaturan Anda: tingkat yang Anda simpan untuk model atau key effortLevel, dengan prioritas di antara keduanya dan di antara file pengaturan yang dijelaskan di modelSettings
5. Effort default model: Fable 5.2, Opus 5.5, Sonnet 5.5, dan Haiku 5.5 memiliki default medium, dan Opus 4.7 memiliki default xhigh. Model lain di tabel tingkat effort memiliki default high. Jika organisasi Anda menetapkan tingkat effort default untuk model default organisasi, tingkat tersebut menjadi default saat Anda menjalankan model itu.

Setelah fallback model otomatis, lihat Tingkat effort setelah fallback untuk tingkat yang berlaku. Untuk subagent dan rekan tim, lihat Tingkat effort subagent dan rekan tim.

Opus 5.5 dimulai pada medium kecuali salah satu sumber di atas menetapkan tingkat untuknya, dan effortLevel tingkat atas di file pengaturan pengguna Anda tidak dihitung untuk Opus 5.5. Key tersebut adalah bentuk lama yang ditulis /effort sebelum Claude Code menyimpan tingkat per model: key itu tetap berlaku di tempat ia berlaku sebelumnya, yaitu pada Opus 5, Fable 5.1, dan model-model sebelumnya, sedangkan Opus 5.5 dan model yang dirilis setelahnya dimulai pada default masing-masing hingga Anda memilih tingkat untuknya dengan /effort atau pemilih /model. effortLevel tingkat atas di 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 di mesin Anda, Anda memilih berapa lama tingkat itu berlaku melalui cara Anda mengonfirmasinya:

• Enter di slider /effort atau pemilih /model, atau tingkat yang diketik setelah /effort: simpan tingkat tersebut sebagai default Anda dan terapkan di sesi-sesi berikutnya
• s di slider /effort atau pemilih /model: terapkan tingkat tersebut hanya untuk sesi ini. Memerlukan Claude Code v2.1.257 atau yang lebih baru

Claude Code menyimpan tingkat per model, di bawah key modelSettings di pengaturan pengguna Anda, sehingga setiap model mempertahankan tingkat tersimpannya sendiri.

max adalah tingkat penalaran terdalam. Kecuali Anda menetapkannya melalui environment variable CLAUDE_CODE_EFFORT_LEVEL, Claude Code menerapkan max hanya pada sesi saat ini.

[!NOTE]

Tingkat yang Anda pilih dari kontrol effort di ponsel atau browser yang terhubung melalui Remote Control hanya berlaku untuk sesi tersebut.

Ketika Anda menetapkan tingkat dengan /effort dalam eksekusi -p, Claude Code menerapkannya hanya pada sesi tersebut dan tidak menyimpannya sebagai default Anda.

Slider /effort juga memiliki toggle Ultracode. Ultracode adalah pengaturan Claude Code, bukan tingkat effort model: saat aktif, Claude mengorkestrasi alur kerja dinamis untuk tugas-tugas substansial, pada tingkat effort apa pun yang digunakan sesi. Untuk mengetahui di mana pengaturan ini dapat ditetapkan secara persisten, lihat pengaturan ultracode.

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

Anda dapat mengaktifkan ultracode melalui salah satu cara berikut:

• /effort: jalankan /effort ultracode untuk mengaktifkannya pada sesi saat ini atau /effort ultracode off untuk menonaktifkannya. Di slider /effort, tekan Tab untuk mengubah toggle Ultracode, lalu Enter untuk menerapkannya
• Flag --effort: luncurkan dengan claude --effort ultracode, yang memulai sesi pada effort xhigh dengan ultracode aktif
• Pengaturan ultracode: tetapkan "ultracode": true di 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 mempertahankan ultracode tetap aktif pada tingkat effort selain xhigh memerlukan Claude Code v2.1.284 atau yang 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 yang 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 tersebut.

Ultracode tidak tersedia ketika:

• Workflows dinonaktifkan
• Model tidak mendukung effort xhigh

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

Pilih tingkat effort

Setiap tingkat menukar penggunaan token dengan kemampuan. Default cocok untuk sebagian besar tugas coding; sesuaikan jika Anda menginginkan keseimbangan yang berbeda.

Dalam pengujian di Opus 5.5 dan Fable 5.1, Claude pada tingkat yang lebih tinggi menguji lebih banyak edge case 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-tugas yang sama dijalankan pada setiap tingkat, baca Using Claude Code: Spending your effort di blog.

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

Opus 5.5 memiliki default medium, satu tingkat di bawah default Opus 5 yaitu high. Dalam pengujian Anthropic, Opus 5.5 pada medium menyamai atau melampaui Opus 5 pada high dalam evaluasi coding dan pekerjaan pengetahuan. Pada tingkat tertentu, Opus 5.5 cenderung berpikir lebih banyak per giliran dibandingkan Opus 5. Saat Anda beralih dari Opus 5 ke Opus 5.5, mulailah pada medium alih-alih membawa tingkat yang Anda gunakan di Opus 5. Untuk menguji tingkat terhadap pekerjaan Anda sendiri, lihat Calibrate effort di panduan prompting Opus 5.5.

Gunakan ultrathink untuk penalaran mendalam satu kali

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

Jika diketik di prompt terminal, kata tersebut juga dapat menaikkan giliran itu ke effort xhigh. Jika bisa, kata tersebut ditampilkan dalam warna pelangi. Memerlukan Claude Code v2.1.311 atau yang lebih baru. Jika kata tersebut tidak berwarna pelangi saat Anda memulai giliran baru, coba salah satu langkah berikut:

• Ketik ulang di luar apa pun seperti tanda kutip, kurung, path, atau perintah, dalam prompt yang tidak dimulai dengan /
• Hapus CLAUDE_CODE_EFFORT_LEVEL jika ditetapkan di bawah xhigh, naikkan maxEffortLevel Anda sendiri ke xhigh atau lebih tinggi, atau minta admin organisasi untuk menaikkan batas organisasi Anda
• Jalankan /model dalam sesi Anda untuk beralih ke model Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2, atau Fable 5.1. Jika kata tersebut tidak dapat menaikkan giliran, seperti di Amazon Bedrock, tetapkan tingkat effort sebagai gantinya

Tetapkan tingkat effort

Anda dapat mengubah effort melalui salah satu cara berikut:

• /effort: jalankan /effort tanpa argumen untuk membuka slider interaktif, /effort diikuti nama tingkat untuk menetapkannya secara langsung, atau /effort auto untuk menghapus tingkat tersimpan Anda untuk model aktif
• Di /model: gunakan tombol panah kiri/kanan untuk menyesuaikan slider effort saat memilih model. Tingkat baru dimulai paling lambat pada pesan Anda berikutnya. Sampai saat itu, Claude dapat terus bekerja pada tingkat lama, bahkan di model baru. Selama sumber yang mengungguli pilihan Anda berlaku, seperti CLAUDE_CODE_EFFORT_LEVEL, Claude bekerja pada tingkat sumber tersebut.
• Flag --effort: teruskan nama tingkat untuk menetapkannya bagi satu sesi saat meluncurkan Claude Code
• Environment variable: tetapkan CLAUDE_CODE_EFFORT_LEVEL ke nama tingkat. Agar Claude Code tidak mengirim tingkat effort, tetapkan ke auto atau unset sebagai gantinya
• Pengaturan: tetapkan tingkat per model di modelSettings, atau tetapkan effortLevel ke low, medium, high, atau xhigh sebagai default untuk model yang tidak memilikinya. max tidak diterima sebagai tingkat di kedua key, dan ultracode memiliki key ultracode sendiri
• Dari perangkat yang terhubung: dalam sesi Remote Control, pilih tingkat dari kontrol effort di ponsel atau browser Anda. Tingkat tersebut hanya berlaku untuk sesi saat ini. Memerlukan Claude Code v2.1.234 atau yang lebih baru
• Frontmatter skill dan subagent: tetapkan effort di file markdown skill atau subagent untuk menimpa tingkat effort saat skill atau subagent tersebut berjalan

effort sebuah skill berlaku hingga akhir giliran tempat skill tersebut berjalan, atau selama eksekusi subagent yang di-fork dengan context: fork. effort sebuah subagent berlaku selama subagent berjalan, kecuali pemanggilannya menimpanya. Selama salah satunya berlaku, skill atau subagent berjalan pada tingkatnya, apa pun tingkat yang Anda gunakan saat meluncurkan, simpan, atau pilih. Jika CLAUDE_CODE_EFFORT_LEVEL ditetapkan, tingkat tersebut yang berlaku.

maxEffortLevel atau batas effort organisasi tetap membatasi tingkat tempat skill atau subagent berjalan. Jika Anda menetapkan effortLevel di pengaturan terkelola, Claude Code menerapkannya pada langkah pengaturan dalam urutan resolusi effort, dan pengguna tetap dapat mengubah tingkat dengan /effort atau --effort. Untuk menjaga pengguna pada atau di bawah suatu tingkat, tetapkan maxEffortLevel.

Tingkat effort subagent dan rekan tim

Pada model percakapan utama, subagent atau rekan tim yang tidak memiliki effort sendiri berjalan pada tingkat yang Anda pilih dalam sesi atau tetapkan dengan --effort. Pada model lain, tingkat tersebut tidak berlaku. Untuk memilih tingkat subagent, tetapkan effort dalam definisinya.

Periksa tingkat effort yang Anda tetapkan

Slider effort muncul di /model ketika model yang didukung dipilih. Tingkat di header sesi, misalnya "with low effort", berasal dari pengaturan effort Anda, bahkan jika Claude masih bekerja pada tingkat lama. Saat startup dan saat Anda mengubahnya, footer juga menampilkan sebentar tingkat yang ditetapkan untuk sesi Anda.

Kapan tingkat effort baru dimulai

Dalam sesi terminal, setelah /effort mengonfirmasi tingkat baru, pesan berikutnya yang Anda kirim berjalan pada tingkat tersebut. Anda dapat mengirimnya setelah giliran yang sedang berlangsung berakhir atau saat Claude masih bekerja:

• Setelah giliran berakhir: Anda tidak perlu melakukan apa pun hingga saat itu, dan wajar jika giliran selesai pada tingkat lama
• Saat Claude masih bekerja: ketik pesan, seperti keep going, lalu tekan Enter untuk mengantrekannya tanpa menginterupsi giliran. Claude menerimanya saat panggilan tool saat ini selesai, atau paling lambat saat giliran berakhir, dan bekerja pada tingkat baru sejak saat itu.

Sebelum v2.1.242, Claude Code dapat mengantrekan /effort itu sendiri hingga giliran selesai, dan selalu melakukannya dalam sesi yang tidak mengambil feature flag, seperti pada penyedia pihak ketiga.

Tidak mengirim tingkat effort

Ketika Claude Code tidak mengirim tingkat effort ke model yang didukung, default API yang berlaku, bukan default Claude Code. Agar Claude Code tidak mengirim tingkat apa pun, mulai claude dari shell yang meng-export CLAUDE_CODE_EFFORT_LEVEL dengan nilai auto atau nilai unset, yang keduanya memiliki efek yang sama:

export CLAUDE_CODE_EFFORT_LEVEL=auto

Header dan footer sesi tidak menampilkan tingkat effort selama tidak ada yang dikirim. Untuk mengonfirmasi bahwa tidak ada yang dikirim, jalankan /effort status di prompt Claude Code:

• Effort level: auto: tidak ada tingkat effort yang dikirim.
• Effort level: auto (currently <level>): sebuah tingkat masih dikirim. Jika pengaturan maxEffortLevel di bawah max berlaku untuk model aktif, Claude Code mengirim default-nya sendiri untuk model tersebut, diturunkan ke batas itu. Hapus pengaturan tersebut atau tetapkan ke max.

[!NOTE]

Sebelum v2.1.304, /effort status mencetak Effort level: auto (currently high) bahkan ketika tidak ada tingkat yang dikirim.

Penalaran adaptif dan thinking budget tetap

Penalaran adaptif membuat thinking bersifat opsional pada setiap langkah, sehingga Claude dapat merespons lebih cepat terhadap prompt rutin dan menyisihkan pemikiran yang lebih mendalam untuk langkah-langkah yang memerlukannya. Jika Anda ingin Claude berpikir lebih sering atau lebih jarang daripada yang dihasilkan tingkat saat ini, Anda dapat menyatakannya langsung di prompt Anda atau di CLAUDE.md; model merespons arahan tersebut dalam batas pengaturan effort-nya.

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

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

Extended thinking

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

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

Di mana Anda tidak dapat menonaktifkan thinking

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

Untuk menghentikan atau mengurangi thinking, gunakan langkah untuk penyedia Anda:

• Anthropic API: Anda dapat menonaktifkan thinking di model seperti claude-opus-5, claude-sonnet-5, dan claude-haiku-4-5. Alias seperti sonnet memilih model yang thinking-nya tidak dapat dinonaktifkan, jadi tetapkan model berdasarkan ID-nya.
• Penyedia pihak ketiga: di penyedia seperti Amazon Bedrock dan Microsoft Foundry, model dengan penalaran adaptif mungkin tetap berpikir meskipun thinking dinonaktifkan. Turunkan tingkat effort untuk mengurangi thinking.

Konteks yang diperluas

Sesi panjang dengan codebase besar dapat menggunakan context window 1 juta token. Model Fable, Sonnet 5 dan yang lebih baru, Haiku 5.5, Opus 4.6 dan yang lebih baru, serta Sonnet 4.6 mendukungnya.

Model Fable, Sonnet 5 dan yang lebih baru, Haiku 5.5, serta Opus 4.7 dan yang lebih baru berjalan dengan window 1M secara default, tanpa memerlukan sufiks [1m]. Ini termasuk sesi di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, serta sesi Claude apps gateway. Untuk menjalankannya dengan window 200K, lihat Nonaktifkan konteks 1M.

Opus 4.6 dan Sonnet 4.6 hanya mencapai 1M melalui varian [1m]-nya, dan akses ke varian tersebut bergantung pada paket Anda. Pada paket Max, Ultra, Team, dan Enterprise, termasuk kursi Team Standard dan Team Premium, Opus 4.6 dengan konteks 1M sudah termasuk dalam langganan Anda. Sonnet 4.6 dengan konteks 1M memerlukan kredit penggunaan di setiap paket langganan, termasuk Max dan Ultra.

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

Di Anthropic API, context window 1M menggunakan harga model standar tanpa tambahan biaya untuk token di atas 200K, kecuali pada Haiku 5.5, yang lebih mahal untuk prompt yang lebih panjang dari 100K token. Untuk paket yang menyertakan konteks yang diperluas dalam langganan Anda, penggunaan tetap ditanggung oleh langganan Anda. Untuk paket yang mengakses konteks yang diperluas melalui kredit penggunaan, token ditagihkan 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 balik LLM gateway

Jika Anda menetapkan ANTHROPIC_BASE_URL ke LLM gateway atau proxy lain, Claude Code memberikan setiap model yang dikenalinya context window yang sama dengan yang dimiliki model tersebut di Anthropic API. Model Fable, Sonnet 5 dan yang lebih baru, Haiku 5.5, serta Opus 4.7 dan yang lebih baru mendapatkan window 1M tanpa varian [1m]. Model yang hanya mencapai 1M melalui varian [1m]-nya, seperti Opus 4.6, berjalan pada 200K tanpa varian tersebut.

Claude Code tidak dapat mendeteksi batas lebih rendah yang diberlakukan oleh gateway atau server di belakangnya. Jika gateway Anda menolak permintaan di atas 200K token, tetapkan CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 di environment yang memulai Claude Code, sehingga sesi di setiap model melakukan compaction pada batas tersebut.

Nonaktifkan konteks 1M

Untuk mempertahankan sesi pada window 200K, tetapkan 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 yang lebih baru, serta Opus 4.7 dan yang lebih baru, Claude Code juga memperlakukan model tersebut seolah 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 tersebut pada context window model.
• Dengan auto-compaction nonaktif, sesi berhenti pada batas 200K dengan error batas konteks alih-alih melakukan compaction.

Context window dan harga Haiku 5.5

Di Anthropic API, Haiku 5.5 berjalan dengan context window 1M di setiap paket, tanpa sufiks [1m] yang perlu 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 melakukan auto-compact pada sekitar 967K token secara default. Untuk melakukan compaction lebih awal, tetapkan window auto-compact yang lebih kecil untuk model tersebut.

Context window dan auto-compaction

Jendela auto-compact adalah seberapa penuh context window dapat terisi sebelum Claude Code melakukan compaction pada percakapan. Untuk informasi tentang apa yang dipertahankan dan dibuang oleh compaction per mekanisme, lihat Apa yang bertahan setelah compaction.

Mengatur jendela auto-compact

[!NOTE]

Jika Claude Code memberikan peringatan tentang nilai CLAUDE_CODE_AUTO_COMPACT_WINDOW, lihat nilai dan peringatan untuk variabel tersebut.

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

• Untuk model saat ini, dalam sesi ini dan sesi-sesi berikutnya: jalankan /autocompact dengan sebuah 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 tersebut menyimpan nilai Anda tetapi sesi tetap menggunakan jendela dari cakupan tersebut, dan perintah akan memberi tahu hal itu. Jalankan /autocompact auto untuk kembali ke jendela yang disesuaikan untuk model Anda. Sebelum v2.1.288, perintah tersebut 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 sebuah model dengan /autocompact diutamakan daripada key ini dalam file yang sama untuk model tersebut.
• Untuk satu kali peluncuran: berikan --autocompact saat memulai Claude Code. Flag tersebut menimpa pengaturan tersimpan Anda untuk peluncuran itu tanpa mengubahnya, dan claude --autocompact auto menjalankan sesi pada jendela yang disesuaikan meskipun 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 ke jumlah token seperti 200000. Kecuali Claude Code mengabaikan nilainya, variabel ini diutamakan daripada perintah, flag, dan pengaturan autoCompactWindow. /autocompact kemudian melaporkan override tersebut tanpa menyimpannya. used_percentage pada baris status diukur terhadap context window penuh model, sehingga selama variabel ini diatur, persentase tersebut tidak menunjukkan kapan compaction akan berjalan.
• Untuk satu subagent: lihat Mengatur jendela auto-compact untuk satu subagent.

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

• Jumlah token biasa, seperti 200000
• Akhiran k atau M, seperti 500k atau 1M
• Angka tanpa akhiran dari 100 hingga 1000, yang berarti ribuan, sehingga 200 menetapkan 200.000

Bagaimanapun cara Anda mengatur jendela, Claude Code membatasinya pada context window model.

Nilai dan peringatan untuk CLAUDE_CODE_AUTO_COMPACT_WINDOW

Peringatan yang mengutip nilai CLAUDE_CODE_AUTO_COMPACT_WINDOW Anda berarti nilai tersebut berada di luar rentang 100.000 hingga 1.000.000 atau bukan jumlah token. Untuk menghentikan peringatan, atur angka dalam rentang tersebut, seperti CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000. Pada Claude Code v2.1.304 atau yang lebih baru, Anda juga dapat menulis angka dengan k untuk ribuan atau M untuk jutaan, seperti 200k atau 1M.

Temukan kata-kata peringatan Anda di kolom pertama, lalu baca ke samping untuk melihat jendela yang digunakan sesi Anda dan apa yang perlu diubah:

Angka tanpa akhiran dibaca sebagai jumlah token sebanyak itu, sehingga CLAUDE_CODE_AUTO_COMPACT_WINDOW=200 berarti 200 token meskipun /autocompact 200 berarti 200.000.

Ambang auto-compact default

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

• Sesi cloud melakukan compaction saat percakapan mendekati batas model
• Sonnet 4.6 dan Opus 4.6 tanpa konteks diperluas melakukan compaction pada batas 200K
• Saat Anda mengatur CLAUDE_CODE_DISABLE_1M_CONTEXT=1, model dengan jendela 1M bawaan, seperti Sonnet 5 dan model Fable, melakukan compaction pada batas 200K
• Model yang berjalan dengan jendela 1M bawaan melakukan compaction sebelum jendela penuh, sekitar 967K token secara default. Ini mencakup 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 context window di balik gateway
• Sesi pada ID model yang tidak dikenali Claude Code, seperti alias LLM gateway, melakukan compaction pada context window yang diasumsikan Claude Code untuk ID tersebut; lihat Mengoreksi jendela untuk gateway atau ID model kustom

Lihat pengaturan idleCompaction untuk mengetahui kapan Claude Code juga melakukan compaction pada percakapan yang Anda biarkan tidak aktif.

Mengoreksi jendela untuk gateway atau ID model kustom

Salah satu dari peringatan berikut berarti Claude Code tidak mengenali ID model sesi Anda, sehingga Claude Code tidak dapat mengetahui context window model tersebut dan mengasumsikan 200K token:

⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...
Claude Code doesn't recognize the model "my-gateway-opus", so it assumes a context window of 200k tokens. Update Claude Code, or see https://code.claude.com/docs/en/model-config#correct-the-window-for-a-gateway-or-custom-model-id to set the window.

Claude Code melakukan auto-compact pada percakapan di 200K yang diasumsikan, jadi jika context window sebenarnya milik model adalah 200K, tidak ada yang perlu dikoreksi. Jika tidak, berikan jendela sebenarnya kepada Claude Code dengan salah satu cara berikut yang sesuai dengan ID Anda:

• Model yang lebih baru daripada versi Claude Code Anda: jalankan claude update di shell Anda. Jika Claude Code mengenali ID tersebut setelah pembaruan, Anda tidak perlu mengonfigurasi apa pun lagi.
• Nama dari gateway atau penyedia Anda untuk model yang dikenal Claude Code: tambahkan entri modelOverrides yang memetakan ID model Anthropic ke ID Anda, seperti "claude-opus-4-8": "my-gateway-opus". Sebagai gantinya, Anda dapat mencantumkan ID Anda dalam baris modelPicker dengan behavesAs diatur ke model tersebut. Dengan cara mana pun, Claude Code kemudian memperlakukan ID tersebut sebagai model itu.
• Model dengan jendela 1M: tambahkan [1m] di akhir ID di tempat Anda mengatur model, seperti claude --model 'my-gateway-opus[1m]' di shell Anda. Jika Anda menonaktifkan konteks 1M, Anda mendapatkan jendela yang sama dengan atau tanpa akhiran tersebut.
• Jendela lainnya: atur CLAUDE_CODE_MAX_CONTEXT_TOKENS ke ukuran jendela dalam token di lingkungan yang memulai Claude Code, seperti CLAUDE_CODE_MAX_CONTEXT_TOKENS=400000. Untuk ID yang tidak dikenali yang tidak diawali dengan claude- dan tidak memiliki akhiran [1m], variabel ini berlaku dengan sendirinya. Untuk ID lainnya, periksa terlebih dahulu ID mana yang dikenai variabel ini.

Setelah Claude Code mengenali ID tersebut atau menggunakan jendela yang Anda berikan, peringatan tersebut tidak lagi muncul saat Anda memulai sesi pada ID tersebut.

ID mana yang dikenai CLAUDE_CODE_MAX_CONTEXT_TOKENS

Pada LLM gateway atau deployment kustom lainnya, Claude Code dapat mengasumsikan context window untuk ID model yang berbeda dari jendela sebenarnya milik model tersebut, terlepas dari apakah Claude Code me-resolve ID tersebut ke model Claude atau tidak. Atur CLAUDE_CODE_MAX_CONTEXT_TOKENS ke jendela yang seharusnya diasumsikan Claude Code.

Cara variabel ini diterapkan bergantung pada ID-nya. Claude Code memperlakukan sebuah ID sebagai ejaan penyedia atau kustom jika ID tersebut tidak diawali dengan claude-, dalam huruf besar maupun kecil apa pun, atau jika ID tersebut membawa akhiran yang dihapus Claude Code saat membaca ID, seperti tanggal @YYYYMMDD yang digunakan di Agent Platform milik Google Cloud. Sebelum v2.1.259, Claude Code tidak memperhitungkan akhiran yang dihapus, sehingga ID claude- yang tidak dikenali dengan akhiran tanggal diperlakukan sebagai nama claude- polos.

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

• Jika Claude Code tidak dapat me-resolve ejaan penyedia atau kustom ke model yang dikenalinya dan ID tersebut tidak mengandung [1m], variabel ini berlaku secara langsung dan compaction proaktif berlanjut pada jendela yang dideklarasikan.

• Jika Claude Code tidak dapat me-resolve ejaan penyedia atau kustom ke model yang dikenalinya dan ID tersebut mengandung [1m], dalam huruf besar maupun kecil apa pun, Claude Code mengasumsikan jendela 1M untuknya dan variabel ini tidak berlaku dengan sendirinya. Untuk mengoreksi jendela sambil mempertahankan compaction proaktif, atur juga CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Dengan variabel tersebut diatur, Claude Code menentukan ukuran ID seperti ejaan yang sama tanpa [1m], sehingga CLAUDE_CODE_MAX_CONTEXT_TOKENS berlaku ketika variabel tersebut akan berlaku untuk ejaan tanpa tag itu.

  Dengan jendela yang dideklarasikan di atas 200K, peringatan bahwa batas 200K tidak diberlakukan memang diharapkan dalam konfigurasi ini.

• Jika ID di-resolve ke model yang dikenali Claude Code, atau ID tersebut adalah nama claude- polos tanpa akhiran yang perlu dihapus Claude Code, dalam huruf besar maupun kecil apa pun, variabel ini hanya berlaku jika Anda juga mengatur DISABLE_COMPACT, yang menonaktifkan semua compaction.

  Misalnya, ID yang mengandung nama model Claude yang dikenal Claude Code, seperti anthropic/claude-opus-4-8, us.anthropic.claude-…-v1:0, atau claude-sonnet-4-5@20250929 yang bertanggal, di-resolve ke model tersebut. Ini termasuk ID yang juga mengandung [1m]: Claude Code me-resolve claude-opus-4-8[1m] ke Opus 4.8 bahkan dengan CLAUDE_CODE_DISABLE_1M_CONTEXT diatur.

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

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 oleh alias. Setiap nilai harus berupa nama model lengkap, atau pengenal yang setara untuk penyedia API Anda. Untuk memilih model yang digunakan saat sesi Anda dimulai, atur ANTHROPIC_DEFAULT_MODEL, yang tidak dicantumkan dalam tabel ini.

Pada penyedia pihak ketiga, Menyesuaikan tampilan dan kapabilitas model yang di-pin menjelaskan apa yang ditampilkan oleh baris model yang di-pin di pemilih /model.

Catatan: ANTHROPIC_SMALL_FAST_MODEL sudah deprecated dan digantikan oleh ANTHROPIC_DEFAULT_HAIKU_MODEL.

Pin 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, pin versi model sebelum meluncurkannya kepada pengguna.

Tanpa pinning, Claude Code menggunakan alias model seperti fable, opus, sonnet, dan haiku yang di-resolve 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. Saat default tidak tersedia, pengguna Amazon Bedrock dan Google Cloud's Agent Platform melihat pemberitahuan dan sesi melakukan fallback ke versi lebih lama dari model default, atau ke model Sonnet default saat default-nya adalah model Opus dan tidak ada versi Opus yang tersedia. Pengguna Microsoft Foundry justru melihat error, karena Microsoft Foundry tidak memiliki pemeriksaan startup yang setara.

Di Amazon Bedrock dan Google Cloud's Agent Platform, pengguna yang memulai sesi dengan versi Sonnet atau Opus tertentu, misalnya dengan --model, ANTHROPIC_MODEL, atau pengaturan model, mem-pin versi tersebut sebagai default sesi untuk alias yang sesuai: pemeriksaan startup melewati default bawaan yang digantikannya dan tidak menampilkan pemberitahuan fallback. Sebelum v2.1.211, pemeriksaan tetap dijalankan dan dapat menampilkan pemberitahuan meskipun model sesi telah dikonfigurasi secara eksplisit.

[!WARNING]

Atur environment variable model ke ID versi tertentu sebagai bagian dari penyiapan awal Anda. Pinning memungkinkan Anda mengontrol kapan pengguna Anda beralih ke model baru.

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

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

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

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

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

Dengan sufiks [1m], context window 1M berlaku untuk semua penggunaan alias yang di-pin, termasuk fase Opus plan mode dari opusplan dan subagent yang frontmatter model-nya menyebut alias tersebut.

• Claude Code menghapus sufiks sebelum mengirim ID model ke penyedia Anda.
• Tambahkan [1m] hanya jika model yang mendasarinya mendukung konteks 1M.
• Sufiks 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] di satu variabel menggunakan konteks 200K meskipun variabel lain mengatur model yang sama dengan sufiks tersebut.

Saat Anda mengatur variabel ANTHROPIC_DEFAULT_*_MODEL, pemilih /model menampilkan satu baris untuk model tersebut sebagai pengganti baris bawaan keluarga model itu, termasuk baris konteks 1M apa pun. Untuk mencapai window 1M tanpa menambahkan sufiks ke variabel tersebut, pengguna Anda menjalankan /model opus[1m], dan Claude Code menerapkan sufiks ke model yang disebutkan oleh variabel tersebut. /model sonnet[1m] bekerja dengan cara yang sama.

[!NOTE]

Allowlist availableModels yang dikirimkan melalui MDM atau file pengaturan terkelola tetap berlaku saat menggunakan penyedia pihak ketiga; pengaturan yang dikelola server tidak dikirimkan ke sana.

Pemfilteran mencocokkan alias model seperti opus, prefiks versi seperti claude-opus-4-8, atau ID model lengkap dalam bentuk penyedia. Prefiks khusus penyedia seperti us.anthropic. tidak dihapus, jadi untuk mengizinkan model tertentu, petakan melalui modelOverrides atau cantumkan ID lengkapnya dalam bentuk penyedia:

• Google Cloud's Agent Platform: saat ID yang diminta Claude Code membawa tanggal @, seperti claude-sonnet-4-5@20250929, sertakan tanggal tersebut dalam entri allowlist Anda. Dengan sendirinya, claude-sonnet-4-5 tidak cocok dengan ID tersebut di bawah kedua pengaturan availableModelsMatch.
• Model yang di-pin: cantumkan nilai yang Anda atur di variabel ANTHROPIC_DEFAULT_*_MODEL milik model tersebut

Sufiks [1m] apa pun dihapus dari entri allowlist maupun model yang diminta sebelum pencocokan.

Menyesuaikan tampilan dan kapabilitas model yang di-pin

Saat Anda mem-pin model pada penyedia pihak ketiga, barisnya di pemilih /model secara default menampilkan nama model jika Claude Code mengenali ID yang di-pin, dan ID mentahnya jika tidak:

• Dikenali: ID persis dari model yang diketahui Claude Code, seperti ID API Anthropic-nya atau bentuknya di penyedia atau gateway Anda, dengan atau tanpa sufiks [1m]. Pin us.anthropic.claude-sonnet-4-5-20250929-v1:0 dan barisnya akan bertuliskan Sonnet 4.5.
• Tidak dikenali: ID lain apa pun, seperti ARN application inference profile atau versi model yang tidak diketahui Claude Code, kecuali entri modelOverrides memetakan sebuah model ke ID tersebut. Di Microsoft Foundry, nama deployment ditentukan oleh pengguna, sehingga Claude Code tidak pernah mengenali ID yang di-pin di sana, baik dipetakan maupun tidak, dan barisnya secara default menampilkan nama deployment.

Saat sebuah baris menampilkan nama model, deskripsi default-nya menyertakan ID yang di-pin sehingga Anda tetap dapat melihat ID mana yang di-pin.

Claude Code mungkin juga tidak mengenali fitur mana yang didukung oleh model yang di-pin. Anda dapat mengatur nama tampilan dan deskripsi sendiri serta mendeklarasikan kapabilitas dengan environment variable pendamping untuk setiap model yang di-pin.

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

Sufiks _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 diketahui. ID khusus penyedia seperti ARN Amazon Bedrock atau nama deployment kustom sering kali tidak cocok dengan pola ini, sehingga fitur yang didukung tetap nonaktif. Atur _SUPPORTED_CAPABILITIES untuk memberi tahu Claude Code fitur mana yang benar-benar didukung oleh model tersebut:

Saat _SUPPORTED_CAPABILITIES diatur, Claude Code mengaktifkan kapabilitas yang tercantum dan menonaktifkan yang tidak tercantum untuk model yang di-pin yang sesuai. Saat variabel tidak diatur, Claude Code melakukan fallback ke deteksi bawaan berdasarkan ID model.

Contoh ini mem-pin Opus ke ARN custom model Amazon Bedrock, mengatur nama yang mudah dikenali, dan mendeklarasikan kapabilitasnya:

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'

Menimpa ID model per versi

Pada platform yang menyematkan Claude Code dan mengatur CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, konfigurasi model host diutamakan daripada pengaturan model terkelola, sementara allowlist availableModels terkelola tetap berlaku kecuali host menyediakan allowlist-nya sendiri; Pengecualian terhadap prioritas pengaturan terkelola menjelaskan kunci dan variabel mana yang ditimpa oleh 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 khusus penyedia yang dikirim Claude Code ke API penyedia Anda. Saat pengguna memilih model yang dipetakan di pemilih /model, Claude Code menggunakan nilai yang Anda konfigurasikan, bukan default bawaan.

Hal ini memungkinkan administrator perusahaan merutekan setiap versi model ke ARN inference profile 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 di 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 sebagaimana tercantum di Ikhtisar model. Untuk ID model bertanggal, sertakan sufiks tanggal persis seperti yang tercantum di sana. Kunci yang tidak dikenal diabaikan.

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

Override menggantikan ID model bawaan yang mendasari setiap entri di pemilih /model. Di Amazon Bedrock, entri modelOverrides diutamakan daripada inference profile apa pun yang ditemukan Claude Code secara otomatis saat startup. Claude Code meneruskan nilai yang sudah native untuk penyedia, seperti ARN inference profile Amazon Bedrock atau nama deployment Microsoft Foundry, ke penyedia apa adanya.

Override juga berlaku saat 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 di-resolve ke ID khusus penyedia yang sama dengan baris pemilih /model untuk versi tersebut, jika penyedia mendukung versi tersebut. Mantle mendukung sebagian versi. Untuk ID model Anthropic di luar sebagian versi tersebut, Claude Code mengirim ID mentah ke Mantle tanpa memetakannya, kecuali entri modelOverrides mencakupnya. Sebelum v2.1.200, nilai --model dan environment variable mencapai penyedia apa adanya tanpa melalui peta override.

modelOverrides bekerja bersama availableModels. Allowlist dievaluasi terhadap ID model Anthropic, bukan nilai override, sehingga entri seperti "opus" di availableModels tetap cocok meskipun versi Opus dipetakan ke ARN. Saat enforceAvailableModels diatur di pengaturan terkelola, Default yang diberlakukan di-resolve melalui modelOverrides hanya dari pengaturan terkelola. Pemetaan admin, seperti versi yang di-pin ke ARN inference profile, dihormati dalam Default yang diberlakukan. Override dari pengaturan pengguna atau proyek tidak memengaruhinya.

Saat availableModels diatur di 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 di pengaturan pengguna atau proyek untuk ID tersebut, dan tidak pernah me-resolve ID yang dikecualikan oleh daftar terkelola melalui modelOverrides dari sumber pengaturan mana pun. Pembatasan sumber terkelola ini memerlukan Claude Code v2.1.200 atau yang lebih baru. Lihat Membatasi pemilihan model untuk mengetahui cara ID yang diblokir ditangani.

Konfigurasi prompt caching

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

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

Riwayat versi

Tabel ini mencantumkan versi Claude Code di mana setiap alias model mengubah model yang menjadi tujuan resolve-nya, diurutkan dari yang terbaru.