CC Switch: un centro de control local para configuraciones de agentes de código

Todo lo que hay que saber sobre farion1231/cc-switch: una aplicación de escritorio multiplataforma que centraliza proveedores, configuraciones, MCP, instrucciones y sesiones de varias herramientas de agentes.

Qué es CC Switch

CC Switch es una aplicación de escritorio de código abierto para Windows, macOS y Linux. Su problema de partida es practico: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw y Hermes Agent utilizan formatos de configuración distintos. Cambiar de proveedor suele requerir editar manualmente JSON, TOML o archivos .env.

Archivos de configuración JSON, TOML y .env dispersos y con símbolos de error, siendo absorbidos por un panel único que los sincroniza en un solo flujo.

El proyecto presenta una interfaz única para importar y activar proveedores, con mas de 50 preajustes. También concentra la gestión de servidores MCP, instrucciones en Markdown, habilidades, historiales de sesión, consumo y costes. Su propuesta no es sustituir los clientes de cada proveedor: escribe y sincroniza sus configuraciones para que el usuario siga usando sus interfaces habituales.

Ventana de aplicación de escritorio con una grilla de más de 50 tarjetas de presets de proveedores de IA, con una tarjeta resaltada por el cursor.

El origen: de un conmutador para Claude Code a una consola multiagente

El repositorio fue creado el 4 de agosto de 2025, según la API de GitHub. Su autor principal es Jason Young (farion1231): el perfil de GitHub lo describe como ingeniero de desarrollo de pila completa interesado en IA y herramientas para desarrolladores; el README atribuye la licencia MIT a Jason Young.

El propio nombre y el envío inicial encontrado en Hacker News describen la primera posición del producto: el 9 de noviembre de 2025, amrrs publico el hilo 45861477, que lo presentaba como conmutador de proveedores para Claude Code y Codex. La versión actual muestra la ampliación posterior: ya no solo cambia proveedores de Claude Code y Codex, sino que administra ocho familias de herramientas y añade proxy local, gestión de MCP e instrucciones, habilidades y sesiones.

Panel holográfico oscuro que gestiona servidores MCP, importación mediante enlace ccswitch:// y flechas de sincronización bidireccional entre iconos de distintos clientes de IA.

No se recuperó una publicación de lanzamiento del autor que explique una anécdota o conflicto con una función nativa concreta. Por ello, la tensión que si esta documentada se formula de manera limitada: los distintos clientes conservan archivos y ciclos de reinicio propios, mientras CC Switch ofrece una capa local que traduce, guarda y aplica configuraciones; para la mayoría de herramientas el README recomienda reiniciar el terminal o el cliente después del cambio.

Filosofía y principios

La documentación expone varios principios operativos:

Intervención mínima: siempre mantiene una configuración activa para evitar que al borrar proveedores el cliente de línea de comandos quede inutilizable.
Fuente única de verdad local: los datos sincronizables se guardan en SQLite en ~/.cc-switch/cc-switch.db; las preferencias de dispositivo se almacenan aparte en JSON.
Escrituras seguras: usa el patrón archivo temporal mas renombrado atómico para reducir el riesgo de corrupción de configuración, junto con copias de seguridad rotativas.
Sincronización bidireccional: al activar un proveedor escribe los archivos en uso y, al editar el proveedor activo, recupera cambios realizados en ellos.
Responsabilidad humana ante código asistido por IA: la guía de contribución acepta aportes asistidos por IA, pero exige que quien los envia comprenda y pruebe el código; avisa que cambios generados sin revisar pueden cerrarse.

Núcleo de una base de datos SQLite brillante en el centro de una sala de servidores, con flujos de datos bidireccionales y copias de seguridad rotativas orbitando alrededor.

Son decisiones de producto descritas por el propio repositorio, no una auditoría independiente de seguridad, disponibilidad o compatibilidad de los proveedores configurados.

Cómo funciona

La aplicación se compone de una interfaz React y TypeScript y un backend Tauri 2 con Rust. El README separa comandos, servicios, acceso a datos y base SQLite; identifica servicios para proveedores, MCP, proxy, sesiones, configuración y pruebas de latencia.

El flujo cotidiano documentado es:

