Bir ağ geçidine bağlanın

Kuruluşunuzun sağladığı ağ geçidi URL'sini, model takma adını ve kimlik bilgisini veya token çözümleyicisini kullanarak Codex'i bir LLM ağ geçidine bağlayın.

Mevcut bir yapılandırma olup olmadığını kontrol edin

Herhangi bir şey eklemeden önce, yöneticinizin Codex'i zaten yapılandırıp yapılandırmadığını kontrol edin.

• CLI için seçili profili inceleyin ve codex doctor komutunu çalıştırın. Başlangıçtan sonra, etkin modeli ve sağlayıcıyı doğrulamak için /status kullanın.
• macOS uygulaması için ~/.codex/config.toml dosyasını veya kuruluşunuzun sağladığı yönetilen yapılandırmayı inceleyin.
• Windows uygulaması için %USERPROFILE%\.codex\config.toml dosyasını veya kuruluşunuzun sağladığı sistem yapılandırmasını inceleyin.

Beklenen ağ geçidi sağlayıcısı ve model zaten etkinse Bağlantıyı doğrulayın bölümüne geçin.

Ağ geçidi bağlantı bilgilerinizi edinin

Codex CLI veya kuruluşunuzun onayladığı masaüstü uygulamasını yükleyin. Codex'i kendiniz yapılandırmak için ağ geçidi ekibinizden şu değerleri alın:

• API yolu dahil HTTPS ağ geçidi temel URL'si; örneğin https://gateway.example.com/v1.
• Kullanılacak model adı ve sağlayıcı kimliği.
• Erişim kapsamı sınırlandırılmış ağ geçidi kimlik bilginiz ve bunun ortam değişkeni veya yüklü bir token çözümleyicisi ve yapılandırması.
• Gerekli model kataloğu dosyası ve bunun mutlak yerel yolu.

Sağlayıcıyı yapılandırın

config.toml dosyasını macOS veya Linux'ta ~/.codex/config.toml konumunda ya da Windows'ta %USERPROFILE%\.codex\config.toml konumunda açın.

URL'yi ve modeli yöneticinizin sağladığı değerlerle değiştirerek bu örneği mevcut yapılandırmanızla birleştirin. Mevcut bir anahtar veya tablo için ikinci bir tanım eklemeyin. Bu örnekte gpt-6-sol kullanılır; bunu özel bir katalog olmadan yalnızca yöneticiniz Codex sürümünüzün modeli tanıdığını ve birlikte gelen meta verilerin ağ geçidiyle eşleştiğini doğrularsa kullanın.

model = "gpt-6-sol"
model_provider = "enterprise-gateway"
web_search = "disabled"

[model_providers.enterprise-gateway]
name = "Organization Gateway"
base_url = "https://gateway.example.com/v1"
wire_api = "responses"
env_key = "CODEX_GATEWAY_API_KEY"

Yöneticiniz bir model kataloğu sağlarsa bunu yerel olarak kaydedin ve model_catalog_json ayarını dosyanın mutlak yolunu kullanarak ilk TOML tablosundan önce ekleyin. Özel takma adlar, eşleşen katalog meta verileri gerektirir. Örneğin:

model_catalog_json = "/etc/codex/gateway-models.json"

Yöneticinizin birlikte sağladığı model adını ve kataloğu kullanın. Dosya belirtilen konumda mevcut değilse katalog yolu eklemeyin.

enterprise-gateway, örnek bir sağlayıcı kimliğidir. Aynı kimliği model_provider, [model_providers.<id>] ve [model_providers.<id>.auth] içinde kullanın. Bu örnek, ilk bağlantı testi için web aramasını devre dışı bırakır; yöneticiniz bu özelliği etkinleştirmeden önce özellik desteğini doğrulamalıdır.

Ağ geçidi kimlik bilginizi, kuruluşunuzun gizli bilgi dağıtım mekanizmasını kullanarak Codex'i başlatan sürecin ortamında CODEX_GATEWAY_API_KEY olarak kullanılabilir hale getirin. Kimlik bilgisini TOML dosyasına veya bir depoya koymayın. Terminalde ayarlanan bir değişken, masaüstünden başlatılan bir uygulamada kullanılamayabilir.

Özel bir kimlik doğrulama üst bilgisi kullanın

Ağ geçidiniz bearer token yerine X-API-Key gibi bir üst bilgi gerektiriyorsa sağlayıcı tablosundaki env_key ayarını şununla değiştirin:

env_http_headers = { "X-API-Key" = "CODEX_GATEWAY_API_KEY" }

Yöneticinizin sağladığı üst bilgi adını aynen kullanın. Codex, değeri belirtilen ortam değişkeninden okur; kimlik bilgisini yapılandırma dosyasında tutmayın. model_providers.<id>.env_http_headers hakkında bilgi için yapılandırma başvurusuna bakın.

Kuruluşun kimlik bilgisi yardımcısını kullanın

Yöneticiniz komut destekli kimlik doğrulama sağlıyorsa env_key yerine yüklediği yardımcıyı ve yapılandırmayı kullanın. Her iki mekanizmayı birden yapılandırmayın. Yardımcı makinenizde mevcut olmalıdır; Codex bunu yüklemez. Örneğin, yöneticinizin sağladığı çözümleyici yolunu ve bağımsız değişkenleri kullanarak örnekteki env_key ayarını bu tabloyla değiştirin:

