Variabel lingkungan

Referensi untuk variabel lingkungan yang mengontrol perilaku Claude Code.

Variabel lingkungan dapat mengontrol perilaku Claude Code seperti pemilihan model, autentikasi, perutean permintaan, dan pengalihan fitur. Banyak perilaku yang sama juga dapat dikonfigurasi melalui bidang file pengaturan, bendera CLI, atau perintah dalam sesi seperti /model.

Halaman ini mencakup cara untuk:

• Menetapkan variabel lingkungan di shell Anda atau di file pengaturan
• Memeriksa nilai mana yang berlaku ketika perilaku dapat diatur lebih dari satu cara
• Mencari variabel yang dibaca Claude Code
• Melihat fitur mana yang berhenti berfungsi ketika variabel mematikan pengambilan bendera fitur

Atur environment variable

Variabel yang Anda atur di shell Anda berlaku untuk sesi terminal tersebut, sementara variabel dalam file pengaturan berlaku setiap kali claude dijalankan.

Di shell Anda

Atur variabel sebelum meluncurkan claude:

export API_TIMEOUT_MS="1200000"
claude

$env:API_TIMEOUT_MS = "1200000"
claude

set API_TIMEOUT_MS=1200000
claude

Baris penugasan tidak mencetak apa pun saat berhasil. Untuk mengonfirmasi bahwa variabel telah diatur, cetak variabel tersebut di shell yang sama:

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

Di file pengaturan

Tambahkan variabel di bawah kunci env dalam file settings.json, buat file jika belum ada. Claude Code membacanya langsung dari file, jadi variabel tersebut berlaku tidak peduli bagaimana claude diluncurkan. Sesi yang sedang berjalan menerapkan nilai baru dan yang diubah ke lingkungannya saat Anda menyimpan file, tetapi fitur yang membaca variabelnya sekali saat startup, seperti pemantauan OpenTelemetry, mempertahankan nilai startupnya sampai Anda meluncurkan kembali. Menghapus variabel dari file tidak membatalkan pengaturannya dalam sesi yang sedang berjalan; penghapusan berlaku saat berikutnya Anda meluncurkan claude.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

File yang Anda pilih mengontrol siapa variabel berlaku untuk:

Lihat File pengaturan untuk mengetahui di mana setiap file berada dan Prioritas pengaturan untuk mengetahui bagaimana mereka bergabung saat lebih dari satu mengatur variabel yang sama.

Urutan Prioritas

Beberapa perilaku memiliki baik variabel lingkungan maupun kunci pengaturan khusus, dan mana yang dibaca Claude Code terlebih dahulu berbeda per kunci. Untuk ANTHROPIC_MODEL dan CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code membaca variabel terlebih dahulu dan hanya menggunakan pengaturan model atau autoConnectIde ketika variabel tidak diatur. Untuk pasangan yang Anda atur, periksa baris variabel di bawah ini dan entri kunci pada referensi pengaturan.

Ketika variabel yang sama diatur di shell Anda dan blok env file pengaturan, nilai file pengaturan berlaku di sebagian besar sesi. Claude Code menulis setiap entri env ke dalam lingkungan proses, menggantikan nilai yang diwarisi dari shell. Bagaimana nilai env berinteraksi dengan shell Anda mencakup sesi yang mempertahankan nilai yang diwarisi sebagai gantinya, dan pengaturan env mengatakan kapan pengaturan tersebut diterapkan. Beberapa variabel adalah kasus khusus; pengaturan env mencantumkan pengecualiannya.

Dalam file pengaturan Anda dapat mengatur variabel tetapi Anda tidak dapat menghapusnya. Untuk mengganti variabel yang tidak dapat Anda batalkan, seperti CLAUDE_CODE_USE_VERTEX yang sudah usang yang diekspor oleh profil shell yang tidak Anda kontrol, atur ke string kosong dalam blok env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code memperlakukan nilai kosong sebagai tidak diatur untuk pemilihan penyedia. Subproses masih mewarisi nilai kosong.

Antara file pengaturan, nilai env mengikuti urutan prioritas pengaturan, jadi entri pengaturan yang dikelola mengganti variabel yang sama dalam pengaturan pengguna atau proyek. Pengaturan proyek dan lokal tidak dapat mengatur beberapa variabel, seperti CLAUDE_CONFIG_DIR dan variabel pengekspor OpenTelemetry. Variabel yang Claude Code abaikan dalam env mencantumnya, bersama dengan nilai off OpenTelemetry yang masih berlaku.

Bagaimana variabel lingkungan berinteraksi dengan bendera CLI dan perintah dalam sesi bervariasi per fitur: --model dan /model mengganti ANTHROPIC_MODEL, sementara CLAUDE_CODE_EFFORT_LEVEL mengganti --effort dan /effort. Ketika variabel berinteraksi dengan sumber konfigurasi lain, barisnya dalam daftar Variabel menyatakan urutan prioritas atau menautkan ke halaman yang mendokumentasikannya.

