Uso de CC-Switch-CLI
CC-Switch-CLI es una herramienta de cambio de proveedores (providers) para la línea de comandos, adecuada para servidores sin interfaz gráfica, entornos SSH o para personas que necesitan cambiar rápidamente de proveedor entre Claude Code, Codex, Gemini CLI, OpenCode y OpenClaw.
A quién va dirigido
Si eres un usuario de escritorio habitual, prioriza el uso de la interfaz gráfica de CC Switch; si ya estás acostumbrado a la terminal o necesitas gestionar configuraciones por lotes, consulta esta página. Los siguientes bloques de código solo contienen comandos, con explicaciones ubicadas fuera de los bloques de código para evitar copiar las explicaciones junto con los comandos.
Instalación e inicio
Los usuarios de macOS / Linux pueden seguir la documentación oficial para usar el script de instalación o el paquete de Releases; a los usuarios de Windows se les recomienda descargar el paquete comprimido correspondiente desde Releases y ejecutarlo en el directorio del programa tras descomprimirlo.
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch.\cc-switch.exeAl ingresar directamente cc-switch entrarás en la interfaz interactiva, ideal para que los principiantes exploren primero el menú; los siguientes comandos son adecuados para cuando ya sabes lo que deseas hacer y quieres ejecutarlos directamente.
Comprobación del entorno
| Aspecto a confirmar | Cómo comprobarlo | Por qué |
|---|---|---|
| CC Switch o la versión CLI está instalada | Esta terminal puede reconocer el comando correspondiente | Cualquier comando de configuración fallará si no está instalado. |
| La CLI de destino está instalada | Claude Code, Codex y Gemini CLI al menos pueden iniciarse individualmente | CC-Switch-CLI no instala la herramienta de destino por ti |
| La información del proveedor está completa | Ten a mano la Base URL, la API Key y el nombre del modelo | La configuración por línea de comandos no tiene avisos gráficos, y olvidar un elemento puede causar fallos fácilmente. |
| Verifica primero en un directorio de prueba | No cambies de proveedor en lote directamente en proyectos reales | Es más fácil revertir cambios si la configuración es incorrecta |
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider currentComandos de Provider
Un Provider es la configuración de un proveedor. Antes de agregar un Provider, prepara primero la Base URL, la API Key y el nombre del modelo desde el panel del proveedor; al editar o cambiar de proveedor, confirma primero el número usando el comando de lista.
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>< id> debe reemplazarse por el número que aparece dentro de cc-switch provider list. No ejecutes < id> tal cual de forma literal.Gestión por aplicación
Si solo deseas ver la configuración de una herramienta de destino específica, puedes añadir --app. Esto resulta muy útil para resolver problemas en Claude Code, Codex y Gemini CLI por separado.
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider listcc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider currentTras confirmar que la aplicación de destino y el proveedor actual están correctos, procede a realizar el cambio. Una vez completado el cambio, reinicia la terminal y luego usa la herramienta de destino para enviar una consulta de prueba mínima.
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"Sincronización de MCP
MCP no es necesario para todos los principiantes. Ocúpate de ello únicamente si ya has utilizado MCP en Claude Code, Codex o Gemini CLI y necesitas sincronización entre herramientas. Para la primera vez, se recomienda entrar primero al menú TUI para revisar el área de MCP y no copiar directamente comandos avanzados de tutoriales antiguos.
cc-switch cc-switch --app codexMetodología de configuración
- Confirma primero la herramienta de destino a la que deseas cambiar: Claude Code, Codex, Gemini CLI u otra CLI.
- Prepara la Base URL, la API Key y el nombre del modelo desde el panel del proveedor.
- Agrega o selecciona un Provider en CC-Switch-CLI.
- Aplica el Provider a la herramienta de destino.
- Tras reabrir la terminal, prueba con una pregunta mínima en la CLI de destino.
- Una vez confirmado el funcionamiento, aplica el mismo Provider a las demás herramientas de destino.
| Escenarios | Recomendaciones |
|---|---|
| Uso en escritorio local | Prefiere el uso de la interfaz gráfica de CC Switch; los campos y el estado son más intuitivos |
| Servidor remoto / SSH | Usa entonces CC-Switch-CLI; consulta los comandos de la versión actual antes de operar |
| Cambio de configuración por lotes | Verifica primero el éxito en un proyecto de prueba y luego aplícalo a proyectos reales |
| Varios usuarios compartiendo equipo | No escribas tu Key en la configuración pública; confirma primero el alcance del archivo de configuración |
Solución de problemas para principiantes
| Problema | Comprobación prioritaria | Solución |
|---|---|---|
| Command not found | Comprueba si está instalado y si está añadido al PATH | Reabre la terminal o regresa a las instrucciones de instalación oficiales para confirmar la ruta de instalación |
| La herramienta de destino no cambió tras el cambio | Si se ha reabierto la terminal y si se seleccionó la herramienta de destino correcta | Cierra la ventana de terminal actual, vuelve a abrirla y prueba de nuevo |
| 401 / Unauthorized | Si la Key está completa y si no ha expirado | Copia la Key de nuevo, asegurándote de que no haya espacios adicionales |
| model not found | Si el nombre del modelo se copió exactamente del panel de control | Vuelve a rellenarlo de acuerdo con la lista de modelos del proveedor |