Magpie einrichten

Diese Anleitung zeigt, wie Sie Aiberm in magpie als Anbieter hinzufügen. Sobald Sie es einmal hinzugefügt haben, können Claude Code, Codex, Gemini CLI, OpenCode und alle anderen von magpie unterstützten Agenten Modelle von Aiberm auswählen.

magpie ist ein Open-Source-Gateway, das auf Ihrem Rechner läuft (standardmäßig unter 127.0.0.1:3425). Es beherrscht die APIs von OpenAI, Anthropic und Gemini und übersetzt zwischen ihnen, einschließlich Streaming und Tool-Aufrufen. Die Agenten kommunizieren nur mit magpie. Ihr Aiberm-API-Schlüssel bleibt in magpie; in die Konfigurationsdateien der Agenten kommen stattdessen die Adresse des lokalen Gateways und ein lokales Token.

Voraussetzungen

• Ein Aiberm-Konto (Registrieren)
• Ein Aiberm-API-Schlüssel (Schlüssel erstellen)
• magpie 0.1.8 oder neuer (für Importlinks erforderlich)

Downloads für macOS, Windows und Linux finden Sie auf der Downloadseite. Unter macOS oder Linux können Sie auch im Terminal installieren:

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

Unter Linux installiert das Skript die Desktop-App, wenn GTK 3 und WebKitGTK 4.1 vorhanden sind, andernfalls die Terminal-Version. Wenn der Download GitHub nicht erreicht, geben Sie einen Proxy an: curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --proxy http://127.0.0.1:7890.

Aiberm-Endpunkte

Tragen Sie sowohl die Chat-URL als auch die Anthropic-URL ein. Die Anfragen von Claude Code gehen unverändert an die Anthropic-URL, und auch Anfragen anderer Agenten an Claude-Modelle schickt magpie dorthin. Alle anderen Anfragen gehen an die Chat-URL und werden übersetzt, wenn der Agent eine andere API spricht. Aiberm akzeptiert für seine Chat-Modelle beide Protokolle.

Lassen Sie die Responses-URL und die Gemini-URL leer. Der Responses-Endpunkt (/v1/responses) und der Gemini-Endpunkt (/v1beta) von Aiberm bedienen nicht jedes Modell; Claude-Modelle sind darüber zum Beispiel nicht verfügbar. Ohne diese URLs übersetzt magpie die Responses-Anfragen von Codex und die Anfragen von Gemini CLI selbst, sodass Codex und Gemini CLI jedes Aiberm-Modell nutzen können.

Option 1: Importlink (empfohlen)

Öffnen Sie auf einem Rechner, auf dem magpie installiert ist, den folgenden Link. magpie zeigt einen Bestätigungsdialog mit dem Namen des Anbieters, seinen Endpunkten und einem Feld für Ihren API-Schlüssel und weist Sie darauf hin, an welche Hosts Ihre Prompts und Ihr Schlüssel gesendet werden. Gespeichert wird erst, wenn Sie auf Hinzufügen klicken.

Zu magpie hinzufügen

Der Link enthält absichtlich keinen API-Schlüssel. Eine öffentliche Seite sollte nie ein Geheimnis enthalten; fügen Sie Ihren eigenen Schlüssel im Dialog ein. Der Schlüssel wird ausschließlich in ~/.config/magpie/providers.json auf Ihrem Rechner gespeichert und ist nur für Ihren Benutzer lesbar. Der Weblink trägt seine Parameter hinter #, und diesen Teil senden Browser nie an den Server.

Ohne Desktop (zum Beispiel über SSH) übergeben Sie dieselben Parameter an die Terminal-Version. Sie zeigt dieselbe Zusammenfassung und fragt vor dem Hinzufügen nach:

magpie import 'magpie://import?name=Aiberm&id=aiberm&chat=https%3A%2F%2Faiberm.com%2Fv1&anthropic=https%3A%2F%2Faiberm.com&website=https%3A%2F%2Faiberm.com&keys=https%3A%2F%2Faiberm.com%2Fconsole%2Ftoken'

