Tutorial de CC Switch: gestión segura de Claude Code, Codex, MCP y reversiones

CC Switch, también buscado a menudo como CCSwitch o cc switch, es una herramienta de administración de escritorio para usuarios habituales de programación de IA. El problema que quiere resolver es muy directo: muchas personas ahora usan Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw al mismo tiempo, pero cada herramienta tiene su propio formato de configuración, método de escritura del proveedor, configuración de MCP y método de gestión de habilidades.

Cuando solo usa una herramienta, cambiar manualmente la configuración es soportable; una vez que se combinen varias herramientas, además de cuentas oficiales, API de terceros, servicios de transferencia, modelos locales y configuraciones compartidas en equipo, editar manualmente JSON, TOML y .env pronto se convertirá en una tarea muy molesta.

El objetivo de CC Switch es integrar estas configuraciones dispersas en una aplicación de escritorio multiplataforma. ¿Qué problema resuelve?

Las herramientas modernas de programación de IA se parecen cada vez más a “colegas de desarrollo en la línea de comandos”, pero la ecología de cada herramienta aún no está completamente unificada.

Los puntos débiles comunes incluyen:

• Los formatos de configuración de Claude Code, Codex, Gemini CLI, OpenCode y OpenClaw son diferentes.
• Al cambiar de proveedor de API, debe cambiar repetidamente el archivo de configuración.
• El servidor MCP se configura repetidamente en diferentes herramientas.
• Los archivos de aviso como CLAUDE.md, AGENTS.md y GEMINI.md son difíciles de mantener de manera unificada.
• La instalación, sincronización, copia de seguridad y desinstalación de habilidades carecen de una entrada centralizada.
• Varias cuentas, múltiples retransmisiones y cambios de servicios de múltiples modelos se confunden fácilmente.
• Después de que el archivo de configuración se modifica manualmente y se cometen errores, el costo de solución de problemas es muy alto.

La idea de CC Switch es: no permitir que los usuarios recuerden los detalles de configuración de cada herramienta, sino utilizar una interfaz unificada para administrar proveedores, MCP, indicaciones, habilidades, sesiones y agentes. ¿Qué herramientas son compatibles?

Los objetos de soporte principales enumerados en el archivo README incluyen cinco categorías:

• Claude Code
• Codex
• Gemini CLI
• OpenCode
• OpenClaw

Estas herramientas en sí mismas tienen un posicionamiento similar y todas giran en torno a la programación de IA, el flujo de trabajo de los agentes y la colaboración en la línea de comandos. Pero sus sistemas de configuración son diferentes y el valor de CC Switch radica en empaquetar estas diferencias.

Para las personas que suelen comparar diferentes herramientas de programación de IA, esto es mucho menos problemático que revisar manualmente los archivos de configuración cada vez. Gestión de proveedores

La capacidad de primera capa de CC Switch es la gestión de proveedores.

Tiene más de 50 ajustes preestablecidos de proveedores integrados y las instrucciones mencionadas en el archivo README incluyen AWS Bedrock, NVIDIA NIM y varios relés comunitarios. Los usuarios pueden copiar la clave API, importarla con un clic y luego cambiar a la interfaz.

Hay varios puntos prácticos principales:

• Agregar proveedor con un clic.
• Clasificación de arrastrar y soltar de proveedores.
• Cambio rápido de la bandeja del sistema.
• Importación y exportación de proveedores.
• Algunos proveedores generales se pueden sincronizar con múltiples aplicaciones.

Para muchas personas, esta característica es bastante atractiva. Debido al uso diario de herramientas de programación de IA, a menudo no es “el modelo no se puede usar”, sino “qué herramienta, qué punto final y qué cuenta usar para esta clave hoy” lo que se confunde fácilmente. Proxy local y conmutación por error

Además de escribir archivos de configuración, CC Switch también proporciona el modo proxy local.

El objetivo de esta capacidad es:

• Proveedores de conmutación en caliente.
• Conversión de formato.
• Conmutación por error automática.
• Fusible.
• Chequeo de salud del proveedor.
• Solicitar corrección.

