Langsung ke konten utama

​
Model yang tersedia

Untuk pengaturan model di Claude Code, Anda dapat mengonfigurasi salah satu dari:
  • Sebuah alias model
  • Sebuah nama model
    • Anthropic API: Sebuah nama model lengkap
    • Bedrock: ARN profil inferensi
    • Foundry: nama deployment
    • Vertex: nama versi

​
Alias model

Alias model menyediakan cara yang nyaman untuk memilih pengaturan model tanpa perlu mengingat nomor versi yang tepat:
Alias modelPerilaku
defaultPengaturan model yang direkomendasikan, tergantung pada jenis akun Anda
sonnetMenggunakan model Sonnet terbaru (saat ini Sonnet 4.6) untuk tugas coding sehari-hari
opusMenggunakan model Opus terbaru (saat ini Opus 4.6) untuk tugas penalaran kompleks
haikuMenggunakan model Haiku yang cepat dan efisien untuk tugas sederhana
sonnet[1m]Menggunakan Sonnet dengan jendela konteks 1 juta token untuk sesi panjang
opus[1m]Menggunakan Opus dengan jendela konteks 1 juta token untuk sesi panjang
opusplanMode khusus yang menggunakan opus selama plan mode, kemudian beralih ke sonnet untuk eksekusi
Alias selalu menunjuk ke versi terbaru. Untuk menetapkan versi tertentu, gunakan nama model lengkap (misalnya, claude-opus-4-6) atau atur variabel lingkungan yang sesuai seperti ANTHROPIC_DEFAULT_OPUS_MODEL.

​
Mengatur model Anda

Anda dapat mengonfigurasi model Anda dengan beberapa cara, yang tercantum dalam urutan prioritas:
  1. Selama sesi - Gunakan /model <alias|name> untuk beralih model di tengah sesi
  2. Saat startup - Luncurkan dengan claude --model <alias|name>
  3. Variabel lingkungan - Atur ANTHROPIC_MODEL=<alias|name>
  4. Pengaturan - Konfigurasi secara permanen di file pengaturan Anda menggunakan bidang model.
Contoh penggunaan: 
# Mulai dengan Opus
claude --model opus

# Beralih ke Sonnet selama sesi
/model sonnet
Contoh file pengaturan: 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
Batasi pemilihan model

Administrator enterprise dapat menggunakan availableModels dalam pengaturan terkelola atau kebijakan untuk membatasi model mana yang dapat dipilih pengguna. Ketika availableModels diatur, pengguna tidak dapat beralih ke model yang tidak ada dalam daftar melalui /model, flag --model, alat Config, atau variabel lingkungan ANTHROPIC_MODEL. 
{
  "availableModels": ["sonnet", "haiku"]
}

​
Perilaku model default

Opsi Default di pemilih model tidak dipengaruhi oleh availableModels. Opsi ini selalu tetap tersedia dan mewakili default runtime sistem berdasarkan tingkat langganan pengguna. Bahkan dengan availableModels: [], pengguna masih dapat menggunakan Claude Code dengan model Default untuk tingkat mereka.

​
Kontrol model yang dijalankan pengguna

Untuk sepenuhnya mengontrol pengalaman model, gunakan availableModels bersama dengan pengaturan model:
  • availableModels: membatasi apa yang dapat dialihkan pengguna
  • model: menetapkan penggantian model eksplisit, mengambil alih Default
Contoh ini memastikan semua pengguna menjalankan Sonnet 4.6 dan hanya dapat memilih antara Sonnet dan Haiku: 
{
  "model": "sonnet",
  "availableModels": ["sonnet", "haiku"]
}

​
Perilaku penggabungan

Ketika availableModels diatur di beberapa tingkat, seperti pengaturan pengguna dan pengaturan proyek, array digabungkan dan dideduplikasi. Untuk memberlakukan allowlist ketat, atur availableModels dalam pengaturan terkelola atau kebijakan yang memiliki prioritas tertinggi.

​
Perilaku model khusus

​
Pengaturan model default

Perilaku default tergantung pada jenis akun Anda:
  • Max dan Team Premium: default ke Opus 4.6
  • Pro dan Team Standard: default ke Sonnet 4.6
  • Enterprise: Opus 4.6 tersedia tetapi bukan default