Pulsar Add Provider, elegir un preajuste o crear una configuración personalizada.
Activarla desde la interfaz o la bandeja del sistema.
Reiniciar el terminal o el cliente correspondiente para que lea los cambios; el README marca a Claude Code como excepción, pues admite cambio en caliente de datos de proveedor.
Para volver al acceso oficial, activar un preajuste de inicio de sesión oficial y seguir el flujo de autenticación del cliente.

El modo de proxy local añade conversión de formatos, conmutación en caliente, comprobación de salud, disyuntor y conmutación por error. Para MCP hay panel unificado, importación mediante enlace ccswitch:// y sincronización bidireccional entre las herramientas documentadas. Para instrucciones, sincroniza archivos como CLAUDE.md, AGENTS.md y GEMINI.md; para habilidades permite instalarlas desde repositorios GitHub o archivos ZIP, mediante enlace simbólico o copia.

Nodo de proxy local que enruta paquetes de datos brillantes entre proveedores, con un disyuntor parpadeante y anillos concéntricos de comprobación de salud.

El almacenamiento local incluye la base de datos, ajustes, copias de seguridad y directorios de habilidades bajo ~/.cc-switch/. La documentación también indica sincronización por Dropbox, OneDrive, iCloud o WebDAV. Los comandos de desarrollo publicados incluyen pnpm dev, pnpm typecheck, pnpm test:unit, pnpm build, cargo clippy y cargo test.

Bandeja del sistema desplegada con una lista de proveedores de IA y un interruptor activo en cian, junto a una terminal ejecutando comandos de build en Rust y TypeScript.

Estado oficial y semioficial

No hay evidencia recuperada de que los proveedores de las herramientas gestionadas hayan adoptado CC Switch como herramienta oficial, la hayan incorporado a un mercado oficial o certifiquen su proxy y sus preajustes. El repositorio se identifica expresamente como software MIT y declara ccswitch.io como su única web oficial; por tanto, debe entenderse como un proyecto independiente.

Existe una vía de distribución reconocible pero distinta de una aprobación de proveedor: el README publica brew install --cask cc-switch para macOS y paru -S cc-switch-bin para Arch Linux. Eso acredita instrucciones de instalación mantenidas por el proyecto, no una garantía de compatibilidad, calidad de rutas de terceros ni respaldo de los fabricantes de modelos.

El ecosistema

Repositorios del autor

La lista de repositorios publicos recuperada para farion1231 muestra piezas relacionadas, aunque no todas son necesariamente dependencias de CC Switch:

farion1231/cc-switch-website: sitio web del proyecto; 14 estrellas.
farion1231/homebrew-ccswitch: tap de Homebrew para CC Switch; 53 estrellas.
farion1231/claude-code-mux: proxy de enrutamiento en Rust con conmutación por error y prioridades; 4 estrellas.
farion1231/CLIProxyAPI: envuelve varios clientes CLI como servicio compatible con APIs de OpenAI, Gemini, Claude y Codex; 4 estrellas.
farion1231/code-switch: herramienta de proxy y gestión multiproveedor para Claude Code y Codex; 3 estrellas.
farion1231/claude-code-router: repositorio que propone usar Claude Code como base de infraestructura de código; 2 estrellas.

Las descripciones de GitHub permiten situarlos alrededor de la gestión y el enrutamiento de modelos, pero no prueban que se instalen juntos ni que compartan soporte o ciclo de versiones.

Forks, puertos y extensiones comunitarias

La búsqueda de GitHub recuperada durante esta investigación muestra bifurcaciones y derivaciones en otros idiomas, en especial chino:

BigStrongSun/ccswitchmulti, 239 estrellas: propone enrutamiento multimodelo para Codex, incluyendo suscripción de OpenAI, DeepSeek, Qwen, modelos locales y endpoints compatibles con OpenAI.
Zhang161215/cc-switch, 93 estrellas: aplicación de escritorio para gestionar y cambiar configuraciones de Claude Code y Codex.
kongkongyo/cc-switch, 82 estrellas: fork o derivación de escritorio para Claude Code, Codex, OpenCode y Gemini CLI.
Radiant303/cc-switch-kimicode, 13 estrellas: se presenta como una variante centrada en soporte ampliado para Kimi Code.
piaomiaoguying/cc-switch, 10 estrellas: rama mejorada archivada cuyo texto recomienda utilizar la versión oficial posterior.
jianhongyu136/claude-cli-switch, 3 estrellas: cliente CLI basado en CC Switch para lanzar Claude, Codex, Gemini y OpenCode con entornos de proveedor aislados, sin mutar la configuración global.

