Magpie
Voeg RunAPI toe aan Magpie en selecteer de modellen voor Claude Code of Codex.
Installeren en voorbereiden
Installeer de nieuwste stabiele versie van Magpie. Volg de officiële referentie voor de installatie op jouw platform. Installeer Claude Code of Codex afzonderlijk.
Maak een aparte standaard-API-sleutel aan via de Authenticatiehandleiding. Kopieer een model-ID en het ondersteunde protocol uit de Modelcatalogus. Maak een back-up van je agentconfiguratie voordat je van provider wisselt.
Een OpenAI-compatibele provider toevoegen
Gebruik deze optie voor modellen die Chat Completions ondersteunen.
Vervang beide tijdelijke aanduidingen voordat je de opdracht uitvoert.
De basis-URL bij url= eindigt op /v1; Magpie voegt
/chat/completions toe.
magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
Een Anthropic-compatibele provider toevoegen
Gebruik deze optie voor modellen die Anthropic Messages ondersteunen. De
basis-URL bij anthropic= bevat geen /v1; Magpie voegt /v1/messages
toe.
magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
Kies eerst één optie. Magpie weigert een tweede provider met dezelfde sleutel. Maak voor elke provider een andere aparte RunAPI-sleutel aan als je beide providers wilt behouden. Bewaar de RunAPI-sleutels in Magpie, buiten je repositories.
Een model aan een agent toewijzen
Start Magpie en laat de gateway draaien. Selecteer Claude Code of Codex in het scherm Agents en kies het model onder je RunAPI-provider. De CLI biedt dezelfde keuze. Voer één opdracht uit met de gekozen provider en het model-ID.
magpie serve
Selecteer het model in een andere terminal.
magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID
Vervang voor de Anthropic-optie runapi-chat door runapi-anthropic.
Magpie gebruikt lokaal provider/model en stuurt het oorspronkelijke
model-ID door naar RunAPI. De agent maakt verbinding met Magpie op
127.0.0.1:3425 en heeft de RunAPI-sleutel niet nodig. Codex gebruikt
de lokale Responses-interface; dit betekent niet dat RunAPI een
Responses-verzoek ontvangt. Deze provideropties selecteren Chat
Completions of Messages aan de kant van RunAPI.
Je configuratie controleren
Controleer de provider en het geselecteerde model met deze opdrachten, start vervolgens een nieuwe agentsessie en verstuur een korte prompt.
magpie version
magpie providers
magpie claude
magpie codex
Controleer het verwachte model en verzoek in de gebruiksgegevens van RunAPI. Een geslaagd antwoord van de agent bewijst op zichzelf niet welke provider het heeft verwerkt. Test models, Detect APIs en de providertest van Magpie kunnen inferentieverzoeken versturen.
De configuratie en lokale routes zijn gecontroleerd met Magpie 0.1.1307 en Claude Code 2.1.295 op Linux. Beide provideropties gaven een vast antwoord van een lokale fixture terug. Echte RunAPI-inferentie en Codex-inferentie zijn niet getest voor deze handleiding. Controleer het protocol en de toolondersteuning van het geselecteerde model voordat je het voor agentwerk gebruikt.
Probleemoplossing
Als Magpie meldt dat er al een provider met die sleutel is toegevoegd, hergebruik die provider of gebruik een andere aparte sleutel voor de tweede optie. Deze fout is lokaal gereproduceerd.
Een lokale fixturerun reproduceerde no model list met connection refused toen de ingestelde server was gestopt. Controleer het adres en
de beschikbaarheid van de server en gebruik daarna models= met het
exacte model-ID. Laat Magpie draaien zolang agents de lokale gateway
gebruiken.
Claude Code meldde unrecognized_model voor de fixture-ID’s, maar gaf
toch het fixtureantwoord terug. Controleer het oorspronkelijke model-ID
en de modelconfiguratie van Claude Code als je deze waarschuwing ziet.
De fixture heeft contextlimieten, toolaanroepen of modelkwaliteit niet
gevalideerd.
Je vorige configuratie herstellen
Herstel de agent voordat je de provider verwijdert. Deze opdrachten zetten elke agent terug naar de vorige configuratie.
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
Verwijder alleen de providers die je hebt toegevoegd. Trek de aparte RunAPI-sleutels in als je ze niet meer nodig hebt. Herstel je back-up als je nog andere handmatige configuratiewijzigingen hebt aangebracht.
Volgende stappen
Zie de LLM API-snelstart voor voorbeelden van de openbare protocollen van RunAPI en de Modelcatalogus voor ondersteunde modellen. De officiële referentie van Magpie vermeldt ook een Grok Build-integratie; Grok Build is niet getest voor deze handleiding.