En pocas palabras, no solo escribe la configuración en la herramienta de destino, sino que también agrega una capa de proxy local en el medio para permitir que diferentes herramientas accedan a los servicios del modelo a través del proxy.

Esto es útil para usuarios de múltiples proveedores: si un servicio no funciona, se puede cambiar a otro; si un modelo es caro, se puede sustituir por otro más económico; si un determinado formato de solicitud es incompatible, también se puede adaptar a través de la capa de proxy. MCP, indicaciones y habilidades

CC Switch La capacidad de segundo nivel más importante es la gestión unificada de MCP, Avisos y Habilidades. PCM

Proporciona un panel MCP unificado que puede administrar servidores MCP entre múltiples aplicaciones y admite sincronización bidireccional e importación de Deep Link.

Esto es muy útil para los usuarios que utilizan MCP. Debido a que hay muchos servidores MCP, las configuraciones se pueden distribuir fácilmente entre diferentes clientes. El panel unificado puede reducir las configuraciones repetidas y facilitar la migración. Indicaciones

La parte de Avisos admite la edición de Markdown y los archivos correspondientes se pueden sincronizar entre diferentes herramientas, por ejemplo:

• CLAUDE.md
• AGENTS.md
• GEMINI.md

Estos documentos son esencialmente especificaciones de proyecto para el Agente. Después de una gestión unificada, es más fácil mantener las reglas del equipo, los compromisos del proyecto y los recordatorios globales. Habilidades

Skills admite la instalación con un solo clic desde repositorios de GitHub o archivos ZIP, y también admite la administración de repositorios personalizados, enlaces simbólicos y copia de archivos.

Si utiliza herramientas como Claude Code, Codex y OpenClaw al mismo tiempo, Skills puede convertirse fácilmente en un montón de archivos dispersos en diferentes directorios. CC Switch Centralizarlos puede reducir los costes de mantenimiento. Sesiones y espacios de trabajo

El archivo README también menciona las capacidades relacionadas con el Administrador de sesiones y el Espacio de trabajo.

Puede navegar, buscar y restaurar el historial de sesiones en múltiples aplicaciones. Para las personas que han utilizado herramientas de programación de IA durante mucho tiempo, la gestión de sesiones es realmente muy importante: una gran cantidad de contexto valioso, procesos de depuración y comparaciones de soluciones están enterrados en conversaciones antiguas.

Además, también proporciona un editor de espacio de trabajo para OpenClaw, que puede editar archivos de agente como AGENTS.md y SOUL.md con vista previa de Markdown.

Esto muestra que CC Switch no es solo una “pequeña herramienta para cambiar de clave”, sino que se está expandiendo hacia el banco de trabajo de AI Agent. Sincronización en la nube y almacenamiento de datos

CC Switch admite la sincronización de datos del proveedor a través de Dropbox, OneDrive, iCloud, NAS o WebDAV.

El método de almacenamiento de datos local también es relativamente claro:

• Base de datos: ~/.cc-switch/cc-switch.db
• Configuración local: ~/.cc-switch/settings.json
• Copia de seguridad automática: ~/.cc-switch/backups/
• Habilidades: ~/.cc-switch/skills/
• Respaldo de habilidades: ~/.cc-switch/skill-backups/

Utiliza SQLite como fuente de datos principal y enfatiza las escrituras atómicas y las copias de seguridad automáticas, con el objetivo de evitar la corrupción del archivo de configuración al cambiar o escribir.

Este diseño es fundamental para los usuarios habituales. Porque una vez que la propia herramienta de gestión de configuración escribe una configuración incorrecta, afectará a todas las herramientas de programación de IA. Método de instalación

CC Switch es una aplicación de escritorio multiplataforma construida en Tauri 2.

Los requisitos del sistema son aproximadamente los siguientes:

• Windows: Windows 10 y superior
• macOS: macOS 12 Monterey y superior
• Linux: Ubuntu 22.04+, Debian 11+, Fedora 34+ y otras distribuciones principales

