Referensi Konfigurasi
Referensi lengkap untuk Codex config.toml dan requirements.toml
Gunakan halaman ini sebagai referensi yang dapat ditelusuri untuk file konfigurasi Codex. Untuk panduan konseptual dan contoh, mulailah dengan Dasar-dasar konfigurasi dan Konfigurasi Lanjutan.
Pengaturan akses komputer lokal dengan Work Cloud
Saat akses komputer lokal dengan Work Cloud diaktifkan, cloud OpenAI mengoordinasikan tugas sementara alat yang didukung berjalan di cloud atau di komputer yang terhubung. Persyaratan menetapkan batasan; nilai konfigurasi menyediakan nilai default.
Gunakan API kebijakan untuk mengelola pengaturan Global. Untuk mengelola pengaturan Local atau Codex Cloud, gunakan antarmuka Agent Security. Alur kerja API Global yang ada tetap tersedia setelah migrasi. Uji skrip dan integrasi Terraform Anda, serta pastikan penetapan dan urutan kebijakan tidak berubah. Dukungan untuk suatu kolom requirements.toml tidak dengan sendirinya menjamin kompatibilitas API.
| Pengaturan atau kelompok pengaturan | Cakupan dalam akses komputer lokal dengan Work Cloud | Panduan |
|---|---|---|
| Kebijakan persetujuan dan persyaratan peninjauan | Kebijakan orkestrator Global saat kebijakan terkelola diaktifkan | Pertahankan kontrol persetujuan dan peninjauan di Global. Penggantian pengaturan lingkungan tidak dapat mengubah kontrol orkestrator. Eksekusi lokal dan eksekusi kontainer cloud memiliki cakupan kebijakan yang terpisah. |
| Aplikasi terkelola, MCP server, plugin, marketplace, dan aturan perintah | Kebijakan Global | Pertahankan kontrol ini pada cakupan global. Jangan menganggap keberadaan suatu kolom dalam skema sebagai bukti bahwa kolom tersebut dapat diedit per lingkungan. |
| Persyaratan berkas, sandbox, dan jaringan yang portabel | Eksekusi lokal | Untuk eksekusi lokal, MDM dan persyaratan perangkat terkelola lama memiliki prioritas lebih tinggi daripada Agent Security. Berkas persyaratan sistem perangkat memiliki prioritas lebih rendah daripada Agent Security. Konfigurasi requirements.toml perusahaan yang baru tidak berlaku untuk kontainer cloud Work, yang tetap menggunakan kebijakan Work Cloud yang ada. |
| Kontrol eksekutor khusus platform | Komputer yang menjalankan langkah | Dukungan bergantung pada eksekutor dan platform. |
| Hook terkelola | Jika diaktifkan, hook MCP yang ditentukan admin dan berjalan pada koordinator cloud (orkestrator) untuk peristiwa siklus hidup dan alat yang didukung. | Sebelum mengandalkan hook ini, uji koneksi callback, pastikan peristiwa yang diterimanya, dan periksa pengaruh kegagalan terhadap tugas. Hook MCP tidak menyediakan jejak audit Compliance API yang lengkap. Hook perintah, konfigurasi lokal, dan plugin tidak didukung dengan orkestrasi cloud, meskipun alat dijalankan secara lokal. Hook yang sudah didukung tetap berlaku untuk utas Work dan Codex khusus lokal, yang orkestrasi dan eksekusinya sama-sama berjalan secara lokal. |
| Alamat listener proksi, port, dan pengaturan proses | Bukan kebijakan lingkungan yang portabel | Runtime cloud tidak mendukung port listener HTTP/SOCKS terkelola dan listener proksi non-loopback; dukungan aturan soket bergantung pada jalur eksekusi. Konfigurasi proksi kustom terpisah dari pembatasan tujuan yang didukung. |
| Pengaturan khusus aplikasi dan nilai default lokal biasa | Belum tentu digunakan oleh koordinasi cloud | Kontrol yang diberlakukan aplikasi dapat tetap efektif meskipun akses komputer lokal dengan Work Cloud tidak menggunakannya. Pengiriman melalui cloud dan perilaku browser cloud memerlukan validasi terpisah. |
Persyaratan Agent Security untuk akses komputer lokal dengan Work Cloud
Untuk Work dengan akses lokal dan dots, kebijakan Global yang didukung berlaku pada orkestrator cloud bersama saat kebijakan terkelola diaktifkan. Persyaratan eksekusi lokal mengatur komputer yang terhubung. Kontainer cloud Work dan komputer cloud dots menggunakan konfigurasi dan persyaratan eksekusinya sendiri. Uji kontrol lokal dan cloud secara terpisah.
Tersedia di antarmuka Agent Security
- Kebijakan persetujuan yang diizinkan
- Mode pencarian web yang diizinkan
Dikonfigurasi melalui TOML
allowed_approvals_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
Persyaratan orkestrator ini tetap berada di Global. Persyaratan ini tidak mengonfigurasi izin kapabilitas cloud bersama atau membuat pengaturan eksekusi lokal dapat diterapkan pada kontainer cloud Work atau komputer cloud dots.
Batas kompatibilitas akses komputer lokal dengan Work Cloud
Dukungan bergantung pada kolom, cara kebijakan dikirimkan, dan tempat tugas dijalankan. Periksa kebijakan efektif anggota sebelum mengaktifkan sinkronisasi. Beberapa kontrol perlu diuji dalam penerapan Anda, sebagaimana dicatat dalam tabel.
Dalam suatu kebijakan, urutan dari prioritas tertinggi ke terendah adalah penggantian pengaturan lingkungan khusus OS → penggantian pengaturan lingkungan untuk semua OS → Global. Kebijakan dengan prioritas lebih tinggi diutamakan meskipun kebijakan dengan prioritas lebih rendah lebih spesifik.
Untuk eksekusi lokal, MDM dan persyaratan perangkat terkelola lama lebih diutamakan daripada Agent Security, yang lebih diutamakan daripada berkas persyaratan sistem perangkat. Beberapa persyaratan, termasuk persyaratan jaringan, memiliki aturan penggabungan khusus kolom dan batasan runtime. Lihat Konfigurasi terkelola untuk contohnya.
| Pengaturan atau kelompok | Kompatibilitas akses komputer lokal dengan Work Cloud | Panduan admin |
|---|---|---|
sqlite_home, log_dir, model_catalog_json |
Tidak didukung sebagai penggantian konfigurasi cloud terkelola. | Jalur lokal tidak dapat memindahkan penyimpanan cloud atau log. Katalog model lokal tidak diterapkan di cloud. |
model_provider, model_providers |
Tidak didukung dalam persyaratan atau konfigurasi terkelola untuk akses komputer lokal dengan Work Cloud. | Gateway inferensi kustom dan koneksi penyedia tidak diterapkan melalui kolom ini. Hal ini terpisah dari pemilihan model. |
enforce_residency |
Memblokir akses komputer lokal dengan Work Cloud jika diaktifkan dalam kebijakan cloud mana pun. | Jika enforce_residency diaktifkan dalam kebijakan cloud mana pun, Izinkan akses komputer lokal dinonaktifkan untuk Work maupun dots. Perlindungan ini tidak mengatur residensi ruang kerja atau, dengan sendirinya, menonaktifkan Work Cloud maupun dots. |
application.network.enabled dan application.network.domains |
Tidak didukung oleh akses komputer lokal dengan Work Cloud. | Jangan gunakan pembatasan tujuan aplikasi ini sebagai kontrol jaringan perintah untuk akses komputer lokal dengan Work Cloud. |
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions |
Penyampaian kebijakan cloud perlu divalidasi. Akses komputer lokal dengan Work Cloud menolak kunci persyaratan terkelola ini. | Pembatasan browser memiliki pemeriksaan di sisi aplikasi. Hal itu tidak membuktikan penyampaian melalui cloud atau penerapannya pada browser cloud. additional_developer_instructions memerlukan dukungan orkestrator. |
experimental_network dan permissions.<profile>.network |
Sebagian. Pembatasan tujuan dan eksekutor yang didukung berbeda dari konfigurasi proksi kustom. | Runtime cloud tidak mendukung port listener HTTP/SOCKS terkelola dan listener proksi non-loopback; dukungan aturan soket bergantung pada jalur eksekusi. Perilaku penggabungan untuk eksekusi lokal diatur secara terpisah. Pembatasan jaringan perintah tidak menonaktifkan pencarian yang dihosting, MCP, atau alat aplikasi. |
features / feature_requirements, models, computer_use |
Sebagian. | Opsi yang sudah dihentikan seperti tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true, dan remote_control = true ditolak. Beberapa pengaturan penggunaan komputer masih memerlukan validasi menyeluruh. |
browser_use, allow_appshots, feedback, allow_remote_control, pembatasan sumber marketplace |
Aplikasi atau app-server menerapkan kontrol ini pada beberapa jalur penyampaian kebijakan. | Kontrol aplikasi tetap dapat berlaku saat akses komputer lokal dengan Work Cloud mengabaikan suatu kolom. Aturan situs browser desktop tidak berlaku untuk kontainer cloud Work. Validasi antarmuka dan jalur penyampaian kebijakan yang sebenarnya digunakan. |
Skema konfigurasi mencakup kunci yang mungkin tidak berfungsi dengan akses komputer lokal dengan Work Cloud atau tidak mendukung penggantian konfigurasi lingkungan. Lihat Konfigurasi terkelola untuk konfigurasi dasar global dan urutan prioritasnya.
config.toml
Konfigurasi tingkat pengguna berada di ~/.codex/config.toml. Anda juga dapat menambahkan penggantian cakupan proyek dalam file .codex/config.toml. Codex hanya memuat file konfigurasi cakupan proyek jika Anda memercayai proyek tersebut.
Konfigurasi cakupan proyek tidak dapat mengganti penyedia lokal mesin, autentikasi,
metadata permintaan aplikasi milik host, notifikasi, pemilihan profil konfigurasi,
atau kunci perutean telemetri. Codex mengabaikan openai_base_url,
chatgpt_base_url, apps_mcp_product_sku, model_provider,
model_providers, notify, profile, profiles,
experimental_realtime_ws_base_url, dan otel ketika muncul dalam
.codex/config.toml lokal proyek; tempatkan kunci penyedia, notifikasi, dan telemetri
dalam konfigurasi tingkat pengguna. File profil konfigurasi berada di samping
config.toml sebagai $CODEX_HOME/profile-name.config.toml; pilih salah satunya dengan
--profile profile-name.
Untuk kunci sandbox dan persetujuan (approval_policy, sandbox_mode, dan sandbox_workspace_write.*), gunakan referensi ini bersama Sandbox dan persetujuan, Jalur terlindungi dalam root yang dapat ditulis, dan Akses jaringan. Untuk profil izin beta, lihat Izin.
Codex dan ChatGPT Work tidak lagi mendukung approval_policy = "untrusted".
Hapus pengaturan tersebut atau pilih kebijakan yang didukung. Entri proyek dengan
trust_level = "untrusted" dalam ~/.codex/config.toml tingkat pengguna tetap didukung. Lihat
Bermigrasi dari kebijakan persetujuan untrusted yang telah dihentikan
untuk contoh serta pertimbangan kelebihan dan kekurangan opsi persetujuan.
Tetapkan model ke model yang tersedia bagi akun yang Anda gunakan untuk masuk atau ruang kerja Anda. Lihat
Ketersediaan GPT-6.1 Sol sebelum menggunakan nilai contoh.
| Kunci | Tipe / nilai | Detail |
|---|---|---|
agents |
table |
Pengaturan multiagen dan deklarasi peran kustom. Nama pengaturan skalar dicadangkan dan tidak dapat digunakan sebagai nama peran kustom. |
agents.<name>.config_file |
string (path) |
Jalur ke lapisan konfigurasi TOML untuk peran tersebut; jalur relatif ditentukan dari file konfigurasi yang mendeklarasikan peran. |
agents.<name>.description |
string |
Panduan peran yang ditampilkan kepada Codex saat memilih dan membuat jenis agen tersebut. |
agents.default_subagent_model |
string |
Model default untuk agen yang dibuat. Model yang ditentukan secara eksplisit saat pembuatan lebih diutamakan. |
agents.default_subagent_reasoning_effort |
string |
Upaya penalaran default untuk agen yang dibuat. Upaya yang ditentukan secara eksplisit saat pembuatan lebih diutamakan. |
agents.enabled |
boolean |
Mengaktifkan atau menonaktifkan alat multiagen (default: true). |
agents.interrupt_message |
boolean |
Mencatat pesan yang dapat dilihat model saat giliran agen diinterupsi (default: true). |
agents.max_concurrent_threads_per_session |
number |
Jumlah maksimum utas agen yang dibuat yang dapat terbuka secara bersamaan, tidak termasuk utas utama. Jika tidak diatur, Codex memilih nilai default. |
agents.max_threads |
number |
Alias lama untuk agents.max_concurrent_threads_per_session. |
allow_login_shell |
boolean |
Mengizinkan alat berbasis shell menggunakan semantik shell login. Defaultnya adalah true; jika false, permintaan login = true ditolak dan login yang tidak dicantumkan secara default menggunakan shell non-login. |
analytics.enabled |
boolean |
Mengaktifkan atau menonaktifkan analitik untuk mesin/profil ini. Jika tidak diatur, default klien berlaku. |
approval_policy |
on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } |
Mengontrol kapan Codex berhenti sejenak untuk meminta persetujuan sebelum menjalankan perintah. Anda juga dapat menggunakan approval_policy = { granular = { ... } } untuk mengizinkan atau menolak otomatis kategori permintaan tertentu, sementara permintaan lainnya tetap interaktif. untrusted tidak didukung, dan on-failure sudah usang; gunakan on-request untuk eksekusi interaktif atau never untuk eksekusi noninteraktif. |
approval_policy.granular.mcp_elicitations |
boolean |
Jika true, permintaan elisitasi MCP boleh ditampilkan alih-alih ditolak otomatis. |
approval_policy.granular.request_permissions |
boolean |
Jika true, permintaan dari alat request_permissions boleh ditampilkan. |
approval_policy.granular.rules |
boolean |
Jika true, permintaan persetujuan yang dipicu oleh aturan execpolicy prompt boleh ditampilkan. |
approval_policy.granular.sandbox_approval |
boolean |
Jika true, permintaan persetujuan eskalasi sandbox boleh ditampilkan. |
approval_policy.granular.skill_approval |
boolean |
Jika true, permintaan persetujuan skrip skill boleh ditampilkan. |
approvals_reviewer |
user | auto_review |
Pihak yang meninjau permintaan persetujuan yang memenuhi syarat berdasarkan on-request atau kebijakan persetujuan terperinci. Defaultnya adalah user; auto_review menggunakan subagen peninjau. Pengaturan ini tidak mengubah penerapan sandbox atau meninjau tindakan yang sudah diizinkan di dalam sandbox. |
apps._default.approvals_reviewer |
user | auto_review |
Peninjau default untuk permintaan persetujuan alat aplikasi, kecuali diganti per aplikasi. Jika tidak dicantumkan, aplikasi mewarisi nilai approvals_reviewer tingkat teratas. |
apps._default.default_tools_approval_mode |
auto | prompt | writes | approve |
Perilaku persetujuan default untuk alat aplikasi tanpa penggantian per aplikasi atau per alat. |
apps._default.destructive_enabled |
boolean |
Izin/penolakan default untuk alat aplikasi dengan destructive_hint = true. |
apps._default.enabled |
boolean |
Status pengaktifan aplikasi default untuk semua aplikasi, kecuali diganti per aplikasi. |
apps._default.open_world_enabled |
boolean |
Izin/penolakan default untuk alat aplikasi dengan open_world_hint = true. |
apps.<id>.approvals_reviewer |
user | auto_review |
Peninjau untuk permintaan persetujuan alat aplikasi ini. Menggantikan apps._default.approvals_reviewer. |
apps.<id>.default_tools_approval_mode |
auto | prompt | writes | approve |
Perilaku persetujuan default untuk alat dalam aplikasi ini, kecuali ada penggantian per alat. |
apps.<id>.default_tools_enabled |
boolean |
Status pengaktifan default untuk alat dalam aplikasi ini, kecuali ada penggantian per alat. |
apps.<id>.destructive_enabled |
boolean |
Mengizinkan atau memblokir alat dalam aplikasi ini yang menyatakan destructive_hint = true. |
apps.<id>.enabled |
boolean |
Mengaktifkan atau menonaktifkan aplikasi/konektor tertentu berdasarkan ID (default: true). |
apps.<id>.open_world_enabled |
boolean |
Mengizinkan atau memblokir alat dalam aplikasi ini yang menyatakan open_world_hint = true. |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Penggantian perilaku persetujuan per alat untuk satu alat aplikasi. |
apps.<id>.tools.<tool>.enabled |
boolean |
Penggantian status pengaktifan per alat untuk alat aplikasi (misalnya repos/list). |
auto_review.extra_policy |
string |
Kebijakan Markdown lokal tambahan untuk peninjauan otomatis, disertakan bersama kebijakan utama. guardian_extra_policy yang dikelola lebih diutamakan. Nilai kosong diabaikan. |
auto_review.policy |
string |
Instruksi kebijakan Markdown lokal untuk peninjauan otomatis. guardian_policy_config yang dikelola lebih diutamakan. Nilai kosong diabaikan. |
background_terminal_max_timeout |
number |
Jendela polling maksimum dalam milidetik untuk polling write_stdin kosong (polling terminal latar belakang). Default: 300000 (5 menit). Menggantikan kunci lama background_terminal_timeout. |
browser_use.allow_history_access |
boolean |
Atur ke false untuk membatasi akses riwayat browser. Persyaratan yang dikelola dapat memberlakukan pembatasan ini. |
browser_use.default_origin_policy |
table |
Pembatasan origin browser cadangan. Mendukung access, uploads, downloads, dan full_cdp_access, masing-masing diatur ke allow atau deny. |
browser_use.origins.<origin> |
table |
Pembatasan browser per origin dengan field yang sama seperti browser_use.default_origin_policy. Sertakan skema HTTP atau HTTPS dan port opsional; jangan sertakan jalur, kueri, dan fragmen. Nilai lokal tidak dapat melonggarkan penolakan yang dikelola. |
chatgpt_base_url |
string |
Mengganti URL dasar yang digunakan selama alur login ChatGPT. |
check_for_update_on_startup |
boolean |
Memeriksa pembaruan Codex saat startup (atur ke false hanya jika pembaruan dikelola secara terpusat). |
cli_auth_credentials_store |
file | keyring | auto | ephemeral |
Mengontrol lokasi CLI menyimpan kredensial yang di-cache. |
compact_prompt |
string |
Penggantian inline untuk prompt pemadatan riwayat. |
computer_use.default_app_access |
allow | deny |
Kebijakan akses aplikasi native cadangan untuk Computer Use. Entri khusus aplikasi dapat menyediakan kebijakan; konfigurasi lokal tidak dapat melonggarkan pembatasan yang dikelola. |
computer_use.macos.bundle_ids |
map<string, allow | deny> |
Akses aplikasi native macOS dengan pengenal bundel sebagai kunci. |
computer_use.windows.always_allowed_app_ids |
array<string> |
Pengenal aplikasi Windows yang dapat dibuka Computer Use tanpa meminta persetujuan. Aplikasi yang tidak ada dalam daftar memerlukan persetujuan; hapus entri tersimpan dari pengaturan Computer Use di aplikasi desktop ChatGPT. |
computer_use.windows.aumids |
map<string, allow | deny> |
Akses aplikasi Windows terpaket dengan Application User Model ID (AUMID) sebagai kunci. |
computer_use.windows.exes |
array<table> |
Aturan akses executable Windows. Setiap aturan memerlukan publisher_name, product_name, dan access (allow atau deny); binary_name bersifat opsional. |
default_permissions |
string |
Nama profil izin default yang diterapkan pada pemanggilan alat dalam sandbox. Profil bawaan adalah :read-only, :workspace, dan :danger-full-access; nama profil kustom memerlukan tabel [permissions.<name>] yang sesuai. Jangan gabungkan dengan sandbox_mode atau [sandbox_workspace_write]. |
desktop.custom_file_handlers.<id> |
table |
Hanya pada tingkat pengguna. Menentukan target Buka di tambahan untuk aplikasi desktop ChatGPT. Lihat Menambahkan penangan file kustom untuk contoh dan batasan ID penangan. |
desktop.custom_file_handlers.<id>.args |
array<string> |
Argumen yang disisipkan di antara perintah dan masukan file (default: []). |
desktop.custom_file_handlers.<id>.command |
string |
Jalur executable atau nama perintah yang akan dideteksi dan diluncurkan. Wajib diisi. |
desktop.custom_file_handlers.<id>.icon |
string |
Jalur aset bundel, URL data:image/... yang dienkode Base64, URI file, atau jalur lokal absolut untuk ikon penangan. Wajib diisi; sumber yang tidak didukung menggunakan ikon VS Code default. |
desktop.custom_file_handlers.<id>.input |
path | json_argument | json_stdin |
Cara aplikasi mengirim masukan file ke penangan (default: path). |
desktop.custom_file_handlers.<id>.label |
string |
Nama tampilan yang ditampilkan dalam menu Buka di. Wajib diisi. |
desktop.custom_file_handlers.<id>.supports_ssh |
boolean |
Menawarkan penangan untuk file di ruang kerja SSH (default: false). |
developer_instructions |
string |
Instruksi pengembang tambahan yang disisipkan ke dalam sesi (opsional). |
disable_paste_burst |
boolean |
Menonaktifkan deteksi penempelan teks beruntun di TUI. |
experimental_compact_prompt_file |
string (path) |
Memuat penggantian prompt pemadatan dari file (eksperimental). |
experimental_use_unified_exec_tool |
boolean |
Nama lama untuk mengaktifkan exec terpadu; utamakan [features].unified_exec atau codex --enable unified_exec. |
features.apps |
boolean |
Mengaktifkan integrasi aplikasi (konektor) (stabil; aktif secara default). Lalu lintas aplikasi dan konektor tidak dikontrol oleh proksi jaringan perintah dalam sandbox atau daftar domain yang diizinkannya. |
features.code_mode.direct_only_tool_namespaces |
array<string> |
Namespace alat yang hanya dapat digunakan mode kode melalui pemanggilan alat langsung. |
features.code_mode.enabled |
boolean |
Mengaktifkan konfigurasi fitur mode kode. Fitur ini sedang dikembangkan dan nonaktif secara default. |
features.code_mode.excluded_tool_namespaces |
array<string> |
Namespace alat yang dikecualikan mode kode dari panduan alat mode kode bertingkat dan akses melalui eksekutor. |
features.context_management.experimental_mode |
boolean |
Pengaturan pengelolaan konteks eksperimental. Fitur ini saat ini belum tersedia. |
features.enable_request_compression |
boolean |
Mengompresi isi permintaan streaming dengan zstd jika didukung (stabil; aktif secara default). |
features.fast_mode |
boolean |
Mengaktifkan pemilihan tingkat layanan katalog model di TUI, termasuk perintah tingkat Fast jika model aktif menyatakan dukungannya (stabil; aktif secara default). |
features.goals |
boolean |
Mengaktifkan tujuan yang disimpan secara persisten dan pelanjutan otomatis (stabil; aktif secara default). |
features.hooks |
boolean |
Mengaktifkan hook siklus hidup yang dimuat dari hooks.json atau konfigurasi inline [hooks]. features.codex_hooks adalah alias yang sudah usang. |
features.memories |
boolean |
Mengaktifkan Memori (nonaktif secara default). |
features.multi_agent |
boolean |
Mengaktifkan alat kolaborasi multiagen (spawn_agent, send_input, resume_agent, wait_agent, dan close_agent) (stabil; aktif secara default). |
features.network_proxy |
boolean | table |
Memulai proksi jaringan untuk perintah dalam sandbox (eksperimental; nonaktif secara default). Diperlukan untuk memberlakukan aturan domain profil izin, kecuali persyaratan experimental_network yang dikelola administrator dan diaktifkan memulai proksi. Gunakan tabel saat mengatur opsi kebijakan tingkat fitur seperti domains. Tidak memfilter pencarian web, aplikasi, MCP, atau alat lain yang dihosting. |
features.network_proxy.allow_local_binding |
boolean |
Mengizinkan akses jaringan lokal/privat yang lebih luas. Defaultnya adalah false; aturan izin literal IP lokal persis atau localhost tetap dapat mengizinkan target lokal tertentu. |
features.network_proxy.allow_upstream_proxy |
boolean |
Mengizinkan perantaian melalui proksi upstream dari lingkungan. Defaultnya adalah true. |
features.network_proxy.dangerously_allow_all_unix_sockets |
boolean |
Mengizinkan tujuan soket Unix apa pun, bukan hanya akses berdasarkan daftar izin. Defaultnya adalah false; gunakan hanya dalam lingkungan yang dikontrol ketat. |
features.network_proxy.dangerously_allow_non_loopback_proxy |
boolean |
Mengizinkan alamat listener non-loopback. Defaultnya adalah false; mengaktifkannya dapat membuat listener proksi dapat diakses dari luar localhost. |
features.network_proxy.domains |
map<string, allow | deny> |
Kebijakan domain untuk jaringan dalam sandbox. Secara default tidak diatur, yang berarti tidak ada tujuan eksternal yang diizinkan hingga Anda menambahkan aturan allow. Mendukung host persis, *.example.com hanya untuk subdomain, **.example.com untuk domain induk beserta subdomain, dan aturan izin global *. Utamakan aturan dengan cakupan terbatas karena * membuka akses keluar publik secara luas. Tambahkan aturan deny untuk tujuan yang diblokir; deny diutamakan jika terjadi konflik. |
features.network_proxy.enable_socks5 |
boolean |
Menyediakan dukungan SOCKS5. Defaultnya adalah true. |
features.network_proxy.enable_socks5_udp |
boolean |
Mengizinkan UDP melalui SOCKS5. Defaultnya adalah true. |
features.network_proxy.enabled |
boolean |
Memulai proksi jaringan perintah dalam sandbox saat akses jaringan perintah diaktifkan. Defaultnya adalah false; aturan domain profil izin tidak diberlakukan saat proksi nonaktif. |
features.network_proxy.proxy_url |
string |
URL listener HTTP untuk jaringan dalam sandbox. Defaultnya adalah "http://127.0.0.1:3128". |
features.network_proxy.socks_url |
string |
URL listener SOCKS5. Defaultnya adalah "http://127.0.0.1:8081". |
features.network_proxy.unix_sockets |
map<string, allow | deny> |
Kebijakan soket Unix untuk jaringan dalam sandbox. Secara default tidak diatur; tambahkan entri allow untuk soket yang diizinkan. |
features.personality |
boolean |
Mengaktifkan kontrol pemilihan kepribadian (stabil; aktif secara default). |
features.prevent_idle_sleep |
boolean |
Mencegah mesin memasuki mode tidur saat giliran sedang berjalan (eksperimental; nonaktif secara default). |
features.remote_plugin |
boolean |
Mengaktifkan katalog plugin jarak jauh (stabil; aktif secara default). |
features.rollout_budget.enabled |
boolean |
Mengaktifkan pelacakan anggaran rollout. Fitur ini sedang dikembangkan dan nonaktif secara default. Jika diaktifkan, features.rollout_budget.limit_tokens diperlukan. |
features.rollout_budget.limit_tokens |
integer |
Batas token positif untuk pelacakan anggaran rollout. Diperlukan saat anggaran rollout diaktifkan. |
features.rollout_budget.prefill_token_weight |
number |
Pengali nonnegatif berhingga untuk token prefill dalam penghitungan anggaran rollout. Defaultnya adalah 1.0. |
features.rollout_budget.reminder_interval_tokens |
integer |
Interval token positif antara pengingat anggaran rollout. Defaultnya adalah 10% dari limit_tokens, dengan minimum 1 token. |
features.rollout_budget.sampling_token_weight |
number |
Pengali nonnegatif berhingga untuk token hasil sampling dalam penghitungan anggaran rollout. Defaultnya adalah 1.0. |
features.shell_snapshot |
boolean |
Membuat snapshot lingkungan shell untuk mempercepat perintah berulang (stabil; aktif secara default). |
features.shell_tool |
boolean |
Mengaktifkan alat default shell untuk menjalankan perintah (stabil; aktif secara default). |
features.skill_mcp_dependency_install |
boolean |
Mengizinkan permintaan dan pemasangan dependensi MCP yang belum tersedia untuk skill (stabil; aktif secara default). |
features.unified_exec |
boolean |
Menggunakan alat exec terpadu berbasis PTY (stabil; aktif secara default kecuali di Windows). |
features.web_search |
boolean |
Sakelar lama yang sudah usang; utamakan pengaturan tingkat teratas web_search. |
features.web_search_cached |
boolean |
Sakelar lama yang sudah usang. Jika web_search tidak diatur, true dipetakan ke web_search = "cached". |
features.web_search_request |
boolean |
Sakelar lama yang sudah usang. Jika web_search tidak diatur, true dipetakan ke web_search = "live". |
feedback.enabled |
boolean |
Mengaktifkan pengiriman masukan melalui /feedback di seluruh klien lokal (default: true). |
file_opener |
vscode | vscode-insiders | windsurf | cursor | none |
Skema URI yang digunakan untuk membuka sitasi dari keluaran Codex (default: vscode). |
forced_chatgpt_workspace_id |
string (uuid) |
Membatasi login ChatGPT ke pengenal ruang kerja tertentu. |
forced_login_method |
chatgpt | api |
Membatasi Codex ke metode autentikasi tertentu. |
hide_agent_reasoning |
boolean |
Menyembunyikan peristiwa penalaran dalam TUI maupun keluaran codex exec. |
history.max_bytes |
number |
Jika diatur, membatasi ukuran file riwayat dalam byte dengan membuang entri terlama. |
history.persistence |
save-all | none |
Mengontrol apakah Codex menyimpan transkrip sesi ke history.jsonl. |
hooks |
table |
Hook siklus hidup yang dikonfigurasi secara inline dalam config.toml. Menggunakan skema peristiwa yang sama seperti hooks.json; lihat panduan Hook untuk contoh dan peristiwa yang didukung. |
hooks.<Event> |
array<table> |
Grup pencocok untuk peristiwa hook seperti PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop, atau Interrupt. |
hooks.<Event>[].hooks |
array<table> |
Penangan hook untuk grup pencocok. Hook perintah dan alat MCP didukung, sedangkan penangan hook prompt dan agen diurai tetapi dilewati. |
hooks.<Event>[].hooks[].additionalContextLimit |
integer |
Perkiraan ambang token per penangan untuk menyimpan additionalContext yang terlalu besar ke disk dan menampilkan pratinjau yang lebih singkat kepada model. Defaultnya adalah 2500; 0 meneruskan konteks lengkap langsung ke model. Lihat Keluaran hook berukuran besar. |
hooks.<Event>[].hooks[].async |
boolean |
Menjalankan hook perintah di latar belakang tanpa menunda operasi pemicunya. Defaultnya adalah false; SessionEnd selalu berjalan secara sinkron. Lihat Menjalankan hook di latar belakang. |
hooks.<Event>[].hooks[].commandWindows |
string |
Penggantian perintah khusus Windows untuk hook perintah. Alias TOML command_windows juga diterima. |
instructions |
string |
Dicadangkan untuk penggunaan mendatang; utamakan model_instructions_file atau AGENTS.md. |
log_dir |
string (path) |
Direktori tempat Codex menulis file log; defaultnya adalah $CODEX_HOME/log. Mengaturnya secara eksplisit juga mengaktifkan log TUI teks biasa opsional, codex-tui.log, di direktori tersebut. |
marketplaces.<name>.ref |
string |
Branch, tag, atau commit Git opsional untuk marketplace. |
marketplaces.<name>.source |
string |
Lokasi repositori Git atau direktori root marketplace lokal. Gunakan jalur absolut untuk sumber lokal; direktori tersebut berisi .agents/plugins/marketplace.json. |
marketplaces.<name>.source_type |
git | local |
Jenis sumber untuk marketplace plugin yang dikonfigurasi. Marketplace dapat ditentukan dalam config.toml sistem, yang dikelola cloud, pengguna, atau proyek tepercaya. |
marketplaces.<name>.sparse_paths |
array<string> |
Jalur sparse checkout opsional untuk marketplace Git. Sertakan katalog marketplace dan direktori plugin lokal yang dirujuknya. |
mcp_oauth_callback_port |
integer |
Port tetap global opsional untuk server callback HTTP lokal yang digunakan selama login MCP OAuth. oauth.callback_port khusus server lebih diutamakan. Jika keduanya tidak diatur, Codex mengikat ke port sementara yang dipilih oleh OS. |
mcp_oauth_callback_url |
string |
URL callback dasar opsional untuk login MCP OAuth, seperti URL ingress devbox. Klien yang telah didaftarkan sebelumnya dan baru ditambahkan menggunakan URL ini tanpa perubahan jika server otorisasi mendukung identifikasi penerbit; klien yang sudah ada tanpa callback tersimpan menambahkan ID callback khusus server di akhir. Tanpa dukungan penerbit, setiap MCP server yang telah didaftarkan sebelumnya dan callback terkonfigurasinya tidak memiliki ID yang diperlukan akan menggunakan URL ini sebagai cadangan dengan ID ditambahkan di akhir. Port URL callback tidak menentukan port listener. |
mcp_oauth_credentials_store |
auto | file | keyring |
Penyimpanan pilihan untuk kredensial MCP OAuth. |
mcp_optional_startup_grace_ms |
integer (milliseconds) |
Waktu tunggu bersama untuk MCP server opsional saat menyusun katalog alat awal. Defaultnya adalah 1000. Atur ke 0 untuk menggunakan waktu tunggu startup_timeout_sec masing-masing server. |
mcp_servers.<id>.args |
array<string> |
Argumen yang diteruskan ke perintah STDIO MCP server. |
mcp_servers.<id>.auth |
oauth | chatgpt |
Autentikasi cadangan untuk HTTP MCP server setelah token bearer dan header otorisasi yang dikonfigurasi. oauth (default) menggunakan kredensial MCP OAuth tersimpan jika tersedia. chatgpt menggunakan sesi ChatGPT saat ini untuk origin ChatGPT pihak pertama yang tepercaya, lalu beralih ke OAuth tersimpan sebagai cadangan. Kedua mode dapat terhubung tanpa autentikasi jika tidak ada sumber kredensial yang dapat digunakan. |
mcp_servers.<id>.bearer_token_env_var |
string |
Variabel lingkungan yang menyediakan token bearer untuk HTTP MCP server. |
mcp_servers.<id>.command |
string |
Perintah peluncur untuk STDIO MCP server. |
mcp_servers.<id>.cwd |
string |
Direktori kerja untuk proses STDIO MCP server. |
mcp_servers.<id>.default_tools_approval_mode |
auto | prompt | writes | approve |
Perilaku persetujuan default untuk alat MCP di server ini, kecuali ada penggantian per alat. |
mcp_servers.<id>.disabled_tools |
array<string> |
Daftar penolakan yang diterapkan setelah enabled_tools untuk MCP server. |
mcp_servers.<id>.enabled |
boolean |
Menonaktifkan MCP server tanpa menghapus konfigurasinya. |
mcp_servers.<id>.enabled_tools |
array<string> |
Daftar izin nama alat yang disediakan oleh MCP server. |
mcp_servers.<id>.env |
map<string,string> |
Variabel lingkungan yang diteruskan ke STDIO MCP server. |
mcp_servers.<id>.env_http_headers |
map<string,string> |
Header HTTP yang diisi dari variabel lingkungan untuk HTTP MCP server. |
mcp_servers.<id>.env_vars |
array<string | { name = string, source = "local" | "remote" }> |
Variabel lingkungan tambahan yang dimasukkan ke daftar izin untuk STDIO MCP server. Entri string secara default menggunakan source = "local"; gunakan source = "remote" hanya dengan stdio jarak jauh berbasis eksekutor. |
mcp_servers.<id>.experimental_environment |
local | remote |
Penempatan eksperimental untuk MCP server. remote memulai server stdio melalui lingkungan eksekutor jarak jauh; penempatan jarak jauh streamable HTTP belum diimplementasikan. |
mcp_servers.<id>.http_headers |
map<string,string> |
Header HTTP statis yang disertakan dalam setiap permintaan MCP HTTP. |
mcp_servers.<id>.http_headers_helper |
string (command) |
Perintah lokal yang mencetak objek JSON berisi nama dan nilai header HTTP. Hanya didukung untuk HTTP MCP server yang terhubung secara lokal. Token bearer eksplisit dan kredensial OAuth lebih diutamakan daripada header Authorization yang disediakan oleh pembantu. |
mcp_servers.<id>.oauth_resource |
string |
Parameter sumber daya OAuth RFC 8707 opsional yang disertakan selama login MCP. |
mcp_servers.<id>.oauth.callback_port |
integer |
Port listener callback OAuth tetap untuk MCP server ini. Menggantikan mcp_oauth_callback_port. Untuk callback loopback langsung dengan port URL eksplisit, konfigurasikan port listener yang sama. |
mcp_servers.<id>.oauth.callback_url |
string |
Callback OAuth khusus server. Klien yang telah didaftarkan sebelumnya menggunakannya kembali jika identifikasi penerbit didukung atau URL sudah diakhiri dengan ID callback khusus server. Jika tidak, Codex menggunakan callback global atau default dengan ID tersebut ditambahkan di akhir. Klien tanpa ID yang telah didaftarkan sebelumnya menggunakan callback ini selama pendaftaran klien. |
mcp_servers.<id>.oauth.client_id |
string |
ID klien OAuth yang telah didaftarkan sebelumnya, digunakan untuk otorisasi dan pertukaran token dengan MCP server ini. |
mcp_servers.<id>.required |
boolean |
Jika true, menggagalkan startup/pelanjutan jika MCP server yang diaktifkan ini tidak dapat diinisialisasi. |
mcp_servers.<id>.scopes |
array<string> |
Cakupan OAuth yang diminta saat melakukan autentikasi ke MCP server tersebut. |
mcp_servers.<id>.startup_timeout_ms |
number |
Alias untuk startup_timeout_sec dalam milidetik. |
mcp_servers.<id>.startup_timeout_sec |
number |
Mengganti batas waktu startup default 10 detik untuk MCP server. |
mcp_servers.<id>.tool_timeout_sec |
number |
Mengganti batas waktu default 60 detik per alat untuk MCP server. |
mcp_servers.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Penggantian perilaku persetujuan per alat untuk satu alat MCP di server ini. |
mcp_servers.<id>.tools.<tool>.output_token_limit |
integer (positive) |
Anggaran token untuk keluaran satu alat MCP, sebelum tambahan serialisasi standar sebesar 20%. Menggantikan anggaran pemotongan keluaran default model untuk alat tersebut. |
mcp_servers.<id>.url |
string |
Endpoint untuk Streamable HTTP MCP server. |
memories.consolidation_model |
string |
Penggantian model opsional untuk konsolidasi memori global. |
memories.disable_on_external_context |
boolean |
Jika true, utas yang menggunakan konteks eksternal seperti pemanggilan alat MCP, pencarian web, atau pencarian alat dikecualikan dari pembuatan memori. Defaultnya adalah false. Alias lama: memories.no_memories_if_mcp_or_web_search. |
memories.extract_model |
string |
Penggantian model opsional untuk ekstraksi memori per utas. |
memories.generate_memories |
boolean |
Jika false, utas yang baru dibuat tidak disimpan sebagai masukan pembuatan memori. Defaultnya adalah true. |
memories.max_raw_memories_for_consolidation |
number |
Jumlah maksimum memori mentah terbaru yang dipertahankan untuk konsolidasi global. Defaultnya adalah 256 dan dibatasi hingga 4096. |
memories.max_rollout_age_days |
number |
Usia maksimum utas yang dipertimbangkan untuk pembuatan memori. Defaultnya adalah 30 dan dibatasi pada rentang 0-90. |
memories.max_rollouts_per_startup |
number |
Jumlah maksimum kandidat rollout yang diproses per putaran startup. Defaultnya adalah 16 dan dibatasi hingga 128. |
memories.max_unused_days |
number |
Jumlah hari maksimum sejak memori terakhir digunakan sebelum tidak lagi memenuhi syarat untuk konsolidasi. Defaultnya adalah 30 dan dibatasi pada rentang 0-365. |
memories.min_rate_limit_remaining_percent |
number |
Persentase sisa minimum yang diperlukan dalam jendela batas laju Codex sebelum pembuatan memori dimulai. Defaultnya adalah 25 dan dibatasi pada rentang 0-100. |
memories.min_rollout_idle_hours |
number |
Waktu tidak aktif minimum sebelum utas dipertimbangkan untuk pembuatan memori. Defaultnya adalah 6 dan dibatasi pada rentang 1-48. |
memories.use_memories |
boolean |
Jika false, Codex melewati penyisipan memori yang ada ke sesi mendatang. Defaultnya adalah true. |
model |
string |
Model yang digunakan (misalnya, gpt-6.1-sol). |
model_auto_compact_token_limit |
number |
Ambang token yang memicu pemadatan riwayat otomatis (jika tidak diatur, menggunakan default model). |
model_auto_compact_token_limit_scope |
total | body_after_prefix |
Mengontrol apakah ambang pemadatan otomatis menghitung seluruh konteks aktif (total, default) atau hanya pertumbuhan setelah prefiks jendela pemadatan yang diteruskan (body_after_prefix). |
model_catalog_json |
string (path) |
Jalur opsional ke katalog model JSON yang dimuat saat startup. File profil $CODEX_HOME/profile-name.config.toml yang dipilih dapat menggantinya untuk setiap profil. |
model_context_window |
number |
Jumlah token jendela konteks yang tersedia untuk model aktif. |
model_instructions_file |
string (path) |
Pengganti instruksi bawaan sebagai alternatif untuk AGENTS.md. |
model_provider |
string |
ID penyedia dari model_providers (default: openai). |
model_providers.<id> |
table |
Definisi penyedia kustom. ID penyedia bawaan (openai, ollama, dan lmstudio) dicadangkan dan tidak dapat diganti. |
model_providers.<id>.auth |
table |
Konfigurasi token bearer berbasis perintah untuk penyedia kustom. Jangan gabungkan dengan env_key, experimental_bearer_token, atau requires_openai_auth. |
model_providers.<id>.auth.args |
array<string> |
Argumen yang diteruskan ke perintah token. |
model_providers.<id>.auth.command |
string |
Perintah yang dijalankan saat Codex memerlukan token bearer. Perintah harus mencetak token ke stdout. |
model_providers.<id>.auth.cwd |
string (path) |
Direktori kerja untuk perintah token. |
model_providers.<id>.auth.refresh_interval_ms |
number |
Interval penyegaran token secara proaktif oleh Codex dalam milidetik (default: 300000). Atur ke 0 untuk menyegarkan hanya setelah percobaan ulang autentikasi. |
model_providers.<id>.auth.timeout_ms |
number |
Waktu eksekusi maksimum perintah token dalam milidetik (default: 5000). |
model_providers.<id>.base_url |
string |
URL dasar API untuk penyedia model. |
model_providers.<id>.env_http_headers |
map<string,string> |
Header HTTP yang diisi dari variabel lingkungan jika tersedia. |
model_providers.<id>.env_key |
string |
Variabel lingkungan yang menyediakan API key penyedia. |
model_providers.<id>.env_key_instructions |
string |
Panduan penyiapan opsional untuk API key penyedia. |
model_providers.<id>.experimental_bearer_token |
string |
Token bearer langsung untuk penyedia (tidak disarankan; gunakan env_key). |
model_providers.<id>.http_headers |
map<string,string> |
Header HTTP statis yang ditambahkan ke permintaan penyedia. |
model_providers.<id>.name |
string |
Nama tampilan untuk penyedia model kustom. |
model_providers.<id>.query_params |
map<string,string> |
Parameter kueri tambahan yang ditambahkan ke permintaan penyedia. |
model_providers.<id>.request_max_retries |
number |
Jumlah percobaan ulang untuk permintaan HTTP ke penyedia (default: 4). |
model_providers.<id>.requires_openai_auth |
boolean |
Penyedia menggunakan autentikasi OpenAI (defaultnya false). |
model_providers.<id>.stream_idle_timeout_ms |
number |
Batas waktu tidak aktif untuk aliran SSE dalam milidetik (default: 300000). |
model_providers.<id>.stream_max_retries |
number |
Jumlah percobaan ulang untuk gangguan streaming SSE (default: 5). |
model_providers.<id>.supports_standalone_web_search |
boolean |
Menyatakan dukungan untuk endpoint pencarian web mandiri yang kompatibel (default: false). Pencarian mandiri masih dalam pengembangan dan nonaktif secara default; kompatibilitas penyedia saja tidak mengaktifkannya. |
model_providers.<id>.supports_websockets |
boolean |
Menentukan apakah penyedia tersebut mendukung transport WebSocket Responses API. |
model_providers.<id>.wire_api |
responses |
Protokol yang digunakan oleh penyedia. responses adalah satu-satunya nilai yang didukung dan menjadi default jika tidak dicantumkan. |
model_providers.amazon-bedrock.aws.profile |
string |
Nama profil AWS yang digunakan oleh penyedia bawaan amazon-bedrock. |
model_providers.amazon-bedrock.aws.region |
string |
Wilayah AWS yang digunakan oleh penyedia bawaan amazon-bedrock. |
model_reasoning_effort |
string |
Upaya penalaran yang dinyatakan tersedia oleh model terpilih, seperti low, medium, high, xhigh, max, atau ultra. Tingkat yang tersedia bergantung pada model dan klien. |
model_reasoning_summary |
auto | concise | detailed | none |
Memilih tingkat detail ringkasan penalaran atau menonaktifkan ringkasan sepenuhnya. |
model_supports_reasoning_summaries |
boolean |
Memaksa Codex untuk mengirim atau tidak mengirim metadata penalaran. |
model_verbosity |
low | medium | high |
Penggantian tingkat kerincian GPT-5 Responses API opsional; jika tidak diatur, default model/preset terpilih digunakan. |
notice.hide_full_access_warning |
boolean |
Melacak konfirmasi permintaan peringatan akses penuh. |
notice.hide_gpt-5.1-codex-max_migration_prompt |
boolean |
Melacak konfirmasi permintaan migrasi gpt-5.1-codex-max. |
notice.hide_gpt5_1_migration_prompt |
boolean |
Melacak konfirmasi permintaan migrasi GPT-5.1. |
notice.hide_rate_limit_model_nudge |
boolean |
Melacak pilihan untuk menonaktifkan pengingat pergantian model akibat batas laju. |
notice.hide_world_writable_warning |
boolean |
Melacak konfirmasi peringatan direktori Windows yang dapat ditulisi oleh semua pengguna. |
notice.model_migrations |
map<string,string> |
Melacak migrasi model yang telah dikonfirmasi sebagai pemetaan lama->baru. |
notify |
array<string> |
Perintah yang dipanggil untuk notifikasi; menerima payload JSON dari Codex. |
openai_base_url |
string |
Penggantian URL dasar untuk penyedia model bawaan openai. |
oss_provider |
lmstudio | ollama |
Penyedia lokal default yang digunakan saat menjalankan dengan --oss (secara default meminta pilihan jika tidak diatur). |
otel.environment |
string |
Tag lingkungan yang diterapkan pada peristiwa OpenTelemetry yang dihasilkan (default: dev). |
otel.exporter |
none | otlp-http | otlp-grpc |
Memilih pengekspor OpenTelemetry dan menyediakan metadata endpoint yang diperlukan. |
otel.exporter.<id>.endpoint |
string |
Endpoint pengekspor untuk log OTEL. |
otel.exporter.<id>.headers |
map<string,string> |
Header statis yang disertakan dalam permintaan pengekspor OTEL. |
otel.exporter.<id>.protocol |
binary | json |
Protokol yang digunakan oleh pengekspor OTLP/HTTP. |
otel.exporter.<id>.tls.ca-certificate |
string |
Jalur sertifikat CA untuk TLS pengekspor OTEL. |
otel.exporter.<id>.tls.client-certificate |
string |
Jalur sertifikat klien untuk TLS pengekspor OTEL. |
otel.exporter.<id>.tls.client-private-key |
string |
Jalur kunci privat klien untuk TLS pengekspor OTEL. |
otel.log_user_prompt |
boolean |
Mengaktifkan ekspor prompt pengguna mentah bersama log OpenTelemetry. |
otel.metrics_exporter |
none | statsig | otlp-http | otlp-grpc |
Memilih pengekspor metrik OpenTelemetry (defaultnya statsig). |
otel.trace_exporter |
none | otlp-http | otlp-grpc |
Memilih pengekspor trace OpenTelemetry dan menyediakan metadata endpoint yang diperlukan. |
otel.trace_exporter.<id>.endpoint |
string |
Endpoint pengekspor trace untuk log OTEL. |
otel.trace_exporter.<id>.headers |
map<string,string> |
Header statis yang disertakan dalam permintaan pengekspor trace OTEL. |
otel.trace_exporter.<id>.protocol |
binary | json |
Protokol yang digunakan oleh pengekspor trace OTLP/HTTP. |
otel.trace_exporter.<id>.tls.ca-certificate |
string |
Jalur sertifikat CA untuk TLS pengekspor trace OTEL. |
otel.trace_exporter.<id>.tls.client-certificate |
string |
Jalur sertifikat klien untuk TLS pengekspor trace OTEL. |
otel.trace_exporter.<id>.tls.client-private-key |
string |
Jalur kunci privat klien untuk TLS pengekspor trace OTEL. |
permissions.<name>.description |
string |
Deskripsi yang mudah dibaca untuk profil bernama ini. Profil tidak mewarisi deskripsi induknya melalui extends. |
permissions.<name>.extends |
string |
Profil induk opsional yang diterapkan sebelum profil bernama ini. Atur ke profil bernama lain, :read-only, atau :workspace; :danger-full-access, induk yang tidak ditentukan, dan siklus ditolak. |
permissions.<name>.filesystem |
table |
Profil izin sistem file bernama. Setiap kunci berupa jalur absolut atau token khusus seperti :minimal atau :workspace_roots. |
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> |
"read" | "write" | "deny" |
Akses sistem file dengan cakupan relatif terhadap setiap direktori root ruang kerja yang berlaku. Gunakan "." untuk root itu sendiri; subjalur glob seperti "**/*.env" dapat menolak pembacaan dengan "deny". |
permissions.<name>.filesystem.<path-or-glob> |
"read" | "write" | "deny" | table |
Memberikan akses langsung untuk jalur, pola glob, atau token khusus, atau membatasi cakupan entri bertingkat di bawah root tersebut. Gunakan "deny" untuk menolak pembacaan pada jalur yang cocok. |
permissions.<name>.filesystem.glob_scan_max_depth |
number |
Kedalaman maksimum untuk memperluas pola glob penolakan baca pada platform yang membuat snapshot kecocokan sebelum startup sandbox. Jika diatur, nilainya harus minimal 1. |
permissions.<name>.network.allow_local_binding |
boolean |
Mengizinkan akses jaringan lokal/privat yang lebih luas melalui jaringan dalam sandbox. Aturan izin literal IP lokal persis atau localhost tetap dapat mengizinkan target lokal tertentu saat nilai ini tetap false. |
permissions.<name>.network.allow_upstream_proxy |
boolean |
Mengizinkan jaringan dalam sandbox dirantai melalui proksi upstream lain. |
permissions.<name>.network.dangerously_allow_all_unix_sockets |
boolean |
Mengizinkan tujuan soket Unix apa pun sebagai pengganti kumpulan terbatas default. Gunakan hanya dalam lingkungan yang dikontrol ketat. |
permissions.<name>.network.dangerously_allow_non_loopback_proxy |
boolean |
Mengizinkan alamat pengikatan non-loopback untuk listener jaringan dalam sandbox. Mengaktifkannya dapat membuat listener dapat diakses dari luar localhost. |
permissions.<name>.network.domains |
table |
Aturan domain untuk perintah dalam sandbox. Hanya diberlakukan saat features.network_proxy atau persyaratan jaringan yang dikelola administrator dan diaktifkan mengaktifkan proksi. Mendukung host persis, *.example.com, **.example.com, dan aturan izin global *; deny diutamakan. Tidak membatasi pencarian web, aplikasi, atau MCP server. |
permissions.<name>.network.domains.<pattern> |
allow | deny |
Mengizinkan atau menolak host persis atau pola wildcard dengan cakupan terbatas seperti *.example.com atau **.example.com. |
permissions.<name>.network.enable_socks5 |
boolean |
Menyediakan dukungan SOCKS5 saat profil izin ini mengaktifkan jaringan dalam sandbox. |
permissions.<name>.network.enable_socks5_udp |
boolean |
Mengizinkan UDP melalui listener SOCKS5 saat diaktifkan. |
permissions.<name>.network.enabled |
boolean |
Mengaktifkan akses jaringan untuk perintah dalam profil izin ini. Ini tidak memulai proksi jaringan. Tanpa features.network_proxy atau persyaratan jaringan yang dikelola administrator dan diaktifkan, akses jaringan perintah bersifat langsung dan aturan domain profil tidak diberlakukan. |
permissions.<name>.network.mode |
limited | full |
Mode proksi jaringan yang digunakan untuk lalu lintas subproses. |
permissions.<name>.network.proxy_url |
string |
URL listener HTTP yang digunakan saat profil izin ini mengaktifkan jaringan dalam sandbox. |
permissions.<name>.network.socks_url |
string |
Endpoint proksi SOCKS5 yang digunakan oleh profil izin ini. |
permissions.<name>.network.unix_sockets |
table |
Penggantian daftar izin soket Unix untuk jaringan dalam sandbox. Gunakan jalur soket sebagai kunci; allow menambahkan jalur, dan deny menolaknya. |
permissions.<name>.network.unix_sockets.<path> |
allow | deny |
Menambahkan jalur soket Unix absolut ke daftar izin yang berlaku dengan allow, atau menolaknya dengan deny. Entri yang ditolak tidak disertakan dalam daftar izin yang berlaku. |
permissions.<name>.workspace_roots |
table |
Direktori root ruang kerja yang ditentukan profil dan menerima aturan sistem file :workspace_roots bersama direktori root ruang kerja runtime sesi. |
permissions.<name>.workspace_roots.<path> |
boolean |
Memasukkan jalur ke kumpulan direktori root ruang kerja profil saat true. Entri yang dinonaktifkan tetap tidak aktif. |
personality |
none | friendly | pragmatic |
Gaya komunikasi default untuk model yang menyatakan dukungan supportsPersonality; dapat diganti per utas/giliran atau melalui /personality. |
plan_mode_reasoning_effort |
string |
Penggantian penalaran khusus mode Plan menggunakan tingkat yang didukung oleh model terpilih. Jika tidak diatur, mode Plan menggunakan default preset bawaannya. |
plugins.<plugin>.enabled |
boolean |
Mengaktifkan atau menonaktifkan plugin marketplace lokal menggunakan kunci plugin-name@marketplace-name. Dibaca dari konfigurasi gabungan yang berlaku; pengaturan proyek tepercaya dapat menggantikan default pengguna, yang dikelola cloud, dan sistem. Penyegaran marketplace dapat memasang atau menyegarkan plugin yang dikonfigurasi meskipun dinonaktifkan. Ini tidak menggantikan status pengaktifan yang dikelola ruang kerja. |
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode |
auto | prompt | writes | approve |
Perilaku persetujuan default untuk alat pada MCP server yang disediakan plugin. |
plugins.<plugin>.mcp_servers.<server>.disabled_tools |
array<string> |
Daftar penolakan yang diterapkan setelah enabled_tools untuk MCP server yang disediakan plugin. |
plugins.<plugin>.mcp_servers.<server>.enabled |
boolean |
Mengaktifkan atau menonaktifkan MCP server yang disertakan oleh plugin terpasang tanpa mengubah manifes plugin. |
plugins.<plugin>.mcp_servers.<server>.enabled_tools |
array<string> |
Daftar izin alat yang disediakan dari MCP server yang disediakan plugin. |
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Penggantian perilaku persetujuan per alat untuk alat MCP yang disediakan plugin. |
project_doc_fallback_filenames |
array<string> |
Nama file tambahan yang dicoba jika AGENTS.md tidak ada. |
project_doc_max_bytes |
number |
Jumlah byte maksimum yang dibaca dari AGENTS.md saat menyusun instruksi proyek. |
project_root_markers |
array<string> |
Daftar nama file penanda root proyek; digunakan saat mencari root proyek di direktori induk. |
projects.<path>.trust_level |
string |
Menandai proyek atau worktree sebagai tepercaya atau tidak tepercaya ("trusted" | "untrusted"). Proyek yang tidak tepercaya melewati lapisan .codex/ dengan cakupan proyek, termasuk konfigurasi, hook, dan aturan lokal proyek. |
review_model |
string |
Penggantian model opsional yang digunakan oleh /review (secara default menggunakan model sesi saat ini). |
sandbox_mode |
read-only | workspace-write | danger-full-access |
Kebijakan sandbox untuk akses sistem file dan jaringan selama eksekusi perintah. |
sandbox_workspace_write.exclude_slash_tmp |
boolean |
Mengecualikan /tmp dari direktori root yang dapat ditulisi dalam mode workspace-write. |
sandbox_workspace_write.exclude_tmpdir_env_var |
boolean |
Mengecualikan $TMPDIR dari direktori root yang dapat ditulisi dalam mode workspace-write. |
sandbox_workspace_write.network_access |
boolean |
Mengizinkan akses jaringan keluar di dalam sandbox workspace-write. |
sandbox_workspace_write.writable_roots |
array<string> |
Direktori root tambahan yang dapat ditulisi saat sandbox_mode = "workspace-write". |
service_tier |
string |
Tingkat layanan pilihan untuk giliran baru. Gunakan fast atau tingkat lain yang dinyatakan tersedia oleh model aktif; fast dipetakan ke nilai permintaan priority. |
shell_environment_policy.exclude |
array<string> |
Pola pengecualian variabel lingkungan lama. Gunakan shell_environment_policy.filters untuk konfigurasi baru; jangan gabungkan kedua bentuk dalam lapisan yang sama. |
shell_environment_policy.experimental_use_profile |
boolean |
Menggunakan profil shell pengguna saat membuat subproses. |
shell_environment_policy.filters |
map<string, include | exclude> |
Filter pola variabel lingkungan kanonis yang tidak membedakan huruf besar dan kecil. Entri penyertaan membuat daftar izin dan tidak dapat memulihkan nilai yang dikecualikan. Nilai set eksplisit diterapkan setelah pengecualian. Jangan gabungkan filter dengan array lama exclude atau include_only dalam lapisan yang sama. |
shell_environment_policy.ignore_default_excludes |
boolean |
Mempertahankan variabel yang mengandung KEY, SECRET, atau TOKEN sebelum filter lain dijalankan (default: true). Atur ke false untuk menerapkan pengecualian otomatis berdasarkan nama rahasia. |
shell_environment_policy.include_only |
array<string> |
Daftar izin pola variabel lingkungan lama. Gunakan shell_environment_policy.filters untuk konfigurasi baru; jangan gabungkan kedua bentuk dalam lapisan yang sama. |
shell_environment_policy.inherit |
all | core | none |
Pewarisan lingkungan dasar saat membuat subproses. |
shell_environment_policy.set |
map<string,string> |
Nilai lingkungan eksplisit yang disisipkan setelah pengecualian; filter penyertaan masih dapat menghapusnya. |
show_raw_agent_reasoning |
boolean |
Menampilkan konten penalaran mentah saat model aktif menghasilkannya. |
skills.config |
array<object> |
Penggantian status pengaktifan per skill yang disimpan dalam config.toml. |
skills.config.<index>.enabled |
boolean |
Mengaktifkan atau menonaktifkan skill yang dirujuk. |
skills.config.<index>.path |
string (path) |
Jalur ke folder skill yang berisi SKILL.md. |
skills.max_context_tokens |
integer (positive) |
Anggaran token untuk katalog skill yang tersedia. Defaultnya adalah 2% dari jendela konteks model. Nilai eksplisit dibatasi hingga 10000 token. |
sqlite_home |
string (path) |
Direktori tempat Codex menyimpan basis data status berbasis SQLite yang digunakan oleh tugas agen dan status runtime lain yang dapat dilanjutkan. |
suppress_unstable_features_warning |
boolean |
Menyembunyikan peringatan yang muncul saat flag fitur yang sedang dikembangkan diaktifkan. |
tool_output_token_limit |
number |
Anggaran token untuk menyimpan keluaran setiap alat/fungsi dalam riwayat. |
tool_suggest.disabled_tools |
array<table> |
Menonaktifkan saran untuk konektor atau plugin tertentu yang dapat ditemukan. Setiap entri menggunakan type = "connector" atau "plugin" serta id. |
tool_suggest.discoverables |
array<table> |
Mengizinkan saran alat untuk konektor atau plugin tambahan yang dapat ditemukan. Setiap entri menggunakan type = "connector" atau "plugin" serta id. |
tools.view_image |
boolean |
Mengaktifkan alat lampiran gambar lokal view_image. |
tools.web_search |
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } |
Konfigurasi alat pencarian web opsional. Bentuk objek dapat mengatur ukuran konteks pencarian, domain pencarian yang diizinkan, dan perkiraan lokasi pengguna. Filter domain pencarian ini terpisah dari aturan domain jaringan perintah dalam sandbox dan tidak membatasi konektor atau MCP server. |
tui |
table |
Opsi khusus TUI, seperti mengaktifkan notifikasi desktop inline. |
tui.alternate_screen |
auto | always | never |
Mengontrol penggunaan layar alternatif untuk TUI (default: auto; auto melewatinya di Zellij untuk mempertahankan riwayat gulir). |
tui.animations |
boolean |
Mengaktifkan animasi terminal (layar sambutan, efek kilau, indikator berputar) (default: true). |
tui.keymap.<context>.<action> |
string | array<string> |
Pemetaan pintasan keyboard untuk tindakan TUI. Konteks yang didukung meliputi global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list, dan approval. Tindakan editor pesan tertentu menggunakan pemetaan tui.keymap.global yang sesuai sebagai cadangan; pemetaan khusus konteks lebih diutamakan jika didukung. |
tui.keymap.<context>.<action> = [] |
empty array |
Menghapus pemetaan tindakan dalam konteks peta tombol tersebut. Nama tombol menggunakan string yang dinormalisasi seperti ctrl-a, shift-enter, page-down, atau minus. |
tui.model_availability_nux.<model> |
integer |
Status internal tooltip startup dengan slug model sebagai kunci. |
tui.notification_condition |
unfocused | always |
Mengontrol apakah notifikasi TUI hanya dipicu saat terminal tidak memiliki fokus atau terlepas dari fokus. Defaultnya adalah unfocused. |
tui.notification_method |
auto | osc9 | bel |
Metode notifikasi untuk notifikasi terminal (default: auto). |
tui.notifications |
boolean | array<string> |
Mengaktifkan notifikasi TUI; secara opsional membatasinya pada jenis peristiwa tertentu. |
tui.raw_output_mode |
boolean |
Memulai TUI dalam mode riwayat gulir mentah agar teks terminal mudah dipilih untuk disalin (default: false). Anda dapat mengalihkannya dengan /raw atau pintasan tombol default alt-r. |
tui.resume_cwd |
current | session |
Direktori kerja yang digunakan saat melanjutkan atau membuat cabang sesi. Jika tidak diatur, Codex meminta Anda memilih jika direktori saat ini berbeda dari direktori sesi yang tersimpan. |
tui.show_tooltips |
boolean |
Menampilkan tooltip pengenalan pada layar sambutan TUI (default: true). |
tui.status_line |
array<string> | null |
Daftar berurutan pengenal item baris status footer TUI. null menonaktifkan baris status. |
tui.terminal_title |
array<string> | null |
Daftar berurutan pengenal item judul jendela/tab terminal. Defaultnya adalah ["spinner", "project"]; null menonaktifkan pembaruan judul. |
tui.theme |
string |
Penggantian tema penyorotan sintaks (nama tema dalam kebab-case). |
tui.vim_mode_default |
boolean |
Memulai editor pesan dalam mode normal Vim alih-alih mode penyisipan (default: false). Anda tetap dapat mengalihkannya per sesi dengan /vim. |
web_search |
disabled | cached | indexed | live |
Mode pencarian web (default: "cached"; cached menggunakan indeks yang dikelola OpenAI tanpa akses web eksternal; indexed mengizinkan akses eksternal hanya jika diizinkan oleh indeks pencarian; jika Anda menggunakan --yolo atau pengaturan sandbox akses penuh lainnya, defaultnya menjadi "live"). Gunakan "live" untuk pengambilan langsung tanpa pembatasan, atau "disabled" untuk menghapus alat. |
windows_wsl_setup_acknowledged |
boolean |
Melacak konfirmasi pengenalan Windows (khusus Windows). |
windows.sandbox |
unelevated | elevated | mxc |
Mode sandbox native khusus Windows saat menjalankan Codex secara native di Windows. |
Tidak ada opsi konfigurasi yang cocok.
Anda dapat menemukan skema JSON terbaru untuk config.toml di sini.
Untuk mendapatkan pelengkapan otomatis dan diagnostik saat mengedit config.toml di VS Code atau Cursor, Anda dapat menginstal ekstensi Even Better TOML dan menambahkan baris ini di bagian atas config.toml Anda:
#:schema https://developers.openai.com/codex/config-schema.jsonCatatan: Ganti nama experimental_instructions_file menjadi model_instructions_file. Codex menghentikan penggunaan kunci lama tersebut; perbarui konfigurasi yang ada agar menggunakan nama baru.
requirements.toml
requirements.toml adalah file konfigurasi yang diberlakukan oleh administrator dan membatasi pengaturan sensitif terhadap keamanan yang tidak dapat ditimpa oleh pengguna. Untuk detail, lokasi, dan contoh, lihat Persyaratan yang diberlakukan administrator.
Bagi pengguna ChatGPT Business dan Enterprise, Codex juga dapat menerapkan persyaratan yang diambil dari cloud. Lihat halaman keamanan untuk mengetahui detail urutan prioritas.
Gunakan [features] di requirements.toml untuk menetapkan flag fitur runtime berdasarkan
kunci kanonis yang sama dengan yang digunakan config.toml. Persyaratan juga dapat mencakup kunci
khusus aplikasi terdokumentasi yang tidak termasuk dalam config.toml. Kunci yang tidak dicantumkan tetap
tidak dibatasi.
Beberapa persyaratan terkelola memberlakukan nilai konfigurasi yang persis sama, bukan daftar yang diizinkan. Pengguna tidak dapat menimpa jalur, preferensi pembaruan, kebijakan shell login, pengaturan umpan balik, atau pengaturan desktop privat Windows yang diberlakukan.
Daftar profil izin terkelola yang diizinkan memerlukan Codex 0.138.0 atau yang lebih baru. Codex
0.137.0 dan versi sebelumnya mengabaikan allowed_permission_profiles serta
default_permissions terkelola.
Gunakan allowed_sandbox_modes bersama sandbox_mode. Untuk deployment profil izin,
gunakan allowed_permission_profiles bersama
default_permissions terkelola.
Entri untrusted dalam allowed_approval_policies tetap valid untuk
perilaku persetujuan yang lebih ketat yang diterapkan Codex saat proyek menggunakan
trust_level = "untrusted". Entri ini tidak mengizinkan pengaturan
approval_policy = "untrusted" secara eksplisit.
Tabel [models.new_thread] menyediakan nilai default terkelola, bukan aturan yang wajib dipatuhi.
Jika Anda secara eksplisit mengganti model atau upaya penalaran dengan --model,
--config, atau --profile, Codex mengabaikan baik model maupun
model_reasoning_effort dalam [models.new_thread]. service_tier bersifat independen.
Persyaratan browser mencakup tiga permukaan yang terpisah. in_app_browser
mengontrol panel browser yang dibuka dan digunakan langsung oleh seseorang. browser_use
mengontrol pekerjaan yang dijalankan agen di browser. computer_use mengontrol pekerjaan yang dijalankan agen
di aplikasi desktop native.
Nilai kebijakan Browser Use dan Computer Use yang bersarang tidak memberikan akses dengan
sendirinya. allow khusus origin atau aplikasi dapat menggantikan nilai fallback untuk
sumber kebijakan yang sama, tetapi pemeriksaan fitur, persetujuan, dan kebijakan lainnya
tetap berlaku. Jika persyaratan terkelola dan config.toml sama-sama berlaku, deny
dari salah satunya akan diprioritaskan.
| Kunci | Tipe / nilai | Detail |
|---|---|---|
additional_developer_instructions |
string |
Instruksi pengembang terkelola yang ditambahkan sebagai pesan pengembang terpisah. Codex menolak instruksi yang melampaui batas perkiraan 10.000 token, termasuk penanda konteks. |
allow_appshots |
boolean |
Tetapkan ke false untuk menonaktifkan Appshots bagi pengguna terkelola. Jika dihilangkan, Appshots tetap tidak dibatasi oleh persyaratan dan mengikuti ketersediaan produk normal. |
allow_browser_and_computer_use |
boolean |
Tetapkan ke false untuk memblokir Browser Use yang dijalankan agen dan Computer Use pada aplikasi native. Menetapkannya ke true atau menghilangkannya tidak mengaktifkan salah satu fitur tersebut; pemeriksaan fitur, kebijakan, dan persetujuan lainnya tetap berlaku. |
allow_login_shell |
boolean |
Tetapkan apakah alat shell dapat memulai shell login. |
allow_managed_hooks_only |
boolean |
Ketika true, Codex melewati hook pengguna, proyek, sesi, dan plugin, tetapi tetap mengizinkan hook terkelola dari requirements.toml dan lapisan konfigurasi terkelola lainnya. |
allow_remote_control |
boolean |
Tetapkan ke false untuk menonaktifkan kendali jarak jauh perangkat bagi pengguna terkelola. Jika dihilangkan, kendali jarak jauh perangkat tetap tidak dibatasi oleh persyaratan dan mengikuti ketersediaan produk normal. |
allowed_approval_policies |
array<string> |
Kebijakan persetujuan yang diizinkan, seperti on-request, never, dan granular. Sertakan untrusted untuk mengizinkan kebijakan yang lebih ketat yang berasal dari proyek tidak tepercaya; kebijakan ini tidak dapat dipilih langsung dengan approval_policy. |
allowed_approvals_reviewers |
array<string> |
Nilai yang diizinkan untuk approvals_reviewer, seperti user dan auto_review. |
allowed_chatgpt_workspaces |
array<string> |
Batasi login ChatGPT, termasuk token akses Codex, ke ID ruang kerja yang tercantum. Daftar kosong menonaktifkan login ChatGPT; autentikasi API tetap tersedia jika diizinkan. Tetapkan melalui file persyaratan sistem lokal atau MDM macOS; nilai yang dikelola melalui cloud diabaikan. |
allowed_login_methods |
array<string> |
Izinkan chatgpt, api, atau keduanya. Jika dihilangkan, pengaturan ini tidak membatasi metode login. Jika ditetapkan, daftar harus berisi setidaknya satu metode. api mengizinkan autentikasi API, termasuk Amazon Bedrock. Tetapkan melalui file persyaratan sistem lokal atau MDM macOS. Nilai yang dikelola melalui cloud diabaikan. |
allowed_permission_profiles |
table<boolean> |
Daftar lengkap profil izin yang diizinkan. Profil yang ditetapkan ke true diizinkan. Profil yang tidak dicantumkan atau ditetapkan ke false ditolak, termasuk profil yang ditambahkan pada versi mendatang. Saat sumber persyaratan digabungkan, entri dicocokkan berdasarkan nama profil. |
allowed_permission_profiles.<name> |
boolean |
Izinkan atau tolak profil izin bawaan atau kustom yang ditentukan dalam konfigurasi atau sumber persyaratan yang dimuat. Sumber persyaratan berikutnya yang berprioritas lebih tinggi dapat menggunakan false untuk menonaktifkan profil yang diizinkan oleh sumber sebelumnya yang berprioritas lebih rendah. |
allowed_sandbox_modes |
array<string> |
Nilai yang diizinkan untuk sandbox_mode. |
allowed_web_search_modes |
array<string> |
Nilai yang diizinkan untuk web_search (disabled, cached, indexed, live). disabled selalu diizinkan; daftar kosong secara efektif hanya mengizinkan disabled. |
apps |
table |
Persyaratan aplikasi terkelola dengan pengenal aplikasi sebagai kunci. Persyaratan dapat menonaktifkan aplikasi atau membatasi perilaku persetujuan untuk masing-masing alat. |
apps.<id>.enabled |
boolean |
Tetapkan ke false untuk menonaktifkan aplikasi. Persyaratan yang menonaktifkan aplikasi tetap membatasi ketika beberapa sumber persyaratan digabungkan. |
apps.<id>.tools.<tool>.approval_mode |
auto | prompt | writes | approve |
Tetapkan mode persetujuan terkelola untuk satu alat aplikasi. |
auto_review |
table |
Persyaratan peninjauan otomatis terkelola. |
auto_review.ignore_rules |
array<string> |
Slug model lengkap yang membuat Codex mengabaikan aturan prefiks allow dalam kebijakan eksekusi perintah. Cocokkan slug secara persis, termasuk namespace penyedianya jika ada; berbeda dengan required_on_models, pengaturan ini tidak menerima alias tanpa namespace. Aturan penolakan dan jaringan tetap berlaku. |
auto_review.required_on_models |
array<string> |
Slug model yang harus menggunakan peninjauan otomatis. Slug tidak boleh kosong, harus menghilangkan namespace penyedia, dan tidak boleh memiliki spasi di awal atau akhir. Daftar dari beberapa sumber persyaratan digabungkan. |
browser_use |
table |
Persyaratan terkelola untuk Browser Use yang dijalankan agen. |
browser_use.allow_global_persistent_approval |
boolean |
Tetapkan ke false untuk mencegah Browser Use membuat atau memberlakukan persetujuan Always allow yang mencakup semua situs, seperti mengizinkan unduhan dari situs mana pun. Persetujuan tersimpan yang sudah ada diabaikan, bukan dihapus. Menetapkannya ke true atau menghilangkannya tidak membuat persetujuan. |
browser_use.allow_history_access |
boolean |
Tetapkan ke false untuk mencegah Browser Use membaca riwayat browser. Menetapkannya ke true atau menghilangkannya membuat pengaturan riwayat normal dan pemeriksaan ketersediaan tetap berlaku. |
browser_use.default_origin_policy |
table |
Nilai cadangan untuk setiap pengaturan Browser Use ketika tidak ada entri yang cocok di bawah browser_use.origins yang menentukannya. Aturan origin yang cocok menggantikan nilai cadangan untuk sumber tersebut. Codex kemudian menerapkan hasil yang lebih ketat dari persyaratan terkelola dan konfigurasi pengguna. |
browser_use.default_origin_policy.access |
allow | deny |
Gunakan deny untuk memblokir Browser Use pada origin yang menggunakan nilai cadangan. Origin yang ditolak juga memblokir unggahan, unduhan, akses debugging browser penuh, dan peninjauan otomatis di origin tersebut. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
browser_use.default_origin_policy.access_approval_lifetime |
turn | thread |
Tetapkan durasi berlakunya persetujuan akses situs yang tidak persisten: turn membatasinya pada giliran saat ini, dan thread mempertahankannya selama sisa utas saat ini. persistent_approval secara terpisah mengendalikan apakah Always allow tersedia. Default produk adalah thread. |
browser_use.default_origin_policy.auto_review |
allow | deny |
Gunakan deny untuk melewati peninjauan otomatis pada origin yang menggunakan nilai cadangan dan meminta persetujuan pengguna sebagai gantinya. allow membuat peninjauan otomatis tetap tersedia ketika pengaturan lain mengizinkannya. |
browser_use.default_origin_policy.downloads |
allow | deny |
Gunakan deny untuk memblokir unduhan Browser Use pada origin yang menggunakan nilai cadangan. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
browser_use.default_origin_policy.full_cdp_access |
allow | deny |
Gunakan deny untuk memblokir akses penuh Chrome DevTools Protocol (CDP) pada origin yang menggunakan nilai cadangan. allow hanya mengizinkan pemeriksaan pengaktifan sukarela dan persetujuan normal berlanjut. |
browser_use.default_origin_policy.persistent_approval |
boolean |
Tetapkan ke false untuk mencegah Browser Use menyimpan atau memberlakukan persetujuan Always allow pada origin yang menggunakan nilai cadangan. Persetujuan untuk giliran atau utas saat ini tetap dapat berlaku. true membuat Always allow tersedia jika ketentuan lainnya mengizinkan, tetapi tidak membuat persetujuan. |
browser_use.default_origin_policy.uploads |
allow | deny |
Gunakan deny untuk memblokir unggahan Browser Use pada origin yang menggunakan nilai cadangan. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
browser_use.disable_auto_review |
boolean |
Tetapkan ke true untuk melewati peninjauan otomatis bagi Browser Use dan meminta persetujuan pengguna sebagai gantinya. Menetapkannya ke false atau menghilangkannya membuat peninjauan otomatis tetap tersedia ketika pengaturan lain mengizinkannya. |
browser_use.origins |
map<string, table> |
Kebijakan Browser Use khusus origin. Kunci menggunakan <scheme>://<host-pattern>[:<port>] dengan http atau https. Gunakan host yang persis, *.example.com hanya untuk subdomain, atau **.example.com untuk domain dasar beserta subdomainnya. Wildcard * lainnya dapat mencakup titik, sehingga region*.example.com juga cocok dengan region.api.example.com; host berupa * cocok dengan setiap host untuk skema tersebut. Skema dan port nondefault memengaruhi pencocokan; port default yang ditulis secara eksplisit dihilangkan saat normalisasi. Path, kueri, nama pengguna atau kata sandi yang disematkan, serta wildcard pada skema atau port tidak valid. Apit pola dengan tanda kutip dalam TOML, misalnya [browser_use.origins."https://**.example.com"]. |
browser_use.origins.<pattern> |
table |
Kebijakan untuk origin yang cocok dengan pola ini. Jika beberapa pola cocok, Codex menggunakan nilai yang paling membatasi untuk setiap kapabilitas: deny lebih diutamakan daripada allow, false lebih diutamakan daripada true, dan turn lebih diutamakan daripada thread. |
browser_use.origins.<pattern>.access |
allow | deny |
Gunakan deny untuk memblokir Browser Use pada origin yang cocok. Penolakan juga memblokir unggahan, unduhan, akses debugging browser penuh, dan peninjauan otomatis di origin tersebut. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
browser_use.origins.<pattern>.access_approval_lifetime |
turn | thread |
Tetapkan durasi berlakunya persetujuan akses situs yang tidak persisten untuk origin yang cocok: turn membatasinya pada giliran saat ini, dan thread mempertahankannya selama sisa utas saat ini. persistent_approval secara terpisah mengendalikan apakah Always allow tersedia. |
browser_use.origins.<pattern>.auto_review |
allow | deny |
Gunakan deny untuk melewati peninjauan otomatis pada origin yang cocok dan meminta persetujuan pengguna sebagai gantinya. allow membuat peninjauan otomatis tetap tersedia ketika pengaturan lain mengizinkannya. |
browser_use.origins.<pattern>.downloads |
allow | deny |
Gunakan deny untuk memblokir unduhan Browser Use pada origin yang cocok. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
browser_use.origins.<pattern>.full_cdp_access |
allow | deny |
Gunakan deny untuk memblokir akses penuh Chrome DevTools Protocol (CDP) pada origin yang cocok. allow hanya mengizinkan pemeriksaan pengaktifan sukarela dan persetujuan normal berlanjut. |
browser_use.origins.<pattern>.persistent_approval |
boolean |
Tetapkan ke false untuk mencegah Browser Use menyimpan atau memberlakukan persetujuan Always allow pada origin yang cocok. Persetujuan untuk giliran atau utas saat ini tetap dapat berlaku. true membuat Always allow tersedia jika ketentuan lainnya mengizinkan, tetapi tidak membuat persetujuan. |
browser_use.origins.<pattern>.uploads |
allow | deny |
Gunakan deny untuk memblokir unggahan Browser Use pada origin yang cocok. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. |
chatgpt_base_url |
string |
Tetapkan URL dasar layanan ChatGPT sebelum autentikasi dan pengambilan kebijakan cloud. Pengaturan ini tidak mengonfigurasi setiap tujuan jaringan Codex. Tetapkan melalui file persyaratan sistem lokal atau MDM macOS; nilai yang dikelola melalui cloud diabaikan. |
check_for_update_on_startup |
boolean |
Tetapkan apakah Codex memeriksa pembaruan saat mulai berjalan. |
cli_auth_credentials_store |
file | keyring | auto | ephemeral |
Tetapkan penyimpanan kredensial CLI sebelum autentikasi dimuat. file menggunakan CODEX_HOME/auth.json; keyring mengharuskan penyimpanan kredensial OS; auto menggunakan file sebagai cadangan jika penyimpanan kredensial tidak tersedia; ephemeral menyimpan kredensial dalam memori untuk proses saat ini. Tetapkan melalui file persyaratan sistem lokal atau MDM macOS; nilai yang dikelola melalui cloud diabaikan. |
computer_use |
table |
Persyaratan terkelola untuk pekerjaan yang dijalankan agen dalam aplikasi desktop native. Aturan aplikasi terkelola dan aturan aplikasi config.toml sama-sama diberlakukan; aplikasi harus diizinkan oleh setiap sumber kebijakan. |
computer_use.allow_locked_computer_use |
boolean |
Tetapkan ke false untuk mencegah pengguna mengaktifkan Locked Use pada perangkat macOS terkelola. Persyaratan ini menghapus kontrol pengaktifan; persyaratan ini tidak menonaktifkan Locked Use jika sudah diaktifkan. Jika dihilangkan, ketersediaan produk normal berlaku. |
computer_use.allow_persistent_approval |
boolean |
Tetapkan ke false untuk menghapus opsi penyimpanan persetujuan aplikasi lintas sesi. Persetujuan untuk sesi saat ini tetap tersedia. Menetapkannya ke true atau menghilangkannya tidak memberikan persetujuan untuk aplikasi. |
computer_use.default_app_access |
allow | deny |
Akses cadangan untuk aplikasi native yang tidak cocok dengan aturan khusus platform. deny memblokir akses. allow hanya mengizinkan pemeriksaan persetujuan dan kebijakan normal berlanjut. Default produk adalah allow. |
computer_use.macos |
table |
Aturan aplikasi Computer Use untuk macOS. |
computer_use.macos.bundle_ids |
map<string, allow | deny> |
Petakan pengenal bundle macOS yang persis ke allow atau deny. Aturan yang cocok menggantikan computer_use.default_app_access dalam sumber kebijakan yang sama. Penolakan dari persyaratan terkelola maupun konfigurasi pengguna tetap memblokir akses. |
computer_use.macos.bundle_ids.<bundle-id> |
allow | deny |
Gunakan deny untuk memblokir pengenal bundle yang persis. allow hanya menggantikan default sumber kebijakan ini dan tetap mengharuskan semua sumber kebijakan lainnya serta alur persetujuan normal untuk mengizinkan aplikasi. |
computer_use.windows |
table |
Aturan aplikasi Computer Use untuk aplikasi Windows yang dikemas dan tidak dikemas. |
computer_use.windows.aumids |
map<string, allow | deny> |
Petakan Application User Model ID (AUMID) terdaftar yang persis untuk aplikasi bertanda tangan yang dikemas ke allow atau deny. Aturan yang cocok menggantikan computer_use.default_app_access dalam sumber kebijakan yang sama. |
computer_use.windows.aumids.<aumid> |
allow | deny |
Gunakan deny untuk memblokir identitas aplikasi yang dikemas secara persis. allow hanya menggantikan default sumber kebijakan ini dan tetap mengharuskan semua sumber kebijakan lainnya serta alur persetujuan normal untuk mengizinkan aplikasi. |
computer_use.windows.exes |
array<table> |
Aturan untuk executable Windows bertanda tangan yang tidak dikemas. Aturan mencocokkan penerbit executable yang terverifikasi dan informasi versi bertanda tangan, bukan path atau nama file saat ini. Penolakan yang cocok lebih diutamakan daripada izin yang cocok. Executable tanpa tanda tangan menggunakan computer_use.default_app_access; executable yang identitas bertanda tangannya tidak dapat diverifikasi secara pasti diblokir. |
computer_use.windows.exes[].access |
allow | deny |
Keputusan akses yang wajib diisi untuk executable yang cocok. deny memblokir akses. allow hanya menggantikan default sumber kebijakan ini dan tetap mengharuskan semua sumber kebijakan lainnya serta alur persetujuan normal untuk mengizinkan aplikasi. |
computer_use.windows.exes[].binary_name |
string |
Nilai OriginalFilename opsional dari informasi versi bertanda tangan milik executable. Pencocokan tidak membedakan huruf besar dan kecil. Jika aturan penerbit dan produk yang cocok mengharuskan nilai ini tetapi executable tidak menyediakannya, Computer Use memblokir executable tersebut. |
computer_use.windows.exes[].product_name |
string |
Nilai ProductName yang persis dari informasi versi bertanda tangan milik executable, wajib diisi. |
computer_use.windows.exes[].publisher_name |
string |
Nama penerbit yang persis dari sertifikat penandatanganan tepercaya milik executable, wajib diisi dan diformat sebagai distinguished name Windows X.500. |
default_permissions |
string |
Profil izin default terkelola. Profil harus diizinkan oleh allowed_permission_profiles. Tetapkan secara eksplisit agar perilakunya dapat diprediksi; jika dihilangkan, Codex hanya menggunakan :workspace sebagai default ketika :workspace dan :read-only keduanya diizinkan secara eksplisit. |
enforce_residency |
string |
Wajibkan lalu lintas layanan Codex menggunakan residensi data yang didukung. Saat ini menerima us. |
experimental_network |
table |
Persyaratan jaringan yang dikelola administrator untuk perintah lokal dalam sandbox, yang diberlakukan dari requirements.toml. Saat diaktifkan, persyaratan ini dapat memulai proksi jaringan perintah tanpa features.network_proxy. Alat browser secara terpisah memeriksa penolakan jaringan terkelola dan daftar izin eksklusif. Persyaratan ini tidak merutekan lalu lintas browser melalui proksi atau mengendalikan pencarian web, aplikasi, MCP server, lalu lintas aplikasi native, atau lalu lintas khusus kapabilitas lainnya. Pada jalur Codex Cloud terkelola yang didukung, persyaratan ini membatasi jaringan perintah bersama pengaturan internet lingkungan Cloud yang terpisah. Eskalasi penuh sandbox yang disetujui dapat melewati proksi perintah jika kebijakan mengizinkannya. Work Cloud tidak mewarisi persyaratan ini. |
experimental_network.allow_local_binding |
boolean |
Izinkan akses jaringan lokal/privat yang lebih luas untuk jaringan dalam sandbox. Pada jalur proksi Codex Cloud yang didukung, nilai false yang eksplisit dapat mencegah akses melalui proksi upstream meskipun suatu domain diizinkan. Nilai default-nya adalah true hanya jika tidak ada persyaratan yang berlaku, profil jaringan yang dipilih, atau pengaturan fitur proksi yang memberikan nilai. Nilai false yang diwarisi tetap dianggap eksplisit. Penggantian Cloud berprioritas lebih tinggi yang didukung dapat mengubahnya tanpa memperluas Global untuk Local atau menambahkan entri Allow domain. Verifikasi dukungan eksekutor. Jangan terapkan default Cloud ini pada Local. |
experimental_network.allow_upstream_proxy |
boolean |
Izinkan jaringan dalam sandbox meneruskan koneksi melalui proksi upstream dari lingkungan. |
experimental_network.allowed_domains |
array<string> |
Aturan izin administrator untuk jaringan perintah dalam sandbox ketika proksi jaringan terkelola diaktifkan. Aturan ini tidak berlaku untuk pencarian web, aplikasi, atau MCP server. Jangan gabungkan pengaturan ini dengan experimental_network.domains. |
experimental_network.dangerously_allow_all_unix_sockets |
boolean |
Izinkan tujuan soket Unix apa pun, bukan hanya akses ke tujuan dalam daftar izin. Gunakan hanya dalam lingkungan yang dikendalikan secara ketat. |
experimental_network.dangerously_allow_non_loopback_proxy |
boolean |
Izinkan alamat listener non-loopback untuk persyaratan [experimental_network]. Mengaktifkannya dapat membuat listener dapat diakses dari luar localhost. |
experimental_network.denied_domains |
array<string> |
Aturan penolakan administrator berbentuk daftar untuk jaringan dalam sandbox. Jangan gabungkan pengaturan ini dengan experimental_network.domains. |
experimental_network.domains |
map<string, allow | deny> |
Kebijakan domain administrator berbentuk peta untuk jaringan dalam sandbox. Mendukung host yang persis, *.example.com hanya untuk subdomain, **.example.com untuk domain utama beserta subdomain, dan aturan izin * global. Utamakan aturan dengan cakupan terbatas karena * membuka akses keluar publik secara luas. Aturan Environment dapat menggantikan kunci domain Global yang sama dalam suatu kebijakan. Nilai berprioritas lebih tinggi menggantikan kunci yang sama, sementara kunci warisan lainnya tetap berlaku. Setelah penggabungan, deny lain yang cocok, termasuk wildcard yang diwarisi, tetap memblokir permintaan. Peta lingkungan yang kosong tidak menghapus aturan Global. Verifikasi dukungan eksekutor. Jangan gabungkan pengaturan ini dengan experimental_network.allowed_domains atau experimental_network.denied_domains. |
experimental_network.domains.<pattern> |
allow | deny |
Izinkan atau tolak akses jaringan dalam sandbox untuk pola domain yang cocok. Aturan penolakan lebih diutamakan ketika beberapa pola cocok. |
experimental_network.enabled |
boolean |
Aktifkan persyaratan jaringan dalam sandbox. Pengaturan ini tidak memberikan akses jaringan ketika sandbox aktif menonaktifkan jaringan perintah. |
experimental_network.http_port |
integer |
Port listener HTTP loopback yang digunakan untuk persyaratan [experimental_network]. |
experimental_network.managed_allowed_domains_only |
boolean |
Ketika persyaratan jaringan diaktifkan dan pengaturan ini bernilai true, konfigurasi pengguna biasa dan persetujuan per domain tidak dapat memperluas daftar izin proksi terkelola. Tanpa entri Allow yang efektif, baik yang dikonfigurasi maupun diwarisi, perintah terkelola biasa tidak memiliki tujuan yang diizinkan. Kebijakan yang hanya berisi penolakan tidak mengizinkan akses ke bagian internet lainnya. Pengaturan ini tidak mencakup setiap alat atau eskalasi penuh sandbox yang disetujui. |
experimental_network.socks_port |
integer |
Port listener SOCKS5 loopback yang digunakan untuk persyaratan [experimental_network]. |
experimental_network.unix_sockets |
map<string, allow | deny> |
Daftar izin soket Unix yang dikelola administrator untuk jaringan dalam sandbox di macOS. Path harus absolut. |
experimental_network.unix_sockets.<path> |
allow | deny |
Di macOS, allow menambahkan path soket Unix absolut ke daftar izin; deny tidak menyertakannya. Entri deny tidak dapat memblokir soket ketika izin untuk semua soket Unix diaktifkan. |
features |
table |
Nilai fitur yang ditetapkan secara tetap. Gunakan nama kanonis dari config.toml untuk fitur runtime; kunci persyaratan khusus aplikasi yang didokumentasikan juga didukung di sini. |
features.<name> |
boolean |
Wajibkan fitur runtime atau aplikasi yang didokumentasikan untuk tetap aktif atau nonaktif. |
features.apps |
boolean |
Tetapkan ketersediaan integrasi Apps agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.browser_use |
boolean |
Tetapkan ke false dalam requirements.toml untuk menonaktifkan Browser Use yang dijalankan agen. |
features.browser_use_external |
boolean |
Tetapkan ke false dalam requirements.toml untuk mencegah Codex mengoperasikan browser yang didukung melalui ekstensi browser ChatGPT, termasuk tab yang sudah ada dan sesi yang sudah login. |
features.browser_use_full_cdp_access |
boolean |
Tetapkan ke false dalam requirements.toml untuk menonaktifkan akses penuh Chrome DevTools Protocol pada runtime lokal, termasuk mode Browser Developer, dan mencegah aplikasi desktop ChatGPT mengaktifkan pengaturan terkait. Jika dihilangkan, ketersediaan produk normal berlaku. |
features.computer_use |
boolean |
Tetapkan ke false dalam requirements.toml untuk menonaktifkan Computer Use, Record & Replay, serta alur penginstalan atau pengaktifan terkait. |
features.fast_mode |
boolean |
Tetapkan fitur kanonis fast_mode agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.guardian_approval |
boolean |
Tetapkan ketersediaan persetujuan Guardian agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.in_app_browser |
boolean |
Tetapkan ke false dalam requirements.toml untuk menonaktifkan panel browser bawaan yang dibuka dan dikendalikan langsung oleh pengguna. |
features.in_app_chat |
boolean |
Tetapkan ke false untuk menyembunyikan layar percakapan ChatGPT dan ChatGPT Work serta antarmuka otomatisasi cloud terkait dalam aplikasi desktop ChatGPT. Pengaturan ini tidak memblokir ChatGPT Voice atau menghentikan tugas cloud yang sudah ada. Menetapkannya ke true tidak melewati pemeriksaan akun, izin ruang kerja, atau peluncuran bertahap. |
features.in_app_dictation |
boolean |
Tetapkan ke false untuk menonaktifkan dikte dalam aplikasi desktop. Menetapkannya ke true tidak melewati pemeriksaan ketersediaan lainnya. |
features.in_app_local_automation |
boolean |
Tetapkan ke false untuk menonaktifkan tugas terjadwal lokal dalam aplikasi desktop. Menetapkannya ke true tidak melewati pemeriksaan ketersediaan lainnya. |
features.in_app_updates |
boolean |
Tetapkan ke false dalam requirements.toml untuk menonaktifkan pembaruan dalam aplikasi. Pembaruan tetap diaktifkan secara default ketika persyaratan ini dihilangkan. |
features.memories |
boolean |
Tetapkan ketersediaan Memories agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.multi_agent |
boolean |
Tetapkan ketersediaan multiagen agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.plugin_sharing |
boolean |
Tetapkan ke false dalam requirements.toml yang dikelola melalui cloud untuk menonaktifkan berbagi plugin yang dibuat secara lokal di ruang kerja. |
features.plugins |
boolean |
Tetapkan ketersediaan plugin agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.realtime_conversation |
boolean |
Tetapkan ke false untuk menonaktifkan perintah eksperimental /voice di Codex CLI. Jangan mengandalkan pengaturan ini untuk memblokir ChatGPT Voice dalam aplikasi desktop atau sesi suara app-server. Menetapkannya ke true tidak melewati pemeriksaan klien atau peluncuran bertahap. |
features.remote_plugin |
boolean |
Tetapkan ketersediaan katalog plugin jarak jauh agar tetap aktif atau nonaktif bagi pengguna terkelola. |
features.workspace_dependencies |
boolean |
Tetapkan ketersediaan runtime dependensi ruang kerja yang dibundel agar tetap aktif atau nonaktif bagi pengguna terkelola. |
feedback |
table |
Pengaturan masukan terkelola. |
feedback.enabled |
boolean |
Tetapkan apakah pengguna dapat mengirim masukan di seluruh klien Codex. |
guardian_extra_policy |
string |
Kebijakan Markdown terkelola tambahan untuk peninjauan otomatis, yang disertakan bersama kebijakan utama. Pengaturan ini lebih diutamakan daripada [auto_review].extra_policy lokal. Nilai kosong diabaikan. |
guardian_policy_config |
string |
Instruksi kebijakan Markdown terkelola untuk peninjauan otomatis. Pengaturan ini lebih diutamakan daripada [auto_review].policy lokal. Nilai kosong diabaikan. |
hooks |
table |
Hook siklus hidup terkelola yang diberlakukan admin. Memerlukan direktori hook terkelola dan menggunakan skema peristiwa yang sama dengan [hooks] inline dalam config.toml. |
hooks.<Event> |
array<table> |
Grup pencocok untuk peristiwa hook seperti PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, atau Stop. |
hooks.<Event>[].hooks |
array<table> |
Penangan hook untuk grup pencocok. Hook perintah dan alat MCP didukung, sedangkan penangan hook prompt dan agen diurai tetapi dilewati. |
hooks.<Event>[].hooks[].additionalContextLimit |
integer |
Perkiraan ambang token per penangan untuk menyimpan additionalContext yang terlalu besar ke disk dan menampilkan pratinjau yang lebih singkat kepada model. Default-nya adalah 2500; 0 meneruskan konteks lengkap langsung ke model. Lihat Keluaran hook yang besar. |
hooks.<Event>[].hooks[].async |
boolean |
Jalankan hook perintah di latar belakang tanpa menunda operasi pemicunya. Default-nya adalah false; SessionEnd selalu berjalan secara sinkron. Lihat Menjalankan hook di latar belakang. |
hooks.<Event>[].hooks[].commandWindows |
string |
Penggantian perintah khusus Windows untuk hook perintah. Alias TOML command_windows juga diterima. |
hooks.managed_dir |
string (absolute path) |
Direktori yang berisi skrip hook terkelola di macOS dan Linux. Codex memvalidasi bahwa path direktori bersifat absolut dan direktori tersebut ada sebelum memuat hook terkelola. |
hooks.windows_managed_dir |
string (absolute path) |
Direktori yang berisi skrip hook terkelola di Windows. Codex memvalidasi bahwa path direktori bersifat absolut dan direktori tersebut ada sebelum memuat hook terkelola. |
in_app_browser |
table |
Persyaratan untuk panel browser bawaan. Pengaturan ini tidak mengendalikan Browser Use yang dijalankan agen. |
in_app_browser.allow_external_browser_settings_import |
boolean |
Tetapkan ke false untuk mencegah pengguna mengimpor pengaturan atau data penjelajahan dari browser eksternal ke browser bawaan. Menetapkannya ke true atau menghilangkannya membuat impor tetap tersedia ketika pemeriksaan produk lainnya mengizinkannya. Ini adalah pengaturan khusus pengelolaan yang tidak dapat digantikan melalui config.toml. |
log_dir |
string (path) |
Tetapkan direktori tempat Codex menulis file log lokal. |
marketplaces |
table |
Persyaratan admin untuk sumber marketplace plugin. Aturan berlaku ketika restrict_to_allowed_sources bernilai true. |
marketplaces.allowed_sources |
table |
Sumber marketplace yang diizinkan dengan nama aturan pilihan administrator sebagai kunci. Nama yang berbeda terakumulasi di seluruh lapisan persyaratan; bidang dengan nama yang sama menggunakan urutan prioritas lapisan normal. |
marketplaces.allowed_sources.<name> |
table |
Satu aturan sumber yang diizinkan. Nilai akhir source setelah penggabungan persyaratan menentukan bidang setingkat mana yang ditafsirkan Codex. |
marketplaces.allowed_sources.<name>.host_pattern |
string |
Ekspresi reguler yang wajib diisi ketika source = "host_pattern". Codex mencocokkannya dengan nama host berhuruf kecil yang diurai dari sumber Git bergaya HTTPS, SSH, atau SCP. Gunakan ^ dan $ untuk mengharuskan kecocokan seluruh nama host. |
marketplaces.allowed_sources.<name>.path |
string (absolute path) |
Direktori marketplace lokal yang wajib diisi ketika source = "local". Codex mengharuskan path absolut dan membandingkan path setelah normalisasi. |
marketplaces.allowed_sources.<name>.ref |
string |
Ref Git persis yang opsional untuk aturan git. Jika dihilangkan, aturan mengizinkan ref apa pun untuk repositori yang cocok. |
marketplaces.allowed_sources.<name>.source |
git | host_pattern | local |
Jenis pencocok sumber marketplace. Gunakan git untuk satu repositori, host_pattern untuk host Git yang dicocokkan dengan ekspresi reguler, atau local untuk satu direktori. |
marketplaces.allowed_sources.<name>.url |
string |
URL repositori Git yang wajib diisi ketika source = "git". Codex menormalisasi URL yang dikonfigurasi dan diizinkan sebelum mengharuskan kecocokan repositori secara persis. |
marketplaces.restrict_to_allowed_sources |
boolean |
Ketika true, wajibkan sumber marketplace yang dikonfigurasi agar cocok dengan allowed_sources untuk penambahan marketplace, penginstalan plugin, penyegaran, dan pemuatan runtime. Katalog Git yang dikurasi OpenAI, termasuk katalog API key, juga harus cocok dengan daftar izin. Plugin ruang kerja yang dibundel dan diinstal dari jarak jauh terpisah dari kebijakan sumber Git terkurasi ini. |
mcp_servers |
table |
Daftar izin MCP server yang boleh diaktifkan. Nama server (<id>) dan identitasnya harus sama-sama cocok agar MCP server dapat diaktifkan. Setiap MCP server yang dikonfigurasi tetapi tidak ada dalam daftar izin (atau identitasnya tidak cocok) dinonaktifkan. |
mcp_servers.<id>.identity |
table |
Aturan identitas untuk satu MCP server. Tetapkan salah satu dari command (stdio) atau url (streamable HTTP). |
mcp_servers.<id>.identity.command |
string | table |
Izinkan STDIO MCP server berdasarkan string perintah yang persis, atau gunakan tabel pencocok untuk mengharuskan executable yang persis dan pencocok argumen berurutan. Bentuk string tidak memeriksa argumen, cwd, env, atau env_vars. |
mcp_servers.<id>.identity.command.args |
array<table> |
Pencocok argumen berurutan untuk server stdio. Daftar argumen yang dikonfigurasi harus memiliki panjang yang sama, dan setiap posisi harus cocok. Pencocok perintah tidak memeriksa cwd, env, atau env_vars. |
mcp_servers.<id>.identity.command.args[].expression |
string |
Ekspresi reguler yang digunakan oleh pencocok argumen regex. Ekspresi harus valid dan cocok dengan seluruh nilai argumen. |
mcp_servers.<id>.identity.command.args[].match |
exact | prefix | regex |
Operasi pencocokan untuk posisi argumen ini. |
mcp_servers.<id>.identity.command.args[].value |
string |
Nilai yang digunakan oleh pencocok argumen exact atau prefix. |
mcp_servers.<id>.identity.command.executable |
string |
Executable yang harus cocok secara persis dengan command yang dikonfigurasi pada server stdio. |
mcp_servers.<id>.identity.url |
string | table |
Izinkan Streamable HTTP MCP server berdasarkan string URL yang persis, atau gunakan tabel pencocok nilai exact, prefix, atau regex. |
mcp_servers.<id>.identity.url.expression |
string |
Ekspresi reguler yang digunakan oleh pencocok URL regex. Ekspresi harus valid dan cocok dengan seluruh nilai URL. |
mcp_servers.<id>.identity.url.match |
exact | prefix | regex |
Operasi pencocokan untuk URL MCP server yang dikonfigurasi. |
mcp_servers.<id>.identity.url.value |
string |
Nilai yang digunakan oleh pencocok URL exact atau prefix. |
model_catalog_json |
string (path) |
Tetapkan katalog model JSON yang digunakan Codex saat mulai berjalan. |
model_provider |
string |
Tetapkan ID penyedia model, dengan menggantikan konfigurasi lokal dan sesi. |
model_providers |
map<string, table> |
Definisi penyedia model terkelola. Setiap entri menggantikan seluruh konfigurasi penyedia dengan ID yang sama; bidang tidak digabungkan dengan definisi pengguna. Penyedia dengan ID lain tetap tersedia. |
model_providers.<id> |
table |
Definisi lengkap penyedia terkelola. Menggunakan bidang penyedia yang sama dengan config.toml, termasuk name, base_url, autentikasi, dan pengaturan transport. |
models |
table |
Berisi tabel [models.new_thread]. |
models.new_thread |
table |
Nilai default opsional yang diterapkan saat utas lokal baru dimulai. Nilai ini lebih diutamakan daripada default pengguna dan proyek, tetapi dapat digantikan oleh penggantian eksplisit. |
models.new_thread.model |
string |
Model default untuk utas baru. Penggantian eksplisit pada model atau upaya penalaran menyebabkan kedua bidang diabaikan. |
models.new_thread.model_reasoning_effort |
string |
Upaya penalaran default untuk utas baru. Penggantian eksplisit pada model atau upaya penalaran menyebabkan kedua bidang diabaikan. |
models.new_thread.service_tier |
string |
Tingkat layanan default untuk utas baru. Penggantian tingkat layanan secara eksplisit menyebabkan bidang ini diabaikan. |
permissions |
table |
Profil izin yang ditentukan admin dengan nama profil sebagai kunci. Menggunakan bidang profil yang sama dengan config.toml. |
permissions.<name> |
table |
Profil izin yang ditentukan admin. Namanya tidak boleh diawali dengan :, menggunakan nama yang dicadangkan filesystem, atau menduplikasi profil dari konfigurasi yang dimuat. Menggunakan bidang profil yang sama dengan config.toml; lihat panduan Izin untuk skema profil lengkap. |
permissions.filesystem.deny_read |
array<string> |
Penolakan akses baca sistem file yang diberlakukan admin. Entri dapat berupa path atau pola glob, dan pengguna tidak dapat melonggarkannya dengan konfigurasi lokal. |
plugins |
table |
Daftar izin MCP server khusus plugin dengan pengenal plugin sebagai kunci. Ketika tabel ini ada, server yang dibundel dengan plugin tanpa entri plugin dan server yang cocok dinonaktifkan. |
plugins.<plugin>.mcp_servers |
table |
Daftar izin untuk MCP server yang dibundel dengan satu plugin. Persyaratan server plugin menggunakan bentuk identitas persis dan pencocok yang sama dengan persyaratan mcp_servers tingkat teratas. |
plugins.<plugin>.mcp_servers.<server>.identity |
table |
Aturan identitas untuk satu MCP server yang dibundel dengan plugin. Tetapkan salah satu dari command (stdio) atau url (streamable HTTP). |
plugins.<plugin>.mcp_servers.<server>.identity.command |
string | table |
Izinkan STDIO MCP server milik plugin berdasarkan string perintah yang persis, atau gunakan tabel pencocok untuk mengharuskan executable yang persis dan pencocok argumen berurutan. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args |
array<table> |
Pencocok argumen berurutan untuk server stdio yang dibundel dengan plugin. Daftar argumen yang dikonfigurasi harus memiliki panjang yang sama, dan setiap posisi harus cocok. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression |
string |
Ekspresi reguler yang digunakan oleh pencocok argumen regex. Ekspresi harus cocok dengan seluruh nilai argumen. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match |
exact | prefix | regex |
Operasi pencocokan untuk posisi argumen ini. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value |
string |
Nilai yang digunakan oleh pencocok argumen exact atau prefix. |
plugins.<plugin>.mcp_servers.<server>.identity.command.executable |
string |
Executable yang harus cocok secara persis dengan perintah yang dikonfigurasi pada server stdio yang dibundel dengan plugin. |
plugins.<plugin>.mcp_servers.<server>.identity.url |
string | table |
Izinkan Streamable HTTP MCP server milik plugin berdasarkan string URL yang persis, atau gunakan tabel pencocok nilai exact, prefix, atau regex. |
plugins.<plugin>.mcp_servers.<server>.identity.url.expression |
string |
Ekspresi reguler yang digunakan oleh pencocok URL regex. Ekspresi harus cocok dengan seluruh nilai URL. |
plugins.<plugin>.mcp_servers.<server>.identity.url.match |
exact | prefix | regex |
Operasi pencocokan untuk URL MCP server yang dibundel dengan plugin. |
plugins.<plugin>.mcp_servers.<server>.identity.url.value |
string |
Nilai yang digunakan oleh pencocok URL exact atau prefix. |
remote_sandbox_config |
array<table> |
Persyaratan sandbox khusus host. Entri pertama yang hostname_patterns-nya cocok dengan nama host yang telah diresolusikan menggantikan allowed_sandbox_modes tingkat teratas untuk sumber persyaratan tersebut. Entri khusus host saat ini hanya menggantikan mode sandbox. |
remote_sandbox_config[].allowed_sandbox_modes |
array<string> |
Mode sandbox yang diizinkan untuk diterapkan ketika entri khusus host ini cocok. |
remote_sandbox_config[].hostname_patterns |
array<string> |
Pola nama host yang tidak membedakan huruf besar dan kecil. Mendukung * untuk urutan karakter apa pun dan ? untuk satu karakter. |
rules |
table |
Aturan perintah yang diberlakukan admin dan digabungkan dengan file .rules. Aturan persyaratan harus bersifat membatasi. |
rules.prefix_rules |
array<table> |
Daftar aturan prefiks yang diberlakukan. Setiap aturan harus menyertakan pattern dan decision. |
rules.prefix_rules[].decision |
prompt | forbidden |
Wajib diisi. Aturan persyaratan hanya dapat meminta persetujuan atau melarang (bukan mengizinkan). |
rules.prefix_rules[].justification |
string |
Alasan opsional yang tidak boleh kosong, ditampilkan dalam permintaan persetujuan atau pesan penolakan. |
rules.prefix_rules[].pattern |
array<table> |
Prefiks perintah yang dinyatakan sebagai token pola. Setiap token menetapkan salah satu dari token atau any_of. |
rules.prefix_rules[].pattern[].any_of |
array<string> |
Daftar token alternatif yang diizinkan pada posisi ini. |
rules.prefix_rules[].pattern[].token |
string |
Satu token literal pada posisi ini. |
sqlite_home |
string (path) |
Tetapkan direktori tempat Codex menyimpan status runtime berbasis SQLite. |
windows |
table |
Persyaratan sandbox native Windows. |
windows.allowed_sandbox_implementations |
array<string> |
Implementasi sandbox native Windows lama yang diizinkan (elevated dan unelevated). Daftar tidak boleh kosong. Ketika keduanya diizinkan dan tidak ada mode yang dipilih, Codex mengutamakan elevated. Daftar ini tidak membatasi sandbox mxc ketika tersedia. |
Tidak ada opsi konfigurasi yang cocok.