Qwen Code nasıl kullanılır: kurulum, hesap ve model seçimi, API ayarları

Qwen Code, Alibaba Qwen ekibi tarafından yayımlanan açık kaynaklı (Apache-2.0) bir AI kodlama aracısıdır. Kullanımı dört adımdan oluşur: “kurulum → projede qwen çalıştırma → bağlantı hedefini /auth ile yapılandırma → görev isteme”. Ancak ücretsiz Qwen OAuth katmanı 15 Nisan 2026'da sona erdiğinden, bundan önceki talimatlara göre giriş yaparsanız artık ücretsiz çalışmaz. Korece kullanıcıların önceden bilmesi gereken nokta da şudur: Qwen Code'da Korece UI yoktur. Bu sayfa sırasıyla güncel /auth menüsüne göre başlangıç yöntemini, Korece yanıt ayarını, Claude ve GPT kullanımı için özel yapılandırmayı ve sık kullanılan komutları açıklar. En yeni sürüm 29 Eylül 2026'da npm'de yayımlanan v0.24.7'dir ve sürümler en az haftada bir yayımlandığından, kurulu sürümü qwen --version ile kontrol edin.

Kurulum

Resmî README'de yer alan komutlardır. Bağımsız kurulum komut dosyasını kullanırsanız Node.js'i doğrudan hazırlamanız gerekmez; Node.js 22 veya üzeri yalnızca npm ile kurulumda 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

Ortam değişkenlerinin uygulanması için kurulumdan sonra terminali yeniden açın. Qwen Code başlangıçta Google Gemini CLI v0.8.2 temel alınarak oluşturulmuş olsa da v0.1'den beri kaynak projeyle senkronize edilmeden bağımsız olarak geliştirilmektedir. Gemini CLI ayarları veya ücretsiz kotaları olduğu gibi geçerli değildir.