Claude Code membaca variabel lingkungan shell saat startup, jadi perubahan pada variabel tersebut berlaku saat Anda meluncurkan claude berikutnya. Variabel yang diatur di bawah kunci env dalam file pengaturan diterapkan kembali ke sesi yang sedang berjalan ketika file berubah, dengan pengecualian startup-only yang dijelaskan dalam Dalam file pengaturan.

Variabel

Variabel numerik seperti timeout, anggaran token, dan jumlah retry menerima notasi ilmiah dan ejaan dengan pemisah digit selain digit biasa, kecuali jika baris variabel tersebut mencatat bahwa variabel hanya menerima digit biasa. Misalnya, Claude Code membaca 2e3 sebagai 2000 dan 64_000 sebagai 64000. Sebelum v2.1.211, ejaan ini dapat secara diam-diam menetapkan nilai yang jauh lebih kecil, seperti 1e6 yang menetapkan timeout menjadi 1.

Variabel exporter OpenTelemetry standar (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES, dan varian khusus sinyal) juga didukung. Lihat Pemantauan untuk detail konfigurasi.

Atur CLAUDE_CODE_ENABLE_TELEMETRY dan variabel OpenTelemetry yang mengaktifkan ekspor, memilih tujuannya, atau menangkap konten di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Claude Code mengabaikannya di pengaturan proyek dan lokal, kecuali nilai mati yang dijelaskan di bagian tersebut. OTEL_RESOURCE_ATTRIBUTES serta variabel interval ekspor, timeout, dan kompresi, seperti OTEL_METRIC_EXPORT_INTERVAL, tetap berlaku dari pengaturan proyek dan lokal.

Fitur yang memerlukan pengambilan feature-flag

Claude Code mengaktifkan beberapa fitur melalui feature flag yang diambilnya dari Anthropic. Claude Code melewati pengambilan tersebut dalam sesi-sesi ini:

• Sesi di mana Anda menetapkan DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, atau CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; baris setiap variabel dalam tabel variabel mengatakan nilai mana yang mematikan pengambilan
• Sesi pada penyedia pihak ketiga, seperti Amazon Bedrock, Claude Platform di AWS, Agent Platform Google Cloud, atau Microsoft Foundry, kecuali platform host yang menyematkan Claude Code menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sesi gateway aplikasi Claude

Dengan pengambilan dimatikan, Anda tidak dapat:

• Menjalankan /auto-mode-setup untuk membuat draf entri autoMode.environment
• Menggunakan Remote Control dengan CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC atau DISABLE_GROWTHBOOK yang ditetapkan. Untuk DISABLE_TELEMETRY dan DO_NOT_TRACK, lihat persyaratan Remote Control
• Mengirim pesan sesi di luar mesin ini ketika Remote Control tidak tersedia. Pesan antar sesi di mesin ini berfungsi dengan pengambilan dimatikan
• Menjalankan claude import atau perintah /import
• Menjalankan /skill-doctor atau membuka laporannya di tab Stats /plugin
• Mensinkronkan skills dan plugins yang diaktifkan untuk akun claude.ai Anda ke dalam sesi terminal Anda
• Menggunakan alat penasihat
• Membaca atau membalas komentar pada artefak
• Membuat Claude membaca artifact publik milik organisasi lain
• Memiliki Claude Code menyelidiki server konektor claude.ai untuk revisi protokol MCP 2026-07-28 kecuali Anda menetapkan MCP_PROTOCOL_NEGOTIATION=auto
• Mendapatkan alat PowerShell secara default untuk akun claude.ai dan Console di Windows dengan Git Bash terinstal; Claude Code merutekan perintah shell melalui Git Bash kecuali Anda menetapkan CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Di Windows tanpa Git Bash, alat tetap aktif
• Mendapatkan umpan balik yang dibuat Claude, yang Claude Code aktifkan melalui flag yang diambil
• Memiliki Claude memperlakukan pasta besar sebagai teks yang ditempel daripada teks yang diketik; konten di balik placeholder [Pasted text #N] mencapai Claude tanpa tanda
• Memiliki Claude Code mengecualikan alat MCP yang skema inputnya akan ditolak API; ia mengirim skema bagaimanapun, dan permintaan yang menyertakannya gagal dengan kesalahan 400 yang menyebutkan alat berdasarkan posisinya

Sesi pertama setelah instalasi atau upgrade

Dalam sesi pertama Anda setelah Anda menginstal Claude Code, atau upgrade ke versi yang menambahkan fitur, fitur yang gated-flag dapat hilang. Sesi itu juga dapat dimulai dalam mode izin yang berbeda daripada sesi-sesi Anda yang kemudian. Claude Code mengambil flag selama sesi itu, jadi sesi berikutnya Anda memiliki fitur dan mode izin awal yang biasa.

Setelah instalasi segar, dalam sesi non-interaktif seperti claude -p, Agent SDK, atau ekstensi VS Code, Claude Code masih dapat mengambil flag sebelum ia memilih mode izin awal.

Lihat juga

• Pengaturan: semua konfigurasi settings.json, termasuk kunci env
• Referensi CLI: flag waktu peluncuran
• Konfigurasi jaringan: pengaturan proxy dan TLS
• Monitoring: konfigurasi OpenTelemetry