--- title: Magpie | RunAPI description: Añade RunAPI a Magpie y selecciona sus modelos para Claude Code o Codex. url: https://runapi.ai/es/docs/resources/tool-integrations/magpie.md canonical: https://runapi.ai/es/docs/resources/tool-integrations/magpie locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/tool-integrations/magpie > Índice del sitio para agentes: https://runapi.ai/llms.txt # Magpie ## Instalar y preparar Instala la versión estable más reciente de [Magpie][1]. Sigue la [referencia oficial][2] para la instalación específica de tu plataforma. Instala Claude Code o Codex por separado. [1]: https://usemagpie.ai [2]: https://github.com/yetone/magpie/blob/main/docs/reference.md Crea una clave API estándar dedicada siguiendo la [guía de autenticación](https://runapi.ai/es/docs/guides/authentication.md). Copia un ID de modelo y su protocolo compatible del [catálogo de modelos](https://runapi.ai/es/models). Haz una copia de seguridad de la configuración del agente antes de cambiar de proveedor. ## Añadir un proveedor compatible con OpenAI Usa esta opción para los modelos que admitan Chat Completions. Sustituye ambos marcadores antes de ejecutar el comando. La base `url=` termina en `/v1`; Magpie añade `/chat/completions`. ```shell magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` ## Añadir un proveedor compatible con Anthropic Usa esta opción para los modelos que admitan Anthropic Messages. La base `anthropic=` no incluye `/v1`; Magpie añade `/v1/messages`. ```shell magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID ``` Elige primero una opción. Magpie rechaza un segundo proveedor con la misma clave. Para conservar ambos proveedores, crea una clave RunAPI dedicada distinta para cada uno. Guarda las claves RunAPI en Magpie, fuera de tus repositorios. ## Asignar un modelo a un agente Inicia Magpie y mantén su pasarela en funcionamiento. En la pantalla Agents, selecciona Claude Code o Codex y elige el modelo de tu proveedor RunAPI. La CLI ofrece la misma selección. Ejecuta un comando con el proveedor y el ID de modelo elegidos. ```shell magpie serve ``` En otra terminal, selecciona el modelo. ```shell magpie models magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID ``` Para la opción Anthropic, sustituye `runapi-chat` por `runapi-anthropic`. Magpie utiliza `provider/model` localmente y envía el ID de modelo original a RunAPI. El agente se conecta a Magpie en `127.0.0.1:3425`; no necesita la clave RunAPI. Codex utiliza la interfaz Responses local, lo que no implica que RunAPI reciba una solicitud Responses. Estas opciones de proveedor seleccionan Chat Completions o Messages en el lado de RunAPI. ## Verificar la configuración Comprueba el proveedor y el modelo seleccionado con estos comandos, luego inicia una nueva sesión del agente y envía una instrucción breve. ```shell magpie version magpie providers magpie claude magpie codex ``` Confirma el modelo y la solicitud esperados en los registros de uso de RunAPI. Una respuesta correcta del agente por sí sola no permite saber qué proveedor la procesó. Las funciones Test models, Detect APIs y la prueba de proveedor de Magpie pueden enviar solicitudes de inferencia. La configuración y las rutas locales se comprobaron con Magpie 0.1.1307 y Claude Code 2.1.295 en Linux. Ambas opciones de proveedor devolvieron una respuesta fija de una fixture local. No se probaron la inferencia real de RunAPI ni la inferencia de Codex para esta guía. Comprueba el protocolo y la compatibilidad con herramientas del modelo seleccionado antes de usarlo con agentes. ## Solución de problemas Si Magpie indica que ya se añadió un proveedor con esa clave, reutiliza ese proveedor o usa otra clave dedicada para la segunda opción. Este error se reprodujo localmente. Una ejecución con una fixture local reprodujo `no model list` con `connection refused` cuando el servidor configurado estaba detenido. Comprueba la dirección y la disponibilidad del servidor, luego utiliza `models=` con el ID exacto del modelo. Mantén Magpie en funcionamiento mientras los agentes utilicen su pasarela local. Claude Code indicó `unrecognized_model` para los ID de la fixture, pero aun así devolvió la respuesta de la fixture. Si aparece esta advertencia, comprueba el ID de modelo original y la configuración de modelos de Claude Code. La fixture no validó los límites de contexto, las llamadas a herramientas ni la calidad del modelo. ## Restaurar la configuración anterior Restaura el agente antes de eliminar su proveedor. Estos comandos devuelven cada agente a su configuración anterior. ```shell magpie claude default magpie codex default magpie provider rm runapi-chat magpie provider rm runapi-anthropic ``` Elimina solo los proveedores que hayas añadido. Revoca las claves RunAPI dedicadas si ya no las necesitas. Restaura tu copia de seguridad si realizaste otros cambios manuales de configuración. ## Próximos pasos Consulta el [inicio rápido de la API LLM](https://runapi.ai/es/docs/guides/llm-api/quickstart.md) para ver ejemplos de los protocolos públicos de RunAPI y el [catálogo de modelos](https://runapi.ai/es/models) para conocer los modelos compatibles. La referencia oficial de Magpie también enumera una integración con Grok Build; no se probó Grok Build para esta guía. --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [x402](https://runapi.ai/es/x402.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "Magpie", "description": "Añade RunAPI a Magpie y selecciona sus modelos para Claude Code o Codex.", "url": "https://runapi.ai/es/docs/resources/tool-integrations/magpie", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/tool-integrations/magpie" } ] ```