Referencia de errores

​

Encuentra tu error

​

Reintentos automáticos

• Errores del servidor, respuestas de sobrecarga y tiempos de espera de solicitud agotados que llegan antes de que cualquier parte de la respuesta de Claude se haya enviado en streaming.
• Un error del servidor o una respuesta de sobrecarga que llega después de que Claude ha terminado de pensar pero antes de que haya comenzado cualquier texto o llamada a herramienta. Claude Code reintenta un error del servidor en ese punto hasta dos veces. Antes de v2.1.284, Claude Code terminaba el turno con el error en ese punto.
• Conexiones perdidas. Cuando una conexión se cae a mitad de una solicitud antes de que Claude haya completado cualquier parte de su respuesta, incluido su pensamiento, Claude Code reenvía la solicitud con el mismo retroceso y el turno continúa, incluso si algo de texto ya había comenzado a enviarse en streaming. Cuando se cae después de que Claude ha terminado de pensar pero antes de que haya comenzado cualquier texto o llamada a herramienta, Claude Code en su lugar reenvía la solicitud hasta dos veces en rápida sucesión, y termina el turno con Connection lost before a response was produced si la conexión sigue cayéndose en ese punto.
• Una conexión que Claude Code detecta que se rompió porque tu computadora entró en suspensión a mitad de una solicitud. Claude Code la cuenta como una conexión perdida según las reglas anteriores; una vez que la etiqueta de reintento nombra la razón específica, dice Connection lost while your computer was asleep, y si el turno termina después de que Claude ha terminado de pensar pero antes de cualquier texto o llamada a herramienta, el mensaje dice Your computer went to sleep before a response was produced.
• Un stream de respuesta estancado, cuando los encabezados de respuesta han llegado pero ninguna parte de la respuesta de Claude ha llegado, o cuando Claude ha terminado de pensar pero no ha comenzado ningún texto ni llamada a herramienta: Claude Code aborta la conexión estancada y vuelve a enviar la solicitud en streaming como máximo una vez. Si la respuesta se estanca una segunda vez después de que Claude ha terminado de pensar pero antes de cualquier texto o llamada a herramienta, Claude Code termina el turno con The response stalled before a response was produced.
• Una solicitud en streaming a la que la API nunca responde con encabezados de respuesta, en una conexión donde se aplica el plazo del primer byte: Claude Code la aborta al cumplirse el plazo y la reenvía como máximo una vez por solicitud al modelo, dentro del presupuesto de reintentos, y luego termina el turno con No response from API si ese intento también queda sin respuesta. En otras conexiones, la solicitud espera hasta API_TIMEOUT_MS. Cuando estableces CLAUDE_CODE_RETRY_WATCHDOG, el límite de un reintento no se aplica.
• Una respuesta en streaming que el filtro de contenido de salida de la API detiene antes de que Claude haya terminado de pensar o haya comenzado cualquier texto o llamada a herramienta. Claude Code reenvía la solicitud una vez, dentro del presupuesto de reintentos, y muestra Output blocked by content filtering policy si el filtro también detiene la segunda respuesta.
• Limitaciones temporales 429, pero no el 429 de límite de gasto de un gateway, que no es una limitación; consulta Spend limit reached.
  • Cuando has iniciado sesión con una suscripción de claude.ai, esto incluye limitaciones 429 que no llevan los encabezados de cuota de tu plan. Antes de v2.1.199, Claude Code reintentaba esas limitaciones solo para inicios de sesión con clave de API y Enterprise.
• Una solicitud rechazada porque la entrada más max_tokens excede el límite de contexto. Reenviarla sin cambios fallaría de la misma manera, por lo que Claude Code reintenta con un max_tokens reducido, y deja de reintentar y compacta en su lugar en dos casos:
  • Cuando ninguna reducción puede caber, por ejemplo cuando la conversación misma casi llena la ventana de contexto.
  • Cuando un reintento no puede reducir max_tokens más. Antes de v2.1.218, Claude Code podía reenviar una solicitud reducida que aún no cabía, como cuando el presupuesto de pensamiento extendido excedía el contexto restante, hasta que se agotaba el presupuesto de reintentos.
• Una credencial de Google Cloud expirada o faltante en Google Cloud’s Agent Platform, o credenciales de AWS que no se pueden cargar en tu máquina. Claude Code descarta sus credenciales en caché y reintenta hasta dos veces, luego reporta el error para que puedas volver a autenticarte de inmediato, como se describe en Could not load AWS or Google Cloud credentials. Antes de v2.1.228, Claude Code reintentaba una credencial de Google Cloud fallida durante todo el presupuesto de reintentos antes de mostrar el error.
• Un 401 o 403 de la API de Anthropic, directamente o a través de un gateway de LLM, mientras un script apiKeyHelper suministra la credencial. Claude Code vuelve a ejecutar el script y reintenta con su salida nueva, dentro de todo el presupuesto de reintentos. Cuando el script mismo falla en la nueva ejecución, Claude Code muestra Your apiKeyHelper script is failing en su lugar.

• Un fallo de validación de certificado TLS, como un proxy que inspecciona TLS, un paquete NODE_EXTRA_CA_CERTS faltante o un certificado expirado. Claude Code reporta el error en el primer intento, para que puedas corregir la configuración del certificado de inmediato; consulta SSL certificate errors. Claude Code sigue reintentando condiciones TLS transitorias, como un tiempo de espera agotado en el handshake. Antes de v2.1.199, Claude Code reintentaba los fallos de certificado durante todo el presupuesto de reintentos antes de mostrar el error.
• Un error del servidor, una conexión perdida o un stream estancado que llega después de que Claude ha completado un bloque de texto o una llamada a herramienta, o ha comenzado uno después de terminar su pensamiento, pero antes de que termine la respuesta. Claude Code no vuelve a ejecutar la solicitud, porque eso podría ejecutar las mismas llamadas a herramientas dos veces. Conserva lo que Claude completó, ejecuta las llamadas a herramientas que Claude terminó y continúa el turno a partir de sus resultados. Para saber lo que ves en una sesión interactiva y en una no interactiva, lee The response above may be incomplete. Antes de v2.1.199, Claude Code descartaba la salida parcial y reportaba todo el turno como un error cuando un error del servidor llegaba a mitad del streaming.
• Un fallo que llega después de que Claude ha terminado la respuesta: no hay nada que reintentar, por lo que Claude Code conserva la respuesta completa y termina el turno normalmente.
• Una respuesta en streaming de Amazon Bedrock con un content-type inesperado, porque el gateway o proxy que reescribe la respuesta reescribiría el reintento de la misma manera. Requiere Claude Code v2.1.208 o posterior.
• Un reintento sin streaming de una solicitud en streaming fallida que obtiene un estado de éxito pero ningún mensaje de la API de Claude en el cuerpo. Claude Code termina el turno con ese error.
• Una solicitud que la verificación de políticas de tu organización rechazó, que aparece como una línea API Error: con el mensaje de denegación. Los administradores de tu organización configuran la verificación con Inference hooks, una función de Claude Enterprise, y el mensaje termina con las instrucciones que configuraron o, de forma predeterminada, te indica que te comuniques con ellos. Claude Code no reenvía la solicitud denegada al mismo modelo ni a un modelo de respaldo, porque la denegación se refiere al contenido de la solicitud y no al modelo. Antes de v2.1.239, Claude Code podía reenviar una solicitud denegada, sin streaming o en un modelo de respaldo configurado, antes de mostrarte la denegación.

​

Lo que ves mientras Claude Code reintenta o espera

• Antes de que Claude haya completado un bloque de texto o una llamada a herramienta, o haya comenzado uno después de terminar su pensamiento, Claude Code reintenta la solicitud o termina el turno con un error. Reintentos automáticos indica qué estancamientos reintenta y cuántas veces.
• Después de que Claude ha completado un bloque de texto o una llamada a herramienta, o ha comenzado uno después de terminar su pensamiento, pero antes de que Claude haya terminado la respuesta, Claude Code conserva lo que Claude completó, continúa el turno a partir de las llamadas a herramientas que Claude terminó y muestra The response above may be incomplete. En una sesión no interactiva, y para la respuesta de un subagente en cualquier sesión, Claude Code puede primero pedirle a Claude que continúe la respuesta; esa entrada indica cuándo lo hace y cuándo sigues viendo el aviso allí.
• Después de que Claude terminó la respuesta, Claude Code termina el turno normalmente.

​

Ajustar el comportamiento de reintentos

​

Errores del servidor

​

API Error: 500 Internal server error

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.