Option 2: In der App hinzufügen

1. Öffnen Sie magpie, wechseln Sie zu Anbieter und klicken Sie auf ＋ Anbieter hinzufügen.
2. Wählen Sie Benutzerdefiniert (beliebige kompatible URL). magpie hat keine Vorlage für Aiberm.
3. Füllen Sie das Formular aus:

4. Speichern Sie. magpie ruft https://aiberm.com/v1/models ab und bietet die zurückgegebenen Modelle in der Modellauswahl jedes Agenten an. Vor dem Speichern können Sie mit Modelle abrufen festlegen, welche Modelle die Agenten sehen, und Modelle testen prüft den Schlüssel und die URLs.

Bleibt das Feld Modelle leer, stammt die Liste aus /v1/models, sodass Modelle, die Aiberm später hinzufügt, erscheinen, sobald Sie die Modelle erneut abrufen (oder magpie provider refresh aiberm ausführen). Die Liste enthält jedes Modell, das Ihr Schlüssel nutzen kann, darunter Bild-, Audio- und Embedding-Modelle, mit denen Coding-Agenten nichts anfangen können; wählen Sie nur die aus, die Sie brauchen. Geben Sie nur dann eine kommagetrennte Liste an, wenn die automatische Liste falsch ist. Modell-IDs finden Sie auf der Preisseite und in der Modellliste, zum Beispiel claude-sonnet-5-5, gpt-5.6-sol oder google/gemini-3.1-pro.

Ein Modell für jeden Agenten wählen

Öffnen Sie Agenten. Jede Zeile steht für einen Agenten, der auf diesem Rechner installiert oder konfiguriert ist. Klicken Sie auf das Modell und wählen Sie eines unter aiberm aus, oder geben Sie aiberm/ gefolgt von einer Modell-ID ein.

magpie claude aiberm/claude-sonnet-5-5
magpie codex aiberm/gpt-5.6-sol
magpie opencode aiberm/claude-sonnet-5-5
magpie gemini aiberm/google/gemini-3.1-pro

magpie ändert nur die Konfigurationsschlüssel, die es selbst verwaltet. Kommentare, Reihenfolge und Einrückung in der Agent-Konfiguration bleiben, wie sie sind. Eine bereits laufende Sitzung behält das Modell, mit dem sie gestartet wurde. Starten Sie eine neue Sitzung, damit die Änderung greift. Starten Sie bei Codex außerdem die Codex-App neu, da sie ihre Modellliste beim Start aufbaut.

Um zurückzuwechseln, wählen Sie eines der eigenen Modelle des Agenten oder führen Sie magpie claude default aus (ersetzen Sie claude durch den Namen des Agenten). magpie entfernt, was es geschrieben hat, und stellt die ersetzten Werte wieder her.

Wenn Sie einen Agenten bereits direkt mit Aiberm verbunden haben

Für magpie müssen Sie weder ANTHROPIC_BASE_URL noch OPENAI_BASE_URL exportieren; magpie schreibt die Gateway-Adresse in die Konfiguration des jeweiligen Agenten.

• Claude Code oder Codex in der eigenen Konfigurationsdatei eingerichtet (wie in Claude Code einrichten und Codex CLI einrichten): Es ist nichts zu tun. magpie ersetzt nur die Werte, die es braucht, und magpie <agent> default stellt Ihre Werte wieder her.
• Claude Code mit export, setx oder Windows-Benutzerumgebungsvariablen eingerichtet: Sie können sie beibehalten. Claude Code gibt den Werten in ~/.claude/settings.json Vorrang, sodass die Einstellungen von magpie gelten, solange Sie es nutzen. Nach magpie claude default greift Claude Code wieder auf Ihre Variablen zurück und kommuniziert direkt mit Aiberm.

Während der Nutzung

• magpie muss laufen. Nach dem Schließen des Fensters bleibt es in der Menüleiste bzw. im System-Tray. magpie tray startet nur das Symbol, magpie serve nur das Gateway. Damit es bei der Anmeldung ohne Fenster startet, führen Sie unter macOS oder Linux magpie daemon install aus, unter Windows magpie autostart on.

