En resumen

Abre status.claude.com. Si hay un incidente activo de Claude Code o de la API, también está caído para los demás y lo que toca es esperar.

Si la página de estado está en verde, lee el error exacto. La referencia de errores de Anthropic los divide en unas pocas familias:

Claude Code ya reintenta los fallos transitorios hasta 10 veces con espera progresiva antes de mostrarte un error, así que un error visible significa que se agotaron los reintentos.

El problema

Claude Code deja de responder o aparece un error en rojo a mitad de tarea. Buscar "Claude Code caído" es el reflejo natural, pero muchas veces el servicio funciona y el fallo está más cerca: un límite de uso, un proxy, una VPN, una sesión caducada. Los dos casos piden respuestas opuestas. Esperar no arregla un proxy y reinstalar no arregla una caída.

Paso 1: revisa la página de estado de Claude

status.claude.com lista los incidentes de los servicios de Claude, incluida la API que usa Claude Code. Los mensajes de error de Anthropic también remiten allí. Desde la v2.1.198, cuando la causa es una sobrecarga 529, la cuenta atrás del reintento indica dónde consultar el estado.

Si usas Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry o una pasarela, el error nombra ese proveedor o host. Consulta la página de estado de ese proveedor, no la de Anthropic.

Paso 2: lee el mensaje de error

API Error: 500 Internal server error

Anthropic lo describe como un problema del servidor, normalmente temporal. Vuelve a intentarlo en un momento. Si persiste, revisa la página de estado.

API Error: Repeated 529 Overloaded errors

La API está a plena capacidad. La referencia de Anthropic dice que un 529 no es tu límite de uso y no cuenta para tu cuota. Un mensaje como Opus is experiencing high load pertenece a la misma familia. Cambiar a otro modelo con /model te permite seguir mientras pasa la carga.

Server is temporarily limiting requests (not your usage limit)

Una limitación breve que no tiene que ver con tu plan. Desde la v2.1.199, Claude Code la reintenta automáticamente antes de mostrarla. Espera un poco y vuelve a intentarlo.

You've hit your session limit o weekly limit

No es una caída. Se ha agotado la cuota de tu plan y el mensaje indica cuándo se reinicia. Consulta cuándo se reinicia el uso de Claude Code y qué hacer al llegar al límite.

Request rejected (429)

Has alcanzado el límite de tasa configurado para tu clave de API, tu proyecto de Bedrock o tu proyecto de Google Cloud. Si un proxy o una pasarela respondió con su propia página 429, su título aparece después del ·.

Unable to connect to API

Falló la conexión con la API. Las versiones recientes indican la causa y mantienen el código de error entre paréntesis, por ejemplo ConnectionRefused, ENOTFOUND o EHOSTUNREACH. Ejemplos de mensajes:

Unable to connect to API. Check your internet connection
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
Connection dropped (ECONNRESET)

Anthropic menciona como causas habituales no tener conexión a internet, una VPN que bloquea api.anthropic.com y un proxy corporativo sin configurar.

Paso 3: prueba la conexión desde la misma shell

curl -I https://api.anthropic.com

En Windows PowerShell usa curl.exe -I https://api.anthropic.com para no usar el alias integrado.

• curl falla: el problema es la red de este equipo. Revisa el Wi-Fi, la VPN y el DNS. Detrás de un proxy corporativo, define HTTPS_PROXY antes de abrir Claude Code.
• curl funciona pero Claude Code no: hay algo entre el runtime y la red. Revisa ANTHROPIC_BASE_URL si usas una pasarela, y los hosts permitidos del cortafuegos en la página de configuración de red de Anthropic.

Paso 4: descarta la instalación local

Si la página de estado está en verde y la red funciona:

1. Actualiza: claude update.
2. Comprueba que has iniciado sesión con la cuenta que esperas: /status dentro de Claude Code.
3. Busca un ANTHROPIC_API_KEY olvidado en tu entorno, que tiene prioridad sobre el inicio de sesión con suscripción.
4. Si se queda colgado o usa mucha CPU en lugar de dar errores, la página de solución de problemas de Anthropic cubre las causas habituales.

Para ejecuciones desatendidas

Para CI u otros trabajos que nadie vigila, Anthropic documenta CLAUDE_CODE_RETRY_WATCHDOG=1. Reintenta indefinidamente los errores de capacidad 429 y 529 en lugar de fallar tras los reintentos normales. Un 429 por límite de gasto sigue fallando al instante. Combínalo con un tiempo máximo para el trabajo, para que una caída larga no ocupe un runner sin fin.

Distinguir un problema del proveedor de uno del ordenador cuando no estás

Cuando una sesión se ejecuta en un ordenador delante del que no estás, "Claude Code no funciona" puede significar tres cosas: el proveedor tiene problemas, la sesión llegó a un límite o el propio ordenador se desconectó.

Si quieres distinguirlas desde el móvil, Happier es una app de código abierto para ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos, desde el móvil, el escritorio o la web.

Lo que muestra:

• Cada máquina aparece como en línea (online) o desconectada (offline), con la última vez que se vio. Si el ordenador está desconectado, el estado del proveedor no importa hasta que vuelva.
• Los límites de uso aparecen como un aviso en la sesión, Límite de uso alcanzado (Usage limit reached), con la hora de reinicio que dio el proveedor. Así distingues una parada por cuota de una caída.

En el ordenador, happier daemon status muestra si el servicio en segundo plano está en marcha. Happier no arregla caídas del proveedor, cortes de red ni un ordenador apagado. La configuración está en Cómo usar Happier desde el móvil. Está en GitHub, puedes descargarlo aquí y hay un Discord.

Preguntas frecuentes

¿Está caído Claude Code ahora mismo?

Consulta status.claude.com. Es la fuente a la que remiten los propios mensajes de error de Anthropic.

¿Un error 529 gasta mi uso?

No. La referencia de errores de Anthropic dice que un 529 no es tu límite de uso y no cuenta para tu cuota.

El chat de Claude funciona pero Claude Code no. ¿Por qué?

Comparten cuenta, pero no siempre el mismo camino. Claude Code puede estar usando una clave de API, un proxy, una pasarela o un proveedor en la nube. Revisa /status y tus variables de entorno.

¿Por qué Claude Code se detiene con "Connection lost while your computer was asleep"?

El ordenador entró en reposo durante una petición. Claude Code reintenta las conexiones perdidas y, si aun así el turno termina, vuelve a enviar el mensaje.

Guías relacionadas

• Cómo saber qué sesión de Claude Code, Codex u OpenCode está atascada (sin revisar 10 terminales)
• ¿Cuándo se reinicia el uso de Claude Code? La ventana de cinco horas y el límite semanal, explicados
• ¿Has llegado al límite de uso de Claude Code? Qué hacer y cómo seguir trabajando
• Mantén Claude Code, Codex y OpenCode en marcha cuando el portátil entra en reposo (cortes de Wi-Fi, cerrar la tapa, reanudar)