---
title: Magpie | RunAPI
description: RunAPI zu Magpie hinzufügen und seine Modelle für Claude Code oder Codex
  auswählen.
url: https://runapi.ai/de/docs/resources/tool-integrations/magpie.md
canonical: https://runapi.ai/de/docs/resources/tool-integrations/magpie
locale: de
---

> HTML-Version: https://runapi.ai/de/docs/resources/tool-integrations/magpie
> Website-Index für KI-Agenten: https://runapi.ai/llms.txt

# Magpie

## Installieren und vorbereiten

Installieren Sie die neueste stabile Version von [Magpie][1]. Folgen Sie
für die plattformspezifische Installation der [offiziellen Referenz][2].
Installieren Sie Claude Code oder Codex separat.



[1]: https://usemagpie.ai
[2]: https://github.com/yetone/magpie/blob/main/docs/reference.md

Erstellen Sie einen eigenen Standard-API-Schlüssel gemäß dem
[Authentifizierungsleitfaden](https://runapi.ai/de/docs/guides/authentication.md). Kopieren Sie
eine Modell-ID und das unterstützte Protokoll aus dem
[Modellkatalog](https://runapi.ai/de/models). Sichern Sie Ihre Agentenkonfiguration, bevor
Sie den Anbieter wechseln.

## Einen OpenAI-kompatiblen Anbieter hinzufügen

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.

```shell
magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
```

## Einen Anthropic-kompatiblen Anbieter hinzufügen

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.

```shell
magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
```

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.

## Einem Agenten ein Modell zuweisen

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.

```shell
magpie serve
```

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

```shell
magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID
```

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.

## Einrichtung überprüfen

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.

```shell
magpie version
magpie providers
magpie claude
magpie codex
```

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.

## Fehlerbehebung

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.

## Vorherige Einrichtung wiederherstellen

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

```shell
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
```

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.

## Nächste Schritte

Öffentliche Protokollbeispiele von RunAPI finden Sie im
[LLM-API-Schnellstart](https://runapi.ai/de/docs/guides/llm-api/quickstart.md), unterstützte
Modelle im [Modellkatalog](https://runapi.ai/de/models). Die offizielle Magpie-Referenz
führt auch eine Grok-Build-Integration auf; Grok Build wurde für diesen
Leitfaden nicht getestet.

---

## Mehr von RunAPI

- [Startseite](https://runapi.ai/de/.md)
- [Modellkatalog](https://runapi.ai/de/models.md)
- [Preise](https://runapi.ai/de/pricing.md)
- [Anbieter](https://runapi.ai/de/models)
- [Dokumentation](https://runapi.ai/de/docs/guides)
- [SDKs](https://runapi.ai/de/sdk.md)
- [CLI](https://runapi.ai/de/cli.md)
- [MCP Server](https://runapi.ai/de/mcp.md)
- [x402](https://runapi.ai/de/x402.md)
- [Claude Code vs Cursor](https://runapi.ai/de/claude-code-vs-cursor.md)
- [Cursor API-Einrichtung](https://runapi.ai/de/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/de/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/de/contact.md)
- [Kontakt](https://runapi.ai/de/contact.md)
- [Bedingungen](https://runapi.ai/de/terms.md)
- [Datenschutz](https://runapi.ai/de/privacy.md)
- [Website-Index für KI-Agenten](https://runapi.ai/llms.txt)

Kontakt: contact@runapi.ai

## Strukturierte Daten

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/de/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/de",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/deicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "de",
    "@type": "TechArticle",
    "headline": "Magpie",
    "description": "RunAPI zu Magpie hinzufügen und seine Modelle für Claude Code oder Codex auswählen.",
    "url": "https://runapi.ai/de/docs/resources/tool-integrations/magpie",
    "mainEntityOfPage": "https://runapi.ai/de/docs/resources/tool-integrations/magpie"
  }
]
```
