Yapılandırma temelleri

Codex, yapılandırma ayrıntılarını birden fazla konumdan okur. Kişisel varsayılanlarınız ~/.codex/config.toml içinde bulunur; proje geçersiz kılmalarını ise .codex/config.toml dosyalarıyla ekleyebilirsiniz. Codex, güvenlik amacıyla proje .codex/ katmanlarını yalnızca projeye güvendiğinizde yükler.

Codex yapılandırma dosyası

Codex, kullanıcı düzeyindeki yapılandırmayı ~/.codex/config.toml konumunda saklar. Ayarların kapsamını belirli bir proje veya alt klasörle sınırlamak için deponuza bir .codex/config.toml dosyası ekleyin.

Yapılandırma dosyasını Codex IDE uzantısından açmak için sağ üst köşedeki dişli simgesini, ardından Codex Settings > Open config.toml seçeneğini belirleyin.

CLI ve IDE uzantısı aynı yapılandırma katmanlarını paylaşır. Bunları şu amaçlarla kullanabilirsiniz:

• Varsayılan modeli ve sağlayıcıyı ayarlamak.
• Onay politikalarını ve korumalı alan ayarlarını yapılandırmak.
• MCP sunucularını yapılandırmak.

Yapılandırma önceliği

Codex, değerleri şu sırayla çözümler (en yüksek öncelikten başlayarak):

1. CLI bayrakları ve --config geçersiz kılmaları
2. Proje yapılandırma dosyaları: Proje kökünden geçerli çalışma dizininize doğru sıralanan .codex/config.toml dosyaları (en yakındaki kazanır; yalnızca güvenilen projeler)
3. --profile profile-name ile seçilen profil dosyaları (~/.codex/profile-name.config.toml)
4. Kullanıcı yapılandırması: ~/.codex/config.toml
5. Sistem yapılandırması (varsa): Unix'te /etc/codex/config.toml
6. Yerleşik varsayılanlar

Ortak varsayılanları config.toml içinde ayarlamak ve profil dosyalarını yalnızca farklılık gösteren değerlere odaklamak için bu öncelik sırasını kullanın.

Bir projeyi güvenilmeyen olarak işaretlerseniz Codex; projeye özgü yapılandırma, kancalar ve kurallar dâhil olmak üzere proje kapsamındaki .codex/ katmanlarını atlar. Kullanıcı/genel kancalar ve kurallar dâhil olmak üzere kullanıcı ve sistem yapılandırmaları yüklenmeye devam eder.

-c/--config aracılığıyla tek seferlik geçersiz kılmalar (TOML tırnak kuralları dâhil) için Gelişmiş Yapılandırma bölümüne bakın.

Yaygın yapılandırma seçenekleri

Kullanıcıların en sık değiştirdiği seçeneklerden bazıları şunlardır:

Varsayılan model

Codex'in CLI ve IDE'de varsayılan olarak kullanacağı modeli seçin.

model = "gpt-5.6"

Onay istemleri

Codex'in oluşturulan komutları çalıştırmadan önce sormak için ne zaman duraklayacağını denetleyin.

approval_policy = "on-request"

untrusted, on-request ve never arasındaki davranış farklılıkları için Onay istemleri olmadan çalıştırma ve Yaygın korumalı alan ve onay birleşimleri bölümlerine bakın.

Korumalı alan düzeyi

Codex'in komutları yürütürken sahip olduğu dosya sistemi ve ağ erişimi miktarını ayarlayın.

sandbox_mode = "workspace-write"

Modlara göre davranış (korunan .git/.codex yolları ve ağ varsayılanları dâhil) için Korumalı alan ve onaylar, Yazılabilir köklerdeki korunan yollar ve Ağ erişimi bölümlerine bakın.

İzin profilleri

Codex ayrıca yeniden kullanılabilir dosya sistemi ve ağ politikaları için adlandırılmış izin profillerini destekler. Yerleşik profiller :read-only, :workspace ve :danger-full-access şeklindedir. Özel profiller, [permissions.<name>] tablolarını ve bunlarla eşleşen bir default_permissions değerini kullanır. İzinler bölümüne bakın.

