Magpie vs. CC Switch: ¿qué administrador de proveedores para agentes deberías usar?

Claude Code, Codex y Gemini CLI son agentes. El modelo que responde a sus solicitudes y el proveedor que ofrece ese modelo son opciones distintas. Administrar esas opciones en varias herramientas es donde resultan útiles programas como Magpie, CC Switch, Claude Code Router y CLIProxyAPI.

La respuesta breve: incluye en tu lista Magpie para una puerta de enlace compartida entre agentes, CC Switch para un espacio de configuración integrado en el escritorio, Claude Code Router para reglas explícitas de enrutamiento de solicitudes y CLIProxyAPI para un proxy compatible que usa cuentas. Son fortalezas que se solapan, no cuatro categorías excluyentes. CC Switch tiene enrutamiento; Magpie incluye funciones de espacio de trabajo; Claude Code Router admite más que Claude Code.

La pregunta útil no es qué producto tiene la lista de funciones más larga, sino qué parte de la configuración de tus agentes quieres que administre.

Alcance: documentación oficial consultada el 3 de noviembre de 2026. Esta comparación se basa en documentación; no es un benchmark práctico, una prueba de fiabilidad ni una auditoría de seguridad. Que se indique compatibilidad no demuestra que el comportamiento sea idéntico con todos los agentes, proveedores y versiones. AIHubMix preparó esta comparación; el README de Claude Code Router incluye a AIHubMix entre sus patrocinadores. Esta relación se declara aquí, en lugar de tratarse como evidencia técnica.

Primero, distingue el agente de su proveedor ascendente

Un agente proporciona el entorno de trabajo: acceso a archivos, herramientas de shell, reglas de aprobación y el ciclo de conversación. Un modelo genera respuestas. Un proveedor permite acceder a ese modelo mediante un endpoint, una clave de API o, cuando se admite, el inicio de sesión en una cuenta.

Cambiar el modelo ascendente no convierte Claude Code en Codex. Tampoco una respuesta correcta de la API demuestra que todas las llamadas a herramientas, imágenes, campos de razonamiento o conversaciones prolongadas vayan a comportarse igual.

Por eso, esta comparación se centra en programas que controlan agentes de programación existentes. Un servicio de modelos alojado o una puerta de enlace para el backend de una aplicación resuelven un problema relacionado, pero no necesariamente son la herramienta que administra la configuración de tus agentes locales.

Es fácil confundir estas cinco operaciones:

• Cambio de configuración cambia el endpoint, la clave o el modelo que usa un agente.
• Enrutamiento local interpone una puerta de enlace entre el agente y su proveedor ascendente. La puerta de enlace puede elegir un destino o traducir formatos de API.
• Agregación de modelos muestra los modelos de varios proveedores en una sola lista de selección. No ofrece automáticamente conmutación por error.
• Distribución entre cuentas selecciona entre credenciales o cuentas. La rotación por turnos es una estrategia de distribución, no una garantía de que se recuperen todas las solicitudes fallidas.
• Conmutación por error prueba otro destino configurado tras un fallo que cumpla las condiciones. El alcance y las condiciones dependen de la implementación.

Empieza por la operación que necesitas y luego elige el producto.

Una lista rápida de opciones

Usa esta tabla para decidir por dónde empezar y luego revisa las restricciones detalladas que aparecen más abajo.

CCR significa Claude Code Router. Estas listas son recomendaciones editoriales que se solapan, no capacidades exclusivas ni clasificaciones basadas en mediciones. Magpie necesita otro destino disponible para la conmutación por error; la agregación de CC Switch no incluye conmutación por error; las reglas de CCR requieren validación; la aplicación complementaria de escritorio y las estadísticas de CLIProxyAPI son componentes separados. La compatibilidad varía según el agente y el proveedor.

Magpie: reúne varios agentes detrás de una puerta de enlace de modelos

Magpie combina la administración nativa de la configuración de agentes con una puerta de enlace local compartida. Entre sus integraciones documentadas figuran Claude Code, Codex, Gemini CLI, OpenCode, Cline y Cursor CLI, entre otras. La interfaz muestra las instalaciones detectadas; también puede usar la puerta de enlace cualquier cliente que acepte una URL base compatible, lo cual no equivale a contar con una integración nativa específica.

