Qwen Code

Qwen Code uç noktalarını ~/.qwen/settings.json içindeki modelProviders'tan okur — baseUrl ve envKey içeren tek bir girdi, Claude ve GPT'yi /model seçicisine koyar.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. ~/.qwen/settings.json dosyasını açın (yoksa oluşturun) ve yukarıdaki dört bloğu dosyaya birleştirerek ekleyin. Belgeler, “proje ve kullanıcı ayarları arasındaki birleştirme çakışmalarını önlemek için” modelProviders alanını kullanıcı kapsamındaki dosyada tanımlamanızı önerir.
3. Mümkünse anahtarı env bloğundan daha güvenli bir yere koyun. Qwen Code anahtarı process.env[envKey] ifadesinden okur ve belgeler kaynakları en öncelikliden en az öncelikliye şöyle sıralar: kabukta tanımlı export, ardından bir .env dosyası, sonra env bloğu (konumu: settings.json) — bunun düz metin depolama olduğu özellikle belirtilir. Yukarıdaki env bloğu çalışan en küçük yapılandırmadır; saklamak için en iyi seçenek değildir.
4. qwen'i çalıştırın. security.auth.selectedType değeri openai olarak ayarlanmış ve model.name, tanımladığınız bir id ile eşleşiyorsa etkileşimli bir /auth adımı gerekmez — belgeler tek dosyalı örneğin ardından bunu açıkça söyler.
5. Bir selamlama değil, dosyayı okuyup düzenleyen bir görev verin. Qwen Code bir ajandır: araç çağrısı ve akış, ilk çalıştırmada denenmesi gereken işlevlerdir ve yalnızca kısmen uyumlu bir uç noktada ilk bozulacak şeyler de bunlardır.
6. modelProviders.openai altına daha fazla girdi ekleyerek /model ile çalışma zamanında model değiştirin. Bu düzenlemeler çalışan bir oturumda anında yüklenir; providerProtocol başlangıçta bir kez okunur ve değişiklik için yeniden başlatma gerekir.

Qwen Code kimlik doğrulama sayfası, Seçenek 4: API Anahtarı (esnek) ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Qwen Code içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Belgelerin, insanların yanlış tahmin ettiği üç konuda net yanıtı var

Bunlar yukarıda bağlantısı verilen kimlik doğrulama sayfasından ve model sağlayıcıları başvuru kaynağından alınmıştır. Okumak yerine varsayımlara dayanmak, her birinde ciddi hata ayıklama süresine mal olur.

1. Bir modelProviders girdisi CLI bayraklarından daha yüksek önceliğe sahiptir. Belgelenen sıra, en yüksek öncelikten başlayarak şöyledir: çalışan oturumda /auth aracılığıyla yapılan geçersiz kılmalar, ardından seçili model sağlayıcısının envKey'si, sonra --openai-api-key gibi CLI bağımsız değişkenleri, ortam değişkenleri ve ayarlardaki security.auth.apiKey. Çoğu kişi bayrağın öncelikli olmasını bekler. Öyle değildir; bu nedenle --openai-base-url yok sayılıyor gibi görünebilir.
2. security.auth.apiKey ve security.auth.baseUrl kullanımdan kaldırılmıştır. Başvuru belgesi bunu belirtir ve modelProviders yapısına geçişi önerir. Eski bir eğitim bu iki anahtarı düzenlemenizi söylüyorsa, artık kullanımdan çıkmakta olan yolu düzenletiyordur.
3. wireApi istek biçimini belirler; uyumsuzluk otomatik olarak algılanmaz. Bu ayarı belirtmezseniz Chat Completions kullanılır; yukarıdaki blokta da bu biçim kullanılmıştır. "wireApi": "responses" ayarı, gerçekten Responses ile uyumlu bir uç nokta gerektirir. Belgeler, istek başarısız olduğunda uç nokta algılama veya otomatik geri dönüş olmadığını açıkça belirtir. Kunavo hem /v1/responses hem de /v1/chat/completions uç noktasına gelen istekleri yanıtlar; ancak bu sayfada ikili eşleşmelerin hiçbiri test edilmemiştir. Bu nedenle varsayılan ayarla başlayın.

Ücretsiz katmanı arıyorsanız

Qwen Code hakkında hâlâ yazılanların çoğu, günlük ücretsiz kullanım kotası sunan bir Qwen OAuth girişinden söz ediyor. Bu seçenek artık yok: belgelerde ücretsiz katmanın 15 Nisan 2026'da sona erdiği ve Qwen OAuth'un artık /auth iletişim kutusunda seçilebilir bir seçenek olmadığı belirtiliyor. Belgelerde artık üç seçenek listeleniyor: Alibaba ModelStudio — alt menüsünde Coding Plan, Token Plan ve Standard API Key seçenekleriyle —, Third-party Providers ve “yerel bir sunucuya, proxy'ye veya desteklenmeyen bir sağlayıcıya” bağlandığı belirtilen Custom Provider. Kunavo bu üçüncü seçenektir. ModelStudio alt menüsündeki seçeneklerin tek bir faturayı ödeme yolları olmadığını da unutmayın: her birinin kendi anahtarı ve barındırıcısı vardır; Token Plan barındırıcısında Coding Plan anahtarı çalışmaz.