Los usuarios de Windows pueden descargar el paquete de instalación .msi o el paquete comprimido de la versión portátil.

Los usuarios de macOS pueden utilizar Homebrew:

Actualización

1
2

brew tap farion1231/ccswitch
brew install --cask cc-switch

:

1

brew upgrade --cask cc-switch

Los usuarios de Linux pueden elegir .deb, .rpm o AppImage. Los usuarios de Arch Linux también pueden instalar a través de paru -S cc-switch-bin.

Al 6 de mayo de 2026, la página del almacén muestra que la última versión es CC Switch v3.14.1 y la fecha de lanzamiento es el 23 de abril de 2026. Pila de tecnología

Desde la perspectiva de la estructura del almacén, CC Switch es una aplicación de escritorio típica de Tauri:

• Interfaz: React 18, TypeScript, Vite, TailwindCSS, TanStack Query, shadcn/ui
• Servidor: Tauri 2, Rust, SQLite, Tokio
• Pruebas: Vitest, MSW, Biblioteca de pruebas

Los patrones de diseño principales incluyen:

• SQLite como fuente única de verdad.
• JSON guarda la configuración local a nivel del dispositivo.
• Escriba la configuración en vivo de la herramienta de destino al cambiar.
• Rellene desde la configuración en vivo al editar el proveedor actual.
• Utilice archivos temporales y cambie el nombre para realizar escrituras atómicas.
• Bloqueo de conexión a la base de datos para evitar problemas de escritura concurrente.

Este tipo de arquitectura ilustra que los proyectos no son simples scripts, sino que están diseñados como herramientas de escritorio a largo plazo. ¿Para quién es adecuado?

CC Switch es adecuado para los siguientes tipos de usuarios:

• Utilice Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw simultáneamente.
• Cambia frecuentemente de cuentas oficiales, retransmisiones de terceros, modelos locales o proveedores de equipos.
• Se ha iniciado el uso masivo de MCP.
• Quiere mantener CLAUDE.md, AGENTS.md, GEMINI.md de forma unificada.
• Instalar, probar y migrar Skills con frecuencia.
• Quiere ver el historial de sesiones y el uso de diferentes herramientas.

Si solo usa una herramienta de programación de IA, siempre usa el inicio de sesión oficial y no se molesta con el Proveedor, MCP y Skills, entonces su valor puede no ser tan obvio.

Pero si ha entrado en el estado de “herramientas múltiples, cuentas múltiples, proveedores múltiples y proyectos múltiples”, puede ahorrar una gran cantidad de trabajo de configuración trivial. A qué prestar atención

Estas herramientas son convenientes, pero tenga en cuenta los límites.

Primero, administrará la configuración de múltiples CLI de AI, así que asegúrese de confiar en esta herramienta y su lógica de escritura.

En segundo lugar, la clave API, el punto final de retransmisión y el servidor MCP son configuraciones confidenciales. Antes de activar la sincronización en la nube, asegúrese de que el directorio sincronizado y el servicio WebDAV sean seguros y confiables.

En tercer lugar, después de cambiar de proveedor, la mayoría de las herramientas aún necesitan reiniciar el terminal o la CLI para que surtan efecto. El archivo README menciona que Claude Code admite la conmutación en caliente para los datos del proveedor, pero generalmente aún es necesario reiniciar otras herramientas.

Cuarto, al volver al inicio de sesión oficial, es mejor agregar el proveedor oficial de acuerdo con la descripción del proyecto y luego volver a realizar el proceso de inicio de sesión de la herramienta correspondiente. Consulta los canales oficiales antes de la instalación.

Las únicas fuentes oficiales actualmente declaradas sobre el proyecto son:

• Sitio web oficial: ccswitch.io
• Código fuente: github.com/farion1231/cc-switch
• Descargar: Versiones para este repositorio de GitHub

CC Switch es un software gratuito y de código abierto. No se deben utilizar sitios de descarga que requieran recarga, soliciten contraseñas de cuentas oficiales o utilicen nombres falsos. Windows descarga primero el MSI en las versiones; macOS puede usar:

