Menu

Codex CLI

AGENT INTEGRATION

Codex CLI ile Noxery

Responses API ve uzun session desteğiyle güvenilir bir agent bağlantısı kur.

Gereksinimler

Bir Noxery API anahtarı ve GET /v1/models yanıtında görünen aktif bir model gerekir. Anahtarı yalnızca agent'ın çalıştığı makinede, environment variable olarak sakla.

shell
export NOXERY_API_KEY="nox-YOUR_KEY"
export NOXERY_BASE_URL="https://api.noxery.net/v1"

Yapılandırma

Codex CLI'nin Responses destekleyen güncel sürümünde ~/.codex/config.toml dosyasını kullan:

config.toml
model = "gpt-6-astra"
model_provider = "noxery"

[model_providers.noxery]
name = "Noxery"
base_url = "https://api.noxery.net/v1"
env_key = "NOXERY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Windows kullanıyorsan tek tıkla kurulum: noxery-codex-setup.bat indir İndir, çift tıkla, anahtarını yapıştır — gerisini halleder.

Model seçimi

Model adını tahmin etme; katalogdan al. Agent yapılandırmasında paneldeki görünen adı değil, API'den dönen id alanını kullan.

curl
curl https://api.noxery.net/v1/models \
  -H "Authorization: Bearer $NOXERY_API_KEY"

Örnek model: gpt-6-astra. Model listesi ve limitler zamanla değişebilir.

Uzun sohbetler ve araç çağrıları

Her konuşma için sabit ve benzersiz bir session ID gönder. Bu, bağlantılı isteklerin upstream tarafında izlenmesini ve loglanmasını sağlar.

http
x-opencode-session: project-123-session-01
# Alternatif: x-codex-session veya x-conversation-id

Uzun geçmişi her turda sınırsız büyütme. Sistem context penceresine sığması için eski mesajları sıkıştırabilir; araç çağrısı ile araç sonucunu birlikte gönder. Streaming kullanırken SSE bağlantısını kesmeden parçaları sırayla birleştir.

Tool calling kullanan agent'larda tools, tool_choice ve gerekli tool sonuçlarını aynı istekte tut. Eksik bir tool çifti 400 hatasına veya tekrarlanan agent turuna yol açabilir.

Sorun giderme

401 alıyorum
Header'ın tam olarak Authorization: Bearer nox-... olduğundan ve environment variable'ın agent sürecinde tanımlı olduğundan emin ol.
404 model hatası alıyorum
GET /v1/models ile güncel ID'yi al. Modelin paneldeki adı ile API ID'si aynı olmak zorunda değildir.
429 alıyorum
Free plan için limit 15 RPM ve 30M token/aydır. 429 yanıtında kısa, jitter'lı backoff uygula; kota dolduysa tekrar denemek sorunu çözmez.
Agent uzun sohbetlerde kopuyor
Client timeout'unu artır, SSE buffering'i kapat, session header'ını sabit tut ve geçmişi düzenli aralıklarla özetle. Tek isteği sonsuza kadar büyütmek yerine yeni bir session aç.