---
title: "«Request timed out» en Claude Code en el Mac · Guías de Kilobat"
url: "https://kilobat.app/es/guides/claude-code-request-timed-out"
description: "Claude Code en tu Mac muestra «Request timed out». La API no respondió antes del límite. Revisa la red, un proxy y el ajuste de tiempo de espera."
---

# «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 agente**Copia 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](https://kilobat.app/es/guides/recipes/why-cant-it-connect).

## 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

- [Claude Code: referencia de errores](https://code.claude.com/docs/en/errors.md)
- [Claude Code: configuración de red empresarial](https://code.claude.com/docs/en/network-config.md)

Comprobado el 29 de octubre de 2026.

## Guías relacionadas

- [«Unable to connect to API» en Claude Code en el Mac](https://kilobat.app/es/guides/claude-code-unable-to-connect-to-api): Claude Code muestra Unable to connect to API cuando una solicitud no llega a api.anthropic.com.
- [ERR_CONNECTION_TIMED_OUT en Chrome en el Mac](https://kilobat.app/es/guides/err-connection-timed-out): Chromium describe este error así: «A connection attempt timed out.» (se agotó el tiempo de un intento de conexión). Chrome encontró la dirección, pero el servidor no respondió a tiempo.
- [Bufferbloat: las llamadas van con retraso cuando la red está ocupada](https://kilobat.app/es/guides/bufferbloat-mac): El bufferbloat es la latencia que añaden los dispositivos de red cuando retienen demasiados datos en sus búferes.
- [Detectar pérdida de paquetes en un Mac con ping](https://kilobat.app/es/guides/packet-loss-mac): La pérdida de paquetes hace que las llamadas se corten y las páginas se queden atascadas.
