Claude Code API Error 500 y 529: reanuda sin duplicar trabajo

Si Claude Code muestra API Error: 500, la API que respondió sufrió un fallo interno. Según la referencia oficial de errores, no lo causan tu petición, tu configuración ni tu cuenta. Con la API de Anthropic, la terminal muestra este mensaje:

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

Antes de reintentar, fíjate en cuándo apareció, porque eso cambia el primer paso:

• A mitad de una tarea, igual que con un 529 o con el aviso The response above may be incomplete: conserva la conversación y revisa qué llegó a completarse. El error no demuestra que los archivos sigan intactos ni que una operación externa haya fallado; Code puede conservar bloques terminados y ejecutar llamadas a herramientas que ya estaban completas.
• Al iniciar sesión, por ejemplo con OAuth error: Request failed with status code 500: todavía no empezó ninguna tarea, así que no hay trabajo que comprobar. Mira el estado del servicio, espera y reinicia el inicio de sesión.
• En cada turno de una conversación reanudada concreta, mientras una sesión nueva funciona: actualiza Code y reanúdala de nuevo. Si sigue fallando, continúa en una sesión nueva con un resumen del estado comprobado, sin reenviar a ciegas la instrucción original.

Para retomar una tarea interrumpida, sigue este orden:

1. Lee el mensaje completo y deja terminar los reintentos que aún estén en marcha. Comprueba el estado del proveedor que nombra el error.
2. Si la conversación sigue abierta, continúa en ella. Si cerraste Code, abre claude --resume desde la carpeta del proyecto y selecciona la conversación correcta.
3. Contrasta el historial con los archivos, las tareas en ejecución y los registros externos. Después pide que continúe solo los pasos pendientes, indicando qué ya está hecho y qué no debe repetirse.

Recuperar la conversación devuelve el contexto disponible; comprobar el trabajo establece desde dónde puedes continuar. Son dos pasos distintos.

«Claude no está disponible temporalmente»: identifica el mensaje de Code

Una indicación de indisponibilidad temporal no basta para saber si falta capacidad, se agotó una cuota o la respuesta se cortó. En Code, guarda la línea completa de la terminal. Si el aviso aparece en la web de Claude y no en Code, consulta la guía del error interno del servidor en Claude, que separa los distintos accesos.

Estas distinciones proceden de la referencia de errores de Code; las dos filas de un 500 al iniciar sesión y en una conversación reanudada resumen informes de usuarios que se detallan más abajo. Para Anthropic, comprueba Claude Status. Con Amazon Bedrock, Google Cloud o Microsoft Foundry, el final del mensaje nombra la página de estado de ese proveedor; con una ANTHROPIC_BASE_URL personalizada, nombra el host de la pasarela. Un estado público en verde no garantiza que tu solicitud individual haya funcionado.

Si la respuesta de error viene de un proxy o una pasarela, por ejemplo API Error: 502 Bad Gateway, consulta Claude Code 403, 503 y 529: quién da el error y cómo arreglarlo. Si el 500 te llega en tu propio código al llamar a la API directamente, la guía adecuada es Error 500 en Claude API: cómo reintentar y qué hacer si persiste.

«Request failed with status code 500» al iniciar sesión

