Magpie

Erstellen Sie einen eigenen Standard-API-Schlüssel gemäß dem Authentifizierungsleitfaden. Kopieren Sie eine Modell-ID und das unterstützte Protokoll aus dem Modellkatalog. Sichern Sie Ihre Agentenkonfiguration, bevor Sie den Anbieter wechseln.

Verwenden Sie diesen Weg für Modelle, die Chat Completions unterstützen. Ersetzen Sie vor dem Ausführen des Befehls beide Platzhalter. Die Basis-URL url= endet auf /v1; Magpie hängt /chat/completions an.

Verwenden Sie diesen Weg für Modelle, die Anthropic Messages unterstützen. Die Basis-URL anthropic= enthält kein /v1; Magpie hängt /v1/messages an.

Wählen Sie zunächst einen Weg. Magpie lehnt einen zweiten Anbieter mit demselben Schlüssel ab. Um beide Anbieter zu behalten, erstellen Sie für jeden einen eigenen RunAPI-Schlüssel. Bewahren Sie die RunAPI-Schlüssel in Magpie und außerhalb Ihrer Repositorys auf.

Starten Sie Magpie und lassen Sie das Gateway laufen. Wählen Sie auf der Seite Agents Claude Code oder Codex und anschließend das Modell unter Ihrem RunAPI-Anbieter aus. Die CLI bietet dieselbe Auswahl. Führen Sie einen Befehl mit dem gewählten Anbieter und der Modell-ID aus.

Wählen Sie das Modell in einem anderen Terminal aus.

Ersetzen Sie für den Anthropic-Weg runapi-chat durch runapi-anthropic. Magpie verwendet lokal provider/model und leitet die ursprüngliche Modell-ID an RunAPI weiter. Der Agent verbindet sich unter 127.0.0.1:3425 mit Magpie und benötigt keinen RunAPI-Schlüssel. Codex verwendet die lokale Responses-Schnittstelle; daraus folgt nicht, dass RunAPI eine Responses-Anfrage erhält. Diese Anbieteroptionen wählen auf RunAPI-Seite Chat Completions oder Messages aus.

Prüfen Sie mit diesen Befehlen den Anbieter und das ausgewählte Modell. Starten Sie dann eine neue Agentensitzung und senden Sie einen kurzen Prompt.

Bestätigen Sie das erwartete Modell und die Anfrage in den RunAPI-Nutzungsprotokollen. Eine erfolgreiche Antwort des Agenten allein zeigt nicht, welcher Anbieter sie verarbeitet hat. Die Magpie-Funktionen Test models, Detect APIs und der Anbietertest können Inferenzanfragen senden.

Die Konfiguration und die lokalen Routen wurden mit Magpie 0.1.1307 und Claude Code 2.1.295 unter Linux geprüft. Beide Anbieteroptionen lieferten eine feste Antwort einer lokalen Fixture. Echte RunAPI-Inferenz und Codex-Inferenz wurden für diesen Leitfaden nicht getestet. Prüfen Sie das Protokoll und die Werkzeugunterstützung des ausgewählten Modells, bevor Sie es für Agentenaufgaben einsetzen.

Wenn Magpie meldet, dass bereits ein Anbieter mit diesem Schlüssel hinzugefügt wurde, verwenden Sie diesen Anbieter erneut oder einen anderen eigenen Schlüssel für den zweiten Weg. Dieser Fehler wurde lokal reproduziert.

Ein lokaler Fixture-Lauf reproduzierte no model list mit connection refused, als der konfigurierte Server gestoppt war. Prüfen Sie die Adresse und die Erreichbarkeit des Servers und verwenden Sie dann models= mit der genauen Modell-ID. Lassen Sie Magpie laufen, während Agenten sein lokales Gateway verwenden.

Claude Code meldete für die Fixture-IDs unrecognized_model, lieferte aber trotzdem die Fixture-Antwort. Prüfen Sie bei dieser Warnung die ursprüngliche Modell-ID und die Modellkonfiguration von Claude Code. Die Fixture prüfte weder Kontextgrenzen noch Werkzeugaufrufe oder Modellqualität.

Stellen Sie den Agenten wieder her, bevor Sie seinen Anbieter entfernen. Diese Befehle setzen jeden Agenten auf seine vorherige Konfiguration zurück.

Entfernen Sie nur Anbieter, die Sie hinzugefügt haben. Widerrufen Sie die eigenen RunAPI-Schlüssel, wenn Sie sie nicht mehr benötigen. Stellen Sie Ihre Sicherung wieder her, falls Sie weitere manuelle Konfigurationsänderungen vorgenommen haben.

Öffentliche Protokollbeispiele von RunAPI finden Sie im LLM-API-Schnellstart, unterstützte Modelle im Modellkatalog. Die offizielle Magpie-Referenz führt auch eine Grok-Build-Integration auf; Grok Build wurde für diesen Leitfaden nicht getestet.