Tutorial de configuración en un solo clic con CC-Switch (recomendado para principiantes)

¡Primera opción recomendada para principiantes!

CC-Switch es una herramienta de configuración en un solo clic diseñada específicamente para usuarios sin experiencia: no requiere editar archivos de configuración a mano, se maneja con una interfaz gráfica y completa el cambio de canal en poco más de diez segundos.

Pasos de configuración

1. Descarga e instala CC-Switch

• Windows: ve a CC-Switch GitHub Releases para descargar el instalador .msi
• macOS (Homebrew):

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

• Linux: descarga el paquete .deb desde la página de Releases para instalarlo

Tras la descarga, completa la instalación en tu equipo.

2. Abre el programa y selecciona la CLI a configurar

Inicia CC-Switch y, en la interfaz principal, selecciona la herramienta que quieras configurar (como Claude Code, Codex, etc.) y, a continuación, haz clic en «Añadir proveedor» para configurarla.

3. Rellena la información del proveedor

• Nombre del proveedor: escribe NextHub
• Dirección de solicitud: para Claude Code, introduce https://api.nexthub.cc; para Codex, introduce https://api.nexthub.cc/v1
• Formato de API: configúralo según el tipo de CLI que hayas elegido
• API Key: introduce la clave que has generado en la consola

¿Hay que añadir /v1 a la dirección de solicitud?

Claude Code usa el protocolo Anthropic y añade automáticamente /v1/messages a la dirección, por lo que basta con introducir solo el dominio; Codex usa el protocolo OpenAI Responses (/v1/responses), de modo que la dirección de solicitud debe incluir /v1.

Una vez completados los datos, haz clic en el botón «Añadir» de la esquina inferior derecha para guardar la configuración.

4. Confirma que el canal está activo

Vuelve a la interfaz principal y comprueba el canal en uso para asegurarte de que se haya cambiado al canal de NextHub que acabas de configurar.

5. Omitir la confirmación de la primera instalación de Claude Code (opcional)

En la interfaz principal, haz clic en el botón «Ajustes», entra en la página de ajustes generales, busca «Omitir la confirmación de la primera instalación de Claude Code» y asegúrate de que esta opción esté activada.

6. Verificación desde la terminal

Abre la terminal y ejecuta claude o codex para mantener una conversación sencilla y comprobar que la configuración funciona. Si recibes una respuesta, la configuración se completó con éxito 🎉

claude

También puedes configurar Claude Desktop

CC-Switch incorpora un panel de Claude Desktop que permite importar en un solo clic los proveedores que ya tienes en Claude Code; tras el cambio, recuerda reiniciar Claude Desktop por completo. Consulta los pasos detallados en el tutorial de configuración de Claude Desktop.

Funciones destacadas de CC-Switch

Cambio de la configuración de API en un solo paso, gestión visual de la configuración, gestión de servidores MCP, acciones rápidas desde la bandeja del sistema, proxy local con conmutación en caliente y failover de canales totalmente automático.