• Consulta status.claude.com, o la página de estado del proveedor nombrada en el mensaje, para ver si hay incidentes activos
• Espera un minuto y luego envía tu mensaje de nuevo. Tu mensaje original sigue en la conversación, así que para un prompt largo puedes escribir try again en lugar de pegarlo completo.
• Si el error persiste sin ningún incidente publicado, ejecuta /feedback para que Anthropic pueda investigar con los detalles de tu solicitud. Consulta Informar un error si /feedback no está disponible en tu entorno.

​

API Error: Repeated 529 Overloaded errors

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

• Consulta status.claude.com, o la página de estado del proveedor nombrada en el mensaje, para ver si hay avisos de capacidad
• Vuelve a intentarlo en unos minutos
• Ejecuta /model y cambia a un modelo diferente para seguir trabajando, ya que la capacidad se controla por modelo. Claude Code te pide que hagas esto cuando un modelo está bajo una carga particularmente alta, por ejemplo Opus is experiencing high load, please use /model to switch to Sonnet. En los modelos Fable, el mensaje nombra Fable. En una sesión que ejecuta la aplicación Claude Desktop, como la pestaña Code o Cowork, el mensaje dice Opus is experiencing high load. Switch to Sonnet. y cambias de modelo con el selector de modelos de la aplicación.

​

Request timed out

Request timed out

• Reintenta la solicitud
• Si la causa es una red lenta o un proxy, aumenta API_TIMEOUT_MS como se describe en Reintentos automáticos
• Si se agota el tiempo de espera con frecuencia y tu red por lo demás funciona bien, consulta Errores de red y de conexión más abajo

​

No response from API

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

• Primer intento: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS cuando lo estableces en 1 o más, limitado a un valor entre 10 segundos y 30 minutos. De lo contrario, Claude Code usa el tiempo de espera del watchdog a nivel de bytes indicado en Watchdogs de inactividad del streaming, así que las variables que cambian ese tiempo de espera también cambian esta espera. En cualquier caso, Claude Code agrega un segundo por cada 32KB del cuerpo de la solicitud.
• Reintento: un segundo menos que API_TIMEOUT_MS, poco menos de 10 minutos por defecto, para que el reintento pueda durar más que un proxy o gateway que retiene la respuesta hasta que termina la generación. En Amazon Bedrock, el reintento usa el mismo plazo que el primer intento, y el mensaje muestra una duración en lugar de dos.

• Envía tu mensaje de nuevo. Tu mensaje original sigue en la conversación, así que para un prompt largo puedes escribir try again en lugar de pegarlo completo.
• Si se repite, trátalo como un problema de red o de proxy.
• Si un proxy o gateway de tu red retiene las respuestas hasta que se completan, aumenta API_TIMEOUT_MS para que el reintento espere más. En Amazon Bedrock, aumenta también CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS.
• Si al primer intento se le sigue agotando el tiempo de espera y luego el reintento tiene éxito, aumenta CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS para que el primer intento también espere lo suficiente.

​

The response above may be incomplete

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.

• Server error mid-response: un error de sobrecarga o un error de servidor 5xx a mitad del streaming. Esta variante requiere Claude Code v2.1.199 o posterior; antes, en ese caso se descartaba la salida parcial y se informaba todo el turno como un error.
• Connection lost mid-response: la conexión se perdió. También ves esta variante cuando un proxy o gateway cierra limpiamente el cuerpo de la respuesta antes de que la respuesta haya terminado.
• Your computer went to sleep mid-response: Claude Code detectó que tu computadora entró en suspensión mientras la respuesta se transmitía en streaming. Cuando tu computadora se reactiva, Claude Code trata la conexión como rota y deja de leer de ella.
• Part of the response never arrived: un evento del streaming se perdió entre la API y Claude Code, así que un evento posterior hizo referencia a contenido que nunca llegó. Antes de v2.1.281, en este caso el turno terminaba con API Error: Content block not found.
• The response stream was malformed: llegó un evento para un bloque de contenido que ya había terminado, o llegó un evento dañado. Un evento dañado es aquel cuyos datos no son JSON válido, cuyo contenido falta o cuyo contenido no coincide con el tipo del evento. Antes de v2.1.284, en su lugar aparecía el error sin procesar del analizador, como uno que empieza con API Error: JSON Parse error, cuando un evento con JSON no válido llegaba después de que Claude había completado su pensamiento, un bloque de texto o una llamada a herramienta.
• The response stopped arriving: la conexión siguió abierta pero dejó de entregar datos, así que el watchdog de inactividad del streaming la abortó. Antes de v2.1.222, Claude Code también podía informar este fallo en conexiones a un gateway a través de ANTHROPIC_BASE_URL o ANTHROPIC_AWS_BASE_URL mientras aún llegaban los pings de keep-alive del servidor, porque allí solo contaba los eventos de respuesta analizados; actualizar elimina esos tiempos de espera agotados falsos en esas rutas. Los gateways a los que se accede mediante una URL base de proveedor como ANTHROPIC_BEDROCK_BASE_URL no están cubiertos por el watchdog de bytes; consulta Watchdogs de inactividad del streaming.

• Si Claude solo había completado su pensamiento, Claude Code vuelve a emitir la solicitud. Cuando los streamings reemitidos fallan de la misma manera, el turno termina con Part of the response never arrived and no response was produced. Try again. o The response stream was malformed and no response was produced. Try again.
• Si no se había completado nada, Claude Code reenvía en su lugar la solicitud sin streaming. Si desactivaste ese respaldo con CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, el turno termina con API Error: Content block not found para un evento perdido o API Error: Content block already closed para uno duplicado. Para un evento dañado con el respaldo desactivado, el turno termina con API Error: Stream event unreadable o con el error sin procesar del analizador.

• Si ocurre antes en la respuesta, Claude Code reintenta el fallo o termina el turno con un error diferente. Consulta Reintentos automáticos.
• Cuando uno de estos fallos llega después de que Claude terminó la respuesta, Claude Code conserva la respuesta completa y termina el turno normalmente, sin este aviso. Antes de v2.1.222, Claude Code mostraba este aviso cuando la conexión se perdía o se detenía después de que la respuesta terminaba, e informaba el turno como un error aunque la respuesta estuviera completa.
• En una sesión no interactiva, como una ejecución con -p, una ejecución del Agent SDK o una sesión en la nube, no tienes que enviar continue tú mismo cuando la respuesta cortada está en la conversación principal y contiene texto pero ninguna llamada a herramienta: Claude Code conserva la salida parcial y le pide a Claude que continúe desde donde se detuvo, hasta tres veces seguidas. Solo ves este aviso para una respuesta así cuando Claude Code agotó esas continuaciones. Antes de v2.1.246, Claude Code terminaba un turno no interactivo con este aviso en el primer corte.
• En un subagente, sea la sesión interactiva o no: cuando su respuesta cortada contiene texto pero ninguna llamada a herramienta, Claude Code le pide al subagente que continúe. El aviso se convierte en el último mensaje del subagente solo cuando esas continuaciones se agotan. Antes de v2.1.257, un subagente mostraba este aviso en el primer corte.

• En una sesión interactiva, lee la respuesta que queda en pantalla: Claude Code conserva cada bloque que Claude completó antes del error, pero descarta un bloque final interrumpido cuando termina el turno, así que es posible que falten las últimas oraciones o llamadas a herramientas. Responde con continue para que Claude retome desde su último bloque completado.
• En modo no interactivo (-p):
  • Con la salida de texto predeterminada, Claude Code imprime el último bloque de texto completado que aún conserva de antes en el turno, seguido de este mensaje. Cuando no conserva ninguno, Claude Code imprime solo este mensaje, por ejemplo porque Claude Code compactó la conversación a mitad del turno y borró ese texto. Antes de v2.1.219, Claude Code imprimía solo este mensaje en la salida de texto de -p y descartaba la respuesta que ya había producido.
  • Con --output-format json o stream-json, Claude Code informa este mensaje en el campo result.
  • Para continuar el turno cuando la conexión sea estable, reanuda la sesión y envía continue como se describe en Continuar conversaciones.

​

Auto mode cannot determine the safety of an action

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

• Reintenta después de unos segundos; Claude ve el mismo mensaje y normalmente reintenta por su cuenta. Un fallo transitorio no tiene relación con los requisitos del modo automático; no necesitas cambiar la configuración
• Si los reintentos siguen fallando, continúa con tareas de solo lectura y vuelve más tarde a la acción bloqueada
• En Amazon Bedrock, si el mensaje reaparece en cada reintento, comprueba que tu cuenta pueda invocar el modelo que nombra: para los modelos estándar de Amazon Bedrock, confirma que tu política de IAM permite invocarlo; para los IDs de modelo de Mantle, contacta al equipo de tu cuenta de AWS

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

• Reintenta la acción; normalmente funciona en el siguiente intento
• Ejecuta claude --debug y repite la acción para ver los detalles en el registro de depuración

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

