Skip to main content

​
Bunu ajanım kursun

Bu görevi bilgisayarınızda halihazırda çalışan bir ajana kopyalayın:

​
Bağlantı nasıl çalışır

OpenCodex, Codex ile model API’leri arasında yerel bir proxy’dir. Bu kılavuz OpenCodex 2.73.0 ve Codex CLI 0.149.0 sürümlerini kullanır. TokenLab ön ayarının Chat Completions entegrasyonu 2.72.0 sürümünde yayınlandı ve uçtan uca doğrulandı. Sürüm 2.73.0, bu entegrasyonu korur ve modele özgü Responses ile Anthropic Messages yönlendirmesini ekler. Aşağıda listelenen rotalar; akışlı metin ve işlev çağrısı/sonuç gidiş-dönüşleri ile TokenLab üzerinde kontrol edilmiştir. Codex, Responses isteklerini yerel OpenCodex proxy’sine gönderir. OpenCodex ardından seçilen modelin isteğini TokenLab’e iletir. Yerel bağlantıdaki bir Responses isteği, modelin TokenLab’in Responses API’si üzerinden çağrıldığı anlamına gelmez. Ön ayarın Base URL’si https://api.tokenlab.sh/v1 değerindedir. Değiştirmeden bırakın: OpenCodex eşleşen Messages veya Responses URL’sini kendisi oluşturur. Listelenen Responses varsayılanları ve Claude yönlendirmesi dışındaki modeller, ön ayarın Chat bağdaştırıcısını kullanır. TokenLab, bunu belirten modeller için Gemini’ın yerel API’sini destekler, ancak OpenCodex 2.73.0 TokenLab ön ayarı Gemini’ı Chat Completions üzerinden çağırır. Sağlayıcının tamamını Responses veya Gemini olarak değiştirmeyin; bu durum, o formatı kabul etmeyen modeller için de istekleri değiştirecektir.

​
Yükleme veya güncelleme

npm kurulumu için Node.js 18 veya daha yeni bir sürüm kullanın:
Codex’in de yüklü olması gerekir. OpenCodex kurulum ve Codex bağlantı talimatları sağlar. Yerel Windows ve WSL ayrı yapılandırmalara sahiptir; kurulumu ve Codex’i aynı ortamda çalıştırın.

​
TokenLab Ekleme

TokenLab API Anahtarları bölümünde bir anahtar oluşturun. Terminal kurulumu için, değerini komut geçmişine eklemeden TOKENLAB_API_KEY değişkenini ayarlamak üzere Hızlı Başlangıç kılavuzunu izleyin. OpenCodex’i bu terminalden başlatın; bir arka plan hizmeti, değişkenin kendi başlatma ortamında bulunmasına ihtiyaç duyar. Sıfırdan bir OpenCodex kurulumu için ocx init komutunu çalıştırın, TokenLab’i seçin ve anahtarı yerel olarak girin ya da ${TOKENLAB_API_KEY} ortam değişkeni referansını doğrudan kullanın. Sihirbazın Codex bağlantısı ve otomatik başlatma seçeneklerini uygulamadan önce inceleyin. Mevcut bir kurulum için, diğer sağlayıcıları değiştirmeden ön ayarı ekleyin:
Tek tırnaklar anahtarın değerini değil, bir ortam değişkeni referansını kaydeder. Bu komut PowerShell’de de çalışır. tokenlab zaten mevcutsa, --force ile üzerine yazmak yerine bu sağlayıcıyı kontrol panelinden düzenleyin. Ayrıca kontrol panelindeki Add provider listesinden TokenLab’i seçebilir ve anahtarı oraya girebilirsiniz. OpenCodex, yapılandırmasını $OPENCODEX_HOME/config.json, normalde ~/.opencodex/config.json altına kaydeder. Proxy henüz çalışmıyorsa başlatın, ardından kontrol panelini açın:
Sağlayıcı sayfasında Base URL’yi ve keşfedilen modelleri kontrol edin. Ön ayar GET /v1/models?category=chat uç noktasını keşfeder ve tool-use yeteneğine sahip modelleri tutar. Görseller, video, ses, embedding’ler ve karar modelleri hariç tutulur. Bir anahtarla yapılan keşif, o anahtarın model izinlerini ve teslimat politikasını yansıtır. Codex’i bağlamak ve model kataloğunu yenilemek için ocx sync çalıştırın, ardından yeni bir Codex oturumu başlatın. Bu işlem, Codex’in proxy bağlantısını ve kataloğunu değiştirir; senkronizasyondan önce mevcut özel sağlayıcı ayarlarını gözden geçirin ve bir yedek alın. Hesabınızı veya izin politikanızı değiştirmenizi gerektirmez.

​
Bir model seçme ve isteği doğrulama

