Teapot Router / Documentación
Solución de problemas de Claude Code: conexión, 401 y cuota
Asocia el error a la solución: red y proxy, clave y URL, saldo y cuota — tres comprobaciones para tres clases de fallo.
Abrir panelConexión o timeout: revisa primero la ruta de red
- El CLI no hereda el proxy del sistema. Ejecuta `echo $https_proxy` — si está vacío, expórtalo y reintenta.
- La extensión de VSCode tiene su propia pila de red y puede no heredar el proxy ni las variables de entorno — configura el proxy dentro de la extensión.
- Con endpoint personalizado, revisa ANTHROPIC_BASE_URL (caracteres o barras de más); no mezcles la URL oficial con la de un gateway.
Si funciona en otra red (hotspot del móvil) y no en la tuya, es puramente red — no la clave.
401 o 403: revisa clave y dirección
- El 401 suele ser la clave: copia incompleta (espacios), revocada o caducada, o clave de otro proveedor.
- Con endpoint personalizado, clave y dirección van en pareja — la clave de un proveedor contra la URL de otro siempre da 401.
- Un nombre de campo mal escrito en el env de settings.js puede recaer en silencio al endpoint por defecto: parece configurado pero sigue yendo a la URL oficial.
Una clave revocada no vuelve; reinicia el cliente tras cambiarla.
429, cuota y modelo no encontrado
- El 429 es límite de tasa: espera la ventana o baja la concurrencia.
- 'Cuota insuficiente' tiene dos capas: el saldo de la cuenta y el límite propio de la clave — el límite es un techo, no crédito extra.
- 'Modelo no encontrado': comprueba que el ID del cliente coincida exactamente (mayúsculas, versión) con el catálogo Modelos.
Cada petición (modelo/tokens/coste) está en el registro de uso — tras arreglar el error, concilia una entrada para ver si algún reintento silencioso cobró doble.