• A un subagente en segundo plano en una ejecución con -p sin --input-format stream-json, Claude Code le devuelve un resultado de error que contiene Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• En todos los demás casos, incluidas las sesiones interactivas y la conversación principal de una ejecución con -p, Claude Code le devuelve esa denegación a Claude

• Esto no es una decisión sobre tu acción. Contenido que ya estaba en tu conversación activó un filtro de seguridad en la API cuando el modo automático envió la conversación al clasificador
• Reintentar no servirá; el mismo contenido de la conversación volverá a activar el filtro
• En una sesión interactiva, cambia a otro modo de permisos para poder aprobar la acción cuando se te solicite
• Inicia una conversación nueva sin el contenido que activa el filtro

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

• En una sesión interactiva, el modo automático recurre a una solicitud de permiso normal para esa acción, para que puedas aprobarla o denegarla manualmente
• A un subagente en segundo plano en una ejecución no interactiva con -p sin --input-format stream-json, Claude Code le devuelve un resultado de error que contiene Agent aborted: auto mode classifier transcript exceeded context window in headless mode, y la ejecución continúa
• En cualquier otro punto de una ejecución con -p sin --permission-prompt-tool, no hay ninguna solicitud a la que recurrir, así que la acción no se ejecuta y la ejecución continúa

• En una sesión interactiva, aprueba o deniega la acción en la solicitud que aparece
• En una sesión interactiva, ejecuta /compact para reducir el tamaño de la conversación y que las acciones siguientes vuelvan a caber en la ventana del clasificador

​

The server returned no safety verdict

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

• En una sesión interactiva, el mensaje aparece como advertencia en la transcripción y el turno termina
• En una ejecución no interactiva con -p, la ejecución termina e informa un error de ejecución. Con la salida de texto predeterminada, el mensaje se imprime en stderr.
• Cuando un subagente alcanzó el límite, el subagente se detiene antes de terminar, y Claude recibe lo que haya producido junto con una nota de que el modo automático lo detuvo

• Envía otro mensaje para que Claude lo intente de nuevo. El recuento de respuestas se reinicia.
• Si la detención se repite y tus solicitudes pasan por un gateway de LLM o proxy, comprueba si corta las respuestas en streaming o las reescribe. Revisión del clasificador en el servidor indica qué comportamiento del gateway causa denegaciones, y la guía de compatibilidad de gateways enumera lo que debe pasar sin cambios.
• Establece CLAUDE_CODE_AUTO_MODE_SERVER=0 antes de iniciar Claude Code para que use en su lugar sus propias solicitudes al clasificador. Antes de v2.1.281, Claude Code no leía la variable en una conexión directa a la API de Anthropic.
• Para aprobar tú mismo las acciones, sal del modo automático

​

Agent terminated early due to an API error

Agent terminated early due to an API error: <error detail>

• Busca el detalle del error que aparece después de los dos puntos en su propia sección de esta página, como Límites de uso o Errores del servidor, y sigue los pasos de esa sección
• Cuando se resuelva el error subyacente, pídele a Claude que reintente la tarea o reanuda el subagente

​

Límites de uso

​

You’ve hit your session limit

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

• Espera la hora de reinicio que se muestra en el error
• En la pestaña Code de la aplicación de escritorio, la tarjeta de límite de sesión ofrece una casilla de verificación Auto-continue when limits reset. La tarjeta de límite semanal no. Cuando está marcada, la aplicación de escritorio reintenta el turno interrumpido después del reinicio y muestra la hora del reintento en la tarjeta. La casilla de verificación de escritorio y el ajuste Continue automatically at usage limit de la CLI en /config son independientes, así que desactiva cada uno por separado.
• Para el límite de Opus o Sonnet, ejecuta /model y cambia a un modelo fuera de esa familia para seguir trabajando. Cada modelo tiene su propia caché de prompts, por lo que la siguiente solicitud relee toda la conversación sin aciertos de caché; consulta Cambiar de modelo
• Ejecuta /usage para ver los límites de tu plan y cuándo se reinician
• Ejecuta /usage-credits para comprar uso adicional en Pro y Max, o para solicitarlo a tu administrador en Team y Enterprise. Consulta créditos de uso para planes de pago para ver cómo se factura esto.
• Para actualizar tu plan y obtener límites base más altos, consulta claude.com/pricing

​

Usage credits required for 1M context

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

• Ejecuta /model y selecciona la variante sin el sufijo [1m] para volver a la ventana de contexto estándar
• Donde el mensaje menciona /usage-credits, ejecútalo para activar la facturación medida de la variante de 1M en Pro y Max, o para solicitar créditos de uso a tu administrador en Team y Enterprise. Una vez que los créditos de uso estén activados, reinicia Claude Code o inicia una nueva sesión, según lo que indique el mensaje. Hasta entonces, la sesión permanece en el límite de contexto estándar.
• Si el error persiste después de /model, es posible que un ID de modelo de 1M esté configurado en otro lugar. Consulta Configurar tu modelo para ver las ubicaciones de configuración que debes verificar en orden de prioridad.
• Para eliminar por completo las variantes de 1M del selector de modelo, establece CLAUDE_CODE_DISABLE_1M_CONTEXT=1

​

The prompt to confirm went unanswered

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

• Donde se ejecuta la sesión, en la terminal o en la aplicación que la aloja, envía otro prompt y responde la solicitud de consentimiento cuando vuelva a aparecer. Para una sesión en segundo plano, primero conéctate a ella desde la vista de agentes. Reenviar desde un cliente de Remote Control vuelve a mostrar este mensaje, porque el cliente no puede mostrar la solicitud.
• Ejecuta /model para cambiar a un modelo que no facture créditos de uso
• Para darte más tiempo, establece dialogExpiry en un valor más largo o en "never"

​

Server is temporarily limiting requests

API Error: Server is temporarily limiting requests (not your usage limit)

• Espera un momento e inténtalo de nuevo
• Consulta status.claude.com si persiste

​

Request rejected (429)

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

• Ejecuta /status y confirma que la credencial activa es la que esperas. Un ANTHROPIC_API_KEY olvidado en tu entorno puede enrutar las solicitudes a través de una clave de nivel bajo en lugar de tu suscripción.
• Consulta la consola de tu proveedor para ver los límites activos y solicita un nivel más alto si es necesario
• Para claves de API de Anthropic, consulta la referencia de rate limits para ver cómo funcionan los niveles y cómo establecer límites por espacio de trabajo
• Reduce la concurrencia: baja CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, evita ejecutar muchos subagentes en paralelo o cambia a un modelo más pequeño con /model para ejecuciones con scripts de alto volumen

​

You’ve hit your monthly spend limit

You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

• En Pro y Max, aumenta tu límite de gasto mensual en Settings > Usage en claude.ai, o ejecuta /usage-credits
• En Team y Enterprise, aumenta el límite en Organization settings > Usage si gestionas la facturación, o pídele a un administrador que lo haga. /usage-credits envía esa solicitud a tu administrador por ti
• Para el límite de un canal, pide a un propietario de la organización o al administrador del canal que lo aumente en claude.ai. Consulta Per-channel limits en la documentación de Claude Tag
• Si el mensaje indica una hora de reinicio para la ventana de tu plan, puedes esperar a que llegue
• Ejecuta /usage para ver las ventanas de tu plan y cuándo se reinicia cada una

​

Spend limit reached

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

• Espera la hora de reinicio que indica el mensaje, o sigue las instrucciones del operador si el mensaje las incluye
• Pide al operador de tu gateway que aumente el límite si lo alcanzas con frecuencia

​

Credit balance is too low

Credit balance is too low

• Si tienes un plan Pro, Max, Team o Enterprise y ves esto, ejecuta /status y revisa la fila API key. Un ANTHROPIC_API_KEY aprobado en tu entorno enruta las solicitudes a través de esa clave en lugar de tu suscripción. Elimina la variable en el shell actual y quítala de tu perfil de shell, luego vuelve a iniciar claude. Ejecuta /login si aún no iniciaste sesión con tu suscripción.
• Agrega créditos en platform.claude.com/settings/billing, y considera activar ahí la recarga automática para que el saldo se recargue antes de llegar a cero
• Establece límites de gasto por espacio de trabajo en la Console para evitar que un solo proyecto agote el saldo de la organización. Consulta Administrar los costos de forma eficaz.

​

Could not update your spend limit

Could not update your spend limit: <reason from the server>

• Si el mensaje incluye una razón, elige un límite que la cumpla, como una cantidad menor
• Si el mensaje muestra solo la forma genérica, reintenta; el fallo puede ser transitorio
• Si el cambio sigue fallando, hazlo en cambio desde tu configuración de facturación de claude.ai en el navegador

