Skip to main content
Variabel lingkungan dapat mengontrol perilaku Claude Code seperti pemilihan model, autentikasi, perutean permintaan, dan toggle fitur. Banyak perilaku yang sama juga dapat dikonfigurasi melalui file pengaturan, flag CLI, atau perintah dalam sesi seperti /model. Halaman ini mencakup cara:

Mengatur variabel lingkungan

Variabel yang Anda atur di shell berlaku untuk sesi terminal itu, sementara variabel di file pengaturan berlaku setiap kali claude berjalan.

Di shell Anda

Atur variabel sebelum meluncurkan claude:
Untuk mengaturnya untuk setiap sesi, tambahkan baris export ke ~/.bashrc, ~/.zshrc, atau file profil shell Anda.

Di file pengaturan

Tambahkan variabel di bawah kunci env dalam file settings.json. Claude Code membacanya langsung dari file saat startup, jadi variabel berlaku tidak peduli bagaimana claude diluncurkan.
~/.claude/settings.json
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.

Prioritas

Saat perilaku yang sama memiliki variabel lingkungan dan bidang pengaturan, variabel lingkungan mengambil prioritas. Misalnya, ANTHROPIC_MODEL mengganti pengaturan model, dan CLAUDE_CODE_AUTO_CONNECT_IDE mengganti autoConnectIde. Bidang pengaturan berlaku saat variabel lingkungan tidak diatur. Ketika variabel yang sama diatur di shell Anda dan file pengaturan blok env, nilai file pengaturan berlaku. Claude Code menulis setiap entri env ke dalam lingkungan proses saat startup, mengganti nilai yang diwarisi dari shell. Beberapa variabel adalah kasus khusus; pengaturan env mencantumkan pengecualiannya. Di antara file pengaturan, nilai env mengikuti prioritas pengaturan, jadi entri pengaturan yang dikelola mengganti variabel yang sama dalam pengaturan pengguna atau proyek. Bagaimana variabel lingkungan berinteraksi dengan flag CLI dan perintah dalam sesi bervariasi per fitur: --model dan /model mengganti ANTHROPIC_MODEL, sementara CLAUDE_CODE_EFFORT_LEVEL mengganti /effort. Saat variabel berinteraksi dengan sumber konfigurasi lain, barisnya dalam daftar Variabel menyatakan prioritas atau menautkan ke halaman yang mendokumentasikannya. Claude Code membaca variabel lingkungan saat startup, jadi perubahan berlaku saat Anda meluncurkan claude berikutnya.

Variabel

Variabel pengekspor 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 spesifik sinyal) juga didukung. Lihat Monitoring untuk detail konfigurasi.

Lihat juga