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