ai2saveai2save

Errores comunes y verificación de conexión

401 / invalid_api_key

Confirma que la solicitud se haya enviado a Base URL y que la autorización use Bearer sk-.... Verifica si la clave está completa, si ha sido revocada o si pertenece al grupo correcto.

404 / model not found

Revisa secuencialmente el ID del modelo, la dirección del protocolo y el grupo de claves. OpenAI Compatible normalmente utiliza la dirección con /v1; Claude Code normalmente utiliza la dirección raíz sin /v1.

403 o bloqueo de control de riesgo

Configura un User-Agent explícito en el script para reducir la probabilidad de que un User-Agent vacío sea interceptado por la puerta de enlace. No intentes evadir restricciones mediante reintentos continuos.

Solicitud muy lenta

Primero prueba con preguntas cortas. Si las preguntas cortas son rápidas pero las tareas complejas lentas, usualmente se debe al tiempo de inferencia del contexto o del modelo; si las preguntas cortas también son lentas, verifica la red local, la ruta y el estado del servicio.

Conexión exitosa pero el cliente no cambia

Cierra completamente el cliente y vuelve a abrirlo. Revisa si existen múltiples archivos de configuración, variables de entorno antiguas que sobrescriben la nueva configuración o si CC Switch no ha activado realmente al proveedor objetivo.

Lista de verificación antes de lanzar

  • Verifica la clave, Base URL y el modelo con la solicitud mínima.
  • Configura tiempo de espera, reintentos, concurrencia y límites de presupuesto.
  • Prepara rutas alternativas o modelos de respaldo.
  • Separa los datos de logs, no registres la clave completa.