Kodlama araçları

Codex CLI

OpenAI Codex CLI'yı TokenLab API'sini kullanacak şekilde yapılandırın

Bu kurulumu ajanımın yapmasını sağlayın

Bu görevi bilgisayarınızda zaten çalışmakta olan bir ajana kopyalayın:

Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/tr/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Genel Bakış

Codex CLI, /v1/responses üzerinden TokenLab'e bağlanabilir. Seçilen modelin tokenlab.accepted_request_formats içinde openai_responses listelemesi gerekir; özellikler modele göre değişiklik gösterebilir.

Uzak sıkıştırma (remote compaction) POST /v1/responses/compact kullanır. Codex mevcut oturum modelini body.model içinde gönderir, bu nedenle söz konusu modelin de Responses desteklemesi gerekir. /v1/compact yapılandırmasını yapmayın.

Sistem Gereksinimleri

macOS, Linux veya Windows için resmi CLI kurulum kılavuzunu kullanın. Yerel Windows ve WSL ayrı ortamlardır; Windows kılavuzunu takip edin. Aşağıdaki npm komutu bir kurulum seçeneğidir, yerel ikili dosyalar için bir zorunluluk değildir.

Kurulum

npm install -g @openai/codex@0.163.0

Kurulumu doğrulayın:

codex --version

Yapılandırma

Adım 1: API Anahtarını Ayarlayın

Anahtarı komut geçmişine eklemeden TOKENLAB_API_KEY değişkenini ayarlamak için macOS, Linux, WSL veya Windows PowerShell'e yönelik Hızlı Başlangıç terminal talimatlarını kullanın. Codex'i bu terminalden başlatın. Kalıcı kullanım için yerel sır yöneticinizi kullanın; kabuk profilinize düz metin olarak bir anahtar eklemeyin.

Adım 2: tokenlab.config.toml Dosyasını Yapılandırın

Codex 0.163.0 (2026-10-18 tarihinde test edildi) ile aktif CODEX_HOME dizininizde (normalde ~/.codex) ayrı bir tokenlab.config.toml kullanın. Bu dosyayı yalnızca adı kullanılmıyorsa oluşturun veya mevcut bir TokenLab profilini düzenlemeden önce yedekleyin. Aşağıdaki profil codex --profile tokenlab ile açıkça yüklenir; varsayılan config.toml, auth.json, hesapları ve izin ilkelerini değiştirmeden bırakır. Eski tip bir [profiles.tokenlab] tablosu kullanmayın. Normal kurulumunuza dönmek için profilsiz başlatın. Resmi profil yapılandırmasına bakın.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

Bu WebSocket modu, Codex istemcileri için bir Responses-over-WebSocket köprüsüdür. Yalnızca resmi response.create olaylarını kabul eder; stream örtüktür ve background ile response.cancel bu aktarımda kullanılamaz. OpenAI Realtime API değildir ve session.update, conversation.item.*, input_audio_buffer.*, ikili ses veya iç içe geçmiş Realtime response.create.response zarflarını kabul etmez.

Seçilen yapılandırma dosyası mevcut değilse oluşturun. Dosyayı düzenledikten sonra aşağıdaki eşleşen komutla yeni bir oturum başlatın.

Güncel Codex, wire_api = "responses" kullanır. chat/completions yapılandırmasını yapmayın. Bu özel sağlayıcı için requires_openai_auth değerini ayarlanmamış veya false olarak bırakın, böylece env_key kullanılır.

Responses istekleri Chat Completions isteklerine dönüştürülmez. İsteğe bağlı ve gelecekteki alanlar seçilen modele bağlıdır.

Temel Kullanım

Etkileşimli modu başlatın:

codex --profile tokenlab

Doğrudan komut:

codex --profile tokenlab "Fix the bug in main.py line 42"

Model belirtin:

codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"

Bir model seçin

Şu anda tokenlab.accepted_request_formats içinde openai_responses listeleyen bir model kullanın. Adayları kendi kodlama görevlerinizde karşılaştırın ve güncel fiyatları Modeller sayfasından kontrol edin.

Etkileşimli Komutlar

KomutAçıklama
/helpYardımı görüntüle
/exit veya Ctrl+CÇıkış yap
/clearKonuşmayı temizle
/statusAktif modeli, izinleri ve token kullanımını göster
/model <name>Modeli değiştir

Yapılandırmayı Doğrulayın

Ortam değişkeninin değerini yazdırmadan ayarlanıp ayarlanmadığını kontrol edin. Bu kontrol anahtarı doğrulamaz:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Codex'i başlatın ve aktif modeli ile izinleri kontrol etmek için /status komutunu çalıştırın. Bir profil kullanıyorsanız aynı profili başlatın. Resmi status komutuna bakın.

Gerçek bir istek yapmaya hazır olduğunuzda aşağıdaki komutu çalıştırın. Bu işlem TokenLab bakiyenizi kullanır. Yanıtı ve İstekler bölümündeki eşleşen kaydı kontrol edin; tek başına bir ortam kontrolü veya başarılı bir başlatma, bir isteğin başarılı olduğunu kanıtlamaz.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Yaygın Kullanım Alanları

Kod incelemesi:

git diff | codex --profile tokenlab "Review these code changes"

Commit mesajları oluşturma:

git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"

Hataları düzeltme:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Kodu açıklama:

cat main.py | codex --profile tokenlab "Explain what this code does"

Aynı ajanda görsel ve video oluşturun

Codex, TokenLab MCP sunucusu ile görseller ve kısa videolar da oluşturabilir. Her üretim aynı TokenLab bakiyesinden ücretlendirilir. Bunu TOKENLAB_API_KEY değişkeninin ayarlandığı terminalde çalıştırın:

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

Bu komut, sunucuyu temel config.toml dosyanıza ekler. Codex bu dosyayı tokenlab.config.toml profili altında da yükler; böylece araçlar --profile tokenlab ile veya bu olmadan çalışır. codex mcp list komutunu çalıştırın ve tokenlab sunucusunun listelendiğini doğrulayın. Ardından şunu 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 çağrısı yapar.

Sorun Giderme

Bu sayfada