Ana içeriğe atla

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. LemonData 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.

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-lemondata-key"
Kalıcı yapılandırma: Add to ~/.bashrc, ~/.zshrc, or ~/.bash_profile:
export OPENAI_API_KEY="sk-your-lemondata-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 = "lemondata"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
fast_mode = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
sandbox_mode = "danger-full-access"
approval_policy = "never"

disable_response_storage = false
personality = "friendly"
service_tier = "fast"

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

[features]
responses_websockets = true
responses_websockets_v2 = true
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. LemonData için wire_api = "responses" tutun, eğer kasıtlı olarak daha eski bir uyumluluk yolunu kullanmıyorsanız.
Eğer bir istek seçilen model veya rota üzerinde desteklenmeyen Responses-özel alanlar kullanıyorsa, LemonData isteği sessizce düşürmek yerine açık bir hata döner.

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.4 "Build a REST API server"

Önerilen Modeller

ModelEn Uygun
gpt-5.4Kodlama ve muhakeme için en iyi varsayılan seçenek
gpt-5-miniKodlama iş akışları için daha hızlı, daha ucuz yedek
claude-sonnet-4-6Kod incelemesi, dokümantasyon
deepseek-r1Algoritma tasarımı, muhakeme

Etkileşimli Komutlar

KomutAçıklama
/helpYardımı görüntüle
/exit or Ctrl+CÇıkış
/clearKonuşmayı temizle
/configYapılandırmayı görüntüle
/model <name>Modeli değiştir
/tokensToken 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

  • config.toml içindeki base_url’un tam olarak https://api.lemondata.cc/v1 olduğundan emin olun
  • Ağ bağlantısını kontrol edin
  • Proxy müdahalesi olmadığından emin olun
  • ~/.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 LemonData kontrol panelinde aktif olduğundan emin olun
  • Model adının tam olarak eşleştiğini kontrol edin
  • Model kullanılabilirliğini şu adreste doğrulayın: lemondata.cc/en/models
  • Bazı alanlar yalnızca LemonData 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