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_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
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.<name>] 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. |
Eşleşen yapılandırma seçeneği yok.
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.jsonNot: 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, <scheme>://<host-pattern>[:<port>] 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ı (<id>) 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. |
Eşleşen yapılandırma seçeneği yok.