Claude Code

AGENT INTEGRATION

Claude Code ile Noxery

OpenAI ve Anthropic protokollerinin farklarını bilerek 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ın yoksa Hızlı başlangıç adımlarını izle; anahtarı API Anahtarları sayfasından üret. 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

ÖnemliClaude Code Anthropic Messages API bekler. Noxery'nin endpoint'i OpenAI-compatible olduğu için bu iki environment variable tek başına doğrudan çalışmaz.

Claude Code kullanacaksan araya Anthropic Messages ile OpenAI Chat/Responses arasında dönüşüm yapan, kendi yönettiğin bir adapter koy. Adapter upstream olarak https://api.noxery.net/v1 adresini ve Bearer token authentication'ı kullanmalı. Adapter olmadan OpenCode veya Codex entegrasyonunu tercih et.

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: deepseek-v4-pro-202606. 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

Güncel limitleri paneldeki plan tablosundan kontrol et. 429 yanıtındaki retry_after süresi dolmadan tekrar deneme; kota dolduysa pencere bitmeden tekrar denemek sorunu çözmez.

"Codex ran out of room in the model's context window" hatası

Codex, modelin bağlam penceresini tanımadığında erken durabilir; thread uzadıkça bu mesajı verir. ~/.codex/config.toml dosyanıza modelin gerçek penceresini ekleyin: model_context_window = 1050000 ve model_auto_compact_token_limit = 900000 (gpt-6-astra, gpt-6-sol, gpt-5.6-sol, gpt-5.5 gibi 1.05M modeller için). 400k modellerde (örn. gpt-5.3-codex) model_context_window = 400000 / model_auto_compact_token_limit = 340000 kullanın. Ayrıca çok uzayan thread'lerde yeni bir thread başlatın; büyük dosya/komut çıktılarını kısa tutun.

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