--- title: Magpie | RunAPI description: Aggiungi RunAPI a Magpie e seleziona i suoi modelli per Claude Code o Codex. url: https://runapi.ai/it/docs/resources/tool-integrations/magpie.md canonical: https://runapi.ai/it/docs/resources/tool-integrations/magpie locale: it --- > Versione HTML: https://runapi.ai/it/docs/resources/tool-integrations/magpie > Indice del sito per gli agenti: https://runapi.ai/llms.txt # Magpie ## Installazione e preparazione Installa la versione stabile più recente da [Magpie][1]. Segui il [riferimento ufficiale][2] per le istruzioni di installazione specifiche della piattaforma. Installa Claude Code o Codex separatamente. [1]: https://usemagpie.ai [2]: https://github.com/yetone/magpie/blob/main/docs/reference.md Crea una chiave API standard dedicata seguendo la [Guida all’autenticazione](https://runapi.ai/it/docs/guides/authentication.md). Copia un ID modello e il protocollo supportato dal [Catalogo modelli](https://runapi.ai/it/models). Esegui un backup della configurazione dell’agente prima di cambiare provider. ## Aggiungere un provider compatibile con OpenAI 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`. ```shell magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` ## Aggiungere un provider compatibile con Anthropic Usa questa opzione per i modelli che supportano Anthropic Messages. La base `anthropic=` non contiene `/v1`; Magpie aggiunge `/v1/messages`. ```shell magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` 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. ## Assegnare un modello a un agente 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. ```shell magpie serve ``` In un altro terminale, seleziona il modello. ```shell magpie models magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID ``` 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. ## Verificare la configurazione Controlla il provider e il modello selezionato con questi comandi, quindi avvia una nuova sessione dell’agente e invia un breve prompt. ```shell magpie version magpie providers magpie claude magpie codex ``` 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. ## Risoluzione dei problemi 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. ## Ripristinare la configurazione precedente Ripristina l’agente prima di rimuovere il suo provider. Questi comandi riportano ciascun agente alla configurazione precedente. ```shell magpie claude default magpie codex default magpie provider rm runapi-chat magpie provider rm runapi-anthropic ``` 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. ## Passaggi successivi Consulta la [Guida rapida all’API LLM](https://runapi.ai/it/docs/guides/llm-api/quickstart.md) per esempi dei protocolli pubblici di RunAPI e il [Catalogo modelli](https://runapi.ai/it/models) per i modelli supportati. Il riferimento ufficiale di Magpie elenca anche un’integrazione con Grok Build; Grok Build non è stato testato per questa guida. --- ## Altre risorse di RunAPI - [Home](https://runapi.ai/it/.md) - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models) - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) - [x402](https://runapi.ai/it/x402.md) - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Indice del sito per gli agenti](https://runapi.ai/llms.txt) Contatti: contact@runapi.ai ## Dati strutturati ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "TechArticle", "headline": "Magpie", "description": "Aggiungi RunAPI a Magpie e seleziona i suoi modelli per Claude Code o Codex.", "url": "https://runapi.ai/it/docs/resources/tool-integrations/magpie", "mainEntityOfPage": "https://runapi.ai/it/docs/resources/tool-integrations/magpie" } ] ```