Nota del autor: tanto magpie como CC Switch modifican los archivos de configuración de los agentes en tu equipo. En este artículo comparamos su arquitectura, ritmo de lanzamientos, capacidades y público al que se dirigen, y explicamos por qué solo puedes dejar que uno de los dos escriba la configuración.
Últimamente, ~/.claude/settings.json se encuentra en una situación un poco incómoda. CC Switch lleva más de un año trabajando con él: al cambiar de proveedor, solo modifica los campos de conexión y deja intacto todo lo demás. Pero magpie también quiere escribir en ese archivo y cambia la dirección de conexión a 127.0.0.1:3425. Como ambos programas escriben en él, prevalece el último: los cambios del anterior se sobrescriben sin aviso. Por eso, en un momento dado, solo uno debería encargarse de ese archivo.
El ritmo de los dos proyectos es muy diferente. Hasta el 28 de octubre de 2026, los números de versión acumulados de magpie ya habían superado los 1000 desde la creación de su repositorio de lanzamientos, el 23 de septiembre de 2026. Solo el 27 de octubre, la API de GitHub registró 87. Por su parte, CC Switch pasó de la v3.19.0 (30 de julio de 2026) a la v4.0.21 (26 de octubre de 2026): 30 versiones estables en tres meses, cada una con notas de lanzamiento en chino. Magpie significa «urraca» en inglés, y esta urraca anuncia decenas de actualizaciones al día.
La comunidad también está dividida sobre magpie. El 10 de octubre de 2026 apareció una publicación en linux.do titulada «Es muy confuso usar magpie; si estás acostumbrado a CC Switch, no recomiendo cambiar». Al día siguiente apareció otra: «¿Por qué todo el mundo recomienda magpie? Lo descargué y no veo qué tiene de mejor». A algunas personas les preocupa que CC Switch desaparezca, pero nuestra conclusión es que no será reemplazado, aunque magpie sí le ha quitado una parte de sus usuarios.
Este artículo no es un tutorial de instalación ni pretende declarar un ganador absoluto. Solo buscamos aclarar las diferencias entre ambos enfoques para ayudarte a decidir con cuál quedarte.
Magpie VS CC Switch: decenas de paquetes al día frente a 30 versiones en tres meses
La diferencia más evidente entre ambos proyectos está en su ritmo de publicación, así que empecemos por ahí. El número de versión de magpie sigue en 0.1.x, pero el número de parche crece rápidamente. En las 25 horas transcurridas entre el 3 de octubre de 2026 a las 13:00 y el 4 de octubre a las 14:00, pasó de v0.1.756 a v0.1.859: exactamente 100 versiones. Al 28 de octubre de 2026, la más reciente era v0.1.1801. La API de GitHub solo devuelve como máximo los primeros 1000 registros de publicación, por lo que ya no se pueden consultar los más antiguos. El total sigue aumentando.
Conviene aclarar qué significan estos números de versión. Son números de parche generados por compilaciones automáticas: prácticamente cada commit produce un paquete. Eso no equivale a 1000 mejoras de funcionalidad. Esta frecuencia refleja dos cosas: el mantenimiento es muy activo y los problemas se corrigen rápido; al mismo tiempo, la serie 0.1.x sigue en una etapa de experimentación intensa y el propio número de versión advierte que no cabe esperar una gran estabilidad.
| Indicador (al 2026-10-28) | magpie | CC Switch |
|---|---|---|
| Creación del repositorio | 2026-09-23 | 2025-08-04 |
| Última versión | v0.1.1801 | v4.0.21（2026-10-26） |
| Ritmo de publicación | Hasta 87 en un solo día según los registros consultados; más de 1000 acumulados | 30 versiones oficiales en tres meses |
| Estrellas en GitHub | Unas 23.800 | Unas 149.000 |
| Herramientas compatibles | El README enumera 68 agentes | 12 herramientas, cada una con una configuración predefinida |
| Mantenimiento | No acepta PR externos; solo los mantenedores pueden abrirlos | Colaboración abierta mediante issues y PR |
Al poner lado a lado las 149.000 estrellas y los 100 paquetes en un día, se ve que los proyectos están en etapas distintas: CC Switch ya tiene una enorme comunidad de usuarios, mientras que magpie sigue iterando rápidamente. No se trata de cuál trabaja más, sino de diferencias en el ritmo de los equipos y su tolerancia al riesgo. El autor de CC Switch cuenta que cerró más de 500 issues antiguos durante la reestructuración de la versión 4.0. Por su parte, magpie alcanzó unas 23.800 estrellas en poco más de un mes, aunque conviene separar la popularidad de la estabilidad.
Un detalle más: la página de CC Switch en la documentación de APIYI (tutorial de casos de uso en docs.apiyi.com) todavía menciona la versión v3.12.0 y 5 herramientas. Está desactualizada frente a las 12 herramientas y la versión v4.0.21 del repositorio oficial. Para confirmar las versiones, consulta GitHub.
Magpie VS CC Switch: ¿modificar archivos de configuración o pasar primero por una pasarela local?
La diferencia fundamental está en el enfoque: CC Switch gira en torno a los agentes; magpie, en torno a una pasarela.
Al cambiar de proveedor, CC Switch solo reemplaza los campos de conexión en los archivos de configuración de cada herramienta: dirección de solicitud, clave API y modelo. Los complementos, hooks, MCP, ajustes personalizados y comentarios se conservan intactos. Además, antes de la primera modificación, crea automáticamente una copia de seguridad del archivo original. Claude Code, Codex y Gemini CLI usan el modo de «cambio»: solo hay un proveedor activo a la vez. OpenCode, OpenClaw, Hermes y Pi usan el modo de «coexistencia»: varios proveedores se guardan simultáneamente en la configuración de la propia herramienta. CC Switch también ofrece enrutamiento local, pero hay que activarlo manualmente. Una vez activado, permite convertir entre los protocolos Anthropic Messages, OpenAI Chat Completions, OpenAI Responses y Gemini Native, y ofrece una cola de conmutación por error y un mecanismo de circuito abierto.
magpie, en cambio, dirige primero las conexiones de todos los agentes a 127.0.0.1:3425, almacena las claves de forma centralizada y reenvía las solicitudes al proveedor a través de la pasarela. Esta permite convertir entre cuatro protocolos, incluidos la salida en streaming, las llamadas a herramientas y el contenido de razonamiento. También modifica los campos clave de la configuración de cada agente. Como dice su README, magpie «modifica la única clave que importa en la configuración del propio agente», mediante escritura atómica y conservando los comentarios, el orden y el formato. Si prefieres que no modifique los archivos de configuración, también puedes apuntar OPENAI_BASE_URL, ANTHROPIC_BASE_URL y GOOGLE_GEMINI_BASE_URL a la pasarela local y usar magpie como clave API.
| Aspecto | magpie | CC Switch |
|---|---|---|
| Enfoque | Pasarela local + conmutador | Gestor de configuración de escritorio + enrutamiento local opcional |
| Método de cambio | La solicitud pasa primero por 127.0.0.1:3425 y después se envía |
Modifica los campos de conexión en la configuración de cada herramienta |
| Tolerancia a fallos entre cuentas | Cinco modos de grupos de enrutamiento + conmutación por error entre varias cuentas + calentamiento diario | Cola de conmutación por error + circuito abierto + supervisión del estado |
| Gestión diaria | Library: escribe una sola vez instrucciones, MCP, skills y subagentes | Panel de MCP + Skills + biblioteca de indicaciones + gestor de sesiones |
| Sesiones | La lista muestra el costo de cada sesión y permite reabrirla en la terminal con un clic | Contenido estructurado, resúmenes por turno, exportación y comandos de recuperación |
| Formatos disponibles | Escritorio, TUI, CLI, Web UI, Docker y Termux | Escritorio + bandeja del sistema |
Ventajas de magpie: enrutamiento, tolerancia a fallos y migración
Los principales atractivos de magpie son:
- Bajo coste de migración: la función Import de la página de proveedores permite importar directamente los proveedores de CC Switch y completar la migración en pocos minutos. Es el punto que más directamente afecta a CC Switch.
- Grupos de enrutamiento: puedes presentar un grupo a un agente como si fuera un modelo, por ejemplo,
group/daily-coding. Cada grupo admite cinco modos: smart, order, rotate, usage y pace. Las sesiones que pueden beneficiarse de la caché permanecen en la cuenta que respondió primero. - Suscripciones como proveedores: las suscripciones de Claude, ChatGPT y Copilot en las que ya has iniciado sesión pueden convertirse en proveedores para otros agentes. Esta función se puede desactivar en los ajustes de privacidad.
- Enmascaramiento de datos: las claves, los tokens, las direcciones de correo y otros datos se sustituyen localmente por marcadores antes de enviarse. La función está desactivada por defecto. Si se activa y el enmascaramiento no funciona cuando debería, la solicitud devuelve directamente un error 503, sin enviar el texto original.
- Uso compartido en red local y despliegue: puedes asignar una clave de pasarela independiente a cada cliente y establecer límites de gasto. También puedes ejecutarlo en un NAS con Docker.
Ventajas de CC Switch: una gestión cotidiana más detallada
CC Switch ofrece funciones de gestión diaria más detalladas:
- Panel unificado de MCP: permite seleccionar qué sincronizar en cada herramienta e importar las configuraciones existentes.
- Gestión de Skills: permite instalarlas desde GitHub o un archivo ZIP con un clic y actualizarlas todas de una vez.
- Biblioteca de indicaciones: al activar una indicación, se escribe en CLAUDE.md / AGENTS.md. Antes, el contenido existente en el archivo se guarda en la biblioteca de indicaciones.
- Gestor de sesiones: cada turno se reduce a una línea de resumen y los pasos fallidos se marcan en rojo. Puedes copiar el comando de recuperación para continuar la conversación.
- Instantáneas de proyectos: permiten cambiar de una vez los proveedores, MCP, Skills e indicaciones de cada proyecto.
La versión v4.0.21 también añadió la posibilidad de alternar entre varias cuentas de suscripción oficial de Claude. El inicio de sesión sigue el proceso oficial y los tokens solo se guardan en la ubicación propia de Claude Code. CC Switch no los registra ni los sube, y tampoco rota automáticamente las cuentas en función de sus cuotas. Es un diseño más conservador, justo lo contrario del enfoque de magpie.
Las herramientas solo retransmiten: el modelo y la clave detrás de Magpie y CC Switch
Elijas la herramienta que elijas, su función es reenviar las solicitudes: tendrás que conseguir el modelo y la clave por separado. Para que todo funcione sin problemas, necesitas una clave API de claude-opus-5-5 estable y disponible. APIYI (apiyi.com) ofrece tanto un endpoint compatible con Anthropic como otro compatible con OpenAI, por lo que puedes conectar directamente cualquiera de las dos herramientas.
| Elemento de configuración | Valor | Descripción |
|---|---|---|
| Dirección compatible con Anthropic | https://api.apiyi.com |
Sin /v1, adecuada para Claude Code |
| Dirección compatible con OpenAI | https://api.apiyi.com/v1 |
Adecuada para Codex y otras herramientas que usan el protocolo de OpenAI |
| Nombre del modelo | claude-opus-5-5 |
La versión thinking claude-opus-5-5-thinking tiene el mismo precio |
| Precio (por millón de tokens) | Entrada: $4 / salida: $20 / lectura de caché: $0.2 | Datos al 28 de octubre de 2026; consulta la lista de modelos de la plataforma para conocer los modelos y precios vigentes |
| Endpoints y grupos | chat, messages; grupos ClaudeCode, Default, SVIP, entre otros | Elige el grupo según tus necesidades |
Ten en cuenta que ambas herramientas leen la misma configuración del agente. CC Switch escribe la clave API en ~/.claude/settings.json, mientras que magpie la guarda en la puerta de enlace; en ambos casos se utiliza la misma cuenta del proveedor. Por eso, solo tienes que cambiar la clave una vez en la consola de APIYI. También puedes consultar el saldo y el consumo en el mismo lugar, sin tener que introducirla por separado en las dos herramientas.
Magpie VS CC Switch: recomendaciones según el caso
Quiénes deberían seguir con CC Switch
Si usas principalmente Claude Code, tienes solo uno o dos proveedores, prefieres la estabilidad y no quieres investigar problemas después de cada actualización, CC Switch es más adecuado. Introduce pocos cambios, cuenta con un buen sistema de copias de seguridad y, si algo falla, puedes abrir el archivo de configuración para ver la causa. Quienes organizan con frecuencia MCP, Skills e indicaciones, o necesitan consultar sesiones anteriores, también se sentirán más cómodos con la interfaz y el funcionamiento de CC Switch.
La persona que abrió el hilo del 10-10 lo expresó directamente: «No tiene ningún sentido cambiar a esto y mezclar todos los proveedores; es demasiado caótico. Y lo peor es que, después de seleccionar un modelo con este software, ya no puedes cambiarlo desde la CLI». En el mismo hilo, otra persona comentó: «Por ahora no veo ninguna función exclusiva que deje a CCS atrás». Lo que necesitan estos usuarios es cambiar de proveedor con un clic, y CC Switch ya les permite hacerlo.
Quiénes deberían cambiar a magpie
Si usas varios agentes a la vez, como Codex, Gemini CLI, OpenCode o Pi, tienes varias suscripciones y claves, quieres cambiar automáticamente cuando se agote una cuota y además necesitas un panel de costos, el enfoque de pasarela de magpie te resultará más adecuado. Ese mismo día, alguien comentó en el hilo: «Esta tarde cambié de ccswitcg a magpie y por fin ya no tengo que probar la disponibilidad de cada proxy uno por uno». En el hilo del 10-11, otra persona a favor señaló que «añadir y cambiar proveedores es más fácil en magpie que en ccs, y además tiene reglas de enrutamiento muy potentes». También se mencionó que CC Switch no permite mostrar ni cambiar modelos correctamente en la app de Codex.
Conviene tratar por separado las opiniones negativas sobre magpie. Una persona informó que, tras integrar magpie, la caché de Claude parecía dejar de funcionar y los costos habían aumentado. En el hilo, otra persona dijo que sospechaba que la capa intermedia había añadido una revisión de indicaciones, lo que provocaba el rechazo de solicitudes. Ambos son casos aislados y no hay pasos para reproducirlos, así que no se puede concluir que magpie presente estos problemas. Las fuentes de este artículo se dividen en tres categorías: lo que afirma oficialmente el proyecto, testimonios aislados de terceros y cuestiones aún sin resolver. Conviene tenerlas en cuenta por separado.
Magpie VS CC Switch: cuál elegir según tus necesidades
| Tu situación | Recomendación | Motivo |
|---|---|---|
| Solo usas Claude Code con uno o dos proveedores y buscas estabilidad | CC Switch | Hace pocos cambios, tiene copias de seguridad y mantiene un ritmo estable de lanzamientos: 30 versiones oficiales en tres meses |
| Usas varios agentes y cuentas, y necesitas tolerancia automática a fallos y un panel de costes | magpie | Grupos de enrutamiento + failover + estadísticas de uso |
| Tus principales necesidades son MCP, Skills, indicaciones y revisión de sesiones | CC Switch | Panel de gestión más detallado y análisis de sesiones más completo |
| Necesitas compartir en la red local, ejecutarlo en un NAS o traducir protocolos para agentes no compatibles | magpie | Ofrece una puerta de enlace y despliegue con Docker |
| Quieres usar ambos | Deja que solo uno escriba la configuración | Consulta la siguiente sección |
💡 Consejo: si no sabes cuál elegir, prueba cada herramienta durante una tarde con la misma clave. Los pasos para configurar CC Switch están en el tutorial de APIYI
docs.apiyi.com/scenarios/programming/cc-switch; para conectar magpie a la puerta de enlace unificada, consultahelp.apiyi.com/magpie-unify-claude-code-codex-pi-hermes-api-gateway.html. Solo tienes que seguir los tutoriales, sin empezar desde cero.
El problema de instalar ambos: solo un programa debe gestionar settings.json
Volvamos a la pregunta del principio. magpie y CC Switch modifican los mismos archivos, como ~/.claude/settings.json y ~/.codex/config.toml. Si ambos están en ejecución y cambias de proveedor en uno, la configuración del otro se sobrescribirá silenciosamente, sin ningún aviso. Después, el proveedor que use Claude Code dependerá de cuál haya escrito por última vez.
Para que ambos convivan, debes decidir quién controla los archivos de configuración: uno se encarga de escribir y el otro solo lee, o se cierra después de usarlo. Por ejemplo, puedes dejar que CC Switch gestione MCP y las indicaciones, y encargar todo el cambio de proveedores a magpie; o hacerlo al revés. No conviene que ambos programas escriban por su cuenta de forma continua. Si piensas migrar, puedes usar la función Import de magpie para importar los proveedores de CC Switch. Una vez que compruebes que todo está bien, cierra la herramienta anterior para evitar que ambas escriban al mismo tiempo.
Riesgos y posibles bloqueos de cuenta: haz una copia de seguridad antes de usar Magpie o CC Switch
Conviene tener en cuenta lo siguiente:
- Ambos son herramientas de código abierto de terceros (con licencia MIT) y modifican los archivos de configuración de los agentes locales. Antes de instalarlos, haz una copia manual de archivos como
~/.claude/settings.jsony~/.codex/config.toml; no dependas por completo de las copias de seguridad integradas. - Usar suscripciones fuera de los clientes oficiales puede infringir las condiciones del servicio: esto se aplica a suscripciones de Claude, ChatGPT y Copilot. La propia documentación de CC Switch incluye una advertencia similar. La función de magpie que permite usar una suscripción como proveedor se puede desactivar en Settings → Privacy.
- Las consecuencias son responsabilidad del usuario: esto incluye configuraciones sobrescritas, pérdida de cuota o riesgos para la cuenta. Este artículo no respalda a ninguna de las partes. Lo recomendable es probar primero con una cuenta secundaria o en un proyecto de menor importancia.
Preguntas frecuentes
Q1: ¿Se pueden instalar Magpie y CC Switch al mismo tiempo?
Sí, pero no pueden escribir en la configuración al mismo tiempo. Ambos modifican el mismo archivo `~/.claude/settings.json`, así que debes elegir uno para escribir y dejar el otro en modo de solo lectura o cerrarlo.
Q2: Magpie publicó miles de versiones en poco más de un mes. ¿Es muy inestable?
Se trata principalmente de números de parche generados mediante compilaciones automáticas, lo que indica que se mantiene con frecuencia y los errores se corrigen rápido. Aun así, la versión 0.1.x sigue en una etapa de prueba y error. Si necesitas mucha estabilidad, conviene esperar un tiempo.
Q3: ¿Magpie puede invalidar la caché y aumentar los costos?
Por ahora solo hay comentarios aislados de algunos usuarios, sin una forma de reproducir el problema, así que no se puede sacar una conclusión. Si te preocupa, puedes comparar el panel de uso antes y después del cambio para comprobarlo.
Q4: Si cambio de herramienta, ¿tengo que solicitar una clave API nueva?
No. Ambas herramientas solo reenvían las solicitudes, así que puedes seguir usando la misma clave API. Adminístrala desde la consola de APIYI en apiyi.com e introdúcela en CC Switch o magpie.
Q5: ¿Qué dirección debo usar para claude-opus-5-5?
Claude Code usa el protocolo de Anthropic, así que debes introducir la dirección sin `/v1`. Para Codex y otras herramientas que usan el protocolo de OpenAI, utiliza la dirección con `/v1`. Al 28 de octubre de 2026, los precios eran $4 por entrada, $20 por salida y $0.2 por lectura de caché (por cada millón de tokens). Consulta la lista de modelos de apiyi.com para conocer los precios vigentes.
Q6: ¿Magpie reemplazará a CC Switch?
No. Funcionan en niveles distintos: CC Switch administra y cambia la configuración de los agentes, mientras que magpie hace que todas las solicitudes pasen primero por una puerta de enlace local. Los usuarios de CC Switch más afectados serían quienes solo necesitan cambiar de proveedor con un clic.
Magpie VS CC Switch: puntos clave
- Enfoques distintos: CC Switch modifica los archivos de configuración; magpie hace que las solicitudes pasen primero por una puerta de enlace local en
127.0.0.1:3425. - Ritmos distintos: hasta el 28 de octubre de 2026, magpie acumulaba más de 1000 números de versión, mientras que CC Switch publicó 30 versiones oficiales en tres meses.
- Cada uno tiene sus ventajas: magpie destaca en enrutamiento, tolerancia a fallos y traducción entre protocolos; CC Switch, en MCP, Skills y gestión de sesiones.
- No pueden escribir a la vez: ambos modifican el mismo settings.json, así que solo uno puede tener permiso de escritura.
- Las opiniones negativas suelen ser casos aislados: los comentarios sobre caché, censura y otros problemas no incluyen pasos para reproducirlos, por lo que no pueden tomarse como conclusiones.
- La clave solo se gestiona una vez: se cambia de forma centralizada en la consola de APIYI; ambos instrumentos leen la misma configuración del agente.
Resumen
La comparación entre magpie y CC Switch refleja, en esencia, dos enfoques: uno centrado en una puerta de enlace y en la iteración rápida, y otro centrado en la configuración del agente y en una mejora constante. magpie ha atraído a parte de los usuarios que «solo quieren cambiar de proveedor con un clic», mientras que CC Switch sigue ofreciendo funciones de gestión diaria más detalladas. El debate en la comunidad continuará durante un tiempo, pero para los usuarios individuales la elección es bastante sencilla.
Solo un programa puede gestionar ~/.claude/settings.json a la vez. Elige una herramienta según los cinco escenarios anteriores y úsala a largo plazo; no hace falta alternar entre las dos.
Puedes preparar el modelo y la clave en APIYI, apiyi.com. Con la misma clave puedes acceder a claude-opus-5-5 y usarlo directamente con cualquiera de las dos herramientas.
📚 Referencias
- Repositorio de magpie en GitHub: pasarela local unificada de IA y selector de modelos
- Enlace:
github.com/yetone/magpie -
Descripción: el README incluye una lista de 68 agentes y una explicación de la pasarela. La versión en chino está en README.zh-CN.md
-
Documentación oficial de magpie: funciones y configuración
- Enlace:
usemagpie.ai/docs -
Descripción: información detallada sobre grupos de enrutamiento, enmascaramiento de datos privados y uso compartido en la red local
-
Repositorio de CC Switch en GitHub: gestor multiplataforma todo en uno
- Enlace:
github.com/farion1231/cc-switch -
Descripción: notas de lanzamiento y registro detallado de correcciones; consulta aquí la información oficial sobre las versiones
-
Sitio oficial de CC Switch: información del producto y descargas
- Enlace:
ccswitch.io - Descripción: lista de herramientas compatibles e instrucciones de uso
Autor: Equipo técnico de APIYI
Consultas técnicas: puedes contactarnos desde la página principal de APIYI. Encontrarás más recursos de integración en el centro de documentación docs.apiyi.com
