Yapılandırma Referansı

Codex config.toml ve requirements.toml için eksiksiz referans

Bu sayfayı Codex yapılandırma dosyaları için arama yapılabilir bir referans olarak kullanın. Kavramsal rehberlik ve örnekler için Yapılandırma temelleri ve Gelişmiş Yapılandırma ile başlayın.

Work Cloud ile yerel bilgisayar erişimi ayarları

Work Cloud ile yerel bilgisayar erişimi etkinleştirildiğinde OpenAI bulutu görevi koordine ederken desteklenen araçlar bulutta veya bağlı bir bilgisayarda çalışır. Gereksinimler sınırları belirler; yapılandırma değerleri ise varsayılanları sağlar.

Global ayarlarını yönetmek için ilke API'sini kullanın. Local veya Codex Cloud ayarlarını yönetmek için Agent Security arayüzünü kullanın. Mevcut Global API iş akışları geçişten sonra da kullanılabilir. Betiklerinizi ve Terraform entegrasyonlarınızı test edin; ilke atamalarının ve sıralamasının değişmediğini doğrulayın. Bir requirements.toml alanının desteklenmesi, tek başına API uyumluluğu anlamına gelmez.

Ayar veya ayar ailesi Work Cloud ile yerel bilgisayar erişimindeki kapsam Yönergeler
Onay ilkeleri ve inceleme gereksinimleri Yönetilen ilke etkin olduğunda Global orkestratör ilkesi Onay ve inceleme kontrollerini Global kapsamında tutun. Ortama özgü geçersiz kılmalar orkestratör kontrollerini değiştiremez. Yerel yürütme ile bulut kapsayıcısında yürütme ayrı ilke kapsamlarına sahiptir.
Yönetilen uygulamalar, MCP server'ları, eklentiler, pazar yerleri ve komut kuralları Global ilkesi Bu kontrolleri genel kapsamda tutun. Alanın bir şemada bulunmasını, her ortam için ayrı ayrı düzenlenebileceğinin kanıtı olarak değerlendirmeyin.
Dosya, korumalı alan ve taşınabilir ağ gereksinimleri Yerel yürütme Yerel yürütmede MDM ve eski yönetilen cihaz gereksinimleri, Agent Security'den daha yüksek önceliğe sahiptir. Cihazın sistem gereksinimleri dosyası ise Agent Security'den daha düşük önceliğe sahiptir. Yeni kurumsal requirements.toml yapılandırması Work bulut kapsayıcıları için geçerli değildir; bu kapsayıcılarda mevcut Work Cloud ilkeleri geçerliliğini korur.
Platforma özgü yürütücü kontrolleri Adımı çalıştıran bilgisayar Destek, yürütücüye ve platforma bağlıdır.
Yönetilen kancalar Etkinleştirildiği yerlerde, desteklenen yaşam döngüsü ve araç olayları için bulut koordinatöründe (orkestratörde) çalışan, yönetici tarafından tanımlanmış MCP kancaları. Bu kancalara güvenmeden önce geri çağrı bağlantısını test edin, aldığı olayları doğrulayın ve hataların görevi nasıl etkilediğini kontrol edin. MCP kancaları eksiksiz bir Compliance API denetim izi sağlamaz. Araçlar yerel olarak çalışsa bile bulut orkestrasyonunda komut kancaları, yerel yapılandırma kancaları ve eklenti kancaları desteklenmez. Mevcut desteklenen kancalar, hem orkestrasyonun hem de yürütmenin yerel olduğu, yalnızca yerelde çalışan Work ve Codex konuşmalarında geçerliliğini korur.
Proxy dinleyici adresleri, bağlantı noktaları ve süreç ayarları Taşınabilir ortam ilkesi kapsamında değildir Yönetilen HTTP/SOCKS dinleyici bağlantı noktaları ve geri döngü dışındaki adreslerde çalışan proxy dinleyicileri bulut çalışma zamanı tarafından desteklenmez; soket kurallarının desteği yürütme yoluna bağlıdır. Özel proxy yapılandırması, desteklenen hedef kısıtlamalarından ayrıdır.
Yalnızca uygulamaya özgü ayarlar ve olağan yerel varsayılanlar Bulut koordinasyonu tarafından mutlaka kullanılmaz Uygulamanın zorunlu kıldığı kontroller, Work Cloud ile yerel bilgisayar erişimi bunları kullanmasa bile etkili olmaya devam edebilir. Bulut üzerinden iletimin ve bulut tarayıcısının davranışı ayrı ayrı doğrulanmalıdır.

Work Cloud ile yerel bilgisayar erişimi için Agent Security gereksinimleri

Yerel erişimli Work ve dots için, yönetilen ilke etkin olduğunda desteklenen Global ilkesi paylaşılan bulut orkestratörüne uygulanır. Yerel yürütme gereksinimleri bağlı bilgisayarı yönetir. Work bulut kapsayıcıları ve dots bulut bilgisayarları kendi yürütme yapılandırmalarını ve gereksinimlerini kullanır. Yerel kontrolleri ve bulut kontrollerini ayrı ayrı test edin.

Agent Security arayüzünde sunulanlar

  • İzin verilen onay ilkeleri
  • İzin verilen web araması modları

TOML aracılığıyla yapılandırılanlar

  • allowed_approvals_reviewers
  • auto_review
  • guardian_policy_config
  • apps
  • mcp_servers
  • plugins
  • rules

Bu orkestratör gereksinimleri Global kapsamında kalır. Paylaşılan bulut yeteneklerinin izinlerini yapılandırmaz veya yerel yürütme ayarlarını Work bulut kapsayıcılarına ya da dots bulut bilgisayarlarına taşınabilir hâle getirmez.

Work Cloud ile yerel bilgisayar erişiminin uyumluluk sınırları

Destek, alana, ilkenin nasıl iletildiğine ve görevin nerede çalıştığına bağlıdır. Eşitlemeyi etkinleştirmeden önce üye için geçerli olan ilkeyi kontrol edin. Tabloda belirtildiği gibi, bazı kontrollerin kendi dağıtımınızda test edilmesi gerekir.

Bir ilke içinde en yüksekten en düşüğe doğru öncelik sırası şöyledir: işletim sistemine özgü ortam geçersiz kılması → tüm işletim sistemleri için ortam geçersiz kılması → Global. Daha düşük öncelikli ilke daha özgül olsa bile daha yüksek öncelikli ilke geçerli olur.

Yerel yürütmede MDM ve eski yönetilen cihaz gereksinimleri Agent Security'ye göre, Agent Security ise cihazın sistem gereksinimleri dosyasına göre önceliklidir. Ağ gereksinimleri de dahil olmak üzere bazı gereksinimlerin alana özgü birleştirme kuralları ve çalışma zamanı sınırları vardır. Örnekler için Yönetilen yapılandırma bölümüne bakın.

Ayar veya ayar grubu Work Cloud ile yerel bilgisayar erişimi uyumluluğu Yönetici rehberi
sqlite_home, log_dir, model_catalog_json Yönetilen bulut geçersiz kılma ayarları olarak desteklenmez. Yerel yollar bulut depolamasını veya günlükleri taşıyamaz. Yerel model kataloğu aktarılmaz.
model_provider, model_providers Work Cloud ile yerel bilgisayar erişiminin yönetilen gereksinimlerinde veya yapılandırmasında desteklenmez. Özel çıkarım ağ geçitleri ve sağlayıcı bağlantıları bu alanlar aracılığıyla aktarılmaz. Bu durum model seçiminden bağımsızdır.
enforce_residency Herhangi bir bulut politikasında etkinleştirildiğinde Work Cloud ile yerel bilgisayar erişimini engeller. Herhangi bir bulut politikasında enforce_residency etkinleştirilirse Allow local computer access hem Work hem de dots için devre dışı bırakılır. Bu koruma, çalışma alanının veri yerleşimini yapılandırmaz veya tek başına Work Cloud ya da dots'u devre dışı bırakmaz.
application.network.enabled ve application.network.domains Work Cloud ile yerel bilgisayar erişimi tarafından desteklenmez. Bu uygulama hedefi kısıtlamalarını, Work Cloud ile yerel bilgisayar erişiminde komutların ağ erişimini denetlemek için kullanmayın.
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions Bulut politikalarının iletiminin doğrulanması gerekir. Work Cloud ile yerel bilgisayar erişimi bu yönetilen gereksinim anahtarlarını reddeder. Tarayıcı kısıtlamaları için uygulama tarafında kontroller vardır. Bu, politikaların buluta iletildiğini veya bulut tarayıcısında uygulandığını kanıtlamaz. additional_developer_instructions, orkestratör desteği gerektirir.
experimental_network ve permissions.<profile>.network Kısmen desteklenir. Desteklenen hedef ve yürütücü kısıtlamaları, özel proxy yapılandırmasından farklıdır. Yönetilen HTTP/SOCKS dinleyici bağlantı noktaları ve geri döngü dışı proxy dinleyicileri bulut çalışma zamanı tarafından desteklenmez; soket kurallarının desteği yürütme yoluna bağlıdır. Yerel yürütmedeki birleştirme davranışı ayrıdır. Komutların ağ erişimine yönelik kısıtlamalar, barındırılan aramayı, MCP'yi veya uygulama araçlarını devre dışı bırakmaz.
özellikler / feature_requirements, modeller, computer_use Kısmen desteklenir. tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true ve remote_control = true gibi kullanımdan kaldırılmış anahtarlar reddedilir. Bazı bilgisayar kullanımı ayarlarının hâlâ uçtan uca doğrulanması gerekir.
browser_use, allow_appshots, geri bildirim, allow_remote_control, pazaryeri kaynak kısıtlamaları Uygulama veya uygulama sunucusu, bazı politika iletim yollarında bu denetimleri uygular. Work Cloud ile yerel bilgisayar erişimi bir alanı yok saysa bile uygulama denetimleri geçerli olabilir. Masaüstü tarayıcısının site kuralları Work bulut kapsayıcıları için geçerli değildir. Kullanılan arayüzü ve politika iletim yolunu doğrulayın.

Yapılandırma şeması, Work Cloud ile yerel bilgisayar erişiminde çalışmayabilecek veya ortam düzeyindeki geçersiz kılmaları desteklemeyebilecek anahtarlar içerir. Genel temel ayarlar ve öncelik sırası için Yönetilen yapılandırma bölümüne bakın.

config.toml

Kullanıcı düzeyindeki yapılandırma ~/.codex/config.toml konumunda bulunur. Ayrıca .codex/config.toml dosyalarına proje kapsamlı geçersiz kılmalar ekleyebilirsiniz. Codex, proje kapsamlı yapılandırma dosyalarını yalnızca projeye güvendiğinizde yükler.

Proje kapsamlı yapılandırma; makineye yerel sağlayıcı, kimlik doğrulama, ana bilgisayarın sahip olduğu uygulama isteği meta verileri, bildirim, yapılandırma profili seçimi veya telemetri yönlendirme anahtarlarını geçersiz kılamaz. Codex, projeye yerel bir .codex/config.toml içinde yer aldıklarında openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url ve otel anahtarlarını yok sayar; bunun yerine sağlayıcı, bildirim ve telemetri anahtarlarını kullanıcı düzeyindeki yapılandırmaya yerleştirin. Yapılandırma profil dosyaları, config.toml dosyasının yanında $CODEX_HOME/profile-name.config.toml olarak bulunur; --profile profile-name ile bunlardan birini seçin.

Korumalı alan ve onay anahtarları (approval_policy, sandbox_mode ve sandbox_workspace_write.*) için bu referansı Korumalı alan ve onaylar, Yazılabilir köklerdeki korumalı yollar ve Ağ erişimi ile birlikte kullanın. Beta izin profilleri için İzinler bölümüne bakın.

Codex ve ChatGPT Work artık approval_policy = "untrusted" ayarını desteklemiyor. Ayarı kaldırın veya desteklenen bir politika seçin. Kullanıcı düzeyindeki yapılandırmada trust_level = "untrusted" içeren ~/.codex/config.toml proje girdileri desteklenmeye devam eder. Örnekler ve Kullanımdan kaldırılan untrusted onay politikasından geçiş bölümünde açıklanan onay seçeneklerinin avantaj ve dezavantajları hakkında bilgi edinin.

model değerini, oturum açtığınız hesapta veya çalışma alanında kullanılabilen bir model olarak ayarlayın. Örnek değeri kullanmadan önce GPT-6.1 Sol kullanılabilirliği bölümüne bakın.