Su puerta de enlace traduce los formatos OpenAI Chat, OpenAI Responses, Anthropic Messages y Gemini. Los proveedores pueden incluir servicios con clave de API, endpoints personalizados compatibles, servidores de modelos locales y cuentas de suscripción compatibles. Los perfiles guardan con un mismo nombre las configuraciones de varios agentes.

La idea distintiva es un grupo de enrutamiento: varios modelos o proveedores que se ofrecen al agente como una sola opción. Los modos documentados incluyen:

• order: usa el primer miembro hasta que no pueda responder y, entonces, prueba el siguiente.
• rotate: pasa a otro miembro en cada turno.
• usage: da preferencia al miembro menos utilizado.
• smart: entre las suscripciones aptas que aún tienen cuota, da preferencia a la que se reiniciará antes.
• pace: selecciona según la capacidad semanal restante en relación con el tiempo que falta para el reinicio.

Los grupos pueden anidarse. Magpie también describe cómo mantener una conversación en la cuenta que respondió, cuando vale la pena conservar su caché de prompts. Esa es una política de enrutamiento, no una prueba de que cambiar de proveedor arbitrariamente conserve el estado almacenado en caché. El enrutamiento opcional por intención usa un modelo elegido por el usuario para leer los turnos nuevos; la documentación no demuestra que esto siempre ahorre dinero.

Hay un límite sencillo, pero importante, para la conmutación por error: debe haber otro destino disponible. El README señala explícitamente que, si hay una sola cuenta y ningún grupo de enrutamiento, no hay adónde desviar la solicitud y el error llega al agente.

Magpie no es solo un enrutador. Su Library administra instrucciones, servidores MCP, habilidades y subagentes. También ofrece vistas de uso, cuota, costo y sesiones. Cuenta con interfaces de escritorio, terminal, navegador y CLI, y enumera macOS, Windows, Linux, Docker y Termux entre los entornos compatibles.

Los controles de privacidad requieren una decisión aparte

El enmascaramiento de Magpie está desactivado de forma predeterminada. Cuando se activa, detecta localmente valores confidenciales compatibles, los sustituye por marcadores antes de enviarlos y los restablece en las respuestas, incluidos los argumentos de las herramientas. La detección puede equivocarse; el modelo no puede inspeccionar el valor original de algo que se haya enmascarado. Si el enmascaramiento activado no puede ejecutarse, el README indica que la solicitud se retiene y se devuelve HTTP 503.

Esto no garantiza que se detecten todos los secretos. Lee la documentación de privacidad, incluida la información sobre la detección de cuentas: Magpie puede leer los inicios de sesión existentes de los agentes, y es posible desactivar la detección.

El README también describe una telemetría diaria de las versiones de lanzamiento que incluye un identificador aleatorio, la versión, el sistema y los identificadores de uso del producto. La telemetría puede desactivarse en la configuración de privacidad o con DO_NOT_TRACK=1. Los clics en enlaces de socios y las consultas a la lista de socios se contabilizan independientemente de esos controles; según el README, esos recuentos no conservan identificadores ni direcciones. Por tanto, «puerta de enlace local» no debe interpretarse como «ninguna otra actividad de red».

Incluye Magpie en tu lista si: quieres que varios agentes compartan opciones de enrutamiento de proveedores, modelos y cuentas. La contrapartida es hacerte responsable de la política de enrutamiento, el acceso a las credenciales y la configuración de privacidad, en lugar de limitarte a elegir un modelo de un menú.

CC Switch: un espacio de trabajo de escritorio que también enruta solicitudes

Decir que CC Switch es solo un conmutador de configuración no refleja todo su alcance documentado. Además de administrar proveedores, ofrece MCP, habilidades, bibliotecas de prompts, configuraciones de proyectos, sesiones, seguimiento de uso, copias de seguridad y sincronización. Entre los clientes enumerados están Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode y otros, aunque la compatibilidad de las funciones varía según el cliente.

Sus tres modos de conexión explican buena parte de la comparación:

Directo conecta el agente con el proveedor seleccionado. Al cambiar de proveedor, se modifican los campos relacionados con la conexión, mientras que el proyecto indica que se conservan los hooks, complementos, ajustes de MCP y comentarios no relacionados.

