magpie mit QCode: Claude Code und Codex

QCode in magpie einrichten: die Adressen für anthropic, chat und responses, Hinzufügen per Import-Link oder einem Befehl und die Modellauswahl.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Letzte Überprüfung: 2026-10-27 · 📄 Gemäß offizieller Dokumentation (magpie v0.1.1680, veröffentlicht am 2026-10-27) · QCode-Anbindung mit magpie 0.1.1677 getestet (✅ Claude Code 2.1.311, Codex CLI 0.164.0)

Auf einen Blick¶

Was magpie ist und wie es sich von CC Switch unterscheidet¶

magpie betreibt ein Gateway auf Ihrem Rechner (127.0.0.1:3425). Es spricht die APIs von OpenAI, Anthropic und Gemini und übersetzt zwischen ihnen, einschließlich Streaming und Tool-Aufrufen. Wenn Sie in magpie ein Modell für einen Agenten auswählen, schreibt magpie dieses Modell in die eigene Konfigurationsdatei des Agenten. Claude Code und Codex verbinden sich daher mit dem lokalen Gateway; Ihr QCode-Schlüssel bleibt in magpie, und das Gateway leitet jede Anfrage an QCode weiter.

Der strukturelle Unterschied zu CC Switch lässt sich in einem Satz sagen: CC Switch schreibt Endpunkt und Schlüssel in die Konfiguration jedes Clients, und der Client verbindet sich direkt mit dem Anbieter; magpie richtet den Client auf ein lokales Gateway, das die Anfragen weiterleitet.

Welches Protokoll¶

Claude läuft nur über /api; die OpenAI-kompatiblen Adressen bedienen Claude nicht. Wird eine claude-*-ID an chat oder responses gesendet, antwortet QCode mit model_not_available_on_endpoint; diese Prüfung erfolgt vor der Authentifizierung. GPT nutzt beide OpenAI-Pfade, und chinesische Modelle laufen sowohl über chat als auch über anthropic.

Für den asiatischen oder nordamerikanischen Zugangspunkt ersetzen Sie die Domain durch asia.qcode.cc oder us.qcode.cc; die Pfade bleiben gleich. Alle drei Domains haben dieselben Fähigkeiten und unterscheiden sich nur im Netzwerkweg.

Die offizielle Beschreibung von magpie für responses nennt eine Base URL, die auf /v1 endet. Für QCode tragen Sie https://api.qcode.cc/openai ein (wie die base_url in der Codex-Konfiguration für QCode); getestet mit magpie 0.1.1677 am 2026-10-27.

Installation¶

Der offizielle Installer:

curl -fsSL https://usemagpie.ai/install.sh | sh

Der Installer legt den Befehl magpie in ~/.local/bin ab und das Programm an den vorgesehenen Ort: /Applications auf dem Mac, das Anwendungsmenü unter Linux. Unter Windows nimmt magpie.exe dieselben Befehle entgegen; wenn Sie nur die Terminal-Version brauchen, verwenden Sie magpie-cli-windows-amd64.exe aus dem neuesten Release. magpie läuft auf macOS, Windows und Linux als Menüleisten-App, Fenster, TUI, Web-UI und CLI.

QCode hinzufügen¶

Variante A: Import-Link (Desktop-App und Web)

magpie verlangt, dass jeder Parameterwert URL-kodiert ist. Hier ist der Link für QCode ohne Schlüssel:

magpie://import?name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=claude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5%2Cgpt-6.1-sol%2Cgpt-5.6-sol&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard

Im Web verwenden Sie die anklickbare Form mit denselben Parametern nach # (Browser senden das Fragment nie an einen Server; ist magpie nicht installiert, bietet der Link den Download an):

https://usemagpie.ai/import#name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=claude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5%2Cgpt-6.1-sol%2Cgpt-5.6-sol&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard

Ohne Schlüssel im Link fügt der Benutzer den Schlüssel im Dialog von magpie ein, wie die offizielle Dokumentation sagt; bis Add gedrückt wird, wird nichts gespeichert. Im Terminal zeigt magpie import ohne Schlüssel nur an, was hinzugefügt würde, und speichert nichts (getestet am 2026-10-27); verwenden Sie im Terminal daher Variante B. Um den Schlüssel eines gespeicherten Providers zu ersetzen, führen Sie magpie provider key qcode cr_xxx aus.

Variante B: ein Befehl im Terminal (getestet)

magpie provider add QCode anthropic=https://api.qcode.cc/api url=https://api.qcode.cc/openai/v1 responses=https://api.qcode.cc/openai key=cr_xxx

Variante C: die App

Öffnen Sie den Tab Providers, drücken Sie ＋ Add provider, wählen Sie Custom (offizielle Bezeichnung: Custom · any compatible URL), geben Sie einen Namen, eine OpenAI-kompatible Base URL (endet auf /v1) und/oder eine Anthropic-kompatible Base (die Wurzel) sowie den Schlüssel ein und speichern Sie.

Modelle auswählen¶

magpie claude qcode/claude-sonnet-5-5        # Hauptmodell
magpie claude opus qcode/claude-opus-5-5     # der Opus-Slot in Claude Code
magpie codex qcode/gpt-6.1-sol               # Codex
magpie claude default                        # die frühere Claude-Code-Konfiguration wiederherstellen
magpie codex default                         # die frühere Codex-Konfiguration wiederherstellen