Windows korumalı alan modu

Codex'i doğrudan Windows üzerinde çalıştırırken windows tablosundaki yerel korumalı alan modunu elevated olarak ayarlayın. unelevated seçeneğini yalnızca yönetici izinleriniz yoksa veya yükseltilmiş kurulum başarısız olursa kullanın.

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

Web araması modu

Codex, yerel sohbetlerde web aramasını varsayılan olarak etkinleştirir ve sonuçları bir web araması önbelleğinden sunar. Önbellek, OpenAI tarafından yönetilen bir web sonuçları dizinidir; bu nedenle önbelleğe alınmış mod, canlı sayfaları getirmek yerine önceden dizine eklenmiş sonuçları döndürür. Bu, rastgele canlı içeriklerden kaynaklanan istem enjeksiyonuna maruz kalmayı azaltır; ancak web sonuçlarını yine de güvenilmeyen içerik olarak değerlendirmelisiniz. --yolo veya başka bir tam erişimli korumalı alan ayarı kullanıyorsanız web araması varsayılan olarak canlı sonuçları kullanır. web_search ile bir mod seçin:

• "cached" (varsayılan), sonuçları web araması önbelleğinden sunar.
• "indexed", harici web erişimine yalnızca arama dizini isteği onayladığında izin verir.
• "live", en güncel verileri web'den getirir (--search ile aynıdır).
• "disabled", web araması aracını kapatır.

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

Akıl yürütme çabası

Desteklendiğinde modelin ne kadar akıl yürütme çabası harcayacağını ayarlayın.

model_reasoning_effort = "high"

İletişim tarzı

Desteklenen modeller için varsayılan bir iletişim tarzı ayarlayın.

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

Bunu daha sonra etkin bir oturumda /personality ile veya app-server API'lerini kullanırken iş parçacığı/etkileşim bazında geçersiz kılabilirsiniz.

TUI tuş eşlemesi

Terminal kısayollarını tui.keymap altında özelleştirin. Seçilen düzenleyici eylemleri, eşleşen tui.keymap.global bağlamalarına geri döner; desteklendiğinde bağlama özgü bağlamalar önceliklidir. Boş bir liste, eylemin bağlamasını kaldırır.

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

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

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

Komut ortamı

Codex'in başlatılan komutlara hangi ortam değişkenlerini ileteceğini denetleyin. Yalnızca ihtiyaç duyduğunuz değişkenleri tutmak için anahtarlı filtreler kullanın:

[shell_environment_policy]
ignore_default_excludes = false

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

ignore_default_excludes varsayılan olarak true değerini kullanır; bu da adlarında KEY, SECRET veya TOKEN bulunan değişkenler için otomatik filtrelemeyi atlar. Otomatik filtreleme istiyorsanız bunu false olarak ayarlayın. Dışlama kuralları, öncelik ve eski yapılandırma için Kabuk ortamı politikası bölümüne bakın.

Günlük dizini

Codex'in yerel günlük dosyalarını yazdığı konumu geçersiz kılın. log_dir değerinin açıkça ayarlanması, aynı zamanda bu dizindeki isteğe bağlı düz metin TUI günlüğü olan codex-tui.log seçeneğini etkinleştirir.

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

Tek seferlik çalıştırmalar için bunu CLI üzerinden de ayarlayabilirsiniz:

codex -c log_dir=./.codex-log

Özellik bayrakları

İsteğe bağlı ve deneysel yetenekleri açıp kapatmak için config.toml içindeki [features] tablosunu kullanın.

Yaygın özellik bayrakları

Yaşam döngüsü kancalarının yapılandırması için Kancalar bölümüne bakın.

Özellikleri etkinleştirme

• config.toml içinde, [features] altına feature_name = true ekleyin.
• CLI'dan codex --enable feature_name komutunu çalıştırın.
• Birden fazla özelliği etkinleştirmek için codex --enable feature_a --enable feature_b komutunu çalıştırın.
• Bir özelliği devre dışı bırakmak için config.toml içindeki anahtarı false olarak ayarlayın.