Saltar al contenido principal
Texto exacto del error

Mensajes de error de Claude Code: texto exacto, dónde está la causa y cómo corregirlo

Escribe o pega el mensaje que ves para filtrar la lista. Cada entrada indica si la causa está en tu equipo, en tu cuenta, en el servicio o en una pasarela intermedia, y enlaza con la solución completa.
  • 60 mensajes
  • 14 guías de solución
  • Revisado el 15 de noviembre de 2026

Inicio de sesión, cuenta y verificación

  • Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh

    También en esta guía

    • Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh)
      • Causa: tu equipo o configuración
      • CLI
    • EPERM: operation not permitted, mkdir

    Tu sesión no fue rechazada: otro proceso de Claude Code tiene, o dejó, el bloqueo de renovación. Espera un minuto, cierra ese proceso o borra la carpeta vacía.

  • Failed to authenticate. API Error: 403 Your account can't receive replies from Claude right now

    • Causa: cuenta o plan
    • CLI
    • HTTP 403

    También en esta guía

    • Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
      • Causa: cuenta o plan
      • CLI
    • Replies from Claude are unavailable on your account. You can complete the verification now in the Anthropic Verification Portal
      • Causa: cuenta o plan
      • Web
    • Complete verification to continue
      • Causa: cuenta o plan
      • App de escritorio

    Es una verificación de identidad de Anthropic, no un fallo de Claude Code: reintentar o /login no la quita. Cuándo verificarte, cómo y qué pasa después.

Modelo no encontrado o no disponible

  • There's an issue with the selected model (claude-fable-5.2)

    • Causa: varias posibles
    • CLI

    También en esta guía

    • You've reached your Fable limit.
      • Causa: cuenta o plan
      • CLI
    • Fable 5.2's safeguards flagged this message
    • Claude Code doesn't recognize the model "claude-fable-5-2", so it assumes a context window of 200k tokens
      • Causa: tu equipo o configuración
      • CLI
      • App de escritorio
      • Issue #108785
    • Fable is experiencing high load, please use /model to switch to Sonnet
      • Causa: el servicio
      • CLI
    • Invalid signature in thinking block. The block is bound to a different conversation.
      • Causa: tu equipo o configuración
      • API
      • HTTP 400

    Si Fable 5.2 falla, actualiza Claude Code a 2.1.321 o más, escribe /model claude-fable-5-2 con guiones y, en la API, no edites el historial ya enviado.

Límites de uso y capacidad

  • API Error: Rate limit reached

    • Causa: varias posibles
    • CLI
    • HTTP 429

    También en esta guía

    • You've hit your session limit · resets 3:45pm
      • Causa: cuenta o plan
      • CLI
    • You've hit your weekly limit · resets Mon 12:00am
      • Causa: cuenta o plan
      • CLI
    • API Error: Server is temporarily limiting requests (not your usage limit)
      • Causa: el servicio
      • CLI
    • API Error: Request rejected (429) · this may be a temporary capacity issue
      • Causa: cuenta o plan
      • CLI
      • HTTP 429
    • API Error: Usage credits required for 1M context
      • Causa: cuenta o plan
      • CLI

    Si Claude Code se detiene con «Rate limit reached», guarda el estado de la tarea y comprueba qué límite indica el mensaje: cuota, servidor, API o contexto 1M.

  • API Error: Repeated 529 Overloaded errors

    • Causa: el servicio
    • CLI
    • HTTP 529

    También en esta guía

    • Opus is experiencing high load, please use /model to switch to Sonnet
      • Causa: el servicio
      • CLI
    • Opus is experiencing high load. Switch to Sonnet.
      • Causa: el servicio
      • App de escritorio
    • API Error: Server error mid-response. The response above may be incomplete.
      • Causa: el servicio
      • CLI

    Cuando ves el 529, Claude Code ya ha reintentado hasta 10 veces y no te ha gastado cuota: cambia de modelo con /model, deja un fallbackModel o espera.

Errores del servidor y conexiones cortadas

  • Unable to connect to API

    • Causa: tu equipo o configuración
    • CLI

    También en esta guía

    • ECONNREFUSED
      • Causa: tu equipo o configuración
      • CLI
    • ECONNRESET
      • Causa: varias posibles
      • CLI
    • ETIMEDOUT
      • Causa: tu equipo o configuración
      • CLI
    • fetch failed
      • Causa: tu equipo o configuración
      • CLI

    Connection dropped (ECONNRESET) o Connection refused en Claude Code: no hubo respuesta HTTP; curl en la misma shell dice si falla la red o tu entorno.

  • API Error: 500 Internal server error

    • Causa: el servicio
    • HTTP 500

    También en esta guía

    • OAuth error: Request failed with status code 500
    • API Error: 500 status code (no body)
    • No conversation found with session ID
      • Causa: tu equipo o configuración

    Un API Error 500 de Claude Code es un fallo del servidor: mira el estado, espera y reanuda la conversación correcta comprobando lo ya hecho antes de seguir.

  • API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}

    • Causa: varias posibles
    • HTTP 403

    También en esta guía

    • App unavailable in region
      • Causa: varias posibles
    • No available accounts
      • Causa: pasarela o proxy
      • HTTP 503
    • No available channel for model X under group Y
    • API Error: 503 Bedrock is unable to process your request

    El mismo código puede venir de tu proxy, tu cuenta, Anthropic o un intermediario; el texto del error y la línea base URL de /status dicen a quién le toca.

Solicitud rechazada

App, IDE y arranque

Archivos, sesiones y estado local

  • Error compacting conversation

    • Causa: varias posibles
    • CLI
    • App de escritorio

    También en esta guía

    • Conversation too long. Press esc twice to go up a few messages and try again.
      • Causa: tu equipo o configuración
      • CLI
      • App de escritorio
      • Issue #7530
    • Prompt is too long · automatic compaction failed:
      • Causa: varias posibles
      • CLI
      • App de escritorio
    • Autocompact is thrashing: the context refilled to the limit within 3 turns of the previous compact, 3 times in a row.
      • Causa: tu equipo o configuración
      • CLI
      • App de escritorio
      • Desde 2.1.89
    • Compaction failed · attached media exceeds size limits
      • Causa: tu equipo o configuración
      • CLI
      • App de escritorio
    • Compaction failed · conversation could not be reduced below the context limit
      • Causa: tu equipo o configuración
      • CLI
      • App de escritorio

    «Error compacting conversation» en Claude Code solo avisa de que la compactación falló; la causa está en la línea de al lado, y de ella depende la salida.

  • Error writing file

    También en esta guía

    • File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.
    • EPERM: operation not permitted
      • Causa: tu equipo o configuración
    • InputValidationError: Write failed due to the following issues: The required parameter `file_path` is missing
    • Error editing file

    «Error writing file» en Claude Code es solo una etiqueta: con Ctrl+O ves el mensaje real (EACCES, modified since read, content is missing) y su arreglo.

Cómo se mantiene esta lista

  • Solo se incluye un mensaje cuando una guía de este sitio lo trata, y el texto se copia carácter por carácter de esa guía.
  • Las versiones, los estados HTTP y los números de issue de GitHub son los que cita la guía enlazada. Si la guía no da ninguno, el campo queda vacío.
  • La etiqueta de causa indica por dónde empezar. La guía explica cómo confirmarlo.

Lista revisada por última vez el 15 de noviembre de 2026.