CC Switch: herramienta de código abierto y multiplataforma para gestionar configuraciones de programación con IA

Qué es CC Switch

CC Switch es una herramienta de código abierto para gestionar configuraciones en escenarios de programación con IA, compatible con macOS, Windows y Linux. El equipo del proyecto la describe como un hub integral de herramientas de programación con IA, pensado para administrar varias aplicaciones agente desde una sola interfaz.

Según la documentación pública del sitio oficial, CC Switch permite gestionar de forma unificada Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw y Hermes Agent. Otra descripción oficial también menciona Grok Build, Pi y MiniMax Code, lo que indica que la cobertura continúa ampliándose.

Funciones principales

Gestión unificada de proveedores

Administra desde una sola interfaz los proveedores de modelos, la información de autenticación y los endpoints de API de varias aplicaciones agente. Admite cambio en caliente y recuperación desde copias de seguridad.

Enrutamiento local inteligente

Incluye disyuntores, monitorización de estado y una cola de conmutación por error. Si el proveedor principal presenta una anomalía, puede cambiar automáticamente a un nodo de respaldo para no interrumpir el flujo de trabajo actual.

Seguimiento de uso y costes

Permite consultar en tiempo real el número de solicitudes, el consumo de tokens, los aciertos de caché, la cuota de suscripción y los costes, con filtros por aplicación y por proveedor.

Almacenamiento local seguro

Las configuraciones y las claves de API se guardan en una base de datos SQLite local, con soporte completo de migración de esquema. Los datos no salen del equipo.

Gestión de MCP, Skills y prompts

Unifica servicios MCP, paquetes de Skills, plantillas de prompts y Hermes Memory. Admite sincronización entre aplicaciones y despliegue mediante enlaces simbólicos.

Gestión centralizada de sesiones

Reúne los registros locales de sesión de cada agente y permite buscar, recuperar y eliminar entradas, reduciendo el aislamiento entre aplicaciones.

Mapeo de modelos y conversión de protocolos

Puede asignar los identificadores oficiales de rol de Claude o los nombres de modelo GPT de Codex al modelo real de un proveedor externo, y realizar automáticamente la conversión entre la API de Responses y la API de Chat Completions.

Cómo usar CC Switch

El siguiente flujo de trabajo está basado en la documentación oficial:

1. Descarga e instalación: visita el sitio oficial https://ccswitch.io/, descarga el instalador correspondiente a tu sistema y, tras la instalación, inicia CC Switch.
2. Selecciona los objetivos de gestión: marca en la interfaz principal las aplicaciones agente que quieras gestionar y activa la monitorización desde la barra de herramientas.
3. Añade un proveedor: en la página de configuración de proveedores, introduce la URL del endpoint de API de terceros y el token de autenticación. Al guardar, el sistema comprueba automáticamente la conectividad.
4. Activa el enrutamiento local: para aplicaciones como Codex o Claude Desktop, activa la opción “requiere mapeo de enrutamiento local” y mantén el proxy en ejecución.
5. Configura el mapeo de modelos: en los ajustes de mapeo, asigna a Sonnet/Opus/Haiku o a la serie GPT el nombre real del modelo de terceros que se va a solicitar.
6. Sincroniza Skills: en la página de gestión de Skills, importa paquetes existentes o instala desde un ZIP. La sincronización con los directorios de configuración de cada agente se realiza mediante enlaces simbólicos.
7. Supervisa el uso: consulta en el panel de estadísticas los registros de solicitudes en tiempo real, el consumo de tokens y las curvas de coste, y establece alertas de cuota.

Ventajas principales

