Qwen Code verwenden: Installation, Konto- und Modellauswahl, API-Einstellungen

Qwen Code ist ein von Alibabas Qwen-Team veröffentlichter Open-Source-KI-Coding-Agent (Apache-2.0). Die Nutzung besteht aus vier Schritten: „Installation → qwen im Projekt ausführen → Verbindungsziel mit /auth konfigurieren → Aufgabe anfordern“. Da die kostenlose Qwen-OAuth-Stufe am 15. April 2026 eingestellt wurde, funktioniert eine Anmeldung nach älteren Anleitungen nicht mehr kostenlos. Ein weiterer wichtiger Hinweis für koreanische Nutzer: Qwen Code hat keine koreanische Benutzeroberfläche. Diese Seite erklärt nacheinander den Einstieg anhand des aktuellen Menüs /auth, die Einstellung koreanischer Antworten, benutzerdefinierte Konfigurationen für Claude und GPT sowie häufig verwendete Befehle. Die neueste Version ist v0.24.7, veröffentlicht am 29. September 2026 auf npm. Da Releases mindestens wöchentlich erscheinen, prüfen Sie die installierte Version mit qwen --version.

Installation

Dies sind die Befehle aus dem offiziellen README. Mit dem eigenständigen Installationsskript müssen Sie Node.js nicht selbst vorbereiten; nur bei der npm-Installation ist Node.js 22 oder höher erforderlich.

# 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

Öffnen Sie das Terminal nach der Installation erneut, damit die Umgebungsvariablen wirksam werden. Qwen Code basierte ursprünglich auf Google Gemini CLI v0.8.2, wird aber seit v0.1 unabhängig entwickelt und nicht mehr mit dem Original synchronisiert. Einstellungen oder kostenlose Kontingente von Gemini CLI gelten daher nicht automatisch.

Erster Start und koreanische Antworten

cd /path/to/your-project
qwen

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

Die integrierten UI-Sprachen sind ausschließlich vereinfachtes Chinesisch, Englisch, Russisch, Deutsch, Japanisch, brasilianisches Portugiesisch, Französisch und Katalanisch; auch in den UI-Übersetzungsdateien des Repositorys gibt es kein Koreanisch (geprüft am 1. Oktober 2026). Daher erscheinen die Menüs auf Englisch, und diese Seite zitiert die sichtbaren englischen Begriffe unverändert. Die Antwortsprache des Modells ist unabhängig von der UI und kann mit /language output Korean auf Koreanisch festgelegt werden.

Neben dem Terminal gibt es eine Desktop-App, eine im Browser geöffnete Weboberfläche (qwen serve --open, experimentelle Funktion), Integrationen für VS Code, Zed und JetBrains sowie eine kopflose Ausführung für Skripte und CI (qwen -p "..."). Alle gehören zum selben kostenlosen Repository; die Inferenzkosten werden separat berechnet.

Verbindungsziel mit /auth auswählen

Wenn Sie /auth (Alias /login) öffnen, erscheint der Bildschirm „Select authentication method:“ mit drei Optionen der obersten Ebene. Wenn Sie Qwen OAuth auswählen möchten, wird der Hinweis „Discontinued — switch to Coding Plan or API Key“ angezeigt.

Die drei Optionen von ModelStudio sind nicht drei Möglichkeiten, dieselbe Rechnung zu bezahlen. Die Dokumentation weist jeder Option einen eigenen Endpunkt und eigenen Schlüssel zu; wenn Schlüsseltyp und baseUrl nicht zusammenpassen, funktioniert die Verbindung nicht. Der Coding Plan wird am 1. Oktober 2026 als „begrenzte Menge – nach dem Prinzip ,wer zuerst kommt‘; tägliche Auffüllung um 00:00 Uhr (UTC+8)“ angezeigt, sodass die Anmeldung je nach Tag nicht möglich sein kann. Beim Coding Plan wird eine Aufgabe anhand mehrerer Modellaufrufe berechnet; Alibaba erklärt, dass einfache Aufgaben typischerweise 5–10 Modellaufrufe und komplexe Aufgaben typischerweise 10–30 oder mehr Modellaufrufe umfassen. Einen ausführlichen Preisvergleich finden Sie auf der englischen Seite Qwen Code pricing.

Claude oder GPT verwenden: Custom Provider in settings.json

Die Authentifizierungsdokumentation von Qwen Code empfiehlt für Verbindungen zu Drittanbietern wie OpenAI, Anthropic, Google, OpenRouter und eigenen Endpunkten die Verwendung von ~/.qwen/settings.json und modelProviders. Für Kunavo sieht die Konfiguration wie folgt aus.

