CC-Switch Claude Code
Esta página solo explica una cosa: cómo agregar o seleccionar un Provider en CC Switch y luego aplicarlo a Claude Code. No es un tutorial de configuración directa de Claude Code; si deseas modificar directamente el archivo de configuración de Claude Code, consulta la configuración de la CLI de Claude Code.
Qué explica esta página
El propósito de CC Switch es ayudarte a gestionar Providers de forma centralizada y sincronizar las configuraciones con las herramientas de destino. Para Claude Code, concéntrate en verificar el protocolo de Claude / Anthropic, la Key y el nombre del modelo. No utilices directamente una dirección compatible con OpenAI como dirección de Claude a menos que el proveedor indique explícitamente que es compatible con Claude Code.
Verificaciones antes de comenzar
| Qué verificar | Cómo comprobarlo | Por qué |
|---|---|---|
| Claude Code puede iniciarse ahora | Confirma en la terminal o cliente que Claude Code se abre con normalidad | CC Switch solo se encarga de cambiar configuraciones, no de instalar Claude Code |
| El proveedor es compatible con Claude Code | Puedes ver instrucciones relacionadas con Claude / Anthropic / Claude Code en el panel de control o en la documentación | Los proveedores que solo ofrecen interfaces compatibles con OpenAI podrían no funcionar con Claude Code |
| La Key y el nombre del modelo son válidos | Puedes ver tokens, Keys, listas de modelos o instrucciones de modelos disponibles en el panel de control | Escribir incorrectamente el nombre del modelo provocará directamente el error de modelo no encontrado |
| Cambia solo una herramienta de destino primero | Al principio, selecciona únicamente Claude Code | Es más fácil identificar dónde está el problema durante la resolución de errores |
Cómo rellenar los campos
| Ajuste | Modo de completarlo | Atención para principiantes |
|---|---|---|
| Provider Name | Escribe un nombre fácil de reconocer | Por ejemplo, 'Proveedor principal Claude', no escribas solo números |
| Target Tool / Preset | Selecciona Claude Code o el ajuste predeterminado relacionado con Claude | No selecciones Codex, OpenAI ni Gemini |
| Base URL | Copia el enlace de la API proporcionado por el panel del proveedor para Claude / Anthropic | No todos los proveedores comparten la misma Base URL que OpenAI |
| API Key | Copia la Key completa generada en el panel de control | A menudo también se le llama token, Key o clave secreta |
| Model Name | Copia exactamente el nombre del modelo de Claude admitido por el panel | No lo abrevies por tu cuenta y no cambies el nombre visible por el nombre real del modelo |
Aplicar a Claude Code
- Abre CC Switch y ve al área de gestión de Providers.
- Añade un nuevo Provider o selecciona una configuración de proveedor que ya hayas creado.
- Selecciona los ajustes predeterminados relacionados con la herramienta de destino Claude Code.
- Rellena en orden el Provider name, Base URL, API Key y el nombre del modelo.
- Tras guardar, ejecuta Apply / Switch para aplicar el Provider actual a Claude Code.
- Si la interfaz indica que debes reiniciar la terminal o la herramienta de destino, cierra la sesión actual de Claude Code y vuelve a abrirla.
Comprobar si funciona
Durante la prueba, envía primero una pregunta sumamente corta y no abras directamente un proyecto real. Siempre que responda con normalidad, indicará que la Key, la Base URL, el nombre del modelo y la sincronización con la herramienta de destino son básicamente funcionales.
claude "Please reply only: CC-Switch Claude Code is active"