Variabel lingkungan
Variabel lingkungan yang didukung oleh Codex
Codex menggunakan config.toml untuk pengaturan persisten. Gunakan variabel lingkungan untuk
penimpaan dalam cakupan shell, rahasia otomatisasi, perilaku penginstal, atau diagnostik.
Halaman ini mencantumkan variabel lingkungan publik stabil yang dibaca langsung oleh Codex.
Halaman ini tidak mencantumkan variabel pengembangan internal, variabel pengujian, atau
nama rahasia khusus penyedia yang Anda pilih sendiri melalui
env_key.
Lokasi inti
| Variabel | Digunakan oleh | Default | Deskripsi |
|---|---|---|---|
CODEX_HOME |
CLI, ekstensi IDE, app-server, penginstal | ~/.codex |
Menetapkan lokasi akar untuk status Codex, termasuk konfigurasi, autentikasi, log, sesi, skill, dan metadata paket mandiri. Jika Anda menetapkannya, direktori tersebut harus sudah tersedia. |
CODEX_SQLITE_HOME |
Status CLI dan app-server | CODEX_HOME |
Menetapkan tempat penyimpanan status berbasis SQLite. Opsi konfigurasi sqlite_home memiliki prioritas. Jalur relatif ditentukan dari direktori kerja saat ini. |
Untuk informasi selengkapnya tentang file yang disimpan dalam CODEX_HOME, lihat
Lokasi konfigurasi dan status.
Variabel penginstal
Variabel ini berlaku untuk skrip penginstalan mandiri yang disajikan dari
https://chatgpt.com/codex/install.sh dan
https://chatgpt.com/codex/install.ps1.
| Variabel | Default | Deskripsi |
|---|---|---|
CODEX_NON_INTERACTIVE |
false |
Tetapkan ke 1, true, atau yes untuk melewati prompt penginstal. Prompt menggunakan respons defaultnya, jadi gunakan ini untuk penginstalan dan pembaruan berskrip, bukan penyiapan pertama kali. |
CODEX_INSTALL_DIR |
~/.local/bin di macOS/Linux; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin di Windows |
Mengubah lokasi penginstalan perintah codex yang terlihat. Cache paket mandiri tetap berada dalam CODEX_HOME/packages/standalone. |
Untuk penginstalan tanpa pengawasan, tetapkan CODEX_NON_INTERACTIVE=1 pada shell yang menjalankan
penginstal yang telah diunduh:
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iexAutentikasi dan jaringan
| Variabel | Digunakan oleh | Deskripsi |
|---|---|---|
CODEX_API_KEY |
codex exec |
Menyediakan API key untuk satu proses noninteraktif. Ini hanya didukung dalam codex exec; tetapkan secara inline, bukan untuk seluruh pekerjaan, saat menjalankan kode yang dikendalikan repositori. |
CODEX_ACCESS_TOKEN |
CLI, app-server, otomatisasi tepercaya | Menyediakan token akses ChatGPT atau Codex untuk otomatisasi tepercaya. Untuk login persisten, salurkan ke codex login --with-access-token. |
CODEX_CA_CERTIFICATE |
Klien HTTPS, login, dan WebSocket | Menunjuk ke bundel CA PEM untuk lingkungan dengan intersepsi TLS perusahaan atau CA akar privat. Memiliki prioritas atas SSL_CERT_FILE. |
SSL_CERT_FILE |
Klien HTTPS, login, dan WebSocket | Jalur bundel CA PEM cadangan saat CODEX_CA_CERTIFICATE tidak ditetapkan. |
Untuk API key penyedia, tetapkan
env_key dalam konfigurasi penyedia model.
Codex membaca variabel yang disebutkan oleh konfigurasi tersebut, sehingga nama variabel
itu sendiri bukan variabel lingkungan Codex yang tetap.
Untuk penanganan rahasia otomatisasi, lihat Gunakan autentikasi API key. Untuk penyiapan token akses, lihat Token akses.
Diagnostik
| Variabel | Digunakan oleh | Deskripsi |
|---|---|---|
RUST_LOG |
CLI dan app-server | Mengendalikan pemfilteran dan tingkat detail log Rust. codex exec menggunakan output error secara default, kecuali Anda menetapkan nilai yang lebih terperinci. |
RUST_LOG menerima nilai seperti error, warn, info, debug, dan
trace. Variabel ini juga menerima filter pencatatan log Rust yang lebih spesifik, seperti
codex_core=debug,codex_tui=debug.
CLI interaktif merekam diagnostik dalam penyimpanan lokal berbatas secara default, tetapi
file teks biasa codex-tui.log bersifat opsional. Tetapkan log_dir secara eksplisit saat Anda
memerlukan log teks biasa untuk pemecahan masalah:
RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.logDalam mode noninteraktif, codex exec mencetak pesan secara inline, bukan menulisnya
ke file log TUI terpisah.