magpie im Team teilen: Gateway-Key, LAN-Freigabe und Synchronisierung (November 2026)
Wie nutzen Sie magpie im Team oder auf mehreren Computern? Stand 2026-11-10 laut offizieller magpie-Referenz: Schalten Sie auf dem Computer, auf dem das Gateway läuft, Settings → Network and sharing → Share on local network ein und legen Sie für jede Kollegin, jeden Kollegen oder jeden Computer einen Gateway-Schlüssel an (magpie gateway-key add); jeder Schlüssel kann ein eigenes Limit und eine eigene Modellliste haben, und eine Anfrage von einem anderen Rechner ohne aktivierten Gateway-Schlüssel erhält 401. Läuft magpie auch auf dem anderen Computer, fügen Sie diesen Computer dort als Remote magpie hinzu. Für einen Umzug oder mehrere Computer im Gleichstand nutzen Sie magpie backup und magpie restore oder Settings → Sync and backup. Gateway-Schlüssel sind etwas anderes als die API-Schlüssel Ihrer Anbieter: Mit QCode braucht das Team einen einzigen QCode-Schlüssel, und der liegt auf dem Gateway-Computer.
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 Wege, ein magpie zu teilen
Einer pro Person, mit Limit und Modellliste
Schalten Sie Settings → Network and sharing → Share on local network ein und öffnen Sie dann Gateway → Gateway keys → Add gateway key. Im Terminal: magpie gateway-key add, list, limit und models. Gateway-Schlüssel sind von den API-Schlüsseln Ihrer Anbieter getrennt; diese bleiben nur auf dem Gateway-Computer.
Ein anderer Computer nutzt dieses Gateway
Läuft magpie auch auf dem anderen Computer, wählen Sie dort im Hinzufügen-Dialog Another computer's magpie und tragen die Adresse dieses Computers und einen Gateway-Schlüssel ein. Dessen eigenes magpie richtet weiter seine Agenten ein, Anbieter, Routing-Gruppen und Nutzung kommen vom geteilten.
Auf einem Server oder NAS
Das offizielle Image ist ghcr.io/yetone/magpie; 3425 ist das Gateway für Agenten, 3430 die Browser-Oberfläche, und MAGPIE_WEB_KEY hält den Oberflächen-Schlüssel über Neustarts hinweg gleich. Jede Anfrage von außerhalb des Containers, auch die des Hosts selbst, braucht einen aktivierten Gateway-Schlüssel.
Mit Passphrase versiegelt, der Server speichert nur Chiffretext
magpie backup schreibt ein mit Passphrase verschlüsseltes Backup, magpie restore spielt es auf einem anderen Computer zurück; Settings → Sync and backup nutzt WebDAV, S3 oder ein privates GitHub-Repository und bringt alle Rechner alle 3 Minuten auf denselben Stand, solange das Gateway läuft.
Was es heißt, magpie im Team zu teilen
Ihr Team bekommt Gateway-Schlüssel, nicht den API-Schlüssel Ihres Anbieters. Stand 2026-11-10 schreibt die offizielle magpie-Referenz, dass das Gateway für Clients Gateway-Schlüssel (gateway keys) ausgibt, getrennt von den API-Schlüsseln der Anbieter. Der Anbieter-Schlüssel (etwa Ihr QCode-Schlüssel cr_) liegt nur auf dem Computer, auf dem das Gateway läuft; Sie legen für jede Person oder jeden Computer einen benannten Gateway-Schlüssel an, und deren Tool richtet die Base URL auf die Adresse Ihres Gateways und nutzt diesen Gateway-Schlüssel als API-Schlüssel: Ein Anthropic-kompatibler Client nimmt die Adresse selbst, ein OpenAI-kompatibler Client hängt /v1 an (die Beispiele der offiziellen Docker-Seite sind http://192.168.1.20:3425 und http://192.168.1.20:3425/v1), Modell-IDs schreiben sich Anbieter/Modell. Anfragen über Loopback brauchen keinen Gateway-Schlüssel; mit eingeschalteter LAN-Freigabe müssen Anfragen anderer Rechner einen aktivierten Schlüssel mitsenden, und ein von Docker veröffentlichter Port sowie eine WSL-Distribution hinter NAT gelten ebenfalls als entfernt.
Gateway-Schlüssel: wo sie liegen und welche Befehle es gibt
Stand 2026-11-10 lautet der Pfad in der Referenz Settings → Network and sharing → Share on local network, erst danach erscheint Gateway → Gateway keys → Add gateway key; die Antwort des Autors in Issue #1496 sagt dasselbe: Mit eingeschalteter Freigabe zeigt die Gateway-Seite Gateway keys, und Add gateway key legt beliebig viele benannte Schlüssel an. Die Terminalbefehle laut offiziellem Text: magpie gateway-key add team-a legt einen an (der neue Schlüssel wird einmal ausgegeben), magpie gateway-key list zeigt IDs, Namen, Aktivstatus und maskierte Schlüssel, magpie gateway-key limit team-a week --tokens 2m --cost 5 setzt ein Wochenlimit, und magpie gateway-key models team-a qcode/* erlaubt nur die Modelle des Anbieters qcode (ein Muster ist Anbieter/Modell oder Anbieter/*, all steht für alle Modelle). Wer einen Schlüssel hat, öffnet im Browser die Adresse, über die er das Gateway erreicht, mit angehängtem /me, gibt seinen Schlüssel ein und sieht seine Limits, seine Nutzung von heute und der letzten 7 und 30 Tage, die erlaubten Modelle und eine fertige Einrichtung für Claude Code und Codex.
Zeitleiste
Issue #28 (alle Einstellungen per WebDAV synchronisieren): Der Autor antwortete, dass der erste Schritt in v0.1.28 erschienen ist, ein verschlüsseltes Backup und Restore mit magpie backup und magpie restore.
Issue #28 geschlossen: Laut Autor bekam v0.1.76 in den Einstellungen den Bereich Sync and backup mit WebDAV-Sync, und weitere Computer treten mit derselben Passphrase bei.
Issue #1496 (mehrere API-Schlüssel am Gateway, Token-Nutzung pro Schlüssel) geschlossen: Der Autor antwortete, dass genau das die Gateway-Schlüssel leisten, mit Limit und Modellliste pro Schlüssel und Nutzung pro Schlüssel summiert.
Was offiziell dokumentiert ist und was noch offen ist
In der offiziellen Doku festgehalten
1. Eine entfernte Anfrage sendet einen aktivierten Gateway-Schlüssel als Bearer, x-api-key, x-goog-api-key oder ?key=; über Loopback geht jedes Token. 2. Ein Limit zählt Tokens, geschätzte Kosten in US$ oder beides, pro Tag, Woche oder Monat oder alle N Tage bzw. N Stunden; ein Schlüssel kann bis zu fünf Limits haben, ist eines aufgebraucht, erhalten die Anfragen dieses Schlüssels 429, andere Schlüssel bleiben unberührt; die Kosten sind eine Schätzung zu den Preisen der Usage-Seite, und Anfragen von diesem Computer ohne Gateway-Schlüssel werden nicht begrenzt. 3. Jeder Schlüssel lässt sich einzeln umbenennen, deaktivieren, rotieren oder entfernen, und Entfernen widerruft den Fernzugriff; beim Rotieren bleiben Name, Aktivstatus, Limits und Nutzungsverlauf erhalten. 4. Ein Backup wird auf Ihrem Rechner verschlüsselt (AES-256-GCM, der Schlüssel per PBKDF2-SHA256 aus der Passphrase abgeleitet), ohne Passphrase ist nichts darin lesbar; eine mit magpie backup --no-keys erstellte Datei enthält keine API-Schlüssel, und beim Wiederherstellen bleiben die Gateway-Schlüssel auf dem Zielrechner erhalten. 5. Der Sync läuft alle 3 Minuten, solange das Gateway läuft, der Server speichert nur Chiffretext, und der GitHub-Sync verlangt ein privates Repository. 6. Setzen Sie ein synchronisiertes Agentenmodell auf einem Computer zurück, behält dieser Computer seinen eigenen Wert: Settings → Sync führt ihn unter Kept on this computer, und Follow the others übernimmt wieder den synchronisierten Wert.
Auf GitHub noch offen
Stand 2026-11-10 ist Issue #2269 weiter offen. Sein Titel besagt, dass eine nicht lesbare settings.json als Standardwerte in Backup und Sync gelangt und die Einstellungen jedes anderen Rechners überschreibt, auf dem sie zurückgespielt wird. Am 2026-10-15 antwortete der Autor, dass es behoben ist: Mit der Korrektur stoppen Backup, GUI-Export und Sync bei einer nicht lesbaren settings.json mit einem Fehler, nichts wird versiegelt oder hochgeladen, und der Sync-Status zeigt den Fehler; die Korrektur erscheint im nächsten Release, bis dahin bleibt das Issue offen. Der Autor schrieb außerdem, dass eine von einem anderen Windows-Programm offen gehaltene settings.json sowie ein echter WebDAV-, S3- oder GitHub-Server noch nicht getestet wurden.
Direkt ans Gateway oder magpie auf beiden Computern
Das Tool ruft dieses Gateway direkt auf
Passt, wenn eine Person nur Claude Code, Codex oder ein anderes Tool mit Base-URL-Feld braucht. Geben Sie ihr einen Gateway-Schlüssel: Ein Anthropic-kompatibler Client nimmt die Gateway-Adresse selbst, ein OpenAI-kompatibler Client hängt /v1 an, Modell-IDs lauten Anbieter/Modell, und GET /v1/models listet sie. Jeder Schlüssel hat eigenes Limit und eigene Modellliste, die Nutzung wird pro Schlüssel gezählt.
Auf dem anderen Computer läuft auch magpie
Fügen Sie das geteilte als Remote magpie hinzu; das Beispiel der Referenz ist magpie provider add remote-magpie sk-magpie-… url=http://192.168.1.20:3425 id=office, wobei sk-magpie-… durch einen angelegten Gateway-Schlüssel und die Adresse durch Ihre ersetzt wird. magpie auf jenem Computer schreibt weiter die Konfiguration seiner eigenen Agenten, Anbieter, Routing-Gruppen (office/group/…) und Nutzung kommen vom geteilten; die Limits, die das geteilte magpie diesem Schlüssel setzt, erscheinen auch auf der Usage-Seite des anderen Computers.
Für ein Team oder mehrere Computer: fünf Schritte
1. Installieren Sie magpie auf dem Computer, auf dem das Gateway laufen soll, und fügen Sie QCode hinzu (die drei Adressen und der Importlink stehen auf /magpie-claude-code-guide). 2. Schalten Sie Settings → Network and sharing → Share on local network ein und legen Sie unter Gateway → Gateway keys pro Person einen Schlüssel an; im Terminal: magpie gateway-key add team-a, magpie gateway-key limit team-a week --tokens 2m --cost 5 und magpie gateway-key models team-a qcode/* (qcode ist die Anbieter-ID, die magpie QCode beim Hinzufügen gibt). 3. Ihr Team trägt im eigenen Tool die LAN-Adresse Ihres Computers ein (offizielles Beispiel http://192.168.1.20:3425, für OpenAI-kompatible Clients mit /v1) und den Gateway-Schlüssel als API-Schlüssel; wer selbst magpie nutzt, nimmt stattdessen die Remote-magpie-Variante oben. 4. Umzug oder Sicherung: magpie backup (fragt zweimal nach der Passphrase), dann magpie restore magpie.magpie-backup auf dem neuen Computer; ohne API-Schlüssel mit magpie backup --no-keys ~/b.magpie-backup. Mehrere Computer halten Sie mit Settings → Sync and backup auf demselben Stand. 5. Für einen Server siehe die Docker-Frage unten; Windows und WSL stehen auf /magpie-wsl-windows-setup, Fehler auf /magpie-errors-and-fixes, der Wechsel von CC Switch auf /magpie-migrate-from-cc-switch.
Das Team braucht einen QCode-Schlüssel, auf dem Gateway-Computer
Stand 2026-11-10 nennt der QCode-Artikel zu magpie drei Adressen: anthropic ist https://api.qcode.cc/api, chat ist https://api.qcode.cc/openai/v1, responses ist https://api.qcode.cc/openai; ein Klick auf „In magpie importieren“ in der Konsole richtet Claude und GPT gemeinsam ein. Ein QCode-API-Schlüssel bedient beide kompatiblen Schnittstellen, Anthropic und OpenAI, abgerechnet pro Token, die Preise je Modell stehen auf /models. Im Team: Der QCode-Schlüssel bleibt in magpie, Ihr Team bekommt Gateway-Schlüssel, nicht den QCode-Schlüssel; das ganze Team teilt sich über das Gateway das Limit und die parallelen Anfragen dieses Schlüssels (ein Key im Privatplan erlaubt 5, bei Ultimate 10), und die Nutzung sehen Sie in der Nutzungsstatistik der QCode-Konsole. Wenn Sie Kontingent und Nutzung pro Person steuern wollen, nutzen Sie den Team-Tarif mit einem Sub-Key pro Mitglied, jeweils mit eigenem Kontingent; siehe /claude-code-team-shared-keys. 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
Wie lasse ich Kollegen magpie mitnutzen?
Schalten Sie auf Ihrem Computer Settings → Network and sharing → Share on local network ein, legen Sie einen Gateway-Schlüssel für die Person an (magpie gateway-key add mit einem Namen) und lassen Sie deren Tool die Base URL auf die LAN-Adresse Ihres Gateways richten, mit diesem Gateway-Schlüssel als API-Schlüssel. Ihr Anbieter-Schlüssel bleibt in magpie und wird nicht weitergegeben. Nutzt die Person selbst magpie, fügt sie Ihres als Remote magpie hinzu. Installation und das Hinzufügen von QCode stehen auf /magpie-claude-code-guide.
Kann magpie die Nutzung jeder Person begrenzen?
Ja. Jeder Gateway-Schlüssel kann ein eigenes Limit haben: Tokens, geschätzte Kosten oder beides, pro Tag, Woche oder Monat oder alle N Tage bzw. N Stunden, bis zu fünf Limits, dazu eine Auswahl erlaubter Modelle; ist es aufgebraucht, erhält dieser Schlüssel 429, alle anderen arbeiten weiter. In Issue #1496 erklärt der Autor, dass die Nutzung pro Schlüssel gezählt wird: Usage → Overview → Gateway keys summiert Tokens und Kosten je Schlüssel, Usage → Requests filtert nach Schlüssel, und die exportierte CSV hat die Spalten caller_key_id und caller_key_name. Ihr Team sieht eigene Limits und Nutzung, indem es die Gateway-Adresse mit /me öffnet und den eigenen Schlüssel eingibt.
Wie synchronisiere ich magpie-Einstellungen zwischen Computern?
Auf zwei Wegen. Einmalig: magpie backup schreibt ein mit Passphrase verschlüsseltes Backup, magpie restore magpie.magpie-backup spielt es auf dem anderen Computer zurück. Laufend: Settings → Sync and backup mit WebDAV, S3 oder einem privaten GitHub-Repository bringt jeden Rechner alle 3 Minuten auf Stand, solange das Gateway läuft, und der Server speichert nur Chiffretext; in Issue #28 schrieb der Autor, dass der WebDAV-Sync mit v0.1.76 kam und weitere Computer mit derselben Passphrase beitreten. Das Sync-Issue #2269 ist Stand 2026-11-10 noch offen, der Autor hat geantwortet, dass die Korrektur im nächsten Release erscheint; siehe oben.
magpie im LAN oder aus der Ferne liefert 401 – was tun?
Senden Sie einen aktivierten Gateway-Schlüssel mit. Ist die LAN-Freigabe an (oder das Gateway im Netz), brauchen Anfragen anderer Rechner einen aktivierten Gateway-Schlüssel, sonst kommt 401; über Loopback ist keiner nötig. Legen Sie mit magpie gateway-key add einen Schlüssel für die Person oder den Computer an und tragen Sie ihn in deren Tool als API-Schlüssel ein; läuft magpie in Docker, stellen Sie docker exec magpie voran. Den genauen 401-Text und weitere Fehler finden Sie auf /magpie-errors-and-fixes.
Bekommt beim Teilen jeder den API-Schlüssel?
Jeder bekommt einen Gateway-Schlüssel. Der API-Schlüssel Ihres Anbieters (etwa der QCode-Schlüssel cr_) liegt nur auf dem Computer, auf dem das Gateway läuft; ein Gateway-Schlüssel lässt sich jederzeit deaktivieren, rotieren oder entfernen, Entfernen widerruft seinen Fernzugriff, und beim Rotieren bleiben Name, Limits und Nutzungsverlauf erhalten. Wenn Sie auch bei QCode Schlüssel und Kontingent pro Person trennen wollen, siehe /claude-code-team-shared-keys: Im Team-Tarif hat jedes Mitglied einen eigenen Sub-Key mit eigenem Kontingent.
Kann ich magpie auf einem Server installieren?
Ja. Das offizielle Docker-Image ist ghcr.io/yetone/magpie (linux/amd64 und linux/arm64): 3425 ist das Gateway, 3430 die Browser-Oberfläche, und die Umgebungsvariable MAGPIE_WEB_KEY hält den Oberflächen-Schlüssel über Neustarts gleich; Schlüssel pro Client legen Sie unter Gateway → Gateway keys in der Browser-Oberfläche oder mit docker exec magpie magpie gateway-key add "Docker client" an. Im Container ist keine LAN-Freigabe nötig, und jede Anfrage von außerhalb braucht einen aktivierten Gateway-Schlüssel. Ohne Container richtet magpie daemon install den Befehl magpie serve als Hintergrunddienst ein (unter Linux ein systemd-Benutzerdienst, unter macOS launchd); unter Windows öffnet magpie autostart on magpie bei der Anmeldung, und es stellt das Gateway bereit.
Quellen
Gelesen am 2026-11-10: docs/reference.md in yetone/magpie auf GitHub (Abschnitte zu Gateway-Schlüsseln, Remote magpie, Backup und Sync sowie Hintergrunddienst); die Docker-Seite auf usemagpie.ai; die Antworten des Autors yetone in den Issues #28 (geschlossen am 2026-09-25), #1496 (geschlossen am 2026-10-12) und #2269 (offen). QCode: der magpie-Artikel, die Endpunktseite, der Button „In magpie importieren“ in der Konsole, der Leitfaden zu geteilten Team-Keys und der Test der magpie-Terminalversion am 2026-11-10. Modell-IDs richten sich nach /models.
Ein QCode-Schlüssel, ein Gateway-Schlüssel pro Person
Legen Sie den QCode-Schlüssel in das magpie auf dem Gateway-Computer und geben Sie Ihrem Team eigene Gateway-Schlüssel; ein Schlüssel bedient die Anthropic- und die OpenAI-kompatible Schnittstelle, abgerechnet pro Token, die Preise je Modell stehen auf /models.
Weiterlesen
Nutzungspakete
Einmaliges Kontingent für 7 Tage ohne Abo; weitere Pakete landen auf demselben Key
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.
Claude Code: geteilte Keys im Team
Ein Sub-API-Key pro Person, Tageskontingent pro Key, Nutzung per qot_, Offboarding und Vergleich mit Anthropic-Team-Plätzen, Claude Code und monatlichen API-Guthaben. Geprüft am 2026-10-27.
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 anhand der magpie-Referenz, der Docker-Seite und der zugehörigen Issues geprüft; die offiziellen Seiten haben Vorrang. Geprüfte Version: Der QCode-Test am 2026-11-10 lief mit magpie 0.1.3533; magpie veröffentlicht mehrmals täglich, daher richten sich Menünamen und Befehle nach der installierten Version. Die Verfügbarkeit der QCode-Modelle richtet sich nach /models.