Qwen Code kurulumu: Yükleme, sağlayıcı, Almanca arayüz ve API

Qwen Code, Alibaba'nın Qwen ekibinin açık kaynaklı (Apache-2.0) yapay zekâ kodlama aracısıdır. Kurulum dört adımda yapılır: yükleyin, projede qwen ile başlatın, /auth ile sağlayıcıyı seçin ve bir görev verin. Önceden bilinmesi gereken önemli nokta: ücretsiz Qwen OAuth kotası 15 Nisan 2026'da sona erdi — eski bir kılavuzu izleyenler artık bununla ücretsiz devam edemez. Bu sayfa güncel /auth menüsünü izler; Almancaya geçişi, Claude veya GPT için özel bir uç noktanın kurulmasını ve en önemli komutları gösterir. En yeni sürüm v0.24.7'dir; 29 Eylül 2026'da npm'de yayımlandı. Sürümler en az haftalık olarak çıkar; sürümünüzü qwen --version ile kontrol edin.

Kurulum

Komutlar resmî README'den alınmıştır. Bağımsız yükleyiciyle Node.js'i kendiniz sağlamanız gerekmez; yalnızca npm için Node.js 22 veya daha yeni bir sürüm zorunludur.

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Ortam değişkenlerinin etkili olması için bundan sonra terminali yeniden açın. Qwen Code başlangıçta Google Gemini CLI v0.8.2'yi temel alıyordu, ancak v0.1'den beri bağımsız olarak geliştiriliyor ve artık orijinaliyle senkronize edilmiyor. Gemini CLI ayarları ve kotaları burada geçerli değildir.

İlk başlatma ve Almanca arayüz

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

/language ui de-DE sonrasında Qwen Code kendi Almanca ifadelerini gösterir; örneğin „Authentifizierungsmethode auswählen“ veya „Werkzeug-Genehmigungsmodus“. Bu sayfa aynı ifadeleri kullanır. Yanıt dili bundan ayrıdır ve /language output German ile ayarlanır.

Terminalin yanı sıra bir masaüstü uygulaması, tarayıcıda bir web arayüzü (qwen serve --open, deneysel), VS Code, Zed ve JetBrains entegrasyonları ile betikler ve CI için başsız mod (qwen -p "...") vardır. Tümü aynı ücretsiz depodadır; çıkarım ücretini ayrıca ödersiniz.

/auth ile sağlayıcıyı seçme

/auth (diğer adıyla /login) üç üst düzey seçenek içeren „Authentifizierungsmethode auswählen“ ekranını açar. Qwen OAuth'u hâlâ seçmek isteyenler şu mesajı görür: „Eingestellt — wechseln Sie zu Coding Plan oder API Key“.

Üç ModelStudio yolu aynı faturanın üç ödeme yöntemi değildir: Belgeler her biri için ayrı bir uç nokta ve ayrı bir anahtar tanımlar; anahtar türü ile baseUrl birbiriyle eşleşmelidir. Coding Plan, 1 Ekim 2026 itibarıyla „begrenzt verfügbar, wer zuerst kommt, täglich um 0 Uhr (UTC+8) aufgefüllt“ olarak belirtiliyordu — dolayısıyla bazı günler satın alınamayabilir. Bir görev Coding Plan'de birden fazla model çağrısı tüketir; Alibaba basit görevler için genellikle 5–10, karmaşık görevler için 10–30 veya daha fazla çağrı belirtir. Maliyet karşılaştırması İngilizce Qwen Code pricing sayfasında ayrıntılı olarak ele alınır.

Claude veya GPT kullanma: settings.json içinde Custom Provider

Kimlik doğrulama belgeleri, OpenAI, Anthropic, Google, OpenRouter gibi üçüncü taraf sağlayıcılar veya kendi uç noktanız için modelProviders bloğunun ~/.qwen/settings.json içinde kullanılmasını önerir. Kunavo için görünümü şöyledir:

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

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Sorun gidermede zaman kazandıran dört nokta:

