Codex CLI

Genel Bakış

Tür: Kodlama AracıBirincil Yol: OpenAI Responses (gelişmiş isteğe bağlı yol)Destek Güveni: Model/yol sınırlamalarıyla destekleniyor

OpenAI Codex, terminalde kod okuyabilen, değiştirebilen ve çalıştırabilen hafif bir kodlama ajanı olarak hizmet veren açık kaynaklı bir komut satırı aracıdır (CLI). GPT modelleri üzerine inşa edilmiştir ve kod üretimi için optimize edilmiştir. TokenLab için, Codex CLI /v1/responses kullanabilir, ancak bunu gelişmiş bir uyumluluk yolu olarak ele almalısınız. Sadece Responses özelliklerinin her model ve yönlendirilen yol boyunca garantili olmadığı durumlar vardır. Codex CLI uzaktan sıkıştırma POST /v1/responses/compact üzerinde desteklenir. Codex, /compact ve otomatik sıkıştırma için geçerli oturumun model değerini body.model içinde gönderir, bu nedenle sıkıştırmada kullanmak istediğiniz model Responses yolunda kullanılabilir olmalıdır. /v1/compact yapılandırmayın.

Sistem Gereksinimleri

OS: macOS, Linux (resmi destek), WSL üzerinden Windows
Node.js: Sürüm 18+
npm: Sürüm 10.x.x veya daha yüksek

Kurulum

npm install -g @openai/codex

Kurulumu doğrulayın:

codex --version

Yapılandırma

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

Geçici (mevcut oturum):

export OPENAI_API_KEY="sk-your-tokenlab-key"

Kalıcı yapılandırma: Şunlara ekleyin: ~/.bashrc, ~/.zshrc veya ~/.bash_profile:

export OPENAI_API_KEY="sk-your-tokenlab-key"

Sonra yeniden yükleyin:

source ~/.zshrc  # or source ~/.bashrc

Adım 2: config.toml’u Yapılandırma

Edit ~/.codex/config.toml:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

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

[features]
fast_mode = true

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 bu transport üzerinde background ile response.cancel kullanılamaz. OpenAI Realtime API değildir ve session.update, conversation.item.*, input_audio_buffer.*, ikili ses veya iç içe Realtime response.create.response zarflarını kabul etmez.

Eğer yapılandırma dosyası mevcut değilse, dosyayı oluşturmak için bir kez codex çalıştırın, ardından dosyayı düzenleyin. config.toml değiştirildikten sonra yeni sağlayıcı ayarlarının yeniden yüklenmesi için Codex’i tamamen yeniden başlatın.

Codex, özel sağlayıcılar için chat/completions desteğini kullanımdan kaldırıyor. TokenLab için wire_api = "responses" tutun, eğer kasıtlı olarak daha eski bir uyumluluk yolunu kullanmıyorsanız.

TokenLab bilinmeyen Responses alanlarını best-effort iletir ve isteği sessizce Chat Completions’a düşürmez. Alanın veya kombinasyonun desteklenip desteklenmediğine seçilen upstream karar verir.

Temel Kullanım

Etkileşimli modu başlatın:

codex

Doğrudan komut:

codex "Fix the bug in main.py line 42"

Model belirtin:

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

Önerilen Modeller

Model	En Uygun
`gpt-5.6-sol`	Kodlama ve muhakeme için en iyi varsayılan seçenek
`gpt-5-mini`	Kodlama iş akışları için daha hızlı, daha ucuz yedek
`claude-sonnet-4-6`	Kod incelemesi, dokümantasyon
`deepseek-r1`	Algoritma tasarımı, muhakeme

Etkileşimli Komutlar

Komut	Açıklama
`/help`	Yardımı görüntüle
`/exit` or `Ctrl+C`	Çıkış
`/clear`	Konuşmayı temizle
`/config`	Yapılandırmayı görüntüle
`/model <name>`	Modeli değiştir
`/tokens`	Token kullanımını görüntüle

Yapılandırmayı Doğrulayın

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Yaygın Kullanım Durumları

Kod incelemesi:

git diff | codex "Review these code changes"

Commit mesajı oluşturma:

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

Hataları düzeltme:

codex "Fix the TypeScript errors in src/components/"

Kodu açıklama:

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

Sorun Giderme

Bağlantı Hatası

config.toml içindeki base_url’un tam olarak https://api.tokenlab.sh/v1 olduğundan emin olun
Ağ bağlantısını kontrol edin
Proxy müdahalesi olmadığından emin olun

Kimlik Doğrulama Başarısız

~/.codex/config.toml içinde env_key = "OPENAI_API_KEY" satırının bulunduğunu doğrulayın
OPENAI_API_KEY ortam değişkeninin ayarlı olduğundan emin olun
Anahtarın sk- ile başladığını kontrol edin
Anahtarın TokenLab kontrol panelinde aktif olduğundan emin olun

Model Bulunamadı

Model adının tam olarak eşleştiğini kontrol edin
Model kullanılabilirliğini şu adreste doğrulayın: tokenlab.sh/en/models

Responses-yerel alan reddedildi

Bazı alanlar yalnızca TokenLab seçili model ve yol için bu davranışı garanti edebildiğinde /v1/responses üzerinde kullanılabilir
Eğer unsupported_request_field görürseniz, o alanı kaldırın veya buna bağlı olmayan bir iş akışına geçin

/compact veya otomatik sıkıştırma başarısız

Codex CLI /v1/compact değil, POST /v1/responses/compact çağırır
Sıkıştırma isteği geçerli oturumun model değerini kullanır, bu yüzden bu model Responses yolunda kullanılabilir olmalıdır
wire_api = "responses" ve base_url = "https://api.tokenlab.sh/v1" ayarlarını koruyun

Uyumluluk matrisi

Kodlama araçları

Native SDK'lar

Framework'ler ve platformlar

Sohbet uygulamaları

Genel Bakış

Sistem Gereksinimleri

Kurulum

Yapılandırma

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

Adım 2: config.toml’u Yapılandırma

Temel Kullanım

Önerilen Modeller

Etkileşimli Komutlar

Yapılandırmayı Doğrulayın

Yaygın Kullanım Durumları

Sorun Giderme

​Genel Bakış

​Sistem Gereksinimleri

​Kurulum

​Yapılandırma

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

​Adım 2: config.toml’u Yapılandırma

​Temel Kullanım

​Önerilen Modeller

​Etkileşimli Komutlar

​Yapılandırmayı Doğrulayın

​Yaygın Kullanım Durumları

​Sorun Giderme

Genel Bakış

Sistem Gereksinimleri

Kurulum

Yapılandırma

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

Adım 2: config.toml’u Yapılandırma

Temel Kullanım

Önerilen Modeller

Etkileşimli Komutlar

Yapılandırmayı Doğrulayın

Yaygın Kullanım Durumları

Sorun Giderme