İçeriğe geç
Geliştirici Kaynakları
Geliştirici Kaynakları

Codex Uygulaması

Codex App'te RunAPI'yi model sağlayıcı olarak kullanın, Responses uyumlu bir model seçin ve bağlantıyı doğrulayın.

Markdown'ı görüntüle

Genel Bakış

Codex, Windows ve macOS için ChatGPT masaüstü uygulamasında mevcuttur. Bu kılavuz, yerel Codex Uygulamasını RunAPI’nin OpenAI uyumlu Responses uç noktasına yönlendirir, bir RunAPI modeli seçer ve bağlantıyı doğrular.

Bu, yanıt ve kod oluşturmak için kullanılan model sağlayıcısını değiştirir. RunAPI araçları eklemez. Barındırılan MCP, kendi istemci ve kimlik doğrulama gereksinimleri olan ayrı bir entegrasyondur.

Başlamadan önce

Bu adımlar, kullanıcı düzeyi yapılandırmanızı okuyan yerel Codex istemcilerini yapılandırır. Barındırılan Codex bulut görevlerini yapılandırmaz.

API anahtarını kaydet

Masaüstü uygulamaları, kabuğunuzdan ortam değişkenlerini devralamayabilir. ~/.codex/.env dosyasını oluşturun veya düzenleyin ve anahtarı kendi satırına ekleyin:

DOTENV 
export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

Bu dosyayı depolarınızın dışında tutun. macOS ve Linux’ta yalnızca kendi kullanıcı hesabınızla erişilebilecek şekilde kısıtlayın:

SHELL 
chmod 600 ~/.codex/.env

RunAPI'yi yapılandırın

Kullanıcı düzeyi ~/.codex/config.toml dosyasını açın. Aşağıdaki değerleri mevcut dosyayla birleştirin; ilgisiz ayarları değiştirmeyin veya mevcut üst düzey bir anahtarın ikinci bir kopyasını eklemeyin:

TOML 
model = "YOUR_RUNAPI_MODEL_ID"
model_provider = "runapi"

[model_providers.runapi]
name = "RunAPI"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"
wire_api = "responses"

Sağlayıcı ve kimlik doğrulama ayarları kullanıcı düzeyinde olmalıdır. Codex, projenin .codex/config.toml dosyasındaki model_provider ve model_providers değerlerini yoksayar. TOML yalnızca ortam değişkeni adını saklar; API anahtarı ~/.codex/.env dosyasında kalır.

base_url, bir işlem URL’si değil API köküdür. wire_api = "responses" ile Codex, POST /v1/responses isteği gönderir. Sağlayıcı sözleşmesi için OpenAI’ın özel model sağlayıcı yapılandırmasına bakın.

Bir model seçin

YOUR_RUNAPI_MODEL_ID değerini Model Kataloğu‘ndan kopyalanan tam tanımlayıcıyla değiştirin. Responses API’yi ortaya çıkaran bir model seçin; yalnızca Chat Completions desteği bu yapılandırma için yeterli değildir.

model değerini değiştirdiğinizde uygulamayı tamamen yeniden başlatın ve yeni bir görev başlatın. Mevcut bir görev, başlatıldığı model ve sağlayıcıyı koruyabilir.

Yeniden başlatın ve doğrulayın

  1. ChatGPT masaüstü uygulamasını tamamen kapatıp yeniden açın.
  2. Codex’i açın ve bir depoda yeni bir görev başlatın.
  3. Describe this repository in one sentence. gibi kısa bir istem gönderin.
  4. Codex’in normal bir yanıt döndürdüğünü ve RunAPI’nin seçilen model için bir POST /v1/responses isteği kaydettiğini doğrulayın.

İlk doğrulama kısa tutulmalıdır; böylece yapılandırma hataları göreve özgü davranışlardan kolayca ayırt edilebilir.

RunAPI araçlarını ekleyin

Yukarıdaki model sağlayıcı, Codex çıkarımını RunAPI üzerinden yönlendirir. MCP ayrıdır: desteklenen istemcilerin model keşfi, hesap bilgileri ve desteklenen görev iş akışları için RunAPI araçlarını çağırmasına olanak tanıyabilir.

Barındırılan MCP kılavuzu, şu an desteklenen istemci ve kimlik doğrulama gereksinimlerini belgeler. Codex’e özgü Barındırılan MCP kimlik doğrulaması doğrulanmadığından bu sayfa Codex MCP kurulum adımlarını içermez. Model sağlayıcı yapılandırmasını bir MCP sunucu girişiyle değiştirmeyin; bu iki entegrasyon farklı amaçlara hizmet eder.

Sorun giderme

  • Codex hâlâ önceki sağlayıcıyı kullanıyor: Dosyanın ~/.codex/config.toml olduğunu onaylayın, yinelenen model veya model_provider anahtarlarını kaldırın, uygulamayı tamamen yeniden başlatın ve yeni bir görev başlatın.
  • RUNAPI_API_KEY eksik: Anahtarın yalnızca terminal profilinde değil ~/.codex/.env içinde olduğunu doğrulayın, ardından uygulamayı yeniden başlatın.
  • Kimlik doğrulama başarısız olur: Kimlik Doğrulama Kılavuzu üzerinden standart bir anahtar oluşturun veya döndürün. Anahtarı config.toml dosyasına veya destek günlüklerine yapıştırmayın.
  • İstek 404 döndürüyor: base_url değerini https://runapi.ai/v1/responses yerine https://runapi.ai/v1 olarak ayarlayın.
  • Model kullanılamıyor veya bir alanı reddediyor: Tanımlayıcıyı tekrar tam olarak kopyalayın ve modelin Responses API ile istenen özelliği desteklediğini doğrulayın.
  • Codex farklı bir model seçiyor: Güvenilir proje .codex/config.toml dosyalarında model geçersiz kılmasını kontrol edin. Proje yapılandırması, kullanıcı düzeyindeki sağlayıcının yerini alamasa da bir model seçebilir.
  • CLI çalışıyor ancak uygulama başarısız oluyor: ~/.codex/.env dosyasını kontrol edin, ardından uygulamayı tamamen yeniden başlatın. GUI uygulamaları yalnızca kabuğunuz tarafından dışa aktarılan değişkenleri okuyamayabilir.
  • Bir bulut görevi RunAPI kullanmıyor: Bu yerel yapılandırma yalnızca yerel Codex istemcileri için geçerlidir; barındırılan bulut görevleri bilgisayarınızdaki dosyaları okumaz.

RunAPI'yi Kaldır

  1. ~/.codex/config.toml dosyasından RunAPI model, model_provider ve [model_providers.runapi] değerlerini kaldırın ya da önceden kullandığınız sağlayıcı değerlerini geri yükleyin.
  2. Başka bir yerel araç kullanmıyorsa RUNAPI_API_KEY değerini ~/.codex/.env dosyasından kaldırın.
  3. Uygulamayı tamamen yeniden başlatın ve yeni bir görev başlatın.
  4. Artık ihtiyaç duyulmadığında RunAPI’deki özel anahtarı iptal edin.

Sonraki adımlar

Paylaşılan protokol davranışı için LLM API Hızlı Başlangıç ve tam istek ile yanıt alanları için Responses API Başvurusu kullanın. Gerektiğinde Model Kataloğu, Kimlik Doğrulama Kılavuzu veya Barındırılan MCP ile devam edin.