Qwen Code einrichten: API Key, Base URL und Modelle

Verbinde Qwen Code über modelProviders.openai in ~/.qwen/settings.json mit BetterToken. In einem macOS-Test mit einem GPT-Modell verarbeitete Qwen Code 0.26.0 Textanfragen sowohl mit Responses als auch mit Chat Completions.

Datei-Leseaufgaben waren im Test mit Qwen Code 0.26.0 unzuverlässig. Chat Completions lieferte bei allen drei Versuchen eine leere finale Antwort; Responses lieferte zweimal von drei Versuchen die richtige Antwort. Die Tool-Ergebnisse enthielten den korrekten Dateiinhalt, aber die Ursache der Fehler in der finalen Antwort ist ungeklärt. Verlass dich für Datei-Leseaufgaben vorerst nicht auf diese Konfiguration.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key, über die Variable envKey referenziert
Base URL	https://bettertoken.ai/v1 für baseUrl
Modell	YOUR_MODEL_ID
Provider-Konfiguration	modelProviders.openai
API-Format	wireApi: "responses"

Voraussetzungen

• Node.js 22 oder neuer für die folgende npm-Installation
• Ein BetterToken API Key: Registrieren und Key erhalten
• Eine Model ID aus der model plaza

Installation

Verwende die npm-Option aus der offiziellen Schnellstartanleitung:

npm install -g @qwen-code/qwen-code@latest
qwen --version

Manuelle Einrichtung

Setze den API Key in deinem Terminal und ersetze YOUR_API_KEY:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Füge diese Einstellungen in ~/.qwen/settings.json ein. Ersetze beide YOUR_MODEL_ID-Werte durch dieselbe exakte Model ID:

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

envKey bezeichnet eine Umgebungsvariable und enthält nicht den API Key selbst. Die offizielle Referenz für Modell-Provider unterstützt auch wireApi: "chat-completions". Responses war bei den Datei-Leseversuchen in diesem Test erfolgreicher, aber keines der Formate bestand jeden Versuch.

Verbindung prüfen

Führe diesen reinen Texttest im selben Terminal aus:

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

Prüfe, ob die finale Antwort OK enthält. Eine erfolgreiche Textanfrage belegt nicht, dass eine Datei-Leseaufgabe eine korrekte finale Antwort liefert. Berücksichtige diese Einschränkung bei der Wahl deines Workflows.

Modell wechseln

Füge unter modelProviders.openai einen Modelleintrag hinzu, setze model.name auf dessen exakte id und starte eine neue Sitzung.

Häufige Fehler

Symptom	Prüfung
Authentifizierung schlägt fehl	Exportiere die durch envKey bezeichnete Variable im Terminal, in dem Qwen Code ausgeführt wird.
Falscher Endpunkt	Verwende https://bettertoken.ai/v1 für baseUrl; wireApi bestimmt das Anfrageprotokoll.
Modell nicht gefunden	Setze model.name auf eine id unter modelProviders.openai.
Leere oder falsche Antwort nach dem Lesen einer Datei	Dies trat in Version 0.26.0 trotz korrekter Tool-Ergebnisse auf. Der Wechsel zu Responses beseitigte die Fehler nicht. Verwende für Datei-Leseaufgaben einen anderen getesteten Client.

Weiterführende Links

• Unterstützte Tools vergleichen
• API-Fehler und Ratenlimits
• OpenCode einrichten

Technische Details

wireApi: "responses" wählt /v1/responses; wireApi: "chat-completions" wählt /v1/chat/completions. Beide Textpfade funktionierten im Test mit Qwen Code 0.26.0. Bei Datei-Leseaufgaben lagen die Erfolgsraten bei 2/3 beziehungsweise 0/3.