​

Errores de autenticación

​

No has iniciado sesión

Not logged in · Please run /login

• Ejecuta /login para autenticarte con tu suscripción de Claude o tu cuenta de Console
• Si esperabas que una variable de entorno te autenticara, confirma que ANTHROPIC_API_KEY está definida y exportada en el shell desde el que iniciaste claude
• Para CI o automatización donde el inicio de sesión interactivo no es posible, configura un script apiKeyHelper que obtenga una clave al inicio
• Consulta Precedencia de autenticación para entender qué credencial usa Claude Code cuando hay varias presentes

​

No se pudo resolver el método de autenticación

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

• Actualiza a la v2.1.176 o posterior si esto aparece en una sesión en segundo plano o en la nube y tus credenciales ya están configuradas
• Confirma que ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o las credenciales de tu proveedor de nube están definidas en el entorno que inicia el worker, no solo en tu shell interactivo
• Para el Agent SDK, consulta la configuración de autenticación en el inicio rápido
• Ejecuta /status en una sesión interactiva en el mismo entorno para confirmar qué fuente de credenciales se resuelve

​

Clave de API no válida

Invalid API key · Fix external API key

• Busca errores tipográficos y confirma que la clave no ha sido revocada en la Console
• En el mismo shell, ejecuta env | grep ANTHROPIC, o en PowerShell Get-ChildItem Env:ANTHROPIC*. Herramientas como direnv, los plugins de shell para dotenv y las terminales de los IDE pueden cargar una clave obsoleta desde un archivo .env de tu proyecto sin que la definas explícitamente.
• Elimina ANTHROPIC_API_KEY y ejecuta /login para usar en su lugar la autenticación por suscripción
• Si la clave proviene de un script apiKeyHelper, ejecuta el script directamente para confirmar que imprime una clave válida en stdout
• Ejecuta /status para confirmar qué fuente de credenciales está usando realmente Claude Code

​

Tu script apiKeyHelper está fallando

• El comando terminó con un error o se agotó su tiempo de espera
• El comando no imprimió nada en stdout
• El comando imprimió algo además de la clave, como un banner de inicio de sesión o una línea de registro. El panel muestra returned output that cannot be used as an API key e indica qué está mal, sin repetir la salida. Antes de la v2.1.227, Claude Code enviaba lo que el comando imprimiera, tras recortar los espacios en blanco circundantes.

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

• Ejecuta directamente en tu shell el comando configurado en apiKeyHelper para reproducir el fallo
• Si el comando informa una sesión expirada, vuelve a autenticarte con tu proveedor de credenciales, por ejemplo iniciando sesión de nuevo en tu SSO o en tu almacén de secretos
• Corrige el comando para que imprima solo la clave en stdout, como un único token de ASCII imprimible de hasta 16,384 caracteres, y termine con el código de salida 0. Consulta rotar credenciales con apiKeyHelper para ver una configuración funcional.
• Ejecuta /status para ver el fallo y confirmar que apiKeyHelper es la fuente de credenciales activa. La fila apiKeyHelper muestra Failing con el detalle del último fallo, como el código de salida y la salida de error del comando, y desaparece después de la siguiente ejecución correcta. Antes de la v2.1.274, /status mostraba solo la fuente de credenciales, no el fallo.
• Cada vez que el comando falla, su código de salida y su salida de error también aparecen en un panel Authentication en la terminal. Antes de la v2.1.212, el panel se titulaba Cloud authentication.

​

Valor de encabezado de solicitud no válido

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

• Invalid auth token: un token bearer de ANTHROPIC_AUTH_TOKEN o CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS: un nombre o valor de encabezado que definiste en ANTHROPIC_CUSTOM_HEADERS. La descripción indica por número qué par Name: Value es el problemático, como distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, sin repetir el nombre ni el valor, ya que tú elegiste ambos.
• Invalid request header from the environment: un valor que Claude Code copia en un encabezado de solicitud desde otra variable de entorno, como CLAUDE_AGENT_SDK_CLIENT_APP. La descripción indica la variable que debes corregir.

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

• Vuelve a definir la variable o el ajuste que indica el mensaje, escribiendo de nuevo a mano los caracteres alrededor de la posición informada en lugar de pegarlos otra vez desde la misma fuente
• Para ANTHROPIC_CUSTOM_HEADERS, mantén un par Name: Value por línea y reescribe el par que indica el mensaje
• Ejecuta /status para confirmar qué fuente de credenciales está activa

​

Esta organización ha sido deshabilitada

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

• Elimina ANTHROPIC_API_KEY en el shell actual y quítala de tu perfil de shell; luego vuelve a iniciar claude
• Si el mensaje dice Update or unset, no tienes ningún inicio de sesión guardado al que recurrir. Elimina la clave y ejecuta /login, o reemplaza la clave por una de una organización de Console activa.
• Ejecuta /status después para confirmar que la credencial activa es tu suscripción
• Si no hay ninguna variable de entorno definida y el error persiste, contacta con soporte o inicia sesión con otra cuenta.

​

Tu organización ha deshabilitado la autenticación con clave de API

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Sign in again with your claude.ai account

• Si el mensaje menciona ANTHROPIC_API_KEY, elimínala en el shell actual y quítala de tu perfil de shell o de tu archivo .env; luego vuelve a iniciar claude
• Si el mensaje menciona apiKeyHelper, quita el ajuste apiKeyHelper de tu settings.json
• Ejecuta /login para iniciar sesión con tu cuenta de claude.ai
• Ejecuta /status después para confirmar que la credencial activa es tu suscripción y no una clave de API
• Si necesitas la autenticación con clave de API para automatización, pide al administrador de tu organización que la vuelva a habilitar en la Console

​

Tu organización ha deshabilitado el acceso con suscripción de Claude

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

• Pide a tu administrador que habilite el acceso a Claude Code para tu organización
• Autentícate con una clave de API de Console en lugar de tu suscripción. Consulta Autenticación con Claude Console para configurarla.
• Si eres el administrador y no ves ninguna opción para habilitar el acceso, contacta con el soporte de Anthropic

​

Las rutinas están deshabilitadas por la política de tu organización

Routines are disabled by your organization's policy.

• Pide a un Owner de tu organización que active el interruptor Routines en claude.ai/admin-settings/claude-code
• Para trabajo programado puntual que no requiere rutinas a nivel de organización, consulta tareas programadas

​

Remote Control requiere la API de Anthropic

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.

• Una variable de proveedor CLAUDE_CODE_USE_*, como CLAUDE_CODE_USE_BEDROCK para Amazon Bedrock o CLAUDE_CODE_USE_VERTEX para Agent Platform de Google Cloud
• ANTHROPIC_BASE_URL apuntando a un host distinto de api.anthropic.com, como un gateway de LLM o un proxy, incluso cuando inicias sesión con claude.ai; antes de la v2.1.196, una URL base personalizada no bloqueaba Remote Control
• ANTHROPIC_UNIX_SOCKET definida, de modo que la sesión envía sus solicitudes a través de un socket local en lugar de a api.anthropic.com
• Un inicio de sesión en un gateway en la nube empresarial realizado mediante /login, que no admite Remote Control y no tiene ninguna variable que eliminar

• Elimina la variable que menciona el mensaje, como CLAUDE_CODE_USE_BEDROCK o ANTHROPIC_BASE_URL, y reinicia la sesión, o inicia Remote Control desde una sesión que se comunique directamente con la API de Anthropic
• Si la variable no está definida en tu shell, revisa la clave env en tus archivos de configuración, que aplica variables de entorno a todas las sesiones
• Para este y los demás mensajes de inicio de Remote Control, consulta Solución de problemas de Remote Control

​

Remote Control no pudo renovar tu inicio de sesión

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

• Claude.ai login expired y Claude.ai login was rejected: claude.ai ya no acepta tu token de inicio de sesión guardado, porque expiró o fue revocado
• OAuth token unavailable: Claude Code no tenía ningún token de inicio de sesión guardado cuando correspondía renovar la credencial de la conexión
• OAuth token refresh failed: claude.ai rechazó tu token de inicio de sesión guardado mientras Claude Code se reconectaba, y la renovación del token no produjo uno nuevo
• JWT refresh failed: no OAuth token: Claude Code no encontró ningún token de inicio de sesión guardado con el que renovar
• Signed out of Claude: cerraste sesión en esta máquina, por ejemplo ejecutando /logout en otra terminal, así que Claude Code no tiene ningún inicio de sesión guardado con el que renovar la conexión

• Ejecuta /login para volver a iniciar sesión
• Ejecuta /remote-control para reconectar la sesión. Los mensajes que terminan en run /login to restore Remote Control no necesitan este paso: Claude Code se reconecta por sí solo una vez que inicias sesión.

