Magpie

Crea una chiave API standard dedicata seguendo la Guida all’autenticazione. Copia un ID modello e il protocollo supportato dal Catalogo modelli. Esegui un backup della configurazione dell’agente prima di cambiare provider.

Usa questa opzione per i modelli che supportano Chat Completions. Sostituisci entrambi i segnaposto prima di eseguire il comando. La base url= termina con /v1; Magpie aggiunge /chat/completions.

Usa questa opzione per i modelli che supportano Anthropic Messages. La base anthropic= non contiene /v1; Magpie aggiunge /v1/messages.

Scegli prima una sola opzione. Magpie rifiuta un secondo provider con la stessa chiave. Per mantenere entrambi i provider, crea una chiave RunAPI dedicata diversa per ciascuno. Conserva le chiavi RunAPI in Magpie, fuori dai repository.

Avvia Magpie e mantieni il gateway in esecuzione. Nella schermata Agents, seleziona Claude Code o Codex e scegli il modello nel tuo provider RunAPI. La CLI offre la stessa selezione. Esegui un comando con il provider e l’ID modello scelti.

In un altro terminale, seleziona il modello.

Per l’opzione Anthropic, sostituisci runapi-chat con runapi-anthropic. Magpie usa provider/model in locale e inoltra l’ID modello originale a RunAPI. L’agente si connette a Magpie su 127.0.0.1:3425; non ha bisogno della chiave RunAPI. Codex usa l’interfaccia Responses locale, il che non implica che RunAPI riceva una richiesta Responses. Queste opzioni del provider selezionano Chat Completions o Messages sul lato RunAPI.

Controlla il provider e il modello selezionato con questi comandi, quindi avvia una nuova sessione dell’agente e invia un breve prompt.

Conferma il modello e la richiesta previsti nei registri di utilizzo RunAPI. Una risposta corretta dell’agente, da sola, non dimostra quale provider l’abbia gestita. Le funzioni Test models, Detect APIs e il test del provider di Magpie possono inviare richieste di inferenza.

La configurazione e le route locali sono state verificate con Magpie 0.1.1307 e Claude Code 2.1.295 su Linux. Entrambe le opzioni del provider hanno restituito una risposta fissa da una fixture locale. L’inferenza reale RunAPI e l’inferenza Codex non sono state testate per questa guida. Controlla il protocollo e il supporto degli strumenti del modello selezionato prima di usarlo per il lavoro degli agenti.

Se Magpie segnala che è già stato aggiunto un provider con quella chiave, riutilizza quel provider oppure usa una chiave dedicata diversa per la seconda opzione. Questo errore è stato riprodotto in locale.

Un’esecuzione con fixture locale ha riprodotto no model list con connection refused quando il server configurato era arrestato. Controlla l’indirizzo e la disponibilità del server, quindi usa models= con l’ID modello esatto. Mantieni Magpie in esecuzione mentre gli agenti usano il suo gateway locale.

Claude Code ha segnalato unrecognized_model per gli ID della fixture, ma ha comunque restituito la risposta della fixture. Se compare questo avviso, controlla l’ID modello originale e la configurazione del modello di Claude Code. La fixture non ha convalidato i limiti di contesto, le chiamate agli strumenti o la qualità del modello.

Ripristina l’agente prima di rimuovere il suo provider. Questi comandi riportano ciascun agente alla configurazione precedente.

Rimuovi solo i provider che hai aggiunto. Revoca le chiavi RunAPI dedicate se non ti servono più. Ripristina il backup se hai effettuato altre modifiche manuali alla configurazione.

Consulta la Guida rapida all’API LLM per esempi dei protocolli pubblici di RunAPI e il Catalogo modelli per i modelli supportati. Il riferimento ufficiale di Magpie elenca anche un’integrazione con Grok Build; Grok Build non è stato testato per questa guida.