Kodlama araçları

OpenCodex

Codex'i, modele özel API yönlendirmesi ile OpenCodex üzerinden TokenLab'e bağlayın

Bırakın ajanım bunu ayarlasın

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

Read https://tokenlab.sh/docs/tr/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

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ınlanmış ve uçtan uca doğrulanmıştır. 2.73.0 sürümü, bu entegrasyonu korur ve modele özel Responses ve Anthropic Messages yönlendirmesi ekler. Aşağıda listelenen rotalar, akışlı metin ve fonksiyon çağrısı/sonuç gidiş-dönüşleri ile TokenLab üzerinde kontrol edilmiştir.

Codex, Responses isteklerini yerel OpenCodex proxy'sine gönderir. OpenCodex daha sonra 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.

Codex'te seçilen modellerOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

Ön ayarın Base URL'si https://api.tokenlab.sh/v1 şeklindedir. Bunu değiştirmeyin: 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 adaptörünü kullanır.

TokenLab, bunu beyan eden modeller için Gemini'nin yerel API'sini destekler, ancak OpenCodex 2.73.0 TokenLab ön ayarı, Gemini'yi Chat Completions üzerinden çağırır. Sağlayıcının tamamını Responses veya Gemini olarak değiştirmeyin; bu, bu formatı kabul etmeyen modeller için yapılan istekleri de değiştirecektir.

Kurulum veya güncelleme

npm kurulumu için Node.js 18 veya üzerini kullanın:

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

Codex'in de kurulu olması gerekir. OpenCodex, kurulum ve Codex bağlantı talimatları sağlar. Yerel Windows ve WSL'in ayrı yapılandırmaları vardır; kurulumu ve Codex'i aynı ortamda çalıştırın.

TokenLab ekleme

TokenLab API Keys kısmında bir anahtar oluşturun. Terminal kurulumu için, TOKENLAB_API_KEY değerini komut geçmişine eklemeden ayarlamak üzere Hızlı Başlangıç adımlarını izleyin. OpenCodex'i bu terminalden başlatın; bir arka plan servisinin değişkeni kendi başlatma ortamında görmesi gerekir.

Yeni bir OpenCodex kurulumu için ocx init komutunu çalıştırın, TokenLab'i seçin ve anahtarı yerel olarak girin veya ${TOKENLAB_API_KEY} şeklindeki değişmez ortam referansını kullanın. Sihirbazın Codex bağlantısı ve otomatik başlatma seçeneklerini uygulamadan önce gözden geçirin.

Mevcut bir kurulum için, diğer sağlayıcıları değiştirmeden ön ayarı ekleyin:

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

Tek tırnak işaretleri, anahtarın değerini değil, ortam değişkeni referansını kaydeder. Bu komut PowerShell'de de çalışır. Eğer tokenlab zaten mevcutsa, --force ile üzerine yazmak yerine sağlayıcıyı panelden düzenleyin.

Ayrıca paneldeki Add provider listesinden TokenLab'i seçebilir ve anahtarı oraya girebilirsiniz. OpenCodex yapılandırmasını $OPENCODEX_HOME/config.json altında, genellikle ~/.opencodex/config.json konumunda saklar.

Proxy halihazırda çalışmıyorsa başlatın ve ardından panelini açın:

ocx start
ocx status
ocx gui

Sağlayıcı sayfasında Base URL'yi ve keşfedilen modelleri kontrol edin. Ön ayar GET /v1/models?category=chat komutuyla keşif yapar ve tool-use yeteneğine sahip modelleri tutar. Görseller, video, ses, yerleştirmeler (embeddings) 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 komutunu çalıştırın, ardından yeni bir Codex oturumu başlatın. Bu, Codex'in proxy bağlantısını ve kataloğunu değiştirir; mevcut özel sağlayıcı ayarlarını gözden geçirin ve eşitlemeden önce yedek alın. Hesabınızı veya izin politikanızı değiştirmenizi gerektirmez.

Bir model seçin ve isteği doğrulayın

Codex'in model seçicisinden tokenlab/<model-id> girişini seçin veya tek bir CLI başlatması için bunu belirleyin:

codex -m "tokenlab/gpt-6.1-sol"

OpenCodex, sağlayıcıyı seçmek için tokenlab/ ön ekini kullanır; TokenLab'e gönderilen model kimliği gpt-6.1-sol olur. Models sayfasından şu anda mevcut olan tam bir kimlik seçin.

