OpenCode

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.

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

Yapılandırma

Proje köküne opencode.json veya kullanıcı dizinine ~/.config/opencode/opencode.json ekle:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "noxery": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Noxery",
      "options": {
        "baseURL": "https://api.noxery.net/v1",
        "apiKey": "nox-YOUR_KEY"
      },
      "models": {
        "deepseek-v4-pro-202606": {"name": "deepseek-v4-pro-202606"}
      }
    }
  }
}

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

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