Variabel lingkungan
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 |
Exec, peninjauan, TypeScript SDK, exec-server jarak jauh | Menyediakan API key untuk proses Codex noninteraktif. 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 tersimpan, salurkan token ke codex login --with-access-token. |
OPENAI_FEDERATION_RULE_ID |
Identitas beban kerja | Memilih aturan federasi yang dikonfigurasi untuk beban kerja. |
OPENAI_IDENTITY_TOKEN_FILE |
Identitas beban kerja | Mengarah ke jalur absolut file yang berisi token OIDC atau SPIFFE JWT-SVID saat ini. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
Identitas beban kerja | Secara opsional menyediakan pengidentifikasi JSON terbatas untuk atribusi audit yang dilaporkan klien. Ini tidak memengaruhi autentikasi atau otorisasi. |
CODEX_CA_CERTIFICATE |
Klien HTTPS, login, dan WebSocket | Mengarah ke bundel CA PEM untuk lingkungan dengan intersepsi TLS perusahaan atau sertifikat root privat. Lebih diprioritaskan daripada 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 dalam 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.