• baseUrl /v1 ile biter. Model Providers referansı açıkça API'nin /v1 köküne ayarlanmasını, /v1/chat/completions üzerine ayarlanmamasını söyler — yolu SDK kendisi ekler. Yol eklenirse kimlik doğrulama hatası değil, 404 alınır.
• Anahtarın bulunduğu yer. Qwen Code anahtarı envKey tarafından belirtilen ortam değişkeninden okur. Sıra şöyledir: kabuk-export, ardından bir .env dosyası (önerilen .qwen/.env; bulunan ilk dosya kullanılır), son olarak settings.json içindeki env — anahtar burada düz metin olarak bulunur.
• Dosya, CLI seçeneğine üstün gelir. Sıra: /auth değerleri → seçilen modelProviders girdisi → CLI bağımsız değişkenleri → ortam değişkenleri → settings.json. Bu nedenle --openai-base-url bazen etkisiz görünür. Eski kılavuzlardaki security.auth.apiKey ve security.auth.baseUrl kullanım dışıdır.
• Chat Completions ile başlayın. wireApi olmadan Chat Completions geçerlidir. "responses" ile uç nokta algılama veya otomatik geri dönüş olmaz. modelProviders üzerindeki değişiklikler çalışan bir oturumda da geçerli olur (/model yeniden açın).

Kunavo kataloğunda Qwen metin modeli yoktur. Bu nedenle Qwen'e daha ucuz bir erişim değil, Claude veya GPT'yi Qwen Code içinde ön ödemeli krediyle kullanmanın bir yoludur. Kunavo, Qwen Code'u kendi uç noktasına karşı kendisi de çalıştırmadı; İngilizce Qwen Code kurulum sayfasındaki gibi bu yapılandırma da resmî belgelerden alınmıştır. Deneme yaparken çalışan bir yönlendirme yolunu koruyun.

İlk görev ve önemli komutlar

README, ilk görev olarak özünde şunu önerir: „Bu depoyu açıkla ve nereden başlamam gerektiğini göster.“ Bu, dosya erişimini ve araç çağrılarını tek seferde sınar — yalnızca „Merhaba“ demek bağlantı sorunlarını ortaya çıkarmaz.

yolo ve diğer otomatik modlar için belgeler bizzat şu uyarıyı yapar: yalnızca güvenilir, yalıtılmış veya atılabilir ortamlarda kullanın. /stats model içindeki tahmini maliyetleri Qwen Code kendisi hesaplar; gerçek tutar sağlayıcınızın kullanım günlüğünde yer alır.

Bilmeniz gereken sınırlar

• Yerleşik web araması ana makineye bağlıdır. DashScope'un sunucu tarafı aramasını kullanır: ModelStudio Standard API Key ve Token Plan için ve algılanan bir DashScope ana makinesindeki girdiler için açıktır; Coding Plan için (orada doğrulanmamıştır) ve başka ana makinelerdeki üçüncü taraf sağlayıcılar ile özel uç noktalar için kapalıdır (web_search belgeleri). Alternatif: bir MCP arama sunucusu.
• Kunavo üzerinden yalnızca sohbet çalışır. Kunavo embedding, konuşma sentezi veya konuşma tanıma modelleri sunmaz. Qwen Code'un Live Voice özelliği zaten bir DashScope uç noktası gerektirir ve sohbet modeli nereye yönlendirilirse yönlendirilsin kendi anahtarını kullanmaya devam eder.

Kunavo'yu denemek için ödeme

Kunavo, abonelik olmadan ön ödemeli bakiyeyle çalışır ve token başına ücretlendirir. Minimum yükleme tutarı $10’dır; Stripe ödeme sayfasında kartlar (Visa, Mastercard, American Express), Apple Pay, Google Pay ve Link kullanılabilir; Avusturya’da ayrıca EPS de vardır — SEPA otomatik ödeme şu anda sunulmamaktadır. Stripe, Pay by Bank’i yalnızca Birleşik Krallık, İrlanda ve Finlandiya’daki alıcılara sunar; Almanya’da şimdiye kadar yalnızca kapalı önizleme olarak kullanılabilir (Stripe dokümantasyonu, 3 Ekim 2026 itibarıyla). Ayrıntılar Faturalandırma bölümünde; hesap ile anahtarı oluşturabilirsiniz. İlk görevden sonra kullanım günlüğü gerçek tutarı gösterir.

Sık sorulan sorular

1 Ekim 2026'da doğrulandı: Qwen Code README'si; kimlik doğrulama, Model Providers, komutlar ve web_search belgeleri (main dalı); Almanca UI metinleri (packages/cli/src/i18n/locales/de.js); npm'deki @qwen-code/qwen-code 0.24.7; ayrıca Alibaba Cloud'un Coding Plan ve Token Plan sayfaları. Kunavo, Qwen Code'u kendi uç noktasına karşı çalıştırmadı.