Resolución de problemas de Claude Code
El aspecto clave para solucionar problemas en Claude Code es confirmar si ha obtenido la configuración de Claude / Anthropic. No mezcle direcciones compatibles con OpenAI, nombres de modelos de Codex ni claves de Gemini en Claude Code.
¿Qué se debe verificar primero?
| Elemento a verificar | Cómo comprobarlo | Motivo |
|---|---|---|
| Herramienta de destino | Asegúrese de estar solucionando problemas de Claude Code, no de Codex ni de Gemini CLI | Los archivos de configuración, protocolos y nombres de modelos varían según la herramienta. |
| Compatibilidad del proveedor | Claude, Anthropic y Claude Code se mencionan explícitamente en el panel o tutorial | Los proveedores que solo ofrecen interfaces compatibles con OpenAI no necesariamente son compatibles con Claude Code |
| Tipo de clave (Key) | Utilice la clave correspondiente a Claude / Anthropic | Si el tipo de clave es incorrecto, provocará directamente un error 401 o un fallo de autenticación |
| Estado del terminal | Tras cambiar la configuración, vuelva a abrir el terminal y realice la prueba nuevamente | Es posible que el terminal anterior aún esté usando las variables de entorno o configuraciones previas al cambio |
Errores comunes
| Problema | Comprobación prioritaria | Solución |
|---|---|---|
| El comando se abre, pero la solicitud falla | Si Claude Code ha obtenido la nueva configuración | Cierre la ventana del terminal actual y vuelva a abrirla, luego envíe la pregunta de prueba más corta posible. Después de cambiar mediante CC-Switch, no modifique manualmente la misma configuración al mismo tiempo. |
| 401 / No autorizado (Unauthorized) | Tipo e integridad de la clave | Confirme que esté utilizando la clave correspondiente para Claude / Anthropic; no introduzca claves compatibles con OpenAI en Claude Code. Verifique que no haya espacios al principio o al final al volver a copiar. |
| 404 / Modelo no encontrado (model not found) | Nombre del modelo de Claude | Escríbalo exactamente como aparece en el panel del proveedor para los modelos de Claude; no altere mayúsculas/minúsculas, guiones ni números de versión. |
| Tiempo de conexión agotado o sin respuesta | Base URL de Claude | Verifique la dirección de API de Claude / Anthropic en el panel; los proveedores que solo ofrecen direcciones compatibles con OpenAI podrían no ser compatibles con Claude Code. |
| Sigue usando el proveedor anterior después de cambiar | Sesión del terminal y origen de configuración | Vuelva a abrir el terminal y realice la prueba nuevamente; si sigue sin surtir efecto, confirme que el proveedor actual en CC-Switch se haya aplicado a Claude Code. |
Prueba mínima
Al realizar pruebas, primero envíe una pregunta corta predeterminada, confirme que puede responder y luego continúe con el proyecto real.
Prueba mínima de Claude Code
claude "Please reply only: Claude Code configuration test successful"Plantilla de reporte
Al enviar un reporte al proveedor, redacte de la siguiente manera
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened