Errores de Claude Code: guía esencial para 400, 403, 429 y 529

Los errores de Claude Code siempre aparecen en el peor momento, y el mensaje suele ser media frase. Esta página es mi tabla de consulta. Revisé cada entrada el 21 de octubre de 2026 contra la referencia oficial de errores y la página de problemas de instalación de Anthropic; cuando algo no está en la documentación oficial, lo digo en vez de inventar.

Cada uno de estos errores de Claude Code lleva un número: I es instalación, A es inicio de sesión, U es uso. Los de instalación viven en la guía de instalación; los de inicio de sesión y uso están aquí abajo. Busca tu mensaje en la tabla, pulsa el número y listo.

Tabla rápida de errores de Claude Code

Mensaje que ves	Ir a	Etapa
command not found: claude	I1	instalación
EACCES: permission denied	I3	instalación
npm WARN EBADENGINE	I4	instalación
curl: (22) ... 403 / App unavailable in region	I8	instalación
OAuth error: Invalid code	A1	sesión
API Error: 403 Request not allowed	A2	sesión
OAuth error: Request failed with status code 403	A2	sesión
Your organization has disabled Claude subscription access	A2	sesión
Paste code here if prompted (atascado)	A3	sesión
Not logged in · Please run /login	A4	sesión
Repeated 529 Overloaded errors	U1	uso
Request rejected (429)	U2	uso
You've hit your session limit	U3	uso
You've hit your weekly limit	U3	uso
Usage credits required for 1M context	U4	uso
This organization has been disabled	U5	uso
Credit balance is too low / Invalid API key	U6	uso
thinking.type.enabled is not supported	U7	uso
thinking type should be enabled or disabled	U7	uso
Error editing file / Error writing file	U8	uso
Error loading webview	U9	uso
¿Claude Code está caído hoy?	U10	uso
Your account is on hold	U11	uso

Mira esto primero: ¿qué credencial está usando Claude Code?

Te lo digo claro: de los errores de Claude Code con los que he ayudado a otros, como un tercio venían de lo mismo. Claude Code usa la primera credencial que encuentra, en este orden: configuración de un proveedor cloud, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, un script apiKeyHelper, CLAUDE_CODE_OAUTH_TOKEN y, al final, tu suscripción de /login (orden oficial). Así que una API key vieja en ~/.zshrc o en el .env de un proyecto le gana en silencio al plan Pro que estás pagando. En modo -p la key se usa siempre.

Escribe /status. Si aparece una fila de API key que no esperabas, probablemente ahí está tu 400, tu 401, tu 429 o el mensaje de saldo. Arreglarlo lleva diez segundos y se lleva por delante varios errores de Claude Code de golpe.

Errores al iniciar sesión: A1 a A4

A1. Falla el inicio de sesión: el reinicio general

Para casi todos los errores de Claude Code al entrar, el reinicio oficial es aburrido y funciona: /logout, cierra Claude Code, vuelve a lanzar claude e inicia sesión. OAuth error: Invalid code. Please make sure the full code was copied significa que el código caducó o se copió a medias, así que termina rápido cuando se abra el navegador. Failed to start OAuth callback server indica que Claude Code no puede escuchar en 127.0.0.1 (pasa en sandboxes); la documentación propone ejecutar claude setup-token en un equipo donde el login funcione y poner el resultado en CLAUDE_CODE_OAUTH_TOKEN (fuente).

A2. API Error: 403 Request not allowed / OAuth 403

La lista oficial para un 403 después de entrar: en Pro o Max, abre claude.ai/settings y confirma que la suscripción está activa de verdad (Free no incluye Claude Code). En una cuenta de Console necesitas el rol «Claude Code» o «Developer», que asigna un administrador (fuente).

Un primo de este: Your organization has disabled Claude subscription access for Claude Code. Es un ajuste de la organización en el servidor y nada local lo anula; pide a tu administrador que lo active o usa una API key de Console (fuente).

A3. Login atascado en WSL2, SSH o un contenedor

