--- title: Magpie | RunAPI description: Adicione o RunAPI ao Magpie e selecione seus modelos para Claude Code ou Codex. url: https://runapi.ai/pt-BR/docs/resources/tool-integrations/magpie.md canonical: https://runapi.ai/pt-BR/docs/resources/tool-integrations/magpie locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/resources/tool-integrations/magpie > Índice do site para agentes: https://runapi.ai/llms.txt # Magpie ## Instalar e preparar Instale a versão estável mais recente do [Magpie][1]. Siga a [referência oficial][2] para a instalação na sua plataforma. Instale Claude Code ou Codex separadamente. [1]: https://usemagpie.ai [2]: https://github.com/yetone/magpie/blob/main/docs/reference.md Crie uma chave de API padrão dedicada no [Guia de autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md). Copie um ID de modelo e seu protocolo compatível do [Catálogo de modelos](https://runapi.ai/pt-BR/models). Faça backup da configuração do agente antes de mudar de provedor. ## Adicionar um provedor compatível com OpenAI Use esta opção para modelos compatíveis com Chat Completions. Substitua os dois valores de exemplo antes de executar o comando. A URL base `url=` termina em `/v1`; o Magpie acrescenta `/chat/completions`. ```shell magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` ## Adicionar um provedor compatível com Anthropic Use esta opção para modelos compatíveis com Anthropic Messages. A URL base `anthropic=` não contém `/v1`; o Magpie acrescenta `/v1/messages`. ```shell magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` Escolha uma opção primeiro. O Magpie rejeita um segundo provedor com a mesma chave. Para manter os dois provedores, crie uma chave RunAPI dedicada diferente para cada um. Mantenha as chaves RunAPI no Magpie, fora dos seus repositórios. ## Atribuir um modelo a um agente Inicie o Magpie e mantenha seu gateway em execução. Na tela Agents, selecione Claude Code ou Codex e escolha o modelo do seu provedor RunAPI. A CLI oferece a mesma seleção. Execute um comando com o provedor e o ID de modelo escolhidos. ```shell magpie serve ``` Em outro terminal, selecione o modelo. ```shell magpie models magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID ``` Para a opção Anthropic, substitua `runapi-chat` por `runapi-anthropic`. O Magpie usa `provider/model` localmente e encaminha o ID original do modelo ao RunAPI. O agente se conecta ao Magpie em `127.0.0.1:3425`; ele não precisa da chave RunAPI. O Codex usa a interface Responses local, o que não implica que o RunAPI receba uma requisição Responses. Essas opções de provedor selecionam Chat Completions ou Messages no lado do RunAPI. ## Verificar a configuração Verifique o provedor e o modelo selecionado com estes comandos. Depois, inicie uma nova sessão do agente e envie um prompt curto. ```shell magpie version magpie providers magpie claude magpie codex ``` Confirme o modelo e a requisição esperados nos registros de uso do RunAPI. Uma resposta bem-sucedida do agente, por si só, não comprova qual provedor a processou. As funções Test models, Detect APIs e o teste de provedor do Magpie podem enviar requisições de inferência. A configuração e as rotas locais foram verificadas com Magpie 0.1.1307 e Claude Code 2.1.295 no Linux. As duas opções de provedor retornaram uma resposta fixa de uma fixture local. A inferência real do RunAPI e a inferência do Codex não foram testadas para este guia. Verifique o protocolo e o suporte a ferramentas do modelo selecionado antes de usá-lo em tarefas de agente. ## Solucionar problemas Se o Magpie informar que já existe um provedor adicionado com essa chave, reutilize esse provedor ou use outra chave dedicada para a segunda opção. Esse erro foi reproduzido localmente. Uma execução com fixture local reproduziu `no model list` com `connection refused` quando o servidor configurado estava parado. Verifique o endereço e a disponibilidade do servidor e use `models=` com o ID exato do modelo. Mantenha o Magpie em execução enquanto os agentes usarem seu gateway local. O Claude Code informou `unrecognized_model` para os IDs da fixture, mas ainda retornou a resposta da fixture. Verifique o ID original do modelo e a configuração de modelos do Claude Code se esse aviso aparecer. A fixture não validou limites de contexto, chamadas de ferramentas nem qualidade do modelo. ## Restaurar a configuração anterior Restaure o agente antes de remover seu provedor. Estes comandos retornam cada agente à configuração anterior. ```shell magpie claude default magpie codex default magpie provider rm runapi-chat magpie provider rm runapi-anthropic ``` Remova apenas os provedores que você adicionou. Revogue as chaves RunAPI dedicadas se não precisar mais delas. Restaure seu backup se tiver feito outras alterações manuais na configuração. ## Próximas etapas Consulte o [Guia rápido da API LLM](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md) para exemplos dos protocolos públicos do RunAPI e o [Catálogo de modelos](https://runapi.ai/pt-BR/models) para os modelos compatíveis. A referência oficial do Magpie também lista uma integração com Grok Build; o Grok Build não foi testado para este guia. --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [x402](https://runapi.ai/pt-BR/x402.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Magpie", "description": "Adicione o RunAPI ao Magpie e selecione seus modelos para Claude Code ou Codex.", "url": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/magpie", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/tool-integrations/magpie" } ] ```