[model_providers.enterprise-gateway.auth]
command = "/usr/local/bin/fetch-codex-gateway-token"
args = ["print-token"]
timeout_ms = 30000
refresh_interval_ms = 300000

Özel sağlayıcı kimlik doğrulaması başvurusu, komutu, bağımsız değişkenleri, zaman aşımını, yenileme aralığını ve token çıktısına ilişkin sözleşmeyi tanımlar. Yardımcı artık token alamıyorsa oturumunuzu nasıl yenileyeceğinizi yöneticinize sorun.

Yardımcı yürütülebilir dosyaları ve katalog dosyaları için çözümlenmiş mutlak yollar kullanın.

CLI'ı yapılandırın

CLI, macOS veya Linux'ta varsayılan olarak ~/.codex/config.toml dosyasını okur. Sağlayıcı ayarlarını kaydettikten sonra codex komutunu çalıştırın. WSL içinde, CODEX_HOME başka bir konuma işaret etmediği sürece Linux yapılandırmasını ve yollarını kullanın.

macOS uygulamasını yapılandırın

macOS uygulaması aynı ~/.codex/config.toml dosyasını okur. Sağlayıcı ayarlarını kaydettikten sonra uygulamayı yeniden başlatın. Kimlik bilgisi için bir ortam değişkeni kullanıyorsanız bunun uygulama süreci tarafından erişilebilir olduğundan emin olun.

Windows uygulamasını yapılandırın

Sağlayıcı ayarlarını %USERPROFILE%\.codex\config.toml dosyasına yerleştirin, ardından uygulamayı yeniden başlatın. Komut destekli kimlik doğrulama için yöneticinizin yüklediği çözümleyiciyi kullanın. Örneğin, Unix kimlik doğrulama tablosunu şununla değiştirin:

[model_providers.enterprise-gateway.auth]
command = 'C:\Program Files\OpenAI\Codex\fetch-codex-gateway-token.exe'
args = ["print-token"]
timeout_ms = 30000
refresh_interval_ms = 300000

Windows TOML dosyalarında tek tırnaklı sabit dizeler, ters eğik çizgileri korur. Unix katalog yollarını da değiştirin; örneğin yöneticinizin sağladığı gerçek yolu kullanarak 'C:\ProgramData\OpenAI\Codex\models.json' biçiminde yazın.

MCP server'ları ve eklentileri ayrı olarak yapılandırın. Bir model ağ geçidi kimlik bilgisi, araçlarınıza veya bağlı sistemlerinize erişim yetkisi vermez.

Bağlantıyı doğrulayın

Yapılandırmayı değiştirdikten sonra istemciyi yeniden başlatın. CLI'da codex başlatın ve etkin modeli ve sağlayıcıyı incelemek için /status kullanın. Masaüstü uygulamasında seçili modeli ve yapılandırmayı kontrol edin.

Yeni bir görevde şu prompt'u gönderin:

Reply with exactly: gateway-ok

Beklenen yanıt gateway-ok şeklindedir. Tek başına bir yanıt, hangi rotanın isteği işlediğini kanıtlamaz: yöneticinizden ağ geçidinin kullanıcı kimliğinizi, model takma adını ve amaçlanan üst hizmet rotasını kaydettiğini doğrulamasını isteyin. Modeli, kendisine adını sorarak belirlemeyin.

Bu işlem, ilk bağlantıyı doğrular. Yöneticiler ayrıca akış, araçlar ve sonraki konuşma turları için kullanıma sunma kontrollerini tamamlamalıdır.

Bağlantı sorunlarını giderin

Yardım isterken token'ları ve hassas prompt'ları çıkararak hata mesajını ekleyin.

Mevcut bir ağ geçidi dağıtımını kullanın

Kuruluşunuz başka bir kodlama aracıyla zaten bir ağ geçidi kullanıyorsa bunun ağ yolunu, günlük kaydını ve sağlayıcı erişimini yeniden kullanabilirsiniz. Bir Codex bağlantısı yapılandırıp test etmek için ağ geçidi ekibinizle çalışın:

1. Mevcut ağ geçidi URL'sini, kimlik bilgisi mekanizmasını, gerekli üst bilgileri, model rotalarını ve yapılandırma dağıtım yöntemini belirleyin.
2. Ağ geçidi ekibinizden, ağ geçidinin Codex'in gerektirdiği API davranışını desteklediğini doğrulamasını ve bir Codex model rotası yapılandırmasını isteyin.
3. Ağ geçidi ekibinizden erişim kapsamı sınırlandırılmış bir ağ geçidi kimlik bilgisi veya kimlik bilgisi yardımcısı, model adı ve gerekli model kataloğunu alın.
4. Bu değerlerle Codex'i yapılandırın.
5. Kullanmayı planladığınız CLI veya masaüstü uygulamasında bağlantıyı doğrulayın. Ağ geçidi ekibinizin akış, araç ve sonraki konuşma turu kontrollerini tamamlamasını sağlayın.
6. Pilot uygulama başarılı olduktan sonra yapılandırmayı diğer geliştiricilere dağıtmak için Codex'i bir ağ geçidi üzerinden dağıtma sayfasını izleyin.

Yönetici geçiş kontrol listesi ve yapılandırma eşlemesi için Mevcut bir ağ geçidi dağıtımını yeniden kullanma sayfasına bakın.

İlgili belgeler

• Codex CLI
• MCP server'lar
• Eklentiler