Dasar-dasar konfigurasi

Codex membaca detail konfigurasi dari lebih dari satu lokasi. Pengaturan default pribadi Anda berada di ~/.codex/config.toml, dan Anda dapat menambahkan penggantian khusus proyek dengan file .codex/config.toml. Demi keamanan, Codex hanya memuat lapisan .codex/ proyek jika Anda memercayai proyek tersebut.

File konfigurasi Codex

Codex menyimpan konfigurasi tingkat pengguna di ~/.codex/config.toml. Untuk membatasi cakupan pengaturan ke proyek atau subfolder tertentu, tambahkan file .codex/config.toml di repositori Anda.

Untuk membuka file konfigurasi dari ekstensi Codex IDE, pilih ikon roda gigi di sudut kanan atas, lalu pilih Codex Settings > Open config.toml.

CLI dan ekstensi IDE menggunakan lapisan konfigurasi yang sama. Anda dapat menggunakannya untuk:

• Menetapkan model dan penyedia default.
• Mengonfigurasi kebijakan persetujuan dan pengaturan sandbox.
• Mengonfigurasi server MCP.

Prioritas konfigurasi

Codex menentukan nilai dalam urutan berikut (prioritas tertinggi lebih dahulu):

1. Flag CLI dan penggantian nilai melalui --config
2. File konfigurasi proyek: .codex/config.toml, diurutkan dari direktori akar proyek hingga direktori kerja Anda saat ini (yang terdekat diutamakan; hanya untuk proyek tepercaya)
3. File profil yang dipilih dengan --profile profile-name (~/.codex/profile-name.config.toml)
4. Konfigurasi pengguna: ~/.codex/config.toml
5. Nilai bawaan config.toml yang dikelola melalui cloud, jika disediakan untuk ruang kerja tempat Anda masuk
6. Konfigurasi sistem (jika ada): /etc/codex/config.toml di Unix
7. Nilai bawaan aplikasi

Gunakan urutan prioritas tersebut untuk menetapkan pengaturan default bersama di config.toml dan menjaga agar file profil hanya berisi nilai yang berbeda.

Konfigurasi yang dikelola melalui cloud dan konfigurasi sistem dapat menentukan marketplace plugin dan mengatur apakah plugin diaktifkan secara bawaan. Konfigurasi ini terpisah dari kebijakan requirements.toml yang diberlakukan secara wajib. Lihat Mengonfigurasi marketplace plugin dan nilai bawaan.

Jika Anda menandai proyek sebagai tidak tepercaya, Codex melewati lapisan .codex/ yang dicakup oleh proyek, termasuk konfigurasi, hook, dan aturan lokal proyek. Konfigurasi pengguna dan sistem tetap dimuat, termasuk hook dan aturan pengguna/global.

Untuk penggantian sekali pakai melalui -c/--config (termasuk aturan tanda kutip TOML), lihat Konfigurasi Lanjutan.

Opsi konfigurasi umum

Berikut beberapa opsi yang paling sering diubah:

Model default

Pilih model yang digunakan Codex secara default di CLI dan IDE.

model = "gpt-5.6"

Permintaan persetujuan

Atur kapan Codex berhenti sementara untuk meminta persetujuan sebelum menjalankan perintah yang dihasilkan.

approval_policy = "on-request"

Untuk perbedaan perilaku antara on-request dan never, lihat Menjalankan tanpa permintaan persetujuan dan Kombinasi sandbox dan persetujuan yang umum. Jika konfigurasi yang ada menggunakan approval_policy = "untrusted", lihat Bermigrasi dari kebijakan persetujuan untrusted yang telah dihentikan.

Tingkat sandbox

Sesuaikan tingkat akses sistem file dan jaringan yang dimiliki Codex saat menjalankan perintah.

sandbox_mode = "workspace-write"

Untuk perilaku setiap mode (termasuk jalur .git/.codex yang dilindungi dan pengaturan default jaringan), lihat Sandbox dan persetujuan, Jalur yang dilindungi di root yang dapat ditulis, dan Akses jaringan.

Profil izin

