Cuando un cambio de CC Switch no surte efecto, lo habitual no es que no se haya guardado. El archivo que inspeccionas, el cliente que está en ejecución y la live config escrita por CC Switch pueden ser distintos. No borres primero la configuración: localiza qué fuente está activa realmente.
Distingue tres tipos de configuración
- Datos propios de CC Switch: Providers, sincronización, copias y metadatos de gestión.
- Live config de la herramienta destino: los ajustes que Claude Code, Codex y otras herramientas leen al iniciar.
- Configuración de proyecto: MCP, variables de entorno o instrucciones de un repositorio que pueden sobrescribir ajustes de usuario.
CC Switch busca escribir o leer la live config de la herramienta destino, pero las rutas reales pueden variar por herramienta, sistema y versión. No copies un directorio fijo de internet; revisa el objeto gestionado en la herramienta seleccionada de CC Switch y confírmalo con la salida de ajustes o registros del CLI destino.
Orden para diagnosticar cambios no aplicados
- Confirma en CC Switch que el Provider, MCP o Skill está guardado y que elegiste el espacio de trabajo correcto.
- Cierra completamente el CLI destino y todas las terminales relacionadas, y vuelve a iniciarlos. Muchos CLIs no recargan Providers en caliente.
- Revisa si un archivo del proyecto o una variable de entorno sobrescribe el ajuste de usuario.
- Inspecciona los registros del MCP server: puede estar cargado pero no iniciar.
- Si hay sincronización en la nube, confirma que otro dispositivo no haya restaurado una versión antigua.
No edites a mano para que la sincronización lo sobrescriba
Puedes comparar una copia de seguridad durante el diagnóstico, pero evita editar el mismo elemento a la vez en CC Switch, un editor de texto y una carpeta sincronizada. Pausa la sincronización, exporta o respalda el estado actual, realiza un cambio mínimo, reinicia y verifica, y después reactiva la sincronización.
Las API keys, comandos MCP y rutas locales pueden ser sensibles; ocúltalos antes de compartir capturas o registros. Consulta la guía de CC Switch para Provider, sincronización y copias. Si la llamada MCP devuelve un error, sigue la guía para fallos de llamadas MCP.
Resumen
Si CC Switch no aplica cambios, confirma dónde escribió, qué lo sobrescribe, si el proceso se reinició y si el servicio arranca. Una verificación mínima es más segura que reinstalar todo o borrar la configuración.
Empieza con un inventario de fuentes de configuración
Antes de depurar, enumera el registro actual de CC Switch, la configuración de usuario del cliente, la configuración del proyecto, variables de terminal y sistema, y copias sincronizadas. No supongas que el último archivo editado es el activo: muchos CLIs leen variables al iniciar y el proyecto puede sobrescribir al usuario.
| Elemento | Qué registrar |
|---|---|
| Cliente actual | Nombre, versión y método de inicio |
| Espacio actual | Raíz del repositorio y estado de confianza |
| Provider | Base URL y alias de modelo, nunca la key completa |
| MCP | Nombre del server, comando y ubicación del registro |
| Sincronización | Si está activa y último dispositivo sincronizado |
Si el Provider no cambió
Usa los registros del cliente o del servidor para confirmar el endpoint realmente contactado. Si sigue siendo el anterior, investiga escritura, sobrescrituras o falta de reinicio. Si ya es el nuevo pero falla, revisa key, modelo y estado del nuevo Provider. Separar ambos casos evita cambiar repetidamente la capa equivocada.
Vigila también terminales antiguas: un shell en ejecución puede conservar variables viejas aunque CC Switch actualice el sistema. Ciérralo, abre uno limpio y ejecuta una solicitud mínima.
Si un cambio MCP no se aplica
MCP tiene dos puertas: que el cliente lea la configuración y que el server pueda iniciar. Si no aparece en la lista de herramientas, la configuración no se cargó o es inválida. Si aparece pero falla la llamada, revisa comando, directorio de trabajo, dependencias, puerto y stderr.
En Windows, rutas con espacios, comillas anidadas y ejecutables Node/Python de entornos distintos son causas habituales. No pegues un comando shell largo sin probar en la configuración; ejecútalo primero por separado en la misma terminal.
Cómo recuperar de forma segura
Si la configuración ya está confusa, exporta o copia el estado legible y pausa la sincronización. Elimina solo un elemento de prueba que sepas que administra CC Switch y deja intacta la configuración ajena. Crea un Provider o MCP server simple, verifica escritura, reinicio y llamada, e importa el contenido antiguo gradualmente.
FAQ: ¿Puedo borrar todos los directorios de configuración?
No es recomendable. Puedes perder referencias de keys, ajustes MCP, sesiones y preferencias de proyecto difíciles de reconstruir. Haz copia, identifica la propiedad y recupera con el cambio más pequeño posible.
FAQ: ¿Por qué el cambio se comporta distinto en otro equipo?
Comprueba primero versiones de sincronización, cliente y variables del sistema. La sincronización copia archivos; no garantiza los mismos modelos locales, rutas, ejecutables o permisos.