Anahtar Tür / değerler Ayrıntılar
agents table Çoklu ajan ayarları ve özel rol bildirimleri. Skaler ayar adları ayrılmıştır ve özel rol adı olarak kullanılamaz.
agents.<name>.config_file string (path) Bu rolün TOML yapılandırma katmanının yolu; göreli yollar, rolü bildiren yapılandırma dosyasına göre çözümlenir.
agents.<name>.description string Bu ajan türünü seçerken ve başlatırken Codex'e gösterilen rol yönergeleri.
agents.default_subagent_model string Başlatılan ajanlar için varsayılan model. Başlatma sırasında açıkça belirtilen model önceliklidir.
agents.default_subagent_reasoning_effort string Başlatılan ajanlar için varsayılan akıl yürütme çabası. Başlatma sırasında açıkça belirtilen çaba önceliklidir.
agents.enabled boolean Çoklu ajan araçlarını etkinleştirir veya devre dışı bırakır (varsayılan: true).
agents.interrupt_message boolean Bir ajan turu kesintiye uğradığında modelin görebileceği bir mesaj kaydeder (varsayılan: true).
agents.max_concurrent_threads_per_session number Ana konuşma hariç, aynı anda açık olabilen başlatılmış ajan konuşmalarının azami sayısı. Ayarlanmazsa varsayılanı Codex seçer.
agents.max_threads number Şu ayarın eski takma adı: agents.max_concurrent_threads_per_session.
allow_login_shell boolean Kabuk tabanlı araçların oturum açma kabuğu davranışını kullanmasına izin verir. Varsayılan değer true; değer false olduğunda login = true istekleri reddedilir ve login belirtilmezse varsayılan olarak oturum açma kabuğu olmayan kabuklar kullanılır.
analytics.enabled boolean Bu makine/profil için analitiği etkinleştirir veya devre dışı bırakır. Ayarlanmazsa istemcinin varsayılanı geçerlidir.
approval_policy on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } Codex'in komutları çalıştırmadan önce ne zaman onay için duraklayacağını belirler. Ayrıca approval_policy = { granular = { ... } } ile belirli istem kategorilerine izin verebilir veya bunları otomatik olarak reddedebilir, diğer istemleri etkileşimli tutabilirsiniz. untrusted desteklenmez ve on-failure kullanımdan kaldırılmıştır; etkileşimli çalıştırmalar için on-request, etkileşimsiz çalıştırmalar için never kullanın.
approval_policy.granular.mcp_elicitations boolean Değer true olduğunda MCP bilgi toplama istemlerinin otomatik reddedilmek yerine gösterilmesine izin verilir.
approval_policy.granular.request_permissions boolean Değer true olduğunda request_permissions aracından gelen istemlerin gösterilmesine izin verilir.
approval_policy.granular.rules boolean Değer true olduğunda execpolicy prompt kurallarının tetiklediği onay istemlerinin gösterilmesine izin verilir.
approval_policy.granular.sandbox_approval boolean Değer true olduğunda korumalı alan yetkilerini yükseltmeye yönelik onay istemlerinin gösterilmesine izin verilir.
approval_policy.granular.skill_approval boolean Değer true olduğunda beceri betiklerine yönelik onay istemlerinin gösterilmesine izin verilir.
approvals_reviewer user | auto_review Şu politika veya ayrıntılı onay politikaları kapsamındaki uygun onay istemlerini kimin inceleyeceği: on-request. Varsayılan değer user; auto_review inceleyici alt ajanı kullanır. Bu ayar, korumalı alan uygulamasını değiştirmez veya korumalı alan içinde zaten izin verilen eylemleri incelemeye almaz.
apps._default.approvals_reviewer user | auto_review Uygulama bazında geçersiz kılınmadıkça uygulama araçlarının onay istemleri için varsayılan inceleyici. Belirtilmezse uygulamalar üst düzey approvals_reviewer değerini devralır.
apps._default.default_tools_approval_mode auto | prompt | writes | approve Uygulama veya araç bazında geçersiz kılma ayarı bulunmayan uygulama araçlarının varsayılan onay davranışı.
apps._default.destructive_enabled boolean Şu özelliğe sahip uygulama araçları için varsayılan izin/ret ayarı: destructive_hint = true.
apps._default.enabled boolean Uygulama bazında geçersiz kılınmadıkça tüm uygulamaların varsayılan etkinlik durumu.
apps._default.open_world_enabled boolean Şu özelliğe sahip uygulama araçları için varsayılan izin/ret ayarı: open_world_hint = true.
apps.<id>.approvals_reviewer user | auto_review Bu uygulamanın araç onay istemlerinin inceleyicisi. Geçersiz kıldığı ayar: apps._default.approvals_reviewer.
apps.<id>.default_tools_approval_mode auto | prompt | writes | approve Araç bazında geçersiz kılma ayarı bulunmadıkça bu uygulamadaki araçların varsayılan onay davranışı.
apps.<id>.default_tools_enabled boolean Araç bazında geçersiz kılma ayarı bulunmadıkça bu uygulamadaki araçların varsayılan etkinlik durumu.
apps.<id>.destructive_enabled boolean Bu uygulamada destructive_hint = true özelliğini bildiren araçlara izin verir veya bunları engeller.
apps.<id>.enabled boolean Belirli bir uygulamayı/bağlayıcıyı kimliğine göre etkinleştirir veya devre dışı bırakır (varsayılan: true).
apps.<id>.open_world_enabled boolean Bu uygulamada open_world_hint = true özelliğini bildiren araçlara izin verir veya bunları engeller.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Tek bir uygulama aracının onay davranışını araç bazında geçersiz kılma ayarı.
apps.<id>.tools.<tool>.enabled boolean Bir uygulama aracının etkinlik durumunu araç bazında geçersiz kılma ayarı (örneğin repos/list).
auto_review.extra_policy string Otomatik inceleme için ana politikayla birlikte eklenen yerel Markdown ek politikası. Yönetilen guardian_extra_policy önceliklidir. Boş değerler yok sayılır.
auto_review.policy string Otomatik inceleme için yerel Markdown politika talimatları. Yönetilen guardian_policy_config önceliklidir. Boş değerler yok sayılır.
background_terminal_max_timeout number Boş write_stdin yoklamaları için milisaniye cinsinden azami yoklama penceresi (arka planda terminal yoklaması). Varsayılan: 300000 (5 dakika). Eski background_terminal_timeout anahtarının yerini alır.
browser_use.allow_history_access boolean Tarayıcı geçmişine erişimi kısıtlamak için false olarak ayarlayın. Yönetilen gereksinimler bu kısıtlamayı zorunlu kılabilir.
browser_use.default_origin_policy table Tarayıcı kaynakları için yedek kısıtlamalar. Desteklenen alanlar: access, uploads, downloads ve full_cdp_access; her biri allow veya deny olarak ayarlanır.
browser_use.origins.<origin> table Kaynak başına tarayıcı kısıtlamaları; şu ayarla aynı alanları kullanır: browser_use.default_origin_policy. HTTP veya HTTPS şemasını ve isteğe bağlı bağlantı noktasını ekleyin; yolları, sorguları ve parçaları eklemeyin. Yerel değerler yönetilen ret kurallarını gevşetemez.
chatgpt_base_url string ChatGPT oturum açma akışında kullanılan temel URL'yi geçersiz kılar.
check_for_update_on_startup boolean Başlangıçta Codex güncellemelerini denetler (yalnızca güncellemeler merkezi olarak yönetiliyorsa false olarak ayarlayın).
cli_auth_credentials_store file | keyring | auto | ephemeral CLI'nin önbelleğe alınmış kimlik bilgilerini nerede saklayacağını belirler.
compact_prompt string Geçmiş sıkıştırma prompt'ını satır içinde geçersiz kılma ayarı.
computer_use.default_app_access allow | deny Computer Use için yerel uygulamalara yönelik yedek erişim politikası. Uygulamaya özgü girdiler bir politika sağlayabilir; yerel yapılandırma yönetilen kısıtlamaları gevşetemez.
computer_use.macos.bundle_ids map<string, allow | deny> Paket tanımlayıcısı anahtarıyla belirtilen yerel macOS uygulaması erişimi.
computer_use.windows.always_allowed_app_ids array<string> Computer Use tarafından onay istenmeden açılabilen Windows uygulamalarının tanımlayıcıları. Listede bulunmayan uygulamalar onay gerektirir; kayıtlı girdileri ChatGPT masaüstü uygulamasının Computer Use ayarlarından kaldırın.
computer_use.windows.aumids map<string, allow | deny> Application User Model ID (AUMID) anahtarıyla belirtilen paketlenmiş Windows uygulaması erişimi.
computer_use.windows.exes array<table> Windows yürütülebilir dosya erişim kuralları. Her kuralda publisher_name, product_name ve access (allow veya deny) zorunludur; binary_name isteğe bağlıdır.
default_permissions string Korumalı alandaki araç çağrılarına uygulanacak varsayılan izin profilinin adı. Yerleşik profiller :read-only, :workspace ve :danger-full-access; özel profil adları eşleşen [permissions.&lt;name&gt;] tabloları gerektirir. sandbox_mode veya [sandbox_workspace_write] ile birlikte kullanmayın.
desktop.custom_file_handlers.<id> table Yalnızca kullanıcı düzeyinde kullanılabilir. ChatGPT masaüstü uygulaması için ek bir Open in hedefi tanımlar. Örnekler ve işleyici kimliği kısıtlamaları için Özel dosya işleyicileri ekleme bölümüne bakın.
desktop.custom_file_handlers.<id>.args array<string> Komut ile dosya girdisi arasına eklenen argümanlar (varsayılan: []).
desktop.custom_file_handlers.<id>.command string Algılanacak ve başlatılacak yürütülebilir dosyanın yolu veya komut adı. Zorunludur.
desktop.custom_file_handlers.<id>.icon string İşleyici simgesi için paketle gelen varlığın yolu, Base64 kodlamalı data:image/... URL'si, dosya URI'si veya mutlak yerel yol. Zorunludur; desteklenmeyen kaynaklarda varsayılan VS Code simgesi kullanılır.
desktop.custom_file_handlers.<id>.input path | json_argument | json_stdin Uygulamanın dosya girdisini işleyiciye nasıl gönderdiği (varsayılan: path).
desktop.custom_file_handlers.<id>.label string Open in menülerinde gösterilen ad. Zorunludur.
desktop.custom_file_handlers.<id>.supports_ssh boolean SSH çalışma alanlarındaki dosyalar için işleyiciyi sunar (varsayılan: false).
developer_instructions string Oturuma eklenen ek geliştirici talimatları (isteğe bağlı).
disable_paste_burst boolean TUI'de hızlı toplu yapıştırma algılamasını devre dışı bırakır.
experimental_compact_prompt_file string (path) Sıkıştırma prompt'ını geçersiz kılan içeriği bir dosyadan yükler (deneysel).
experimental_use_unified_exec_tool boolean Birleşik exec'i etkinleştirmek için kullanılan eski ad; [features].unified_exec veya codex --enable unified_exec tercih edin.
features.apps boolean Uygulama (bağlayıcı) entegrasyonlarını etkinleştirir (kararlı; varsayılan olarak açık). Uygulama ve bağlayıcı trafiği, korumalı alandaki komutların ağ proxy'si veya bu proxy'nin alan adı izin listesi tarafından denetlenmez.
features.code_mode.direct_only_tool_namespaces array<string> Kod modunun yalnızca doğrudan araç çağrıları aracılığıyla kullanabildiği araç ad alanları.
features.code_mode.enabled boolean Kod modu özelliğinin yapılandırmasını etkinleştirir. Bu özellik geliştirme aşamasındadır ve varsayılan olarak kapalıdır.
features.code_mode.excluded_tool_namespaces array<string> Kod modunun, iç içe kod modu araç yönergelerinden ve yürütücüye sunulan araçlardan hariç tuttuğu araç ad alanları.
features.context_management.experimental_mode boolean Deneysel bağlam yönetimi ayarı. Özellik şu anda kullanılamamaktadır.
features.enable_request_compression boolean Desteklendiğinde akış isteklerinin gövdelerini zstd ile sıkıştırır (kararlı; varsayılan olarak açık).
features.fast_mode boolean TUI'de model kataloğu hizmet katmanı seçimini, etkin model bildirdiğinde Fast katmanı komutları da dâhil olmak üzere etkinleştirir (kararlı; varsayılan olarak açık).
features.goals boolean Kalıcı hedefleri ve otomatik devam etmeyi etkinleştirir (kararlı; varsayılan olarak açık).
features.hooks boolean Şu kaynaktan yüklenen yaşam döngüsü kancalarını etkinleştirir: hooks.json veya satır içi [hooks] yapılandırması. features.codex_hooks kullanımdan kaldırılmış bir takma addır.
features.memories boolean Anıları etkinleştirir (varsayılan olarak kapalı).
features.multi_agent boolean Çoklu ajan iş birliği araçlarını (spawn_agent, send_input, resume_agent, wait_agent ve close_agent) etkinleştirir (kararlı; varsayılan olarak açık).
features.network_proxy boolean | table Korumalı alandaki komutlar için ağ proxy'sini başlatır (deneysel; varsayılan olarak kapalı). Yönetici tarafından yönetilen ve etkinleştirilmiş experimental_network gereksinimleri proxy'yi başlatmadıkça, izin profilinin alan adı kurallarını uygulamak için gereklidir. domains gibi özellik düzeyindeki politika seçeneklerini ayarlarken bir tablo kullanın. Web aramasını, uygulamaları, MCP'yi veya diğer barındırılan araçları filtrelemez.
features.network_proxy.allow_local_binding boolean Daha geniş yerel/özel ağ erişimine izin verir. Varsayılan değer false; tam yerel IP adresi veya localhost izin kuralları yine de belirli yerel hedeflere izin verebilir.
features.network_proxy.allow_upstream_proxy boolean Ortamda tanımlı bir üst proxy üzerinden zincirleme bağlantıya izin verir. Varsayılan değer: true.
features.network_proxy.dangerously_allow_all_unix_sockets boolean Yalnızca izin listesine erişim yerine herhangi bir Unix soketi hedefine izin verir. Varsayılan değer false; yalnızca sıkı denetlenen ortamlarda kullanın.
features.network_proxy.dangerously_allow_non_loopback_proxy boolean Geri döngü dışındaki dinleyici adreslerine izin verir. Varsayılan değer false; etkinleştirilmesi proxy dinleyicilerini localhost dışından erişilebilir hâle getirebilir.
features.network_proxy.domains map<string, allow | deny> Korumalı ağ erişimi için alan adı politikası. Varsayılan olarak ayarlanmamıştır; bu nedenle allow kuralları eklenene kadar hiçbir dış hedefe izin verilmez. Tam ana makine adlarını, yalnızca alt alan adları için *.example.com, kök alan adı ve alt alan adları için **.example.com ve genel * izin kurallarını destekler. * dışarıya genel ağ erişimini geniş ölçüde açtığından, kapsamı daraltılmış kuralları tercih edin. Engellenecek hedefler için deny kuralları ekleyin; çakışmalarda deny önceliklidir.
features.network_proxy.enable_socks5 boolean SOCKS5 desteğini sunar. Varsayılan değer: true.
features.network_proxy.enable_socks5_udp boolean SOCKS5 üzerinden UDP'ye izin verir. Varsayılan değer: true.
features.network_proxy.enabled boolean Komutların ağ erişimi etkinleştirildiğinde korumalı alandaki komutların ağ proxy'sini başlatır. Varsayılan değer false; proxy kapalıyken izin profilinin alan adı kuralları uygulanmaz.
features.network_proxy.proxy_url string Korumalı ağ erişimi için HTTP dinleyicisi URL'si. Varsayılan değer: "http://127.0.0.1:3128".
features.network_proxy.socks_url string SOCKS5 dinleyicisi URL'si. Varsayılan değer: "http://127.0.0.1:8081".
features.network_proxy.unix_sockets map<string, allow | deny> Korumalı ağ erişimi için Unix soketi politikası. Varsayılan olarak ayarlanmamıştır; izin verilen soketler için allow girdileri ekleyin.
features.personality boolean Kişilik seçimi denetimlerini etkinleştirir (kararlı; varsayılan olarak açık).
features.prevent_idle_sleep boolean Bir tur etkin olarak çalışırken makinenin uykuya geçmesini önler (deneysel; varsayılan olarak kapalı).
features.remote_plugin boolean Uzak eklenti kataloğunu etkinleştirir (kararlı; varsayılan olarak açık).
features.rollout_budget.enabled boolean Yürütme bütçesi takibini etkinleştirir. Bu özellik geliştirme aşamasındadır ve varsayılan olarak kapalıdır. Etkinleştirildiğinde features.rollout_budget.limit_tokens zorunludur.
features.rollout_budget.limit_tokens integer Yürütme bütçesi takibi için pozitif token sınırı. Yürütme bütçesi etkinleştirildiğinde zorunludur.
features.rollout_budget.prefill_token_weight number Yürütme bütçesi hesabında ön doldurma tokenları için sonlu, negatif olmayan çarpan. Varsayılan değer: 1.0.
features.rollout_budget.reminder_interval_tokens integer Yürütme bütçesi hatırlatmaları arasındaki pozitif token aralığı. Varsayılanı, limit_tokens değerinin %10'udur; en az 1 token olmalıdır.
features.rollout_budget.sampling_token_weight number Yürütme bütçesi hesabında örneklenen tokenlar için sonlu, negatif olmayan çarpan. Varsayılan değer: 1.0.
features.shell_snapshot boolean Tekrarlanan komutları hızlandırmak için kabuk ortamının anlık görüntüsünü alır (kararlı; varsayılan olarak açık).
features.shell_tool boolean Komut çalıştırmak için varsayılan shell aracını etkinleştirir (kararlı; varsayılan olarak açık).
features.skill_mcp_dependency_install boolean Becerilerin eksik MCP bağımlılıkları için istem gösterilmesine ve kurulum yapılmasına izin verir (kararlı; varsayılan olarak açık).
features.unified_exec boolean Birleşik PTY destekli exec aracını kullanır (kararlı; Windows dışında varsayılan olarak etkin).
features.web_search boolean Kullanımdan kaldırılmış eski açma/kapatma ayarı; üst düzey web_search ayarını tercih edin.
features.web_search_cached boolean Kullanımdan kaldırılmış eski açma/kapatma ayarı. web_search ayarlanmamışsa true değeri web_search = "cached" değerine eşlenir.
features.web_search_request boolean Kullanımdan kaldırılmış eski açma/kapatma ayarı. web_search ayarlanmamışsa true değeri web_search = "live" değerine eşlenir.
feedback.enabled boolean Yerel istemcilerde /feedback aracılığıyla geri bildirim gönderimini etkinleştirir (varsayılan: true).
file_opener vscode | vscode-insiders | windsurf | cursor | none Codex çıktısındaki kaynak atıflarını açmak için kullanılan URI şeması (varsayılan: vscode).
forced_chatgpt_workspace_id string (uuid) ChatGPT oturum açma işlemlerini belirli bir çalışma alanı tanımlayıcısıyla sınırlar.
forced_login_method chatgpt | api Codex'i belirli bir kimlik doğrulama yöntemiyle sınırlar.
hide_agent_reasoning boolean Akıl yürütme olaylarını hem TUI'de hem de codex exec çıktısında gizler.
history.max_bytes number Ayarlanırsa en eski girdileri silerek geçmiş dosyasının boyutunu bayt cinsinden sınırlar.
history.persistence save-all | none Codex'in oturum dökümlerini history.jsonl dosyasına kaydedip kaydetmeyeceğini belirler.
hooks table Şurada satır içinde yapılandırılan yaşam döngüsü kancaları: config.toml. hooks.json ile aynı olay şemasını kullanır; örnekler ve desteklenen olaylar için Kancalar kılavuzuna bakın.
hooks.<Event> array<table> Şu kanca olayları için eşleştirici grupları: PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop veya Interrupt.
hooks.<Event>[].hooks array<table> Bir eşleştirici grubunun kanca işleyicileri. Komut ve MCP aracı kancaları desteklenir; prompt ve ajan kancası işleyicileri ise ayrıştırılır ancak atlanır.
hooks.<Event>[].hooks[].additionalContextLimit integer Fazla büyük additionalContext içeriğini diske kaydedip modele daha kısa bir önizleme göstermek için işleyici başına yaklaşık token eşiği. Varsayılan değer 2500; 0 bağlamın tamamını doğrudan modele iletir. Büyük kanca çıktısı bölümüne bakın.
hooks.<Event>[].hooks[].async boolean Bir komut kancasını, tetikleyen işlemi geciktirmeden arka planda çalıştırır. Varsayılan değer false; SessionEnd her zaman eşzamanlı çalışır. Kancaları arka planda çalıştırma bölümüne bakın.
hooks.<Event>[].hooks[].commandWindows string Komut kancaları için yalnızca Windows'a özgü komut geçersiz kılma ayarı. TOML takma adı command_windows da kabul edilir.
instructions string Gelecekte kullanılmak üzere ayrılmıştır; model_instructions_file veya AGENTS.md tercih edin.
log_dir string (path) Codex'in günlük dosyalarını yazdığı dizin; varsayılanı $CODEX_HOME/log. Bu ayarın açıkça belirtilmesi, isteğe bağlı düz metin TUI günlüğünü, codex-tui.log, de bu dizinde etkinleştirir.
marketplaces.<name>.ref string Pazar yeri için isteğe bağlı Git dalı, etiketi veya commit'i.
marketplaces.<name>.source string Git deposunun konumu veya yerel pazar yerinin kök dizini. Yerel kaynak için mutlak yol kullanın; dizin .agents/plugins/marketplace.json dosyasını içerir.
marketplaces.<name>.source_type git | local Yapılandırılmış bir eklenti pazar yerinin kaynak türü. Pazar yerleri sistem, bulut tarafından yönetilen, kullanıcı veya güvenilir proje config.toml dosyasında tanımlanabilir.
marketplaces.<name>.sparse_paths array<string> Bir Git pazar yeri için isteğe bağlı seyrek çalışma kopyası yolları. Pazar yeri kataloğunu ve başvurduğu tüm yerel eklenti dizinlerini ekleyin.
mcp_oauth_callback_port integer MCP OAuth oturum açma sırasında kullanılan yerel HTTP geri çağrı sunucusu için isteğe bağlı genel sabit bağlantı noktası. Sunucuya özgü oauth.callback_port önceliklidir. Hiçbiri ayarlanmazsa Codex, işletim sisteminin seçtiği geçici bir bağlantı noktasına bağlanır.
mcp_oauth_callback_url string MCP OAuth oturum açma için isteğe bağlı temel geri çağrı URL'si; örneğin bir geliştirme makinesinin giriş URL'si. Yeni eklenen, önceden kaydedilmiş istemciler, yetkilendirme sunucusu issuer (kimlik sağlayıcısı) tanımlamasını desteklediğinde bu URL'yi değiştirmeden kullanır; kayıtlı geri çağrısı olmayan mevcut istemciler sunucuya özgü bir geri çağrı kimliği ekler. Issuer tanımlama desteği olmadan, yapılandırılmış geri çağrısında gerekli kimlik bulunmayan önceden kaydedilmiş MCP server'ları, yedek olarak kimliğin eklendiği bu URL'yi kullanır. Geri çağrı URL'sindeki bağlantı noktaları dinleyicinin bağlantı noktasını belirlemez.
mcp_oauth_credentials_store auto | file | keyring MCP OAuth kimlik bilgileri için tercih edilen depolama alanı.
mcp_optional_startup_grace_ms integer (milliseconds) İlk araç kataloğu oluşturulurken isteğe bağlı MCP server'ları için paylaşılan bekleme süresi. Varsayılan değer 1000. Bunun yerine her sunucunun startup_timeout_sec süresini beklemek için değeri 0 olarak ayarlayın.
mcp_servers.<id>.args array<string> MCP stdio server komutuna geçirilen argümanlar.
mcp_servers.<id>.auth oauth | chatgpt Bir MCP HTTP server için yapılandırılmış bearer tokenları ve yetkilendirme başlıklarından sonra kullanılan yedek kimlik doğrulama yöntemi. oauth (varsayılan), mevcut olduğunda kayıtlı MCP OAuth kimlik bilgilerini kullanır. chatgpt, güvenilir birinci taraf ChatGPT kaynağı için geçerli ChatGPT oturumunu kullanır, ardından yedek olarak kayıtlı OAuth bilgilerine başvurur. Hiçbir kimlik bilgisi kaynağı sonuç vermezse her iki mod da kimlik doğrulama olmadan bağlanabilir.
mcp_servers.<id>.bearer_token_env_var string Bir MCP HTTP server'ın bearer tokenını sağlayan ortam değişkeni.
mcp_servers.<id>.command string Bir MCP stdio server'ın başlatıcı komutu.
mcp_servers.<id>.cwd string MCP stdio server sürecinin çalışma dizini.
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve Araç bazında geçersiz kılma ayarı bulunmadıkça bu sunucudaki MCP araçlarının varsayılan onay davranışı.
mcp_servers.<id>.disabled_tools array<string> MCP server için enabled_tools sonrasında uygulanan ret listesi.
mcp_servers.<id>.enabled boolean Bir MCP server'ı yapılandırmasını kaldırmadan devre dışı bırakır.
mcp_servers.<id>.enabled_tools array<string> MCP server'ın sunduğu araç adlarının izin listesi.
mcp_servers.<id>.env map<string,string> MCP stdio server'a iletilen ortam değişkenleri.
mcp_servers.<id>.env_http_headers map<string,string> Bir MCP HTTP server için ortam değişkenlerinden doldurulan HTTP başlıkları.
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> Bir MCP stdio server için izin listesine eklenecek ortam değişkenleri. Dize girdilerinin varsayılanı source = "local"; source = "remote" değerini yalnızca yürütücü destekli uzak stdio ile kullanın.
mcp_servers.<id>.experimental_environment local | remote Bir MCP server için deneysel yerleşim ayarı. remote stdio sunucularını uzak bir yürütücü ortamı üzerinden başlatır; akış destekli HTTP için uzak yerleşim henüz uygulanmamıştır.
mcp_servers.<id>.http_headers map<string,string> Her MCP HTTP isteğine eklenen sabit HTTP başlıkları.
mcp_servers.<id>.http_headers_helper string (command) HTTP başlık adlarını ve değerlerini içeren bir JSON nesnesi yazdıran yerel komut. Yalnızca yerel olarak bağlanılan HTTP MCP server'ları için desteklenir. Açıkça belirtilen bearer tokenları ve OAuth kimlik bilgileri, yardımcı aracın sağladığı Authorization başlıklarından önceliklidir.
mcp_servers.<id>.oauth_resource string MCP oturum açma işlemi sırasında eklenecek isteğe bağlı RFC 8707 OAuth kaynak parametresi.
mcp_servers.<id>.oauth.callback_port integer Bu MCP server için sabit OAuth geri çağrı dinleyicisi bağlantı noktası. Geçersiz kıldığı ayar: mcp_oauth_callback_port. URL'de açıkça belirtilmiş bağlantı noktası olan doğrudan bir geri döngü geri çağrısı için aynı dinleyici bağlantı noktasını yapılandırın.
mcp_servers.<id>.oauth.callback_url string Sunucuya özgü OAuth geri çağrısı. Önceden kaydedilmiş istemciler, issuer (kimlik sağlayıcısı) tanımlaması destekleniyorsa veya URL zaten sunucuya özgü geri çağrı kimliğiyle bitiyorsa bunu yeniden kullanır. Aksi takdirde Codex, bu kimliği ekleyerek genel veya varsayılan geri çağrıyı kullanır. Önceden kaydedilmiş kimliği olmayan istemciler, istemci kaydı sırasında bu geri çağrıyı kullanır.
mcp_servers.<id>.oauth.client_id string Bu MCP server'la yetkilendirme ve token alışverişi için kullanılan, önceden kaydedilmiş OAuth istemci kimliği.
mcp_servers.<id>.required boolean Değer true olduğunda, etkin durumdaki bu MCP server başlatılamazsa başlatma/devam ettirme işlemi başarısız olur.
mcp_servers.<id>.scopes array<string> Bu MCP server'da kimlik doğrulama yapılırken istenecek OAuth kapsamları.
mcp_servers.<id>.startup_timeout_ms number Şu ayarın milisaniye cinsinden takma adı: startup_timeout_sec.
mcp_servers.<id>.startup_timeout_sec number Bir MCP server'ın varsayılan 10 saniyelik başlatma zaman aşımını geçersiz kılar.
mcp_servers.<id>.tool_timeout_sec number Bir MCP server'ın varsayılan 60 saniyelik araç başına zaman aşımını geçersiz kılar.
mcp_servers.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Bu sunucudaki tek bir MCP aracının onay davranışını araç bazında geçersiz kılma ayarı.
mcp_servers.<id>.tools.<tool>.output_token_limit integer (positive) Standart %20 serileştirme payı eklenmeden önce, tek bir MCP aracının çıktısının token bütçesi. Modelin bu araç için varsayılan çıktı kısaltma bütçesini geçersiz kılar.
mcp_servers.<id>.url string Akış destekli bir MCP HTTP server'ın uç noktası.
memories.consolidation_model string Genel anı birleştirmesi için isteğe bağlı model geçersiz kılma ayarı.
memories.disable_on_external_context boolean Değer true olduğunda MCP aracı çağrıları, web araması veya araç araması gibi dış bağlam kullanan konuşmalar anı oluşturma sürecinin dışında tutulur. Varsayılan değer: false. Eski takma ad: memories.no_memories_if_mcp_or_web_search.
memories.extract_model string Konuşma başına anı çıkarımı için isteğe bağlı model geçersiz kılma ayarı.
memories.generate_memories boolean Değer false olduğunda yeni oluşturulan konuşmalar anı oluşturma girdileri olarak saklanmaz. Varsayılan değer: true.
memories.max_raw_memories_for_consolidation number Genel birleştirme için saklanan son ham anıların azami sayısı. Varsayılan değer 256, üst sınır ise 4096.
memories.max_rollout_age_days number Anı oluşturmak için değerlendirilen konuşmaların azami yaşı. Varsayılan değer 30 olup 0-90 aralığıyla sınırlandırılır.
memories.max_rollouts_per_startup number Her başlatma geçişinde işlenen azami yürütme adayı sayısı. Varsayılan değer 16, üst sınır ise 128.
memories.max_unused_days number Bir anının birleştirmeye uygun olmaktan çıkmadan önce son kullanımından itibaren geçebilecek azami gün sayısı. Varsayılan değer 30 olup 0-365 aralığıyla sınırlandırılır.
memories.min_rate_limit_remaining_percent number Anı oluşturma başlamadan önce Codex kullanım sınırı pencerelerinde bulunması gereken asgari kalan yüzde. Varsayılan değer 25 olup 0-100 aralığıyla sınırlandırılır.
memories.min_rollout_idle_hours number Bir konuşmanın anı oluşturmak için değerlendirilmesinden önce gereken asgari boşta kalma süresi. Varsayılan değer 6 olup 1-48 aralığıyla sınırlandırılır.
memories.use_memories boolean Değer false olduğunda Codex, mevcut anıları gelecekteki oturumlara eklemeyi atlar. Varsayılan değer: true.
model string Kullanılacak model (ör. gpt-6.1-sol).
model_auto_compact_token_limit number Geçmişin otomatik sıkıştırılmasını tetikleyen token eşiği (ayarlanmazsa modelin varsayılanları kullanılır).
model_auto_compact_token_limit_scope total | body_after_prefix Otomatik sıkıştırma eşiğinin etkin bağlamın tamamını mı (total, varsayılan), yoksa yalnızca taşınan sıkıştırma penceresi önekinden sonraki büyümeyi mi (body_after_prefix) sayacağını belirler.
model_catalog_json string (path) Başlangıçta yüklenen JSON model kataloğunun isteğe bağlı yolu. Seçilen bir $CODEX_HOME/profile-name.config.toml profil dosyası bu ayarı profil bazında geçersiz kılabilir.
model_context_window number Etkin modelin kullanabileceği bağlam penceresi token sayısı.
model_instructions_file string (path) Yerleşik talimatların yerine kullanılacak içerik; AGENTS.md yerine kullanılır.
model_provider string Sağlayıcı kimliğinin alındığı yer: model_providers (varsayılan: openai).
model_providers.<id> table Özel sağlayıcı tanımı. Yerleşik sağlayıcı kimlikleri (openai, ollama ve lmstudio) ayrılmıştır ve geçersiz kılınamaz.
model_providers.<id>.auth table Özel bir sağlayıcı için komut tabanlı bearer token yapılandırması. env_key, experimental_bearer_token veya requires_openai_auth ile birlikte kullanmayın.
model_providers.<id>.auth.args array<string> Token komutuna geçirilen argümanlar.
model_providers.<id>.auth.command string Codex bir bearer tokenına ihtiyaç duyduğunda çalıştırılacak komut. Komut, tokenı stdout'a yazdırmalıdır.
model_providers.<id>.auth.cwd string (path) Token komutunun çalışma dizini.
model_providers.<id>.auth.refresh_interval_ms number Codex'in tokenı önceden yenileme aralığı, milisaniye cinsinden (varsayılan: 300000). Yalnızca kimlik doğrulama yeniden denemesinden sonra yenilemek için 0 olarak ayarlayın.
model_providers.<id>.auth.timeout_ms number Token komutunun milisaniye cinsinden azami çalışma süresi (varsayılan: 5000).
model_providers.<id>.base_url string Model sağlayıcısının API temel URL'si.
model_providers.<id>.env_http_headers map<string,string> Mevcut olduğunda ortam değişkenlerinden doldurulan HTTP başlıkları.
model_providers.<id>.env_key string Sağlayıcının API key değerini sağlayan ortam değişkeni.
model_providers.<id>.env_key_instructions string Sağlayıcının API key değeri için isteğe bağlı kurulum yönergeleri.
model_providers.<id>.experimental_bearer_token string Sağlayıcının doğrudan bearer tokenı (önerilmez; env_key kullanın).
model_providers.<id>.http_headers map<string,string> Sağlayıcı isteklerine eklenen sabit HTTP başlıkları.
model_providers.<id>.name string Özel model sağlayıcısının görünen adı.
model_providers.<id>.query_params map<string,string> Sağlayıcı isteklerine eklenen ek sorgu parametreleri.
model_providers.<id>.request_max_retries number Sağlayıcıya gönderilen HTTP isteklerinin yeniden deneme sayısı (varsayılan: 4).
model_providers.<id>.requires_openai_auth boolean Sağlayıcı OpenAI kimlik doğrulamasını kullanır (varsayılan: false).
model_providers.<id>.stream_idle_timeout_ms number SSE akışlarının milisaniye cinsinden boşta kalma zaman aşımı (varsayılan: 300000).
model_providers.<id>.stream_max_retries number SSE akış kesintileri için yeniden deneme sayısı (varsayılan: 5).
model_providers.<id>.supports_standalone_web_search boolean Uyumlu, bağımsız bir web araması uç noktası desteğini bildirir (varsayılan: false). Bağımsız arama hâlâ geliştirme aşamasındadır ve varsayılan olarak kapalıdır; sağlayıcı uyumluluğu tek başına bu özelliği etkinleştirmez.
model_providers.<id>.supports_websockets boolean Bu sağlayıcının Responses API WebSocket aktarımını destekleyip desteklemediği.
model_providers.<id>.wire_api responses Sağlayıcının kullandığı protokol. responses desteklenen tek değerdir ve belirtilmediğinde varsayılan olarak kullanılır.
model_providers.amazon-bedrock.aws.profile string Yerleşik amazon-bedrock sağlayıcısının kullandığı AWS profil adı.
model_providers.amazon-bedrock.aws.region string Yerleşik amazon-bedrock sağlayıcısının kullandığı AWS bölgesi.
model_reasoning_effort string Seçilen modelin bildirdiği akıl yürütme çabası; örneğin low, medium, high, xhigh, max veya ultra. Kullanılabilir düzeyler modele ve istemciye bağlıdır.
model_reasoning_summary auto | concise | detailed | none Akıl yürütme özetinin ayrıntı düzeyini seçer veya özetleri tamamen devre dışı bırakır.
model_supports_reasoning_summaries boolean Codex'in akıl yürütme meta verilerini göndermesini veya göndermemesini zorunlu kılar.
model_verbosity low | medium | high İsteğe bağlı GPT-5 Responses API ayrıntı düzeyi geçersiz kılma ayarı; ayarlanmazsa seçilen modelin/ön ayarın varsayılanı kullanılır.
notice.hide_full_access_warning boolean Tam erişim uyarı isteminin onaylandığını izler.
notice.hide_gpt-5.1-codex-max_migration_prompt boolean gpt-5.1-codex-max geçiş isteminin onaylandığını izler.
notice.hide_gpt5_1_migration_prompt boolean GPT-5.1 geçiş isteminin onaylandığını izler.
notice.hide_rate_limit_model_nudge boolean Kullanım sınırı nedeniyle model değiştirme hatırlatmasının kapatıldığını izler.
notice.hide_world_writable_warning boolean Windows'ta herkesin yazabildiği dizinler uyarısının onaylandığını izler.
notice.model_migrations map<string,string> Onaylanan model geçişlerini eski->yeni eşlemeleri olarak izler.
notify array<string> Bildirimler için çağrılan komut; Codex'ten JSON biçiminde veri alır.
openai_base_url string Yerleşik openai model sağlayıcısının temel URL'sini geçersiz kılma ayarı.
oss_provider lmstudio | ollama Şununla çalıştırıldığında kullanılan varsayılan yerel sağlayıcı: --oss (ayarlanmazsa varsayılan olarak kullanıcıya sorulur).
otel.environment string Yayımlanan OpenTelemetry olaylarına uygulanan ortam etiketi (varsayılan: dev).
otel.exporter none | otlp-http | otlp-grpc OpenTelemetry dışa aktarıcısını seçer ve varsa uç nokta meta verilerini sağlar.
otel.exporter.<id>.endpoint string OTEL günlüklerinin dışa aktarıcı uç noktası.
otel.exporter.<id>.headers map<string,string> OTEL dışa aktarıcı isteklerine eklenen sabit başlıklar.
otel.exporter.<id>.protocol binary | json OTLP/HTTP dışa aktarıcısının kullandığı protokol.
otel.exporter.<id>.tls.ca-certificate string OTEL dışa aktarıcı TLS bağlantısının CA sertifikası yolu.
otel.exporter.<id>.tls.client-certificate string OTEL dışa aktarıcı TLS bağlantısının istemci sertifikası yolu.
otel.exporter.<id>.tls.client-private-key string OTEL dışa aktarıcı TLS bağlantısının istemci özel anahtarı yolu.
otel.log_user_prompt boolean Ham kullanıcı prompt'larının OpenTelemetry günlükleriyle dışa aktarılmasını isteğe bağlı olarak etkinleştirir.
otel.metrics_exporter none | statsig | otlp-http | otlp-grpc OpenTelemetry metrik dışa aktarıcısını seçer (varsayılan: statsig).
otel.trace_exporter none | otlp-http | otlp-grpc OpenTelemetry iz dışa aktarıcısını seçer ve varsa uç nokta meta verilerini sağlar.
otel.trace_exporter.<id>.endpoint string OTEL günlüklerinin iz dışa aktarıcı uç noktası.
otel.trace_exporter.<id>.headers map<string,string> OTEL iz dışa aktarıcı isteklerine eklenen sabit başlıklar.
otel.trace_exporter.<id>.protocol binary | json OTLP/HTTP iz dışa aktarıcısının kullandığı protokol.
otel.trace_exporter.<id>.tls.ca-certificate string OTEL iz dışa aktarıcı TLS bağlantısının CA sertifikası yolu.
otel.trace_exporter.<id>.tls.client-certificate string OTEL iz dışa aktarıcı TLS bağlantısının istemci sertifikası yolu.
otel.trace_exporter.<id>.tls.client-private-key string OTEL iz dışa aktarıcı TLS bağlantısının istemci özel anahtarı yolu.
permissions.<name>.description string Bu adlandırılmış profilin insanlar tarafından okunabilir açıklaması. Bir profil, üst profilinin açıklamasını extends aracılığıyla devralmaz.
permissions.<name>.extends string Bu adlandırılmış profilden önce uygulanan isteğe bağlı üst profil. Başka bir adlandırılmış profil, :read-only veya :workspace olarak ayarlayın; :danger-full-access, tanımsız üst profiller ve döngüler reddedilir.
permissions.<name>.filesystem table Adlandırılmış dosya sistemi izin profili. Her anahtar mutlak bir yol veya :minimal ya da :workspace_roots gibi özel bir belirteçtir.
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> "read" | "write" | "deny" Her etkin çalışma alanı köküne göre kapsamlandırılmış dosya sistemi erişimi. Kökün kendisi için "." kullanın; "**/*.env" gibi glob alt yolları, "deny" ile okumayı reddedebilir.
permissions.<name>.filesystem.<path-or-glob> "read" | "write" | "deny" | table Bir yola, glob desenine veya özel belirtece doğrudan erişim verir ya da iç içe girdileri bu kök altında kapsamlandırır. Eşleşen yollar için okumayı reddetmek üzere "deny" kullanın.
permissions.<name>.filesystem.glob_scan_max_depth number Korumalı alan başlatılmadan önce eşleşmelerin anlık görüntüsünü alan platformlarda, okumayı reddeden glob desenlerini genişletmek için azami derinlik. Ayarlanırsa en az 1 olmalıdır.
permissions.<name>.network.allow_local_binding boolean Korumalı ağ üzerinden daha geniş yerel/özel ağ erişimine izin verir. Tam yerel IP adresi veya localhost izin kuralları, bu değer false olarak kalsa da belirli yerel hedeflere izin verebilir.
permissions.<name>.network.allow_upstream_proxy boolean Korumalı ağ erişiminin başka bir üst proxy üzerinden zincirleme bağlanmasına izin verir.
permissions.<name>.network.dangerously_allow_all_unix_sockets boolean Varsayılan kısıtlı küme yerine herhangi bir Unix soketi hedefine izin verir. Yalnızca sıkı denetlenen ortamlarda kullanın.
permissions.<name>.network.dangerously_allow_non_loopback_proxy boolean Korumalı ağ dinleyicileri için geri döngü dışındaki bağlanma adreslerine izin verir. Etkinleştirilmesi dinleyicileri localhost dışından erişilebilir hâle getirebilir.
permissions.<name>.network.domains table Korumalı alandaki komutlar için alan adı kuralları. Yalnızca features.network_proxy veya yönetici tarafından yönetilen etkin ağ gereksinimleri proxy'yi etkinleştirdiğinde uygulanır. Tam ana makine adlarını, *.example.com, **.example.com ve genel * izin kurallarını destekler; deny önceliklidir. Web aramasını, uygulamaları veya MCP server'larını kısıtlamaz.
permissions.<name>.network.domains.<pattern> allow | deny Tam bir ana makine adına veya *.example.com ya da **.example.com gibi kapsamı sınırlandırılmış bir joker karakter desenine izin verir veya erişimi reddeder.
permissions.<name>.network.enable_socks5 boolean Bu izin profili korumalı ağ erişimini etkinleştirdiğinde SOCKS5 desteğini sunar.
permissions.<name>.network.enable_socks5_udp boolean Etkinleştirildiğinde SOCKS5 dinleyicisi üzerinden UDP'ye izin verir.
permissions.<name>.network.enabled boolean Bu izin profilindeki komutlar için ağ erişimini etkinleştirir. Bu işlem ağ proxy'sini başlatmaz. features.network_proxy veya yönetici tarafından yönetilen etkin ağ gereksinimleri olmadan komutların ağ erişimi doğrudandır ve profilin alan adı kuralları uygulanmaz.
permissions.<name>.network.mode limited | full Alt süreç trafiği için kullanılan ağ proxy modu.
permissions.<name>.network.proxy_url string Bu izin profili korumalı ağ erişimini etkinleştirdiğinde kullanılan HTTP dinleyicisi URL'si.
permissions.<name>.network.socks_url string Bu izin profilinin kullandığı SOCKS5 proxy uç noktası.
permissions.<name>.network.unix_sockets table Korumalı ağ erişimi için Unix soketi izin listesi geçersiz kılma ayarları. Soket yollarını anahtar olarak kullanın; allow bir yol ekler, deny ise yolu reddeder.
permissions.<name>.network.unix_sockets.<path> allow | deny Mutlak bir Unix soketi yolunu allow ile etkin izin listesine ekler veya deny ile reddeder. Reddedilen girdiler etkin izin listesine alınmaz.
permissions.<name>.workspace_roots table Oturumun çalışma zamanı çalışma alanı kökleriyle birlikte :workspace_roots dosya sistemi kurallarının uygulandığı, profil tarafından tanımlanan çalışma alanı kökleri.
permissions.<name>.workspace_roots.<path> boolean Değer true olduğunda bir yolu profilin çalışma alanı kökleri kümesine ekler. Devre dışı girdiler etkisiz kalır.
personality none | friendly | pragmatic Şu desteği bildiren modeller için varsayılan iletişim tarzı: supportsPersonality; konuşma/tur bazında veya /personality aracılığıyla geçersiz kılınabilir.
plan_mode_reasoning_effort string Seçilen modelin desteklediği bir düzeyi kullanan, Plan moduna özgü akıl yürütme geçersiz kılma ayarı. Ayarlanmadığında Plan modu yerleşik ön ayar varsayılanını kullanır.
plugins.<plugin>.enabled boolean Yerel pazar yeri eklentisini bir plugin-name@marketplace-name anahtarı kullanarak etkinleştirir veya devre dışı bırakır. Etkin birleştirilmiş yapılandırmadan okunur; güvenilir proje ayarları kullanıcı, bulut tarafından yönetilen ve sistem varsayılanlarını geçersiz kılabilir. Pazar yerini yenilemek, yapılandırılmış eklentileri devre dışı olsalar bile yükleyebilir veya yenileyebilir. Bu ayar, çalışma alanı tarafından yönetilen etkinlik durumlarını geçersiz kılmaz.
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode auto | prompt | writes | approve Bir eklentinin sağladığı MCP server'daki araçların varsayılan onay davranışı.
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> Bir eklentinin sağladığı MCP server için enabled_tools sonrasında uygulanan ret listesi.
plugins.<plugin>.mcp_servers.<server>.enabled boolean Yüklü bir eklentiyle birlikte gelen MCP server'ı, eklenti bildirim dosyasını değiştirmeden etkinleştirir veya devre dışı bırakır.
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> Bir eklentinin sağladığı MCP server'dan sunulan araçların izin listesi.
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode auto | prompt | writes | approve Bir eklentinin sağladığı MCP aracının onay davranışını araç bazında geçersiz kılma ayarı.
project_doc_fallback_filenames array<string> Şu dosya eksik olduğunda denenecek ek dosya adları: AGENTS.md.
project_doc_max_bytes number Proje talimatları oluşturulurken AGENTS.md kaynağından okunacak azami bayt sayısı.
project_root_markers array<string> Proje kökünü belirten işaretçi dosya adlarının listesi; üst dizinlerde proje kökü aranırken kullanılır.
projects.<path>.trust_level string Bir projeyi veya worktree'yi güvenilir ya da güvenilmeyen olarak işaretler ("trusted" | "untrusted"). Güvenilmeyen projelerde, projeye yerel yapılandırma, kancalar ve kurallar da dâhil olmak üzere proje kapsamındaki .codex/ katmanları atlanır.
review_model string /review tarafından kullanılan isteğe bağlı model geçersiz kılma ayarı (varsayılan olarak geçerli oturum modeli kullanılır).
sandbox_mode read-only | workspace-write | danger-full-access Komut yürütme sırasında dosya sistemi ve ağ erişimine yönelik korumalı alan politikası.
sandbox_workspace_write.exclude_slash_tmp boolean Şunu workspace-write modundaki yazılabilir kök dizinlerden hariç tutar: /tmp.
sandbox_workspace_write.exclude_tmpdir_env_var boolean Şunu workspace-write modundaki yazılabilir kök dizinlerden hariç tutar: $TMPDIR.
sandbox_workspace_write.network_access boolean workspace-write korumalı alanı içinden dışarıya ağ erişimine izin verir.
sandbox_workspace_write.writable_roots array<string> Şu durumda ek yazılabilir kök dizinler: sandbox_mode = "workspace-write".
service_tier string Yeni turlar için tercih edilen hizmet katmanı. fast veya etkin modelin bildirdiği başka bir katmanı kullanın; fast şu istek değerine eşlenir: priority.
shell_environment_policy.exclude array<string> Eski ortam değişkeni hariç tutma desenleri. Yeni yapılandırmalarda shell_environment_policy.filters kullanın; iki biçimi aynı katmanda birlikte kullanmayın.
shell_environment_policy.experimental_use_profile boolean Alt süreçler başlatılırken kullanıcının kabuk profilini kullanır.
shell_environment_policy.filters map<string, include | exclude> Standart, büyük/küçük harfe duyarsız ortam değişkeni desen filtreleri. Dâhil etme girdileri bir izin listesi oluşturur ve hariç tutulan değerleri geri getiremez. Açıkça belirtilen set değerleri hariç tutmalardan sonra uygulanır. Filtreleri aynı katmanda eski exclude veya include_only dizileriyle birlikte kullanmayın.
shell_environment_policy.ignore_default_excludes boolean Diğer filtreler çalışmadan önce KEY, SECRET veya TOKEN içeren değişkenleri korur (varsayılan: true). Gizli bilgi adlarına yönelik otomatik hariç tutmaları uygulamak için false olarak ayarlayın.
shell_environment_policy.include_only array<string> Eski ortam değişkeni deseni izin listesi. Yeni yapılandırmalarda shell_environment_policy.filters kullanın; iki biçimi aynı katmanda birlikte kullanmayın.
shell_environment_policy.inherit all | core | none Alt süreçler başlatılırken temel ortam devralma davranışı.
shell_environment_policy.set map<string,string> Hariç tutmalardan sonra eklenen, açıkça belirtilmiş ortam değerleri; dâhil etme filtreleri bunları yine de kaldırabilir.
show_raw_agent_reasoning boolean Etkin model yayımladığında ham akıl yürütme içeriğini gösterir.
skills.config array<object> config.toml içinde saklanan, beceri başına etkinleştirme geçersiz kılma ayarları.
skills.config.<index>.enabled boolean Başvurulan beceriyi etkinleştirir veya devre dışı bırakır.
skills.config.<index>.path string (path) Şunu içeren beceri klasörünün yolu: SKILL.md.
skills.max_context_tokens integer (positive) Kullanılabilir beceriler kataloğunun token bütçesi. Varsayılanı, modelin bağlam penceresinin %2'sidir. Açıkça belirtilen değerler en fazla 10000 token olabilir.
sqlite_home string (path) Codex'in, ajan işleri ve devam ettirilebilir diğer çalışma zamanı durumları için kullanılan SQLite tabanlı durum veritabanını sakladığı dizin.
suppress_unstable_features_warning boolean Geliştirme aşamasındaki özellik bayrakları etkinleştirildiğinde görünen uyarıyı gizler.
tool_output_token_limit number Tekil araç/işlev çıktılarını geçmişte saklamak için token bütçesi.
tool_suggest.disabled_tools array<table> Keşfedilebilir belirli bağlayıcılar veya eklentiler için önerileri devre dışı bırakır. Her girdi type = "connector" veya "plugin" ile bir id kullanır.
tool_suggest.discoverables array<table> Keşfedilebilir ek bağlayıcılar veya eklentiler için araç önerilerine izin verir. Her girdi type = "connector" veya "plugin" ile bir id kullanır.
tools.view_image boolean Yerel görsel ekleme aracı view_image etkinleştirilir.
tools.web_search boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } İsteğe bağlı web araması aracı yapılandırması. Nesne biçimi, arama bağlamı boyutunu, izin verilen arama alan adlarını ve kullanıcının yaklaşık konumunu ayarlayabilir. Bu arama alan adı filtreleri, korumalı alandaki komutların ağ alan adı kurallarından ayrıdır ve bağlayıcıları veya MCP server'larını kısıtlamaz.
tui table Satır içi masaüstü bildirimlerini etkinleştirme gibi TUI'ye özgü seçenekler.
tui.alternate_screen auto | always | never TUI için alternatif ekran kullanımını belirler (varsayılan: auto; auto, kaydırma geçmişini korumak için Zellij'de alternatif ekranı kullanmaz).
tui.animations boolean Terminal animasyonlarını (karşılama ekranı, parlama, dönen yükleme göstergesi) etkinleştirir (varsayılan: true).
tui.keymap.<context>.<action> string | array<string> Bir TUI eyleminin klavye kısayolu ataması. Desteklenen bağlamlar arasında global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list ve approval bulunur. Belirli yazma alanı eylemleri, yedek olarak eşleşen tui.keymap.global atamalarını kullanır; desteklendiğinde bağlama özgü atamalar önceliklidir.
tui.keymap.<context>.<action> = [] empty array Bu tuş eşleme bağlamında eylemin atamasını kaldırır. Tuş adları ctrl-a, shift-enter, page-down veya minus gibi normalleştirilmiş dizeler kullanır.
tui.model_availability_nux.<model> integer Modelin kısa adı anahtarıyla tutulan dahili başlangıç ipucu durumu.
tui.notification_condition unfocused | always TUI bildirimlerinin yalnızca terminal odakta değilken mi, yoksa odak durumundan bağımsız olarak mı tetikleneceğini belirler. Varsayılan değer: unfocused.
tui.notification_method auto | osc9 | bel Terminal bildirimlerinin bildirim yöntemi (varsayılan: auto).
tui.notifications boolean | array<string> TUI bildirimlerini etkinleştirir; isteğe bağlı olarak belirli olay türleriyle sınırlar.
tui.raw_output_mode boolean Terminalde kopyalamayı kolaylaştıran seçim için TUI'yi ham kaydırma geçmişi modunda başlatır (varsayılan: false). /raw veya varsayılan alt-r tuş atamasıyla açıp kapatabilirsiniz.
tui.resume_cwd current | session Bir oturuma devam ederken veya oturumdan dal oluştururken kullanılacak çalışma dizini. Ayarlanmazsa ve geçerli dizininiz oturumun kayıtlı dizininden farklıysa Codex seçim yapmanızı ister.
tui.show_tooltips boolean TUI karşılama ekranında başlangıç ipuçlarını gösterir (varsayılan: true).
tui.status_line array<string> | null TUI alt bilgisindeki durum satırı öğelerinin sıralı tanımlayıcı listesi. null durum satırını devre dışı bırakır.
tui.terminal_title array<string> | null Terminal pencere/sekme başlığı öğelerinin sıralı tanımlayıcı listesi. Varsayılan değer ["spinner", "project"]; null başlık güncellemelerini devre dışı bırakır.
tui.theme string Sözdizimi vurgulama temasını geçersiz kılma ayarı (kebab-case biçiminde tema adı).
tui.vim_mode_default boolean Yazma alanını ekleme modu yerine Vim normal modunda başlatır (varsayılan: false). Yine de oturum bazında /vim ile değiştirebilirsiniz.
web_search disabled | cached | indexed | live Web araması modu (varsayılan: "cached"; cached, dış web erişimi olmadan OpenAI tarafından yönetilen bir dizini kullanır; indexed, dış erişime yalnızca arama dizininin denetimi altında izin verir; --yolo veya başka bir tam erişimli korumalı alan ayarı kullanırsanız varsayılan "live" olur). Sınırsız canlı veri alımı için "live", aracı kaldırmak için "disabled" kullanın.
windows_wsl_setup_acknowledged boolean Windows başlangıç bildiriminin onaylandığını izler (yalnızca Windows).
windows.sandbox unelevated | elevated | mxc Codex doğrudan Windows üzerinde çalıştırıldığında kullanılan, yalnızca Windows'a özgü yerel korumalı alan modu.

config.toml için en güncel JSON şemasını burada bulabilirsiniz.

VS Code veya Cursor'da config.toml dosyasını düzenlerken otomatik tamamlama ve tanılama özelliklerinden yararlanmak için Even Better TOML uzantısını yükleyip config.toml dosyanızın en üstüne şu satırı ekleyebilirsiniz:

#:schema https://developers.openai.com/codex/config-schema.json

Not: experimental_instructions_file anahtarını model_instructions_file olarak yeniden adlandırın. Codex eski anahtarı kullanımdan kaldırmaktadır; mevcut yapılandırmaları yeni adı kullanacak şekilde güncelleyin.

requirements.toml

requirements.toml, kullanıcıların geçersiz kılamayacağı güvenlik açısından hassas ayarları kısıtlayan, yönetici tarafından zorunlu tutulan bir yapılandırma dosyasıdır. Ayrıntılar, konumlar ve örnekler için Yönetici tarafından zorunlu tutulan gereksinimler bölümüne bakın.

ChatGPT Business ve Enterprise kullanıcıları için Codex, buluttan alınan gereksinimleri de uygulayabilir. Öncelik ayrıntıları için güvenlik sayfasına bakın.

Çalışma zamanı özellik bayraklarını config.toml tarafından kullanılan aynı standart anahtarlarla sabitlemek için requirements.toml içinde [features] kullanın. Gereksinimler ayrıca config.toml kapsamında olmayan, yalnızca uygulamaya özgü belgelenmiş anahtarları da içerebilir. Atlanan anahtarlar kısıtlanmadan kalır.

Bazı yönetilen gereksinimler, izin verilenler listesi yerine tam bir yapılandırma değerini zorunlu tutar. Kullanıcılar zorunlu tutulan bir yolu, güncelleme tercihini, oturum açma kabuğu politikasını, geri bildirim ayarını veya Windows özel masaüstü ayarını geçersiz kılamaz.

Yönetilen izin profili izin verilenler listeleri, Codex 0.138.0 veya sonraki bir sürümü gerektirir. Codex 0.137.0 ve önceki sürümler allowed_permission_profiles ile yönetilen default_permissions öğesini yok sayar.

allowed_sandbox_modes öğesini sandbox_mode ile kullanın. İzin profili dağıtımlarında, yönetilen default_permissions ile allowed_permission_profiles kullanın.

untrusted girdisi, allowed_approval_policies içinde, Codex'in bir projede şu ayar kullanıldığında uyguladığı daha katı onay davranışı için geçerliliğini korur: trust_level = "untrusted". Bu, açıkça approval_policy = "untrusted" ayarlanmasına izin vermez.

[models.new_thread] tablosu, yönetilen varsayılan değerler sağlar; bunları zorunlu kılmaz. Modeli veya akıl yürütme düzeyini açıkça --model, --config veya --profile ile geçersiz kılarsanız Codex hem model hem de model_reasoning_effort değerini [models.new_thread] tablosunda yok sayar. service_tier bağımsızdır.

Tarayıcı gereksinimleri üç ayrı yüzeyi kapsar. in_app_browser bir kişinin açıp doğrudan kullandığı tarayıcı bölmesini denetler. browser_use bir tarayıcıda ajan tarafından yürütülen çalışmaları denetler. computer_use ise yerel masaüstü uygulamalarında ajan tarafından yürütülen çalışmaları denetler.

İç içe yerleştirilmiş Browser Use ve Computer Use politika değerleri kendi başlarına erişim sağlamaz. Kaynağa veya uygulamaya özgü bir allow, aynı politika kaynağının geri dönüş değerini geçersiz kılabilir; ancak normal özellik, onay ve diğer politika denetimleri yine de geçerlidir. Yönetilen gereksinimlerle config.toml birlikte geçerli olduğunda, bunlardan herhangi birindeki deny öncelikli olur.

Anahtar Tür / değerler Ayrıntılar
additional_developer_instructions string Ayrı bir geliştirici mesajı olarak eklenen yönetilen geliştirici talimatları. Codex, bağlam işaretçileri dahil tahmini 10.000 token sınırını aşan talimatları reddeder.
allow_appshots boolean Yönetilen kullanıcılar için Appshots özelliğini devre dışı bırakmak üzere false olarak ayarlayın. Belirtilmezse Appshots gereksinimlerle kısıtlanmaz ve normal ürün kullanılabilirliğine tabi olur.
allow_browser_and_computer_use boolean Hem ajan tarafından yürütülen Browser Use hem de yerel uygulamalardaki Computer Use özelliğini engellemek için false olarak ayarlayın. true olarak ayarlamak veya belirtmemek iki özellikten hiçbirini etkinleştirmez; diğer özellik, politika ve onay denetimleri geçerliliğini korur.
allow_login_shell boolean Kabuk araçlarının bir oturum açma kabuğu başlatıp başlatamayacağını zorunlu olarak belirleyin.
allow_managed_hooks_only boolean true olduğunda Codex; kullanıcı, proje, oturum ve eklenti kancalarını atlar, ancak requirements.toml ve diğer yönetilen yapılandırma katmanlarından gelen yönetilen kancalara izin vermeye devam eder.
allow_remote_control boolean Yönetilen kullanıcılar için cihazın uzaktan kontrolünü devre dışı bırakmak üzere false olarak ayarlayın. Belirtilmezse cihazın uzaktan kontrolü gereksinimlerle kısıtlanmaz ve normal ürün kullanılabilirliğine tabi olur.
allowed_approval_policies array<string> on-request, never ve granular gibi izin verilen onay politikaları. Güvenilmeyen bir projeden türetilen daha katı politikaya izin vermek için untrusted ekleyin; bu politika doğrudan approval_policy ile seçilemez.
allowed_approvals_reviewers array<string> approvals_reviewer için user ve auto_review gibi izin verilen değerler.
allowed_chatgpt_workspaces array<string> Codex erişim belirteçleri dahil ChatGPT oturum açma işlemlerini listelenen çalışma alanı kimlikleriyle sınırlayın. Boş liste ChatGPT ile oturum açmayı devre dışı bırakır; izin verildiğinde API kimlik doğrulaması kullanılabilir durumda kalır. Yerel sistem gereksinimleri dosyası veya macOS MDM üzerinden ayarlanır; buluttan yönetilen değerler yok sayılır.
allowed_login_methods array<string> chatgpt, api veya her ikisine izin verin. Belirtilmezse bu ayar oturum açma yöntemlerini kısıtlamaz. Ayarlanırsa liste en az bir yöntem içermelidir. api, Amazon Bedrock dahil API kimlik doğrulamasına izin verir. Yerel sistem gereksinimleri dosyası veya macOS MDM üzerinden ayarlanır. Buluttan yönetilen değerler yok sayılır.
allowed_permission_profiles table<boolean> İzin verilen izin profillerinin tam listesi. true olarak ayarlanan profillere izin verilir. Gelecek sürümlerde eklenen profiller dahil, belirtilmeyen veya false olarak ayarlanan profiller reddedilir. Gereksinim kaynakları birleştirilirken girdiler profil adına göre eşleştirilir.
allowed_permission_profiles.<name> boolean Yüklenen bir yapılandırmada veya gereksinim kaynağında tanımlanan yerleşik ya da özel izin profiline izin verin veya profili reddedin. Daha sonra gelen, daha yüksek öncelikli bir gereksinim kaynağı, önceki düşük öncelikli kaynağın izin verdiği bir profili kapatmak için false kullanabilir.
allowed_sandbox_modes array<string> sandbox_mode için izin verilen değerler.
allowed_web_search_modes array<string> web_search için izin verilen değerler (disabled, cached, indexed, live). disabled her zaman izinlidir; boş liste fiilen yalnızca disabled değerine izin verir.
apps table Uygulama tanımlayıcısına göre anahtarlanmış yönetilen uygulama gereksinimleri. Gereksinimler bir uygulamayı devre dışı bırakabilir veya tek tek araçlar için onay davranışını kısıtlayabilir.
apps.<id>.enabled boolean Bir uygulamayı devre dışı bırakmak için false olarak ayarlayın. Birden fazla gereksinim kaynağı birleştirildiğinde devre dışı bırakan gereksinim kısıtlayıcı olmaya devam eder.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Tek bir uygulama aracı için yönetilen onay modunu ayarlayın.
auto_review table Yönetilen otomatik inceleme gereksinimleri.
auto_review.ignore_rules array<string> Codex'in komut yürütme politikasındaki allow önek kurallarını yok sayacağı tam model kısa adları. Varsa sağlayıcı ad alanı dahil kısa adı tam olarak eşleştirin; required_on_models ayarından farklı olarak bu ayar, ad alanı içermeyen bir takma adı kabul etmez. Reddetme ve ağ kuralları geçerliliğini korur.
auto_review.required_on_models array<string> Otomatik inceleme kullanması gereken modellerin kısa adları. Kısa adlar boş olmamalı, sağlayıcı ad alanlarını içermemeli ve başında veya sonunda boşluk bulunmamalıdır. Birden fazla gereksinim kaynağındaki listeler birleştirilir.
browser_use table Ajan tarafından yürütülen Browser Use için yönetilen gereksinimler.
browser_use.allow_global_persistent_approval boolean Browser Use özelliğinin herhangi bir siteden indirmeye izin vermek gibi tüm siteleri kapsayan Always allow onayları oluşturmasını veya uygulamasını önlemek için false olarak ayarlayın. Mevcut kayıtlı onaylar yok sayılır, silinmez. true olarak ayarlamak veya belirtmemek bir onay oluşturmaz.
browser_use.allow_history_access boolean Browser Use özelliğinin tarayıcı geçmişini okumasını önlemek için false olarak ayarlayın. true olarak ayarlamak veya belirtmemek, normal geçmiş ayarlarını ve kullanılabilirlik denetimlerini geçerli bırakır.
browser_use.default_origin_policy table browser_use.origins altında eşleşen hiçbir girdi ilgili ayarı tanımlamadığında her Browser Use ayarı için kullanılacak yedek değer. Eşleşen bir kaynak kuralı, ilgili politika kaynağının yedek değerinin yerini alır. Ardından Codex, yönetilen gereksinimler ile kullanıcı yapılandırmasından çıkan daha katı sonucu uygular.
browser_use.default_origin_policy.access allow | deny Yedek değeri kullanan kaynaklarda Browser Use özelliğini engellemek için deny kullanın. Reddedilen bir kaynakta yüklemeler, indirmeler, tam tarayıcı hata ayıklama erişimi ve otomatik inceleme de engellenir. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
browser_use.default_origin_policy.access_approval_lifetime turn | thread Kalıcı olmayan bir site erişim onayının ne kadar süreceğini ayarlayın: turn onayı geçerli turla sınırlar, thread ise geçerli konuşmanın geri kalanı boyunca korur. persistent_approval, Always allow seçeneğinin kullanılabilir olup olmadığını ayrıca kontrol eder. Ürünün varsayılan değeri thread şeklindedir.
browser_use.default_origin_policy.auto_review allow | deny Yedek değeri kullanan kaynaklarda otomatik incelemeyi atlayıp bunun yerine kullanıcıdan onay istemek için deny kullanın. allow, diğer ayarlar izin verdiğinde otomatik incelemeyi kullanılabilir durumda bırakır.
browser_use.default_origin_policy.downloads allow | deny Yedek değeri kullanan kaynaklarda Browser Use indirmelerini engellemek için deny kullanın. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
browser_use.default_origin_policy.full_cdp_access allow | deny Yedek değeri kullanan kaynaklarda tam Chrome DevTools Protocol (CDP) erişimini engellemek için deny kullanın. allow yalnızca normal isteğe bağlı etkinleştirme ve onay denetimlerinin devam etmesine izin verir.
browser_use.default_origin_policy.persistent_approval boolean Browser Use özelliğinin yedek değeri kullanan kaynaklarda bir Always allow onayını kaydetmesini veya uygulamasını önlemek için false olarak ayarlayın. Geçerli tur veya konuşma için verilen onaylar yine de uygulanabilir. true, diğer koşullar izin verdiğinde Always allow seçeneğini kullanılabilir kılar ancak bir onay oluşturmaz.
browser_use.default_origin_policy.uploads allow | deny Yedek değeri kullanan kaynaklarda Browser Use yüklemelerini engellemek için deny kullanın. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
browser_use.disable_auto_review boolean Browser Use için otomatik incelemeyi atlayıp bunun yerine kullanıcıdan onay istemek üzere true olarak ayarlayın. false olarak ayarlamak veya belirtmemek, diğer ayarlar izin verdiğinde otomatik incelemeyi kullanılabilir durumda bırakır.
browser_use.origins map<string, table> Kaynağa özgü Browser Use politikaları. Anahtarlar, &lt;scheme&gt;://&lt;host-pattern&gt;[:&lt;port&gt;] biçimini http veya https ile kullanır. Tam bir ana makine adı, yalnızca alt alan adları için *.example.com veya temel alan adı ve alt alan adları için **.example.com kullanın. Diğer * joker karakterleri noktaları da kapsayabilir; dolayısıyla region*.example.com, region.api.example.com ile de eşleşir; * ana makine değeri, ilgili şemadaki tüm ana makinelerle eşleşir. Şemalar ve varsayılan olmayan bağlantı noktaları önemlidir; açıkça belirtilen varsayılan bağlantı noktaları normalleştirme sırasında kaldırılır. Yollar, sorgular, gömülü kullanıcı adları veya parolalar ile joker karakter içeren şemalar ya da bağlantı noktaları geçersizdir. Kalıbı TOML içinde tırnak içine alın; örneğin [browser_use.origins."https://**.example.com"].
browser_use.origins.<pattern> table Bu kalıpla eşleşen kaynaklar için politika. Birden fazla kalıp eşleşirse Codex her yetenek için en kısıtlayıcı değeri kullanır: deny, allow değerinden; false, true değerinden; turn ise thread değerinden önceliklidir.
browser_use.origins.<pattern>.access allow | deny Eşleşen kaynaklarda Browser Use özelliğini engellemek için deny kullanın. Reddetme, bu kaynaklardaki yüklemeleri, indirmeleri, tam tarayıcı hata ayıklama erişimini ve otomatik incelemeyi de engeller. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
browser_use.origins.<pattern>.access_approval_lifetime turn | thread Eşleşen kaynaklar için kalıcı olmayan bir site erişim onayının ne kadar süreceğini ayarlayın: turn onayı geçerli turla sınırlar, thread ise geçerli konuşmanın geri kalanı boyunca korur. persistent_approval, Always allow seçeneğinin kullanılabilir olup olmadığını ayrıca kontrol eder.
browser_use.origins.<pattern>.auto_review allow | deny Eşleşen kaynaklarda otomatik incelemeyi atlayıp bunun yerine kullanıcıdan onay istemek için deny kullanın. allow, diğer ayarlar izin verdiğinde otomatik incelemeyi kullanılabilir durumda bırakır.
browser_use.origins.<pattern>.downloads allow | deny Eşleşen kaynaklarda Browser Use indirmelerini engellemek için deny kullanın. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
browser_use.origins.<pattern>.full_cdp_access allow | deny Eşleşen kaynaklarda tam Chrome DevTools Protocol (CDP) erişimini engellemek için deny kullanın. allow yalnızca normal isteğe bağlı etkinleştirme ve onay denetimlerinin devam etmesine izin verir.
browser_use.origins.<pattern>.persistent_approval boolean Browser Use özelliğinin eşleşen kaynaklarda bir Always allow onayını kaydetmesini veya uygulamasını önlemek için false olarak ayarlayın. Geçerli tur veya konuşma için verilen onaylar yine de uygulanabilir. true, diğer koşullar izin verdiğinde Always allow seçeneğini kullanılabilir kılar ancak bir onay oluşturmaz.
browser_use.origins.<pattern>.uploads allow | deny Eşleşen kaynaklarda Browser Use yüklemelerini engellemek için deny kullanın. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir.
chatgpt_base_url string Kimlik doğrulama ve bulut politikası alımı öncesinde ChatGPT hizmetinin temel URL'sini zorunlu kılın. Bu ayar, Codex'in tüm ağ hedeflerini yapılandırmaz. Yerel sistem gereksinimleri dosyası veya macOS MDM üzerinden ayarlanır; buluttan yönetilen değerler yok sayılır.
check_for_update_on_startup boolean Codex'in başlangıçta güncellemeleri denetleyip denetlemeyeceğini zorunlu olarak belirleyin.
cli_auth_credentials_store file | keyring | auto | ephemeral Kimlik doğrulama yüklenmeden önce CLI kimlik bilgisi deposunu zorunlu kılın. file, CODEX_HOME/auth.json kullanır; keyring işletim sisteminin kimlik bilgisi deposunu gerektirir; auto kimlik bilgisi deposu kullanılamıyorsa dosyaya başvurur; ephemeral kimlik bilgilerini geçerli süreç boyunca bellekte tutar. Yerel sistem gereksinimleri dosyası veya macOS MDM üzerinden ayarlanır; buluttan yönetilen değerler yok sayılır.
computer_use table Yerel masaüstü uygulamalarında ajan tarafından yürütülen işler için yönetilen gereksinimler. Hem yönetilen uygulama kuralları hem de config.toml uygulama kuralları uygulanır; her politika kaynağı uygulamaya izin vermelidir.
computer_use.allow_locked_computer_use boolean Kullanıcıların yönetilen bir macOS cihazında Locked Use özelliğini etkinleştirmesini önlemek için false olarak ayarlayın. Bu gereksinim etkinleştirme kontrollerini kaldırır; Locked Use zaten etkinse kapatmaz. Belirtilmezse normal ürün kullanılabilirliği geçerlidir.
computer_use.allow_persistent_approval boolean Uygulama onaylarını oturumlar arasında saklama seçeneğini kaldırmak için false olarak ayarlayın. Geçerli oturum için onaylar kullanılabilir durumda kalır. true olarak ayarlamak veya belirtmemek bir uygulamayı onaylamaz.
computer_use.default_app_access allow | deny Platforma özgü bir kuralla eşleşmeyen yerel uygulamalar için yedek erişim değeri. deny erişimi engeller. allow yalnızca normal onay ve politika denetimlerinin devam etmesine izin verir. Ürünün varsayılan değeri allow şeklindedir.
computer_use.macos table macOS için Computer Use uygulama kuralları.
computer_use.macos.bundle_ids map<string, allow | deny> Tam macOS paket tanımlayıcılarını allow veya deny ile eşleyin. Eşleşen bir kural, aynı politika kaynağındaki computer_use.default_app_access değerinin yerini alır. Yönetilen gereksinimlerden veya kullanıcı yapılandırmasından gelen bir ret, erişimi yine de engeller.
computer_use.macos.bundle_ids.<bundle-id> allow | deny Tam paket tanımlayıcısını engellemek için deny kullanın. allow yalnızca bu politika kaynağının varsayılanını geçersiz kılar ve diğer tüm politika kaynaklarının ve normal onay akışının uygulamaya izin vermesini gerektirmeye devam eder.
computer_use.windows table Paketlenmiş ve paketlenmemiş Windows uygulamaları için Computer Use uygulama kuralları.
computer_use.windows.aumids map<string, allow | deny> İmzalı paketlenmiş uygulamaların tam, kayıtlı Application User Model ID (AUMID) değerlerini allow veya deny ile eşleyin. Eşleşen bir kural, aynı politika kaynağındaki computer_use.default_app_access değerinin yerini alır.
computer_use.windows.aumids.<aumid> allow | deny Tam paketlenmiş uygulama kimliğini engellemek için deny kullanın. allow yalnızca bu politika kaynağının varsayılanını geçersiz kılar ve diğer tüm politika kaynaklarının ve normal onay akışının uygulamaya izin vermesini gerektirmeye devam eder.
computer_use.windows.exes array<table> İmzalı, paketlenmemiş Windows yürütülebilir dosyaları için kurallar. Kurallar, yürütülebilir dosyanın yolunu veya geçerli dosya adını değil, doğrulanmış yayıncısını ve imzalı sürüm bilgilerini eşleştirir. Eşleşen bir ret, eşleşen izinlerden önceliklidir. İmzasız yürütülebilir dosyalar computer_use.default_app_access kullanır; imzalı kimliği kesin olarak doğrulanamayan yürütülebilir dosyalar engellenir.
computer_use.windows.exes[].access allow | deny Eşleşen yürütülebilir dosyalar için zorunlu erişim kararı. deny erişimi engeller. allow yalnızca bu politika kaynağının varsayılanını geçersiz kılar ve diğer tüm politika kaynaklarının ve normal onay akışının uygulamaya izin vermesini gerektirmeye devam eder.
computer_use.windows.exes[].binary_name string Yürütülebilir dosyanın imzalı sürüm bilgilerinden alınan isteğe bağlı OriginalFilename değeri. Eşleştirme büyük/küçük harfe duyarsızdır. Eşleşen bir yayıncı ve ürün kuralı bu değeri gerektiriyor ancak yürütülebilir dosya bunu sağlamıyorsa Computer Use yürütülebilir dosyayı engeller.
computer_use.windows.exes[].product_name string Yürütülebilir dosyanın imzalı sürüm bilgilerinden alınan zorunlu tam ProductName değeri.
computer_use.windows.exes[].publisher_name string Yürütülebilir dosyanın güvenilir imzalama sertifikasından alınan, Windows X.500 ayırt edici adı biçimindeki zorunlu tam yayıncı adı.
default_permissions string Yönetilen varsayılan izin profili. Profile allowed_permission_profiles tarafından izin verilmiş olmalıdır. Öngörülebilir davranış için bunu açıkça ayarlayın; belirtilmezse Codex, yalnızca hem :workspace hem de :read-only açıkça izinli olduğunda varsayılan olarak :workspace kullanır.
enforce_residency string Codex hizmet trafiğinin desteklenen bir veri yerleşimi bölgesini kullanmasını zorunlu kılın. Şu anda us kabul edilir.
experimental_network table Korumalı alandaki yerel komutlar için requirements.toml üzerinden uygulanan, yönetici tarafından yönetilen ağ gereksinimleri. Etkinleştirildiğinde bu gereksinimler, features.network_proxy olmadan komut ağ proxy'sini başlatabilir. Tarayıcı araçları, yönetilen ağ retlerini ve münhasır izin listelerini ayrıca denetler. Bu gereksinimler tarayıcı trafiğini proxy üzerinden yönlendirmez; web aramasını, uygulamaları, MCP server'larını, yerel uygulama trafiğini veya diğer yeteneklere özgü trafiği kontrol etmez. Desteklenen yönetilen Codex Cloud yollarında bu gereksinimler, ayrı Cloud ortamı internet ayarlarıyla birlikte komutların ağ erişimini kısıtlar. Onaylanmış tam korumalı alan yetki yükseltmesi, politikanın izin verdiği durumlarda komut proxy'sini atlayabilir. Work Cloud bu gereksinimleri devralmaz.
experimental_network.allow_local_binding boolean Korumalı alan ağ erişimi için daha geniş yerel/özel ağ erişimine izin verin. Desteklenen Codex Cloud proxy yolunda açıkça belirtilen false değeri, bir alan adına izin verilse bile üst proxy erişimini engelleyebilir. Yalnızca uygulanabilir hiçbir gereksinim, seçili ağ profili veya proxy özellik ayarı bir değer sağlamıyorsa varsayılan olarak true olur. Devralınan false değeri açıkça belirtilmiş sayılmaya devam eder. Desteklenen daha yüksek öncelikli bir Cloud geçersiz kılması, Local için Global kapsamını genişletmeden veya alan adı Allow girdileri eklemeden bu değeri değiştirebilir. Yürütücü desteğini doğrulayın. Bu Cloud varsayılanını Local için uygulamayın.
experimental_network.allow_upstream_proxy boolean Korumalı alan ağ bağlantısının ortamdan alınan bir üst proxy üzerinden zincirlenmesine izin verin.
experimental_network.allowed_domains array<string> Yönetilen ağ proxy'si etkinken korumalı alandaki komutların ağ erişimi için yönetici izin kuralları. Bu kurallar web araması, uygulamalar veya MCP server'ları için geçerli değildir. Bunu experimental_network.domains ile birlikte kullanmayın.
experimental_network.dangerously_allow_all_unix_sockets boolean Yalnızca izin listesindeki hedeflere erişim yerine herhangi bir Unix soketi hedefine izin verin. Yalnızca sıkı denetlenen ortamlarda kullanın.
experimental_network.dangerously_allow_non_loopback_proxy boolean [experimental_network] gereksinimleri için geri döngü dışındaki dinleyici adreslerine izin verin. Etkinleştirilmesi, dinleyicileri localhost dışından erişilebilir hâle getirebilir.
experimental_network.denied_domains array<string> Korumalı alan ağ erişimi için liste biçimindeki yönetici reddetme kuralları. Bunu experimental_network.domains ile birlikte kullanmayın.
experimental_network.domains map<string, allow | deny> Korumalı alan ağ erişimi için eşleme biçimindeki yönetici alan adı politikası. Tam ana makine adlarını, yalnızca alt alan adları için *.example.com, kök alan adı ve alt alan adları için **.example.com ve genel * izin kurallarını destekler. * dışarıya yönelik genel ağ erişimini geniş ölçüde açtığından kapsamı sınırlandırılmış kuralları tercih edin. Ortam kuralları, bir politika içindeki aynı Global alan adı anahtarının yerini alabilir. Daha yüksek öncelikli değerler aynı anahtarın yerini alırken devralınan diğer anahtarlar korunur. Birleştirme sonrasında, devralınan bir joker karakter dahil, eşleşen farklı bir deny isteği yine de engeller. Boş ortam eşlemeleri Global kurallarını temizlemez. Yürütücü desteğini doğrulayın. Bunu experimental_network.allowed_domains veya experimental_network.denied_domains ile birlikte kullanmayın.
experimental_network.domains.<pattern> allow | deny Eşleşen alan adı kalıbı için korumalı alan ağ erişimine izin verin veya erişimi reddedin. Birden fazla kalıp eşleştiğinde reddetme kuralı önceliklidir.
experimental_network.enabled boolean Korumalı alan ağ gereksinimlerini etkinleştirin. Etkin korumalı alan komutların ağ erişimini kapalı tutuyorsa bu ayar ağ erişimi sağlamaz.
experimental_network.http_port integer [experimental_network] gereksinimleri için kullanılacak geri döngü HTTP dinleyici bağlantı noktası.
experimental_network.managed_allowed_domains_only boolean Ağ gereksinimleri etkin ve bu değer doğru olduğunda normal kullanıcı yapılandırması ve alan adı bazındaki onaylar, yönetilen proxy izin listesini genişletemez. Yapılandırılmış veya devralınmış etkin Allow girdisi yoksa normal yönetilen komutların izin verilen hiçbir hedefi olmaz. Yalnızca ret kurallarından oluşan bir politika, internetin geri kalanına izin vermez. Bu ayar, her aracı veya onaylanmış tam korumalı alan yetki yükseltmesini kapsamaz.
experimental_network.socks_port integer [experimental_network] gereksinimleri için kullanılacak geri döngü SOCKS5 dinleyici bağlantı noktası.
experimental_network.unix_sockets map<string, allow | deny> macOS üzerinde korumalı alan ağ erişimi için yönetici tarafından yönetilen Unix soketi izin listesi. Yollar mutlak olmalıdır.
experimental_network.unix_sockets.<path> allow | deny macOS üzerinde allow, mutlak bir Unix soketi yolunu izin listesine ekler; deny ise eklemez. Tüm Unix soketlerine izin verme etkin olduğunda bir deny girdisi bir soketi engelleyemez.
features table Sabitlenmiş özellik değerleri. Çalışma zamanı özellikleri için config.toml içindeki standart adları kullanın; belgelenmiş, yalnızca uygulamaya yönelik gereksinim anahtarları da burada desteklenir.
features.<name> boolean Belgelenmiş bir çalışma zamanı veya uygulama özelliğinin etkin ya da devre dışı kalmasını zorunlu kılın.
features.apps boolean Yönetilen kullanıcılar için Apps entegrasyonunun kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.browser_use boolean Ajan tarafından yürütülen Browser Use özelliğini devre dışı bırakmak için requirements.toml içinde false olarak ayarlayın.
features.browser_use_external boolean Codex'in mevcut sekmeler ve oturum açılmış oturumlar dahil desteklenen tarayıcıları ChatGPT tarayıcı uzantısı üzerinden kullanmasını önlemek için requirements.toml içinde false olarak ayarlayın.
features.browser_use_full_cdp_access boolean Browser Developer modu dahil yerel çalışma zamanındaki tam Chrome DevTools Protocol erişimini devre dışı bırakmak ve ChatGPT masaüstü uygulamasının ilgili ayarı etkinleştirmesini önlemek için requirements.toml içinde false olarak ayarlayın. Belirtilmezse normal ürün kullanılabilirliği geçerlidir.
features.computer_use boolean Computer Use, Record & Replay ve ilgili kurulum veya etkinleştirme akışlarını devre dışı bırakmak için requirements.toml içinde false olarak ayarlayın.
features.fast_mode boolean Yönetilen kullanıcılar için standart fast_mode özelliğini açık veya kapalı olarak sabitleyin.
features.guardian_approval boolean Yönetilen kullanıcılar için Guardian onayının kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.in_app_browser boolean Kullanıcıların doğrudan açıp kontrol ettiği yerleşik tarayıcı panelini devre dışı bırakmak için requirements.toml içinde false olarak ayarlayın.
features.in_app_chat boolean ChatGPT masaüstü uygulamasında ChatGPT ve ChatGPT Work konuşma ekranlarını ve ilgili bulut otomasyonu arayüzünü gizlemek için false olarak ayarlayın. Bu ayar ChatGPT Voice özelliğini engellemez veya mevcut bulut görevlerini durdurmaz. true olarak ayarlamak hesap, çalışma alanı izni veya kullanıma sunma denetimlerini atlamaz.
features.in_app_dictation boolean Masaüstü uygulamasındaki uygulama içi dikteyi devre dışı bırakmak için false olarak ayarlayın. true olarak ayarlamak diğer kullanılabilirlik denetimlerini atlamaz.
features.in_app_local_automation boolean Masaüstü uygulamasındaki yerel zamanlanmış görevleri devre dışı bırakmak için false olarak ayarlayın. true olarak ayarlamak diğer kullanılabilirlik denetimlerini atlamaz.
features.in_app_updates boolean Uygulama içi güncellemeleri devre dışı bırakmak için requirements.toml içinde false olarak ayarlayın. Bu gereksinim belirtilmezse güncellemeler varsayılan olarak etkin kalır.
features.memories boolean Yönetilen kullanıcılar için Memories kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.multi_agent boolean Yönetilen kullanıcılar için çoklu ajan kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.plugin_sharing boolean Yerel olarak oluşturulan eklentiler için çalışma alanı paylaşımını devre dışı bırakmak üzere buluttan yönetilen requirements.toml içinde false olarak ayarlayın.
features.plugins boolean Yönetilen kullanıcılar için eklenti kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.realtime_conversation boolean Codex CLI içindeki deneysel /voice komutunu devre dışı bırakmak için false olarak ayarlayın. Masaüstü uygulamasındaki ChatGPT Voice özelliğini veya app-server sesli oturumlarını engellemek için bu ayara güvenmeyin. true olarak ayarlamak istemci veya kullanıma sunma denetimlerini atlamaz.
features.remote_plugin boolean Yönetilen kullanıcılar için uzak eklenti kataloğunun kullanılabilirliğini açık veya kapalı olarak sabitleyin.
features.workspace_dependencies boolean Yönetilen kullanıcılar için paketle sunulan çalışma alanı bağımlılığı çalışma zamanının kullanılabilirliğini açık veya kapalı olarak sabitleyin.
feedback table Yönetilen geri bildirim ayarları.
feedback.enabled boolean Kullanıcıların Codex istemcileri genelinde geri bildirim gönderip gönderemeyeceğini zorunlu olarak belirleyin.
guardian_extra_policy string Otomatik inceleme için ana politikayla birlikte dahil edilen ek yönetilen Markdown politikası. Yerel [auto_review].extra_policy ayarından önceliklidir. Boş değerler yok sayılır.
guardian_policy_config string Otomatik inceleme için yönetilen Markdown politika talimatları. Yerel [auto_review].policy ayarından önceliklidir. Boş değerler yok sayılır.
hooks table Yönetici tarafından zorunlu kılınan yönetilen yaşam döngüsü kancaları. Yönetilen bir kanca dizini gerektirir ve config.toml içindeki satır içi [hooks] ile aynı olay şemasını kullanır.
hooks.<Event> array<table> PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit veya Stop gibi bir kanca olayı için eşleştirici grupları.
hooks.<Event>[].hooks array<table> Bir eşleştirici grubunun kanca işleyicileri. Komut ve MCP aracı kancaları desteklenirken prompt ve ajan kancası işleyicileri ayrıştırılır ancak atlanır.
hooks.<Event>[].hooks[].additionalContextLimit integer Aşırı büyük additionalContext içeriğini diske kaydedip modele daha kısa bir önizleme göstermek için işleyici başına yaklaşık token eşiği. Varsayılan değer 2500 şeklindedir; 0 tüm bağlamı doğrudan modele aktarır. Büyük kanca çıktısı bölümüne bakın.
hooks.<Event>[].hooks[].async boolean Bir komut kancasını, tetikleyen işlemi geciktirmeden arka planda çalıştırın. Varsayılan değer false şeklindedir; SessionEnd her zaman eşzamanlı çalışır. Kancaları arka planda çalıştırma bölümüne bakın.
hooks.<Event>[].hooks[].commandWindows string Komut kancaları için yalnızca Windows'a özgü komut geçersiz kılması. TOML takma adı command_windows da kabul edilir.
hooks.managed_dir string (absolute path) macOS ve Linux üzerinde yönetilen kanca betiklerini içeren dizin. Codex, yönetilen kancaları yüklemeden önce yolun mutlak olduğunu ve dizinin mevcut olduğunu doğrular.
hooks.windows_managed_dir string (absolute path) Windows üzerinde yönetilen kanca betiklerini içeren dizin. Codex, yönetilen kancaları yüklemeden önce yolun mutlak olduğunu ve dizinin mevcut olduğunu doğrular.
in_app_browser table Yerleşik tarayıcı paneli gereksinimleri. Bu ayarlar, ajan tarafından yürütülen Browser Use özelliğini kontrol etmez.
in_app_browser.allow_external_browser_settings_import boolean Kullanıcıların harici bir tarayıcıdaki ayarları veya tarama verilerini yerleşik tarayıcıya aktarmasını önlemek için false olarak ayarlayın. true olarak ayarlamak veya belirtmemek, diğer ürün denetimleri izin verdiğinde içe aktarmayı kullanılabilir durumda bırakır. Bu, config.toml ile geçersiz kılınamayan, yalnızca yönetilen bir ayardır.
log_dir string (path) Codex'in yerel günlük dosyalarını yazdığı dizini zorunlu kılın.
marketplaces table Eklenti pazar yeri kaynakları için yönetici gereksinimleri. Kurallar, restrict_to_allowed_sources değeri true olduğunda geçerli olur.
marketplaces.allowed_sources table Yöneticinin seçtiği kural adına göre anahtarlanmış, izin verilen pazar yeri kaynakları. Farklı adlar gereksinim katmanları boyunca birikir; aynı ad altındaki alanlar normal katman önceliğini kullanır.
marketplaces.allowed_sources.<name> table İzin verilen tek bir kaynak kuralı. Gereksinimler birleştirildikten sonraki nihai source değeri, Codex'in aynı düzeydeki hangi alanları yorumlayacağını belirler.
marketplaces.allowed_sources.<name>.host_pattern string source = "host_pattern" olduğunda gerekli düzenli ifade. Codex bunu HTTPS, SSH veya SCP biçimindeki bir Git kaynağından ayrıştırılan küçük harfli ana makine adıyla eşleştirir. Ana makine adının tamamının eşleşmesini zorunlu kılmak için ^ ve $ kullanın.
marketplaces.allowed_sources.<name>.path string (absolute path) source = "local" olduğunda gerekli yerel pazar yeri dizini. Codex mutlak bir yol gerektirir ve yolları normalleştirdikten sonra karşılaştırır.
marketplaces.allowed_sources.<name>.ref string Bir git kuralı için isteğe bağlı tam Git ref değeri. Belirtilmezse kural, eşleşen deponun tüm ref değerlerine izin verir.
marketplaces.allowed_sources.<name>.source git | host_pattern | local Pazar yeri kaynağı eşleştirici türü. Tek bir depo için git, düzenli ifadeyle eşleştirilen Git ana makineleri için host_pattern veya tek bir dizin için local kullanın.
marketplaces.allowed_sources.<name>.url string source = "git" olduğunda gerekli Git deposu URL'si. Codex, tam depo eşleşmesini zorunlu tutmadan önce yapılandırılmış ve izin verilen URL'leri normalleştirir.
marketplaces.restrict_to_allowed_sources boolean true olduğunda, pazar yeri ekleme, eklenti yükleme, yenileme ve çalışma zamanında yükleme işlemleri için yapılandırılmış pazar yeri kaynaklarının allowed_sources ile eşleşmesini zorunlu kılın. API key kataloğu dahil OpenAI tarafından seçilen Git katalogları da izin listesiyle eşleşmelidir. Paketle sunulan ve uzaktan yüklenen çalışma alanı eklentileri, seçilmiş Git kaynaklarına yönelik bu politikadan ayrıdır.
mcp_servers table Etkinleştirilebilecek MCP server'larının izin listesi. MCP server'ın etkinleştirilebilmesi için hem sunucu adı (&lt;id&gt;) hem de kimliği eşleşmelidir. İzin listesinde olmayan veya kimliği eşleşmeyen yapılandırılmış tüm MCP server'ları devre dışı bırakılır.
mcp_servers.<id>.identity table Tek bir MCP server için kimlik kuralı. command (stdio) veya url (akış destekli HTTP) seçeneklerinden birini ayarlayın.
mcp_servers.<id>.identity.command string | table Tam komut dizesiyle bir MCP stdio server'a izin verin veya tam bir yürütülebilir dosya ve sıralı bağımsız değişken eşleştiricileri gerektirmek için bir eşleştirici tablosu kullanın. Dize biçimi bağımsız değişkenleri, cwd, env veya env_vars değerlerini incelemez.
mcp_servers.<id>.identity.command.args array<table> Bir stdio sunucusu için sıralı bağımsız değişken eşleştiricileri. Yapılandırılmış bağımsız değişken listesi aynı uzunlukta olmalı ve her konum eşleşmelidir. Komut eşleştiricileri cwd, env veya env_vars değerlerini incelemez.
mcp_servers.<id>.identity.command.args[].expression string Bir regex bağımsız değişken eşleştiricisinin kullandığı düzenli ifade. İfade geçerli olmalı ve bağımsız değişken değerinin tamamıyla eşleşmelidir.
mcp_servers.<id>.identity.command.args[].match exact | prefix | regex Bu bağımsız değişken konumu için eşleştirme işlemi.
mcp_servers.<id>.identity.command.args[].value string Bir exact veya prefix bağımsız değişken eşleştiricisinin kullandığı değer.
mcp_servers.<id>.identity.command.executable string stdio sunucusunun yapılandırılmış command değerinin tam olarak eşleşmesi gereken yürütülebilir dosya.
mcp_servers.<id>.identity.url string | table Tam URL dizesiyle bir MCP akış destekli HTTP server'a izin verin veya bir exact, prefix ya da regex değer eşleştirici tablosu kullanın.
mcp_servers.<id>.identity.url.expression string Bir regex URL eşleştiricisinin kullandığı düzenli ifade. İfade geçerli olmalı ve URL değerinin tamamıyla eşleşmelidir.
mcp_servers.<id>.identity.url.match exact | prefix | regex Yapılandırılmış MCP server URL'si için eşleştirme işlemi.
mcp_servers.<id>.identity.url.value string Bir exact veya prefix URL eşleştiricisinin kullandığı değer.
model_catalog_json string (path) Codex'in başlangıçta kullandığı JSON model kataloğunu zorunlu kılın.
model_provider string Yerel ve oturum yapılandırmasını geçersiz kılarak model sağlayıcı kimliğini zorunlu kılın.
model_providers map<string, table> Yönetilen model sağlayıcı tanımları. Her girdi, aynı kimliğe sahip yapılandırılmış sağlayıcının tamamının yerini alır; alanlar kullanıcının tanımıyla birleştirilmez. Diğer kimliklere sahip sağlayıcılar kullanılabilir durumda kalır.
model_providers.<id> table Tam yönetilen sağlayıcı tanımı. config.toml ile aynı sağlayıcı alanlarını kullanır; bunlara name, base_url, kimlik doğrulama ve taşıma ayarları dahildir.
models table [models.new_thread] tablosunu içerir.
models.new_thread table Yeni bir yerel konuşma başlatıldığında uygulanacak isteğe bağlı varsayılanlar. Kullanıcı ve proje varsayılanlarından önceliklidirler ancak açıkça belirtilen geçersiz kılmalar bunların yerini alabilir.
models.new_thread.model string Yeni konuşmalar için varsayılan model. Modelin veya akıl yürütme çabasının açıkça geçersiz kılınması, her iki alanın da yok sayılmasına neden olur.
models.new_thread.model_reasoning_effort string Yeni konuşmalar için varsayılan akıl yürütme çabası. Modelin veya akıl yürütme çabasının açıkça geçersiz kılınması, her iki alanın da yok sayılmasına neden olur.
models.new_thread.service_tier string Yeni konuşmalar için varsayılan hizmet katmanı. Hizmet katmanının açıkça geçersiz kılınması, bu alanın yok sayılmasına neden olur.
permissions table Profil adına göre anahtarlanmış, yönetici tarafından tanımlanan izin profilleri. config.toml ile aynı profil alanlarını kullanır.
permissions.<name> table Yönetici tarafından tanımlanan izin profili. Adı : ile başlayamaz, ayrılmış filesystem adını kullanamaz veya yüklenen bir yapılandırmadaki profille aynı olamaz. config.toml ile aynı profil alanlarını kullanır; tam profil şeması için İzinler kılavuzuna bakın.
permissions.filesystem.deny_read array<string> Yönetici tarafından zorunlu kılınan dosya sistemi okuma yasakları. Girdiler yol veya glob kalıbı olabilir; kullanıcılar bunları yerel yapılandırmayla gevşetemez.
plugins table Eklenti tanımlayıcısına göre anahtarlanmış, eklentiye özgü MCP server izin listeleri. Bu tablo mevcutsa eşleşen bir eklenti ve sunucu girdisi bulunmayan, eklentiyle birlikte sunulan sunucular devre dışı bırakılır.
plugins.<plugin>.mcp_servers table Tek bir eklentiyle birlikte sunulan MCP server'ları için izin listesi. Eklenti sunucusu gereksinimleri, üst düzey mcp_servers gereksinimleriyle aynı tam kimlik ve eşleştirici biçimlerini kullanır.
plugins.<plugin>.mcp_servers.<server>.identity table Eklentiyle birlikte sunulan tek bir MCP server için kimlik kuralı. command (stdio) veya url (akış destekli HTTP) seçeneklerinden birini ayarlayın.
plugins.<plugin>.mcp_servers.<server>.identity.command string | table Tam komut dizesiyle bir eklentinin stdio MCP server'a izin verin veya tam bir yürütülebilir dosya ve sıralı bağımsız değişken eşleştiricileri gerektirmek için bir eşleştirici tablosu kullanın.
plugins.<plugin>.mcp_servers.<server>.identity.command.args array<table> Eklentiyle birlikte sunulan bir stdio sunucusu için sıralı bağımsız değişken eşleştiricileri. Yapılandırılmış bağımsız değişken listesi aynı uzunlukta olmalı ve her konum eşleşmelidir.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression string Bir regex bağımsız değişken eşleştiricisinin kullandığı düzenli ifade. İfade, bağımsız değişken değerinin tamamıyla eşleşmelidir.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match exact | prefix | regex Bu bağımsız değişken konumu için eşleştirme işlemi.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value string Bir exact veya prefix bağımsız değişken eşleştiricisinin kullandığı değer.
plugins.<plugin>.mcp_servers.<server>.identity.command.executable string Eklentiyle birlikte sunulan stdio sunucusunun yapılandırılmış komutunun tam olarak eşleşmesi gereken yürütülebilir dosya.
plugins.<plugin>.mcp_servers.<server>.identity.url string | table Tam URL dizesiyle bir eklentinin akış destekli HTTP MCP server'a izin verin veya bir exact, prefix ya da regex değer eşleştirici tablosu kullanın.
plugins.<plugin>.mcp_servers.<server>.identity.url.expression string Bir regex URL eşleştiricisinin kullandığı düzenli ifade. İfade, URL değerinin tamamıyla eşleşmelidir.
plugins.<plugin>.mcp_servers.<server>.identity.url.match exact | prefix | regex Eklentiyle birlikte sunulan MCP server URL'si için eşleştirme işlemi.
plugins.<plugin>.mcp_servers.<server>.identity.url.value string Bir exact veya prefix URL eşleştiricisinin kullandığı değer.
remote_sandbox_config array<table> Ana makineye özgü korumalı alan gereksinimleri. hostname_patterns değeri çözümlenen ana makine adıyla eşleşen ilk girdi, ilgili gereksinim kaynağının üst düzey allowed_sandbox_modes ayarını geçersiz kılar. Ana makineye özgü girdiler şu anda yalnızca korumalı alan modlarını geçersiz kılar.
remote_sandbox_config[].allowed_sandbox_modes array<string> Ana makineye özgü bu girdi eşleştiğinde uygulanacak izin verilen korumalı alan modları.
remote_sandbox_config[].hostname_patterns array<string> Büyük/küçük harfe duyarsız ana makine adı kalıpları. Herhangi bir karakter dizisi için * ve tek bir karakter için ? desteklenir.
rules table .rules dosyalarıyla birleştirilen, yönetici tarafından zorunlu kılınan komut kuralları. Gereksinim kuralları kısıtlayıcı olmalıdır.
rules.prefix_rules array<table> Zorunlu olarak uygulanan önek kurallarının listesi. Her kural pattern ve decision içermelidir.
rules.prefix_rules[].decision prompt | forbidden Zorunludur. Gereksinim kuralları yalnızca onay isteyebilir veya yasaklayabilir; izin veremez.
rules.prefix_rules[].justification string Onay istemlerinde veya ret mesajlarında gösterilen, isteğe bağlı ve boş olmayan gerekçe.
rules.prefix_rules[].pattern array<table> Kalıp tokenları olarak ifade edilen komut öneki. Her token, token veya any_of seçeneklerinden birini ayarlar.
rules.prefix_rules[].pattern[].any_of array<string> Bu konumda izin verilen alternatif tokenların listesi.
rules.prefix_rules[].pattern[].token string Bu konumdaki tek bir sabit token.
sqlite_home string (path) Codex'in SQLite tabanlı çalışma zamanı durumunu sakladığı dizini zorunlu kılın.
windows table Yerel Windows korumalı alan gereksinimleri.
windows.allowed_sandbox_implementations array<string> İzin verilen eski yerel Windows korumalı alan uygulamaları (elevated ve unelevated). Liste boş olmamalıdır. Her ikisine de izin verildiğinde ve bir mod seçilmediğinde Codex, elevated seçeneğini tercih eder. Bu liste, kullanılabilir olduğunda mxc korumalı alanını kısıtlamaz.