«Request timed out» en Claude Code en el Mac
Claude Code muestra «Request timed out» cuando la API no responde antes del límite de la conexión. El tiempo de espera predeterminado de las solicitudes es de 10 minutos.
Mi Mac tiene este problema: «Request timed out» en Claude Code en el Mac. Lee https://kilobat.app/es/guides/claude-code-request-timed-out.md y resuélvelo conmigo. Instala la CLI de Kilobat si falta: brew install seifip/kilobat/kilobat. Ejecuta tú mismo las comprobaciones de Terminal y de kilobat de la guía y dime qué encuentras. Enumera los pasos que solo yo puedo hacer. Pregunta antes de cambiar cualquier ajuste.
Síntomas
- Claude Code muestra
Request timed outtras una espera larga. - Ocurre en redes lentas, a través de proxies o con solicitudes grandes.
- Algunos reintentos funcionan.
Causas probables
- Una red o un proxy lentos. La documentación indica que una red o un proxy lentos pueden causarlo.
- Una conexión detenida. Una VPN o un firewall pueden retener paquetes, así que no llega ninguna respuesta.
- Una solicitud grande. Una solicitud sin streaming mantiene un límite de 300 segundos en una sesión local.
- Un tiempo de espera de cero en una versión antigua. En versiones anteriores a la v2.1.305, poner API_TIMEOUT_MS en 0 puede hacer que todas las solicitudes fallen.
Cómo comprobarlo
Prueba el host de la API desde el mismo shell.
curl -I https://api.anthropic.comComprueba tu versión.
claude --versionMuestra las variables de proxy.
env | grep -i proxyEjecuta las comprobaciones de configuración dentro de Claude Code.
/doctor
Cómo solucionarlo
Repite la solicitud.
En una red o un proxy lentos, aumenta el tiempo de espera.
export API_TIMEOUT_MS=900000Actualiza Claude Code si pusiste el tiempo de espera en 0.
Si los tiempos de espera son frecuentes, prueba otra red y la VPN.
Con Kilobat
El doctor de conexión de Kilobat prueba el host de la API capa por capa. Indica la capa que falla o va lenta.
kilobat why https://api.anthropic.comEstas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con
diagnose_connectionydiagnose_network. Consulta Averiguar por qué no conecta un sitio o una API.
Preguntas
¿Cuál es el tiempo de espera predeterminado?
La documentación de Claude Code indica 10 minutos para el tiempo de espera de las solicitudes.
¿API_TIMEOUT_MS=0 desactiva todos los límites?
No. El límite del primer byte y el tiempo de inactividad del cuerpo siguen activos.
Fuentes
Comprobado el 29 de octubre de 2026.