Magpie

Crie uma chave de API padrão dedicada no Guia de autenticação. Copie um ID de modelo e seu protocolo compatível do Catálogo de modelos. Faça backup da configuração do agente antes de mudar de provedor.

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.

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.

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.

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.

Em outro terminal, selecione o modelo.

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.

Verifique o provedor e o modelo selecionado com estes comandos. Depois, inicie uma nova sessão do agente e envie um prompt curto.

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.

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.

Restaure o agente antes de remover seu provedor. Estes comandos retornam cada agente à configuração anterior.

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.

Consulte o Guia rápido da API LLM para exemplos dos protocolos públicos do RunAPI e o Catálogo de modelos 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.