Claude Code dapat secara otomatis kembali ke Sonnet jika Anda mencapai ambang penggunaan dengan Opus.

​
Pengaturan model opusplan

Alias model opusplan menyediakan pendekatan hibrida otomatis:
  • Dalam plan mode - Menggunakan opus untuk penalaran kompleks dan keputusan arsitektur
  • Dalam execution mode - Secara otomatis beralih ke sonnet untuk pembuatan kode dan implementasi
Ini memberi Anda yang terbaik dari kedua dunia: penalaran superior Opus untuk perencanaan, dan efisiensi Sonnet untuk eksekusi.

​
Sesuaikan tingkat usaha

Tingkat usaha mengontrol penalaran adaptif, yang secara dinamis mengalokasikan pemikiran berdasarkan kompleksitas tugas. Usaha lebih rendah lebih cepat dan lebih murah untuk tugas-tugas langsung, sementara usaha lebih tinggi memberikan penalaran lebih dalam untuk masalah kompleks. Tiga tingkat bertahan di seluruh sesi: low, medium, dan high. Tingkat keempat, max, memberikan penalaran paling dalam tanpa batasan pengeluaran token, sehingga respons lebih lambat dan biaya lebih tinggi daripada di high. max hanya tersedia di Opus 4.6 dan tidak bertahan di seluruh sesi kecuali melalui variabel lingkungan CLAUDE_CODE_EFFORT_LEVEL. Opus 4.6 dan Sonnet 4.6 default ke medium effort. Ini berlaku untuk semua penyedia, termasuk Bedrock, Vertex AI, dan akses API langsung. Medium adalah tingkat yang direkomendasikan untuk sebagian besar tugas coding: ini menyeimbangkan kecepatan dan kedalaman penalaran, dan tingkat yang lebih tinggi dapat menyebabkan model untuk overthink pekerjaan rutin. Cadangkan high atau max untuk tugas yang benar-benar mendapat manfaat dari penalaran lebih dalam, seperti masalah debugging yang sulit atau keputusan arsitektur kompleks. Untuk penalaran mendalam sekali tanpa mengubah pengaturan sesi Anda, sertakan “ultrathink” dalam prompt Anda untuk memicu high effort untuk giliran itu. Mengatur usaha:
  • /effort: jalankan /effort low, /effort medium, /effort high, atau /effort max untuk mengubah tingkat, atau /effort auto untuk mengatur ulang ke default model
  • Dalam /model: gunakan tombol panah kiri/kanan untuk menyesuaikan slider usaha saat memilih model
  • Flag --effort: teruskan low, medium, high, atau max untuk menetapkan tingkat untuk sesi tunggal saat meluncurkan Claude Code
  • Variabel lingkungan: atur CLAUDE_CODE_EFFORT_LEVEL ke low, medium, high, max, atau auto
  • Pengaturan: atur effortLevel di file pengaturan Anda ke "low", "medium", atau "high"
  • Skill dan subagent frontmatter: atur effort dalam file markdown skill atau subagent untuk mengganti tingkat usaha ketika skill atau subagent itu berjalan
Variabel lingkungan mengambil alih semua metode lain, kemudian tingkat yang Anda konfigurasi, kemudian default model. Usaha frontmatter berlaku ketika skill atau subagent itu aktif, mengganti tingkat sesi tetapi bukan variabel lingkungan. Usaha didukung pada Opus 4.6 dan Sonnet 4.6. Slider usaha muncul dalam /model ketika model yang didukung dipilih. Tingkat usaha saat ini juga ditampilkan di sebelah logo dan spinner, misalnya “with low effort”, sehingga Anda dapat mengkonfirmasi pengaturan mana yang aktif tanpa membuka /model. Untuk menonaktifkan penalaran adaptif pada Opus 4.6 dan Sonnet 4.6 dan kembali ke anggaran pemikiran tetap sebelumnya, atur CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. Ketika dinonaktifkan, model ini menggunakan anggaran tetap yang dikendalikan oleh MAX_THINKING_TOKENS. Lihat variabel lingkungan.

​
Konteks diperluas

