Claude Code no inicia sesión / falla la autenticación (Invalid API key / Please run /login / OAuth): causas y soluciones

¿Hay una caída ahora mismo?

El estado oficial de Claude Code es operativo. Si este error persiste, probablemente sea un problema de implementación o de tu entorno.

Actualizado: 6 jun 2026, 4:47 UTC

Ver el estado de Claude Code

Qué significa este error

Claude Code no consigue iniciar sesión ni autenticarse. Las causas habituales son un callback de inicio de sesión OAuth que agota el tiempo de espera, un llavero (keychain) de macOS bloqueado que no puede guardar el token, una discrepancia entre tu clave de API y la base URL, o problemas de DNS/red. «Invalid API key · Please run /login» indica una clave incorrecta o un token caducado.

Causas comunes

  • El callback de inicio de sesión OAuth agotó el tiempo de espera
  • El llavero (keychain) de macOS está bloqueado y no puede guardar el token de autenticación
  • La clave de API (sk-ant-…) y la base URL (oficial o proxy) no coinciden
  • Intentaste OAuth en un entorno sin navegador (SSH/CI/Docker)
  • El DNS/proxy/cortafuegos bloquea el servidor de autenticación
  • Versión desactualizada o caché dañada

Cómo solucionarlo

  1. 1.Ejecuta /logout para borrar por completo el token antiguo y luego vuelve a hacer /login
  2. 2.Actualiza Claude Code, elimina ~/.claude/cache y vuelve a intentarlo
  3. 3.En entornos sin navegador (SSH/CI/Docker), define la variable de entorno ANTHROPIC_API_KEY en lugar de usar OAuth
  4. 4.Asegúrate de que tu clave de API y tu base URL provengan de la misma plataforma (clave oficial → base URL oficial)
  5. 5.Ejecuta /doctor para revisar de una vez los problemas de configuración, autenticación y actualización
  6. 6.En macOS, desbloquea el llavero; verifica la configuración de red/proxy

Cuándo conviene esperar (y cuándo no)

Es un problema de autenticación/configuración y no se solucionará solo con esperar. Repite /logout y luego /login, actualiza y borra la caché, o define ANTHROPIC_API_KEY en entornos sin navegador. Ejecutar /doctor primero es la forma más rápida de aislar la causa.

Alternativas cuando Claude Code está caído

CodexCursorGitHub CopilotClineWindsurfContinue

Errores relacionados

Preguntas frecuentes

¿Qué es Login / authentication failed?

Claude Code no consigue iniciar sesión ni autenticarse. Las causas habituales son un callback de inicio de sesión OAuth que agota el tiempo de espera, un llavero (keychain) de macOS bloqueado que no puede guardar el token, una discrepancia entre tu clave de API y la base URL, o problemas de DNS/red. «Invalid API key · Please run /login» indica una clave incorrecta o un token caducado.

¿Cómo soluciono Login / authentication failed?

Ejecuta /logout para borrar por completo el token antiguo y luego vuelve a hacer /login / Actualiza Claude Code, elimina ~/.claude/cache y vuelve a intentarlo / En entornos sin navegador (SSH/CI/Docker), define la variable de entorno ANTHROPIC_API_KEY en lugar de usar OAuth / Asegúrate de que tu clave de API y tu base URL provengan de la misma plataforma (clave oficial → base URL oficial) / Ejecuta /doctor para revisar de una vez los problemas de configuración, autenticación y actualización / En macOS, desbloquea el llavero; verifica la configuración de red/proxy

Compara Claude Code con otras