magpie funktioniert nicht? 401- und 405-Fehler beheben (November 2026)
Stand 2026-11-10 nennen die offizielle Dokumentation von magpie, die Release Notes und die Issues im Repository für jeden dieser häufigen Fehler Ursache und Lösung: Nutzt ein Agent nach dem Wechsel weiter das alte Modell, behält die laufende Sitzung das Modell, mit dem sie gestartet ist – starten Sie also eine neue (bei Codex zusätzlich die Codex-App neu starten). Ein 401 in Docker oder im LAN bedeutet, dass die Anfrage keinen aktivierten Gateway-Schlüssel mitgeschickt hat; erzeugen Sie einen mit magpie gateway-key add. Zum 405 bei ZCode hat der Autor in Issue #425 geantwortet, dass magpie Ihre Prompts nicht umschreibt und sich nicht als offizieller Client ausgibt. Mit QCode ist der 400 in den Zeilen chat und responses des provider test erwartet; sehen Sie nur die ersten 24 Modelle, wählen Sie die benötigten mit magpie provider models aus.
Aktualisiert 2026-11-10
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Die vier häufigsten Fehler
Nach dem Wechsel eine neue Sitzung starten
Die Antwort aus dem offiziellen FAQ: Eine laufende Sitzung behält, womit sie gestartet ist; starten Sie also eine neue. Bei Codex starten Sie zusätzlich die Codex-App neu.
Anfragen brauchen einen Gateway-Schlüssel
Die Docker-Dokumentation von magpie: Eine Anfrage vom Host oder von einem anderen Rechner wird nur mit einem aktivierten Gateway-Schlüssel beantwortet, ohne ihn kommt 401. Erzeugen Sie ihn mit magpie gateway-key add und einem Namen (läuft magpie in Docker, setzen Sie docker exec magpie davor).
ZCode: das Prinzip des Autors
Issue #425 ist geschlossen (not planned). Das Prinzip des Autors: magpie schreibt Ihre Prompts nicht um und gibt sich nicht als offizieller Client aus. Seit v0.1.590 erklärt diese Fehlermeldung, dass ZCode nur Anfragen aus der eigenen App annimmt, und schlägt vor, der Gruppe einen weiteren Anbieter hinzuzufügen.
Der 400 im provider test ist erwartet
Die QCode-Dokumentation: Ist das erste Modell in models ein Claude-Modell, zeigen die Zeilen chat und responses 400, weil Claude nur über den Anthropic-Messages-Endpunkt bereitgestellt wird; ein Häkchen in der Zeile anthropic bedeutet, dass Claude funktioniert.
Woher kommen magpie-Fehler?
Stand 2026-11-10 entstehen die meisten magpie-Fehler an einer von drei Stellen: in der Sitzung des Agents, im lokalen Gateway oder am Modell-Endpunkt dahinter. magpie betreibt auf Ihrem Rechner ein Gateway unter 127.0.0.1:3425 und schreibt für die unterstützten Agents Adresse und Token des Gateways in die eigene Konfigurationsdatei des Agents. Agents lesen ihre Konfiguration beim Start, daher gilt ein Wechsel erst für danach gestartete Sitzungen; läuft das Gateway nicht, kann sich der Agent nicht verbinden; und sobald das Gateway in Docker läuft oder im LAN freigegeben ist, brauchen Anfragen von außerhalb des Containers oder von anderen Rechnern einen aktivierten Gateway-Schlüssel. Unten steht jeder Fehler mit seinem Text oder Symptom, mit Ursache und Befehl aus der offiziellen Dokumentation von magpie, den Release Notes und den Repository-Issues. Beginnen Sie die Diagnose mit drei Befehlen: magpie healthcheck, magpie provider test mit Ihrer Anbieter-ID und magpie log. Für WSL-Setups siehe /magpie-wsl-windows-setup.
2026-11-10: v0.1.3518 behebt Fehler bei Nicht-UTF-8-Text
Laut den offiziellen Release Notes hat v0.1.3518, veröffentlicht am 2026-11-10, einen Fehler behoben: Nicht-UTF-8-Text im Anfragetext wurde als Ersetzungszeichen � (U+FFFD) an den Anbieter gesendet. Wenn das Modell von Ihnen gesendeten Nicht-UTF-8-Text als � erhalten hat, prüfen Sie, ob magpie auf diese oder eine neuere Version aktualisiert ist; ein installiertes magpie aktualisiert sich selbst.
Zeitleiste
Issue #425 (ZCode liefert 405) wird mit der Antwort des Autors geschlossen; ein Release vom selben Tag formuliert die Fehlermeldung um.
Der Autor antwortet auf X auf eine Beschwerde über eine unübersichtliche Modellliste: eine Routing-Gruppe anlegen und im Agent nur diese Gruppe wählen.
Geprüft: offizielles README, docs/start, docs/docker, Reference sowie die Issues #425 und #4453; das Release mit dem Fix für Nicht-UTF-8-Text erscheint am selben Tag.
Was die offiziellen Quellen lösen und was sie offenlassen
Von magpie dokumentiert
① Eine laufende Sitzung behält das Modell, mit dem sie gestartet ist; starten Sie eine neue und bei Codex zusätzlich die Codex-App neu. ② Bei einem Modell über magpie läuft das Gateway mit der App; nach dem Schließen des Fensters bleibt es in der Menüleiste oder im Tray, magpie serve betreibt nur das Gateway, und magpie daemon install hält es als Dienst am Laufen; magpie healthcheck endet mit 0, solange das Gateway antwortet. ③ Über Loopback funktioniert jedes Token; sobald das Gateway im Netz ist (0.0.0.0 in Docker, LAN-Freigabe), brauchen entfernte Anfragen einen aktivierten Gateway-Schlüssel, sonst kommt 401, und eine WSL-Distribution hinter NAT gilt ebenfalls als entfernt. ④ Den Text des Docker-401 finden Sie in der zweiten Frage der FAQ unten; die Lösung ist, einen Gateway-Schlüssel zu erzeugen und in den Einstellungen des Agents einzutragen. ⑤ Die ohne Schlüssel geöffnete Browserseite wird abgewiesen (401); öffnen Sie den Link aus dem Log, und mit MAGPIE_WEB_KEY bleibt der Schlüssel über Neustarts gleich. ⑥ Ist MAGPIE_ALLOW_IPS gesetzt, wird eine Anfrage von jeder anderen Adresse mit 403 abgewiesen, bevor der Schlüssel geprüft wird. ⑦ magpie provider test mit einer Anbieter-ID sendet pro API eine winzige Anfrage und zeigt die Latenz. ⑧ magpie log zeigt, wo die Logs liegen, und magpie log -f verfolgt sie fortlaufend.
Was die offiziellen Quellen offenlassen
Stand 2026-11-10: ① Issue #4453 (SSH remote sessions rejected) ist weiterhin offen: In einer SSH-Sitzung lehnt Claude Desktop die Loopback-Gateway-Adresse 127.0.0.1:3425 ab, die magpie dafür einträgt, und meldet, dass Remote-Sitzungen mit diesem Gateway nicht verfügbar sind. Bei der Prüfung hatte der Repository-Autor noch nicht geantwortet; maßgeblich ist seine spätere offizielle Antwort. ② Fehlermeldungen ändern sich zwischen Versionen, die Meldung zu ZCode wurde zum Beispiel schon einmal umformuliert; deshalb sind die Fehler hier nach ihrer Bedeutung geordnet, der genaue Wortlaut kann abweichen. ③ magpie veröffentlicht mehrere Releases pro Tag; welche Version Ihr Problem behoben hat, steht in den GitHub Releases.
Ein 401, zwei Situationen
Lokaler Loopback
Die offizielle Reference: Anfragen über Loopback werden großzügig behandelt, jedes Token funktioniert, auch ein veralteter oder deaktivierter Gateway-Schlüssel; Agents verbinden sich standardmäßig mit 127.0.0.1:3425.
Docker oder LAN-Freigabe
Sobald das Gateway im Netz ist, brauchen entfernte Anfragen einen aktivierten Gateway-Schlüssel, gesendet als Bearer, x-api-key, x-goog-api-key oder ?key=, sonst kommt 401. Als entfernt gelten auch Anfragen über die Port-Freigabe von Docker (selbst die des Hosts kommen über die Bridge) und eine WSL-Distribution hinter NAT.
magpie in dieser Reihenfolge prüfen
① Prüfen Sie zuerst die Version: magpie veröffentlicht mehrere Releases pro Tag, und der Test für diese Seite am 2026-11-10 lief mit 0.1.3533; ein installiertes magpie aktualisiert sich selbst, oder Sie führen den offiziellen Installer erneut aus: curl -fsSL https://usemagpie.ai/install.sh | sh. ② Führen Sie magpie healthcheck aus; Exit-Code 0 heißt, das Gateway antwortet. Läuft kein Gateway, meldet der Befehl no gateway at http://127.0.0.1:3425 (von QCode am 2026-11-10 geprüft); öffnen Sie dann die App oder starten Sie mit magpie serve nur das Gateway. ③ Führen Sie magpie provider test mit Ihrer Anbieter-ID aus (qcode, wenn Sie QCode wie in dessen Dokumentation hinzugefügt haben); der Befehl sendet pro API eine winzige Anfrage, so sehen Sie, welche Zeile fehlschlägt. ④ Mit magpie log -n 200 sehen Sie die letzten Log-Zeilen; wenn Sie um Hilfe bitten, hängen Sie den Pfad an, den magpie log ausgibt. ⑤ Hat ein Wechsel nicht gegriffen, starten Sie eine neue Sitzung und bei Codex die Codex-App neu. ⑥ Bei einem 401 in Docker oder im LAN erzeugen Sie einen Schlüssel unter Gateway → Gateway keys oder mit magpie gateway-key add und einem Namen (in Docker mit docker exec magpie davor). ⑦ Für WSL siehe /magpie-wsl-windows-setup.
Zwei normale Ergebnisse mit QCode
Stand 2026-11-10 beschreibt die QCode-Dokumentation zwei normale Ergebnisse: ① Ist das erste Modell in models ein Claude-Modell, zeigt magpie provider test für den Anbieter qcode in den Zeilen chat und responses ✗ 400 mit dem Hinweis, dass das Modell an diesem Endpunkt nicht verfügbar ist: Claude wird nur über den Anthropic-Messages-Endpunkt bereitgestellt, ein Häkchen in der Zeile anthropic bedeutet also, dass Claude funktioniert; um GPT zu prüfen, führen Sie magpie codex qcode/gpt-6.1-sol aus und senden eine echte Anfrage. ② Ohne models= beim Hinzufügen des Anbieters gibt magpie nur die ersten 24 Modelle der Liste frei; die freizugebenden wählen Sie mit magpie provider models, gefolgt von der Anbieter-ID qcode und den Modell-IDs, und die angebotenen Modelle stehen auf https://qcode.cc/models. Ein QCode-Schlüssel bedient Anthropic- und OpenAI-kompatible Schnittstellen; tragen Sie in magpie bei anthropic https://api.qcode.cc/api, bei chat https://api.qcode.cc/openai/v1 und bei responses https://api.qcode.cc/openai ein. Abgerechnet wird pro Token, die Preise je Modell stehen auf /models. Drei Schritte zum Start: registrieren, aufladen, den Schlüssel kopieren (er beginnt mit cr_) und ihn wie auf der magpie-Seite von docs.qcode.cc hinzufügen. Erst ein paar Tage testen? «Nutzungspakete» starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen aufbrauchen; mehr unter /pay-as-you-go.
Häufige Fragen
Ich habe das Modell gewechselt, aber mein Agent nutzt weiter das alte. Warum?
Eine laufende Sitzung behält das Modell, mit dem sie gestartet ist, so steht es im offiziellen FAQ. Starten Sie eine neue Sitzung und bei Codex zusätzlich die Codex-App neu. Agents lesen ihre Konfiguration beim Start, daher gilt die Änderung ab der nächsten Sitzung. Um einen Agent in den ursprünglichen Zustand zurückzusetzen, wählen Sie in der Auswahl eines seiner eigenen Modelle oder führen magpie mit dem Agent-Namen und default aus, zum Beispiel magpie claude default.
Fehler 401: the API key sent is not an enabled magpie gateway key
Das ist der 401-Text aus der Docker-Dokumentation von magpie: Der Schlüssel, den ein Agent von außerhalb des Containers gesendet hat, ist kein aktivierter Gateway-Schlüssel (bei LAN-Freigabe brauchen Anfragen von anderen Rechnern ebenfalls einen Gateway-Schlüssel). Die Dokumentation nennt einen typischen Fall: Nach dem Upgrade von einem älteren Image sendet ein Agent außerhalb des Containers weiterhin magpie oder einen anderen Schlüssel, der kein Gateway-Schlüssel ist. Die Lösung: Erzeugen Sie einen Schlüssel unter Gateway → Gateway keys oder mit magpie gateway-key add und einem Namen (in Docker mit docker exec magpie davor); der Befehl gibt einen neuen sk-magpie-key-… aus, den Sie im Agent als API-Schlüssel eintragen. Am lokalen Loopback funktioniert jedes Token.
ZCode: 405 Method Not Allowed – was tun?
Der Titel von Issue #425 beginnt mit ZCode provider returns 405 Method Not Allowed, das Issue ist geschlossen (not planned). In seiner Antwort vom 2026-10-01 nannte der Autor das Prinzip: magpie schreibt Ihre Prompts nicht um und gibt sich nicht als offizieller Client aus. Seit v0.1.590 erklärt diese Fehlermeldung, dass ZCode nur Anfragen aus der eigenen App annimmt, und schlägt vor, der Gruppe einen weiteren Anbieter hinzuzufügen. Folgen Sie dem und fügen einen Anbieter hinzu, der mit API-Schlüssel arbeitet: QCode bietet GLM-Modelle wie glm-5.3 sowohl über die Anthropic- als auch über die OpenAI-Chat-Schnittstelle an; die Modelle stehen auf /models.
Die Zeilen chat und responses im provider test zeigen 400. Ist meine Einrichtung falsch?
Nein, solange die Zeile anthropic ein Häkchen hat. QCode stellt Claude-Modelle nur über den Anthropic-Messages-Endpunkt bereit; ist das erste Modell in models ein Claude-Modell, schickt der Test es auch an chat und responses und erhält designbedingt einen 400 mit dem Text Model 'claude-opus-5-5' is not available on this endpoint. Für ein Häkchen in allen drei Zeilen setzen Sie beim Auflisten mit magpie provider models ein GPT-Modell wie gpt-6.1-terra an die erste Stelle (von QCode am 2026-11-10 geprüft); GPT lässt sich auch prüfen, indem Sie magpie codex qcode/gpt-6.1-sol ausführen und eine echte Anfrage senden.
Warum sehe ich in magpie nur einen Teil der Modelle, und was tun, wenn die Modellliste unübersichtlich ist?
Laut QCodes Test gibt magpie ohne models= beim Hinzufügen des Anbieters nur die ersten 24 Modelle frei. Wenn Sie nach magpie provider models die Anbieter-ID und Modell-IDs angeben, wird die ganze Liste durch Ihre ersetzt; um nur ein Modell zusätzlich freizugeben, schreibt die Reference +Modell-ID (und -Modell-ID nimmt eines heraus), der Rest bleibt unverändert. Bei einer unübersichtlichen Liste antwortete der Autor am 2026-11-05 auf X, eine Routing-Gruppe anzulegen und im Agent nur diese Gruppe zu wählen; die Reference beschreibt außerdem einen Schalter Only through routing groups am Anbieter, der den ganzen Anbieter für Routing-Gruppen reserviert.
Der Agent bekommt 502 oder kann sich nicht verbinden, und im Routing-Tab von magpie steht nichts?
Die Ursache laut offiziellem FAQ: Eine Proxy-App (Surge, Clash, mihomo und ähnliche, mit Systemproxy, TUN oder erweitertem Modus) hat die Anfrage des Agents an http://127.0.0.1:3425 abgefangen und woandershin geschickt, sodass sie magpie nie erreicht. Die offizielle Lösung: Fügen Sie vor Ihren übrigen Regeln zwei Regeln ein, die lokale Adressen direkt durchlassen, IP-CIDR,127.0.0.0/8,DIRECT,no-resolve und IP-CIDR6,::1/128,DIRECT,no-resolve, und lassen Sie den Agent danach eine neue Anfrage senden.
Quellen
Das magpie-README, docs/start und docs/docker auf usemagpie.ai (einschließlich der chinesischen Fassungen), docs/reference.md im Repository, die GitHub Releases der hier genannten Versionen, die Issues #425 und #4453 mit Kommentaren sowie ein Archiv des X-Beitrags des Autors vom 2026-11-05, alles am 2026-11-10 gelesen. QCode: qcode.cc/models, qcode.cc/pay-as-you-go, die magpie-Seite auf docs.qcode.cc und QCodes eigene Testnotizen, alle vom 2026-11-10.
magpie mit einem QCode-Schlüssel nutzen
Ein QCode-Schlüssel für die Felder anthropic, chat und responses in magpie: Anthropic- und OpenAI-kompatible Schnittstellen, abgerechnet pro Token; die Preise je Modell stehen auf /models.
Verwandte Beiträge
Nutzungspakete
Einmalige Kontingente mit 7 Tagen Gültigkeit, ohne Abo; die Preise je Modell stehen auf /models.
magpie für Claude Code einrichten: lokales Gateway für Claude Code und Codex (2026-11)
magpie-Einrichtung: Installations- und Deinstallationsbefehle, drei Wege einen Anbieter hinzuzufügen, Modellwahl für Claude Code und Codex und die drei Adressen von QCode.
magpie WSL-Setup und magpie unter Windows (2026-11)
Wo Sie magpie mit WSL installieren: die Windows-App und magpie.exe, Agenten in WSL-Distributionen, Status der WSL-Issues und die drei QCode-Adressen.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Die Angaben auf dieser Seite wurden am 2026-11-10 mit der offiziellen Dokumentation, den Release Notes und den Repository-Issues von magpie abgeglichen; die offiziellen Seiten haben Vorrang. Fehlertexte und Menünamen ändern sich mit der Version, maßgeblich ist die bei Ihnen installierte. Welche Modelle QCode anbietet, steht auf /models.