Enrutamiento reenvía las solicitudes localmente a través de CC Switch. Convierte los formatos Anthropic Messages, OpenAI Chat Completions, OpenAI Responses y Gemini Native, y admite colas de conmutación por error por herramienta, interruptores de circuito y supervisión del estado de los proveedores.

Agregación, para Claude Code y Codex, muestra los modelos de varios proveedores en el selector de modelos del cliente. Las solicitudes se envían al proveedor del modelo elegido. La agregación no ofrece conmutación por error. También tiene restricciones por proveedor; por ejemplo, no admite suscripciones oficiales de Claude en la agregación. En general, los proveedores que usan inicio de sesión oficial no pueden utilizarse con Enrutamiento; OpenAI Official para Codex es una excepción documentada.

Esto convierte a CC Switch en una opción válida tanto para cambiar configuraciones de forma sencilla como para el enrutamiento local. Su énfasis en el espacio de trabajo de escritorio es un motivo editorial para recomendarlo, no una prueba de que las alternativas carezcan de bibliotecas o vistas de sesiones.

Los límites prácticos importan más que la cantidad de preajustes

CC Switch documenta el cambio en caliente para Claude Code. Los cambios de proveedor directos para Codex, Gemini CLI y Grok Build suelen requerir un reinicio; el enrutamiento también puede requerirlo si cambia el modelo. Los cambios en la lista de agregación de Codex requieren reiniciar el daemon, la aplicación o el entorno del editor correspondiente. Planifica estos cambios fuera de una tarea activa.

En las preguntas frecuentes aparece otra distinción útil: la prueba de conectividad de la tarjeta del proveedor comprueba que sea accesible, no que funcionen la clave de API o el modelo. Una marca verde no es una prueba de aceptación integral.

De forma predeterminada, los datos se guardan en ~/.cc-switch, con una base de datos SQLite y archivos asociados. El README describe copias de seguridad de la configuración original antes de la primera reescritura, copias de seguridad automáticas y sincronización compatible con WebDAV/S3. Algunos ajustes del dispositivo, estados y copias de seguridad de la configuración original permanecen en el dispositivo y no se incluyen en la sincronización en la nube. No des por sentado que sincronizar la aplicación transfiere todos los datos que podrían permitir recuperar el estado.

La aplicación oficial está dirigida a equipos de escritorio con interfaz gráfica en macOS, Windows y Linux. Consulta el manual de usuario para ver la matriz exacta de funciones y las restricciones de cada modo según el agente.

Incluye CC Switch en tu lista si: los cambios de proveedor forman parte de un flujo de trabajo de escritorio más amplio que abarca MCP, habilidades, prompts y proyectos. Si solo necesitas un proxy reutilizable sin interfaz gráfica, evalúa ese requisito por separado en lugar de suponer que tendrá las mismas funciones que la aplicación de escritorio.

Claude Code Router: define explícitamente las decisiones de enrutamiento

Claude Code Router, o CCR, ahora se describe como una pasarela multiagente y un plano de control. Su README enumera Codex, OpenCode, Pi, Kimi CLI, Grok CLI y otros clientes, además de Claude Code.

Las capacidades documentadas sitúan las políticas de solicitudes en el centro: condiciones basadas en encabezados y cuerpos de solicitud, prefijos, reescritura de solicitudes, reintentos y modelos alternativos en un orden establecido. Los grupos de credenciales y la rotación de claves se complementan con perfiles de agente, sustituciones de modelos y ajustes del entorno.

Esta combinación resulta útil cuando «seleccionar otro proveedor» es demasiado impreciso. Quizá quieras que una condición concreta de la solicitud seleccione un upstream determinado y necesites averiguar por qué se aplicó esa regla.

CCR documenta los detalles de las solicitudes y las respuestas, el proveedor/modelo/credencial resueltos, el estado, la latencia, los tokens, el coste estimado, las llamadas a herramientas y las trazas. Las estimaciones de coste no son la factura del upstream. Los registros permiten inspeccionar una política, pero no demuestran que esta mejore la calidad de las tareas.

