«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.

Arréglalo con tu agenteCopia un prompt para Claude Code, Codex o cualquier agente que pueda usar Terminal.

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.

Se aplica a: Claude Code en un terminal, en todas las versiones actuales de macOS.Revisado: 29 de octubre de 2026

Síntomas

  • Claude Code muestra Request timed out tras 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

  1. Prueba el host de la API desde el mismo shell.

    curl -I https://api.anthropic.com
  2. Comprueba tu versión.

    claude --version
  3. Muestra las variables de proxy.

    env | grep -i proxy
  4. Ejecuta las comprobaciones de configuración dentro de Claude Code.

    /doctor

Cómo solucionarlo

  1. Repite la solicitud.

  2. En una red o un proxy lentos, aumenta el tiempo de espera.

    export API_TIMEOUT_MS=900000
  3. Actualiza Claude Code si pusiste el tiempo de espera en 0.

  4. Si los tiempos de espera son frecuentes, prueba otra red y la VPN.

Con Kilobat

  1. 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.com
  2. Estas comprobaciones de Kilobat son gratuitas. Los agentes de IA las ejecutan por MCP con diagnose_connection y diagnose_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.