Opus 4.6 dan Sonnet 4.6 mendukung jendela konteks 1 juta token untuk sesi panjang dengan basis kode besar. Ketersediaan bervariasi menurut model dan paket. Pada paket Max, Team, dan Enterprise, Opus secara otomatis ditingkatkan ke konteks 1M tanpa konfigurasi tambahan. Ini berlaku untuk kedua kursi Team Standard dan Team Premium.
PaketOpus 4.6 dengan konteks 1MSonnet 4.6 dengan konteks 1M
Max, Team, dan EnterpriseDisertakan dengan langgananMemerlukan penggunaan tambahan
ProMemerlukan penggunaan tambahanMemerlukan penggunaan tambahan
API dan pay-as-you-goAkses penuhAkses penuh
Untuk menonaktifkan konteks 1M sepenuhnya, atur CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Ini menghapus varian model 1M dari pemilih model. Lihat variabel lingkungan. Jendela konteks 1M menggunakan harga model standar tanpa premium untuk token di luar 200K. Untuk paket di mana konteks diperluas disertakan dengan langganan Anda, penggunaan tetap tercakup oleh langganan Anda. Untuk paket yang mengakses konteks diperluas melalui penggunaan tambahan, token ditagihkan ke penggunaan tambahan. Jika akun Anda mendukung konteks 1M, opsi muncul di pemilih model (/model) dalam versi terbaru Claude Code. Jika Anda tidak melihatnya, coba mulai ulang sesi Anda. Anda juga dapat menggunakan akhiran [1m] dengan alias model atau nama model lengkap: 
# Gunakan alias opus[1m] atau sonnet[1m]
/model opus[1m]
/model sonnet[1m]

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

​
Memeriksa model Anda saat ini

Anda dapat melihat model mana yang sedang Anda gunakan dengan beberapa cara:
  1. Dalam status line (jika dikonfigurasi)
  2. 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 deployment gateway LLM atau pengujian ID model yang tidak tercantum Claude Code secara default. Contoh ini menetapkan ketiga variabel untuk membuat deployment Opus yang dirutekan gateway dapat dipilih: 
export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"
Entri kustom muncul di bagian bawah pemilih /model. ANTHROPIC_CUSTOM_MODEL_OPTION_NAME dan ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION bersifat opsional. Jika dihilangkan, ID model digunakan sebagai nama dan deskripsi default ke Custom model (<model-id>). 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.

​
Variabel lingkungan

Anda dapat menggunakan variabel lingkungan berikut, yang harus berupa nama model lengkap (atau setara untuk penyedia API Anda), untuk mengontrol nama model yang dipetakan alias.
Variabel lingkunganDeskripsi
ANTHROPIC_DEFAULT_OPUS_MODELModel yang digunakan untuk opus, atau untuk opusplan ketika Plan Mode aktif.
ANTHROPIC_DEFAULT_SONNET_MODELModel yang digunakan untuk sonnet, atau untuk opusplan ketika Plan Mode tidak aktif.
ANTHROPIC_DEFAULT_HAIKU_MODELModel yang digunakan untuk haiku, atau fungsionalitas latar belakang
CLAUDE_CODE_SUBAGENT_MODELModel yang digunakan untuk subagents
Catatan: ANTHROPIC_SMALL_FAST_MODEL sudah usang dan digantikan oleh ANTHROPIC_DEFAULT_HAIKU_MODEL.

​
Tetapkan model untuk deployment pihak ketiga