El proyecto ofrece descargas de escritorio para macOS, Windows y Linux, una CLI de npm con una interfaz de gestión en el navegador y despliegue con Docker. La CLI de npm requiere Node.js 22 o posterior. Su guía de proveedores abarca endpoints personalizados, selección de protocolo y grupos de credenciales; también advierte que las pruebas de conexión envían solicitudes al upstream y pueden consumir uso o límites de solicitudes.

Incluye CCR en tu lista de opciones si: necesitas reglas de enrutamiento explícitas y una explicación de la ruta resuelta. La contrapartida es la política que tendrás que mantener. Más condiciones y rutas alternativas implican más combinaciones que validar, no mejores resultados automáticamente.

CLIProxyAPI: empieza con cuentas y un proxy compatible

CLIProxyAPI parte de un modelo de servidor proxy. Expone interfaces compatibles con OpenAI, incluidas Responses; interfaces compatibles con Gemini, incluidas Interactions; e interfaces compatibles con Claude para clientes y SDK.

Su README documenta compatibilidad con OAuth de Codex y Claude Code, acceso a cuentas de Gemini y equilibrio de carga round-robin entre varias cuentas de varios proveedores. También admite upstreams compatibles con OpenAI configurados y ofrece un SDK reutilizable para Go.

Es un punto de partida útil cuando el requisito central es contar con un endpoint compatible respaldado por cuentas o credenciales. No demuestra que el proyecto principal edite de forma nativa los perfiles de todos los agentes.

Dos detalles de empaquetado influyen en la decisión:

• El README recomienda un complemento de escritorio independiente, EasyCLIProxyAPI, para la configuración gráfica, las actualizaciones, los controles de la bandeja del sistema y el inicio/detención del servicio.
• Desde v6.10.0, CLIProxyAPI y CPAMC ya no incluyen estadísticas de uso integradas; el README remite a proyectos independientes de estadísticas y gestión.

Al calcular el mantenimiento, considera el proxy, el complemento de escritorio y el servicio de análisis como componentes independientes. No deduzcas que CLIProxyAPI carece de controles de reintento o recuperación: consulta la configuración de la versión elegida. Del mismo modo, no confundas el reparto de cuentas round-robin con una política garantizada de alternativas entre modelos.

Incluye CLIProxyAPI en tu lista de opciones si: necesitas un proxy respaldado por cuentas y te resulta cómodo elegir por separado los componentes de gestión que lo rodean.

Antes de conectar un proyecto real

Estas herramientas están muy cerca de las credenciales, el contexto del código fuente y las acciones ejecutables de los agentes. Un proceso local sigue formando parte de tu perímetro de confianza.

Primero, distingue entre una clave de API y un inicio de sesión por suscripción. Que un software admita un flujo OAuth no significa que el proveedor permita cualquier uso entre clientes. CC Switch advierte expresamente sobre el uso de suscripciones fuera de los clientes oficiales. Consulta las condiciones vigentes del proveedor y las normas de tu organización; un gestor no concede derechos adicionales ni elimina límites.

Segundo, decide quién es responsable de cada archivo de configuración. Como precaución operativa, evita que varios gestores reescriban automáticamente los mismos ajustes de agente. Haz copias de seguridad de los archivos originales y asegúrate de saber cómo volver al acceso directo. Esta recomendación no implica que se haya demostrado un defecto en estos productos.

Tercero, comprueba cómo se gestionan las credenciales y los registros. Esta comparación no ha verificado el cifrado en reposo. Revisa los permisos, el alcance de las copias de seguridad y la sincronización, la detección de cuentas y el contenido de los registros de solicitudes antes de importar credenciales de producción. Si habilitas el acceso remoto, revisa la autenticación y los ajustes de exposición; no consideres que una configuración local predeterminada garantice la seguridad.

Por último, prueba el comportamiento de los protocolos, no solo sus nombres. OpenAI Chat Completions y Responses son API distintas; Anthropic Messages y Gemini tienen sus propias estructuras. Afirmar que se realiza una conversión no garantiza un comportamiento sin pérdidas en todas las herramientas, campos de razonamiento o imágenes.

Una pequeña prueba de aceptación

Lo siguiente es un ejercicio propuesto para el lector, no una prueba realizada para este artículo:

