Qwen Code nasıl kullanılır: kurulum, /auth, Japoncalaştırma ve API ayarları

Qwen Code, Alibaba'nın Qwen ekibi tarafından yayımlanan açık kaynaklı (Apache-2.0) bir yapay zekâ kodlama aracısıdır. Kullanım akışı “yükle → projede qwen çalıştır → bağlantı hedefini /auth ile yapılandır → görevi belirt” olmak üzere 4 adımdan oluşur. Ancak ücretsiz Qwen OAuth kotası 15 Nisan 2026'da sona erdiği için, daha eski açıklamalarda anlatıldığı gibi giriş yapsanız bile artık ücretsiz çalışmaz. Bu sayfada güncel /auth menüsüne göre başlama, Japonca gösterime geçiş, Claude veya GPT kullanmak için özel yapılandırma ve sık kullanılan komutlar sırayla açıklanır. En son sürüm 29 Eylül 2026'da npm'de yayımlanan v0.24.7'dir; sürümler haftada en az bir kez yayımlandığından elinizdeki sürümü qwen --version ile kontrol edin.

Yükleme

Resmî README'deki adımlar şunlardır. Bağımsız yükleyiciyi kullanırsanız Node.js'i kendiniz hazırlamanız gerekmez. Yalnızca npm kullanıyorsanız Node.js 22 veya üzeri gerekir.

# macOS / Linux（公式のスタンドアロン インストーラー）
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（Node.js 22 以上が必要）
npm install -g @qwen-code/qwen-code@latest

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

Yüklemeden sonra ortam değişkenlerinin uygulanması için terminali yeniden açın. Qwen Code başlangıçta Google Gemini CLI v0.8.2 temel alınarak geliştirilmişti; ancak v0.1'den itibaren üst projeyle eşzamanlamayı bırakıp bağımsız olarak geliştirilmektedir. Gemini CLI ayarları ve ücretsiz kotası doğrudan geçerli değildir.

İlk çalıştırma ve Japoncalaştırma

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

/language ui ja-JP ile arayüz Japonca olur ve sonraki ekranlarda “Kimlik doğrulama yöntemini seçin” ve “Araç onay modu” gibi Qwen Code'a özgü Japonca ifadeler görünür. Bu sayfa da aynı ifadeleri kullanır. Yanıt dili arayüz dilinden ayrıdır ve /language output Japanese ile belirtilir.

Terminalin yanı sıra masaüstü uygulaması, tarayıcıda açılan Web UI (qwen serve --open, deneysel özellik), VS Code, Zed ve JetBrains entegrasyonları ile betikler ve CI için başsız çalıştırma (qwen -p "...") da sunulur. Bunların hepsi aynı ücretsiz depoya dahildir; çıkarım ücretleri ayrıdır.

/auth ile bağlantı hedefini seçme

/auth (diğer adıyla /login) açıldığında “Kimlik doğrulama yöntemini seçin” ekranı görünür ve üst düzeyde üç seçenek vardır. Qwen OAuth'u seçmeye çalışırsanız “Sonlandırıldı — Coding Plan veya API Key'e geçin” mesajı görüntülenir.

ModelStudio'nun bu üç seçeneği aynı faturayı ödemenin farklı yolları değildir. Belgeler her birine ayrı bir uç nokta ve ayrı bir anahtar atar; anahtar türü ile baseUrl eşleşmiyorsa çalışmaz. 1 Ekim 2026 itibarıyla Coding Plan, “sınırlı miktar, ilk gelen alır; her gün 00:00'da (UTC+8) yenilenir” şeklinde gösterilmektedir; bu nedenle bazı günler başvuru yapılabilirken bazı günler yapılamaz. Coding Plan'deki tek bir istek dahili olarak birden çok model çağrısına dönüşür; Alibaba'ya göre basit görevlerde 5–10, karmaşık görevlerde 10–30 veya daha fazla çağrı tüketir. Ücretleri karşılaştırma yöntemi İngilizce Qwen Code pricing sayfasında ayrıntılı olarak ele alınır.

Claude veya GPT kullanma: settings.json içinde Custom Provider yapılandırma

Qwen Code'un kimlik doğrulama belgeleri, OpenAI, Anthropic, Google, OpenRouter ve kendi uç noktanız gibi üçüncü taraflara bağlanmak için ~/.qwen/settings.json içindeki modelProviders seçeneğini önerir. Kunavo için işlem şöyledir.

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

# キーは settings.json に直接書かず、.qwen/.env か環境変数に
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Dikkat edilmesi gereken dört nokta vardır.