​

Remote Control could not renew this computer’s connection

Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.

• Si la advertencia te indica que ejecutes claude /login, abre otra terminal en la máquina que ejecuta el servidor, ejecuta claude /login allí e inicia sesión con tu cuenta de claude.ai
• Si el servidor sigue sin poder iniciar sesión una vez que la credencial de la conexión caducó, imprime un error que contiene Poll: Authentication failed (401) y se detiene. Vuelve a iniciar sesión como indica la segunda oración de la advertencia y luego ejecuta de nuevo claude remote-control en la terminal donde se detuvo el servidor.

​

Remote Control se detuvo porque cambió la cuenta con la que iniciaste sesión

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

• Ejecuta /remote-control para iniciar una nueva sesión de Remote Control con la cuenta u organización actual
• Para volver a la anterior, ejecuta /login e inicia sesión de nuevo en la cuenta u organización anterior. Luego ejecuta /remote-control.

​

Remote Control se detuvo porque la aplicación que ejecuta la sesión cerró sesión o cambió de cuenta

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

• Si la aplicación cerró sesión, vuelve a iniciar sesión en ella y luego reactiva Remote Control en la aplicación
• Si la aplicación cambió de cuenta, Claude Code no puede continuar la sesión finalizada con la nueva cuenta. Inicia una nueva sesión de Remote Control con esa cuenta.

​

Token de OAuth revocado o expirado

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...

• Ejecuta /login en el prompt de Claude Code para volver a iniciar sesión
• Si tu comando -p o tu programa del Agent SDK usa un inicio de sesión guardado, ejecuta claude en el mismo entorno, completa /login y luego vuelve a ejecutar el comando o el programa. Para automatización que no puede iniciar sesión de forma interactiva, autentícate con ANTHROPIC_API_KEY o genera un token de larga duración con claude setup-token.
• Si te autenticas con la variable de entorno CLAUDE_CODE_OAUTH_TOKEN, Claude Code sigue enviando el valor que definiste después de que una solicitud falle con un 401, en lugar de cambiar al token de un inicio de sesión almacenado. /status muestra esta credencial como una fila Auth token que dice CLAUDE_CODE_OAUTH_TOKEN. Genera un token nuevo con claude setup-token y reinicia con él, o elimina la variable y ejecuta /login. Antes de la v2.1.225, Claude Code podía reemplazar el valor de la variable a mitad de la sesión con el token de acceso de corta duración de un inicio de sesión almacenado, y la sesión volvía a fallar con errores 401 una vez que ese token expiraba.
• Si se te pide iniciar sesión repetidamente entre ejecuciones, consulta las comprobaciones del reloj del sistema y los pasos de recuperación del almacenamiento de credenciales en macOS en Solución de problemas
• Para otros fallos, incluidos 403 Forbidden y problemas de OAuth en el navegador, consulta Inicio de sesión y autenticación

​

API Error: 401 Invalid authentication credentials

Please run /login · API Error: 401 Invalid authentication credentials

• Si /status muestra una fila API key que no está marcada como no en uso, un ANTHROPIC_API_KEY aprobado es la credencial activa y tiene precedencia sobre tu inicio de sesión, así que /login no lo reemplaza. Rota la clave en Claude Console, o vuelve a tu suscripción ejecutando unset ANTHROPIC_API_KEY, o en PowerShell Remove-Item Env:ANTHROPIC_API_KEY.
• Si /status muestra solo tu inicio de sesión, ejecuta /login una vez. Si la credencial se revocó, un nuevo inicio de sesión la reemplaza.
• Si el mismo mensaje vuelve a aparecer con la misma cuenta de inicio de sesión, la cuenta o la organización ya no está activa. Comprueba la cuenta y la organización que informa /status, y pide al administrador de tu organización que restaure el acceso.
• Si ANTHROPIC_BASE_URL apunta a un gateway de LLM, el texto después de 401 es el mensaje de tu gateway y no el de Anthropic, y /login no lo cambia. Corrige en su lugar la credencial que espera tu gateway.

​

Inicio de sesión expirado

Login expired · Please run /login

Failed to authenticate: OAuth session expired and could not be refreshed

• Ejecuta /login para volver a iniciar sesión. Reintentar sin iniciar sesión muestra el mismo mensaje en cada solicitud.
• Si inicias sesión con tu cuenta de claude.ai en otra ventana de Claude Code, consulta No has iniciado sesión para saber cuándo esta sesión empieza a usar ese inicio de sesión por sí sola.
• En el modo no interactivo, ejecuta claude en el mismo entorno, completa /login y luego vuelve a ejecutar tu comando. Para automatización que no puede iniciar sesión de forma interactiva, autentícate con ANTHROPIC_API_KEY o genera un token de larga duración con claude setup-token.
• Si el inicio de sesión sigue fallando, consulta Inicio de sesión y autenticación

​

No se pudo renovar tu inicio de sesión porque otro proceso de Claude Code lo está renovando

Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

• Vuelve a intentarlo en un minuto. Si otro proceso completa antes la renovación, esta sesión usa el inicio de sesión renovado.
• Si el mensaje sigue apareciendo, cierra las demás ventanas y procesos de Claude Code y luego reintenta.
• Si vuelve a aparecer sin ningún otro proceso de Claude Code en ejecución, ejecuta /login. Volver a iniciar sesión no espera al bloqueo de renovación.

​

No se pudo guardar tu inicio de sesión

Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.

• En macOS, desbloquea el llavero de inicio de sesión y luego vuelve a ejecutar /login
• En otras plataformas, vuelve a ejecutar /login
• Si el inicio de sesión sigue sin guardarse, consulta No has iniciado sesión o el token expiró para ver el comando para desbloquear el llavero y otros pasos de recuperación del almacenamiento de credenciales

​

No se pudo iniciar el servidor de callback de OAuth

Failed to start OAuth callback server: Failed to start server. Is port 0 in use?

• Para iniciar sesión de inmediato sin el listener local: si usas una suscripción de claude.ai, ejecuta claude setup-token en una máquina donde el inicio de sesión funcione y define el token que imprime como CLAUDE_CODE_OAUTH_TOKEN en esta máquina. De lo contrario, define ANTHROPIC_API_KEY con una clave de Claude Console. Precedencia de autenticación explica cómo elige Claude Code entre credenciales.
• Para usar en su lugar el inicio de sesión por navegador en esta máquina, Claude Code debe poder escuchar en 127.0.0.1. Si se ejecuta dentro de un sandbox, comprueba que la política del sandbox permita escuchar en puertos locales y luego vuelve a ejecutar /login. Si debería poder hacerlo y sigue fallando, ejecuta /feedback para que el informe incluya los detalles de tu entorno.

​

Inicio de sesión de Claude no aceptado

Claude login not accepted · Run /login, then try again

• Ejecuta /login, completa el inicio de sesión y luego vuelve a iniciar la sesión

​

Los artefactos necesitan un inicio de sesión de claude.ai

Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

• Ejecuta /login y selecciona Claude account with subscription. La opción Anthropic Console account no proporciona credenciales de claude.ai.
• Cuando el mensaje menciona una credencial que tiene precedencia, como ANTHROPIC_API_KEY, un ajuste apiKeyHelper o una clave de Console guardada por un /login anterior, quítala como indica el mensaje y luego ejecuta /login
• Cuando el mensaje dice que esta sesión remota se autentica a través de la máquina que la inició, inicia sesión en claude.ai en esa máquina y luego reconecta la sesión
• Cuando el mensaje dice que la credencial la inyecta el entorno anfitrión de la sesión, no puedes cambiarla en esa sesión; inicia una sesión que tenga la sesión de claude.ai iniciada
• Consulta Disponibilidad para ver los demás requisitos de los artefactos, como el plan, el proveedor del modelo y la política de la organización

​

La política del administrador requiere un inicio de sesión en el gateway en la nube

Not signed in to the Cloud gateway — run /login.

Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.

• Para Not signed in to the Cloud gateway, ejecuta /login y completa el inicio de sesión en la pantalla Cloud gateway
• Para el mensaje de inicio, quita la credencial siguiendo los pasos que aparecen al final del mensaje
• Si crees que la máquina no debería requerir el gateway, pide al administrador que la gestiona que quite forceLoginMethod y forceLoginGatewayUrl de su configuración administrada

​

Tu cuenta está en espera

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

• Abre el enlace del mensaje para ver los detalles de la suspensión o apelarla
• Si tienes otra cuenta de Claude o una clave de API que no se ve afectada por la suspensión, puedes seguir trabajando mientras se resuelve: ejecuta /login con esa cuenta, o define la clave con ANTHROPIC_API_KEY

​

Inicio de sesión del perfil de Anthropic expirado

Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