1. Usa un repositorio descartable y credenciales de prueba con pocos privilegios. Guarda una copia de la configuración original del agente.
2. Conecta un agente a un proveedor. Verifica una respuesta sencilla e inspecciona el proveedor/modelo que se seleccionó realmente.
3. Pídele que lea un archivo inocuo y proponga un pequeño cambio. Comprueba que se complete el ciclo de llamada a herramienta y resultado, y que finalice el streaming, antes de permitir escrituras.
4. Añade una segunda ruta solo si hace falta. Con un mock local seguro o una configuración de prueba autorizada, comprueba la condición de fallo prevista y si se selecciona el destino alternativo documentado. Evita agotar deliberadamente cuotas de pago.
5. Confirma que los reintentos o la recuperación no provoquen que se repitan acciones de herramientas con efectos secundarios en tu flujo de trabajo. Este es un criterio de aceptación, no un error de producto observado.
6. Detén el gestor y verifica el procedimiento documentado para volver al acceso directo o restaurar la configuración. Comprueba los requisitos de reinicio y, después, compara las estimaciones de uso con los registros del proveedor.

Elige la configuración más sencilla que supere este ejercicio. Si un agente con su proveedor oficial ya satisface tus necesidades, añadir una pasarela local quizá no resuelva ningún problema.

Veredicto: elige quién se encarga, no un ganador

Para el enrutamiento compartido de modelos y cuentas entre agentes, empieza por Magpie. Para la configuración de escritorio y la gestión de espacios de trabajo, empieza por CC Switch. Para las políticas explícitas de solicitudes y la inspección de rutas, empieza por CCR. Para un proxy reutilizable respaldado por cuentas, empieza por CLIProxyAPI y ten en cuenta sus componentes complementarios.

Estas recomendaciones describen el énfasis que refleja la documentación, no una superioridad medida. La configuración adecuada es aquella que te permite explicar qué modelo gestionó una solicitud, qué credenciales utilizó, qué ocurre si falla y cómo revertir el cambio.

Preguntas frecuentes

¿CC Switch solo sirve para cambiar la configuración?
No. Documenta los modos Direct, Routing y Aggregation, incluida la conversión local de formatos y las colas de conmutación por error para cada herramienta. La disponibilidad varía según el cliente y el proveedor.

¿La agregación ofrece automáticamente una alternativa si algo falla?
No. CC Switch separa explícitamente la agregación de la conmutación por error. Un selector de modelos combinado no constituye una política de recuperación.

¿Magpie mantiene todas las solicitudes en local?
No. Su pasarela se ejecuta localmente, pero la inferencia con proveedores remotos envía las solicitudes al upstream. Su README también documenta controles de telemetría y el recuento independiente de eventos de socios. El enmascaramiento opcional está desactivado de forma predeterminada y puede no detectar ciertos valores o clasificarlos incorrectamente.

¿Cambiar de modelo modifica las herramientas y los permisos del agente?
No por sí solo. El agente sigue siendo responsable de su entorno de herramientas y de las reglas de permisos; también hay que validar cómo gestiona esas herramientas el nuevo modelo.

¿Se puede sustituir una clave de API por un inicio de sesión de suscripción en cualquier cliente?
No lo des por hecho. La compatibilidad técnica con el inicio de sesión, los modelos disponibles, los derechos de la cuenta y los permisos del proveedor son cuestiones distintas. Consulta las condiciones vigentes y las políticas de tu organización.

¿Qué producto es más rápido o más seguro?
Esta comparación no permite determinarlo. Se basa en documentación oficial y no incluye ningún benchmark de rendimiento independiente, medición de fiabilidad ni auditoría de seguridad.

Fuentes

Fuentes oficiales consultadas el 3 de noviembre de 2026:

1. README de Magpie — pasarela, agentes, grupos, Library y comportamiento relacionado con la privacidad.
2. README de CC Switch — modos de conexión, compatibilidad por agente, reinicios y almacenamiento.
3. README de Claude Code Router — perfiles de agente, enrutamiento, credenciales y despliegue.
4. README de CLIProxyAPI — interfaces compatibles, cuentas, software complementario y límites de las estadísticas.
5. Guía de proveedores de CCR — protocolos upstream, proveedores personalizados, grupos de credenciales y costes de las solicitudes de prueba.