OpenCode sağlayıcısı veya modeli bulunamadı: tanılama rehberi

OpenCode'un sağlayıcı veya model bulunamadı hatası için önce seçilen modeli, OpenCode'un gerçekten yüklediği sağlayıcı ve model kimlikleriyle eşleştirin. Referans genellikle providerId/modelId biçimindedir. Doğru bir API anahtarı; yanlış yazılmış bir kimliği, tanımlanmamış özel bir modeli veya çalışan sürecin hiç okumadığı bir yapılandırma dosyasını düzeltemez.

Yalnızca “sağlayıcı sorunu” ifadesine değil, hataya göre ilerleyin

Resmî sorun giderme kılavuzu, model bulunamadı hatalarını model referanslarına yönlendirir. Sağlayıcı kaynağında arama hem sağlayıcı girişini hem de model eşlemesini kontrol eder. Aynı hata, bağdaştırıcının eksik model hatasını da kapsayabilir. Kimlik bilgilerini değiştirmeden veya daha fazla kredi satın almadan önce tam mesajı kaydedin.

1. Sürümü ve seçilen modeli belirleyin

Bu kontrolleri hatanın oluştuğu projeden çalıştırın. Masaüstü uygulaması farklı bir sunucu kullanıyorsa sürümünü ve yapılandırmasını bu terminal kurulumu ile karşılaştırın:

opencode --version
opencode models
opencode auth list

Listede tam model referansını bulun, ardından seçiminizle karakter karakter karşılaştırın. Sağlayıcı ön eki kimliğin parçasıdır. Özel bir ağ geçidi üzerinden sunulan model, adında Claude geçiyor diye yerleşik Anthropic sağlayıcısı haline gelmez.

Kaydedilmiş bir kimlik bilgisini başarılı uzak kimlik doğrulamasının kanıtı olarak yorumlamayın. Bu, yerel olarak bir kimlik bilgisinin var olduğunu gösterir; istek yapıldığında uç noktanın bunu yine kabul etmesi gerekir.

2. Sağlayıcı/model çiftini düzeltin

Bu örnek v1 sağlayıcı biçimini kullanır ve eşleşmesi gereken üç kimliği gösterir. Başvurulan ortam değişkenini OpenCode'u başlatan işlemde ayarlayın veya belgelenen kimlik bilgisi akışını kullanın. İlgili alanları yapılandırmanıza birleştirin; ilgisiz ayarların üzerine yazmayın:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "kunavo/claude-sonnet-5",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5"
        }
      }
    }
  }
}

Burada kunavo, sağlayıcı anahtarıdır ve claude-sonnet-5, model anahtarıdır. Dolayısıyla seçim kunavo/claude-sonnet-5 biçimindedir. anthropic/claude-sonnet-5 seçeneğini seçmek farklı bir sağlayıcı seçer; Kunavo/Claude Sonnet 5 seçeneğini seçmek arama anahtarlarının yerine görünen adları koyar. Bunların hiçbiri yukarıda gösterilen girişe başvurmaz.

/connect ve Other ile özel sağlayıcı kullanırken aynı sağlayıcı kimliğini girin. Kimlik bilgisi tek başına model kataloğunu tanımlamaz. Bağdaştırıcıyı da kontrol edin: burada gösterilen v1 uyumlu bağdaştırıcı Chat Completions kullanır; Responses uç noktası uygun bağdaştırıcıyı gerektirir.

3. v1 ve v2 yapılandırmalarını ayrı tutun

v2 sağlayıcı belgeleri, v1'deki provider, npm ve options alanları yerine providers, package ve settings alanlarını kullanır. Önceki bloğu değiştirmeden bir v2 yapılandırmasına kopyalamak yerine sürüme özel kurulumunu kullanın.

v2'de bir modelin eşleme anahtarı, upstream tarafındaki modelID değerinden de farklı olabilir. Eşleme coder anahtarını içeriyor ve upstream model değeri olarak upstream/coder-v2 gönderiyorsa, sağlayıcı company için company/coder seçimini yapın. Seçimi upstream adına değiştirmek yapılandırılmış takma adı devre dışı bırakır.

4. Hangi yapılandırmanın geçerli olduğunu kontrol edin

OpenCode yapılandırma kaynaklarını birleştirir. Bir proje dosyası genel modeli geçersiz kılabilir; özel yollar, satır içi yapılandırma ve yönetilen ayarlar da önem taşıyabilir. Başarısız projenin dosyasını, genel yapılandırmayı ve yapılandırılmış geçersiz kılmaları inceleyin. Sağlayıcı izin listelerini veya devre dışı sağlayıcı girişlerini kontrol edin.

Tek bir hedefli değişiklik yapın, etkilenen işlemi yeniden başlatın ve modelleri tekrar listeleyin. Model artık kullanılabilir durumdaysa ancak ilk isteği HTTP hatası döndürüyorsa bu yeni hatayı izleyin. Tanılama sırasında özgün dosyaları ve oturum verilerini koruyun; tüm veri dizinini silmek, yanlış model referansını düzeltmeden kimlik bilgilerini ve geçmişi kaldırabilir.

Küçük bir istekle tamamlayın

Seçim çözümlendikten sonra depo görevi öncesinde kısa bir istem deneyin. İstenen sağlayıcının bunu aldığını ve beklenen modeli kaydettiğini doğrulayın. Hâlâ başarısız oluyorsa sürümü, arındırılmış yapılandırmayı, tam hatayı ve ilgili günlük alıntısını toplayın. Paylaşmadan önce günlüklerde anahtarları ve proje içeriğini inceleyin.

Kunavo için OpenCode entegrasyon kılavuzuyla devam edin ve kullanım kaydınızı kontrol edin. Güncel Claude Sonnet 5 oranı, milyon token başına $1,40 girdi ve $7,00 çıktıdır. Fiyat karşılaştırması, istemci amaçlanan rotayı seçtikten sonra anlamlı hale gelir.

Sık sorulan sorular

Resmî belgeler ve sağlayıcı kaynağı 17 Eylül 2026'da kontrol edilmiştir. Örnek yapılandırma kimliğini açıklar; uçtan uca görev karşılaştırması değildir.