• Si el mensaje empieza por Login expired, ejecuta /login para volver a iniciar sesión
• Para renovar un perfil que escribió el inicio de sesión sin clave de Console o el ant auth login de la CLI de Claude Platform, ejecuta /login en una máquina que ofrezca el inicio de sesión sin clave. Elige la cuenta de Anthropic Console y luego Sign in with your Console account. Claude Code reemplaza la credencial expirada en ese perfil
• Para renovar un perfil que creó otra herramienta, vuelve a iniciar sesión con esa herramienta. Si en su lugar eliges Sign in with your Console account en /login, Claude Code deja el perfil como está y crea una clave de API
• Si un administrador aprovisionó la credencial del perfil, pídele que emita una nueva
• Ejecuta /status para confirmar la fuente de credenciales activa y el nombre del perfil
• Para dejar de usar el perfil, elimina ANTHROPIC_PROFILE si la definiste y luego autentícate de otra forma, como /login o ANTHROPIC_API_KEY

• Cuando Claude Code descubrió el perfil desde tu directorio de configuración y su modo de autenticación es user_oauth, el mensaje empieza por Login expired y ofrece /login primero. Claude Code da a un /login que funcione precedencia sobre el perfil descubierto y luego se autentica con tu cuenta de claude.ai en su lugar. Desde v2.1.234 hasta v2.1.277, esta forma decía Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. Antes de v2.1.234, Claude Code también mostraba la forma Re-authenticate your Anthropic profile en este caso.
• Cuando seleccionaste el perfil con ANTHROPIC_PROFILE, el mensaje empieza por Anthropic profile login expired.

​

Requisito de alcance de OAuth

OAuth token does not meet scope requirement: user:profile

• Ejecuta /login para obtener un token nuevo con los alcances actuales. No necesitas cerrar sesión primero.

​

claude.ai rechazó el token de sesión

claude.ai rejected the session token. Run /login, then reconnect.

• Ejecuta /login para volver a iniciar sesión
• Reconecta el conector desde /mcp, o ejecuta /mcp reconnect <server>. Reconectar antes de volver a iniciar sesión deja el conector en el mismo estado. La opción Reconnect del panel de /mcp informa your claude.ai session token was rejected; la forma escrita /mcp reconnect <server> informa una reconexión correcta aunque el token siga rechazado.

​

El servidor MCP necesita que vuelvas a iniciar sesión

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

​

Falta la URL del servidor MCP o no es una URL válida

Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

• Establece la url de la entrada en el endpoint real del servidor donde está configurado el servidor, o define la variable de entorno que nombra su referencia ${VAR}, y luego vuelve a ejecutar el inicio de sesión.

​

Discrepancia del emisor en la respuesta de autorización

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

• Vuelve a intentar el inicio de sesión desde /mcp
• Si el error se repite, infórmalo al operador del servidor. La solución es del lado del servidor: el servidor de autorización debe devolver en el parámetro iss el mismo emisor que anuncia en sus metadatos
• Para conectarte mientras se corrige el servidor, inicia Claude Code con MCP_SDK_GENERATION=v1, cuyo runtime no realiza esta comprobación. Esto elimina una protección contra los ataques de confusión, así que es preferible la solución del lado del servidor

​

Se rechaza enviar credenciales a un endpoint de token que no es https

Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

• Sirve ese endpoint de token por HTTPS, por ejemplo colocando el servidor detrás de un proxy inverso o un túnel que termine TLS y configurando el servidor para que anuncie la dirección https://
• Para conectarte sin cambiar el servidor, inicia Claude Code con MCP_SDK_GENERATION=v1, cuyo runtime no aplica esta regla y envía la solicitud de token por HTTP simple. Esa elección dura hasta que sales y se aplica a todos los servidores. El runtime v1 también omite la comprobación del emisor, así que es preferible servir el endpoint por HTTPS

​

Credenciales de AWS expiradas o no válidas

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

• Si la sugerencia dice que las credenciales las gestiona este entorno, la aplicación que inició Claude Code es dueña de la credencial y los demás pasos de esta sección no se aplican: reintenta o contacta con tu administrador
• Si awsAuthRefresh está definido, ejecuta en otra terminal el comando que indica el mensaje, como aws sso login --profile myprofile, completa el inicio de sesión en el navegador y luego reintenta. De lo contrario, renueva tú mismo la credencial de AWS que usas: tu inicio de sesión de SSO, tus claves de acceso, tu clave de API o tu token de proxy
• Con awsAuthRefresh definido en una sesión interactiva, puedes en su lugar ejecutar /login, elegir 3rd-party platform y luego seleccionar Claude Platform on AWS · refresh credentials en Using 3rd-party platforms para ejecutar el mismo comando sin reiniciar Claude Code. Consulta Configurar las credenciales de AWS
• Si el error se repite después de que el comando de renovación se complete correctamente, confirma que la identidad es válida fuera de Claude Code con aws sts get-caller-identity en el mismo shell y perfil

​

Falló la autenticación de AWS

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

• Si la sugerencia dice que las credenciales las gestiona este entorno, la aplicación que inició Claude Code es dueña de la credencial y los demás pasos de esta sección no se aplican: reintenta o contacta con tu administrador
• Renueva tus credenciales de AWS por si la causa es una credencial expirada: ejecuta el comando awsAuthRefresh que indica el mensaje cuando hay uno definido, o renueva tú mismo tu inicio de sesión de SSO, tus claves de acceso, tu clave de API o tu token de proxy
• Si tus credenciales están al día, confirma que los permisos de IAM de Configuración de IAM están asociados a la identidad que usas y que el modelo seleccionado está habilitado para tu cuenta y región
• Ejecuta aws sts get-caller-identity para confirmar qué identidad usan tus solicitudes

​

Credenciales de Google Cloud expiradas o no válidas

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

• Si la sugerencia dice que las credenciales las gestiona este entorno, la aplicación que inició Claude Code es dueña de la credencial y los demás pasos de esta sección no se aplican: reintenta o contacta con tu administrador
• Si te autenticas con las credenciales predeterminadas de la aplicación, ejecuta el comando gcpAuthRefresh que indica el mensaje, o gcloud auth application-default login, completa el inicio de sesión y luego reintenta
• Si enrutas a través de un gateway de LLM con CLAUDE_CODE_SKIP_VERTEX_AUTH definida, renueva el token del gateway en ANTHROPIC_AUTH_TOKEN o ANTHROPIC_CUSTOM_HEADERS y luego reintenta
• Si te autenticas con un archivo de clave de cuenta de servicio, confirma que GOOGLE_APPLICATION_CREDENTIALS apunta a una clave válida. Consulta Configurar las credenciales de GCP
• Si el error se repite después de una renovación, confirma que la identidad funciona fuera de Claude Code con gcloud auth application-default print-access-token en el mismo shell

​

Falló la autenticación de Google Cloud

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

• Si la sugerencia indica que las credenciales las administra este entorno, la aplicación que inició Claude Code es la dueña de la credencial y los demás pasos de aquí no aplican: reintenta o contacta a tu administrador
• Confirma que los roles de configuración de IAM estén otorgados a la identidad con la que te autenticas
• Confirma que el modelo esté habilitado para tu proyecto. Consulta Solicitar acceso al modelo

​

Falló la autenticación de Microsoft Foundry

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

• Si la sugerencia indica que las credenciales las administra este entorno, la aplicación que inició Claude Code es la dueña de la credencial y los demás pasos de aquí no aplican: reintenta o contacta a tu administrador
• Renueva la credencial que configuraste en Configurar credenciales de Azure: rota ANTHROPIC_FOUNDRY_API_KEY, genera un ANTHROPIC_FOUNDRY_AUTH_TOKEN nuevo o ejecuta az login para que la cadena de credenciales predeterminada de Microsoft Entra pueda volver a iniciar sesión
• Si la credencial está vigente, confirma que la identidad tenga acceso al recurso de Foundry. Consulta Configuración de Azure RBAC

​

No se pudieron cargar las credenciales de AWS o Google Cloud

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

• Ejecuta el comando de inicio de sesión de tu proveedor, como aws sso login --profile myprofile o gcloud auth application-default login, y luego reintenta. Las credenciales de Bedrock, Agent Platform o Foundry no se cargan muestra cómo confirmar las credenciales fuera de Claude Code
• Si el detalle dice AWS default-chain credential resolve timed out, la cadena se colgó en lugar de fallar, así que sigue en su lugar Se agotó el tiempo de espera al resolver las credenciales de la cadena predeterminada de AWS

​

Se agotó el tiempo de espera al resolver las credenciales de la cadena predeterminada de AWS

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