Si el 500 aparece antes de empezar a trabajar, falló el paso de inicio de sesión y no hay archivos ni comandos que revisar. Esta variante aparece en informes de usuarios en GitHub de marzo y abril de 2026 (#33226, #44271, #44725). La terminal mostraba OAuth error: Request failed with status code 500, a veces después de OAuth error: timeout of 15000ms exceeded. El navegador podía mostrar «Authorization failed» con «Internal server error» en la página de autorización de claude.ai, y un informe muestra OAuth error: Failed to fetch user roles: Request failed with status code 500. Varios informes de ese periodo se abrieron el mismo día, el 6 de abril de 2026, lo que encaja con un problema del servicio, pero en esos hilos Anthropic no confirmó la causa.

Sigue estos pasos en orden y prueba una sola vez después de cada uno:

1. Mira el estado y espera. El historial de Claude Status registró el 24 de agosto de 2026 dos incidencias breves de acceso, de 16:02 a 16:08 y de 20:00 a 20:08 UTC, que incluían expresamente conectar Claude Code con una suscripción. Si hay una incidencia abierta, espera a que se cierre.
2. Reinicia el inicio de sesión. Con el servicio en verde, la documentación oficial de instalación y acceso propone un reinicio limpio cuando el fallo de acceso no tiene una causa evidente: ejecuta /logout, cierra Claude Code, vuelve a lanzar claude y completa el acceso. Si el navegador no se abre o la URL se parte en la terminal, pulsa c para copiarla y pégala en el navegador. Esa documentación no describe una solución específica para un 500 de OAuth; es el reinicio general.
3. En WSL2, SSH o un contenedor, el navegador suele abrirse en otro equipo y su redirección no alcanza el puerto local de retorno de Claude Code. Tras iniciar sesión, el navegador muestra un código: pégalo en Paste code here if prompted. Si pegar no hace nada, usa claude auth login, que lee el código desde la entrada estándar.
4. Si la misma cuenta entra sin problema desde otro equipo, sospecha de la ruta local de este: cortafuegos, proxy o el puerto local de retorno. En el informe #44725, el equipo que fallaba tenía una política de cortafuegos gestionada que bloqueaba conexiones entrantes, y la misma cuenta funcionaba en otra máquina. Es un caso único, no una causa confirmada.

Ten en cuenta que /logout elimina todas las credenciales guardadas, incluidos los accesos a servidores MCP y los valores sensibles de plugins; tendrás que autorizarlos de nuevo. Si ves OAuth error: Invalid code, el código caducó o se cortó al copiarlo: repite el acceso y complétalo enseguida.

La hora del sistema y el llavero de macOS solo entran en juego si Code te pide iniciar sesión una y otra vez. La validación del token depende de que el reloj sea correcto. En macOS, claude doctor avisa con macOS Keychain is not writable cuando el llavero rechaza escrituras; desbloquéalo con security unlock-keychain ~/Library/Keychains/login.keychain-db y vuelve a ejecutar /logout y /login. Son comprobaciones para avisos de acceso repetidos, no una causa demostrada del 500.

Después de entrar, /status muestra qué método de autenticación está activo. Si existe una ANTHROPIC_API_KEY aprobada, Code la usa en lugar de la suscripción, y con -p la usa siempre; una clave antigua en el perfil de la shell puede hacer que pruebes una ruta distinta de la que crees. Para saber qué credencial paga, consulta Claude Code: API key, suscripción y facturación API sin sorpresas. Los mensajes de acceso que no son un 500, como Login expired, Not logged in u OAuth token revoked, están en Temporarily unable to authenticate en Claude: qué es y qué hacer.

¿Reintentar o continuar? Depende de lo que llegó a completarse

El límite general predeterminado de Claude Code es de hasta 10 reintentos de fallos transitorios con esperas crecientes, pero esa cifra no describe todos los cortes ni significa «10 intentos totales». Cuando muestra el error final, ya ha agotado los reintentos aplicables a ese caso. La política de reintentos automáticos distingue estos puntos:

• Antes de recibir la respuesta: puede reintentar errores de servidor, sobrecarga y tiempos de espera agotados. Si termina con un 500 y no queda trabajo parcial por comprobar, espera un minuto y escribe try again en la misma conversación; el mensaje original sigue ahí.
• Tras completar el razonamiento, antes de empezar texto o una llamada a herramienta: todavía hay excepciones que permiten reintentar. Desde v2.1.284, un error de servidor o sobrecarga en ese punto admite hasta dos reintentos. Las conexiones cortadas y las respuestas estancadas tienen sus propias reglas.
• Tras completar texto o una llamada a herramienta, o empezar uno de esos bloques después del razonamiento: Code evita reenviar la solicitud entera. Conserva lo completado, ejecuta las llamadas terminadas y puede continuar desde sus resultados.

Por tanto, ver actividad de razonamiento no implica por sí solo que una herramienta haya actuado. Tampoco ver un error al final permite asumir que ninguna actuó.

En una sesión interactiva con el aviso de respuesta incompleta, lee los bloques que quedan: se conserva cada bloque completado y se descarta el último bloque interrumpido. La documentación indica responder continue para retomar desde el último bloque completo. Si la tarea podía modificar archivos o sistemas externos, acompaña esa continuación con la comprobación de estado que se detalla abajo.

En modo no interactivo, la respuesta principal que contiene texto pero ninguna llamada a herramienta puede continuar automáticamente hasta tres veces antes del aviso. Ese comportamiento está documentado desde v2.1.246; no presupongas que un script necesita otro envío manual inmediato. Consulta la explicación de respuestas incompletas.

Cómo reanudar la conversación correcta

Si Code responde y la conversación afectada sigue abierta, conserva esa sesión. No necesitas empezar otra para esperar a que vuelva el servicio. Puedes usar /resume dentro de Code si necesitas seleccionar otra conversación guardada; comprueba que corresponde al trabajo interrumpido.

Si cerraste el proceso, vuelve a la carpeta del proyecto y abre el selector desde tu terminal:

claude --resume

Elige por el contenido del trabajo, no solo por la fecha. Antes de pedir cambios, comprueba que aparecen la petición original y los últimos resultados de herramientas que recuerdas. Si tienes el identificador exacto, sustituye ID-DE-LA-SESION por él:

claude --resume ID-DE-LA-SESION

La referencia actual de recuperación indica que, desde v2.1.223, la búsqueda por ID empieza en el proyecto actual y sigue por los demás proyectos de esa máquina. El selector permite ampliar la búsqueda con Ctrl+A. En versiones anteriores, la búsqueda por ID se limitaba al proyecto y sus worktrees. Los historiales son locales: cambiar de ordenador no traslada la conversación.

Las sesiones creadas con claude -p o Agent SDK no aparecen en el selector interactivo. Para ellas, busca el session_id en la salida JSON del trabajo original; no concluyas que el historial se perdió solo porque no aparezca en la lista.

Si Code se ha quedado colgado

Para un proceso que no responde, la ayuda oficial en español propone intentar cancelar con Ctrl+C y, si tampoco responde, cerrar la terminal y reiniciar para reanudar con claude --resume. Ese procedimiento corresponde a un cuelgue. Un error API 500 o 529 no obliga por sí solo a reiniciar ni prueba un problema de CPU o memoria.

Antes de cerrar, comprueba si hay comandos o tareas en segundo plano que debas dejar terminar o detener de forma deliberada. Reiniciar Code no demuestra que una operación remota se haya cancelado.

Si la conversación ya está abierta en otra terminal

Vuelve al proceso que la tiene abierta, o ciérralo conscientemente antes de recuperarla desde otro lugar. La vista de agentes actual rechaza abrir una conversación que ya pertenece a un proceso vivo; desde v2.1.248 esa protección incluye sesiones abiertas en una terminal. No uses la misma conversación en dos procesos para probar si «uno funciona»: puedes mezclar el historial. Esta condición está descrita en los errores de sesiones en otra terminal.

Comprueba archivos, herramientas, tareas y operaciones externas

La conversación te ayuda a localizar las acciones, pero sus resultados deben coincidir con el estado actual. Una llamada completa puede haber sido ejecutada antes de que se cortara el texto final; una llamada interrumpida puede faltar en la salida. Cuando el resultado no esté claro, marca el paso como no confirmado, en lugar de repetirlo para averiguar qué pasó.

En un repositorio Git, puedes empezar con estos comandos de consulta desde la carpeta correcta:

git status --short
git diff --stat
git diff
git diff --cached
git log -1 --oneline

git diff muestra los cambios sin preparar; git diff --cached, los preparados. Revisa también el contenido de los archivos nuevos que enumera git status, porque su contenido no aparece en esas diferencias. No atribuyas automáticamente cada cambio a Claude: puede haber trabajo previo o de otra persona.

Si hubo efectos externos, consulta el sistema correspondiente con tus permisos habituales. Por ejemplo, localiza el despliegue por su ID y comprueba si quedó pendiente, falló o terminó. La comprobación local de Git no responde esa pregunta. Esta tabla es una pauta práctica de recuperación basada en la conservación de llamadas completas de Code, no una prueba de que todos los servicios ejecuten o cancelen operaciones del mismo modo.

Da una continuación que incluya lo hecho y lo pendiente

Primero puedes pedir una inspección sin cambios en la sesión recuperada:

Retoma el turno interrumpido. Lee los resultados de herramientas conservados y
comprueba el estado actual de los archivos y las tareas. Enumera los pasos
completados, pendientes y no confirmados. No repitas comandos ni hagas cambios
externos durante esta comprobación.

Después añade los resultados que hayas comprobado fuera de Code y autoriza el siguiente paso concreto. Por ejemplo, si el cambio de código y el despliegue ya están hechos, pero falta una comprobación, adapta esta instrucción al caso real:

El cambio de código ya está presente y el despliegue existente figura como
completado en la plataforma. No vuelvas a editar ni a desplegar. Continúa solo
con la comprobación pendiente del resultado y registra su salida. Si detectas
que hace falta otro cambio, explica cuál antes de ejecutarlo.

La recuperación queda encaminada cuando el siguiente paso parte del estado comprobado y produce un resultado identificable. Una respuesta que diga «continuando» no confirma por sí sola que se hayan validado archivos, tareas o despliegues.

Si la sesión no se puede recuperar

Actúa según el mensaje concreto, siguiendo la referencia de fallos al reanudar:

• Failed to resume the conversation: prueba claude --resume con el ID que muestra el error. Si usas una versión anterior a v2.1.285 y falla igual, la documentación recomienda actualizar Code con claude update y reanudar de nuevo, porque esas versiones no podían leer algunas entradas del historial. Un fallo desde la CLI termina con código 1; si ocurre en /resume dentro de Code, la sesión que tenías abierta sigue en ejecución.
• No conversation found with session ID: revisa el ID, la máquina donde se ejecutó y si el historial sigue guardado. La retención predeterminada es de 30 días; también pueden interferir copias duplicadas del mismo historial. No presupongas que una caída 500 borró la conversación.
• This session has no saved transcript en una tarea de segundo plano: si se detuvo antes de completar su primera respuesta, la conversación de la que se separó puede seguir intacta. Recupera esa conversación. Reiniciar la tarea detenida con una conversación vacía empieza de nuevo; no recupera lo que hizo.

Si tras los pasos aplicables no puedes reanudar, abre una sesión nueva con un resumen del estado comprobado: objetivo, archivos modificados, comandos terminados o activos, operaciones externas e IDs, y pasos pendientes. Pide primero contrastar ese resumen. La nueva conversación no restaura el historial perdido ni justifica repetir toda la tarea.

API Error 500 en cada turno de una conversación reanudada

Hay un caso intermedio: la conversación se reanuda, pero cada mensaje devuelve 500, también después de esperar y con el estado en verde, mientras una sesión nueva en el mismo proyecto responde con normalidad. La documentación oficial no describe este caso para el 500. Lo que hay son informes de usuarios en GitHub:

• #58827 (mayo de 2026, v2.1.50, macOS): las sesiones antiguas no se reanudaban y devolvían API Error: 500 status code (no body), mientras que los chats nuevos funcionaban. Su autor lo atribuyó a contenido guardado en el historial que la API rechazaba al reenviarlo, como bloques de razonamiento vacíos y un resultado de herramienta vacío. Se cerró como duplicado de #41992, donde un bloque de texto vacío hacía fallar cada --resume, en ese caso con un 400, y el autor acabó abandonando la sesión.
• #70650 (junio de 2026, v2.1.178, macOS): una sesión de varios días devolvía 500 api_error Internal server error en cada intento, también después de /rewind; otra sesión abierta en una pestaña nueva funcionaba.

Anthropic no confirmó esas causas, y las versiones son antiguas. Para varios errores 400, en cambio, la referencia de errores sí documenta el patrón: contenido arrastrado en el historial guardado hacía fallar todos los turnos de una sesión reanudada en versiones anteriores. La pauta oficial es actualizar, reanudar y, si persiste, empezar con /clear una conversación que no arrastre ese contenido. La misma referencia añade una prueba de control: si el error vuelve también en la conversación nueva, la causa está en la ruta de la petición y no en la conversación guardada. Esa frase está escrita para esos 400; con un 500 sirve como lógica de diagnóstico, no como explicación oficial de su causa.

1. Haz la prueba de control. Abre una sesión nueva con claude en el mismo proyecto y envía una petición breve que no modifique nada. Si también falla, el problema no es esa conversación: vuelve al estado del servicio, a la pasarela o el proveedor que nombra el mensaje y, si no hay incidencia publicada, a /feedback.
2. Si la sesión nueva funciona, actualiza y reanuda. Ejecuta claude update y vuelve a abrir la conversación con claude --resume y su ID. Es el mismo paso que la documentación indica para los fallos al reanudar en versiones antiguas.
3. Si sigue fallando, no fuerces la conversación. No borres ~/.claude, no edites a mano los archivos JSONL de las conversaciones y no uses herramientas de terceros que prometan «reparar» sesiones. Tampoco cuentes con /rewind: en el informe #70650 no lo resolvió.
4. Pasa a la sesión nueva con un traspaso verificado. Antes, comprueba archivos, tareas y operaciones externas como en la tabla de comprobaciones de arriba. Después entrega a la sesión nueva el objetivo, lo ya hecho, lo no confirmado y lo pendiente, con la petición de inspección sin cambios como primer paso. No le pegues la instrucción original para que la ejecute otra vez: repetiría ediciones, comandos o despliegues que quizá ya terminaron.

Al informar con /feedback, indica que una sesión nueva funciona y la reanudada no. Ese contraste es lo que distingue este caso de una caída general.

Usa /rewind solo para un cambio que quieras deshacer

Reanudar una conversación, continuar un turno y restaurar código son acciones distintas. Un error de servidor no exige /rewind. Úsalo cuando hayas identificado un cambio de código que quieras revertir y comprueba el resultado de la restauración.

Los avisos actuales de restauración indican que Code puede omitir rutas enlazadas, archivos que dejaron de ser normales, directorios cambiados o copias de seguridad que no puede leer con seguridad. Restored the code, but skipped N files deja los archivos omitidos con su contenido actual. No files were restored significa que no restauró ninguno.

Las copias también pueden haber caducado: por defecto se eliminan aproximadamente 30 días después de la última copia guardada de la sesión. Que /rewind liste un punto no garantiza que aún pueda restaurarlo. Comprueba los archivos y las diferencias de Git después de usarlo.

No tomes una restauración de código como prueba de que se deshicieron comandos, procesos o cambios externos. Un despliegue, una escritura en una base de datos o un mensaje requiere su propia comprobación y, cuando proceda, su procedimiento de reversión.

Si el bloqueo es de uso, espera la ventana correcta

Un 529 documentado por Code corresponde a sobrecarga y no consume tu cuota. El aviso Server is temporarily limiting requests tampoco significa que hayas agotado el plan. Comprar más uso no es el primer paso para esos mensajes. Para esperar o cambiar de modelo ante una sobrecarga, consulta Error 529 en Claude Code: qué hacer cuando la API se sobrecarga.

Los límites de sesión y semanales se comparten entre modelos: cambiar con /model no devuelve acceso cuando se agotó esa ventana. Un límite específico de Opus o Sonnet sí permite usar un modelo disponible fuera de esa familia. Consulta la hora indicada y /usage; para un límite confirmado, sigue cómo resolver «Rate limit reached» y retomar el trabajo. Las condiciones están en la referencia de límites de uso de Code.

En la CLI interactiva con suscripción, Code puede esperar al reinicio y continuar la tarea desde v2.1.234. Si elegiste esa continuación automática, comprueba si ya se reanudó antes de mandar otro mensaje. El ajuste de la CLI y la casilla de continuación automática de Desktop son independientes.

Un 429 con acceso API también puede señalar un tope de gasto. En la API directa, el tope mensual impuesto por el nivel de uso no incluye retry-after y sigue bloqueando hasta que se restablece el acceso, según la referencia de errores de la API. No encadenes reintentos para ese caso. Usa /status para comprobar la credencial y el proveedor efectivos sin publicar claves. Si el problema es consumo elevado, la auditoría de tokens, contexto y caché responde a esa tarea específica.

Cuándo parar y pedir ayuda

Si una prueba segura vuelve a fallar tras la espera y las comprobaciones, guarda el mensaje completo, la versión de Code, el modelo, el proveedor, la hora con zona horaria y el ID de solicitud si aparece. Añade si hubo salida parcial, qué trabajo comprobaste y cuál fue el resultado al reanudar. Si el fallo es al iniciar sesión, indica si la misma cuenta entra desde otro equipo; si es una conversación reanudada, si una sesión nueva funciona. Oculta credenciales y contenido privado.

Para un 500 persistente sin una incidencia publicada, Code recomienda /feedback; si no está disponible en tu entorno, utiliza la opción de informar del error descrita en su documentación. Si una operación externa sigue sin estado confirmado, resuelve esa incertidumbre en su plataforma antes de repetirla.

Preguntas frecuentes

¿El API Error 500 de Claude Code significa que el servicio está caído hoy?

No necesariamente. Indica un fallo interno de la API que respondió, normalmente temporal. Consulta Claude Status y su historial: si hay una incidencia abierta, espera a que se cierre. Un estado en verde no garantiza que tu petición vaya a funcionar; si el 500 persiste sin incidencia publicada, informa con /feedback. Si solo falla una conversación reanudada y las nuevas responden, sigue los pasos para el 500 en cada turno de una conversación reanudada.

¿Reinstalo Claude Code si el API Error 500 aparece al iniciar sesión?

Reinstalar no figura entre los pasos documentados para un 500 ni para un fallo de acceso. Primero mira el estado y espera; después ejecuta /logout, cierra Claude Code, vuelve a lanzar claude e inicia sesión. En WSL2, SSH o contenedores, pega el código que muestra el navegador o usa claude auth login.

¿Tengo que pagar otro plan para resolver un 529?

No es la solución documentada para la sobrecarga. Code distingue el 529 de tu cuota de uso: espera unos minutos o elige otro modelo disponible con /model, según la referencia de errores de servidor. Un límite de sesión o semanal requiere esperar su renovación o evaluar por separado las opciones de uso de tu cuenta.

¿Puedo escribir continue si quedó una respuesta incompleta?

Sí, en una sesión interactiva es la acción documentada para seguir desde el último bloque completo. Si había herramientas o cambios externos, comprueba sus resultados y limita la continuación a lo pendiente. Code conserva bloques terminados y evita repetir la solicitud entera; consulta la explicación del aviso de respuesta incompleta.

¿Una sesión nueva recupera el trabajo de la anterior?

No recupera automáticamente su conversación. Los archivos y las operaciones externas pueden seguir existiendo aunque falle la reanudación. Intenta primero recuperar el ID correcto; si no es posible, entrega a la nueva sesión el estado comprobado y lo pendiente. Empezar de nuevo la conversación no significa empezar de nuevo el trabajo.