> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt > Use this file to discover all available pages before exploring further. # OpenCodex > Modele özgü API yönlendirmesiyle OpenCodex üzerinden Codex'i TokenLab'e bağlayın ## Bunu ajanım kursun Bu görevi bilgisayarınızda halihazırda çalışan bir ajana kopyalayın: ```text theme={null} Read https://docs.tokenlab.sh/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](https://github.com/lidge-jun/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](https://github.com/lidge-jun/opencodex/releases/tag/v2.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. | Codex'te seçilen modeller | OpenCodex → 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.3` | Responses: `POST /v1/responses` | | `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-fable-5`, `claude-fable-5-1` | Anthropic Messages: `POST /v1/messages` | | `gemini-3.8-flash` | Chat Completions: `POST /v1/chat/completions` | Ö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: ```bash theme={null} npm install -g @bitkyc08/opencodex@2.73.0 ocx --version codex --version ``` Codex'in de yüklü olması gerekir. OpenCodex [kurulum](https://opencodex.me/getting-started/installation/) ve [Codex bağlantı talimatları](https://opencodex.me/getting-started/quickstart/) 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ı](https://tokenlab.sh/dashboard/api?tab=keys) 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ıç](/tr/quickstart) 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: ```bash theme={null} ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}' ``` 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: ```bash theme={null} 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` 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/` girişini seçin veya bunu tek bir CLI başlatması için belirleyin: ```bash theme={null} codex -m "tokenlab/gpt-6.1-sol" ``` 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](https://tokenlab.sh/tr/models) sayfasından şu anda mevcut olan tam bir kimlik seçin. Küçük bir bağlantı kontrolü için şunu gönderin: ```text theme={null} Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files. ``` Bu istek TokenLab bakiyenizi kullanır. [İstekler](https://tokenlab.sh/dashboard/runs?section=requests) 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: ```json theme={null} { "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ı, 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](https://opencodex.me/guides/providers/#3-api-key-catalog). ## 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ı](/tr/guides/tokenlab-provider). Diğer API araçları için [TokenLab MCP sunucusu](/tr/integrations/tokenlab-mcp-server)nu veya entegrasyon talimatları için [TokenLab Skills](/tr/integrations/coding-agent-skill) 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 API](/tr/api-reference/systemone/create-decision)sini 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ı](/tr/api-reference/models/get-model) 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ı](https://opencodex.me/reference/cli/) belgesini inceleyin.