Source: https://aiprimetech.io/es/blog/cc-switch-claude-code-account-provider-manager/ Jul 22, 2026 · 6 min · Herramientas # CC Switch para Claude Code: gestión de cuentas, proveedores y configuraciones A Por [AI Prime Tech](https://aiprimetech.io/es/) · Con asistencia de IA A las 9:05 a. m., configuras Claude Code para que use una puerta de enlace de la empresa. A las 11:30, necesitas una cuenta personal de Anthropic. Después de comer, un repositorio de un cliente requiere sus propios servidores MCP y alias de modelos. Al final del día, ~/.claude/settings.json se ha editado tres veces, un intérprete de comandos todavía contiene un token antiguo y nadie tiene claro a qué endpoint llegará la siguiente solicitud. CC Switch aborda ese problema operativo con perfiles con nombre gestionados desde una aplicación de escritorio. En lugar de mover manualmente credenciales, URL de proveedores, definiciones de MCP y archivos de configuración específicos de cada agente, seleccionas el perfil que debe estar activo. El detalle técnico importante es que se trata de gestión de configuración, no de virtualización de cuentas: Claude Code sigue leyendo sus archivos locales y ajustes de entorno habituales, mientras CC Switch coordina lo que se escribe allí. Esa comodidad es considerable, pero también lo es el límite de confianza. Una utilidad que puede cambiar entre cuentas de desarrollador debe poder leer o escribir credenciales de desarrollador. Antes de adoptarla, debes entender exactamente qué archivos modifica, dónde se encuentra su propia base de datos y cómo se protegen esos archivos. ## Qué hace realmente CC Switch para gestionar Claude Code CC Switch es un gestor de configuración de escritorio de código abierto para agentes de programación. Sus integraciones compatibles se han ampliado con el tiempo, así que consulta el repositorio y las notas de la versión actuales antes de adoptar una lista fija como estándar. Claude Code es una de sus integraciones principales; las versiones actuales también están orientadas a otros agentes de programación de línea de comandos, como Codex y Gemini CLI. Para Claude Code, un perfil de proveedor suele combinar: - Un endpoint de API compatible con Anthropic - Una clave de API o un token de autenticación - Asignaciones de modelos o valores de entorno relacionados con los modelos - Variables de entorno adicionales - Definiciones de servidores MCP - Ajustes de Claude Code que deben acompañar al perfil Esto resulta útil cuando «cuenta» no significa simplemente un inicio de sesión en Anthropic. En implementaciones reales, los desarrolladores pueden alternar entre: - Acceso directo a la API de Anthropic - Una pasarela de API autenticada de una organización - Un proveedor externo compatible con Anthropic - Cuentas de facturación separadas para uso personal, preproducción y producción - Un proxy local o remoto que ofrece una semántica de solicitudes compatible CC Switch centraliza esas opciones y activa la configuración seleccionada. Esto no hace que todos los endpoints compatibles se comporten de forma idéntica. Las diferencias en los nombres de los modelos, las cabeceras de autenticación, los límites de solicitudes, el almacenamiento en caché de prompts y los campos de API no compatibles siguen siendo responsabilidad del proveedor. | Enfoque | Esfuerzo para cambiar | Credenciales expuestas a | Gestión de MCP | Uso más adecuado | Exportaciones de variables en el shell | Bajo al principio, propenso a errores después | Shell, historial, procesos secundarios | Manual | Una cuenta temporal | Archivos de configuración editados a mano | Moderado | Editor, copias de seguridad, archivos locales | Manual | Configuración estable con un único proveedor | Scripts de envoltura | Bajo tras la configuración | Script o gestor de secretos | Depende del script | Equipos dispuestos a mantener herramientas | Perfiles de CC Switch | Bajo mediante la interfaz de escritorio | CC Switch y archivos de configuración del agente | Interfaz centralizada | Varias cuentas, proveedores o agentes | Gestor de secretos externo con scripts de envoltura | El mayor coste de configuración | Gestor de secretos y proceso en ejecución | Personalizada | Controles empresariales estrictos La tabla muestra la contrapartida: CC Switch reduce los errores del operador, pero se convierte en otra aplicación local con privilegios. ## Instalación y compatibilidad con plataformas CC Switch se distribuye a través de la página de versiones del proyecto en GitHub. El repositorio describe actualmente compatibilidad de escritorio con macOS, Windows y Linux, con archivos de distribución que varían según la plataforma y la versión. Verifica los archivos adjuntos a la versión que quieras implementar; la existencia de código fuente no garantiza que cada versión se compile para todas las versiones de sistemas operativos, arquitecturas de CPU o formatos de paquete. En macOS, el proyecto proporciona un flujo de trabajo con un cask de Homebrew: ``` brew tap farion1231/cc-switch brew install --cask cc-switch ``` Antes de utilizar un binario descargado en un entorno gestionado, verifica qué ha instalado Homebrew: ``` brew info --cask cc-switch brew list --cask cc-switch codesign -dv --verbose=4 "/Applications/CC Switch.app" 2>&1 ``` Los usuarios de Windows y Linux deben obtener el instalador o paquete de los archivos publicados de la versión. Los nombres de los paquetes y los canales pueden cambiar, por lo que evito incluir un comando potencialmente desactualizado de winget, Scoop .deb o AppImage en los scripts de configuración inicial de las estaciones de trabajo sin fijar y probar la versión exacta. Para un despliegue controlado: - Fija una versión de CC Switch. - Registra la suma de verificación esperada de la versión. - Pruébala con una configuración desechable de Claude Code. - Haz un inventario de todos los archivos modificados durante la activación del perfil. - Define un proceso de actualización en lugar de seguir silenciosamente la última versión. Una instantánea sencilla antes de la instalación resulta útil: ``` mkdir -p /tmp/claude-config-before cp -R ~/.claude /tmp/claude-config-before/ 2>/dev/null || true # Install CC Switch, create a test profile, and activate it. diff -ru /tmp/claude-config-before/.claude ~/.claude || true ``` Esto detecta comportamientos que la documentación puede pasar por alto, como cambios de formato, campos eliminados o entradas MCP combinadas en un ámbito inesperado. ## Creación y cambio de perfiles de proveedor Un perfil debe representar un contexto coherente de seguridad y facturación. Utilizo nombres que expresan el impacto, como: - anthropic-personal - company-gateway-dev - customer-a-restricted - local-proxy-test Evita etiquetas como default-2. Cuando se produce un incidente en producción, el nombre del perfil activo debe responder a «¿adónde irá esta solicitud?» sin necesidad de abrir un editor. Un perfil de Claude Code que utilice una pasarela compatible con Anthropic podría generar ajustes conceptualmente similares a: ``` { "env": { "ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "${TOKEN_MANAGED_BY_PROFILE}", "ANTHROPIC_MODEL": "company-claude-default" }, "permissions": { "defaultMode": "default" } } ``` Las variables exactas necesarias dependen del proveedor y de la versión de Claude Code. Algunos servicios esperan ANTHROPIC_API_KEY; algunas integraciones con pasarelas utilizan ANTHROPIC_AUTH_TOKEN. No asignes valores a ambas solo para que sea «más probable» que funcione la autenticación. Determina qué credencial priorizará Claude Code, porque un valor obsoleto con mayor precedencia puede dirigir las solicitudes a la cuenta equivocada. Después del cambio, inicia un proceso nuevo de Claude Code: ``` claude ``` Es fácil malinterpretar lo que ocurre realmente cuando cambias de perfil mientras Claude Code ya está en ejecución. La utilidad puede actualizar los archivos en disco, pero no puede sustituir de forma fiable los valores de entorno que un proceso en ejecución ya ha heredado. Por tanto, las sesiones existentes pueden seguir utilizando su proveedor original hasta que se reinicien. Valida la configuración efectiva sin mostrar secretos: ``` python3 - <<'PY' import json from pathlib import Path path = Path.home() / ".claude" / "settings.json" data = json.loads(path.read_text()) env = data.get("env", {}) for key, value in sorted(env.items()): if "KEY" in key or "TOKEN" in key or "SECRET" in key: value = "" print(f"{key}={value}") PY ``` Un error habitual es comprobar únicamente si Claude responde. Un proxy compatible puede devolver una respuesta válida mientras asigna silenciosamente el modelo solicitado a otro modelo. Verifica los registros de solicitudes del proveedor o el registro de auditoría de la pasarela cuando la identidad del modelo sea importante. ## Ajustes de MCP entre agentes La configuración de MCP es donde la centralización resulta más útil que un selector de tokens. Un desarrollador puede tener servidores de sistemas de archivos, seguimiento de incidencias, bases de datos y navegadores configurados en varios agentes, cada uno con su propio esquema o ubicación de almacenamiento. Una definición típica de servidor MCP contiene un comando y argumentos: ``` { "mcpServers": { "project-files": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/alex/work/customer-a" ] } } } ``` Trata esto como una configuración ejecutable. Activar el perfil puede permitir que un agente inicie npx, ejecute un paquete y exponga el directorio especificado a la capa de herramientas accesible para el modelo. En la práctica, separo los perfiles MCP según la sensibilidad del repositorio: - Un perfil general expone documentación y herramientas de bajo riesgo. - Un perfil de cliente expone únicamente el directorio de trabajo de ese cliente. - Los servidores de bases de datos y de control de producción no se habilitan globalmente. - Los permisos de los tokens utilizados por los servidores MCP se delimitan de forma independiente de los del token del proveedor del modelo. Compara también el resultado generado por CC Switch con el comando MCP nativo del agente, cuando esté disponible. En Claude Code, inspecciona los servidores activos después del cambio: ``` claude mcp list ``` No supongas que un objeto MCP JSON puede copiarse sin cambios en todos los agentes de programación. CC Switch puede unificar la gestión en su interfaz, pero cada agente de destino sigue teniendo su propio esquema, reglas de ámbito y comportamiento de ciclo de vida. ## Dónde se almacenan las credenciales Hay dos capas de almacenamiento que auditar: - Los datos de la aplicación CC Switch, utilizados para conservar los perfiles. - La configuración nativa del agente de programación, que se escribe o actualiza cuando se activa un perfil. CC Switch utiliza almacenamiento local de la aplicación en lugar de un servicio de cuentas alojado. La ruta exacta depende de la plataforma y ha cambiado a medida que la aplicación ha evolucionado, así que determínala a partir de la compilación instalada en lugar de confiar en una ruta copiada de una incidencia antigua. Los directorios raíz habituales de datos de aplicaciones en los sistemas operativos son: ``` macOS: ~/Library/Application Support/ Windows: %APPDATA% Linux: ~/.local/share/ or an XDG data directory ``` Busca sin volcar el contenido de las credenciales: ``` find "$HOME/Library/Application Support" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null find "${XDG_DATA_HOME:-$HOME/.local/share}" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null ``` Para Claude Code, revisa ~/.claude/, especialmente settings.json, además de la configuración de Claude a nivel de proyecto cuando corresponda. Otros agentes suelen utilizar directorios independientes, como ~/.codex/ o ~/.gemini/, pero los nombres de archivo y los formatos de las credenciales dependen de la versión del agente. No dé por sentado que «almacenado localmente» significa «cifrado». A menos que la versión de CC Switch que tenga instalada utilice explícitamente un almacén de credenciales del sistema operativo para el secreto en cuestión, considere que su base de datos de la aplicación y los archivos generados para los agentes podrían ser legibles en texto plano desde su cuenta de usuario. Confírmelo inspeccionando los archivos y revisando el código del repositorio, con cuidado de no pegar secretos en terminales, incidencias ni sesiones de chat. ## Implicaciones de seguridad del acceso a tokens desde el escritorio CC Switch opera necesariamente con los permisos de su usuario de escritorio. Si esa cuenta puede leer un token, el malware u otro proceso que se ejecute con el mismo usuario también podría leerlo. CC Switch no elimina los requisitos de seguridad de los dispositivos. Los principales riesgos son: - Concentración de credenciales: Varios tokens de proveedores pueden coexistir en un mismo almacén local de perfiles. - Sobrescritura de la configuración: La activación de un perfil puede reemplazar o combinar archivos utilizados por un agente. - Filtración en copias de seguridad: Los datos de la aplicación y los archivos de configuración ocultos pueden incluirse en copias de seguridad sin cifrar. - Herencia de procesos: Las terminales antiguas y los agentes en ejecución pueden conservar las credenciales anteriores. - Ejecución de MCP: Un perfil puede activar comandos con acceso al sistema de archivos o a la red. - Exposición en la cadena de suministro: La instalación de actualizaciones permite que nuevo código de escritorio acceda a los tokens almacenados. - Divulgación en pantallas y registros: Los diagnósticos de la interfaz o los informes de errores pueden revelar datos de endpoints y credenciales. Aplique controles de privilegio mínimo al uso de la utilidad: ``` chmod 700 ~/.claude chmod 600 ~/.claude/settings.json ``` Priorice los tokens de pasarela de corta duración o revocables cuando el proveedor los admita. Nunca coloque una credencial administrativa de producción en un perfil creado por comodidad. Rote los tokens después de retirar un equipo del servicio; eliminar un perfil no demuestra que la credencial nunca se haya copiado en otro lugar. Para un despliegue empresarial, exigiría: - Versiones fijadas y revisadas - Cifrado completo del disco - Gestión restringida de las copias de seguridad - Límites de gasto y registros de auditoría del lado del proveedor - Tokens separados para cada desarrollador y entorno - Un procedimiento de revocación documentado - Revisión periódica de los comandos MCP y las rutas expuestas CC Switch resulta práctico para flujos de trabajo locales con varios proveedores. No es automáticamente adecuado para entornos cuyas políticas exigen secretos protegidos por hardware, credenciales efímeras o una configuración impuesta de forma centralizada. En esos casos, una pasarela empresarial y un lanzador respaldado por un gestor de secretos pueden constituir un diseño más defendible. ## Conclusiones prácticas - Utilice CC Switch cuando las ediciones manuales repetidas estén provocando errores de cuentas, endpoints o MCP. - Confirme los artefactos de cada plataforma en la versión actual del proyecto publicada en GitHub antes del despliegue. - Asigne a cada perfil un nombre que identifique su proveedor, propietario y entorno. - Reinicie Claude Code después de cambiar de perfil, ya que los procesos en ejecución pueden conservar los valores anteriores. - Inspeccione los archivos generados y utilice claude mcp list para verificar el estado efectivo. - Trate los datos locales de CC Switch y las configuraciones de los agentes que los utilizan como almacenes de credenciales sensibles. - Delimite el alcance de los servidores MCP con el mismo cuidado que el de los tokens de API; pueden ejecutar comandos y exponer archivos. - Fije las versiones, pruebe las diferencias de configuración y mantenga un mecanismo de revocación de tokens. - Mantenga las credenciales de producción de alto impacto fuera de las herramientas de escritorio para cambiar de perfil, salvo que los controles del entorno permitan asumir explícitamente ese riesgo. [Programación](/es/blog/tag/coding/)[Claude](/es/blog/tag/claude/)[API](/es/blog/tag/api/) A [AI Prime Tech](https://aiprimetech.io/es/) AI Prime Tech publica este blog. Los artículos se redactan con asistencia de IA; comprueba los detalles específicos de cada versión, como los identificadores de modelos, los precios y los límites, en la documentación oficial antes de basarte en ellos. Obtén acceso más económico a la API de Claude Una sola clave de API para Claude Opus 5.5, Sonnet 5, Haiku 4.5 y Fable 5.1, además de GPT-6 modelos. Pago por uso, sin suscripción. [Obtén tu clave de API →](/register) AI Prime Tech es una pasarela de API independiente de terceros. Claude™ y Anthropic® son marcas comerciales de Anthropic, PBC. No se implica ninguna afiliación ni respaldo.