• baseUrl yalnızca /v1 değerine kadar olmalıdır.Model sağlayıcısı referansı “/v1/chat/completions değil, API'nin /v1 rotasını belirtin; istek yolunu SDK ekler” diye açıkça belirtir. Yolu da yazarsanız kimlik doğrulama hatası yerine 404 alırsınız.
• Anahtarın konumu. Qwen Code, anahtarı ortamdan envKey ile belirtilen değişken adını kullanarak okur. Öncelik sırası kabuktaki export, .env (.qwen/.env önerilir; yalnızca bulunan ilk dosya kullanılır), ardından settings.json içindeki env şeklindedir; son seçenek anahtarı düz metin olarak sakladığı için önerilmez.
• Yapılandırma dosyası CLI bayrağından üstündür.Çözümleme sırası /auth ile girilen değer → seçili modelProviders → CLI bağımsız değişkenleri → ortam değişkenleri → settings.json şeklindedir. --openai-base-url yok sayılıyormuş gibi görünmesinin nedeni budur. Eski açıklamalardaki security.auth.apiKey ve security.auth.baseUrl kullanımdan kaldırılmıştır.
• Önce Chat Completions ile başlayın.wireApi atlanırsa Chat Completions biçimi kullanılır. "responses" belirtildiğinde uç nokta için otomatik algılama veya geri dönüş yoktur. modelProviders düzenlemeleri çalışan oturumlara da hemen yansır (/model yeniden açıldığında görünür).

Kunavo kataloğunda Qwen'in metin modelleri yoktur.Bu, Qwen'i ucuza kullanmanın değil, Qwen Code içinde Claude veya GPT'yi tek bir ön ödemeli bakiyeyle kullanmanın yoludur. Ayrıca Kunavo, Qwen Code'u kendi uç noktasında gerçekten çalıştırarak doğrulamamıştır. Yapılandırma, İngilizce Qwen Code ayarları sayfasındaki gibi resmî belgelerden oluşturulmuştur. Şu anda çalışan yolu koruyarak deneyin.

İlk görev ve sık kullanılan komutlar

README'deki örneğe uygun olarak, “Bu depoyu açıkla ve nereden okumaya başlamam gerektiğini söyle” gibi bir istekle başlamak; dosya okuma ve araç çağrılarının genel olarak çalışıp çalışmadığını kontrol etmenizi sağlar. Yalnızca selamlaşmak bağlantı sorunlarını ortaya çıkarmaz.

yolo gibi otomatik onay modları için belgeler, bunların yalnızca “güvenilir, korumalı veya geçici ortamlarda kullanılmasını” özellikle uyarır. /stats model için tahmini maliyet Qwen Code'un hesaplamasıdır; gerçek fatura tutarı değildir. Gerçek tutarı bağlantı hedefinin kullanım kayıtlarından kontrol edin.

Bilinmesi gereken sınırlamalar

• Yerleşik web_search bağlantı hedefi tarafından belirlenir.DashScope'un sunucu tarafı araması kullanıldığından ModelStudio Standard API Key ve Token Plan ile tanınan DashScope ana bilgisayarına işaret eden girdilerde etkin, Coding Plan'de devre dışıdır (uç noktada doğrulanmamıştır); üçüncü taraflarda veya diğer ana bilgisayarlara ait özel uç noktalarda da devre dışıdır (web_search belgeleri). Gerekirse bir MCP arama sunucusu ekleyin.
• Kunavo'nun yolu yalnızca sohbettir.Kunavo'da gömme, metinden sese ve sesten metne modelleri yoktur. Qwen Code Live Voice için DashScope uç noktası zorunlu olduğundan sohbet modelini nereye yönlendirirseniz yönlendirin ayrı anahtar aynı kalır.

Kunavo'yu denerken ödeme

Kunavo ön ödemeli yükleme modeliyle çalışır; aylık ücret yoktur ve token başına bakiye düşülür. Minimum yükleme $10 tutarındadır; Stripe Checkout'ta kartlar (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay ve Link kullanılabilir. Faturalandırma açıklamasını inceleyin, ardından hesap oluşturup anahtarınızı üretin. İlk isteğinizden sonra gerçek ücretlendirilen tutarı kullanım kayıtlarında kontrol etmek en güvenli yöntemdir.

Sık sorulan sorular

1 Ekim 2026'da doğrulandı: Qwen Code README'si; kimlik doğrulama, model sağlayıcısı, komut ve web_search belgeleri (main dalı); Japonca arayüz dizeleri (packages/cli/src/i18n/locales/ja.js); npm'deki @qwen-code/qwen-code 0.24.7; Alibaba Cloud Coding Plan ve Token Plan sayfaları. Kunavo, Qwen Code'u kendi uç noktasına bağlayarak çalıştırmamıştır.