Ekibiniz için Codex yapılandırmasını kendi sunucunuzda barındırın
İşlettiğiniz bir HTTPS uç noktasından Codex'e varsayılan yapılandırmaları ve zorunlu ayarları sunun.
Kullanıcılarınız Codex'e ChatGPT ile giriş yapmıyorsa, işlettiğiniz bir HTTPS sunucusundan Codex CLI'a ve masaüstü uygulamasına yapılandırma dağıtabilirsiniz. Kullanıcılar model sağlayıcılarına doğrudan veya bir ağ geçidi üzerinden bağlansa da Codex, başlangıçta ayarlarınızı yükler.
İstemci sınırlamaları
Masaüstü uygulaması, yapılandırma sunucusuna giriş yapmanızı isteyemez. Sunucunuz yeni bir giriş gerektiriyorsa aynı bilgisayardaki bir terminalde codex login komutunu çalıştırın, ardından uygulamayı yeniden açın. Uygulama zorunlu ayarları yükleyemezse başlatma işlemi duraklar.
Codex'i sunucuyu kullanacak şekilde yapılandırın
Bir test bilgisayarında sistemin requirements.toml dosyasını oluşturun veya güncelleyin. Yapılandırma sunucunuzun temel URL'sini içeren bir [config_server] tablosu ekleyin. Linux ve macOS'te /etc/codex/requirements.toml, Windows'ta ise %ProgramData%\OpenAI\Codex\requirements.toml kullanın. macOS'te tabloyu yönetilen tercihler üzerinden de dağıtabilirsiniz.
[config_server]
base_url = "https://codex-config.example.com/team"Sunucuyu yalnızca yerel yöneticinin kontrolündeki gereksinimler seçebilir. Politikanızın geri kalanını uç noktaya taşıdığınızda bu tabloyu bilgisayarda tutun.
Yapılandırma sunucusunda kimlik doğrulaması yapın (isteğe bağlı)
Codex varsayılan olarak yapılandırmayı kimlik bilgileri olmadan getirmeye çalışır. Sunucunuz giriş gerektiriyorsa aynı requirements.toml dosyasına [config_server.oauth] ekleyin. Codex, Proof Key for Code Exchange (PKCE) ile OAuth yetkilendirme kodu akışını kullanır.
[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127Bu örneğin yönlendirme URI'si http://127.0.0.1:43127/callback şeklindedir. Sağlayıcınız kullanılabilir herhangi bir bağlantı noktasında geri döngü geri çağrısını kabul ediyorsa redirect_port değerini atlayabilirsiniz. Codex, erişim belirtecini Authorization başlığında gönderir. Sunucunuz paketi döndürmeden önce bunu doğrulamalıdır.
Codex yapılandırmasını sunun
Yönetilen yapılandırmanızı bir HTTPS uç noktasında barındırın. Codex CLI paketi getirirken yerel requirements.toml dosyasındaki temel URL'yi kullanarak bir GET isteği gönderir:
GET {config_server.base_url}/codex/config/bundleYukarıdaki başlangıç örneğindeki base_url ile Codex şu isteği gönderir:
GET https://codex-config.example.com/team/codex/config/bundle200 OK ile yanıt verin ve yanıt gövdesine bir JSON yapılandırma paketi ekleyin.
Yapılandırma paketi biçimi
Paket, TOML girdilerini iki dizide gruplandırır:
config_toml.enterprise_managed, uygulanacak varsayılanları içerir. Her girdinincontentsalanıconfig.tomlmetnidir.requirements_toml.enterprise_managed, uygulanması zorunlu gereksinimleri içerir. Her girdinincontentsalanırequirements.tomlmetnidir.
Her dizi girdisinin üç dize alanı vardır: id, name (görünen ad) ve contents. İhtiyacınız olmayan kategoriler için boş bir dizi kullanın.
Bu örnek, web araması varsayılanını disabled olarak ayarlar ve allowed_web_search_modes ile bu değeri zorunlu kılar.
{
"config_toml": {
"enterprise_managed": [
{
"id": "search-default",
"name": "Default web search",
"contents": "web_search = 'disabled'"
}
]
},
"requirements_toml": {
"enterprise_managed": [
{
"id": "search-policy",
"name": "Allowed web search modes",
"contents": "allowed_web_search_modes = ['disabled']"
}
]
}
}Codex'te yapılandırmayı doğrulayın
- Bir test bilgisayarında proje dizininizde bir terminal açın ve
codexkomutunu çalıştırın. İstenirse şirket hesabınızla giriş işlemini tamamlayın. - Etkileşimli Codex CLI isteminde
/debug-configyazın ve Enter tuşuna basın. - Varsayılanlar sunuyorsanız bunların adlarını ve kimliklerini Config layer stack altında bulun. Yukarıdaki örnekte
enterprise-managed (Default web search, search-default) (enabled)değerini arayın. - Gereksinimler sunuyorsanız zorunlu kıldığınız bir ayarı Requirements altında bulun ve yanında listelenen politika kaynağını kontrol edin.
Codex, önbelleğe alınmış ayarlarla başlayabilir ve bunları arka planda yenileyebilir. Sunucuda bir politikayı değiştirdikten sonra Codex'in bunu yenilemesini bekleyin, ardından yeni bir oturum başlatın ve diğer makinelere dağıtmadan önce kontrolü tekrarlayın.