41| `Auto mode classifier transcript exceeded context window` | [Errores del servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |41| `Auto mode classifier transcript exceeded context window` | [Errores del servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |
42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Errores del servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |42| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Errores del servidor](#auto-mode-cannot-determine-the-safety-of-an-action) |
43| `The server-side auto mode classifier gave no verdict` | [Errores del servidor](#the-server-returned-no-safety-verdict) |43| `The server-side auto mode classifier gave no verdict` | [Errores del servidor](#the-server-returned-no-safety-verdict) |
44| `<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier` | [Errores del servidor](#was-not-reviewed-and-did-not-run) |
44| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Errores del servidor](#the-server-returned-no-safety-verdict) |45| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [Errores del servidor](#the-server-returned-no-safety-verdict) |
45| `Agent terminated early due to an API error` | [Errores del servidor](#agent-terminated-early-due-to-an-api-error) |46| `Agent terminated early due to an API error` | [Errores del servidor](#agent-terminated-early-due-to-an-api-error) |
46| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Límites de uso](#youve-hit-your-session-limit) |47| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Límites de uso](#youve-hit-your-session-limit) |
471| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/es/env-vars) | sin establecer | Tiempo máximo en milisegundos que cada solicitud a la API pasa esperando a que se resuelvan los errores `429` y `529` cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido. Si no está establecido, la espera no tiene límite. Requiere Claude Code v2.1.295 o posterior. |472| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/es/env-vars) | sin establecer | Tiempo máximo en milisegundos que cada solicitud a la API pasa esperando a que se resuelvan los errores `429` y `529` cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido. Si no está establecido, la espera no tiene límite. Requiere Claude Code v2.1.295 o posterior. |
472| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/es/env-vars) | 500 | Retraso inicial en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 32000, para distribuir los reintentos en un período más largo cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](/docs/es/fast-mode#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |473| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/es/env-vars) | 500 | Retraso inicial en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 32000, para distribuir los reintentos en un período más largo cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](/docs/es/fast-mode#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |
473| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/es/env-vars) | 32000 | Límite máximo en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 64000, para que los reintentos posteriores sigan espaciándose cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](/docs/es/fast-mode#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior. |474| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/es/env-vars) | 32000 | Límite máximo en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 64000, para que los reintentos posteriores sigan espaciándose cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](/docs/es/fast-mode#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior. |
474| [`API_TIMEOUT_MS`](/docs/es/env-vars) | 600000 | Tiempo de espera por solicitud en milisegundos. Auméntalo para redes lentas o proxies. También limita cuánto tiempo espera Claude Code los encabezados de respuesta, como se describe en [No response from API](#no-response-from-api). |475| [`API_TIMEOUT_MS`](/docs/es/env-vars) | 600000 | Tiempo en milisegundos que tiene cada intento de solicitud para recibir sus encabezados de respuesta. No limita cuánto dura una respuesta en streaming después de eso. Auméntalo para redes lentas o proxies. Para saber cómo limita el plazo del primer byte, consulta [No response from API](#no-response-from-api). |
475| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/es/env-vars) | sin establecer | Límite de reenvíos de una [solicitud sin streaming](#streaming-response-ended-before-any-complete-data-was-received) cuyo tiempo de espera se agota. Al alcanzar el límite, la solicitud falla. Una respuesta de Claude que tarda en generarse más que el tiempo de espera vuelve a agotar el tiempo de espera en cada reenvío, así que establece un número bajo, como `0`, para que falle antes. El tiempo de espera de cada intento sin streaming se agota después de 300 segundos en una sesión local, o después de `API_TIMEOUT_MS` cuando estableces un valor positivo. Requiere Claude Code v2.1.285 o posterior. |476| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/es/env-vars) | sin establecer | Límite de reenvíos de una [solicitud sin streaming](#streaming-response-ended-before-any-complete-data-was-received) cuyo tiempo de espera se agota. Al alcanzar el límite, la solicitud falla. Una respuesta de Claude que tarda en generarse más que el tiempo de espera vuelve a agotar el tiempo de espera en cada reenvío, así que establece un número bajo, como `0`, para que falle antes. El tiempo de espera de cada intento sin streaming se agota después de 300 segundos en una sesión local, o después de `API_TIMEOUT_MS` cuando estableces un valor positivo. Requiere Claude Code v2.1.285 o posterior. |
476| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/es/env-vars) | sin establecer | Plazo en milisegundos para el primer byte de respuesta de una solicitud en streaming. Requiere Claude Code v2.1.242 o posterior. Para saber cómo elige Claude Code el plazo cuando esta variable no está establecida, consulta [No response from API](#no-response-from-api). |477| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/es/env-vars) | sin establecer | Plazo en milisegundos para el primer byte de respuesta de una solicitud en streaming. Requiere Claude Code v2.1.242 o posterior. Para saber cómo elige Claude Code el plazo cuando esta variable no está establecida, consulta [No response from API](#no-response-from-api). |
477 478
535Request timed out536Request timed out
536```537```
537 538
538Esto puede ocurrir durante períodos de alta carga o cuando el modelo está generando una respuesta muy grande. El tiempo de espera predeterminado de la solicitud es de 10 minutos.539El tiempo de espera predeterminado de la solicitud es de 10 minutos.
539 540
540**Qué hacer:**541**Qué hacer:**
541 542
627<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.628<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
628```629```
629 630
630En una sesión interactiva, aparece una fila atenuada `Not run · auto mode's check had no usable answer` debajo de la llamada a herramienta en lugar de este mensaje. Presiona `Ctrl+O` para leer el mensaje en el [visor de transcripciones](/docs/es/interactive-mode#transcript-viewer). Las denegaciones descritas en [The server returned no safety verdict](#the-server-returned-no-safety-verdict) muestran la misma fila. Antes de v2.1.296, el mensaje aparecía debajo de la llamada como un error en rojo.631En una sesión interactiva, aparece una fila atenuada `Not run · auto mode's check had no usable answer` debajo de la llamada a herramienta en lugar de este mensaje. Presiona `Ctrl+O` para leer el mensaje en el [visor de transcripciones](/docs/es/interactive-mode#transcript-viewer). Las denegaciones `gave no verdict` descritas en [The server returned no safety verdict](#the-server-returned-no-safety-verdict) muestran la misma fila. Antes de v2.1.296, el mensaje aparecía debajo de la llamada como un error en rojo.
631 632
632Cuando Claude Code puede determinar la categoría del fallo, la nombra entre paréntesis después de `temporarily unavailable`, por ejemplo `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Las categorías son `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` y `(connection failed)`. Si `(timed out)` o `(connection failed)` se repite, revisa tu conexión; consulta [Unable to connect to API](#unable-to-connect-to-api). Antes de v2.1.229, el mensaje nunca nombraba una categoría y decía `Wait briefly and then try this action again`.633Cuando Claude Code puede determinar la categoría del fallo, la nombra entre paréntesis después de `temporarily unavailable`, por ejemplo `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Las categorías son `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` y `(connection failed)`. Si `(timed out)` o `(connection failed)` se repite, revisa tu conexión; consulta [Unable to connect to API](#unable-to-connect-to-api). Antes de v2.1.229, el mensaje nunca nombraba una categoría y decía `Wait briefly and then try this action again`.
633 634
638* 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](/docs/es/permission-modes#eliminate-prompts-with-auto-mode); no necesitas cambiar la configuración639* 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](/docs/es/permission-modes#eliminate-prompts-with-auto-mode); no necesitas cambiar la configuración
639* Si los reintentos siguen fallando, continúa con tareas de solo lectura y vuelve más tarde a la acción bloqueada640* Si los reintentos siguen fallando, continúa con tareas de solo lectura y vuelve más tarde a la acción bloqueada
640* 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](/docs/es/amazon-bedrock#iam-configuration) permite invocarlo; para los IDs de modelo de Mantle, [contacta al equipo de tu cuenta de AWS](/docs/es/amazon-bedrock#mantle-endpoint-errors)641* 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](/docs/es/amazon-bedrock#iam-configuration) permite invocarlo; para los IDs de modelo de Mantle, [contacta al equipo de tu cuenta de AWS](/docs/es/amazon-bedrock#mantle-endpoint-errors)
642* Si el mensaje reaparece en cada reintento y nombra el modelo que estableciste en [`CLAUDE_CODE_AUTO_MODE_MODEL`](/docs/es/permission-modes#choose-the-classifier-model), comprueba que la API o el proveedor de nube en el que se ejecuta tu sesión ofrezca ese ID de modelo. Si no lo ofrece, establece la variable en un ID de modelo que sí ofrezca, o elimina la variable para usar el [modelo clasificador predeterminado](/docs/es/permission-modes#default-classifier-model).
641 643
642Cuando una solicitud al clasificador falla porque tu token de OAuth expiró o fue rotado por otra sesión, Claude Code actualiza el token y reintenta la solicitud una vez, así que una expiración habitual del token no aparece como este mensaje. Antes de v2.1.216, un token expirado o rotado hacía fallar cada solicitud al clasificador, y el modo automático denegaba cada acción verificada con este mensaje hasta que se actualizaba el token.644Cuando una solicitud al clasificador falla porque tu token de OAuth expiró o fue rotado por otra sesión, Claude Code actualiza el token y reintenta la solicitud una vez, así que una expiración habitual del token no aparece como este mensaje. Antes de v2.1.216, un token expirado o rotado hacía fallar cada solicitud al clasificador, y el modo automático denegaba cada acción verificada con este mensaje hasta que se actualizaba el token.
643 645
672* En una sesión interactiva, cambia a otro [modo de permisos](/docs/es/permission-modes) para poder aprobar la acción cuando se te solicite674* En una sesión interactiva, cambia a otro [modo de permisos](/docs/es/permission-modes) para poder aprobar la acción cuando se te solicite
673* Inicia una conversación nueva sin el contenido que activa el filtro675* Inicia una conversación nueva sin el contenido que activa el filtro
674 676
675Cuando la conversación superó el tamaño de la ventana de contexto del clasificador:677Cuando la conversación es demasiado larga para la solicitud al clasificador de Claude Code y Claude Code no puede [compactarla por su cuenta](#was-not-reviewed-and-did-not-run):
676 678
677```text theme={null}679```text theme={null}
678Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)680Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
715 717
716**Qué hacer:**718**Qué hacer:**
717 719
720* En una sesión interactiva, presiona `Ctrl+O` para leer el texto de la denegación en el [visor de transcripciones](/docs/es/interactive-mode#transcript-viewer).
721* Si la denegación nombra `(the conversation is too long for the check)`, ejecuta `/compact` en el prompt de Claude Code para acortar la conversación. Hasta que la conversación sea más corta, enviar otro mensaje produce la misma denegación. Si desactivaste la [compactación automática](/docs/es/settings-reference#autocompactenabled), vuelve a activarla para que Claude Code compacte por su cuenta la próxima vez.
718* Envía otro mensaje para que Claude lo intente de nuevo. El recuento de respuestas se reinicia.722* Envía otro mensaje para que Claude lo intente de nuevo. El recuento de respuestas se reinicia.
719* Si la detención se repite y tus solicitudes pasan por un [gateway de LLM o proxy](/docs/es/llm-gateway), comprueba si corta las respuestas en streaming o las reescribe. [Revisión del clasificador en el servidor](/docs/es/permission-modes#server-side-classifier-review) indica qué comportamiento del gateway causa denegaciones, y la [guía de compatibilidad de gateways](/docs/es/llm-gateway-protocol#feature-pass-through) enumera lo que debe pasar sin cambios.723* Si la detención se repite y tus solicitudes pasan por un [gateway de LLM o proxy](/docs/es/llm-gateway), comprueba si corta las respuestas en streaming o las reescribe. [Revisión del clasificador en el servidor](/docs/es/permission-modes#server-side-classifier-review) indica qué comportamiento del gateway causa denegaciones, y la [guía de compatibilidad de gateways](/docs/es/llm-gateway-protocol#feature-pass-through) enumera lo que debe pasar sin cambios.
720* 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.724* 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.
722 726
723Antes de v2.1.280, Claude Code denegaba de inmediato cada acción de una respuesta sin veredicto y nunca detenía el turno.727Antes de v2.1.280, Claude Code denegaba de inmediato cada acción de una respuesta sin veredicto y nunca detenía el turno.
724 728
729Antes de v2.1.302, en una conexión directa a la API de Anthropic, Claude Code no compactaba una conversación que se había vuelto demasiado larga para la verificación del servidor.
730
731<h3 id="was-not-reviewed-and-did-not-run">
732 Was not reviewed and did not run
733</h3>
734
735Una denegación `was not reviewed and did not run` significa que la conversación es demasiado larga para que el clasificador del [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) verifique la acción, así que la acción no se ejecutó. Claude Code le devuelve este mensaje a Claude:
736
737```text theme={null}
738<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.
739```
740
741Si la compactación falla, las acciones posteriores que el clasificador no puede verificar reciben uno de otros dos mensajes:
742
743* Una denegación [`gave no verdict (the conversation is too long for the check)`](#the-server-returned-no-safety-verdict)
744* El mensaje [`Auto mode classifier transcript exceeded context window`](#auto-mode-cannot-determine-the-safety-of-an-action)
745
746**Qué hacer:**
747
748* Si la compactación que anuncia el mensaje tiene éxito, no necesitas hacer nada.
749* Si ves cualquiera de esos dos mensajes, ejecuta `/compact` en el prompt de Claude Code para acortar la conversación tú mismo. Si desactivaste la [compactación automática](/docs/es/settings-reference#autocompactenabled), vuelve a activarla para que Claude Code compacte por su cuenta la próxima vez.
750
725<h3 id="agent-terminated-early-due-to-an-api-error">751<h3 id="agent-terminated-early-due-to-an-api-error">
726 Agent terminated early due to an API error752 Agent terminated early due to an API error
727</h3>753</h3>
4509 Errores de herramientas4535 Errores de herramientas
4510</h2>4536</h2>
4511 4537
4512Estos errores provienen de las llamadas a herramientas de Claude. Claude corrige la mayoría de los errores de herramientas por sí solo. Cuando uno requiere un cambio de tu parte, la lista **Qué hacer** de ese error indica qué cambiar.4538Estos errores provienen de las llamadas a herramientas de Claude. Claude corrige por sí solo la mayoría de los errores de herramientas. Cuando alguno necesita un cambio de tu parte, la lista **Qué hacer** de ese error indica qué debes cambiar.
4513 4539
4514<h3 id="no-such-tool-available">4540<h3 id="no-such-tool-available">
4515 No such tool available4541 No such tool available
4516</h3>4542</h3>
4517 4543
4518Claude llamó a una herramienta con un nombre que no está en la lista de herramientas de la sesión. Claude Code devuelve el error a Claude como resultado de la llamada a herramienta, y el turno continúa. Cuando Claude Code puede determinar por qué falta la herramienta, agrega una oración después del nombre de la herramienta que da la razón o nombra la herramienta a la que debe llamar en su lugar, como en la segunda línea:4544Claude llamó a una herramienta con un nombre que no está en la lista de herramientas de la sesión. Claude Code devuelve el error a Claude como resultado de la llamada a herramienta, y el turno continúa. Cuando Claude Code puede determinar por qué falta la herramienta, agrega una oración después del nombre de la herramienta que da el motivo o nombra la herramienta que se debe llamar en su lugar, como en la segunda línea:
4519 4545
4520```text theme={null}4546```text theme={null}
4521Error: No such tool available: <tool name>4547Error: No such tool available: <tool name>
4522Error: No such tool available: read. Tool names are case-sensitive: call Read instead.4548Error: No such tool available: read. Tool names are case-sensitive: call Read instead.
4523```4549```
4524 4550
4525Justo después de reanudar una sesión, un servidor MCP todavía puede estar en su primer intento de conexión cuando Claude llama a una de sus herramientas. Claude Code entonces [espera al servidor](/docs/es/mcp#tool-availability) y devuelve este error si la herramienta aún no está disponible cuando termina la espera. Antes de v2.1.284, una llamada así fallaba de inmediato en lugar de esperar.4551Justo después de reanudar una sesión, un servidor MCP puede seguir en su primer intento de conexión cuando Claude llama a una de sus herramientas. En ese caso, Claude Code [espera al servidor](/docs/es/mcp#tool-availability) y devuelve este error si la herramienta sigue sin estar disponible cuando termina la espera. Antes de la v2.1.284, una llamada así fallaba de inmediato en lugar de esperar.
4526 4552
4527Una llamada cuyo nombre de herramienta Claude Code [recortó a 200 caracteres](#tool-use-name-over-200-characters) también falla con este error.4553Una llamada cuyo nombre de herramienta Claude Code [recortó a 200 caracteres](#tool-use-name-over-200-characters) también falla con este error.
4528 4554
4529**Qué hacer:**4555**Qué hacer:**
4530 4556
4531* Si ocurre una vez, no necesitas hacer nada. Claude lee el error y el turno continúa.4557* Si ocurre una vez, no necesitas hacer nada. Claude lee el error y el turno continúa.
4532* Si las llamadas a las herramientas de un servidor MCP siguen fallando con este error, ejecuta `/mcp` en la sesión o `claude mcp list` en tu shell para revisar el [estado](/docs/es/mcp#server-status) del servidor, y vuelve a conectar un servidor fallido desde `/mcp`. En el Agent SDK, consulta [Manejo de errores](/docs/es/agent-sdk/mcp#error-handling).4558* Si las llamadas a las herramientas de un servidor MCP siguen fallando con este error, ejecuta `/mcp` en la sesión o `claude mcp list` en tu shell para revisar el [estado](/docs/es/mcp#server-status) del servidor, y vuelve a conectar un servidor con fallas desde `/mcp`. En el Agent SDK, consulta [Manejo de errores](/docs/es/agent-sdk/mcp#error-handling).
4533 4559
4534<h3 id="agent-would-be-spawned-with-zero-tools">4560<h3 id="agent-would-be-spawned-with-zero-tools">
4535 Agent would be spawned with zero tools4561 Agent would be spawned with zero tools
4536</h3>4562</h3>
4537 4563
4538Cada entrada en la lista [`tools` del subagente](/docs/es/sub-agents#supported-frontmatter-fields) no coincidió con ninguna herramienta utilizable, por lo que Claude Code se negó a lanzar el subagente: sin herramientas, no podía actuar. El mensaje agrupa tus entradas por lo que salió mal:4564Ninguna entrada de la [lista `tools`](/docs/es/sub-agents#supported-frontmatter-fields) del subagente coincidió con una herramienta utilizable, así que Claude Code se negó a iniciar el subagente: sin herramientas, no podría actuar. El mensaje agrupa tus entradas según lo que salió mal:
4539 4565
4540* **Unrecognized**: la entrada no coincide con ningún nombre de herramienta, generalmente un error tipográfico como `Grpe` para `Grep`.4566* **Unrecognized**: la entrada no coincide con ningún nombre de herramienta, normalmente por un error tipográfico como `Grpe` en lugar de `Grep`.
4541* **Not available to subagents**: la entrada nombra una herramienta real que [los subagentes no pueden usar](/docs/es/sub-agents#available-tools). Los subagentes en segundo plano mantienen un conjunto de herramientas integradas más pequeño, por lo que una entrada que solo un subagente en primer plano puede usar termina aquí cuando el subagente se ejecutaría en segundo plano, que es lo predeterminado. Si enumeras `Agent`, el mensaje lo reporta bajo el siguiente grupo en su lugar.4567* **Not available to subagents**: la entrada nombra una herramienta real que [los subagentes no pueden usar](/docs/es/sub-agents#available-tools). Los subagentes en segundo plano conservan un conjunto más reducido de herramientas integradas, así que una entrada que solo puede usar un subagente en primer plano cae aquí cuando el subagente se ejecutaría en segundo plano, que es el comportamiento predeterminado. Si incluyes `Agent`, el mensaje lo reporta en el siguiente grupo.
4542* **Matched no tools in this session**: la entrada es válida pero ninguna herramienta en la sesión actual coincide con ella en este momento, como `mcp__github__*` sin servidor MCP de GitHub conectado, o `Agent` para un subagente en el [límite de profundidad](/docs/es/sub-agents#let-subagents-spawn-their-own-subagents).4568* **Matched no tools in this session**: la entrada es válida, pero ninguna herramienta de la sesión actual coincide con ella en este momento, como `mcp__github__*` sin un servidor MCP de GitHub conectado, o `Agent` para un subagente que está en el [límite de profundidad](/docs/es/sub-agents#let-subagents-spawn-their-own-subagents).
4543 4569
4544Omitir el campo `tools` nunca activa este rechazo. Si dejas la lista `tools` vacía, o `disallowedTools` elimina cada entrada en ella, Claude Code también omite el rechazo y lanza el subagente sin herramientas.4570Omitir el campo `tools` nunca provoca este rechazo. Si dejas vacía la lista `tools`, o si `disallowedTools` elimina todas sus entradas, Claude Code también omite el rechazo e inicia el subagente sin herramientas.
4545 4571
4546Antes de v2.1.208, el subagente se lanzaba sin herramientas y podía devolver un resultado vacío o confuso.4572Antes de la v2.1.208, el subagente se iniciaba sin herramientas y podía devolver un resultado vacío o confuso.
4547 4573
4548```text theme={null}4574```text theme={null}
4549Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.4575Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
4551 4577
4552**Qué hacer:**4578**Qué hacer:**
4553 4579
4554* Corrige cada entrada que el error nombra contra las [herramientas disponibles para subagentes](/docs/es/sub-agents#available-tools)4580* Corrige cada entrada que nombra el error comparándola con las [herramientas disponibles para subagentes](/docs/es/sub-agents#available-tools)
4555* Elimina entradas para herramientas que la sesión no tiene, como herramientas MCP de un servidor que no está conectado4581* Elimina las entradas de herramientas que la sesión no tiene, como herramientas MCP de un servidor que no está conectado
4556* Si la entrada nombra un servidor MCP conectado, compara la entrada con el nombre de ese servidor tal como lo escriben los [nombres de herramientas](/docs/es/permissions#mcp) del servidor, como `reports__v2` en `mcp__reports__v2__get_totals`. Para ese servidor, escribe `mcp__reports__v2__*`, que es `mcp__` seguido del nombre completo y `__*`. Con el más corto `mcp__reports`, que nombra un servidor llamado `reports`, el subagente no obtiene ninguna de las herramientas de `reports__v2`4582* Si la entrada nombra un servidor MCP conectado, compara la entrada con el nombre de ese servidor tal como lo escriben los [nombres de herramientas](/docs/es/permissions#mcp) del servidor, como `reports__v2` en `mcp__reports__v2__get_totals`. Para ese servidor, escribe `mcp__reports__v2__*`, que es `mcp__` seguido del nombre completo y `__*`. Con el `mcp__reports` más corto, que nombra un servidor llamado `reports`, el subagente no recibe ninguna de las herramientas de `reports__v2`
4557* Para una herramienta que [los subagentes en segundo plano descartan](/docs/es/sub-agents#available-tools), como `CronCreate`, elimina la entrada. Para mantener la herramienta, [desactiva el modo fork](/docs/es/sub-agents#turn-fork-mode-on-or-off) y pide a Claude que ejecute el subagente en primer plano4583* Para una herramienta que [los subagentes en segundo plano descartan](/docs/es/sub-agents#available-tools), como `CronCreate`, elimina la entrada
4558* Elimina el campo `tools` en lugar de enumerar herramientas para dar al subagente cada [herramienta disponible para subagentes](/docs/es/sub-agents#available-tools)4584* Para conservar en cambio una herramienta como `CronCreate`, [deja que Claude espere al subagente](/docs/es/sub-agents#let-claude-wait-for-a-subagent), ya que un subagente al que Claude espera se ejecuta en primer plano y conserva la herramienta. Si la definición establece `background: true`, elimina primero ese campo, porque mantiene al subagente en segundo plano
4559* Para una lista `tools` que contiene solo `Agent`, aumenta el [límite de profundidad](/docs/es/sub-agents#let-subagents-spawn-their-own-subagents) o da al agente al menos otra herramienta: Claude Code retiene `Agent` en ese límite, por lo que una lista sin nada más en ella se resuelve a ninguna herramienta4585* Elimina el campo `tools` en lugar de listar herramientas para darle al subagente todas las [herramientas disponibles para subagentes](/docs/es/sub-agents#available-tools)
4586* Para una lista `tools` que contiene solo `Agent`, aumenta el [límite de profundidad](/docs/es/sub-agents#let-subagents-spawn-their-own-subagents) o dale al agente al menos otra herramienta: Claude Code no proporciona `Agent` en ese límite, así que una lista sin nada más se resuelve en ninguna herramienta
4560 4587
4561<h3 id="file-is-covered-by-a-read-deny-rule">4588<h3 id="file-is-covered-by-a-read-deny-rule">
4562 File is covered by a Read deny rule4589 File is covered by a Read deny rule
4563</h3>4590</h3>
4564 4591
4565La herramienta Edit o Write fue llamada en una ruta coincidida por una [regla de denegación `Read`](/docs/es/permissions#read-and-edit), incluyendo la creación de un nuevo archivo en esa ruta. Ambas herramientas cambian contenido que Claude debe poder leer de nuevo, por lo que Claude Code rechaza la llamada antes de cualquier acceso a archivos. NotebookEdit no está cubierto por reglas de denegación `Read`. Antes de v2.1.228, la regla bloqueaba solo la herramienta Edit, y antes de v2.1.208, solo una regla de denegación `Edit` bloqueaba ediciones.4592Se llamó a la herramienta Edit o Write sobre una ruta que coincide con una [regla de denegación de `Read`](/docs/es/permissions#read-and-edit), incluida la creación de un archivo nuevo en esa ruta. Ambas herramientas modifican contenido que Claude tiene que poder volver a leer, así que Claude Code rechaza la llamada antes de cualquier acceso al archivo. NotebookEdit no está cubierta por las reglas de denegación de `Read`. Antes de la v2.1.228, la regla bloqueaba solo la herramienta Edit, y antes de la v2.1.208, solo una regla de denegación de `Edit` bloqueaba las ediciones.
4566 4593
4567```text theme={null}4594```text theme={null}
4568File is covered by a Read deny rule in your permission settings and cannot be edited.4595File is covered by a Read deny rule in your permission settings and cannot be edited.
4569```4596```
4570 4597
4571Cuando Claude Code rechaza la herramienta Write, el mensaje termina con `and cannot be written` en su lugar.4598Cuando Claude Code rechaza la herramienta Write, el mensaje termina en cambio con `and cannot be written`.
4572 4599
4573**Qué hacer:**4600**Qué hacer:**
4574 4601
4575* Si Claude debe poder cambiar el archivo, elimina o reduce la regla de denegación `Read` en `/permissions` o en la [configuración](/docs/es/settings-reference#permission-settings)4602* Si Claude debería poder modificar el archivo, elimina o restringe la regla de denegación de `Read` en `/permissions` o en la [configuración](/docs/es/settings-reference#permission-settings)
4576* Si el archivo debe permanecer intacto, mantén la regla y agrega una regla de denegación `Edit` para la misma ruta para bloquear también la herramienta NotebookEdit4603* Si el archivo debe permanecer intacto, conserva la regla y agrega una regla de denegación de `Edit` para la misma ruta para bloquear también la herramienta NotebookEdit
4577 4604
4578<h3 id="path-cannot-contain-null-bytes">4605<h3 id="path-cannot-contain-null-bytes">
4579 Path cannot contain null bytes4606 Path cannot contain null bytes
4580</h3>4607</h3>
4581 4608
4582El argumento de ruta o patrón de una llamada a herramienta de archivo contenía un byte nulo, que los sistemas de archivos y las herramientas de búsqueda no pueden aceptar. Read, Write, Edit, NotebookEdit, Glob y Grep verifican esto, y el mensaje nombra la herramienta y el argumento:4609El argumento de ruta o patrón de una llamada a una herramienta de archivos contenía un byte nulo, que los sistemas de archivos y las herramientas de búsqueda no pueden aceptar. Read, Write, Edit, NotebookEdit, Glob y Grep verifican esto, y el mensaje nombra la herramienta y el argumento:
4583 4610
4584```text theme={null}4611```text theme={null}
4585Read file_path cannot contain null bytes (\0). Remove the null byte and try again.4612Read file_path cannot contain null bytes (\0). Remove the null byte and try again.
4586```4613```
4587 4614
4588La llamada a herramienta falla, Claude ve el error, y el turno continúa.4615La llamada a herramienta falla, Claude ve el error y el turno continúa.
4589 4616
4590**Qué hacer:**4617**Qué hacer:**
4591 4618
4592* Nada de tu parte: el error se devuelve a Claude como el resultado de la herramienta, y el mensaje en sí le dice a Claude que elimine el byte nulo e intente de nuevo4619* Nada de tu parte: el error se devuelve a Claude como resultado de la herramienta, y el propio mensaje le indica a Claude que elimine el byte nulo y lo intente de nuevo
4593 4620
4594Antes de v2.1.281, un byte nulo en una ruta de Read, Write, Edit o NotebookEdit terminaba todo el turno con un error que nombraba `Path contains null bytes`, y la herramienta nunca se ejecutaba.4621Antes de la v2.1.281, un byte nulo en una ruta de Read, Write, Edit o NotebookEdit terminaba todo el turno con un error que mencionaba `Path contains null bytes`, y la herramienta nunca se ejecutaba.
4595 4622
4596<h3 id="subagent-type-is-required">4623<h3 id="subagent-type-is-required">
4597 subagent\_type is required4624 subagent\_type is required
4601subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...4628subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
4602```4629```
4603 4630
4604Claude llamó a la [herramienta Agent](/docs/es/tools-reference#agent-tool-behavior) sin un `subagent_type`, y esta sesión no tiene un [subagente de propósito general](/docs/es/sub-agents#built-in-subagents) como alternativa. Ese es el caso en dos configuraciones:4631Claude llamó a la [herramienta Agent](/docs/es/tools-reference#agent-tool-behavior) sin un `subagent_type`, y esta sesión no tiene un [subagente de propósito general](/docs/es/sub-agents#built-in-subagents) al cual recurrir. Ese es el caso en dos configuraciones:
4605 4632
4606* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/es/env-vars) está configurado en modo no interactivo, lo que elimina cada subagente integrado4633* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/es/env-vars) está establecida en modo no interactivo, lo que elimina todos los subagentes integrados
4607* El agente del hilo principal de la sesión tiene una [lista de permitidos `tools: Agent(...)`](/docs/es/sub-agents#restrict-which-subagents-can-be-spawned) que deja fuera `general-purpose`4634* El agente del hilo principal de la sesión tiene una [lista de permitidos `tools: Agent(...)`](/docs/es/sub-agents#restrict-which-subagents-can-be-spawned) que excluye `general-purpose`
4608 4635
4609**Qué hacer:**4636**Qué hacer:**
4610 4637
4611* Generalmente nada: el mensaje enumera los subagentes que la sesión sí tiene, por lo que Claude puede reintentar con uno de ellos4638* Normalmente nada: el mensaje lista los subagentes que sí tiene la sesión, así que Claude puede reintentar con uno de ellos
4612* Si Claude sigue fallando, agrega `general-purpose` a la lista de permitidos `tools: Agent(...)`, o quita la definición de `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`4639* Si Claude sigue fallando, agrega `general-purpose` a la lista de permitidos `tools: Agent(...)`, o elimina `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`
4613 4640
4614Antes de v2.1.235, la misma llamada fallaba con `Agent type 'general-purpose' not found`.4641Antes de la v2.1.235, la misma llamada fallaba con `Agent type 'general-purpose' not found`.
4615 4642
4616<h3 id="memory-index-is-over-its-read-limit">4643<h3 id="memory-index-is-over-its-read-limit">
4617 Memory index is over its read limit4644 Memory index is over its read limit
4618</h3>4645</h3>
4619 4646
4620Claude escribió en el índice de [memoria automática](/docs/es/memory#auto-memory) `MEMORY.md` y lo dejó por encima de uno de sus límites de lectura: 200 líneas o 25KB. La escritura fue exitosa, pero solo las primeras 200 líneas o 25KB, lo que ocurra primero, se cargan al inicio de una sesión, por lo que todo lo que está más allá del límite se descarta cada vez que se lee el índice. Antes de v2.1.210, un índice que excedía el límite se truncaba silenciosamente en la siguiente carga sin ninguna señal al momento de la escritura.4647Claude escribió en el índice de [memoria automática](/docs/es/memory#auto-memory) `MEMORY.md` y lo dejó por encima de uno de sus límites de lectura: 200 líneas o 25KB. La escritura se completó, pero solo las primeras 200 líneas o 25KB, lo que ocurra primero, se cargan al inicio de una sesión, así que todo lo que supera el límite se descarta cada vez que se lee el índice. Antes de la v2.1.210, un índice que superaba el límite se truncaba silenciosamente en la siguiente carga sin ninguna señal al momento de escribir.
4621 4648
4622```text theme={null}4649```text theme={null}
4623Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.4650Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.
4624```4651```
4625 4652
4626Solo el contenido que se carga cuenta para los límites. El frontmatter YAML y los comentarios HTML a nivel de bloque se eliminan antes de que se cargue el índice, por lo que se excluyen de la medición. Antes de v2.1.211, Claude Code medía el archivo sin procesar, y el frontmatter o los comentarios podían activar este error incluso cuando el contenido cargado cabía.4653Solo el contenido que se carga cuenta para los límites. El frontmatter YAML y los comentarios HTML a nivel de bloque se eliminan antes de cargar el índice, así que quedan excluidos de la medición. Antes de la v2.1.211, Claude Code medía el archivo sin procesar, y el frontmatter o los comentarios podían provocar este error incluso cuando el contenido cargado cabía.
4627 4654
4628Claude Code entrega el error a Claude después de la escritura en lugar de imprimirlo como un banner en tu terminal, por lo que puede que solo lo notes en la transcripción.4655Claude Code entrega el error a Claude después de la escritura en lugar de mostrarlo como un aviso en tu terminal, así que es posible que solo lo notes en la transcripción.
4629 4656
4630Cuando la escritura de Claude acerca el archivo a un límite sin cruzarlo, Claude Code devuelve un recordatorio más suave para compactar el índice en lugar de este error.4657Cuando la escritura de Claude deja el archivo cerca de un límite sin superarlo, Claude Code devuelve un recordatorio más leve para compactar el índice en lugar de este error.
4631 4658
4632**Qué hacer:**4659**Qué hacer:**
4633 4660
4634* Permite que Claude reescriba `MEMORY.md`, o pídele que lo haga: mantener una línea por entrada, mover los detalles a archivos de tema y combinar o descartar entradas obsoletas4661* Deja que Claude reescriba `MEMORY.md`, o pídeselo: mantener una línea por entrada, mover los detalles a archivos de temas y combinar o eliminar las entradas obsoletas
4635* Para recortar el índice tú mismo, consulta [Auditar y editar tu memoria](/docs/es/memory#audit-and-edit-your-memory)4662* Para recortar el índice tú mismo, consulta [Auditar y editar tu memoria](/docs/es/memory#audit-and-edit-your-memory)
4636 4663
4637<h3 id="pkill-pattern-matches-the-claude-code-process">4664<h3 id="pkill-pattern-matches-the-claude-code-process">
4638 pkill pattern matches the Claude Code process4665 pkill pattern matches the Claude Code process
4639</h3>4666</h3>
4640 4667
4641Un comando `pkill` en una llamada a la herramienta Bash usó un patrón, típicamente con `-f`, que coincide con el propio proceso de Claude Code, por lo que Claude Code rechaza el comando en lugar de permitir que termine la sesión. Claude Code prueba el patrón con `pgrep` antes de ejecutar `pkill` y lo rechaza cuando su propio ID de proceso está en el resultado. La verificación se ejecuta solo en Linux; en macOS, `pkill` se ejecuta sin modificaciones. Antes de v2.1.214, el comando se ejecutaba, y un patrón coincidente mataba la sesión de Claude Code a mitad del turno.4668Un comando `pkill` en una llamada a la herramienta Bash usó un patrón, normalmente con `-f`, que coincide con el propio proceso de Claude Code, así que Claude Code rechaza el comando en lugar de dejar que termine la sesión. Claude Code prueba el patrón con `pgrep` antes de ejecutar `pkill` y lo rechaza cuando su propio ID de proceso aparece en el resultado. La verificación se ejecuta solo en Linux; en macOS, `pkill` se ejecuta sin modificaciones. Antes de la v2.1.214, el comando se ejecutaba, y un patrón coincidente terminaba la sesión de Claude Code a mitad del turno.
4642 4669
4643```text theme={null}4670```text theme={null}
4644pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.4671pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
4645```4672```
4646 4673
4647El rechazo aparece en el resultado de la herramienta Bash en lugar de como un banner en tu terminal, y Claude generalmente ajusta el comando por sí solo.4674El rechazo aparece en el resultado de la herramienta Bash en lugar de como un aviso en tu terminal, y Claude normalmente ajusta el comando por sí solo.
4648 4675
4649**Qué hacer:**4676**Qué hacer:**
4650 4677
4651* Reduce el patrón para que coincida solo con el proceso previsto, por ejemplo la ruta completa del binario de destino en lugar de una subcadena corta4678* Restringe el patrón para que coincida solo con el proceso deseado, por ejemplo la ruta completa del binario objetivo en lugar de una subcadena corta
4652* Para detener procesos iniciados por el shell actual, usa `pkill -P $$` con el patrón, lo que limita la coincidencia a los procesos hijos del propio shell4679* Para detener procesos iniciados por el shell actual, usa `pkill -P $$` con el patrón, lo que limita la coincidencia a los procesos hijos del propio shell
4653 4680
4654<h3 id="failed-to-write-to-a-teammate-inbox">4681<h3 id="failed-to-write-to-a-teammate-inbox">
4655 Failed to write to a teammate's inbox4682 Failed to write to a teammate's inbox
4656</h3>4683</h3>
4657 4684
4658Claude Code no pudo escribir un mensaje en el archivo de buzón de un compañero de equipo bajo `~/.claude/teams/{team-name}/inboxes/`, por lo que el destinatario no recibió nada. La escritura falla cuando Claude Code no puede crear o actualizar el archivo, por ejemplo porque el disco está lleno, el directorio no tiene permisos de escritura, u otro agente mantiene el bloqueo del buzón durante demasiado tiempo. Antes de v2.1.224, Claude Code reportaba el mensaje como enviado incluso cuando la escritura fallaba.4685Claude Code no pudo escribir un mensaje en el archivo de buzón de un compañero de equipo en `~/.claude/teams/{team-name}/inboxes/`, así que el destinatario no recibió nada. La escritura falla cuando Claude Code no puede crear ni actualizar el archivo, por ejemplo porque el disco está lleno, el directorio no admite escritura u otro agente retiene el bloqueo del buzón durante demasiado tiempo. Antes de la v2.1.224, Claude Code reportaba el mensaje como enviado incluso cuando la escritura fallaba.
4659 4686
4660El error aparece en el resultado de la herramienta del agente remitente en lugar de como un banner en tu terminal, y su texto le dice a Claude que intente de nuevo:4687El error aparece en el resultado de la herramienta del agente remitente en lugar de como un aviso en tu terminal, y su texto le indica a Claude que lo intente de nuevo:
4661 4688
4662```text theme={null}4689```text theme={null}
4663Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.4690Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
4664```4691```
4665 4692
4666Los mensajes estructurados del protocolo de [equipo de agentes](/docs/es/agent-teams) fallan de la misma manera, y el error nombra el mensaje no entregado: cuando Claude Code no puede escribir una aprobación de plan, un rechazo de plan, una solicitud de apagado o un rechazo de apagado, el error dice `Failed to write the <message> to <name>'s inbox — nothing was sent`. La `plan approval` en esa lista es la decisión del líder que aprueba el plan de un compañero; el envío del plan del compañero es el mensaje separado `plan approval request`. Ese mensaje y otros dos mensajes de protocolo tienen su propio texto de mensaje y consecuencia:4693Los mensajes de protocolo estructurados del [equipo de agentes](/docs/es/agent-teams) fallan de la misma manera, y el error nombra el mensaje no entregado: cuando Claude Code no puede escribir una aprobación de plan, un rechazo de plan, una solicitud de apagado o un rechazo de apagado, el error dice `Failed to write the <message> to <name>'s inbox — nothing was sent`. El `plan approval` de esa lista es la decisión del líder que aprueba el plan de un compañero de equipo; el envío del plan por parte del compañero es el mensaje separado `plan approval request`. Ese mensaje y otros dos mensajes de protocolo tienen su propio texto y consecuencia:
4667 4694
4668* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: el plan del compañero nunca llegó al líder, y el compañero permanece en modo plan hasta que un reenvío tenga éxito4695* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: el plan del compañero de equipo nunca llegó al líder, y el compañero permanece en modo plan hasta que un nuevo envío tenga éxito
4669* `The permission request could not be delivered to the team lead (mailbox write failed)`: la solicitud de permiso del compañero nunca llegó al líder, por lo que nadie aprobó la llamada a herramienta4696* `The permission request could not be delivered to the team lead (mailbox write failed)`: la solicitud de permiso del compañero de equipo nunca llegó al líder, así que nadie aprobó la llamada a herramienta
4670* `The confirmation could not be written to team-lead's inbox.`: la aprobación del apagado en sí tuvo efecto y el compañero sale; solo falta la confirmación al líder4697* `The confirmation could not be written to team-lead's inbox.`: la aprobación del apagado sí surtió efecto y el compañero de equipo termina; solo falta la confirmación al líder
4671 4698
4672Cuando tú mismo envías un mensaje a un compañero, escribiendo `@name` seguido del mensaje en la sesión del líder, la misma falla aparece como una notificación, `Couldn't write to @name's inbox — message not sent. Try again.`, y Claude Code mantiene tu texto en el cuadro del prompt para que puedas enviarlo de nuevo.4699Cuando tú mismo le envías un mensaje a un compañero de equipo, escribiendo `@name` seguido del mensaje en la sesión del líder, la misma falla aparece como una notificación, `Couldn't write to @name's inbox — message not sent. Try again.`, y Claude Code conserva tu texto en el cuadro del prompt para que puedas enviarlo de nuevo.
4673 4700
4674**Qué hacer:**4701**Qué hacer:**
4675 4702
4676* Pide al remitente que reenvíe el mensaje; la contención por el bloqueo del buzón es transitoria y se resuelve al reintentar4703* Pídele al remitente que vuelva a enviar el mensaje; la contención por el bloqueo del buzón es transitoria y se resuelve al reintentar
4677* Verifica el espacio libre en disco y comprueba que `~/.claude/teams` y los archivos bajo él tengan permisos de escritura para tu usuario4704* Revisa el espacio libre en disco y verifica que tu usuario pueda escribir en `~/.claude/teams` y en los archivos que contiene
4678 4705
4679<h3 id="teammate-agent-definition-not-restored">4706<h3 id="teammate-agent-definition-not-restored">
4680 Teammate's agent definition was not restored4707 Teammate's agent definition was not restored
4681</h3>4708</h3>
4682 4709
4683Claude envió un mensaje a un compañero de [equipo de agentes](/docs/es/agent-teams) detenido, y Claude Code lo reactivó sin volver a aplicar la [definición de subagente](/docs/es/agent-teams#use-subagent-definitions-for-teammates) desde la que fue generado. El aviso sigue al informe de reanudación en el resultado de la herramienta del agente remitente y nombra la razón. Cuando el archivo de definición provenía de una carpeta sin confianza guardada, dice:4710Claude le envió un mensaje a un compañero de [equipo de agentes](/docs/es/agent-teams) detenido, y Claude Code lo reactivó sin volver a aplicar la [definición de subagente](/docs/es/agent-teams#use-subagent-definitions-for-teammates) a partir de la cual se creó. El aviso sigue al reporte de reanudación en el resultado de la herramienta del agente remitente y nombra el motivo. Cuando el archivo de definición proviene de una carpeta sin confianza guardada, dice:
4684 4711
4685```text wrap theme={null}4712```text wrap theme={null}
4686Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.4713Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.
4687```4714```
4688 4715
4689La verificación se aplica a una definición en el directorio `.claude/agents/` del proyecto o de un directorio `--add-dir`, y aceptar el diálogo de confianza para una carpeta principal no la satisface.4716La verificación se aplica a una definición en el directorio `.claude/agents/` del proyecto o de un directorio de `--add-dir`, y aceptar el diálogo de confianza para una carpeta superior no la satisface.
4690 4717
4691**Qué hacer:**4718**Qué hacer:**
4692 4719
4693* Ejecuta `claude` en la carpeta que nombra el [registro de depuración](/docs/es/debug-your-config) y acepta el diálogo de confianza. La definición se vuelve a aplicar la próxima vez que Claude Code reactive al compañero; no necesitas reiniciar la sesión del líder4720* Ejecuta `claude` en la carpeta que nombra el [registro de depuración](/docs/es/debug-your-config) y acepta el diálogo de confianza. La definición se vuelve a aplicar la próxima vez que Claude Code reactive al compañero de equipo; no necesitas reiniciar la sesión del líder
4694* O establece la entrada `hasTrustDialogAccepted` en `true` en `~/.claude.json`, usando la clave exacta `projects["<path>"]` que imprime el registro de depuración4721* O establece la entrada `hasTrustDialogAccepted` en `true` en `~/.claude.json`, usando exactamente la clave `projects["<path>"]` que muestra el registro de depuración
4695 4722
4696<h3 id="message-too-large-for-cross-session-delivery">4723<h3 id="message-too-large-for-cross-session-delivery">
4697 Message too large for cross-session delivery4724 Message too large for cross-session delivery
4698</h3>4725</h3>
4699 4726
4700El [mensaje entre sesiones](/docs/es/cross-session-messaging) de Claude a otra de tus sesiones en esta máquina era demasiado largo para enviarse. Claude Code lo rechazó, y la sesión receptora no recibió nada. El rechazo aparece en el resultado de la herramienta de la sesión remitente, no como un banner en tu terminal. Nombra ambos tamaños y cómo hacer que el mensaje quepa:4727El [mensaje entre sesiones](/docs/es/cross-session-messaging) de Claude a otra de tus sesiones en esta máquina era demasiado largo para enviarse. Claude Code lo rechazó, y la sesión receptora no recibió nada. El rechazo aparece en el resultado de la herramienta de la sesión remitente, no como un aviso en tu terminal. Nombra ambos tamaños y cómo hacer que el mensaje quepa:
4701 4728
4702```text wrap theme={null}4729```text wrap theme={null}
4703Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.4730Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.
4704```4731```
4705 4732
4706Reenviar el mismo texto falla de la misma manera.4733Volver a enviar el mismo texto falla de la misma manera.
4707 4734
4708**Qué hacer:**4735**Qué hacer:**
4709 4736
4710* Pide a Claude que resuma el mensaje, o que ponga el contenido voluminoso en un archivo y envíe la ruta del archivo4737* Pídele a Claude que resuma el mensaje, o que ponga el contenido extenso en un archivo y envíe la ruta del archivo
4711* Pide a Claude que divida el contenido en varios mensajes más cortos4738* Pídele a Claude que divida el contenido en varios mensajes más cortos
4712 4739
4713Antes de v2.1.235, Claude Code reportaba un mensaje de tamaño excesivo como enviado. La sesión receptora lo descartaba sin leerlo.4740Antes de la v2.1.235, Claude Code reportaba un mensaje demasiado grande como enviado. La sesión receptora lo descartaba sin leerlo.
4714 4741
4715<h3 id="too-many-messages-to-this-session-just-now">4742<h3 id="too-many-messages-to-this-session-just-now">
4716 Too many messages to this session just now4743 Too many messages to this session just now
4717</h3>4744</h3>
4718 4745
4719Claude envió una ráfaga rápida de [mensajes entre sesiones](/docs/es/cross-session-messaging) a una de tus sesiones en esta máquina, y la ráfaga alcanzó lo que la bandeja de entrada de esa sesión acepta. Claude Code rechazó el siguiente envío, y la sesión receptora no recibió nada de él. El rechazo aparece en el resultado de la herramienta de la sesión remitente, no como un banner en tu terminal:4746Claude envió una ráfaga rápida de [mensajes entre sesiones](/docs/es/cross-session-messaging) a una de tus sesiones en esta máquina, y la ráfaga alcanzó lo que acepta el buzón de esa sesión. Claude Code rechazó el siguiente envío, y la sesión receptora no recibió nada de él. El rechazo aparece en el resultado de la herramienta de la sesión remitente, no como un aviso en tu terminal:
4720 4747
4721```text wrap theme={null}4748```text wrap theme={null}
4722Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.4749Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.
4724 4751
4725**Qué hacer:**4752**Qué hacer:**
4726 4753
4727* Generalmente nada: Claude agrupa el contenido restante en un mensaje, o espera antes de enviar más4754* Normalmente nada: Claude agrupa el contenido restante en un solo mensaje, o espera antes de enviar más
4728* Si tú mismo provocaste la ráfaga, pide a Claude que combine lo que queda en un único mensaje4755* Si tú mismo provocaste la ráfaga, pídele a Claude que combine lo que queda en un solo mensaje
4729 4756
4730Antes de v2.1.236, Claude Code reportaba estos envíos como enviados. La sesión receptora los descartaba sin leerlos.4757Antes de la v2.1.236, Claude Code reportaba estos envíos como enviados. La sesión receptora los descartaba sin leerlos.
4731 4758
4732<h3 id="cross-session-message-dropped-at-the-inbox">4759<h3 id="cross-session-message-dropped-at-the-inbox">
4733 Cross-session message was dropped at the recipient session's inbox4760 Cross-session message was dropped at the recipient session's inbox
4734</h3>4761</h3>
4735 4762
4736Claude envió un [mensaje entre sesiones](/docs/es/cross-session-messaging) a otra de tus sesiones en esta máquina, y la bandeja de entrada de esa sesión lo descartó antes de que Claude en esa sesión lo leyera. La línea nombra al destinatario y, cuando el destinatario dio una razón, agrega la razón después de un guion:4763Claude envió un [mensaje entre sesiones](/docs/es/cross-session-messaging) a otra de tus sesiones en esta máquina, y el buzón de esa sesión lo descartó antes de que Claude lo leyera en esa sesión. La línea nombra al destinatario y, cuando el destinatario dio un motivo, agrega el motivo después de un guion:
4737 4764
4738```text wrap theme={null}4765```text wrap theme={null}
4739Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.4766Cross-session message was dropped at the recipient session's inbox (recipient: uds:/tmp/cc-socks/13605.sock) and not delivered — its queue of undelivered peer messages was full. Claude was told not to resend right away.
4740```4767```
4741 4768
4742Una línea puede cubrir varios mensajes descartados. En ese caso comienza en plural, por ejemplo `Cross-session messages (12) were dropped`. Para encontrar a qué sesión pertenece una dirección, compárala con la [fila `Peer address`](/docs/es/cross-session-messaging#the-sessions-inbox-socket) que `/status` muestra en cada sesión.4769Una sola línea puede cubrir varios mensajes descartados. En ese caso empieza en plural, por ejemplo `Cross-session messages (12) were dropped`. Para saber a qué sesión pertenece una dirección, compárala con la [fila `Peer address`](/docs/es/cross-session-messaging#the-sessions-inbox-socket) que muestra `/status` en cada sesión.
4743 4770
4744Después del guion, la línea da una o más de estas razones:4771Después del guion, la línea da uno o más de estos motivos:
4745 4772
4746* `its queue of undelivered peer messages was full`: el destinatario ya tenía tantos mensajes no entregados de otras sesiones como su cola permite4773* `its queue of undelivered peer messages was full`: el destinatario ya tenía tantos mensajes no entregados de otras sesiones como permite su cola
4747* `you sent faster than that session accepts`: los mensajes de la sesión remitente llegaron más rápido de lo que el destinatario acepta de un solo remitente4774* `you sent faster than that session accepts`: los mensajes de la sesión remitente llegaron más rápido de lo que el destinatario acepta de un solo remitente
4748* `it repeated your previous message`: el mensaje era idéntico a uno que la sesión remitente envió a este destinatario poco antes4775* `it repeated your previous message`: el mensaje era idéntico a uno que la sesión remitente le había enviado a este destinatario poco antes
4749* `a relay loop between sessions was cut`: el mensaje continuaba una cadena de sesiones enviándose mensajes entre sí, y la cadena había pasado por el destinatario demasiadas veces o se había vuelto demasiado larga4776* `a relay loop between sessions was cut`: el mensaje continuaba una cadena de sesiones que se enviaban mensajes entre sí, y la cadena había pasado por el destinatario demasiadas veces o se había vuelto demasiado larga
4750 4777
4751**Qué hacer:**4778**Qué hacer:**
4752 4779
4753* Asume que el destinatario nunca vio los mensajes descartados. Claude Code le dice lo mismo a Claude, y le indica que incluya cualquier cosa que aún importe en un mensaje posterior en lugar de reenviar de inmediato4780* Da por hecho que el destinatario nunca vio los mensajes descartados. Claude Code le dice lo mismo a Claude, y le indica que incluya todo lo que siga siendo importante en un solo mensaje posterior en lugar de reenviarlo de inmediato
4754* Si tus sesiones se envían actualizaciones frecuentes entre sí, pide a Claude que envíe menos mensajes y más grandes, como un informe cuando una sesión termina su trabajo4781* Si tus sesiones se envían actualizaciones frecuentes entre sí, pídele a Claude que envíe menos mensajes y más grandes, como un informe cuando una sesión termine su trabajo
4755* Para `a relay loop between sessions was cut`, escribe tú mismo la siguiente instrucción en una de las sesiones. Un mensaje que Claude envía en respuesta a tu propio prompt comienza una nueva cadena4782* Para `a relay loop between sessions was cut`, escribe tú mismo la siguiente instrucción en una de las sesiones. Un mensaje que Claude envía en respuesta a tu propio prompt inicia una nueva cadena
4756 4783
4757Antes de v2.1.238, la sesión remitente no recibía ningún informe cuando la bandeja de entrada del destinatario descartaba un mensaje.4784Antes de la v2.1.238, la sesión remitente no recibía ningún reporte cuando el buzón del destinatario descartaba un mensaje.
4758 4785
4759<h3 id="refusing-to-send-a-cross-session-message">4786<h3 id="refusing-to-send-a-cross-session-message">
4760 Refusing to send a cross-session message4787 Refusing to send a cross-session message
4761</h3>4788</h3>
4762 4789
4763Antes de que Claude Code escriba un [mensaje entre sesiones](/docs/es/cross-session-messaging) a otra de tus sesiones en esta máquina, verifica que el socket de bandeja de entrada de la sesión de destino sea el endpoint al que se dirigió el mensaje. Cuando una verificación falla, Claude Code rechaza el envío en la sesión remitente, y la sesión de destino no recibe nada. Para un mensaje que envía Claude, el rechazo aparece en el resultado de la herramienta de la sesión remitente:4790Antes de que Claude Code escriba un [mensaje entre sesiones](/docs/es/cross-session-messaging) a otra de tus sesiones en esta máquina, verifica que el socket del buzón de la sesión destino sea el endpoint al que se dirigió el mensaje. Cuando una verificación falla, Claude Code rechaza el envío en la sesión remitente, y la sesión destino no recibe nada. Para un mensaje que envía Claude, el rechazo aparece en el resultado de la herramienta de la sesión remitente:
4764 4791
4765```text theme={null}4792```text theme={null}
4766Failed to send to api-worker: Refusing to send: reply target is a symlink4793Failed to send to api-worker: Refusing to send: reply target is a symlink
4768 4795
4769El texto después de `Refusing to send:` nombra la verificación que falló:4796El texto después de `Refusing to send:` nombra la verificación que falló:
4770 4797
4771* `reply target is a symlink`: hay un enlace simbólico en la ruta del socket de la sesión de destino. Claude Code no entrega a través de él, porque un enlace allí podría redirigir el mensaje a un endpoint que la sesión de destino no creó.4798* `reply target is a symlink`: hay un enlace simbólico en la ruta del socket de la sesión destino. Claude Code no entrega a través de él, porque un enlace ahí podría redirigir el mensaje a un endpoint que la sesión destino no creó.
4772* `cannot vet reply target`: Claude Code no pudo inspeccionar la ruta de destino en absoluto, por ejemplo porque leerla falló con un error de permisos.4799* `cannot vet reply target`: Claude Code no pudo inspeccionar la ruta destino en absoluto, por ejemplo porque al leerla falló con un error de permisos.
4773 4800
4774**Qué hacer:**4801**Qué hacer:**
4775 4802
4776* Generalmente nada: las verificaciones evitan que un mensaje llegue a un endpoint distinto de la sesión a la que se dirigió, y no se envió nada4803* Normalmente nada: las verificaciones evitan que un mensaje llegue a un endpoint distinto de la sesión a la que se dirigió, y no se envió nada
4777* Si `reply target is a symlink` se repite para una sesión, verifica qué creó un enlace en la ruta del socket de esa sesión, que se muestra en su `/status` bajo `Peer address`4804* Si `reply target is a symlink` se repite para una sesión, revisa qué creó un enlace en la ruta del socket de esa sesión, que se muestra en su `/status` bajo `Peer address`
4778 4805
4779<h3 id="refusing-after-a-symlink-changed">4806<h3 id="refusing-after-a-symlink-changed">
4780 Refusing to read, write, or search a path4807 Refusing to read, write, or search a path
4781</h3>4808</h3>
4782 4809
4783Claude Code verifica las [reglas de permisos](/docs/es/permissions#read-and-edit) de una ruta de archivo, y luego confirma esa resolución nuevamente cuando la herramienta abre el archivo o inicia la búsqueda. Cuando no puede confirmar que la ruta aún conduce a la ubicación que la verificación aprobó, Claude Code rechaza la operación en lugar de seguirla. El rechazo aparece en el resultado de la herramienta:4810Claude Code verifica las [reglas de permisos](/docs/es/permissions#read-and-edit) de una ruta de archivo y luego vuelve a confirmar esa resolución cuando la herramienta abre el archivo o inicia la búsqueda. Cuando no puede confirmar que la ruta sigue llevando a la ubicación que aprobó la verificación, Claude Code rechaza la operación en lugar de seguirla. El rechazo aparece en el resultado de la herramienta:
4784 4811
4785```text wrap theme={null}4812```text wrap theme={null}
4786Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.4813Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.
4787```4814```
4788 4815
4789Cada rechazo nombra su razón:4816Cada rechazo nombra su motivo:
4790 4817
4791* `its symlink resolution changed after permission was checked`: un enlace simbólico a lo largo de la ruta, o en una raíz de búsqueda de Grep o Glob, fue reemplazado entre la verificación de permisos y la operación. En un rechazo de lectura, la frase entre paréntesis nombra qué comparación falló.4818* `its symlink resolution changed after permission was checked`: un enlace simbólico a lo largo de la ruta, o en la raíz de búsqueda de Grep o Glob, se reemplazó entre la verificación de permisos y la operación. En un rechazo de lectura, la frase entre paréntesis nombra qué comparación falló.
4792* `its parent-directory symlink resolution changed after permission was checked`: un directorio por el que pasa la ruta de escritura ya no se resuelve a la ubicación aprobada4819* `its parent-directory symlink resolution changed after permission was checked`: un directorio por el que pasa la ruta de escritura ya no se resuelve en la ubicación aprobada
4793* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code no pudo seguir la ruta hasta una ubicación final en el disco, por ejemplo porque los enlaces simbólicos en ella forman un bucle4820* `where it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve)`: Claude Code no pudo seguir la ruta hasta una ubicación final en disco, por ejemplo porque los enlaces simbólicos en ella forman un bucle
4794* `it is a symbolic link. Write to the link's target path instead`: hay un enlace simbólico en la propia ubicación de escritura solicitada, por ejemplo un `CLAUDE.md` que es un enlace simbólico a `AGENTS.md`; el mensaje dirige a Claude al destino del enlace4821* `it is a symbolic link. Write to the link's target path instead`: hay un enlace simbólico en la propia ubicación de escritura solicitada, por ejemplo un `CLAUDE.md` que es un enlace simbólico a `AGENTS.md`; el mensaje dirige a Claude al destino del enlace
4795* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: la misma condición detectada cuando otro escritor abre el archivo, como una escritura a un `.mcp.json` que es un enlace simbólico4822* `Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.`: la misma condición detectada cuando otro escritor abre el archivo, como una escritura en un `.mcp.json` que es un enlace simbólico
4796* `Refusing to write into symlinked directory: <path>`: el directorio que contiene el archivo es en sí mismo un enlace simbólico, por ejemplo el directorio `.claude/` de un proyecto enlazado a otra ubicación4823* `Refusing to write into symlinked directory: <path>`: el directorio que contiene el archivo es en sí un enlace simbólico, por ejemplo el directorio `.claude/` de un proyecto enlazado a otra ubicación
4797* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: una regla de denegación `Read` para la búsqueda nombra una ruta que pasa a través de un enlace simbólico, y ese enlace cambió mientras Claude Code estaba preparando la búsqueda4824* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: una regla de denegación de `Read` para la búsqueda nombra una ruta que pasa por un enlace simbólico, y ese enlace cambió mientras Claude Code preparaba la búsqueda
4798* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: la raíz de búsqueda existe pero no pudo abrirse; el código entre paréntesis es el error del sistema operativo4825* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: la raíz de búsqueda existe pero no se pudo abrir; el código entre paréntesis es el error del sistema operativo
4799* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code desalojó el registro de aprobación bajo muchas operaciones de archivo simultáneas antes de que la herramienta lo usara; reintentar ejecuta una verificación de permisos nueva4826* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code descartó el registro de aprobación ante muchas operaciones de archivos simultáneas antes de que la herramienta lo usara; reintentar ejecuta una nueva verificación de permisos
4800* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code no pudo resolver el binario `rg` a una ruta absoluta, por lo que rechaza búsquedas fuera del directorio de trabajo en lugar de ejecutar una que tus reglas de denegación no cubran4827* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code no pudo resolver el binario `rg` a una ruta absoluta, así que rechaza las búsquedas fuera del directorio de trabajo en lugar de ejecutar una que tus reglas de denegación no cubren
4801 4828
4802**Qué hacer:**4829**Qué hacer:**
4803 4830
4804* Generalmente nada: el rechazo llega a Claude como el resultado de la herramienta, y la operación rechazada no se ejecuta4831* Normalmente nada: el rechazo llega a Claude como resultado de la herramienta, y la operación rechazada no se ejecuta
4805* Si un rechazo de enlace simbólico se repite en una ruta, encuentra qué sigue reescribiendo un enlace allí, como una herramienta de compilación o un observador de archivos, o pide a Claude que use la ruta resuelta del archivo en lugar de la enlazada4832* Si un rechazo por enlace simbólico se repite en una ruta, averigua qué sigue reescribiendo un enlace ahí, como una herramienta de compilación o un observador de archivos, o pídele a Claude que use la ruta resuelta del archivo en lugar de la enlazada
4806* Si este rechazo aparece para cada archivo mientras Claude Code se ejecuta en Windows dentro de un AppContainer o un sandbox de token restringido, actualiza a v2.1.265 o posterior4833* Si este rechazo aparece para cada archivo mientras Claude Code se ejecuta en Windows dentro de un AppContainer o de un sandbox de token restringido, actualiza a la v2.1.265 o posterior
4807* Si un rechazo de lectura aparece en macOS para un archivo que nada está reescribiendo, como una captura de pantalla arrastrada al prompt, actualiza a v2.1.273 o posterior4834* Si aparece un rechazo de lectura en macOS para un archivo que nada está reescribiendo, como una captura de pantalla arrastrada al prompt, actualiza a la v2.1.273 o posterior
4808* Para el rechazo de ripgrep, instala ripgrep con tu administrador de paquetes para que `rg` se resuelva a una ruta absoluta en `PATH`, o mantén las búsquedas dentro del directorio de trabajo4835* Para el rechazo de ripgrep, instala ripgrep con tu gestor de paquetes para que `rg` se resuelva en una ruta absoluta en `PATH`, o mantén las búsquedas dentro del directorio de trabajo
4809 4836
4810Antes de v2.1.251, Claude Code volvía a verificar la resolución de una ruta solo para escrituras de archivo, por lo que un enlace reemplazado después de la verificación de permisos podía redirigir una lectura o búsqueda a una ubicación diferente sin ningún mensaje. De estos, solo los rechazos de escritura de directorio principal, a través de enlace simbólico y de directorio enlazado simbólicamente aparecen en versiones anteriores.4837Antes de la v2.1.251, Claude Code volvía a verificar la resolución de una ruta solo para las escrituras de archivos, así que un enlace reemplazado después de la verificación de permisos podía redirigir una lectura o búsqueda a otra ubicación sin ningún mensaje. De estos, solo los rechazos de escritura por directorio superior, a través de enlace simbólico y en directorio enlazado aparecen en versiones anteriores.
4811 4838
4812Antes de v2.1.280, el rechazo `where it leads on disk could not be determined` no aparecía.4839Antes de la v2.1.280, el rechazo `where it leads on disk could not be determined` no aparecía.
4813 4840
4814<h3 id="task-output-swap-refused">4841<h3 id="task-output-swap-refused">
4815 Task output swap refused4842 Task output swap refused
4816</h3>4843</h3>
4817 4844
4818Claude Code guarda la salida de cada comando Bash en un archivo bajo su directorio temporal. Cada vez que abre uno de estos archivos, verifica que la ruta aún conduzca al archivo que creó, sin ningún enlace simbólico, enlace duro adicional o directorio movido que la redirija. Este mensaje significa que esa verificación falló, por lo que Claude Code rechazó la operación en lugar de escribir o leer salida a través de esa ruta. El mensaje aparece en el resultado de la herramienta Bash:4845Claude Code guarda la salida de cada comando de Bash en un archivo dentro de su directorio temporal. Cada vez que abre uno de estos archivos, verifica que la ruta siga llevando al archivo que creó, sin ningún enlace simbólico, enlace duro adicional o directorio movido que la redirija. Este mensaje significa que esa verificación falló, así que Claude Code rechazó la operación en lugar de escribir o leer la salida a través de esa ruta. El mensaje aparece en el resultado de la herramienta Bash:
4819 4846
4820```text wrap theme={null}4847```text wrap theme={null}
4821task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.4848task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.
4822```4849```
4823 4850
4824El texto entre paréntesis nombra la verificación que falló. Razones como `output symlink was re-pointed`, `output file identity changed` y `not a regular file` reportan todas la misma condición: algo en la ruta de salida o a lo largo de ella ya no es el archivo que Claude Code creó. Solo algunas razones incluyen una oración `To recover:`.4851El texto entre paréntesis nombra la verificación que falló. Motivos como `output symlink was re-pointed`, `output file identity changed` y `not a regular file` reportan todos la misma condición: algo en la ruta de salida o a lo largo de ella ya no es el archivo que creó Claude Code. Solo algunos motivos incluyen una oración `To recover:`.
4825 4852
4826Si la verificación falla mientras un comando aún se está ejecutando, Claude Code detiene el comando, y su resultado reporta:4853Si la verificación falla mientras un comando sigue ejecutándose, Claude Code detiene el comando, y su resultado reporta:
4827 4854
4828```text theme={null}4855```text theme={null}
4829Command killed: its output file was replaced or could no longer be verified4856Command killed: its output file was replaced or could no longer be verified
4831 4858
4832**Qué hacer:**4859**Qué hacer:**
4833 4860
4834* Actualiza a v2.1.260 o posterior. Las versiones anteriores a veces mostraban este mensaje cuando no había ningún enlace ni directorio movido4861* Actualiza a la v2.1.260 o posterior. Las versiones anteriores a veces mostraban este mensaje cuando no había ningún enlace ni directorio movido
4835* Reinicia Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) configurado en un directorio nuevo4862* Reinicia Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) establecida en un directorio nuevo
4836* O revisa el directorio de tu proyecto bajo el directorio temporal de Claude Code, `/private/tmp/claude-501/-Users-you-my-project` en el mensaje de ejemplo. Si esa ruta es un enlace simbólico, o un directorio que no debería estar allí, elimina el enlace o directorio en sí en lugar del destino del enlace, y reinicia Claude Code4863* O revisa el directorio de tu proyecto dentro del directorio temporal de Claude Code, `/private/tmp/claude-501/-Users-you-my-project` en el mensaje de ejemplo. Si esa ruta es un enlace simbólico, o un directorio que no debería estar ahí, elimina el propio enlace o directorio en lugar del destino del enlace, y reinicia Claude Code
4837* Si el rechazo se repite, un proceso está reemplazando, enlazando o eliminando entradas bajo el directorio temporal de Claude Code mientras la sesión se ejecuta. Configura [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) en un directorio que nada más administre y reinicia4864* Si el rechazo se repite, hay un proceso que reemplaza, enlaza o elimina entradas dentro del directorio temporal de Claude Code mientras la sesión se ejecuta. Establece [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) en un directorio que nada más administre y reinicia
4838 4865
4839<h3 id="disk-quota-or-temp-filesystem-is-full">4866<h3 id="disk-quota-or-temp-filesystem-is-full">
4840 Disk quota or temp filesystem is full4867 Disk quota or temp filesystem is full
4841</h3>4868</h3>
4842 4869
4843Claude Code guarda la salida de cada comando Bash y PowerShell en un archivo bajo su directorio temporal. Cuando un comando sale con un código distinto de cero y sin ninguna salida, Claude Code verifica si el sistema de archivos que contiene ese archivo se quedó sin espacio o sin inodos, o si tu cuota de disco en él está agotada. Si es así, aparece un diagnóstico en el resultado del comando en lugar de la salida vacía:4870Claude Code guarda la salida de cada comando de Bash y PowerShell en un archivo dentro de su directorio temporal. Cuando un comando termina con un código distinto de cero y sin ninguna salida, Claude Code verifica si el sistema de archivos que contiene ese archivo se quedó sin espacio o sin inodos, o si se agotó tu cuota de disco en él. Si es así, aparece un diagnóstico en el resultado del comando en lugar de la salida vacía:
4844 4871
4845```text wrap theme={null}4872```text wrap theme={null}
4846Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.4873Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.
4848 4875
4849El mensaje nombra lo que se agotó:4876El mensaje nombra lo que se agotó:
4850 4877
4851* `Your disk quota is full ... (EDQUOT)`: tu propia cuota en ese sistema de archivos está agotada. Una cuota puede estar llena mientras el sistema de archivos aún muestra espacio libre4878* `Your disk quota is full ... (EDQUOT)`: se agotó tu propia cuota en ese sistema de archivos. Una cuota puede estar llena mientras el sistema de archivos todavía muestra espacio libre
4852* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: el sistema de archivos, o tu cuota en él, no tiene espacio restante4879* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: el sistema de archivos, o tu cuota en él, no tiene espacio disponible
4853* `Command output was lost: the temp filesystem at ... is full` o `... is out of inodes`: al sistema de archivos casi no le queda espacio libre, o se está quedando sin inodos4880* `Command output was lost: the temp filesystem at ... is full` o `... is out of inodes`: al sistema de archivos casi no le queda espacio libre, o se está quedando sin inodos
4854 4881
4855**Qué hacer:**4882**Qué hacer:**
4856 4883
4857* Elimina los archivos que ya no necesites en el sistema de archivos que contiene el directorio temporal de Claude Code. Para `EDQUOT`, elimina archivos que cuenten para tu propia cuota. Para `out of inodes`, elimina muchos archivos en lugar de unos pocos grandes, ya que cada archivo ocupa un inodo sin importar su tamaño4884* Elimina los archivos que ya no necesites en el sistema de archivos que contiene el directorio temporal de Claude Code. Para `EDQUOT`, elimina archivos que cuenten para tu propia cuota. Para `out of inodes`, elimina muchos archivos en lugar de unos pocos grandes, ya que cada archivo ocupa un inodo sin importar su tamaño
4858* O reinicia Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) configurado en un directorio de un sistema de archivos con espacio4885* O reinicia Claude Code con [`CLAUDE_CODE_TMPDIR`](/docs/es/env-vars) establecida en un directorio de un sistema de archivos con espacio
4859* Luego pide a Claude que ejecute el comando de nuevo. La salida que imprimió se perdió, no se truncó4886* Luego haz que Claude ejecute el comando de nuevo. La salida que imprimió se perdió, no se truncó
4860 4887
4861<h3 id="file-is-not-valid-utf-8">4888<h3 id="file-is-not-valid-utf-8">
4862 File is not valid UTF-84889 File is not valid UTF-8
4863</h3>4890</h3>
4864 4891
4865Claude usó la herramienta Edit o NotebookEdit en un archivo cuyos bytes no se decodifican como UTF-8, y Claude Code rechazó el cambio. No se escribió nada, por lo que el archivo quedó como estaba. Esas herramientas guardan el archivo completo de nuevo como UTF-8, lo que habría convertido cada byte que no pudieran decodificar en el carácter de reemplazo `U+FFFD`. El mensaje aparece en el resultado de la herramienta:4892Claude usó la herramienta Edit o NotebookEdit en un archivo cuyos bytes no se decodifican como UTF-8, y Claude Code rechazó el cambio. No se escribió nada, así que el archivo quedó como estaba. Esas herramientas guardan el archivo completo como UTF-8, lo que habría convertido cada byte que no pudieran decodificar en el carácter de reemplazo `U+FFFD`. El mensaje aparece en el resultado de la herramienta:
4866 4893
4867```text wrap theme={null}4894```text wrap theme={null}
4868File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary. This tool saves the whole file as UTF-8, which would replace every byte it cannot decode with U+FFFD. Nothing was written. Make the change with a shell command that reads and writes the file in its own encoding, or ask the user whether to convert the file to UTF-8 first.4895File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary. This tool saves the whole file as UTF-8, which would replace every byte it cannot decode with U+FFFD. Nothing was written. Make the change with a shell command that reads and writes the file in its own encoding, or ask the user whether to convert the file to UTF-8 first.
4869```4896```
4870 4897
4871Un archivo que debería estar en UTF-8 también recibe este mensaje cuando contiene aunque sea una sola secuencia de bytes no válida, porque la verificación cubre los bytes del archivo en su conjunto.4898Un archivo que debería ser UTF-8 también recibe este mensaje cuando contiene aunque sea una secuencia de bytes no válida, porque la verificación cubre los bytes del archivo en su totalidad.
4872 4899
4873**Qué hacer:**4900**Qué hacer:**
4874 4901
4875* Para mantener el archivo en su codificación actual, deja que Claude haga el cambio con un comando de shell que lea y escriba el archivo en esa codificación, como le indica el mensaje4902* Para mantener el archivo en su codificación actual, deja que Claude haga el cambio con un comando de shell que lea y escriba el archivo en esa codificación, como le indica el mensaje
4876* Para seguir editando el archivo con la herramienta Edit, conviértelo a UTF-8, o corrige los bytes no válidos en un archivo que debería estar en UTF-8, y luego pide a Claude que haga la edición de nuevo4903* Para seguir editando el archivo con la herramienta Edit, conviértelo a UTF-8, o corrige los bytes no válidos en un archivo que debería ser UTF-8, y luego pídele a Claude que vuelva a hacer la edición
4877 4904
4878Antes de v2.1.296, Edit y NotebookEdit aplicaban una edición así y guardaban cada byte que no podían decodificar como `U+FFFD`. En esas versiones, actualiza Claude Code.4905Antes de la v2.1.296, Edit y NotebookEdit aplicaban una edición así y guardaban cada byte que no podían decodificar como `U+FFFD`. En esas versiones, actualiza Claude Code.
4879 4906
4880<h3 id="the-source-file-is-not-valid-utf-8-text">4907<h3 id="the-source-file-is-not-valid-utf-8-text">
4881 The source file is not valid UTF-8 text4908 The source file is not valid UTF-8 text
4882</h3>4909</h3>
4883 4910
4884Claude intentó publicar un [artefacto](/docs/es/artifacts) desde un archivo cuyos bytes no se decodifican como texto, o cuyo texto ya contiene el carácter de reemplazo `U+FFFD`, por lo que Claude Code rechazó la publicación antes de cargar nada. El mensaje aparece en el resultado de la herramienta Artifact y nombra la primera posición a corregir:4911Claude intentó publicar un [artefacto](/docs/es/artifacts) a partir de un archivo cuyos bytes no se decodifican como texto, o cuyo texto ya contiene el carácter de reemplazo `U+FFFD`, así que Claude Code rechazó la publicación antes de subir nada. El mensaje aparece en el resultado de la herramienta Artifact y nombra la primera posición que hay que corregir:
4885 4912
4886```text wrap theme={null}4913```text wrap theme={null}
4887file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.4914file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.
4889file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.4916file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.
4890```4917```
4891 4918
4892Claude Code decodifica el archivo como UTF-8, o como UTF-16 cuando comienza con una marca de orden de bytes UTF-16 little-endian. Cuando un archivo UTF-16 así no se decodifica, el primer mensaje nombra `UTF-16` y aun así te indica que reescribas el archivo como UTF-8. Cuando hay más posiciones después de la nombrada, el mensaje agrega un conteo como `(+2 more)` después de la posición.4919Claude Code decodifica el archivo como UTF-8, o como UTF-16 cuando empieza con una marca de orden de bytes UTF-16 little-endian. Cuando un archivo UTF-16 así no se decodifica, el primer mensaje menciona `UTF-16` y aun así te indica que reescribas el archivo como UTF-8. Cuando hay más posiciones después de la nombrada, el mensaje agrega un conteo como `(+2 more)` después de la posición.
4893 4920
4894**Qué hacer:**4921**Qué hacer:**
4895 4922
4896* Generalmente nada: Claude reescribe el archivo y publica de nuevo4923* Normalmente nada: Claude reescribe el archivo y lo publica de nuevo
4897* Si el archivo es uno que escribiste o exportaste, guárdalo de nuevo como UTF-8, y reemplaza cada `U+FFFD` con el carácter que una edición, pegado o conversión anterior perdió4924* Si el archivo es uno que escribiste o exportaste tú, guárdalo de nuevo como UTF-8 y reemplaza cada `U+FFFD` por el carácter que perdió una edición, un pegado o una conversión anterior
4898* Para mostrar un `U+FFFD` intencional en la página, escríbelo como `�` en el HTML en lugar del carácter literal4925* Para mostrar un `U+FFFD` intencional en la página, escríbelo como `�` en el HTML en lugar del carácter literal
4899 4926
4900Antes de v2.1.267, Claude Code cargaba un archivo así sin verificarlo, y era el servidor el que rechazaba la publicación.4927Antes de la v2.1.267, Claude Code subía un archivo así sin verificarlo, y era el servidor el que rechazaba la publicación.
4901 4928
4902<h3 id="not-published-that-file-is-on-a-network-share">4929<h3 id="not-published-that-file-is-on-a-network-share">
4903 Not published: that file is on a network share4930 Not published: that file is on a network share
4904</h3>4931</h3>
4905 4932
4906Claude intentó publicar un [artefacto](/docs/es/artifacts) desde un archivo en una ruta que nombra un host de red:4933Claude intentó publicar un [artefacto](/docs/es/artifacts) a partir de un archivo en una ruta que nombra un host de red:
4907 4934
4908* En Windows, una ruta `\\server\share` que no está bajo una unidad de red asignada que hayas pasado al iniciar con [`--add-dir`](/docs/es/cli-reference#cli-flags)4935* En Windows, una ruta `\\server\share` que no está dentro de una unidad de red asignada que pasaste al iniciar con [`--add-dir`](/docs/es/cli-reference#cli-flags)
4909* En macOS o Linux, una ruta de montaje automático como `/net/<host>/page.html`4936* En macOS o Linux, una ruta de montaje automático como `/net/<host>/page.html`
4910 4937
4911Resolver una ruta así contacta al host que nombra, y en Windows ese contacto puede enviar tus credenciales al host. Claude Code se niega a publicar el archivo y no lo lee. El rechazo aparece en el resultado de la herramienta Artifact:4938Buscar una ruta así contacta al host que nombra, y en Windows ese contacto puede enviarle tus credenciales al host. Claude Code se niega a publicar el archivo y no lo lee. El rechazo aparece en el resultado de la herramienta Artifact:
4912 4939
4913```text theme={null}4940```text theme={null}
4914Not published: that file is on a network share. Publish a file from this session's folders instead.4941Not published: that file is on a network share. Publish a file from this session's folders instead.
4916 4943
4917**Qué hacer:**4944**Qué hacer:**
4918 4945
4919* Nada, si no necesitas ese archivo exacto: el mensaje le indica a Claude que publique un archivo de las propias carpetas de la sesión en su lugar4946* Nada, si no necesitas ese archivo exacto: el mensaje le indica a Claude que publique en su lugar un archivo de las carpetas propias de la sesión
4920* Para publicar ese archivo exacto, cópialo en una carpeta de un disco local y vuelve a pedirlo4947* Para publicar ese archivo exacto, cópialo en una carpeta de un disco local y vuelve a pedirlo
4921* En Windows, para permitir que Claude publique directamente desde el recurso compartido, asígnalo a una letra de unidad y pasa la unidad al iniciar Claude Code. En PowerShell, por ejemplo, ejecuta `net use Z: \\server\share` y luego `claude --add-dir Z:\`. Claude podrá entonces publicar archivos desde esa unidad. Agregar la unidad a mitad de la sesión con `/add-dir` no es suficiente.4948* En Windows, para permitir que Claude publique directamente desde el recurso compartido, asígnalo a una letra de unidad y pasa la unidad al iniciar Claude Code. En PowerShell, por ejemplo, ejecuta `net use Z: \\server\share` y luego `claude --add-dir Z:\`. Así Claude puede publicar archivos desde esa unidad. Agregar la unidad a mitad de la sesión con `/add-dir` no es suficiente.
4922* En macOS o Linux, monta el recurso compartido en un directorio como uno bajo `/mnt` o `/Volumes`, y publica desde esa ruta en lugar de la ruta de montaje automático4949* En macOS o Linux, monta el recurso compartido en un directorio, como uno dentro de `/mnt` o `/Volumes`, y publica desde esa ruta en lugar de la ruta de montaje automático
4923 4950
4924<h3 id="reading-a-local-file-from-outside-the-connected-folders">4951<h3 id="reading-a-local-file-from-outside-the-connected-folders">
4925 Reading a local file from outside the connected folders in a Cowork session4952 Reading a local file from outside the connected folders in a Cowork session
4926</h3>4953</h3>
4927 4954
4928En una sesión de [Cowork](https://claude.com/docs/cowork/overview) que se ejecuta en tu máquina en la aplicación Claude Desktop, Claude nombró un archivo local para un [artefacto](/docs/es/artifacts). Claude Code no pudo confirmar que el archivo sea un archivo simple dentro de las carpetas conectadas de la sesión: la ruta se encuentra fuera de esas carpetas, pasa a través de un enlace simbólico, o está escrita de una manera que puede nombrar un archivo diferente al que parece. Leer un archivo así requiere tu aprobación, y en una sesión que no puede mostrarte la tarjeta de aprobación, como una configurada para omitir todas las aprobaciones, Claude Code rechaza la lectura.4955En una sesión de [Cowork](https://claude.com/docs/cowork/overview) que se ejecuta en tu máquina en la aplicación Claude Desktop, Claude nombró un archivo local para un [artefacto](/docs/es/artifacts). Claude Code no pudo confirmar que el archivo sea un archivo simple dentro de las carpetas conectadas de la sesión: la ruta está fuera de esas carpetas, pasa por un enlace simbólico o está escrita de una forma que puede nombrar un archivo distinto del que parece. Leer un archivo así requiere tu aprobación, y en una sesión que no puede mostrarte la tarjeta de aprobación, como una configurada para omitir todas las aprobaciones, Claude Code rechaza la lectura.
4929 4956
4930El rechazo aparece en el resultado de la herramienta Artifact; cuando el archivo no pudo examinarse en absoluto, nombra esa falla en su lugar:4957El rechazo aparece en el resultado de la herramienta Artifact; cuando el archivo no se pudo examinar en absoluto, nombra esa falla en su lugar:
4931 4958
4932```text wrap theme={null}4959```text wrap theme={null}
4933Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.4960Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.
4937 4964
4938**Qué hacer:**4965**Qué hacer:**
4939 4966
4940* Generalmente nada: el mensaje le dice a Claude que use un archivo simple dentro de las carpetas conectadas en su lugar4967* Normalmente nada: el mensaje le indica a Claude que use en su lugar un archivo simple dentro de las carpetas conectadas
4941* Para poner ese archivo exacto en el artefacto, cópialo en una de las carpetas conectadas de la sesión como un archivo normal, no un enlace simbólico, y vuelve a pedirlo4968* Para incluir ese archivo exacto en el artefacto, cópialo en una de las carpetas conectadas de la sesión como un archivo normal, no como un enlace simbólico, y vuelve a pedirlo
4942 4969
4943<h3 id="webfetch-cannot-fetch-localhost">4970<h3 id="webfetch-cannot-fetch-localhost">
4944 WebFetch cannot fetch localhost4971 WebFetch cannot fetch localhost
4952 4979
4953**Qué hacer:**4980**Qué hacer:**
4954 4981
4955* Generalmente nada: el mensaje dirige a Claude a `curl` a través de la herramienta Bash, que puede llegar a servidores locales y de intranet4982* Normalmente nada: el mensaje dirige a Claude a `curl` a través de la herramienta Bash, que puede llegar a servidores locales y de intranet
4956 4983
4957Antes de v2.1.268, WebFetch reportaba estas URL con un error genérico `Invalid URL`.4984Antes de la v2.1.268, WebFetch reportaba estas URL con un error genérico `Invalid URL`.
4958 4985
4959<h3 id="webfetch-domain-safety-check-failed">4986<h3 id="webfetch-domain-safety-check-failed">
4960 WebFetch domain safety check failed4987 WebFetch domain safety check failed
4961</h3>4988</h3>
4962 4989
4963Antes de obtener una URL, WebFetch envía el nombre de host de la URL a `api.anthropic.com` para verificarlo contra la [lista de bloqueo de seguridad de dominios](/docs/es/data-usage#webfetch-domain-safety-check) de Anthropic. Si la verificación no se puede completar, WebFetch no puede confirmar que el dominio sea seguro, por lo que no obtiene la página y el resultado de la herramienta contiene uno de estos mensajes en su lugar:4990Antes de obtener una URL, WebFetch envía el nombre de host de la URL a `api.anthropic.com` para compararlo con la [lista de bloqueo de seguridad de dominios](/docs/es/data-usage#webfetch-domain-safety-check) de Anthropic. Si la verificación no puede completarse, WebFetch no puede confirmar que el dominio sea seguro, así que no obtiene la página y el resultado de la herramienta incluye en su lugar uno de estos mensajes:
4964 4991
4965```text wrap theme={null}4992```text wrap theme={null}
4966The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.4993The safety check for domain example.com is rate-limited (too many domain checks from this network; the limit is shared and can stay exhausted for minutes). Do not retry WebFetch in a loop or sleep to wait it out; continue without this page and report that its safety check was rate-limited. A single later attempt is fine; if that is rate-limited too, stop.
4968Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.4995Unable to verify if domain example.com is safe to fetch. This may be due to network restrictions or enterprise security policies blocking claude.ai.
4969```4996```
4970 4997
4971* `rate-limited`: el endpoint de verificación respondió con HTTP `429`. El mensaje le dice a Claude que continúe sin la página y que lo intente de nuevo como máximo una vez más tarde. Claude Code no almacena en caché una verificación fallida, por lo que una obtención posterior de ese dominio ejecuta la verificación de nuevo. Si las sesiones en tu red encuentran esto a menudo, puedes omitir la verificación con [`skipWebFetchPreflight: true`](/docs/es/settings-reference#skipwebfetchpreflight) en la configuración.4998* `rate-limited`: el endpoint de verificación respondió con HTTP `429`. El mensaje le indica a Claude que continúe sin la página y que lo intente de nuevo como máximo una vez más tarde. Claude Code no almacena en caché una verificación fallida, así que una obtención posterior de ese dominio vuelve a ejecutar la verificación. Si las sesiones en tu red se topan con esto a menudo, puedes omitir la verificación con [`skipWebFetchPreflight: true`](/docs/es/settings-reference#skipwebfetchpreflight) en la configuración.
4972* `Unable to verify`: la solicitud de verificación falló, agotó el tiempo de espera u obtuvo otro estado de error. Si tu red bloquea `api.anthropic.com`, agrega ese dominio a la lista de permitidos, u omite la verificación con [`skipWebFetchPreflight: true`](/docs/es/settings-reference#skipwebfetchpreflight) en la configuración.4999* `Unable to verify`: la solicitud de verificación falló, agotó el tiempo de espera o recibió otro estado de error. Si tu red bloquea `api.anthropic.com`, agrega ese dominio a la lista de dominios permitidos, u omite la verificación con [`skipWebFetchPreflight: true`](/docs/es/settings-reference#skipwebfetchpreflight) en la configuración.
4973 5000
4974Antes de v2.1.286, el mensaje de rate limit decía `The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.`.5001Antes de la v2.1.286, el mensaje de rate limit decía `The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way.`.
4975Antes de v2.1.285, una verificación afectada por el rate limit se reportaba con el mensaje `Unable to verify` en su lugar.5002Antes de la v2.1.285, una verificación limitada por rate limit se reportaba en su lugar con el mensaje `Unable to verify`.
4976 5003
4977<h2 id="background-session-errors">5004<h2 id="background-session-errors">
4978 Errores de sesión en segundo plano5005 Errores de sesión en segundo plano