Estas cifras proceden de la búsqueda de repositorios de GitHub del 1 de agosto de 2026. Ser una bifurcación, reutilizar el nombre o declarar que se basa en CC Switch no equivale a afiliación, revisión de seguridad ni compatibilidad respaldada por Jason Young.

Núcleo brillante etiquetado CC Switch conectado por rutas neuronales a nodos satélite que representan bifurcaciones comunitarias, con caracteres chinos y fragmentos de mapa global de fondo.

Herramientas relacionadas

Los proyectos de proveedor no son el único entorno: CC Switch sincroniza artefactos de los clientes y no reemplaza sus ejecutables. La versión v3.18.0 documenta la incorporación de Grok Build como octava aplicación gestionada; v3.19.0 documenta endurecimiento de instalación de habilidades, importación ccswitch://, restauración SQL, mezcla de configuración y lanzador de terminal. El ecosistema practico, por tanto, incluye las configuraciones de los ocho clientes, sus servidores MCP y las bibliotecas de habilidades, con CC Switch como capa de coordinación local.

Archivos Markdown CLAUDE.md, AGENTS.md y GEMINI.md flotando y conectados por enlaces simbólicos brillantes a una biblioteca central de habilidades, con repositorios de GitHub y archivos ZIP importándose y transformándose en módulos.

Numeros del repo

Medición: 1 de agosto de 2026, API y página de GitHub.

Métrica	Valor
Estrellas	123.204
Bifurcaciones	8.332
Suscriptores reales	220
Commits	2.232
Incidencias abiertas informadas por la API	2.086
Lenguaje principal	Rust
Otros lenguajes relevantes por bytes	TypeScript, HTML, JavaScript y CSS
Licencia	MIT
Creación	4 de agosto de 2025
Última actualización de metadatos	1 de agosto de 2026
Última versión	`v3.19.1`, publicada el 31 de julio de 2026

Los contribuidores principales devueltos por la API fueron farion1231 con 1.835 contribuciones, yovinchen con 81, makoMakoGo con 15, TinsFox con 12 y dependabot[bot] con 9. El total de 2.232 commits se obtuvo del último enlace de paginación de la API de commits. open_issues_count puede incluir solicitudes de cambios abiertas, por lo que no representa solo incidencias. La API repite el número de estrellas en watchers_count; por eso se informa subscribers_count como número de suscriptores reales.

Cómo contribuir

La guía de contribución pide abrir primero una incidencia para discutir funcionalidades nuevas, bifurcar desde main y crear una rama enfocada, por ejemplo feat/my-feature o fix/issue-123. Cada solicitud de cambios debe abordar una sola función o corrección y completar su plantilla.

Antes de enviarla exige, como mínimo, pnpm typecheck, pnpm format:check y pnpm test:unit; si cambia Rust, también cargo fmt --check, cargo clippy y cargo test. El proyecto usa Conventional Commits y, ante cambios visibles para el usuario, pide actualizar los tres archivos de localización de inglés, chino y japonés. Las vulnerabilidades no deben enviarse como incidencia publica: la guía remite a la política de seguridad.

Cómo lo recibió la comunidad

La evidencia recuperada combina una adopción visible con incidencias de operación y de compatibilidad; no permite afirmar un consenso general:

El hilo de Hacker News 45861477, enviado por amrrs el 9 de noviembre de 2025, nombró al proyecto como conmutador de proveedores para Claude Code y Codex. Al consultarlo tenía 3 puntos y 0 comentarios. Es una referencia directa, pero su volumen no permite inferir una recepción amplia.
En el hilo 46255285, el usuario radio879 escribio que usa CC Switch para cambiar modelos en Claude Code y relato buena experiencia con otro modelo barato. Es una recomendación de uso individual, no una prueba comparativa ni una validación del proxy.
La página de incidencias de GitHub muestra necesidades reales a escala: la incidencia #404, abierta por zlyuan99, acumulaba 70 comentarios sobre que Claude seguia pidiendo inicio de sesión tras configurar settings.json; la #4420, de Zayia, tenía 27 comentarios sobre que Codex Desktop no mostraba una lista de modelos personalizada. Son objeciones concretas de compatibilidad y configuración, no simples opiniones abstractas.
En la misma página, makoMakoGo abrio la incidencia #2337, con 32 comentarios, para advertir sobre un ajuste de contexto de DeepSeek en modo de enrutamiento local. La actividad confirma que el proxy y la traducción de configuraciones necesitan soporte operacional continuo.
Las notas de v3.19.0 reconocen y corrigen problemas de seguridad concretos: una filtración de claves en configuración universal de Gemini y una ventana de confirmación que podía no mostrar el comando MCP a importar. El proyecto recomienda rotar claves y revisar enlaces de importación desconocidos si se usaron. Es una crítica técnica procedente del mantenedor y una razón para actualizar y revisar configuraciones antes de confiar en automatismos.