Después de instalar

1

brew install --cask cc-switch

, verifique la versión instalada en “Acerca de” o en la interfaz de administración de herramientas. No descargue el archivo corregido según el número de versión anterior en el tutorial de terceros. De qué archivos hacer una copia de seguridad antes de modificarlos

Las ubicaciones de datos locales que figuran actualmente en el README oficial de CC Switch son:

1
2
3
4
5

数据库：~/.cc-switch/cc-switch.db
设置：~/.cc-switch/settings.json
自动备份：~/.cc-switch/backups/
Skills：~/.cc-switch/skills/
Skill 备份：~/.cc-switch/skill-backups/

backups La rotación predeterminada conserva las últimas 10 copias y la copia de seguridad antes de la desinstalación de Skills conserva las últimas 20 copias. La copia de seguridad automática no equivale a una recuperación completa ante desastres; antes del primer cambio a gran escala, debe salir de CC Switch y copiar todo el directorio ~/.cc-switch en una ubicación controlada.

Al mismo tiempo, guarde la configuración original de la herramienta de destino por separado, como Codex config.toml, en el directorio de usuarios. No envíe la copia de seguridad que contiene la clave API a Git ni la cargue en un disco de red pública. Un cambio de proveedor seguro

1. Ejecute una solicitud mínima en la CLI original y guarde la línea base normal.
2. Agregar un nuevo Proveedor en CC Switch, que no cubra al único Proveedor oficial disponible.
3. Verifique las variables de entorno correspondientes al punto final, nombre del modelo y clave.
4. Salga por completo después de cambiar y reinicie la CLI de destino.
5. Pruebe primero el texto normal, luego pruebe las respuestas en tiempo real y las llamadas a herramientas.
6. Cuando se produzca una excepción, vuelva al proveedor original y confirme que se restablezca la CLI original.

El proveedor personalizado nativo de Codex utiliza el protocolo de respuestas. El proxy nativo a partir de CC Switch 3.16 puede convertir solicitudes de respuestas del Codex en finalizaciones de chat utilizadas por algunos proveedores externos y reconstruir respuestas de transmisión y llamadas de herramientas. Que pueda funcionar de manera estable aún depende de la versión específica, el modelo ascendente y la configuración del agente. El hecho de que el chat devuelva una frase de texto no puede considerarse que todos los flujos de trabajo del Codex sean compatibles. Verificación y localización de fallos

Después de cambiar de proveedor de Codex, ejecute al menos:

Luego,

1
2

codex --version
codex --help

completó tres pruebas en un repositorio temporal de Git:

• Leer archivos y responder preguntas;
• Modificar un archivo de prueba y ver la diferencia;
• Llame a una herramienta libre de efectos secundarios.

Juicios comunes:

CC Switch README Nota especial: El valor predeterminado es el directorio Codex en la configuración de la aplicación y no leerá automáticamente CODEX_HOME. Si se utiliza un directorio personalizado para la CLI, se debe configurar el mismo “Directorio de perfil” en CC Switch. Pasos de reversión

1. Vuelva al proveedor oficial o verificado previamente reservado en CC Switch.
2. Salga de CC Switch y de la CLI de destino.
3. Seleccione la copia de seguridad antes de la modificación desde ~/.cc-switch/backups/; no sobrescriba la base de datos si no está seguro.
4. Restaure el config.toml guardado por separado si es necesario.
5. Inicie sesión nuevamente en el Proveedor oficial y vuelva a ejecutar la solicitud de referencia mínima.

El diseño “mínimamente intrusivo” de CC Switch conserva una configuración activa, por lo que el único proveedor actualmente activo no se puede eliminar. El enfoque correcto es cambiar primero a un proveedor disponible y luego limpiar la configuración incorrecta. Límite de seguridad