• Cobertura total de aplicaciones: es el único gestor que admite simultáneamente Claude Code, Claude Desktop, Codex, Gemini, OpenCode, OpenClaw y Hermes, según la documentación oficial.
• Acceso no intrusivo: no es necesario modificar el código fuente de los agentes; solo hay que apuntar las variables de entorno al proxy local para usar modelos de terceros.
• Enrutamiento de alta disponibilidad: incorpora disyuntores y conmutación por error. Cuando la línea principal falla, puede cambiar a un proveedor de respaldo en milisegundos para mantener la continuidad del desarrollo.
• Transparencia de costes: el seguimiento detallado del uso ayuda a identificar las fases de mayor consumo. Según mediciones oficiales, puede reducir aproximadamente un 30 % del gasto en API.
• Código abierto y gratuito: se publica bajo la licencia MIT, con desarrollo comunitario y sin barreras de licencia comercial.

Enlaces del proyecto

• Sitio oficial: https://ccswitch.io/
• Repositorio de GitHub: https://github.com/farion1231/cc-switch

El sitio oficial también ofrece accesos al repositorio oficial de GitHub, la documentación oficial y el registro de cambios. Se recomienda consultar siempre la información más reciente en la web oficial.

Casos de uso

• Pruebas A/B con varios modelos: compara rápidamente en un mismo proyecto el rendimiento de generación de código de modelos como Claude, GPT, DeepSeek o GLM.
• Tolerancia a fallos de API en entornos empresariales: evita interrupciones por límites de velocidad o fallos de un único proveedor mediante el cambio automático entre proveedor principal y de respaldo.
• Control detallado de costes: permite a los responsables de equipo seguir el consumo de tokens por proyecto o por miembro y optimizar la estrategia de uso de modelos.
• Consolidación de Skills: centraliza herramientas MCP personalizadas y plantillas de prompt para que los nuevos miembros puedan sincronizarlas con un solo clic en todos los agentes.
• Continuidad de sesiones entre aplicaciones: conserva el contexto de la sesión al pasar de Claude Code a Codex y reduce la repetición de instrucciones.

Proyectos relacionados del ecosistema de código abierto

En los materiales públicos también aparecen dos paquetes de Skills de código abierto. Tienen un enfoque distinto al de la gestión de configuración de CC Switch, pero forman parte del ecosistema de programación con IA:

• Skill de diseño de frontend con IA de código abierto: orientado a resolver la estética repetitiva de las interfaces generadas por IA.
• Agent Skill de código abierto del desarrollador Eze: pensado para reflexionar sobre cómo navegar por internet.

Si buscas herramientas similares a CC Switch, la sección “comparativa con productos similares” de la página oficial puede servir como punto de partida para ampliar la consulta.

Aviso sobre precios y verificación

CC Switch es actualmente un proyecto gratuito y de código abierto bajo la licencia MIT. No obstante, los límites de capacidad, los requisitos del sistema y el alcance del soporte pueden cambiar con las versiones. Los datos sobre mapeo de modelos, estrategias de enrutamiento y porcentajes de ahorro de costes proceden de materiales públicos; consúltese la versión más reciente en el sitio oficial. Para cualquier coste de proveedores o API de pago, conviene consultar directamente con el servicio correspondiente.

Preguntas frecuentes

¿Qué sistemas operativos admite CC Switch?

Admite macOS, Windows y Linux. Puedes descargar el instalador correspondiente desde el sitio oficial.

¿Qué aplicaciones de programación con IA admite CC Switch?

La información oficial menciona Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw y Hermes Agent. Otras fuentes públicas también mencionan soporte para Grok Build, Pi y MiniMax Code; consulta la web oficial para conocer el alcance más reciente.

¿Hay que pagar por CC Switch?

No. El proyecto es gratuito y de código abierto bajo la licencia MIT, con desarrollo impulsado por la comunidad.

¿Es necesario modificar el código fuente para usar CC Switch?

No. Utiliza un acceso no intrusivo: solo hay que apuntar las variables de entorno al proxy local para usar modelos de terceros.

¿Dónde se guardan los datos de configuración?

Todas las configuraciones y claves de API se almacenan en una base de datos SQLite local, con soporte completo de migración de esquema. Los datos no salen del equipo.