• Hinterlegen Sie den Schlüssel nur in magpie. magpie liest keine API-Schlüssel aus Ihrer Shell-Umgebung.

• Eine Proxy-App (Clash, Surge, mihomo und ähnliche Tools mit aktiviertem Systemproxy, TUN- oder Enhanced-Modus) kann Datenverkehr an 127.0.0.1:3425 abfangen. Wenn ein Agent 502 zurückgibt und die Anfrage nie im Tab Weiterleitung von magpie erscheint, fügen Sie vor Ihren übrigen Regeln Regeln hinzu, die lokale Adressen direkt verbinden:

  IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
  IP-CIDR6,::1/128,DIRECT,no-resolve

  In einer Clash- oder mihomo-Konfiguration setzen Sie dieselben Zeilen unter rules:, jeweils mit - am Anfang.

• Der Tab Nutzung zählt nur Aufrufe, die über das Gateway laufen. Aufrufe, die ein Agent direkt an Aiberm sendet, sind nicht enthalten. Sofern Sie für den Anbieter keine eigenen Preise oder keinen Preisfaktor festlegen, schätzt magpie die Kosten anhand der Listenpreise der Modellhersteller, die deutlich über dem liegen können, was Aiberm berechnet. Ihre tatsächliche Abrechnung finden Sie in der Aiberm-Konsole.

Optional: mehrere Schlüssel oder ein Fallback

Alle API-Schlüssel eines Aiberm-Kontos greifen auf dasselbe Guthaben zu. Ist das Guthaben aufgebraucht, schlagen alle Schlüssel dieses Kontos gleichzeitig fehl; weitere Schlüssel desselben Kontos sind also kein Fallback, wenn das Guthaben ausgeht. Mehrere Schlüssel helfen, wenn sie von verschiedenen Aiberm-Konten stammen oder wenn für einen Schlüssel in der Konsole ein eigenes Kontingentlimit festgelegt ist und der nächste Schlüssel übernehmen soll, sobald es aufgebraucht ist.

Um mehrere Schlüssel zu verwenden, fügen Sie sie in das Feld API-Schlüssel des Aiberm-Anbieters ein, getrennt durch Kommas, Leerzeichen oder Zeilenumbrüche. Der erste Schlüssel wird zuerst versucht. Wählen Sie dann, wie Anfragen verteilt werden:

magpie wechselt bei Fehlern wie 401, 403, 429 und 5xx zum nächsten Schlüssel, solange noch nichts an den Agenten gesendet wurde. „Am wenigsten genutzte zuerst“ und „Wochentempo“ sind vor allem für Abonnements gedacht; bei Schlüsseln vergleichen sie nur den jüngsten Token-Verbrauch. Alle Modi außer „Intelligent“ stammen aus dem integrierten magpie-Plugin rotation; wenn nur „Intelligent“ angeboten wird, aktivieren Sie dieses Plugin.

Üblicher ist ein Fallback über Anbieter hinweg: zuerst ein Abonnement und Aiberm, sobald es ausgeschöpft ist. Erstellen Sie im Tab Weiterleitung eine Gruppe mit dem Modell Ihres Abonnements an erster und dem Aiberm-Modell an zweiter Stelle, zum Beispiel ein Modell aus einem Claude-Abo gefolgt von aiberm/claude-sonnet-5-5, und stellen Sie den Agenten auf group/<id> ein. Wenn das erste Mitglied kein Kontingent mehr hat, durch ein Ratenlimit gedrosselt wird oder ausfällt, schickt magpie die Runde an das nächste Mitglied, bevor der Fehler den Agenten erreicht. magpie legt außerdem selbstständig group/auto-<model> an, wenn zwei Ihrer Anbieter dasselbe Modell bereitstellen.

Wiederherstellung und Fehlerbehebung

Weitere Fehlercodes finden Sie unter Fehlerbehandlung. Die eigene Dokumentation von magpie finden Sie unter Get started und Add to magpie.