• Ejecuta aws sts get-caller-identity en el mismo shell con el mismo AWS_PROFILE. Si también se cuelga, corrige el perfil; un comando credential_process que pide datos de forma interactiva es una causa común.
• Completa el paso de inicio de sesión antes de iniciar Claude Code, por ejemplo aws sso login --profile myprofile
• Si tu cadena ejecuta un inicio de sesión interactivo que legítimamente necesita más de 60 segundos, como SSO con MFA a través de un wrapper como aws-vault, aumenta el límite en milisegundos con CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Se agotó el tiempo de espera de la verificación de configuración de Bedrock esperando a AWS

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

A request to AWS timed out. Check your network and proxy settings, then try again.

• Ejecuta aws sts get-caller-identity en el mismo shell. Si también se cuelga, el estancamiento está fuera de Claude Code, en tu red, tu proxy o el asistente de credenciales de tu perfil de AWS; corrige eso primero.
• Completa cualquier inicio de sesión interactivo antes de abrir el asistente, por ejemplo aws sso login --profile myprofile
• Si un asistente de credenciales de tu perfil de AWS legítimamente necesita más de 60 segundos para pedirte datos, aumenta el límite en milisegundos con CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

La sesión del gateway en la nube venció

Cloud gateway session expired — run /login to reconnect.

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

• Ejecuta /login en la sesión y completa el inicio de sesión en el navegador
• Para un inicio no interactivo, inicia claude en el mismo entorno, ejecuta /login y luego vuelve a ejecutar tu comando

​

Se agotó el tiempo de inicio de sesión mientras esperaba que continuaras

Sign-in timed out while waiting for you to continue. Try again.

• Ejecuta /login de nuevo y confirma la cuenta antes de que venza el inicio de sesión

​

El gateway rechazó la solicitud

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

• Pide a tu administrador del gateway que busque la solicitud. La parte final API Error: contiene el rechazo que devolvió el gateway
• Para administradores: una regla de control de acceso en el gateway devuelve un 403 que el registro de auditoría guarda junto con su motivo, y la denegación de autorización de un servicio upstream se transmite según Mensajes de error de upstream

​

Errores de red y conexión

​

Unable to connect to API

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings

• Confirma que puedes alcanzar el host de la API desde el mismo shell ejecutando curl -I https://api.anthropic.com. En Windows PowerShell usa curl.exe -I https://api.anthropic.com para que no se use el alias integrado Invoke-WebRequest.
• Si estás detrás de un proxy corporativo, establece HTTPS_PROXY antes de iniciar Claude Code y consulta Configuración de red
• Si enrutas a través de un gateway LLM o un relé, establece ANTHROPIC_BASE_URL en su dirección. Consulta Conectar Claude Code a un gateway LLM para la configuración.
• Asegúrate de que tu firewall permita los hosts enumerados en Requisitos de acceso a la red
• Los fallos intermitentes se reintentan automáticamente; los fallos persistentes apuntan a un problema de red local

• Verifica si ANTHROPIC_BASE_URL está establecida ejecutando echo $ANTHROPIC_BASE_URL, o echo $env:ANTHROPIC_BASE_URL en PowerShell, y búscala en el bloque env de tus archivos de configuración. Cuando está establecida, Claude Code envía las solicitudes al modelo a esa dirección en lugar de a api.anthropic.com, por lo que un valor residual que apunta a un proxy o gateway local que ya no se está ejecutando produce Connection refused aunque curl alcance la API. Elimínala de tu perfil de shell o de tu configuración e inicia Claude Code desde una nueva terminal.
• En Linux y WSL, revisa /etc/resolv.conf en busca de un servidor de nombres inaccesible. WSL en particular puede heredar un resolvedor defectuoso del host.
• En macOS, un cliente VPN que se desconectó o desinstaló puede dejar una interfaz de túnel o una regla de enrutamiento. Revisa ifconfig en busca de interfaces utun obsoletas y elimina la extensión de red de la VPN en Configuración del Sistema.
• Docker Desktop y runtimes de contenedores similares pueden interceptar el tráfico saliente. Ciérralos y vuelve a intentarlo para descartar esta causa.

​

Unable to connect to Anthropic services

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

• Si el mensaje nombra una variable de proxy, verifica que su valor apunte al proxy correcto y pide a tu equipo de red que permita conexiones HTTPS a través de él hacia el host del mensaje. Consulta Configuración de red.
• Revisa las comprobaciones de Unable to connect to API. La prueba con curl y las indicaciones sobre el firewall de esa sección también se aplican a esta verificación.
• Si tu red está abierta y el fallo persiste, es posible que Claude Code no esté disponible en tu país

​

Socket is closed

• Si ves este error, actualiza a v2.1.214 o posterior con claude update y luego envía tu mensaje de nuevo
• Si los turnos siguen fallando detrás del mismo proxy después de actualizar, revisa Unable to connect to API y verifica la configuración del proxy en Configuración de red

​

API returned an empty or malformed response

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

• Una cláusula Response: con el tipo de contenido, el tipo de cuerpo, como body is an HTML page o empty body, su tamaño en bytes y si la respuesta incluía un id de solicitud de Anthropic. Cuando la respuesta nombra un servidor reconocible, como nginx o cloudflare, o incluye encabezados de intermediarios, como cf-ray o via, la cláusula también los enumera.
• Una oración que nombra el id de la solicitud en streaming fallida y el fallo que desencadenó el reintento. Cuando se había abierto un stream antes del fallo, también informa cuántos eventos del stream llegaron y, si llegó alguno, cuánto tiempo llevaba el stream en silencio cuando el intento falló.

• Lee la cláusula Response: para ver qué sistema respondió. Un cuerpo HTML, la ausencia de id de solicitud de Anthropic o un servidor nombrado como nginx o cloudflare significan que algo entre Claude Code y la API respondió en su lugar
• Si enrutas a través de un gateway LLM, prueba la ruta con una solicitud directa y corrige el salto que devuelve la respuesta que no es de la API
• En una red con página de inicio de sesión, como una Wi-Fi de invitados, completa el inicio de sesión en un navegador y luego vuelve a intentarlo
• Si solo está rota la ruta sin streaming a través de tu gateway, establece CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 para desactivar este respaldo, excepto cuando el propio endpoint de streaming devuelve 404, caso en el que Claude Code sigue recurriendo al respaldo

​

Streaming response ended before any complete data was received

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

• Configura cualquier proxy o gateway entre Claude Code y tu proveedor de modelos para que deje pasar sin modificar los cuerpos de las respuestas en streaming y sus encabezados
• En Amazon Bedrock, consulta Errores de streaming detrás de un gateway o proxy para conocer los requisitos de encabezados y cuerpo

​

La respuesta en streaming de Bedrock tiene un content-type inesperado

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

• Configura el gateway para que deje pasar sin modificar el cuerpo de la respuesta de InvokeModelWithResponseStream y su encabezado Content-Type. Un intermediario que reemite el stream como eventos enviados por el servidor es una causa común.
• Establecer CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 oculta este error, pero Claude Code no decodifica un cuerpo binario con un encabezado reescrito, por lo que esas solicitudes recurren a una ruta más lenta sin streaming. Consulta Errores de streaming detrás de un gateway o proxy.

​

Errores de certificado SSL

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

• Exporta el paquete de CA de tu organización y apunta Claude Code a él con NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Consulta Configuración de red para ver las instrucciones de configuración completas
• No establezcas NODE_TLS_REJECT_UNAUTHORIZED=0, que desactiva por completo la validación de certificados

​

Host no permitido en una sesión en la nube

HTTP 403
x-deny-reason: host_not_allowed

• Abre tu entorno para editarlo, ya sea desde el formulario de la rutina o desde el selector de entornos donde inicias sesiones en la nube.
• En el diálogo Edit cloud environment, cambia Network access de Trusted a Custom y luego agrega el dominio bloqueado a Allowed domains. Ingresa un dominio por línea. Marca Also include default list of common package managers para conservar la lista de permitidos predeterminada junto con tus dominios personalizados. Selecciona Full en su lugar si quieres acceso sin restricciones.
• Haz clic en Save changes. La siguiente ejecución usa la lista de permitidos actualizada. Para una sesión en la nube que ya está abierta, consulta cuándo llega un cambio de acceso a la red a las sesiones existentes.

​

The proxy refused the connection

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

• HTTP 407: el proxy requiere credenciales que no recibió. Inclúyelas en la URL del proxy, como muestra Autenticación básica.
• HTTP 403: el proxy se niega a abrir un túnel hacia *.frame.claudeusercontent.com. Pide a quien administra el proxy que permita ese host, que figura en Requisitos de acceso a la red.
• Cualquier otro estado, como HTTP 502: el proxy no abrió el túnel por un motivo propio, como no poder alcanzar el host. Busca el estado en los registros del proxy.
• unreadable reply en lugar de un estado: lo que hay en la dirección del proxy no respondió con una línea de estado HTTP. Verifica que la dirección corresponda a un proxy HTTP.