El navegador se abre en un sitio al que no llega la respuesta. La página muestra un código: pégalo en Paste code here if prompted. Si pegar no funciona, usa claude auth login. En WSL2, si no se abre ningún navegador, define BROWSER con la ruta de tu navegador de Windows y reintenta (fuente).

A4. Not logged in · Please run /login (una y otra vez)

Ejecuta /login. Si se repite, revisa que el reloj del sistema esté bien. En macOS, un Llavero bloqueado es causa conocida; claude doctor avisará con macOS Keychain is not writable. Además, antes de la v2.1.211 había un fallo por el que al despertar el equipo se cerraban todas las sesiones; si vas atrasado, actualiza (fuente).

Errores durante el uso: U1 a U11

U1. 529 Overloaded (y 500)

API Error: Repeated 529 Overloaded errors quiere decir que la API está a tope. No es tu cuota, y Anthropic dice que no cuenta para tus límites. Claude Code ya reintentó antes de enseñártelo. Espera unos minutos, mira status.claude.com o cambia de modelo con /model, porque la capacidad va por modelo. Un 500 Internal server error también es cosa suya (fuente).

U2. 429 Request rejected

Significado oficial: llegaste al límite de velocidad de una API key, un proyecto de Bedrock o uno de Google Cloud. Es el camino de pago por tokens, no tu suscripción. Por eso, primero /status: una ANTHROPIC_API_KEY olvidada puede mandarte por una key de nivel bajo. Si no es eso, baja la concurrencia o pide un nivel mayor. El parecido Server is temporarily limiting requests (not your usage limit) es un freno breve del servidor, y desde la v2.1.199 se reintenta solo (fuente).

U3. You’ve hit your session limit / weekly limit

Esto sí es la cuota de tu plan. Los mensajes son del tipo You've hit your session limit · resets 3:45pm o You've hit your weekly limit · resets Mon 12:00am. Los límites de sesión y semanal se comparten entre modelos, así que cambiar de modelo no sirve; los límites propios de Opus o Sonnet son la excepción. /usage te dice cuándo se reinicia, /usage-credits compra uso extra en Pro o Max, y desde la v2.1.234 Claude Code puede esperar y seguir solo tras el reinicio (se configura en /config) (fuente). Cómo encajan los dos relojes lo explico en la cuota de Claude.

Si buscaste «claude code usage limit bug»: hay un hilo enorme y abierto en GitHub, #16157, donde usuarios de Max cuentan que el límite se vacía rarísimo de rápido. Tenía 1.499 comentarios cuando lo miré. No encontré una explicación oficial de Anthropic, así que no voy a fingir que sé la causa.

U4. Usage credits required for 1M context

No es falta de cuota. Elegiste un modelo [1m] y tu plan solo da contexto de 1M con créditos de uso. /model y elige la variante sin [1m], o activa los créditos y reinicia. CLAUDE_CODE_DISABLE_1M_CONTEXT=1 esconde esas variantes (fuente).

U5. 400 This organization has been disabled

Suena fatal y casi nunca lo es. Según la documentación, Claude Code está usando una ANTHROPIC_API_KEY antigua de una organización de Console desactivada, a menudo la key de un trabajo anterior en tu perfil de shell. No es que hayan suspendido tu suscripción. Ejecuta unset ANTHROPIC_API_KEY (PowerShell: Remove-Item Env:ANTHROPIC_API_KEY), bórrala del perfil, vuelve a abrir y revisa /status. ¿Sin variable y sigue pasando? Contacta con soporte (fuente). La diferencia con una suspensión real la cuento en mis notas sobre cuentas de Claude suspendidas.

U6. Credit balance is too low / Invalid API key / 401

Credit balance is too low: tu organización de Console se quedó sin saldo prepago, o (otra vez) una API key se impone a tu suscripción. Invalid API key: errata, key revocada o caracteres invisibles; env | grep ANTHROPIC encuentra keys cargadas por direnv o .env. 401 Invalid authentication credentials: mira /status y luego /login una vez (fuente).

U7. Errores 400 sobre thinking

