Qwen Code

Qwen Code liest seine Endpunkte aus modelProviders in ~/.qwen/settings.json — ein Eintrag mit baseUrl und envKey bringt Claude und GPT in die /model-Auswahl.

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

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
2. Öffnen Sie ~/.qwen/settings.json (legen Sie die Datei an, falls sie nicht vorhanden ist) und übernehmen Sie die vier obigen Blöcke. Die Dokumentation empfiehlt, modelProviders in der Datei für den Benutzerbereich zu deklarieren, „um Merge-Konflikte zwischen Projekt- und Benutzereinstellungen zu vermeiden“.
3. Hinterlegen Sie den Schlüssel nach Möglichkeit an einer sichereren Stelle als env. Qwen Code liest ihn aus process.env[envKey], und die Dokumentation ordnet die Quellen absteigend nach Priorität: zuerst eine Shell-export, dann eine .env-Datei und schließlich der env-Block in settings.json – den sie als Speicherung im Klartext kennzeichnet. Der obige env-Block ist die kleinste funktionierende Konfiguration, aber nicht die beste dauerhafte Lösung.
4. Führen Sie qwen aus. Wenn security.auth.selectedType auf openai gesetzt ist und model.name mit einem von Ihnen deklarierten id übereinstimmt, ist kein interaktiver Schritt /auth erforderlich – genau das sagt die Dokumentation ausdrücklich nach dem Beispiel mit einer Datei.
5. Geben Sie ihm eine Aufgabe, bei der eine Datei gelesen und bearbeitet werden muss, statt einer Begrüßung. Qwen Code ist ein Agent: Tool-Aufrufe und Streaming sollten beim ersten Lauf geprüft werden, denn sie würden bei einem Endpunkt, der nur teilweise kompatibel ist, als Erstes fehlschlagen.
6. Fügen Sie weitere Einträge unter modelProviders.openai hinzu, um Modelle zur Laufzeit mit /model zu wechseln. Änderungen daran werden in einer laufenden Sitzung sofort neu geladen; providerProtocol wird beim Start einmal eingelesen und erfordert einen Neustart.

Abgeglichen mit Authentifizierungsseite von Qwen Code, Option 4: API-Schlüssel (flexibel) am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Qwen Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Drei Punkte, die in der Dokumentation geklärt werden und bei denen viele falsch liegen

Diese Angaben stammen von der oben verlinkten Authentifizierungsseite und der Referenz zu den Modellanbietern. Jede davon kostet echte Zeit bei der Fehlersuche, wenn man sie nur annimmt, statt nachzulesen.

1. Ein Eintrag unter modelProviders hat Vorrang vor den CLI-Flags. Die dokumentierte Reihenfolge, absteigend nach Priorität: zuerst die in der laufenden Sitzung über /auth vorgenommenen Überschreibungen, dann die envKey des ausgewählten Modellanbieters, danach CLI-Argumente wie --openai-api-key, anschließend Umgebungsvariablen und zuletzt security.auth.apiKey in den Einstellungen. Die meisten erwarten, dass das Flag Vorrang hat. Das ist nicht der Fall – deshalb kann es so aussehen, als würde --openai-base-url ignoriert.
2. security.auth.apiKey und security.auth.baseUrl sind veraltet. Die Referenz bestätigt das und empfiehlt die Migration zu modelProviders. Wenn ein älteres Tutorial Sie auffordert, diese beiden Schlüssel zu bearbeiten, führt es Sie über einen Weg, der ausläuft.
3. wireApi legt das Anforderungsformat fest; eine Abweichung wird nicht erkannt. Ohne diese Angabe wird Chat Completions verwendet, wie im obigen Block. Für "wireApi": "responses" ist ein tatsächlich Responses-kompatibler Endpunkt erforderlich, und laut Dokumentation gibt es weder eine Erkennung des Endpunkts noch einen automatischen Fallback, wenn eine Anfrage fehlschlägt. Kunavo unterstützt sowohl /v1/responses als auch /v1/chat/completions, aber keine der beiden Kombinationen wurde auf dieser Seite getestet. Beginnen Sie daher mit der Standardeinstellung.

Wenn Sie wegen des kostenlosen Tarifs hier sind

Ein Großteil der Informationen über Qwen Code beschreibt weiterhin eine Qwen-OAuth-Anmeldung mit einem kostenlosen Tageskontingent. Diese Option gibt es nicht mehr: Laut Dokumentation wurde der kostenlose Tarif am 15. April 2026 eingestellt, und Qwen OAuth ist im Dialogfeld /auth nicht mehr als Option auswählbar. Aktuell werden dort drei Optionen aufgeführt: Alibaba ModelStudio – mit Coding Plan, Token Plan und Standard API Key im Untermenü –, Drittanbieter und Benutzerdefinierter Anbieter, beschrieben als Verbindung mit „einem lokalen Server, Proxy oder nicht unterstützten Anbieter“. Kunavo ist die dritte dieser Optionen. Beachten Sie außerdem, dass die Elemente im ModelStudio-Untermenü keine drei Zahlungsmöglichkeiten für dieselbe Rechnung sind: Jedes hat seinen eigenen Host und Schlüssel, und ein Coding-Plan-Schlüssel funktioniert nicht mit einem Token-Plan-Host.