İlk çalıştırma ve Korece yanıt

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Yerleşik UI dilleri yalnızca basitleştirilmiş Çince, İngilizce, Rusça, Almanca, Japonca, Brezilya Portekizcesi, Fransızca ve Katalancadır; deponun UI çeviri dosyalarında Korece yoktur (1 Ekim 2026'da kontrol edildi). Bu nedenle menüler İngilizce görünür ve bu sayfa ekranda görünen İngilizce ifadeleri olduğu gibi alıntılar. Model yanıtlarının dili UI'dan bağımsızdır ve /language output Korean ile Koreceye sabitlenebilir.

Terminalin yanı sıra masaüstü uygulaması, tarayıcıda açılan web UI'sı (qwen serve --open, deneysel özellik), VS Code, Zed ve JetBrains entegrasyonları ile komut dosyaları ve CI için başsız çalıştırma (qwen -p "...") bulunur. Hepsi aynı ücretsiz depodadır; çıkarım maliyetini ayrıca ödersiniz.

/auth ile bağlantı hedefi seçme

/auth(takma adı /login) açıldığında “Select authentication method:” ekranı görünür ve en üst düzeyde üç seçenek bulunur. Qwen OAuth'u seçmeye çalışırsanız “Discontinued — switch to Coding Plan or API Key” uyarısı gösterilir.

ModelStudio'nun bu üç seçeneği aynı faturayı ödemenin üç yolu değildir. Belgeler her biri için ayrı uç nokta ve ayrı anahtar tanımlar; anahtar türü ile baseUrl eşleşmezse çalışmaz. Coding Plan, 1 Ekim 2026 itibarıyla “sınırlı miktar, ilk gelen alır; her gün 00.00'da (UTC+8) yenilenir” şeklinde gösteriliyor; bu nedenle bazı günler kayıt olunamayabilir. Coding Plan'da bir görev birden çok model çağrısı olarak hesaplanır ve Alibaba, basit görevlerde genellikle 5–10, karmaşık görevlerde ise 10–30 veya daha fazla çağrı olduğunu açıklar. Fiyat karşılaştırması İngilizce Qwen Code pricing sayfasında ayrıntılı olarak ele alınır.

Claude veya GPT kullanma: settings.json'da Custom Provider

Qwen Code kimlik doğrulama belgeleri, OpenAI, Anthropic, Google, OpenRouter ve kendi uç noktaları gibi üçüncü taraf bağlantıları için ~/.qwen/settings.json dosyasındaki modelProviders alanını önerir. Kunavo için yapılandırma şö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

Hata ayıklama süresinden tasarruf sağlayan dört nokta:

• baseUrl, yalnızca /v1 değerine kadardır. Model sağlayıcı başvuru belgeleri, “/v1/chat/completions tam yolunu değil, API'nin /v1 kökünü belirtin; istek yolunu SDK ekler” der. Yolu da yazarsanız kimlik doğrulama hatası değil, 404 alırsınız.
• Anahtarın saklandığı yer. Qwen Code, anahtarı envKey içinde belirtilen ada sahip ortam değişkeninden okur. Öncelik sırası kabuktaki export, .env dosyası (.qwen/.env önerilir, yalnızca ilk bulunan dosya kullanılır) ve settings.json içindeki env şeklindedir; son seçenek anahtarı düz metin olarak sakladığı için önerilmez.
• CLI bayraklarına göre yapılandırma dosyası önceliklidir. Karar sırası /auth giriş değeri → seçili modelProviders öğesi → CLI bağımsız değişkenleri → ortam değişkenleri → settings.json şeklindedir. --openai-base-url argümanının yok sayılıyormuş gibi görünmesinin nedeni budur. Eski açıklamalarda geçen security.auth.apiKey ve security.auth.baseUrl için desteğin sonlandırılması planlanmaktadır.
• Başlangıçta Chat Completions kullanın. wireApi atlanırsa Chat Completions biçimi kullanılır. "responses" olarak değiştirirseniz uç nokta otomatik algılanmaz ve hata durumunda otomatik geçiş yapılmaz. modelProviders değişiklikleri çalışan oturumlara da hemen yansır (/model yeniden açıldığında görünür).

Kunavo kataloğunda Qwen metin modelleri yoktur. Bu, Qwen'i ucuza kullanma yöntemi değil; Qwen Code içinde Claude ve GPT'yi tek bir ön ödemeli bakiye ile kullanma yöntemidir. Ayrıca Kunavo, Qwen Code'u kendi uç noktalarında gerçekten çalıştırarak doğrulamamıştır. Yapılandırma, İngilizce Qwen Code ayarları sayfasında olduğu gibi resmî belgeler temel alınarak hazırlanmıştır. Şu anda kullandığınız rotayı koruyarak deneyin.

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

README'nin örnek verdiği ilk istek, “bu depoyu açıkla ve nereden başlamam gerektiğini söyle” gibi bir istektir. Dosya okuma ve araç çağrıları tek seferde doğrulandığından yararlıdır. Yalnızca selamlaşmak bağlantı sorunlarını ortaya çıkarmaz.

yolo gibi otomatik onay modları, belgelerde “yalnızca güvenilir, sanal alan içinde bulunan veya atılabilecek ortamlarda kullanın” şeklinde uyarılır. /stats model'in tahmini maliyeti Qwen Code'un hesaplamasıdır, faturalandırılan tutar değildir. Gerçek tutarı bağladığınız sağlayıcının kullanım geçmişinden kontrol edin.

Bilinmesi gereken sınırlamalar

• Yerleşik web_search, bağlantı hedefine göre etkinleşir veya devre dışı kalır. DashScope sunucu tarafı aramasını kullandığından ModelStudio Standard API Key ve Token Plan ile tanınan bir DashScope ana bilgisayarını gösteren öğelerde etkinleşir; Coding Plan'da (bu uç noktada doğrulanmamıştır) ve üçüncü tarafların veya başka ana bilgisayarların özel uç noktalarında devre dışıdır (web_search belgeleri). Gerekirse bir MCP arama sunucusu bağlayın.
• Kunavo rotası yalnızca sohbet içindir. Kunavo'da embedding, konuşma sentezi veya konuşma tanıma modelleri yoktur. Qwen Code Live Voice için DashScope uç noktası zorunlu olduğundan, sohbet modelini nereye yönlendirirseniz yönlendirin ayrı anahtarı kullanır.

Kunavo ile deneme yaparken ödeme

Kunavo aylık sabit ücret olmadan, ön ödemeli ve bakiyeden token bazında düşülen bir model kullanır. Minimum yükleme $10 olup Stripe Checkout'ta kart (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay ve Link kullanılabilir. Checkout Kore wonu cinsinden görüntülenirse KakaoPay, Naver Pay, PAYCO, Samsung Pay ve uluslararası ödemelere kapalı yerel kartlar da seçilebilir (won dönüşümüne Stripe'ın %2–4 döviz çevirme ücreti eklenir; dolar ile ödeme yaparsanız bundan kaçınabilirsiniz). Toss Pay yoktur. Ödeme bilgilerini inceleyip hesap oluşturun ve anahtarınızı alın. İlk isteğin ardından gerçek tutarı kullanım geçmişi bölümünden kontrol etmek en güvenilir yöntemdir.

Sık sorulan sorular

1 Ekim 2026'da kontrol edildi: Qwen Code README'si; kimlik doğrulama, model sağlayıcı, komut ve web_search belgeleri (main dalı); deponun UI çeviri dosyaları listesi; npm'deki @qwen-code/qwen-code 0.24.7; Alibaba Cloud Coding Plan ve Token Plan sayfaları. Kunavo, Qwen Code'u kendi uç noktasında çalıştırmayı denememiştir.