• No utilice retransmisiones ni sitios espejo de pago de fuentes desconocidas.
• No filtre la clave API en capturas de pantalla, registros y directorios de sincronización.
• Confirme el cifrado del lado del servidor, los permisos y las políticas de retención de datos antes de realizar la sincronización mediante WebDAV.
• Lea los términos de facturación, retención de datos y servicio de un proveedor externo antes de usarlo.

- No se suscriba al proxy inverso de OAuth utilizando ChatGPT para eludir la ruta de autorización normal; Las notas de la versión del proyecto también señalan que esto puede violar los Términos de servicio de OpenAI. Resumen

El valor de CC Switch no reside en la creación de otra herramienta de programación de IA, sino en el reconocimiento de una realidad: el ecosistema de programación de IA ha entrado en una etapa de convivencia de múltiples herramientas.

Claude Code, Codex, Gemini CLI, OpenCode y OpenClaw tienen cada uno sus propios sistemas de configuración, y MCP, Skills, Prompts y Provider se están expandiendo rápidamente. Continuar cambiando las configuraciones manualmente tarde o temprano se convertirá en una carga.

CC Switch recopila estos elementos en una aplicación de escritorio, lo que permite a los usuarios cambiar de proveedor, sincronizar MCP, administrar habilidades, mantener archivos de avisos y ver sesiones más fácilmente. Para los usuarios intensivos de programación de IA, es probable que dichas herramientas pasen de ser “dispositivos opcionales” a una “infraestructura cotidiana”. Preguntas frecuentes

¿CC Switch y CCSwitch son la misma herramienta?

Sí. Cuando los usuarios realizan una búsqueda, pueden escribirlo como CC Switch, CCSwitch o cc switch. Lo que se analiza aquí es la herramienta de escritorio multiplataforma farion1231/cc-switch. ¿Qué herramientas de programación de IA puede gestionar CC Switch?

Está orientado principalmente a AI CLI y herramientas de agentes como Claude Code, Codex, Gemini CLI, OpenCode y OpenClaw, enfocándose en la gestión de proveedores, MCP, avisos, habilidades, agentes y sesiones. ¿CC Switch solo se usa para cambiar la clave API?

No sólo. Cambiar de proveedor es su capacidad básica, pero también se está expandiendo hacia el banco de trabajo del Agente de IA, incluida la administración de MCP, la sincronización de habilidades, el mantenimiento rápido de archivos, la visualización de sesiones y la sincronización en la nube. ¿Cuándo vale más la pena instalar CC Switch?

Si utiliza varios conjuntos de herramientas de programación de IA, varios conjuntos de proveedores de API, modelos locales, relés o configuraciones compartidas en equipo al mismo tiempo, CC Switch puede reducir significativamente el costo de los cambios de configuración manuales. Referencias

• interruptor farion1231/cc
• Lanzamientos de interruptores CC

Crear un Provider local de Ollama

Antes de editar la configuración, verifica el servicio y la etiqueta exacta del modelo en el mismo entorno de usuario que CC Switch y Claude Code:

1
2

ollama list
Invoke-RestMethod -Uri 'http://127.0.0.1:11434/api/tags'

Crea un Provider llamado Ollama Local, configura Base URL como http://127.0.0.1:11434/v1, selecciona OpenAI-compatible / Chat Completions y copia literalmente la etiqueta de ollama list. Si el formulario exige API Key, usa un marcador local no secreto, nunca una credencial real de la nube.

Guarda el Provider activo antes de cambiar. En un repositorio de solo lectura prueba una respuesta normal, una tool call que lea un archivo y la recuperación tras cancelar una petición. Una conversación correcta no demuestra compatibilidad con todo el flujo Agent de Claude Code. Si el modelo falla con tool calling o produce un formato incompatible, cambia de modelo, usa la conversión de protocolo de CC Switch cuando corresponda o revierte.

Si la CLI funciona pero la API no, comprueba el límite Windows/WSL, el puerto 11434 y el firewall. Si la API enumera modelos pero aparece “model not found”, normalmente falta parte de la etiqueta. No expongas un puerto Ollama sin autenticación a Internet.