Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

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.

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 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.