"thinking.type.enabled" is not supported for this model significa que tu Claude Code es más viejo de lo que pide el modelo. claude update y reinicia. Mínimos oficiales: Opus 4.7 pide v2.1.111, Opus 4.8 v2.1.154, Sonnet 5 v2.1.197, Opus 5 v2.1.219, Opus 5.5 v2.1.280, Sonnet 5.5 v2.1.284. En el canal estable quizá tengas que pasar a latest (fuente).

API Error: 400 thinking type should be enabled or disabled es otra historia. Ese texto no aparece en la referencia de errores de Anthropic. Por lo que he podido ver, sale de un endpoint que no es de Anthropic, cuando ANTHROPIC_BASE_URL apunta a una API «compatible» de terceros que no acepta la configuración de thinking de Claude Code. Ejecuta echo $ANTHROPIC_BASE_URL. Con la API de Anthropic o una suscripción no deberías verlo. Los endpoints de terceros no los cubro aquí.

400 due to tool use concurrency issues indica que el historial se corrompió; /rewind, como sugiere el mensaje (fuente).

U8. Error editing file / Error writing file

En el chat solo ves el corto Error editing file; el motivo real está en la vista de transcripción (Ctrl+O), y Claude suele reintentar por su cuenta. Uno típico es Found 2 matches of the string to replace: el texto no era único (#3337). «Error writing file» no tiene entrada en la referencia oficial, así que no puedo darte un significado oficial; mira el mensaje de fondo en la transcripción.

U9. VS Code: Error loading webview

Tampoco hay entrada oficial. Lo que sí dice la documentación: la extensión necesita VS Code 1.94.0 o posterior. El reporte típico se parece a #24142 (un service worker que no se registra; ya cerrado). Actualiza VS Code y la extensión y recarga la ventana. Más allá de eso son conjeturas de la comunidad, y prefiero no venderlas como solución.

U10. ¿Está caído Claude Code hoy?

Mira status.claude.com (el antiguo status.anthropic.com redirige ahí). Cuando lo revisé el 21 de octubre ponía All Systems Operational; el último incidente grave listado era del 7 de octubre. Si la página está en verde y solo tú ves errores de Claude Code, vuelve a /status.

U11. Your account is on hold

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted. Volver a entrar no lo arregla, porque la retención está en la cuenta. La única vía que te indico es la oficial: abre ese enlace, lee los detalles y apela según la página de avisos y apelaciones de Anthropic. ¿Reembolso tras una suspensión? No encontré una política oficial específica, solo las condiciones generales. Más en qué hacer si suspenden tu cuenta de Claude.

Los errores de instalación están en la guía de instalación

Los errores de Claude Code que aparecen antes del primer inicio de sesión (PATH, permisos, avisos de Node, WSL, la terminal equivocada en Windows, un 403 del script) están en la guía para instalar Claude Code, del I1 al I9. Puedes saltar directo a I1 command not found o a I8 script con 403.

Preguntas frecuentes sobre errores de Claude Code

¿Qué significa el error 400 de Claude Code? Depende del texto que sigue. «organization has been disabled» es una API key vieja (U5), «thinking.type.enabled» es una versión antigua (U7) y «thinking type should be enabled or disabled» es un endpoint de terceros (U7).

¿Y el 403? Al iniciar sesión, plan inactivo o falta de rol (A2). Al instalar, la URL del script devolvió una página (I8).

¿429 o 529? 429 es el límite de una API key o proyecto cloud (U2). 529 es capacidad de Anthropic, no tu cuota (U1).

Llegué al límite de uso, ¿cuándo se reinicia? El propio mensaje lo dice, y /usage muestra las dos ventanas. Los cambios en los límites los apunto en el seguimiento de límites.

¿Puedo traer mi configuración de Codex a Claude Code? Sí, oficialmente con /import codex (referencia de comandos); --dry-run lo previsualiza. Hay quien menciona claude mcp serve; no lo encontré en la documentación actual de Anthropic, así que no lo tomes como algo con soporte oficial.

Sigue leyendo: cómo instalar Claude Code · seguimiento de límites de Claude y Codex · comparativa de precios de suscripciones de IA · categoría Claude