Qwen Code verwenden: Installation, /auth, Japanisch und API-Einstellungen

Qwen Code ist ein Open-Source-KI-Coding-Agent (Apache-2.0), der vom Qwen-Team von Alibaba veröffentlicht wird. Der Ablauf besteht aus vier Schritten: „Installieren → qwen im Projekt starten → mit /auth das Zielsystem konfigurieren → eine Aufgabe erteilen“. Da das kostenlose Qwen-OAuth-Kontingent am 15. April 2026 endete, funktioniert Qwen Code nicht kostenlos, selbst wenn Sie sich wie in älteren Anleitungen beschrieben anmelden. Diese Seite erklärt der Reihe nach den Einstieg anhand des aktuellen /auth-Menüs, den Wechsel zur japanischen Anzeige, die benutzerdefinierte Konfiguration für Claude oder GPT und häufig verwendete Befehle. Die neueste Version ist v0.24.7, am 29. September 2026 in npm veröffentlicht. Da Veröffentlichungen mindestens einmal pro Woche erfolgen, prüfen Sie Ihre lokale Version mit qwen --version.

Installation

Dies sind die Schritte aus der offiziellen README. Beim eigenständigen Installationsprogramm müssen Sie Node.js nicht selbst bereitstellen. Nur bei der Verwendung von npm 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 übernommen 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 Upstream synchronisiert. Die Einstellungen und kostenlosen Kontingente von Gemini CLI gelten daher nicht automatisch.

Erster Start und japanische Sprache

cd /path/to/your-project
qwen

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

Mit /language ui ja-JP wird die Oberfläche auf Japanisch umgestellt; anschließend erscheinen in der Oberfläche von Qwen Code japanische Bezeichnungen wie „認証方法を選択“ und „ツール承認モード“. Diese Bezeichnungen verwenden wir auch auf dieser Seite. Die Antwortsprache ist von der UI-Sprache unabhängig und wird mit /language output Japanese festgelegt.

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 Headless-Ausführung für Skripte und CI (qwen -p "..."). Alle sind im selben kostenlosen Repository enthalten; die Inferenzkosten fallen separat an.

Verbindung unter /auth auswählen

Wenn Sie /auth (auch /login genannt) öffnen, erscheint der Bildschirm „認証方法を選択“; auf der obersten Ebene gibt es drei Optionen. Wenn Sie Qwen OAuth auswählen möchten, erscheint „終了 — Coding Plan または API Key に切り替えてください“.

Die drei ModelStudio-Optionen unterscheiden sich nicht nur in der Art der Abrechnung. Die Dokumentation weist jeder Option einen eigenen Endpunkt und einen eigenen Schlüssel zu; sie funktionieren nicht, wenn Schlüsseltyp und baseUrl nicht zusammenpassen. Beim Coding Plan wird am 1. Oktober 2026 „begrenzte Menge – nach dem Prinzip ‚wer zuerst kommt‘, tägliche Auffüllung um 0 Uhr (UTC+8)“ angezeigt; daher kann er an manchen Tagen bestellt werden und an anderen nicht. Eine einzelne Anfrage im Coding Plan führt intern zu mehreren Modellaufrufen. Alibaba zufolge werden bei einfachen Aufgaben 5–10 Aufrufe und bei komplexen Aufgaben 10–30 oder mehr verbraucht. Der englische Artikel Qwen Code pricing behandelt den Preisvergleich ausführlicher.

Claude oder GPT verwenden: Custom Provider in settings.json konfigurieren

Das Authentifizierungsdokument von Qwen Code empfiehlt für Verbindungen zu Drittanbietern wie OpenAI, Anthropic, Google, OpenRouter oder eigenen Endpunkten ~/.qwen/settings.json unter modelProviders. Für Kunavo sieht die Konfiguration so 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 Punkte sind besonders wichtig.