Küçük bir bağlantı kontrolü için şunu gönderin:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Bu istek TokenLab bakiyenizi kullanır. Yanıtı ve eşleşen modelini, zamanını ve durumunu Requests kısmından kontrol edin. Sağlayıcı keşfi ve başarılı başlatma tek başına çıkarım (inference) erişimini doğrulamaz.

Akış (streaming) ve fonksiyon çağırma, tablodaki rotalarda çalışır. Görsel girişi ve düşünme kontrolleri seçilen modele bağlıdır: modelin yeteneklerini kontrol edin ve sadece OpenCodex'in o model için sunduğu çaba (effort) 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 model, düşünme metnini mutlaka dışa aktarmaz veya her çaba seviyesini desteklemez.

Bir Responses modelini Chat Completions üzerinde tutma

Listelenen Responses modellerinden biri için Chat yolunu kullanmak isterseniz, OpenCodex yapılandırmasındaki mevcut providers.tokenlab nesnesine bir modelAdapters girişi ekleyin. Bu örnek, gpt-6-astra modelini Codex için Chat üzerinde tutar:

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

Bu, tam yapılandırmanın yerine geçmeyen bir sağlayıcı alanı örneğidir. Diğer model geçersiz kılmalarını (overrides), kimlik bilgilerini ve sağlayıcıları koruyun, ardından proxy'yi yeniden başlatın ve yeni bir Codex oturumu açın. Sadece bu model girişini kaldırmak, Responses varsayılanını geri yükler.

Claude'un Messages yönlendirmesi, standart TokenLab uç noktasına bağlıdır. Yukarıdaki Chat geçersiz kılma işlemi, Responses varsayılanları için geçerlidir; Claude'u Chat'e geçirmez. Chat-native bir istemci için, listelenen Responses modelleri bu geçersiz kılma olmadan zaten Chat kullanır. Bkz: OpenCodex provider routing.

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

Ön ayar, X-TokenLab-Delivery-Policy başlığını zorunlu kılmaz. TokenLab, API anahtarınızın teslimat politikası varsayılanını kullanır. Chat, Responses veya Messages seçimi, teslimat politikası seçiminden ayrıdır; bkz: TokenLab provider settings.

TokenLab Skills entegrasyon talimatları ekler. Ana modelin sağlayıcısını veya API formatını değiştirmezler.

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 API kısmını MCP üzerinden çağırmak ayrı bir işlemdir; TypeSafe kimlik bilgisi alanına TokenLab anahtarı girmeyin.

Aynı ajanda görsel ve video oluşturma

Codex ayrıca TokenLab MCP server ile görseller ve kısa videolar oluşturabilir. Her üretim aynı TokenLab bakiyesinden ödenir. OpenCodex sadece model isteklerini yönlendirir ve Codex'in kendisi MCP sunucularını başlatır. Sunucuyu, TOKENLAB_API_KEY değişkeninin ayarlı olduğu terminalde Codex'e ekleyin:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

MCP, ana modelin sağlayıcısını veya API formatını değiştirmez. codex mcp list komutunu çalıştırın ve tokenlab'in listelendiğinden emin olun. Ardından yeni bir Codex oturumunda deneyin:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video bir görev kimliği döndürür. Ajan, video hazır olana kadar get_task_status komutunu çağırır.

Sorun giderme ve kurulumu geri yükleme

  • TokenLab seçicide görünmüyor: ocx --version komutunu kontrol edin; 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 aktif olduğunu 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 servisi güncellemez.
  • Model eksik: tam kimliği, anahtarınızın izinlerini ve mevcut durumu kontrol edin. Chat olmayan modeller ve tool-use özelliği olmayan chat modelleri bu ön ayara dahil değildir.
  • Desteklenmeyen istek veya yanlış uç nokta: seçilen modeli yönlendirme tablosuyla karşılaştırın ve kaydedilmiş adaptör geçersiz kılmalarını inceleyin. Gerekli format model detayları kısmındaki tokenlab.accepted_request_formats alanıdır; model listesi bu detay alanının yerini tutmaz. Claude ve Gemini, sadece Codex yerelde Responses kullandığı için Responses'a gönderilmemelidir.
  • Araçlar veya görsel girişi başarısız: orijinal hatayı ve İstek Kimliğini (Request ID) saklayın. Ayarları değiştirmeden önce modelin yeteneklerini ve aktif 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 komutu, 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 reference kısmını inceleyin.

Bu sayfada