magpie für Claude Code einrichten: lokales Gateway installieren und Modelle wählen (November 2026)
Stand 2026-11-10 beschreibt die offizielle magpie-Dokumentation (usemagpie.ai) die Einrichtung für Claude Code in drei Schritten: Führen Sie den Installationsbefehl aus und starten Sie magpie; fügen Sie unter Providers einen Anbieter mit Ihrem eigenen API-Schlüssel hinzu; führen Sie dann magpie claude mit einem Namen der Form Anbieter/Modell aus – das Modell gilt ab der nächsten Sitzung (für Codex: magpie codex und die Codex-App neu starten). magpie (yetone/magpie) ist ein lokales Gateway auf Ihrem Computer unter 127.0.0.1:3425, das zwischen OpenAI Chat, OpenAI Responses, Anthropic Messages und Gemini übersetzt; es steht unter der MIT-Lizenz und ist nicht mit Apache Magpie verbunden. Die drei QCode-Adressen und Befehle finden Sie unten.
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
Vier Punkte aus den offiziellen Quellen
Open Source unter der MIT-Lizenz, von yetone
Das Repository yetone/magpie verwendet die MIT-Lizenz (Copyright (c) 2026 yetone). Das README schließt mit: magpie ist weder mit Apache Magpie noch mit der Apache Software Foundation verbunden.
Die Adresse des lokalen Gateways
Das Gateway spricht OpenAI Chat, OpenAI Responses, Anthropic Messages und Gemini und übersetzt dazwischen, einschließlich Streaming, Tool-Aufrufen und Reasoning.
Plattformen und Varianten
Laut README läuft es auf macOS, Windows und Linux (Menüleisten-App, Fenster, TUI, Web-UI und CLI), in Docker und auf Termux.
Wo Ihre Schlüssel liegen
Schlüssel liegen in ~/.config/magpie/providers.json und sind nur für Sie lesbar. magpie liest Schlüssel nie aus Ihrer Shell-Umgebung: Was Sie hinzufügen, wird verwendet.
Was ist magpie?
Stand 2026-11-10 beschreibt die Dokumentation magpie als einen Ort, an dem Sie das Modell für jeden Ihrer Agenten wählen. Sie fügen die Anbieter hinzu, die Sie haben, wählen pro Agent ein Modell, und magpie schreibt es in die eigene Konfigurationsdatei dieses Agenten. Dahinter steht ein kleines Gateway auf Ihrem Rechner unter 127.0.0.1:3425, das die APIs von OpenAI, Anthropic und Gemini spricht und zwischen ihnen übersetzt, sodass auch ein Agent wie Claude Code, der nur Anthropic Messages spricht, GPT oder chinesische Modelle nutzen kann. Der Autor ist yetone, die Website ist usemagpie.ai und das Repository ist yetone/magpie.
Installations- und Deinstallationsbefehle
Stand 2026-11-10 lautet der offizielle Installationsbefehl curl -fsSL https://usemagpie.ai/install.sh | sh. Er legt den magpie-Befehl in ~/.local/bin ab und die App unter /Applications auf dem Mac bzw. im App-Menü unter Linux; go install github.com/yetone/magpie@latest funktioniert ebenfalls. Unter Windows laden Sie aus dem neuesten Release magpie-windows-amd64.exe herunter (für ARM magpie-windows-arm64.exe); magpie.exe nimmt dieselben Befehle an, und magpie-cli-windows-amd64.exe ist der reine Terminal-Build. Außerdem gibt es ein Docker-Image, ghcr.io/yetone/magpie; Details stehen in der offiziellen Docker-Dokumentation. Zum Deinstallieren führen Sie curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall aus: magpie trennt zuerst jeden Agenten und stellt dessen vorherige Einstellungen wieder her; Ihre Einstellungen und Anbieter in ~/.config/magpie bleiben erhalten, und --purge löscht auch diese.
Zeitleiste
Das Repository yetone/magpie wird auf GitHub erstellt.
Die QCode-Dokumentation schließt den Test von magpie mit Claude Code und Codex ab und veröffentlicht den magpie-Einrichtungsartikel auf docs.qcode.cc.
QCode hat mit dem Terminal-Build von magpie dieses Tages erneut getestet: Ein einziger magpie provider add-Befehl hat QCode hinzugefügt, und provider test bekam von allen drei Adressen eine Antwort. Am selben Tag geprüft: das README, die offizielle Dokumentation (Get started, Add to magpie, Docker sowie die Modellseiten von Claude Code und Codex), das Referenzhandbuch und die GitHub-Releases; laut Dokumentation erscheint magpie mehrmals täglich.
Was die Dokumentation festhält und was offenbleibt
In der offiziellen Dokumentation festgehalten
① Bei einem Modell über magpie läuft das Gateway mit der App. ② Eine laufende Sitzung behält das Modell, mit dem sie gestartet ist; Agenten lesen ihre Konfiguration beim Start, daher gilt ein neues Modell ab der nächsten Sitzung, und Codex muss zusätzlich neu gestartet werden. ③ Die Modellwahl ändert in der Konfiguration des Agenten nur die Schlüssel, die magpie braucht; Kommentare, Reihenfolge und Einrückung bleiben erhalten, und Schreibvorgänge sind atomar. ④ Claude Code: magpie schreibt ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN in ~/.claude/settings.json, und das Token ist der Schlüssel des Gateways, nicht Ihr Anbieter-Schlüssel; Codex: eine [model_providers.magpie]-Tabelle und das Modell in ~/.codex/config.toml. ⑤ OPENAI_BASE_URL oder ANTHROPIC_BASE_URL müssen Sie nicht selbst exportieren. ⑥ Ein Import-Link speichert nichts, bevor Sie auf Add klicken, und ist die id schon vergeben, heißt der Button Replace. ⑦ magpies Modelle erscheinen auch in den /model-Listen von Claude Code und Codex selbst (in Claude Code mit dem Vermerk via magpie), sodass Sie auch direkt im Agenten wechseln können.
Was die Dokumentation offenlässt
Stand 2026-11-10: ① Die offizielle Startseite nennt die Mindestversion von macOS auf zwei Arten (macOS 12+ und macOS 11 or later); maßgeblich ist die Anforderung, die beim Download angezeigt wird. ② Die Liste unterstützter Agenten im README ist länger als die in Get started und wächst weiter; ob Ihr Agent erkannt wird, zeigt die Ausgabe von magpie ls. ③ Die offizielle Import-Seite schreibt, dass magpie ohne den Parameter models die Modelle auflistet, die /v1/models des Anbieters liefert; in QCodes Test vom 2026-11-10 gab ein ohne models= hinzugefügter Anbieter nur die ersten 24 frei (Ausgabe: 24 exposed of 28). Wählen Sie die benötigten Modelle daher nach dem Hinzufügen mit magpie provider models aus.
Drei Wege, einen Anbieter hinzuzufügen
Import-Link oder die App
Ein Import-Link ist magpie://import? plus Parameter; im Web verwenden Sie https://usemagpie.ai/import# mit denselben Parametern, jeder Wert URL-kodiert. Zu den Feldern gehören name (oder preset), chat, responses, anthropic, gemini, key und models. Enthält der Link keinen key, fügen Sie ihn im Dialog ein. In der App ist der Einstieg Providers → Add provider.
Ein Befehl im Terminal
Für ein Preset genügt magpie provider add mit der Preset-id und dem Schlüssel (offizielles Beispiel: deepseek und sk-…); eine eigene Adresse nimmt url= (OpenAI-kompatibel), anthropic= (Anthropic-kompatibel), responses=, models= und key=. Im Terminal zeigt magpie import mit einem Link zuerst eine Zusammenfassung und fragt nach, -y überspringt die Frage; laut Test in der QCode-Dokumentation wird ein Link ohne Schlüssel im Terminal nur angezeigt, nicht gespeichert, daher ist magpie provider add dort der schnellste Weg.
magpie einrichten: installieren, Anbieter hinzufügen, Modell für Claude Code und Codex wählen
① Installieren: Unter macOS und Linux führen Sie curl -fsSL https://usemagpie.ai/install.sh | sh aus, unter Windows laden Sie magpie-windows-amd64.exe herunter; starten Sie danach magpie, damit das Gateway läuft. ② Anbieter hinzufügen: Klicken Sie im Tab Providers auf ＋ Add provider, fügen Sie bei einem Preset nur den Schlüssel ein oder wählen Sie für jede andere Adresse Custom · any compatible URL; wie das im Terminal geht, zeigt die Karte oben, den vollständigen QCode-Befehl finden Sie weiter unten. ③ Modell wählen: Klicken Sie im Tab Agents auf das Modell des Agenten oder führen Sie magpie claude deepseek/deepseek-v4-pro bzw. magpie codex deepseek/deepseek-v4-pro aus; Modelle über magpie heißen Anbieter/Modell. ④ Starten Sie eine neue Sitzung, damit der Agent die neue Konfiguration liest; Codex muss zusätzlich neu gestartet werden. ⑤ Prüfen: magpie ls listet die aktuellen Einstellungen jedes Agenten, und magpie provider test mit einer Anbieter-id sendet pro API eine winzige Anfrage und zeigt die Latenz. ⑥ Zurück zur eigenen Einrichtung des Agenten: magpie claude default oder magpie codex default.
QCode zu magpie hinzufügen
Stand 2026-11-10 nennt der magpie-Artikel von QCode drei Adressen: anthropic ist https://api.qcode.cc/api, chat ist https://api.qcode.cc/openai/v1 und responses ist https://api.qcode.cc/openai (in den magpie-Beispielen endet responses auf /v1; die Endpunkt-Seite von QCode hält fest, dass /openai/responses und /openai/v1/responses gleichwertig sind). Claude läuft über die anthropic-Adresse, GPT über chat und responses, chinesische Modelle über anthropic oder chat; für die Zugangspunkte in Asien und Nordamerika ersetzen Sie die Domain durch asia.qcode.cc oder us.qcode.cc, die Pfade bleiben gleich. Am einfachsten ist der Konsolen-Button „In CC Switch / magpie importieren“: Klicken Sie dort auf „In magpie importieren“, dann sind Claude und GPT in einem Schritt eingerichtet; danach wählen Sie Modelle mit magpie claude qcode/claude-sonnet-5-5 oder magpie codex qcode/gpt-6.1-sol. Wird nur das Hauptmodell gesetzt, nutzt auch der Opus-Slot von Claude Code dieses Modell; für Opus dort führen Sie zusätzlich magpie claude opus qcode/claude-opus-5-5 aus. QCode-Schlüssel sind protokollunabhängig: Ein Schlüssel bedient die Anthropic- und die OpenAI-kompatible Schnittstelle für Claude Code, Codex und andere Tools, abgerechnet pro Token; die Preise je Modell stehen auf /models. Kein Monatsplan? «Nutzungspakete» starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Pack dazu.
Häufige Fragen
Warum greift der Wechsel in magpie nicht?
Wahrscheinlich wurde die Sitzung nicht neu gestartet: Eine laufende Sitzung behält das Modell, mit dem sie gestartet ist, das neue Modell gilt ab der nächsten Sitzung, und Codex muss zusätzlich neu gestartet werden. Prüfen Sie dann, ob das Gateway läuft: Bei einem Modell über magpie läuft es mit der App, und magpie healthcheck endet mit Code 0, solange das Gateway antwortet. magpie ls zeigt die aktuellen Einstellungen jedes Agenten, magpie provider test prüft, ob ein Anbieter antwortet; weitere Fehler behandelt /magpie-errors-and-fixes.
Muss magpie dauerhaft offen bleiben?
Bei einem Modell über magpie, ja: Das Gateway läuft mit der App. Nach dem Schließen des Fensters läuft es in der Menüleiste oder im Tray weiter; magpie tray startet nur das Symbol, magpie serve nur das Gateway, und magpie daemon install lässt es als Dienst laufen (systemd unter Linux, launchd auf dem Mac). Ein Agent mit seinem eigenen Modell läuft nicht über magpie.
Wo speichert magpie meinen Schlüssel, und ist das sicher?
Schlüssel liegen in ~/.config/magpie/providers.json und sind nur für Sie lesbar; aus Ihrer Shell-Umgebung liest magpie keine Schlüssel. Laut Dokumentation sehen Agenten Ihre Schlüssel nie: Das ANTHROPIC_AUTH_TOKEN in der Konfiguration von Claude Code ist der Schlüssel des Gateways. Ein Web-Import-Link trägt seine Parameter nach dem #, und diesen Teil senden Browser nicht an einen Server. Dazu gibt es die Privatsphäre-Maskierung: Ist sie eingeschaltet, werden Schlüssel, Passwörter und E-Mail-Adressen im Prompt auf Ihrem Computer durch Platzhalter ersetzt, bevor die Anfrage ihn verlässt, und in der Antwort wieder eingesetzt; sie ist standardmäßig aus und wird unter Settings → Privacy eingeschaltet.
Wie deinstalliere ich magpie oder stelle meine ursprüngliche Konfiguration wieder her?
Zum Wiederherstellen führen Sie magpie claude default oder magpie codex default aus; magpie entfernt, was es geschrieben hat, und stellt die ersetzten Werte wieder her, etwa eine zuvor vorhandene ANTHROPIC_BASE_URL. Zum Deinstallieren einer Skript-Installation führen Sie curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall aus; Ihre Einstellungen und Anbieter bleiben in ~/.config/magpie erhalten, und --purge löscht auch diese.
Können magpie und CC Switch zusammen genutzt werden?
Ja, beide lassen sich parallel installieren: magpies Autor yetone antwortete am 2026-11-09 auf X, dass man beide zusammen nutzen kann, und das README hält fest, dass magpies Import die Anbieter aus CC Switch übernimmt. Beide Tools schreiben die Konfigurationsdateien von Claude Code und Codex; wie sie sich die Arbeit teilen und auf welche Einstellungen Sie beim gemeinsamen Einsatz achten sollten, steht auf der Vergleichsseite /magpie-vs-cc-switch.
Wie füge ich QCode zu magpie hinzu?
Sie haben drei Wege. Am schnellsten ist der Konsolen-Button „In magpie importieren“; im Terminal führen Sie 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 aus, das in QCodes Test vom 2026-11-10 QCode auf Anhieb hinzugefügt hat; in der App wählen Sie unter Providers → Add provider die Option Custom und tragen die OpenAI-kompatible Adresse (chat), die Anthropic-kompatible Adresse (anthropic) und Ihren cr_-Schlüssel ein. Ohne models= gibt magpie nur die ersten 24 Modelle frei; wählen Sie die benötigten daher mit magpie provider models qcode gpt-6.1-sol claude-sonnet-5-5 claude-opus-5-5 claude-haiku-5-5 aus (ohne + wird die Liste komplett ersetzt). Steht ein GPT-Modell an erster Stelle, zeigt magpie provider test in allen drei Zeilen – chat, responses und anthropic – ein ✓. Um den Schlüssel eines gespeicherten QCode-Anbieters zu ersetzen, führen Sie magpie provider key mit qcode und dem neuen Schlüssel aus.
Quellen
README, LICENSE und Referenzhandbuch des Repositorys yetone/magpie auf GitHub, die GitHub-API, die Release-Informationen von magpie-releases, die Startseite usemagpie.ai sowie die offizielle Dokumentation (Get started, Add to magpie, Docker und die Modellseiten von Claude Code und Codex), alle am 2026-11-10 gelesen; die Antwort von magpie-Autor yetone auf X vom 2026-11-09. QCode: der magpie-Artikel und die Seite zu den Zugangspunkten auf docs.qcode.cc, qcode.cc/models und qcode.cc/pay-as-you-go (abgerufen am 2026-11-10) sowie QCodes Test mit dem Terminal-Build von magpie am 2026-11-10; die Beschriftung des Konsolen-Import-Buttons stammt aus den Seitentexten von QCode.
Claude und GPT in magpie mit einem Schlüssel
Ein QCode-API-Schlüssel für Claude Code, Codex und mehr, 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 oder CC Switch: Was passt zu Ihnen?
Unterschiede bei Funktionsweise, Clients, Protokollübersetzung, Failover, Privacy-Maskierung und Lizenz sowie die QCode-Verbindung beider.
magpie funktioniert nicht: 401- und 405-Fehler beheben (2026-11)
Offizielle Ursache und Lösung häufiger magpie-Fehler: ein Wechsel, der nicht greift, 401 in Docker, ZCode 405, der 400 im provider test und fehlende Modelle.
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 dem magpie-Repository, der Website und der Dokumentation abgeglichen; die offiziellen Seiten haben Vorrang. Geprüfte Version: QCodes Test vom 2026-11-10 lief mit magpie 0.1.3533; magpie erscheint mehrmals täglich, daher richten sich Menünamen und Befehle nach der installierten Version. Welche Modelle QCode anbietet, steht auf /models.