• Revisa la dirección y las credenciales en la variable de proxy, como se describe en Configuración de proxy, y luego ejecuta curl -x http://proxy.example.com:8080 -I https://api.anthropic.com desde el shell en el que inicias Claude Code, usando tu propia URL de proxy. En Windows PowerShell, ejecuta curl.exe. Si esta prueba falla de la misma manera, corrige primero la configuración del proxy. Si tiene éxito, el rechazo es específico del host del artefacto.
• Si tu red permite que Claude Code alcance el host del artefacto directamente, agrega .frame.claudeusercontent.com a NO_PROXY. Mantén la entrada así de acotada: una entrada más amplia como .claudeusercontent.com también omite el proxy para bridge.claudeusercontent.com, que las organizaciones con listas de IP permitidas necesitan mantener en el proxy.

​

El servicio de entornos en la nube devolvió una respuesta vacía o inesperada

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

• Vuelve a intentar la acción. Claude Code solicita la lista de nuevo cada vez
• Si el mensaje sigue apareciendo, consulta status.claude.com para ver si hay incidentes activos

​

Failed to fetch session from Sessions API

Failed to fetch session from Sessions API: Failed to fetch session logs

• Ejecuta el mismo teleport de nuevo. Si falla de la misma manera, reporta el problema

​

Couldn’t reconnect to your Remote Control session

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

• Ejecuta /remote-control para reintentar la conexión
• Inicia una nueva sesión con claude --remote-control para crear una nueva sesión de Remote Control
• Para otros mensajes de inicio de Remote Control, consulta Solución de problemas de Remote Control

​

Sessions ended while this machine was offline

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

• Cuando Claude Code enumere worktrees conservados debajo de este mensaje, recupera de ellos cualquier trabajo sin confirmar
• Ejecuta claude remote-control para iniciar un entorno nuevo

​

Couldn’t share the transcript

Couldn't share the transcript.

• Ejecuta /feedback para enviar la transcripción con una descripción de lo que sucedió. Consulta Reportar un error si /feedback no está disponible en tu entorno
• Si otras solicitudes también están fallando, revisa tu conexión de red y consulta Unable to connect to API

​

Couldn’t send feedback

Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

• : not signed in. Run /login, then retry.: el diálogo solo sube el informe cuando Claude Code encontró credenciales de Anthropic al abrirse, y ninguna era utilizable en el momento del envío. Por ejemplo, cerraste sesión en esta máquina mientras tanto, o ya no se pudo renovar tu inicio de sesión.
• Un paréntesis: (server returned <status>) es el código de respuesta del servicio; (request timed out) y (couldn't reach the service) son fallos de red. Cuando Claude Code no puede indicar un motivo, no aparece el paréntesis.

• Si el mensaje indica que no iniciaste sesión, ejecuta /login y vuelve a enviar
• De lo contrario, vuelve a enviar; si otras solicitudes también están fallando, revisa tu conexión de red y consulta Unable to connect to API
• Si sigue fallando, presenta el informe en github.com/anthropics/claude-code/issues, como indica el mensaje

​

Errores de solicitud

​

El prompt es demasiado largo

Prompt is too long

Context limit reached · /compact or /clear to continue

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

Prompt is too long · automatic compaction failed: <the underlying error>

• Cuando no puede resumir ningún intercambio completo, Claude Code conserva tu prompt más reciente palabra por palabra y resume todo lo anterior.
• En ese caso, cuando la conversación no termina con tu prompt, Claude Code resume toda la conversación en su lugar.

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

• Ejecuta /compact para resumir los turnos anteriores y liberar espacio, o /clear para empezar de nuevo. Si /compact responde Not enough messages to compact., la conversación es un solo intercambio sin nada anterior que resumir, así que el espacio lo ocupan ese único prompt y lo que Claude Code envía con cada solicitud: ejecuta /clear y vuelve a enviarlo con menos texto pegado o adjuntos más pequeños, o reduce las definiciones de herramientas y los archivos de memoria siguiendo los pasos a continuación
• Ejecuta /context para ver un desglose de lo que está consumiendo la ventana: prompt del sistema, herramientas, archivos de memoria y mensajes
• Desactiva los servidores MCP que no estés usando con /mcp disable <name> para quitar sus definiciones de herramientas del contexto
• Recorta los archivos de memoria CLAUDE.md grandes, o mueve las instrucciones a reglas limitadas a rutas que se carguen solo cuando sean relevantes
• La compactación automática está activada de forma predeterminada y normalmente evita este error. Si la desactivaste en /config o con DISABLE_AUTO_COMPACT, vuelve a activarla. Si la mantienes desactivada, ejecuta /compact tú mismo antes de que se llene la ventana.
• Si el error aparece cerca de 200K tokens en un modelo que acepta más, una causa es un ID de modelo que Claude Code no reconoce. Claude Code asume una ventana de 200K para ese ID, así que para seguir trabajando más allá de ese punto, indícale la ventana de contexto real del modelo.

​

El contexto supera el límite de tokens

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

• En una conversación de varios turnos, ejecuta /compact para resumir los turnos anteriores y liberar espacio. Para empezar de nuevo, ejecuta /clear
• Para conocer más formas de reducir el uso, consulta El prompt es demasiado largo

​

Solicitud demasiado grande

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: las imágenes o documentos hicieron que la solicitud superara el límite. Claude Code reintenta sin ellos.
• Request too large for the API's 32MB request limit: los mensajes por sí solos superan el límite, así que el mensaje dice compacting cannot make it fit y Claude Code no reintenta. En modo no interactivo, el mensaje te indica que reduzcas la entrada o que inicies una nueva sesión.

• Si el mensaje dice compacting cannot make it fit, presiona Esc dos veces para retroceder antes del turno que agregó el contenido grande, o ejecuta /clear para empezar de nuevo
• De lo contrario, ejecuta /compact, que elimina las imágenes y los adjuntos acumulados
• Haz referencia a los archivos grandes por su ruta en lugar de pegar su contenido, para que Claude pueda leerlos por fragmentos
• Para imágenes, consulta La imagen era demasiado grande a continuación

​

La imagen era demasiado grande

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
API Error: an image in the conversation could not be processed and was removed.

• Antes de v2.1.299, en una conversación larga con muchas imágenes, Claude Code podía quitar las últimas imágenes que adjuntaste en lugar de la que superaba el límite. La línea was removed se repetía entonces en cada turno, y Claude no veía tus imágenes nuevas.
• Antes de v2.1.299, en VS Code, la app de Desktop y el Agent SDK, las imágenes que adjuntabas mientras Claude estaba trabajando no recibían el redimensionamiento que reciben otras imágenes adjuntas. Llegaban a la API en su tamaño original, lo que provocaba errores de imagen repetidos en conversaciones largas.
• Antes de v2.1.166, una imagen pegada podía permanecer en la conversación, y el mismo error se repetía entonces en cada mensaje posterior

• Cambia el tamaño de la imagen antes de pegarla. La API acepta imágenes de hasta 8000 píxeles en el lado más largo para una sola imagen, o 3000 píxeles cuando hay más de 20 imágenes en el contexto.
• Toma una captura de pantalla más ajustada de la región relevante en lugar de la pantalla completa

​

No se pudo cambiar el tamaño de la imagen

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

• Si el mensaje te pide que conviertas la imagen, conviértela a PNG, JPEG, GIF o WebP y vuelve a adjuntarla. Claude Code puede verificar las dimensiones de estos formatos a partir del encabezado del archivo, sin decodificar la imagen.
• Si el mensaje reporta un límite de dimensiones o de tamaño, redimensiona o vuelve a comprimir la imagen por debajo de ese límite antes de adjuntarla.
• Si el mensaje nombra una causa, como un JPEG CMYK, un WebP animado o un archivo posiblemente dañado, vuelve a guardar la imagen en el formato que sugiere el mensaje y adjúntala de nuevo.

​

Request rejected as unprocessable by the model

API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)

• Si el mensaje sigue apareciendo en una conversación con imágenes o documentos, quítalos tú mismo. Presiona Esc dos veces para retroceder antes de los turnos que los agregaron, o ejecuta /clear para empezar de cero.

​

Errores de PDF

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

• Para PDF demasiado grandes, pídele a Claude que lea un rango de páginas con la herramienta Read en lugar de adjuntar el archivo completo, o extrae el texto con una herramienta como pdftotext y haz referencia al archivo de salida por su ruta
• Para PDF protegidos o no válidos, quita la contraseña o vuelve a exportar el archivo desde su aplicación de origen, y luego inténtalo de nuevo