CC Switch frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable
`BigStrongSun/ccswitchmulti`	Enruta o integra varios modelos para usar con Codex.	Su descripción se concentra en Codex y combina suscripción, DeepSeek, Qwen y modelos locales; CC Switch documenta una aplicación de escritorio que gestiona ocho familias de clientes y MCP, instrucciones y habilidades.
`jianhongyu136/claude-cli-switch`	Cambia proveedores para Claude, Codex, Gemini y OpenCode y se declara basado en CC Switch.	Es un cliente de línea de comandos con sesiones aisladas y sin mutación de configuración global; CC Switch usa una interfaz de escritorio y mantiene una base SQLite con sincronización hacia archivos de clientes.
`Zhang161215/cc-switch`	Gestiona y cambia configuraciones de Claude Code y Codex en escritorio.	La fuente recuperada solo verifica ese alcance de dos herramientas; el README de `farion1231/cc-switch` documenta soporte adicional para Claude Desktop, Gemini CLI, Grok Build, OpenCode, OpenClaw y Hermes Agent.

La comparación se limita a las descripciones recuperadas en GitHub. No se realizaron pruebas de rendimiento, privacidad ni fidelidad de protocolo, por lo que no se ordenan las alternativas por calidad.

Casos de uso y a quién puede ayudar este repositorio

Personas que alternan entre Claude Code, Codex, Gemini CLI, OpenCode u otros clientes admitidos pueden crear preajustes de proveedor y activarlos desde una sola interfaz, sin editar a mano los JSON, TOML y archivos .env de cada herramienta. Tras el cambio, el flujo documentado es reiniciar el cliente o terminal correspondiente, salvo la excepción indicada para Claude Code.
Equipos que comparten una configuración local de agentes pueden centralizar proveedores, servidores MCP, instrucciones, habilidades, sesiones, uso y costes en la base SQLite de ~/.cc-switch/, y sincronizar esos datos mediante Dropbox, OneDrive, iCloud o WebDAV. La escritura atómica y las copias de seguridad rotativas son útiles cuando se aplican cambios sobre varios archivos de cliente.
Usuarios que mantienen instrucciones por proyecto pueden sincronizar CLAUDE.md, AGENTS.md y GEMINI.md, e instalar habilidades desde repositorios de GitHub o archivos ZIP mediante enlace simbólico o copia. También pueden usar el proxy local cuando necesitan conversión de formatos, comprobación de salud o conmutación por error entre proveedores.

El proyecto coordina configuraciones locales, no sustituye la gestión de secretos ni valida los endpoints, enlaces ccswitch:// o paquetes de habilidades que se importen. Las correcciones de seguridad de v3.19.0 hacen necesario revisar las claves y el origen de cada importación.

Recursos

Repositorio: https://github.com/farion1231/cc-switch
Documentación e instalación: https://github.com/farion1231/cc-switch#quick-start
Manual de usuario: https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/en
Guía de contribución: https://github.com/farion1231/cc-switch/blob/main/CONTRIBUTING.md
Versiones y revisiones: https://github.com/farion1231/cc-switch/releases
Sitio oficial: https://ccswitch.io
Comunidad e incidencias: https://github.com/farion1231/cc-switch/discussions, https://github.com/farion1231/cc-switch/issues
Conversaciones: https://news.ycombinator.com/item?id=45861477, https://news.ycombinator.com/item?id=46255285

Nota: este artículo combina el README, la guía de contribución, las notas de versiones, la página de incidencias, el sitio del proyecto, la API de GitHub y resultados de Hacker News consultados el 1 de agosto de 2026. Las cifras cambian con el tiempo.