Magpie
Añade RunAPI a Magpie y selecciona sus modelos para Claude Code o Codex.
Instalar y preparar
Instala la versión estable más reciente de Magpie. Sigue la referencia oficial para la instalación específica de tu plataforma. Instala Claude Code o Codex por separado.
Crea una clave API estándar dedicada siguiendo la guía de autenticación. Copia un ID de modelo y su protocolo compatible del catálogo de modelos. 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.
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.
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.
magpie serve
En otra terminal, selecciona el modelo.
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.
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.
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 para ver ejemplos de los protocolos públicos de RunAPI y el catálogo de modelos 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.