Codex juga mendukung profil izin bernama untuk kebijakan sistem file dan jaringan yang dapat digunakan kembali. Profil bawaan adalah :read-only, :workspace, dan :danger-full-access. Profil khusus menggunakan tabel [permissions.<name>] dan nilai default_permissions yang cocok. Lihat Izin.

Mode sandbox Windows

Saat menjalankan Codex secara native di Windows, tetapkan mode sandbox native ke elevated dalam tabel windows. Gunakan unelevated hanya jika Anda tidak memiliki izin administrator atau jika penyiapan dengan hak akses lebih tinggi gagal.

[windows]
sandbox = "elevated"   # Recommended
# sandbox = "unelevated" # Fallback if admin permissions/setup are unavailable

Mode pencarian web

Codex mengaktifkan pencarian web secara default untuk percakapan lokal dan menyajikan hasil dari cache pencarian web. Cache tersebut adalah indeks hasil web yang dikelola OpenAI, sehingga mode cache mengembalikan hasil yang telah diindeks sebelumnya, bukan mengambil halaman secara langsung. Hal ini mengurangi paparan terhadap injeksi prompt dari konten langsung yang sembarang, tetapi Anda tetap harus memperlakukan hasil web sebagai tidak tepercaya. Jika Anda menggunakan --yolo atau pengaturan sandbox akses penuh lainnya, pencarian web secara default menggunakan hasil langsung. Pilih mode dengan web_search:

• "cached" (default) menyajikan hasil dari cache pencarian web.
• "indexed" mengizinkan akses web eksternal hanya jika indeks pencarian menyetujui permintaan tersebut.
• "live" mengambil data terbaru dari web (sama seperti --search).
• "disabled" menonaktifkan alat pencarian web.

web_search = "cached"  # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live"  # fetch the most recent data from the web (same as --search)
# web_search = "disabled"

Upaya penalaran

Sesuaikan seberapa besar upaya penalaran yang diterapkan model jika didukung.

model_reasoning_effort = "high"

Gaya komunikasi

Tetapkan gaya komunikasi default untuk model yang didukung.

personality = "friendly" # or "pragmatic" or "none"

Anda dapat menggantinya nanti dalam sesi aktif dengan /personality atau per utas/giliran saat menggunakan API app-server.

Pemetaan tombol TUI

Sesuaikan pintasan terminal di bawah tui.keymap. Tindakan composer yang dipilih menggunakan binding tui.keymap.global yang cocok sebagai fallback; binding khusus konteks memiliki prioritas jika didukung. Daftar kosong menghapus binding tindakan tersebut.

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.composer]
submit = ["enter", "ctrl-m"]

[tui.keymap.chat]
interrupt_turn = "f12"

Lingkungan perintah

Atur variabel lingkungan mana yang diteruskan Codex ke perintah yang dijalankan. Gunakan filter berbasis kunci agar hanya variabel yang Anda perlukan yang dipertahankan:

[shell_environment_policy]
ignore_default_excludes = false

[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"

ignore_default_excludes secara default bernilai true, yang melewati pemfilteran otomatis untuk nama variabel yang mengandung KEY, SECRET, atau TOKEN. Tetapkan ke false jika Anda menginginkan pemfilteran otomatis tersebut. Untuk aturan pengecualian, prioritas, dan konfigurasi lama, lihat Kebijakan lingkungan shell.

Direktori log

Ganti lokasi tempat Codex menulis file log lokal. Menetapkan log_dir secara eksplisit juga mengaktifkan log TUI teks biasa opsional, codex-tui.log, di direktori tersebut.

log_dir = "/absolute/path/to/codex-logs"

Untuk proses sekali pakai, Anda juga dapat menetapkannya dari CLI:

codex -c log_dir=./.codex-log

Flag fitur

Gunakan tabel [features] di config.toml untuk mengaktifkan atau menonaktifkan kemampuan opsional dan eksperimental.

Flag fitur umum

Untuk konfigurasi hook siklus hidup, lihat Hook.

Mengaktifkan fitur

• Di config.toml, tambahkan feature_name = true di bawah [features].
• Dari CLI, jalankan codex --enable feature_name.
• Untuk mengaktifkan lebih dari satu fitur, jalankan codex --enable feature_a --enable feature_b.
• Untuk menonaktifkan fitur, tetapkan kunci ke false di config.toml.