magpie schreibt die Adresse des lokalen Gateways in ~/.claude/settings.json (ANTHROPIC_BASE_URL ist http://127.0.0.1:3425) und dazu das Token magpie; der QCode-Schlüssel bleibt in magpie und wird nicht in die Claude-Code-Konfiguration geschrieben. Wird nur das Hauptmodell gesetzt, erhält auch der Opus-Slot dasselbe Modell; damit im Opus-Slot Opus läuft, führen Sie zusätzlich magpie claude opus qcode/claude-opus-5-5 aus. Den Haiku-Slot setzt magpie automatisch auf qcode/claude-haiku-5-5.

Ohne models= beim Hinzufügen des Anbieters zeigt magpie nur die ersten 24 Modelle der Liste (die getestete Ausgabe war 24 of 29 models). Wählen Sie die gewünschten Modelle mit magpie provider models qcode <id> <id> …, zum Beispiel:

magpie provider models qcode claude-opus-5-5 claude-sonnet-5-5 claude-haiku-5-5 gpt-6.1-sol gpt-5.6-sol

Empfohlene IDs: claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6.1-sol und gpt-5.6-sol. Die verfügbaren Modelle stehen unter https://qcode.cc/models. Die Kosten werden pro Token berechnet; die Preise je Modell stehen ebenfalls unter https://qcode.cc/models.

Überprüfen¶

magpie healthcheck
magpie provider test qcode

magpie healthcheck endet mit Code 0, solange das Gateway antwortet. magpie provider test qcode sendet je eine winzige Anfrage an chat, responses und anthropic und zeigt die Latenz.

Ist das erste Modell in models ein Claude-Modell, zeigen die Zeilen chat und responses ✗ 400 · Model 'claude-opus-5-5' is not available on this endpoint. Das ist das vorgesehene Verhalten von QCode: Claude wird nur am Anthropic-Messages-Endpunkt bedient, eine Zeile anthropic mit ✓ bedeutet also, dass Claude funktioniert. GPT prüfen Sie, indem Sie magpie codex qcode/gpt-6.1-sol ausführen und eine echte Anfrage senden.

Senden Sie dann „ping“ in Claude Code und lassen Sie Codex eine Datei lesen. Nach dem Test vom 2026-10-27 entsprechen Claude-Anfragen über magpie einer direkten QCode-Verbindung, das Prompt-Caching funktioniert wie gewohnt, und Codex nutzt die Responses-API.

Häufige Fragen¶

Claude Code verbindet sich nicht, wenn das Gateway nicht läuft¶

Führen Sie zuerst magpie healthcheck aus; Exit-Code 0 bedeutet, dass das Gateway antwortet. Das Gateway läuft mit der App und bleibt nach dem Schließen des Fensters in der Menüleiste oder im Tray. Sie können auch nur das Gateway mit magpie serve betreiben oder es mit magpie daemon install als Dienst halten (systemd unter Linux, launchd unter macOS).

Sind die 400er-Zeilen für chat und responses in magpie provider test qcode ein Konfigurationsfehler?¶

Nein, solange die Zeile anthropic ✓ ist. QCode bedient Claude-Modelle nur am Anthropic-Messages-Endpunkt; deshalb wird das Claude-Modell des Tests bei chat und responses absichtlich mit 400 abgelehnt. GPT prüfen Sie mit magpie codex qcode/gpt-6.1-sol und einer echten Anfrage.

Warum sehe ich nur einen Teil der Modelle?¶

Ohne models= beim Hinzufügen zeigt magpie nur die ersten 24. Wählen Sie die benötigten IDs mit magpie provider models qcode …; die Liste der verfügbaren Modelle steht unter https://qcode.cc/models.

Wie stelle ich die frühere Claude-Code-Konfiguration wieder her?¶

Führen Sie magpie claude default aus oder wählen Sie im Modellauswahldialog ein eigenes Modell des Agenten. magpie entfernt, was es geschrieben hat, und stellt die ersetzten Werte wieder her.

Wie ändere ich die Reasoning-Stufe von Codex?¶

Verwenden Sie magpie codex effort <Stufe>, zum Beispiel magpie codex effort high; magpie codex effort zeigt den aktuellen Wert. Auch eine reine Stufe funktioniert, zum Beispiel magpie codex xhigh.

Was ist die Privatsphäre-Maskierung, und ist sie standardmäßig aktiv?¶

Sie ist standardmäßig aus; schalten Sie sie unter Settings → Privacy ein. Danach werden API-Schlüssel, private Schlüssel, Token, E-Mail-Adressen sowie Karten- und Ausweisnummern mit gültiger Prüfsumme durch Platzhalter wie {{API_KEY_k3v9x2mq}} ersetzt, bevor eine Anfrage Ihren Rechner verlässt, und in der Antwort wieder eingesetzt; die Werte werden nur im Speicher gehalten.

Wie schalte ich die anonyme Nutzungszählung aus?¶

Schalten Sie Count me as a user unter Settings → Privacy aus oder setzen Sie DO_NOT_TRACK=1 / MAGPIE_NO_STATS=1. Einmal täglich sendet eine veröffentlichte magpie-Version einen anonymen Batch mit einer auf Ihrem Rechner erzeugten Zufalls-ID, ihrer Version und Ihrem System sowie den internen IDs der verwendeten Agenten, Anbieter und Modelle.

Verwandte Dokumentation¶

• CC Switch: ein Desktop-Werkzeug, das Endpunkt und Schlüssel in die Konfiguration jedes Clients schreibt
• Codex: die Responses-Form in ~/.codex/config.toml
• Endpunkte & API-Pfade: die drei Protokolle und drei Zugangsdomains
• Umgebungsvariablen: wie ANTHROPIC_BASE_URL und ähnliche Variablen verwendet werden

Enterprise →