Saat menerapkan Claude Code melalui Bedrock, Vertex AI, atau Foundry, tetapkan versi model sebelum meluncurkan ke pengguna. Tanpa penentapan, Claude Code menggunakan alias model (sonnet, opus, haiku) yang diselesaikan ke versi terbaru. Ketika Anthropic merilis model baru, pengguna yang akunnya tidak memiliki versi baru yang diaktifkan akan rusak secara diam-diam.
Atur ketiga variabel lingkungan model ke ID versi spesifik sebagai bagian dari pengaturan awal Anda. Melewatkan langkah ini berarti pembaruan Claude Code dapat merusak pengguna Anda tanpa tindakan apa pun dari pihak Anda.
Gunakan variabel lingkungan berikut dengan ID model spesifik versi untuk penyedia Anda:
PenyediaContoh
Bedrockexport ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'
Vertex AIexport ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'
Foundryexport ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'
Terapkan pola yang sama untuk ANTHROPIC_DEFAULT_SONNET_MODEL dan ANTHROPIC_DEFAULT_HAIKU_MODEL. Untuk ID model saat ini dan warisan di semua penyedia, lihat Ikhtisar Model. Untuk meningkatkan pengguna ke versi model baru, perbarui variabel lingkungan ini dan terapkan kembali. Untuk mengaktifkan konteks diperluas untuk model yang ditetapkan, tambahkan [1m] ke ID model dalam ANTHROPIC_DEFAULT_OPUS_MODEL atau ANTHROPIC_DEFAULT_SONNET_MODEL: 
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'
Akhiran [1m] menerapkan jendela konteks 1M ke semua penggunaan alias tersebut, termasuk opusplan. Claude Code menghapus akhiran sebelum mengirim ID model ke penyedia Anda. Hanya tambahkan [1m] ketika model yang mendasar mendukung konteks 1M, seperti Opus 4.6 atau Sonnet 4.6.
Allowlist settings.availableModels masih berlaku saat menggunakan penyedia pihak ketiga. Penyaringan cocok pada alias model (opus, sonnet, haiku), bukan ID model spesifik penyedia.

​
Ganti ID model per versi

Variabel lingkungan tingkat keluarga di atas mengonfigurasi satu ID model per alias keluarga. Jika Anda perlu memetakan beberapa versi dalam keluarga yang sama ke ID penyedia yang berbeda, gunakan pengaturan modelOverrides sebagai gantinya. modelOverrides memetakan ID model Anthropic individual ke string spesifik penyedia yang dikirim Claude Code ke API penyedia Anda. Ketika pengguna memilih model yang dipetakan di pemilih /model, Claude Code menggunakan nilai yang Anda konfigurasi alih-alih default bawaan. Ini memungkinkan administrator enterprise untuk merutekan setiap versi model ke ARN profil inferensi Bedrock tertentu, nama versi Vertex AI, atau nama deployment Foundry untuk tata kelola, alokasi biaya, atau perutean regional. Atur modelOverrides dalam file pengaturan Anda: 
{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}
Kunci harus berupa ID model Anthropic seperti yang tercantum dalam Ikhtisar Model. Untuk ID model bertanggal, sertakan akhiran tanggal persis seperti yang muncul di sana. Kunci yang tidak dikenal diabaikan. Penggantian menggantikan ID model bawaan yang mendukung setiap entri di pemilih /model. Di Bedrock, penggantian mengambil alih profil inferensi apa pun yang ditemukan Claude Code secara otomatis saat startup. Nilai yang Anda berikan langsung melalui ANTHROPIC_MODEL, --model, atau variabel lingkungan ANTHROPIC_DEFAULT_*_MODEL diteruskan ke penyedia apa adanya dan tidak diubah oleh modelOverrides. modelOverrides bekerja bersama availableModels. Allowlist dievaluasi terhadap ID model Anthropic, bukan nilai penggantian, jadi entri seperti "opus" dalam availableModels terus cocok bahkan ketika versi Opus dipetakan ke ARN.

​
Konfigurasi prompt caching

Claude Code secara otomatis menggunakan prompt caching untuk mengoptimalkan kinerja dan mengurangi biaya. Anda dapat menonaktifkan prompt caching secara global atau untuk tingkat model tertentu:
Variabel lingkunganDeskripsi
DISABLE_PROMPT_CACHINGAtur ke 1 untuk menonaktifkan prompt caching untuk semua model (mengambil alih pengaturan per-model)
DISABLE_PROMPT_CACHING_HAIKUAtur ke 1 untuk menonaktifkan prompt caching hanya untuk model Haiku
DISABLE_PROMPT_CACHING_SONNETAtur ke 1 untuk menonaktifkan prompt caching hanya untuk model Sonnet
DISABLE_PROMPT_CACHING_OPUSAtur ke 1 untuk menonaktifkan prompt caching hanya untuk model Opus
Variabel lingkungan ini memberi Anda kontrol terperinci atas perilaku prompt caching. Pengaturan global DISABLE_PROMPT_CACHING mengambil alih pengaturan spesifik model, memungkinkan Anda dengan cepat menonaktifkan semua caching saat diperlukan. Pengaturan per-model berguna untuk kontrol selektif, seperti saat men-debug model tertentu atau bekerja dengan penyedia cloud yang mungkin memiliki implementasi caching berbeda.