¿Qué es CC Switch?
El README de GitHub llama a CC Switch el «All-in-One Manager» de las herramientas de programación con IA y promete cambiar de proveedor con un clic, sin editar a mano archivos de configuración JSON, TOML o YAML. Es una aplicación de escritorio que edita y, de forma opcional, actúa como proxy de los ajustes de herramientas que se instalan por separado.
- Línea actual: el proyecto está en la versión 4; la última versión de GitHub es la v4.0.35 y las tres versiones más recientes se publicaron en días consecutivos
- Documentación: las guías de proveedores, enrutamiento, MCP, Skills y sesiones están en la documentación oficial
- Autor: la LICENSE nombra a Jason Young; ninguna empresa figura en los archivos del repositorio ni en el sitio
- Lo que no es: no es un modelo de IA, ni una API alojada, ni una pasarela de equipo
Qué hace CC Switch
Según el README, las funciones abarcan proveedores, enrutamiento, recursos compartidos, uso, sesiones y sincronización.
- Proveedores — más de 90 preajustes, entre ellos AWS Bedrock, NVIDIA NIM y relés de la comunidad, o una configuración personalizada; cambio desde la bandeja del sistema para Claude Code, Claude Desktop, Codex, Gemini CLI y Grok Build
- Enrutamiento — convierte entre los formatos Anthropic Messages, OpenAI Chat Completions, OpenAI Responses y Gemini Native, de modo que GPT puede funcionar en Claude Code y Claude en Codex; una cola de conmutación por error con cortacircuitos pasa al siguiente proveedor cuando falla una solicitud
- Agregación — Claude Code y Codex muestran modelos de varios proveedores en una sola lista y cada solicitud va al proveedor del modelo elegido; según el README, este modo no ofrece conmutación por error
- Recursos compartidos — servidores MCP sincronizados con las herramientas que elijas, Skills instaladas desde skills.sh o GitHub, archivos de prompts por herramienta (CLAUDE.md, AGENTS.md, GEMINI.md) y proyectos guardados que cambian toda una configuración de una vez
- Uso y sesiones — estadísticas de tokens, costes y aciertos de caché leídas de los registros de sesión locales incluso sin enrutamiento, cuota restante en las tarjetas de proveedor y una vista de lectura del historial de sesiones con búsqueda y exportación a Markdown
- Sincronización y enlaces — sincronización opcional por WebDAV o S3, enlaces profundos
ccswitch://para importar proveedores y una interfaz en ocho idiomas
Obtener CC Switch
El camino más fácil es el instalador de tu sistema en la página de GitHub Releases, o Homebrew en macOS. El sitio oficial enlaza las mismas versiones.
Opción | Cómo obtenerlo |
|---|---|
| Windows (la más fácil) | CC-Switch-v4.0.35-Windows.msi o el ZIP portátil, desde Releases |
| macOS | .dmg desde Releases o brew install --cask cc-switch |
| Linux | .deb, .rpm o .AppImage (x86_64 y ARM64); Arch: paru -S cc-switch-bin |
| Sitio web | ccswitch.io |
| Documentación | ccswitch.io/en/docs |
| Código fuente (GitHub) | farion1231/cc-switch |
La versión actual es la 4.0.35, publicada el 18 de noviembre de 2026; la última actualización upstream fue el último commit del 19 de noviembre de 2026, según GitHub, comprobado el 19 de noviembre de 2026. El README pide Windows 10 o posterior, macOS 12 o posterior, y Linux con glibc 2.35+ y WebKitGTK 4.1 (RHEL, Rocky y Alma 8–9 aún no son compatibles); indica que la versión de macOS está firmada y notarizada, algo que PromptQuorum no verificó. No se ejecutó ningún instalador.
Instalación y primeros pasos
Estos pasos siguen el Quick Start del README, comprobado el 19 de noviembre de 2026; PromptQuorum no los ha ejecutado.
- 1Instala la aplicación
Why it matters: Ejecuta el instalador de tu sistema o, en macOS, `brew install --cask cc-switch`. - 2Deja que importe tu configuración
Why it matters: Según el README, en el primer inicio CC Switch importa tu configuración existente de Claude Code, Codex, Gemini CLI y Grok Build como un proveedor llamado `default` y añade un proveedor oficial para cada herramienta. - 3Añade un proveedor
Why it matters: Selecciona una herramienta en la barra lateral, pulsa «+», elige un preajuste o una configuración personalizada e introduce tu clave. - 4Cambia y reinicia
Why it matters: Pulsa «Enable» en el proveedor; Claude Code no necesita reinicio, mientras que Codex, Gemini CLI y Grok Build requieren una terminal o sesión de CLI nueva.
Precio, licencia y privacidad
CC Switch es gratuito y de código abierto; el README y el sitio no mencionan ningún plan de pago, y el uso lo factura el proveedor que añadas.
- Licencia: MIT, copyright 2025 Jason Young, según el repositorio
- Flujo de datos: el SECURITY.md describe CC Switch como una aplicación de escritorio local sin backend en la nube operado por el proyecto; las solicitudes que enrutes van al proveedor o relé que elijas, que las ve
- Proxy local: el mismo archivo indica que su dirección y puerto son configurables y pueden enlazarse a una interfaz que no sea loopback; revisa ese ajuste antes de exponerlo
- Datos remotos: según SECURITY.md, la aplicación descarga un JSON de precios de modelos y avatares de proveedores (comprobado allí para la v3.18.0)
- Sincronización: la sincronización por WebDAV o S3 es opcional y, según el README, escribe en un almacenamiento que tú eliges
- Suscripciones: el README advierte de que usar una suscripción de ChatGPT, Copilot o Grok fuera del cliente oficial puede infringir las condiciones del proveedor y te pide que evalúes el riesgo por tu cuenta
- Patrocinadores: el README incluye banners y códigos de descuento de servicios de relé de terceros; PromptQuorum no ha evaluado ninguno
¿Quién debería usar CC Switch?
CC Switch encaja con desarrolladores que ya usan CLI de programación con IA y saben añadir sus propias claves de API.
Usa CC Switch si
- Cambias entre varias herramientas de programación con IA o proveedores de API y editas a mano sus archivos de configuración
- Quieres GPT en Claude Code, Claude en Codex o conmutación automática entre proveedores
- Quieres gestionar servidores MCP y Skills en un solo lugar
Busca otra opción si
- Necesitas una empresa con política de privacidad publicada como encargada del tratamiento
- Necesitas un servidor pasarela compartido para un equipo; SECURITY.md no describe ningún modelo multiusuario
- Usas RHEL, Rocky o Alma 8–9, que el README indica como no compatibles
CC Switch frente a otros enrutadores y pasarelas
CC Switch gestiona los ajustes de las herramientas de programación en un equipo, mientras que las herramientas siguientes son servidores pasarela. Consulta el Directorio de IA local para ver el catálogo completo.
- LiteLLM — una pasarela única compatible con OpenAI para más de 100 API de proveedores, con enrutamiento y seguimiento de costes; un servidor que ejecutas para aplicaciones o un equipo. Consulta la reseña de LiteLLM.
- ClawRouter — un enrutador autoalojado para agentes autónomos que decide localmente qué modelo llamar; descrito en nuestra reseña como un proxy local de Node.js con CLI, no como una aplicación de escritorio con interfaz gráfica. Consulta la reseña de ClawRouter.
- AIClient2API — un proxy autoalojado que convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API compatible con OpenAI. Antes de usar suscripciones de este modo, ten en cuenta la advertencia sobre los términos de los proveedores en «Precio, licencia y privacidad». Consulta la reseña de AIClient2API.
Preguntas frecuentes
¿Incluye CC Switch un modelo de IA?
No. Edita y actúa como proxy de los ajustes de otras herramientas; los modelos y la facturación vienen del proveedor que añadas, como una API oficial, una plataforma en la nube como AWS Bedrock o un relé.
¿Cambiar de proveedor sobrescribe mis plugins y hooks?
Según el README, solo se sustituyen los campos clave como endpoint, clave, nombre del modelo y protocolo, mientras que plugins, hooks, permisos, MCP y comentarios se conservan. Además, hace una copia de cada archivo de configuración en ~/.cc-switch/backups/live-first-write/ antes de la primera reescritura.
¿Por qué los modelos agregados no aparecen en Codex?
Codex lee su lista de modelos solo al iniciar, así que tras cambiar la Agregación debes reiniciar Codex por completo; según el README, cerrar la terminal no basta porque se comparte un único demonio en segundo plano.
¿Cuál es el sitio web oficial?
El README y el llms.txt oficial señalan ccswitch.io como el único sitio oficial y indican que otros dominios con ese nombre no están afiliados al proyecto.