• baseUrl darf nur bis einschließlich /v1 reichen.Der Referenzabschnitt zu Modellanbietern schreibt ausdrücklich: „Geben Sie nicht /v1/chat/completions, sondern die API-/v1-Route an. Der SDK fügt den Request-Pfad hinzu.“ Wenn Sie den Pfad angeben, erhalten Sie statt eines Authentifizierungsfehlers einen 404-Fehler.
• Wo der Schlüssel gespeichert wird. Qwen Code liest ihn aus der Umgebung unter dem Variablennamen, den Sie mit envKey angeben. Die Priorität lautet: export in der Shell, .env (.qwen/.env empfohlen, nur die erste gefundene Datei), danach env in settings.json. Letzteres speichert den Schlüssel im Klartext und wird daher nicht empfohlen.
• Die Konfigurationsdatei hat Vorrang vor CLI-Flags.Die Auflösungsreihenfolge lautet: der unter /auth eingegebene Wert → der ausgewählte modelProviders → CLI-Argumente → Umgebungsvariablen → settings.json. Deshalb scheint --openai-base-url ignoriert zu werden. security.auth.apiKey und security.auth.baseUrl aus älteren Anleitungen sind veraltet.
• Zunächst Chat Completions verwenden.Wenn Sie wireApi weglassen, wird das Chat-Completions-Format verwendet. Mit "responses" gibt es weder eine automatische Erkennung des Endpunkts noch ein Fallback. Änderungen an modelProviders werden auch in einer laufenden Sitzung sofort übernommen (sie werden nach dem erneuten Öffnen von /model angezeigt).

Im Kunavo-Katalog gibt es keine Qwen-Textmodelle.Dies ist keine Möglichkeit, Qwen günstiger zu verwenden, sondern eine Möglichkeit, Claude oder GPT innerhalb von Qwen Code über ein einheitliches Prepaid-Guthaben zu verwenden. Außerdem hat Kunavo Qwen Code nicht tatsächlich mit dem eigenen Endpunkt ausgeführt. Die Konfiguration wurde wie auf der englischen Qwen-Code-Konfigurationsseite anhand der offiziellen Dokumentation erstellt. Lassen Sie den derzeit funktionierenden Pfad unverändert, während Sie dies ausprobieren.

Erste Aufgabe und häufig verwendete Befehle

Beginnen Sie wie im README-Beispiel mit einer Anfrage wie „Erkläre dieses Repository und sage mir, wo ich mit dem Lesen beginnen sollte“. Damit lässt sich prüfen, ob Dateizugriff und Tool-Aufrufe grundsätzlich funktionieren. Mit einer reinen Begrüßung lassen sich Verbindungsprobleme nicht erkennen.

Automatische Genehmigungsmodi wie yolo werden in der Dokumentation ausdrücklich mit dem Hinweis versehen, dass sie „nur in vertrauenswürdigen, sandboxes oder temporären Umgebungen verwendet werden sollen“. Die geschätzten Kosten von /stats model werden von Qwen Code berechnet und entsprechen nicht dem tatsächlichen Rechnungsbetrag. Prüfen Sie den tatsächlichen Betrag in den Nutzungsaufzeichnungen des Zielsystems.

Einschränkungen, die Sie kennen sollten

• Die integrierte web_search-Funktion wird durch das Zielsystem bestimmt. Da sie die serverseitige Suche von DashScope verwendet, ist sie bei Einträgen mit dem ModelStudio Standard API Key und Token Plan sowie bei einem erkannten DashScope-Host aktiviert, beim Coding Plan deaktiviert (weil sie mit diesem Endpunkt nicht geprüft wurde) und bei benutzerdefinierten Endpunkten von Drittanbietern oder anderen Hosts deaktiviert (Dokumentation zu web_search). Bei Bedarf können Sie einen MCP-Suchserver hinzufügen.
• Der Kunavo-Pfad unterstützt nur Chat. Kunavo bietet keine Modelle für Einbettungen, Sprachsynthese oder Spracherkennung an. Qwen Codes Live Voice erfordert einen DashScope-Endpunkt; unabhängig davon, wohin Sie das Chatmodell richten, bleibt dafür ein anderer Schlüssel erforderlich.

Zahlung bei der Nutzung von 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), Apple Pay, Google Pay und Link verwendet werden. Lesen Sie die Abrechnungsdokumentation, erstellen Sie ein Konto und stellen Sie einen Schlüssel aus. Nach der ersten Anfrage prüfen Sie am zuverlässigsten unter Nutzungsaufzeichnungen den tatsächlich berechneten Betrag.

Häufig gestellte Fragen

Geprüft am 1. Oktober 2026: README von Qwen Code sowie die Dokumentationen zu Authentifizierung, Modellanbietern, Befehlen und web_search (main-Zweig), japanische UI-Zeichenfolgen (packages/cli/src/i18n/locales/ja.js), 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 mit dem eigenen Endpunkt ausgeführt.