Codex’in model seçicisinde tokenlab/<model-id> girişini seçin veya bunu tek bir CLI başlatması için belirleyin:
OpenCodex, sağlayıcıyı seçmek için tokenlab/ ifadesini kullanır; TokenLab’e gönderilen model kimliği gpt-6.1-sol olur. Modeller sayfasından şu anda mevcut olan tam bir kimlik seçin. Küçük bir bağlantı kontrolü için şunu gönderin:
Bu istek TokenLab bakiyenizi kullanır. İstekler bölümünden yanıtı ve eşleşen modelini, saatini ve durumunu kontrol edin. Sağlayıcı keşfi ve başarılı başlatma tek başına çıkarım erişimini doğrulamaz. Akış ve işlev çağırma, tablodaki rotalarda çalışır. Görsel girişi ve düşünme kontrolleri seçilen modele bağlıdır: yeteneklerini kontrol edin ve yalnızca OpenCodex’in o model için sunduğu efor seçeneklerini kullanın. Görsel girişi ve düşünme istekleri, Responses ve Messages rotaları için temsili modellerde kontrol edilmiştir; Gemini görsel girişi ise Chat rotasında kontrol edilmiştir. Düşünmeyi destekleyen bir modelin mutlaka düşünme metnini açığa çıkarması veya her efor düzeyini desteklemesi gerekmez.

​
Responses modelini Chat Completions’ta tutma

Listelenen Responses modellerinden biri için Chat yolunu kullanmak üzere, OpenCodex yapılandırmasındaki mevcut providers.tokenlab nesnesine bir modelAdapters girdisi birleştirin. Bu örnek, Codex için gpt-6-astra modelini Chat üzerinde tutar:
Bu, tam yapılandırmanın yerine geçmeyen bir sağlayıcı alanı örneğidir. Diğer model geçersiz kılmalarını, kimlik bilgilerini ve sağlayıcıları koruyun; ardından proxy’yi yeniden başlatıp yeni bir Codex oturumu açın. Yalnızca bu model girdisinin kaldırılması, Responses varsayılanını geri yükler. Claude’un Messages yönlendirmesi kanonik TokenLab uç noktasına bağlıdır. Yukarıdaki Chat geçersiz kılması Responses varsayılanları için geçerlidir; Claude’u Chat’e geçirmez. Yerel olarak Chat kullanan bir istemci için, listelenen Responses modelleri bu geçersiz kılma olmadan da zaten Chat kullanır. Bkz. OpenCodex sağlayıcı yönlendirmesi.

​
Teslimat politikası ve diğer TokenLab araçları

Ön ayar bir X-TokenLab-Delivery-Policy başlığını zorunlu kılmaz. TokenLab, API anahtarınızın varsayılan teslimat politikasını kullanır. Chat, Responses veya Messages seçimi, bir teslimat politikası seçmekten ayrıdır; bkz. TokenLab sağlayıcı ayarları. Diğer API araçları için TokenLab MCP sunucusunu veya entegrasyon talimatları için TokenLab Skills kılavuzunu ekleyin. Bunlar ana modelin sağlayıcısını veya API formatını değiştirmez. OpenCodex 2.73.0’daki JEV Auto, TypeSafe’in karar arka ucunu kullanır. Bu arka uç olarak TokenLab’i sunmaz. TokenLab’in System One APIsini MCP üzerinden çağırmak ayrı bir işlemdir; TypeSafe kimlik bilgisi alanına bir TokenLab anahtarı girmeyin.

​
Sorun giderme ve kurulumunuzu geri yükleme

  • Seçicide TokenLab eksik: ocx --version kontrolü yapın; bu kılavuz 2.73.0 sürümünü hedefler. Kataloğu ocx sync ile yenileyin ve yeni bir Codex oturumu başlatın.
  • 401 veya eksik kimlik bilgileri: Anahtarın etkin ve OpenCodex’i çalıştıran işlem tarafından erişilebilir olduğunu kontrol edin. Farklı bir terminaldeki ortam değişkeni, halihazırda çalışan bir hizmeti güncellemez.
  • Model eksik: Tam model kimliğini, anahtarınızın izinlerini ve geçerli kullanılabilirliğini kontrol edin. Sohbet dışı modeller ve tool-use yeteneği olmayan sohbet modelleri bu ön ayara dahil edilmemiştir.
  • Desteklenmeyen istek veya yanlış uç nokta: Seçilen modeli yönlendirme tablosuyla karşılaştırın ve kaydedilmiş bağdaştırıcı geçersiz kılmalarını inceleyin. Gerekli format model ayrıntıları içindeki tokenlab.accepted_request_formats alanıdır; model listesi bu ayrıntı alanının yerini tutmaz. Claude ve Gemini, yalnızca Codex yerel olarak Responses kullandığı için Responses’a gönderilmemelidir.
  • Araçlar veya görsel girişi başarısız oluyor: Orijinal hatayı ve Request ID’yi saklayın. Ayarları değiştirmeden önce modelin yeteneklerini ve etkin OpenCodex rotasını kontrol edin; bir hatayı gizlemek için konuşma geçmişini veya araç sonuçlarını silmeyin.
Codex’in proxy üzerinden yönlendirilmesini durdurmak için ocx stop kullanın; OpenCodex proxy’yi durdurur ve yerel Codex bağlantısını geri yükler. ocx restore, proxy’yi diğer istemciler için çalışır durumda tutarken yerel bağlantıyı geri yükler. Diğer istemciler tarafından paylaşılan bir kurulumu değiştirmeden önce OpenCodex CLI referansı belgesini inceleyin.