{
  "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

Vier Dinge, die Debugging-Zeit sparen:

• baseUrl endet bei /v1. Die Referenzdokumentation zu den Modellprovidern schreibt ausdrücklich vor: „Geben Sie nicht den vollständigen Pfad /v1/chat/completions an, sondern die API-/v1-Basis; den Anfragepfad ergänzt das SDK.“ Wenn Sie den vollständigen Pfad angeben, erhalten Sie statt eines Authentifizierungsfehlers einen 404-Fehler.
• Wo der Schlüssel hinterlegt wird. Qwen Code liest den Schlüssel aus der Umgebungsvariablen, deren Name in envKey angegeben ist. Die Prioritätsreihenfolge ist: export in der Shell, die .env-Datei (.qwen/.env empfohlen; nur die erste gefundene Datei wird verwendet) und env in settings.json. Die letzte Option speichert den Schlüssel im Klartext und wird daher nicht empfohlen.
• Die Konfigurationsdatei hat Vorrang vor CLI-Flags. Die Reihenfolge ist: Eingabe unter /auth → ausgewählter Eintrag modelProviders → CLI-Argumente → Umgebungsvariablen → settings.json. Deshalb scheint --openai-base-url ignoriert zu werden. security.auth.apiKey und security.auth.baseUrl aus älteren Anleitungen werden voraussichtlich nicht mehr unterstützt.
• Beginnen Sie mit Chat Completions. Wenn Sie wireApi weglassen, wird das Chat-Completions-Format verwendet. Wenn Sie zu "responses" wechseln, gibt es weder eine automatische Erkennung des Endpunkts noch einen automatischen Fallback bei Fehlern. Änderungen an modelProviders werden auch in laufenden Sitzungen sofort übernommen (sie werden sichtbar, wenn Sie /model erneut öffnen).

Im Kunavo-Katalog gibt es keine Qwen-Textmodelle. Dies ist keine Möglichkeit, Qwen günstiger zu verwenden, sondern eine Möglichkeit, Claude und GPT innerhalb von Qwen Code mit einem einzigen Vorauszahlungsguthaben zu nutzen. Außerdem hat Kunavo Qwen Code nicht tatsächlich am eigenen Endpunkt ausgeführt und daher nicht verifiziert. Die Konfiguration wurde wie auf der englischen Qwen-Code-Konfigurationsseite anhand der offiziellen Dokumentation erstellt. Lassen Sie den aktuell verwendeten Weg bestehen und testen Sie zunächst vorsichtig.

Erste Aufgabe und häufig verwendete Befehle

Die erste Anfrage im README lautet beispielsweise: „Beschreibe dieses Repository und sag mir, wo ich anfangen soll.“ Damit lassen sich Dateilesen und Toolaufrufe auf einmal prüfen. Mit einer bloßen Begrüßung lassen sich Verbindungsprobleme nicht erkennen.

Automatische Freigabemodi wie yolo werden in der Dokumentation ausdrücklich nur für Umgebungen empfohlen, denen Sie vertrauen, die sandboxed sind oder die notfalls verworfen werden können. Die geschätzten Kosten von /stats model werden von Qwen Code berechnet und sind nicht der Rechnungsbetrag. Prüfen Sie den tatsächlichen Betrag in den Nutzungsaufzeichnungen des verbundenen Anbieters.

Bekannte Einschränkungen

• Das integrierte web_search wird je nach Verbindungsziel aktiviert oder deaktiviert. Es verwendet die serverseitige Suche von DashScope und ist daher bei Einträgen mit ModelStudio Standard API Key und Token Plan sowie bei erkannten DashScope-Hosts aktiviert. Beim Coding Plan ist es deaktiviert (für diesen Endpunkt nicht verifiziert); ebenso bei Drittanbietern und benutzerdefinierten Endpunkten anderer Hosts (web_search-Dokumentation). Bei Bedarf können Sie einen MCP-Suchserver anbinden.
• Die Kunavo-Route unterstützt nur Chat. Kunavo bietet keine Embedding-, Sprachsynthese- oder Spracherkennungsmodelle. Für Qwen Codes Live Voice ist ein DashScope-Endpunkt erforderlich; unabhängig davon, wohin Sie das Chatmodell routen, wird dafür derselbe separate Schlüssel verwendet.

Zahlungen beim Testen mit Kunavo

Kunavo verwendet ein Prepaid-Auflademodell ohne monatliche Gebühr; die Kosten werden tokenweise vom Guthaben abgezogen. Die Mindestaufladung beträgt $10. Im Stripe-Checkout können Karten (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay und Link verwendet werden. Wenn der Checkout-Betrag in koreanischen Won angezeigt wird, können auch Kakao Pay, Naver Pay, PAYCO, Samsung Pay und inländische Karten ohne internationale Zahlungsfreigabe ausgewählt werden (die Umrechnung in Won enthält eine Stripe-Umrechnungsgebühr von 2–4 %, die bei Zahlung in US-Dollar vermieden werden kann). Toss Pay wird nicht angeboten. Lesen Sie die Abrechnungsinformationen, erstellen Sie ein Konto und stellen Sie einen Schlüssel aus. Nach der ersten Anfrage prüfen Sie den tatsächlichen Betrag am zuverlässigsten unter Nutzungsaufzeichnungen.

Häufig gestellte Fragen

Geprüft am 1. Oktober 2026: Qwen-Code-README, Dokumentation zu Authentifizierung, Modellprovidern, Befehlen und web_search (main-Branch), Liste der UI-Übersetzungsdateien im Repository, npm @qwen-code/qwen-code 0.24.7 sowie die Seiten von Alibaba Cloud zu Coding Plan und Token Plan. Kunavo hat Qwen Code nicht am eigenen Endpunkt ausgeführt.