104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticación](#login-expired) |104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticación](#login-expired) |
105| `Could not refresh your login because another Claude Code process is refreshing it` | [Autenticación](#could-not-refresh-your-login) |105| `Could not refresh your login because another Claude Code process is refreshing it` | [Autenticación](#could-not-refresh-your-login) |
106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Autenticación](#could-not-refresh-your-login) |106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [Autenticación](#could-not-refresh-your-login) |
107| `Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Autenticación](#could-not-refresh-your-login-disk-full) |
108| `Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [Autenticación](#could-not-refresh-your-login-disk-full) |
107| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticación](#your-account-is-on-hold) |109| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticación](#your-account-is-on-hold) |
108| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticación](#your-account-is-on-hold) |110| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticación](#your-account-is-on-hold) |
109| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticación](#anthropic-profile-login-expired) |111| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticación](#anthropic-profile-login-expired) |
242| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Errores de línea de comandos](#the-current-directory-no-longer-exists) |244| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Errores de línea de comandos](#the-current-directory-no-longer-exists) |
243| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |245| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |
244| `ENOSPC: no space left on device, mkdir '<dir>'` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |246| `ENOSPC: no space left on device, mkdir '<dir>'` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |
247| `Error: Claude Code could not save ... because the disk is full (ENOSPC)` / `because your disk quota is used up (EDQUOT)` | [Errores de línea de comandos](#could-not-save-because-the-disk-is-full) |
245| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Errores de línea de comandos](#directory-couldnt-be-resolved-to-a-real-location) |248| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Errores de línea de comandos](#directory-couldnt-be-resolved-to-a-real-location) |
246| `Error: Workspace not trusted` al iniciar Remote Control | [Errores de línea de comandos](#workspace-not-trusted-when-starting-remote-control) |249| `Error: Workspace not trusted` al iniciar Remote Control | [Errores de línea de comandos](#workspace-not-trusted-when-starting-remote-control) |
247| `Error: Workspace not trusted` al ejecutar `claude ultrareview` | [Errores de línea de comandos](#workspace-not-trusted-when-running-claude-ultrareview) |250| `Error: Workspace not trusted` al ejecutar `claude ultrareview` | [Errores de línea de comandos](#workspace-not-trusted-when-running-claude-ultrareview) |
248| `Ultrareview did not start` | [Errores de línea de comandos](#ultrareview-did-not-start) |251| `Ultrareview did not start` | [Errores de línea de comandos](#ultrareview-did-not-start) |
252| `Remote Control did not start: "<question>" got no answer` | [Errores de línea de comandos](#remote-control-did-not-start-got-no-answer) |
249| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errores de línea de comandos](#not-carried-over-to-the-sessions-remote-control-starts) |253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errores de línea de comandos](#not-carried-over-to-the-sessions-remote-control-starts) |
250| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errores de línea de comandos](#sandbox-is-not-supported-by-claude-remote-control) |254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errores de línea de comandos](#sandbox-is-not-supported-by-claude-remote-control) |
251| `` `claude import` is not yet available in this build `` | [Errores de línea de comandos](#claude-import-is-not-yet-available-in-this-build) |255| `` `claude import` is not yet available in this build `` | [Errores de línea de comandos](#claude-import-is-not-yet-available-in-this-build) |
320| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Solución de problemas de plugins](https://code.claude.com/docs/es/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |324| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Solución de problemas de plugins](https://code.claude.com/docs/es/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |
321| `does not load (...), so Claude Code ignores the whole file` | [Solución de problemas de plugins](https://code.claude.com/docs/es/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |325| `does not load (...), so Claude Code ignores the whole file` | [Solución de problemas de plugins](https://code.claude.com/docs/es/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |
322| `path escapes plugin directory` | [Errores de plugins](#path-escapes-plugin-directory) |326| `path escapes plugin directory` | [Errores de plugins](#path-escapes-plugin-directory) |
327| `path not read: <path> is absolute or has a ".." part` | [Errores de plugins](#server-file-path-not-read) |
323| `Plugin not loaded: its manifest <path> was not read` | [Errores de plugins](#plugin-not-loaded-its-manifest-was-not-read) |328| `Plugin not loaded: its manifest <path> was not read` | [Errores de plugins](#plugin-not-loaded-its-manifest-was-not-read) |
324| `path could not be checked` | [Errores de plugins](#path-could-not-be-checked) |329| `path could not be checked` | [Errores de plugins](#path-could-not-be-checked) |
325| `its marketplace entry path does not stay inside the marketplace directory` | [Errores de plugins](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |330| `its marketplace entry path does not stay inside the marketplace directory` | [Errores de plugins](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
368| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Errores de herramientas](#refusing-after-a-symlink-changed) |373| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [Errores de herramientas](#refusing-after-a-symlink-changed) |
369| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Errores de herramientas](#refusing-after-a-symlink-changed) |374| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Errores de herramientas](#refusing-after-a-symlink-changed) |
370| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Errores de herramientas](#refusing-after-a-symlink-changed) |375| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Errores de herramientas](#refusing-after-a-symlink-changed) |
376| `The search failed, so this is not a "no matches" result: matches may exist` | [Errores de herramientas](#the-search-failed) |
371| `task output swap refused (tasks dir moved or linked)` | [Errores de herramientas](#task-output-swap-refused) |377| `task output swap refused (tasks dir moved or linked)` | [Errores de herramientas](#task-output-swap-refused) |
372| `Command killed: its output file was replaced or could no longer be verified` | [Errores de herramientas](#task-output-swap-refused) |378| `Command killed: its output file was replaced or could no longer be verified` | [Errores de herramientas](#task-output-swap-refused) |
373| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [Errores de herramientas](#disk-quota-or-temp-filesystem-is-full) |379| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [Errores de herramientas](#disk-quota-or-temp-filesystem-is-full) |
377| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Errores de herramientas](#disk-quota-or-temp-filesystem-is-full) |383| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Errores de herramientas](#disk-quota-or-temp-filesystem-is-full) |
378| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Errores de herramientas](#file-is-not-valid-utf-8) |384| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Errores de herramientas](#file-is-not-valid-utf-8) |
379| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [Errores de herramientas](#git-is-not-installed-on-this-mac) |385| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [Errores de herramientas](#git-is-not-installed-on-this-mac) |
386| `Refusing to apply edits to <path>: a hook is configured for file edits in this session` | [Errores de herramientas](#a-hook-is-configured-for-file-edits) |
380| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Errores de herramientas](#the-source-file-is-not-valid-utf-8-text) |387| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Errores de herramientas](#the-source-file-is-not-valid-utf-8-text) |
381| `the source file has the replacement character U+FFFD` | [Errores de herramientas](#the-source-file-is-not-valid-utf-8-text) |388| `the source file has the replacement character U+FFFD` | [Errores de herramientas](#the-source-file-is-not-valid-utf-8-text) |
382| `Not published: that file is on a network share` | [Errores de herramientas](#not-published-that-file-is-on-a-network-share) |389| `Not published: that file is on a network share` | [Errores de herramientas](#not-published-that-file-is-on-a-network-share) |
387| `The safety check for domain ... is rate-limited` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |394| `The safety check for domain ... is rate-limited` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |
388| `The safety check for domain ... is temporarily rate-limited` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |395| `The safety check for domain ... is temporarily rate-limited` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |
389| `Unable to verify if domain ... is safe to fetch` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |396| `Unable to verify if domain ... is safe to fetch` | [Errores de herramientas](#webfetch-domain-safety-check-failed) |
397| `MCP tool "<tool>" on server "<server>" gave no answer that could be read` / `answered without its text` | [Cómo se lee el resultado del hook de una herramienta MCP](https://code.claude.com/docs/es/hooks.md#how-the-tools-result-is-read) |
390| `Can't open MCP settings while no terminal is attached to this background session` | [Errores de sesión en segundo plano](#commands-refused-in-a-background-session) |398| `Can't open MCP settings while no terminal is attached to this background session` | [Errores de sesión en segundo plano](#commands-refused-in-a-background-session) |
391| `Can't open MCP settings in a background session` | [Errores de sesión en segundo plano](#commands-refused-in-a-background-session) |399| `Can't open MCP settings in a background session` | [Errores de sesión en segundo plano](#commands-refused-in-a-background-session) |
392| `blocked because the path is spelled in a form that cannot be safely resolved` | [Errores de sesión en segundo plano](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |400| `blocked because the path is spelled in a form that cannot be safely resolved` | [Errores de sesión en segundo plano](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
397| `Can't open — this session is running in another terminal` | [Errores de sesión en segundo plano](#this-session-is-running-in-another-terminal) |405| `Can't open — this session is running in another terminal` | [Errores de sesión en segundo plano](#this-session-is-running-in-another-terminal) |
398| `This conversation is already open in another running Claude session` | [Errores de sesión en segundo plano](#this-session-is-running-in-another-terminal) |406| `This conversation is already open in another running Claude session` | [Errores de sesión en segundo plano](#this-session-is-running-in-another-terminal) |
399| `This session's saved conversation is no longer on disk` | [Errores de sesión en segundo plano](#this-sessions-saved-conversation-is-no-longer-on-disk) |407| `This session's saved conversation is no longer on disk` | [Errores de sesión en segundo plano](#this-sessions-saved-conversation-is-no-longer-on-disk) |
408| `This forked session could not be started. Fork the conversation again to retry.` | [Errores de sesiones en segundo plano](#this-forked-session-could-not-be-started) |
400| `Bypass permissions was requested at launch and ignored` | [Bypass permissions ignorado en una sesión en segundo plano](https://code.claude.com/docs/es/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |409| `Bypass permissions was requested at launch and ignored` | [Bypass permissions ignorado en una sesión en segundo plano](https://code.claude.com/docs/es/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |
401| `kept <id> — its worktree is still at <path>` | [Errores de sesiones en segundo plano](#worktree-has-commits-that-are-not-pushed-anywhere) si la siguiente línea del mensaje menciona commits sin enviar; de lo contrario, [Qué elimina borrar una sesión](https://code.claude.com/docs/es/agent-view.md#what-deleting-a-session-removes) |410| `kept <id> — its worktree is still at <path>` | [Errores de sesiones en segundo plano](#worktree-has-commits-that-are-not-pushed-anywhere) si la siguiente línea del mensaje menciona commits sin enviar; de lo contrario, [Qué elimina borrar una sesión](https://code.claude.com/docs/es/agent-view.md#what-deleting-a-session-removes) |
402| `kept <id> — <n> unpushed commits on <branch>` | [Errores de sesión en segundo plano](#worktree-has-commits-that-are-not-pushed-anywhere) |411| `kept <id> — <n> unpushed commits on <branch>` | [Errores de sesión en segundo plano](#worktree-has-commits-that-are-not-pushed-anywhere) |
548| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/es/env-vars) | 10 | Número de reintentos. Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el valor predeterminado y elimina el límite. Redúcelo para que los fallos aparezcan más rápido en scripts. |557| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/es/env-vars) | 10 | Número de reintentos. Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el valor predeterminado y elimina el límite. Redúcelo para que los fallos aparezcan más rápido en scripts. |
549| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/es/env-vars) | sin establecer | Establécelo en `1` en sesiones desatendidas, como trabajos de CI, para reintentar errores de capacidad `429` y `529` indefinidamente en lugar de fallar después de `CLAUDE_CODE_MAX_RETRIES` intentos. Claude Code falla de inmediato cuando una solicitud de velocidad estándar recibe un `429` que reporta un límite de gasto o créditos de uso agotados, incluso uno de un [límite de gasto de un gateway](#spend-limit-reached) que se restablece según un calendario. Antes de v2.1.239, el watchdog los reintentaba indefinidamente. Para solicitudes en modo rápido, consulta [Handle rate limits](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). En v2.1.199 o posterior, también aumenta el número predeterminado de reintentos para otros errores transitorios, como errores del servidor, tiempos de espera agotados y conexiones perdidas, a 300, aproximadamente tres horas de retroceso, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si estableces esa variable explícitamente. |558| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/es/env-vars) | sin establecer | Establécelo en `1` en sesiones desatendidas, como trabajos de CI, para reintentar errores de capacidad `429` y `529` indefinidamente en lugar de fallar después de `CLAUDE_CODE_MAX_RETRIES` intentos. Claude Code falla de inmediato cuando una solicitud de velocidad estándar recibe un `429` que reporta un límite de gasto o créditos de uso agotados, incluso uno de un [límite de gasto de un gateway](#spend-limit-reached) que se restablece según un calendario. Antes de v2.1.239, el watchdog los reintentaba indefinidamente. Para solicitudes en modo rápido, consulta [Handle rate limits](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). En v2.1.199 o posterior, también aumenta el número predeterminado de reintentos para otros errores transitorios, como errores del servidor, tiempos de espera agotados y conexiones perdidas, a 300, aproximadamente tres horas de retroceso, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si estableces esa variable explícitamente. |
550| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/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. |559| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/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. |
560| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sin límite | Con `CLAUDE_CODE_RETRY_WATCHDOG` establecido, el tiempo máximo en milisegundos que una solicitud espera a que se restablezca el [límite de uso](#youve-hit-your-session-limit) de tu plan, como el límite de sesión o el semanal. Cuando el restablecimiento está más lejos que este límite, la solicitud falla de inmediato, a menos que los créditos de uso tengan margen o la API no haya podido comprobarlos. En esos casos se reintenta, y falla si se supera el límite antes de que tenga éxito. Requiere Claude Code v2.1.301 o posterior. |
551| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Intervalo mínimo en milisegundos entre comprobaciones de si un [límite de uso](#youve-hit-your-session-limit) ya se levantó, mientras una solicitud espera a que ese límite se restablezca con `CLAUDE_CODE_RETRY_WATCHDOG` establecido. Cuando una comprobación encuentra que el límite se levantó, la solicitud se envía de inmediato. Indica solo dígitos, de `60000` a `10800000`. Si no está establecido o está fuera de ese rango, no se realizan comprobaciones. Para saber cuándo Claude Code omite estas comprobaciones, consulta la [referencia de variables de entorno](https://code.claude.com/docs/es/env-vars.md). Requiere Claude Code v2.1.305 o posterior. |561| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Intervalo mínimo en milisegundos entre comprobaciones de si un [límite de uso](#youve-hit-your-session-limit) ya se levantó, mientras una solicitud espera a que ese límite se restablezca con `CLAUDE_CODE_RETRY_WATCHDOG` establecido. Cuando una comprobación encuentra que el límite se levantó, la solicitud se envía de inmediato. Indica solo dígitos, de `60000` a `10800000`. Si no está establecido o está fuera de ese rango, no se realizan comprobaciones. Para saber cuándo Claude Code omite estas comprobaciones, consulta la [referencia de variables de entorno](https://code.claude.com/docs/es/env-vars.md). Requiere Claude Code v2.1.305 o posterior. |
552| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/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](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/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](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |
553| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/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](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior. |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/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](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior. |
554| [`API_TIMEOUT_MS`](https://code.claude.com/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). |564| [`API_TIMEOUT_MS`](https://code.claude.com/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). |
555| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/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. |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/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. Para conocer el tiempo de espera de cada intento, consulta [Cuánto espera un intento sin streaming](#how-long-a-non-streaming-attempt-waits). Requiere Claude Code v2.1.285 o posterior. |
556| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/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). |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/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). |
557 567
568#### Cuánto espera un intento sin streaming
569
570Un intento sin streaming termina al agotarse su tiempo de espera de solicitud o su tiempo de espera de inactividad del cuerpo, lo que ocurra primero:
571
572* **Tiempo de espera de solicitud**: `API_TIMEOUT_MS` cuando estableces un valor positivo; de lo contrario, 300 segundos en una sesión local.
573* **[Tiempo de espera de inactividad del cuerpo](https://code.claude.com/docs/es/network-config.md#streaming-idle-watchdogs)**: de 5 a 6 minutos sin respuesta, por alto que establezcas `API_TIMEOUT_MS`, en los casos en que se aplica y no lo has desactivado.
574
558## Errores del servidor575## Errores del servidor
559 576
560La mayoría de estos errores provienen del proveedor de inferencia: el servicio de Anthropic en la API de Anthropic, y el servicio detrás del endpoint de ese proveedor en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizado. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) y [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) también cubren causas de tu lado, como una cuenta de Amazon Bedrock que no puede invocar el modelo clasificador o un subagente que alcanzó un límite de uso.577La mayoría de estos errores provienen del proveedor de inferencia: el servicio de Anthropic en la API de Anthropic, y el servicio detrás del endpoint de ese proveedor en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizado. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) y [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) también cubren causas de tu lado, como una cuenta de Amazon Bedrock que no puede invocar el modelo clasificador o un subagente que alcanzó un límite de uso.
1436 1453
1437Este no es el mismo estado que [Token de OAuth revocado o expirado](#oauth-token-revoked-or-expired). Esos mensajes informan un rechazo que devolvió la API. Claude Code genera por sí mismo `Login expired` para un inicio de sesión que ya no logró renovar, así que no envía ninguna solicitud. Cuando la renovación falla porque la propia cuenta está suspendida y no porque el inicio de sesión esté obsoleto, Claude Code muestra [Tu cuenta está en espera](#your-account-is-on-hold) en su lugar.1454Este no es el mismo estado que [Token de OAuth revocado o expirado](#oauth-token-revoked-or-expired). Esos mensajes informan un rechazo que devolvió la API. Claude Code genera por sí mismo `Login expired` para un inicio de sesión que ya no logró renovar, así que no envía ninguna solicitud. Cuando la renovación falla porque la propia cuenta está suspendida y no porque el inicio de sesión esté obsoleto, Claude Code muestra [Tu cuenta está en espera](#your-account-is-on-hold) en su lugar.
1438 1455
1439Las sesiones autenticadas con una clave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/es/env-vars) o un proveedor de terceros no usan el inicio de sesión guardado y nunca ven este mensaje.
1440
1441Puedes comprobar este estado antes de que falle una solicitud: [`/status`](https://code.claude.com/docs/es/commands) muestra una fila `Login` que dice `Expired — log in again`, junto con la organización y el correo electrónico que tiene guardados para el inicio de sesión expirado. La fila aparece solo cuando el inicio de sesión guardado es tu credencial activa y ya no se puede renovar. Las sesiones autenticadas de otra forma no muestran la fila, aunque siga guardado un inicio de sesión expirado. Antes de la v2.1.210, `/status` no daba ninguna indicación en este estado de que alguna vez hubiera existido un inicio de sesión, porque la credencial borrada no le dejaba nada que informar.1456Puedes comprobar este estado antes de que falle una solicitud: [`/status`](https://code.claude.com/docs/es/commands) muestra una fila `Login` que dice `Expired — log in again`, junto con la organización y el correo electrónico que tiene guardados para el inicio de sesión expirado. La fila aparece solo cuando el inicio de sesión guardado es tu credencial activa y ya no se puede renovar. Las sesiones autenticadas de otra forma no muestran la fila, aunque siga guardado un inicio de sesión expirado. Antes de la v2.1.210, `/status` no daba ninguna indicación en este estado de que alguna vez hubiera existido un inicio de sesión, porque la credencial borrada no le dejaba nada que informar.
1442 1457
1443**Qué hacer:**1458**Qué hacer:**
1461Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1476Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1462```1477```
1463 1478
1464Las sesiones autenticadas con una clave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/es/env-vars) o un proveedor de terceros no usan el inicio de sesión guardado y nunca ven este mensaje.
1465
1466**Qué hacer:**1479**Qué hacer:**
1467 1480
1468* Vuelve a intentarlo en un minuto. Si otro proceso completa antes la renovación, esta sesión usa el inicio de sesión renovado.1481* Vuelve a intentarlo en un minuto. Si otro proceso completa antes la renovación, esta sesión usa el inicio de sesión renovado.
1469* Si el mensaje sigue apareciendo, cierra las demás ventanas y procesos de Claude Code y luego reintenta.1482* Si el mensaje sigue apareciendo, cierra las demás ventanas y procesos de Claude Code y luego reintenta.
1470* Si vuelve a aparecer sin ningún otro proceso de Claude Code en ejecución, ejecuta `/login`. Volver a iniciar sesión no espera al bloqueo de renovación.1483* Si vuelve a aparecer sin ningún otro proceso de Claude Code en ejecución, ejecuta `/login`. Volver a iniciar sesión no espera al bloqueo de renovación.
1471 1484
1485### Could not refresh your login: the disk that holds the Claude Code config directory is full
1486
1487Libera espacio en el disco que contiene el directorio de configuración de Claude Code y luego vuelve a enviar tu mensaje. Volver a iniciar sesión no ayudaría mientras el disco esté lleno, porque no se podría guardar un inicio de sesión nuevo. El directorio de configuración es `~/.claude` en tu directorio home, a menos que definas [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/es/env-vars).
1488
1489```text wrap theme={null}
1490Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full · Delete files you no longer need on that disk, then try again · Signing in again won't help
1491```
1492
1493En [modo no interactivo](https://code.claude.com/docs/es/headless.md) (`-p`) y en el [Agent SDK](https://code.claude.com/docs/es/agent-sdk/overview.md), el mensaje dice:
1494
1495```text wrap theme={null}
1496Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full. Delete files you no longer need on that disk and retry; signing in again won't help
1497```
1498
1499**Qué hacer:**
1500
1501* En el caso de un script, vuelve a ejecutar su comando `claude -p`
1502* Si el disco ya muestra espacio libre, quedarse sin cuota de disco o sin inodos produce el mismo mensaje. Elimina tus propios archivos de ese disco. Si el mensaje vuelve a aparecer, elimina muchos archivos pequeños en lugar de unos pocos grandes, porque cada archivo ocupa un inodo sin importar su tamaño.
1503
1472### No se pudo guardar tu inicio de sesión1504### No se pudo guardar tu inicio de sesión
1473 1505
1474Iniciaste sesión con claude.ai, pero Claude Code no pudo guardar el inicio de sesión en su almacén de credenciales, así que el inicio de sesión no se completó. En macOS esto puede ocurrir cuando el llavero de inicio de sesión se bloquea, por ejemplo al entrar en reposo o por inactividad, después de que Claude Code ya haya leído o guardado credenciales en él durante la misma sesión.1506Iniciaste sesión con claude.ai, pero Claude Code no pudo guardar el inicio de sesión en su almacén de credenciales, así que el inicio de sesión no se completó. En macOS esto puede ocurrir cuando el llavero de inicio de sesión se bloquea, por ejemplo al entrar en reposo o por inactividad, después de que Claude Code ya haya leído o guardado credenciales en él durante la misma sesión.
2187Este error no es un problema de red del lado del cliente. Las sesiones en la nube y las [tareas programadas en la nube](https://code.claude.com/docs/es/routines.md) se ejecutan dentro de una VM aislada cuyo tráfico saliente a través de la red de la sesión se filtra según la lista de permitidos del [entorno en la nube](https://code.claude.com/docs/es/cloud-environments.md):2219Este error no es un problema de red del lado del cliente. Las sesiones en la nube y las [tareas programadas en la nube](https://code.claude.com/docs/es/routines.md) se ejecutan dentro de una VM aislada cuyo tráfico saliente a través de la red de la sesión se filtra según la lista de permitidos del [entorno en la nube](https://code.claude.com/docs/es/cloud-environments.md):
2188 2220
2189* **Tráfico de GitHub y de conectores**: las [operaciones de GitHub](https://code.claude.com/docs/es/cloud-environments.md#github-proxy) y el tráfico de los conectores MCP usan canales separados, por eso pueden seguir funcionando mientras otros hosts están bloqueados2221* **Tráfico de GitHub y de conectores**: las [operaciones de GitHub](https://code.claude.com/docs/es/cloud-environments.md#github-proxy) y el tráfico de los conectores MCP usan canales separados, por eso pueden seguir funcionando mientras otros hosts están bloqueados
2190* **Entorno predeterminado**: el entorno **Default** usa acceso **Trusted**, que permite la [lista de permitidos predeterminada](https://code.claude.com/docs/es/cloud-environments.md#default-allowed-domains) de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes, y bloquea otros dominios en esa ruta2222* **Entorno predeterminado**: el entorno **Default** usa acceso **Limited** con **Allow package managers** marcado. Sus sesiones alcanzan la [lista de permitidos predeterminada](https://code.claude.com/docs/es/cloud-environments.md#default-allowed-domains) de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes.
2191 2223
2192**Qué hacer:**2224**Qué hacer:**
2193 2225
2194Estos pasos cambian uno de tus propios entornos. Un [entorno compartido por la organización](https://code.claude.com/docs/es/cloud-environments.md#organization-shared-environments) se abre como de solo lectura en el selector, así que pide a un Owner que cambie su acceso a la red desde la página **Cloud environments** en la [configuración de administración](https://claude.ai/admin-settings).2226Estos pasos cambian uno de tus propios entornos. Un [entorno compartido por la organización](https://code.claude.com/docs/es/cloud-environments.md#organization-shared-environments) se abre como de solo lectura en el selector, así que pide a un Owner que cambie su acceso a la red desde la página **Cloud environments** en la [configuración de administración](https://claude.ai/admin-settings).
2195 2227
2196* Abre tu entorno para editarlo, ya sea desde el [formulario de la tarea programada en la nube](https://code.claude.com/docs/es/routines.md#environments-and-network-access) o desde el [selector de entornos](https://code.claude.com/docs/es/cloud-environments.md#configure-your-environment) donde inicias sesiones en la nube.2228* Abre tu entorno para editarlo, ya sea desde el [formulario de la tarea programada en la nube](https://code.claude.com/docs/es/routines.md#environments-and-network-access) o desde el [selector de entornos](https://code.claude.com/docs/es/cloud-environments.md#configure-your-environment) donde inicias sesiones en la nube.
2197* En el diálogo **Edit cloud environment**, cambia **Network access** de **Trusted** a **Custom** y luego agrega el dominio bloqueado a **Allowed domains**. Ingresa un dominio por línea. Marca **Also include default list of common package managers** para conservar la [lista de permitidos predeterminada](https://code.claude.com/docs/es/cloud-environments.md#default-allowed-domains) junto con tus dominios personalizados. Selecciona **Full** en su lugar si quieres acceso sin restricciones.2229* En el diálogo **Edit cloud environment**, selecciona **Limited** en **Network access** y luego agrega el dominio bloqueado a **Allowed domains**. Ingresa un dominio por línea. Marca **Allow package managers** para permitir la [lista de permitidos predeterminada](https://code.claude.com/docs/es/cloud-environments.md#default-allowed-domains) junto con tus propios dominios. Selecciona **Full** en su lugar si quieres acceso sin restricciones.
2198* Haz clic en **Save changes**. La siguiente ejecución usa la lista de permitidos actualizada. Para una sesión en la nube que ya está abierta, consulta [cuándo llega un cambio de acceso a la red a las sesiones existentes](https://code.claude.com/docs/es/cloud-environments.md#network-access).2230* Haz clic en **Save changes**. La siguiente ejecución usa la lista de permitidos actualizada. Para una sesión en la nube que ya está abierta, consulta [cuándo llega un cambio de acceso a la red a las sesiones existentes](https://code.claude.com/docs/es/cloud-environments.md#network-access).
2199 2231
2200Consulta [Acceso a la red](https://code.claude.com/docs/es/cloud-environments.md#network-access) para conocer los niveles de acceso y la lista de permitidos predeterminada. Las sesiones locales de la CLI no se ven afectadas por esta política.2232Consulta [Acceso a la red](https://code.claude.com/docs/es/cloud-environments.md#network-access) para conocer los niveles de acceso y la lista de permitidos predeterminada. Las sesiones locales de la CLI no se ven afectadas por esta política.
2317**Qué hacer:**2349**Qué hacer:**
2318 2350
2319* **Sin sesión iniciada**: el mensaje continúa con `: not signed in. Run /login, then retry.` Ejecuta `/login` y vuelve a enviar2351* **Sin sesión iniciada**: el mensaje continúa con `: not signed in. Run /login, then retry.` Ejecuta `/login` y vuelve a enviar
2320* **Rechazo de tu organización**: por ejemplo, `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` Si el mensaje agrega `To report a bug, open an issue`, hazlo en [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). A partir de entonces, `/feedback` puede responder durante siete días que está [desactivado por la política de tu organización](#feedback-is-disabled-by-your-organizations-policy). Un borrador en cola permanece en la cola y aun así [caduca según lo programado](https://code.claude.com/docs/es/tools-reference.md#discard-or-keep-a-draft)2352* **Rechazo de tu organización**: por ejemplo, `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` A partir de entonces, `/feedback` puede responder durante siete días que está [desactivado por la política de tu organización](#feedback-is-disabled-by-your-organizations-policy). Un borrador en cola permanece en la cola y aun así [caduca según lo programado](https://code.claude.com/docs/es/tools-reference.md#discard-or-keep-a-draft)
2321* **Credenciales rechazadas**: el mensaje continúa con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Ejecuta `/status` en el prompt de Claude Code para ver qué inicio de sesión, token o clave de API envía esta sesión2353* **Credenciales rechazadas**: el mensaje continúa con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Ejecuta `/status` en el prompt de Claude Code para ver qué inicio de sesión, token o clave de API envía esta sesión
2322* **`(request timed out)` o `(couldn't reach the service)` justo después de `Couldn't send feedback`**: vuelve a enviar el informe o el borrador en cola. El diálogo conserva tu texto, y el mensaje de un borrador en cola dice `The draft is still queued.` Si otras solicitudes también están fallando, revisa tu conexión de red y consulta [Unable to connect to API](#unable-to-connect-to-api). Si sigue fallando, presenta el informe en [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2354* **`(request timed out)` o `(couldn't reach the service)` justo después de `Couldn't send feedback`**: vuelve a enviar el informe o el borrador en cola. El diálogo conserva tu texto, y el mensaje de un borrador en cola dice `The draft is still queued.` Si otras solicitudes también están fallando, revisa tu conexión de red y consulta [Unable to connect to API](#unable-to-connect-to-api). Si sigue fallando, presenta el informe en [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)
2323* **`(server returned <status>)`, o ningún motivo, justo después de `Couldn't send feedback`**: el estado es el código de respuesta del servicio. El mensaje propio del servicio lo sigue cuando se envió uno, como en `(server returned 403: Access Forbidden)`. Si sigue fallando, presenta el informe en [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2355* **`(server returned <status>)`, o ningún motivo, justo después de `Couldn't send feedback`**: el estado es el código de respuesta del servicio. El mensaje propio del servicio lo sigue cuando se envió uno, como en `(server returned 403: Access Forbidden)`. Si sigue fallando, presenta el informe en [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)
2442 2474
2443### El contexto supera el límite de tokens2475### El contexto supera el límite de tokens
2444 2476
2445`/context` muestra esta advertencia al principio de su salida cuando la conversación ha crecido más allá de la ventana de contexto del modelo. Las solicitudes fallan con [`Prompt is too long`](#prompt-is-too-long) hasta que liberes espacio. Una sesión interactiva muestra ese error como la línea `Context limit reached`.2477`/context` muestra esta advertencia al principio de su salida cuando la conversación ha crecido más allá de la ventana de contexto del modelo:
2446 2478
2447```text theme={null}2479```text theme={null}
2448Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.2480Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
2449```2481```
2450 2482
2483Después de una advertencia `Context exceeds`, no necesitas ejecutar ninguno de los dos comandos mientras la [compactación automática](https://code.claude.com/docs/es/settings-reference.md#autocompactenabled) esté activada, que es lo predeterminado:
2484
2485* **Compactación automática activada**: envía tu siguiente mensaje. Si aún falla con [`Prompt is too long`](#prompt-is-too-long), consulta esa entrada.
2486* **Compactación automática desactivada**: en la sesión, ejecuta `/compact` si la advertencia lo menciona, o `/clear` para empezar de nuevo. Hasta que ejecutes uno, los mensajes fallan con `Context limit reached`, o con `Prompt is too long` en la salida de `-p`.
2487
2451Cuando el límite que superaste es una ventana de compactación, como el límite de 200K en los modelos con contexto de 1M, la advertencia se redacta de otra manera. Una ventana de compactación puede estar por debajo de la ventana de contexto del modelo, por lo que las solicitudes que la superan aún pueden tener éxito.2488Cuando el límite que superaste es una ventana de compactación, como el límite de 200K en los modelos con contexto de 1M, la advertencia se redacta de otra manera. Una ventana de compactación puede estar por debajo de la ventana de contexto del modelo, por lo que las solicitudes que la superan aún pueden tener éxito.
2452 2489
2453```text theme={null}2490```text theme={null}
2458 2495
2459**Qué hacer:**2496**Qué hacer:**
2460 2497
2461* En una conversación de varios turnos, ejecuta `/compact` para resumir los turnos anteriores y liberar espacio. Para empezar de nuevo, ejecuta `/clear`2498* **Después de una advertencia de ventana de compactación**: en una conversación de varios turnos, ejecuta `/compact` para resumir los turnos anteriores y liberar espacio. Para empezar de nuevo, ejecuta `/clear`.
2462* Para conocer más formas de reducir el uso, consulta [El prompt es demasiado largo](#prompt-is-too-long)2499* Para conocer más formas de reducir el uso, consulta [El prompt es demasiado largo](#prompt-is-too-long)
2463 2500
2464Antes de v2.1.216, `/context` mostraba un uso superior al 100% sin ninguna línea de advertencia que explicara qué significaba eso o cómo recuperarse.2501Antes de v2.1.216, `/context` mostraba un uso superior al 100% sin ninguna línea de advertencia que explicara qué significaba eso o cómo recuperarse.
3302 3339
3303### Configuration error in \~/.claude.json3340### Configuration error in \~/.claude.json
3304 3341
3305Claude Code no pudo analizar `~/.claude.json`, el archivo que contiene los datos de tu cuenta, tus servidores MCP y el estado por proyecto. Tu archivo no se modificó. Un inicio [no interactivo](https://code.claude.com/docs/es/headless.md) como `claude -p` sale con el código 1 cada vez hasta que repares el archivo.3342Claude Code no pudo analizar `~/.claude.json`, el archivo que contiene los datos de tu cuenta, los servidores MCP y el estado de cada proyecto. Un inicio [no interactivo](https://code.claude.com/docs/es/headless.md) como `claude -p` termina con el código 1.
3306 3343
3307Cuando Claude Code encuentra una [copia de seguridad](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically), la salida la menciona e imprime una línea `cp` que la copia de vuelta:3344Cuando Claude Code encuentra una [copia de seguridad](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically), la salida la menciona e imprime una línea `cp` que la copia de vuelta:
3308 3345
3317 3354
3318**Qué hacer:**3355**Qué hacer:**
3319 3356
3320* **La salida tiene una línea `cp`**: ejecuta esa línea en tu terminal. En Windows, ejecútala en PowerShell. Reemplaza el archivo dañado con la copia de seguridad, una versión anterior de `~/.claude.json`.3357* **La salida tiene una línea `cp`**: ejecuta esa línea en tu terminal. En Windows, ejecútala en PowerShell.
3321* **La salida no tiene una línea `cp`, o el error vuelve después de ejecutarla**: corrige el JSON en `~/.claude.json`, copia encima otro archivo `.claude.json.backup.<timestamp>` de [`~/.claude/backups/`](https://code.claude.com/docs/es/claude-directory#cleaned-up-automatically) si hay uno, o cámbiale el nombre. Sin un archivo en `~/.claude.json`, Claude Code se inicia con la configuración predeterminada y sin nada de lo que contenía el archivo.3358* **La salida no tiene una línea `cp`, o el error vuelve después de ejecutarla**: si `~/.claude.json` todavía tiene tu configuración, corrige su JSON. Si no puedes, copia encima otro archivo `.claude.json.backup.<timestamp>` de [`~/.claude/backups/`](https://code.claude.com/docs/es/claude-directory#cleaned-up-automatically) si existe, o cámbiale el nombre. Sin ningún archivo en `~/.claude.json`, Claude Code se inicia con la configuración predeterminada y sin nada de lo que contenía el archivo.
3322 3359* **`~/.claude.json` ya no tiene tu configuración**: busca un archivo `.claude.json.corrupted.<timestamp>` que todavía la tenga, en [`~/.claude/backups/`](https://code.claude.com/docs/es/claude-directory#cleaned-up-automatically) o en tu directorio home. Corrige su JSON y luego cópialo sobre `~/.claude.json`. Si no puedes encontrar ni corregir ninguno, intenta los mismos pasos con un archivo `.claude.json.backup.<timestamp>` que tenga tu configuración. Si ninguno la tiene, cambia el nombre de `~/.claude.json` y vuelve a agregar tus servidores MCP con [`claude mcp add`](https://code.claude.com/docs/es/mcp#installing-mcp-servers).
3323Antes de v2.1.318, te quedabas con los valores predeterminados en `~/.claude.json` después de que un inicio no interactivo imprimiera este error, así que el siguiente inicio se ejecutaba sin tu configuración.
3324 3360
3325### Claude configuration file was empty and no backup holds anything3361### Claude configuration file was empty and no backup holds anything
3326 3362
3381 3417
3382Antes de v2.1.309, Claude Code imprimía solo el texto de error del sistema operativo cuando el volumen estaba lleno o tu cuota se había agotado. Un ejemplo es `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`, y se aplican los mismos pasos.3418Antes de v2.1.309, Claude Code imprimía solo el texto de error del sistema operativo cuando el volumen estaba lleno o tu cuota se había agotado. Un ejemplo es `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`, y se aplican los mismos pasos.
3383 3419
3420### Claude Code no pudo guardar porque el disco está lleno
3421
3422Esta línea en stderr después de una ejecución de [`claude -p`](https://code.claude.com/docs/es/headless) significa que el disco está lleno o tu cuota de disco se agotó, así que Claude Code no pudo guardar todo lo de la ejecución:
3423
3424```text wrap theme={null}
3425Error: Claude Code could not save all of this session's transcript under /Users/you/.claude because the disk is full (ENOSPC). If you resume this session, part of the conversation may be missing. Free up space on that disk before the next run.
3426```
3427
3428Con salida de texto o `json`, la ejecución termina con código 1, y la respuesta ya se imprimió. Con salida `stream-json`, la ejecución conserva su código de salida habitual, y la respuesta llega de todos modos.
3429
3430**Qué hacer:**
3431
3432* **`the disk is full (ENOSPC)`**: antes de tu próxima ejecución, libera espacio en el disco que contiene la ruta del mensaje
3433* **`your disk quota is used up (EDQUOT)`**: antes de tu próxima ejecución, libera espacio o solicita una cuota mayor
3434
3384### No se pudo resolver el directorio a una ubicación real3435### No se pudo resolver el directorio a una ubicación real
3385 3436
3386Ejecutaste `/add-dir` para un subdirectorio de tu directorio de trabajo, y Claude Code no pudo resolver el directorio a su ubicación real.3437Ejecutaste `/add-dir` para un subdirectorio de tu directorio de trabajo, y Claude Code no pudo resolver el directorio a su ubicación real.
3452 3503
3453Antes de v2.1.309, `claude ultrareview` no aceptaba `--trust-workspace`.3504Antes de v2.1.309, `claude ultrareview` no aceptaba `--trust-workspace`.
3454 3505
3506### Remote Control no se inició porque una pregunta no obtuvo respuesta
3507
3508Este mensaje significa que [`claude remote-control`](https://code.claude.com/docs/es/remote-control) hizo la pregunta de primera ejecución citada en el mensaje y no obtuvo respuesta:
3509
3510```text theme={null}
3511Remote Control did not start: "Enable Remote Control?" got no answer. Run `claude remote-control` at a terminal and answer y once; it won't ask again.
3512Remote Control did not start: "Choose [1/2] (default: 1):" got no answer. You can run `claude remote-control` and choose, or pass --spawn=same-dir or --spawn=worktree.
3513```
3514
3515**Qué hacer:**
3516
3517* **`Enable Remote Control?`**: en un script o un servicio, la entrada estándar termina antes de que alguien pueda responder. Ejecuta `claude remote-control` una vez en una terminal, como el usuario con el que se ejecuta tu script o servicio, y responde `y`.
3518* **`Choose [1/2] (default: 1):`**: vuelve a ejecutar `claude remote-control` y [elige un modo de creación](https://code.claude.com/docs/es/remote-control.md#set-the-default-spawn-mode-for-a-project), o pasa [`--spawn=same-dir` o `--spawn=worktree`](https://code.claude.com/docs/es/remote-control#start-a-remote-control-session) para omitir la pregunta
3519
3455### No se transfiere a las sesiones que inicia Remote Control3520### No se transfiere a las sesiones que inicia Remote Control
3456 3521
3457Iniciaste [Remote Control](https://code.claude.com/docs/es/remote-control.md) con un flag global de `claude` antes del verbo `remote-control`, uno que restringiría o configuraría las sesiones que inicia Remote Control, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag colocado antes del verbo nunca llega a esas sesiones. En su lugar, Claude Code se niega a iniciar y nombra el flag:3522Iniciaste [Remote Control](https://code.claude.com/docs/es/remote-control.md) con un flag global de `claude` antes del verbo `remote-control`, uno que restringiría o configuraría las sesiones que inicia Remote Control, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag colocado antes del verbo nunca llega a esas sesiones. En su lugar, Claude Code se niega a iniciar y nombra el flag:
3499 3564
3500* No has iniciado una sesión desde la instalación, así que Claude Code todavía no ha obtenido el flag. El primer `claude import` puede imprimir esto aunque la función esté disponible para ti.3565* No has iniciado una sesión desde la instalación, así que Claude Code todavía no ha obtenido el flag. El primer `claude import` puede imprimir esto aunque la función esté disponible para ti.
3501* Usas Claude Code a través de Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry o Claude Platform on AWS, o a través de un [gateway de aplicaciones de Claude](https://code.claude.com/docs/es/claude-apps-gateway#availability-and-limitations). Claude Code no obtiene feature flags en estas sesiones, así que `claude import` sigue sin estar disponible.3566* Usas Claude Code a través de Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry o Claude Platform on AWS, o a través de un [gateway de aplicaciones de Claude](https://code.claude.com/docs/es/claude-apps-gateway#availability-and-limitations). Claude Code no obtiene feature flags en estas sesiones, así que `claude import` sigue sin estar disponible.
3502* Estableciste `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/es/env-vars), que desactivan la obtención de feature flags, así que `claude import` sigue sin estar disponible.3567* Estableciste `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/es/env-vars#variables), `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/es/env-vars), que desactivan la obtención de feature flags, así que `claude import` sigue sin estar disponible.
3503 3568
3504**Qué hacer:**3569**Qué hacer:**
3505 3570
3741 3806
3742Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:3807Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:
3743 3808
3744* `Shell command permission check failed for pattern "..."`: la verificación de permisos del comando no lo permitió. [Verificaciones de permisos en comandos inyectados](https://code.claude.com/docs/es/skills.md#permission-checks-on-injected-commands) explica qué resultados provocan la cancelación en cada modo de permisos y cómo aprobar previamente un comando con `allowed-tools`3809* `Shell command permission check failed for pattern "..."`: la comprobación de permisos del comando no lo permitió. [Comprobaciones de permisos en comandos inyectados](https://code.claude.com/docs/es/skills.md#permission-checks-on-injected-commands) explica qué resultados abortan en cada modo de permisos y cómo aprobar previamente un comando con `allowed-tools`
3745* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: el frontmatter del skill exige bash en una máquina que no lo tiene. Instala Git for Windows o cambia el frontmatter a `shell: powershell`. Consulta [Cómo se ejecutan los comandos inyectados](https://code.claude.com/docs/es/skills.md#how-injected-commands-run)3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: el frontmatter del skill exige bash en una máquina que no lo tiene. Instala Git for Windows o cambia el frontmatter a `shell: powershell`. Consulta [Cómo se ejecutan los comandos inyectados](https://code.claude.com/docs/es/skills.md#how-injected-commands-run)
3746 3811
3747**Qué hacer:**3812**Qué hacer:**
3895 3960
3896* **No pasaste una rama base**: Claude Code comparó contra la rama predeterminada del repositorio y sugiere pasar tu base explícitamente, como en el ejemplo anterior3961* **No pasaste una rama base**: Claude Code comparó contra la rama predeterminada del repositorio y sugiere pasar tu base explícitamente, como en el ejemplo anterior
3897* **Pasaste una rama base que ya estaba en tu clon**: la sugerencia dice ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3962* **Pasaste una rama base que ya estaba en tu clon**: la sugerencia dice ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3898* **Pasaste una rama base que no estaba en tu clon**: Claude Code la obtuvo de origin antes de comparar. La sugerencia dice ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; cuando Claude Code no puede determinar si tu clon es superficial (shallow), sugiere `git fetch --unshallow origin` en su lugar. Antes de la v2.1.221, la sugerencia proponía `git fetch --unshallow origin` para toda rama base obtenida, y en un clon completo ese comando falla con `fatal: --unshallow on a complete repository does not make sense`.3963* **Pasaste una rama base que no estaba en tu clon**: Claude Code la obtuvo de origin antes de comparar. La sugerencia dice ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; cuando Claude Code no puede saber si tu clon es superficial, sugiere `git fetch --unshallow origin` en su lugar. Antes de v2.1.221, la sugerencia proponía `git fetch --unshallow origin` para cada rama base obtenida, y en un clon completo ese comando falla con `fatal: --unshallow on a complete repository does not make sense`.
3899 3964
3900**Qué hacer:**3965**Qué hacer:**
3901 3966
4457* Si el mensaje termina con `EACCES`, restaura tu permiso de ejecución en cada directorio que conduce al archivo o carpeta que indica la ruta. Revisa los directorios por encima de la ruta y luego sigue cada enlace simbólico que encuentres y revisa los directorios que conducen a donde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo verificar](#path-could-not-be-checked).4522* Si el mensaje termina con `EACCES`, restaura tu permiso de ejecución en cada directorio que conduce al archivo o carpeta que indica la ruta. Revisa los directorios por encima de la ruta y luego sigue cada enlace simbólico que encuentres y revisa los directorios que conducen a donde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo verificar](#path-could-not-be-checked).
4458* Para compartir archivos con otros plugins en el mismo marketplace, vincúlelos con un enlace simbólico dentro del directorio del plugin, siguiendo las [reglas de enlace simbólico](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)4523* Para compartir archivos con otros plugins en el mismo marketplace, vincúlelos con un enlace simbólico dentro del directorio del plugin, siguiendo las [reglas de enlace simbólico](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)
4459 4524
4525### Server file path not read
4526
4527El mensaje `path not read` significa que Claude Code no leyó un archivo de servidor MCP o LSP que nombra un plugin, debido a la ruta del archivo. El resto del plugin se carga, sin los servidores que define el archivo.
4528
4529Una parte `..` cuenta incluso cuando la ruta permanece dentro del plugin, como en este ejemplo:
4530
4531```text theme={null}
4532mcp-servers path not read: ./sub/../x.json is absolute or has a ".." part
4533```
4534
4535**Qué hacer:**
4536
4537* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor
4538* Si mantienes el plugin, conserva el archivo de servidor dentro del directorio del plugin. Nómbralo en el manifiesto o en la entrada de marketplace con una ruta que comience con `./` y no tenga `..`, por ejemplo `./servers/x.json`
4539* Para compartir un archivo de servidor entre plugins del mismo marketplace, vincula el archivo en cada plugin con un enlace simbólico, siguiendo las [reglas de enlaces simbólicos](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)
4540
4460### Plugin not loaded: its manifest was not read4541### Plugin not loaded: its manifest was not read
4461 4542
4462Claude Code no pudo confirmar que el [manifiesto](https://code.claude.com/docs/es/plugins/manifest-reference.md) de un plugin de marketplace en `.claude-plugin/plugin.json` está dentro del plugin, por lo que no carga nada de ese plugin. Para un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), Claude Code tampoco pudo confirmar que el manifiesto está dentro de ese marketplace. El mensaje aparece en la pestaña **Errors** de `/plugin`, y el motivo al final indica lo que encontró Claude Code.4543Claude Code no pudo confirmar que el [manifiesto](https://code.claude.com/docs/es/plugins/manifest-reference.md) de un plugin de marketplace en `.claude-plugin/plugin.json` está dentro del plugin, por lo que no carga nada de ese plugin. Para un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), Claude Code tampoco pudo confirmar que el manifiesto está dentro de ese marketplace. El mensaje aparece en la pestaña **Errors** de `/plugin`, y el motivo al final indica lo que encontró Claude Code.
5065 5146
5066Antes de la v2.1.280, el rechazo `where it leads on disk could not be determined` no aparecía.5147Antes de la v2.1.280, el rechazo `where it leads on disk could not be determined` no aparecía.
5067 5148
5149### The search failed, so this is not a "no matches" result
5150
5151Una búsqueda de [Grep](https://code.claude.com/docs/es/tools-reference.md#grep-tool-behavior) o [Glob](https://code.claude.com/docs/es/tools-reference.md#glob-tool-behavior) que ejecutó Claude falló antes de devolver algún resultado, así que no se sabe si existen coincidencias. El mensaje que recibe Claude en lugar de los resultados empieza así:
5152
5153```text wrap theme={null}
5154The search failed, so this is not a "no matches" result: matches may exist. What happened to the search program (ripgrep) is not known, and no results were read. Run the search once more. If it fails again, tell the user that searches are failing.
5155```
5156
5157**Qué hacer:**
5158
5159* **La primera vez que aparece**: nada. El mensaje le pide a Claude que primero vuelva a buscar.
5160* **Si Claude dice que las búsquedas están fallando**: captura el error de ripgrep para un reporte de error:
5161 1. Desde tu shell, inicia una sesión con los mismos flags que la sesión donde fallaron las búsquedas, más [`--debug-file claude-debug.log`](https://code.claude.com/docs/es/cli-reference#cli-flags)
5162 2. Envíale a Claude la solicitud que provocó la búsqueda fallida
5163 3. Si la búsqueda vuelve a fallar, busca la línea que contiene `rg error (signal=` en `claude-debug.log`
5164 4. Incluye esa línea cuando [reportes el problema](#report-an-error)
5165
5068### Task output swap refused5166### Task output swap refused
5069 5167
5070Claude 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:5168Claude 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:
5153 5251
5154Antes 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.5252Antes 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.
5155 5253
5254### Refusing to apply edits: a hook is configured for file edits in this session
5255
5256Claude intentó publicar un [artefacto](https://code.claude.com/docs/es/artifacts.md) con una [actualización en un solo paso](https://code.claude.com/docs/es/artifacts.md#turn-off-one-step-artifact-updates), un pequeño cambio en el archivo del artefacto incluido en la publicación, y Claude Code lo rechazó. No se publicó nada y el archivo no cambió. El mensaje aparece en el resultado de la herramienta Artifact:
5257
5258```text wrap theme={null}
5259Refusing to apply edits to <path>: a hook is configured for file edits in this session, so a publish can't apply edits here. Edit the file, then publish it without edits. Nothing was published.
5260```
5261
5262Claude Code no permite actualizaciones en un solo paso mientras tu sesión tenga un [hook `PreToolUse`](https://code.claude.com/docs/es/hooks#pretooluse) o un [mod](https://code.claude.com/docs/es/plugins/mods/overview.md) sobre `Edit` o `Write`.
5263
5264**Qué hacer:**
5265
5266* Nada, si Claude pasó a editar el archivo y publicarlo
5267* Si Claude se detuvo en el mensaje, pídele a Claude que edite el archivo y lo publique
5268* Si el mensaje sigue apareciendo, cierra Claude Code y vuelve a abrirlo
5269* Si el mensaje vuelve a aparecer incluso después de volver a abrirlo, [desactiva las actualizaciones en un solo paso](https://code.claude.com/docs/es/artifacts.md#turn-off-one-step-artifact-updates)
5270
5156### The source file is not valid UTF-8 text5271### The source file is not valid UTF-8 text
5157 5272
5158Claude intentó publicar un [artefacto](https://code.claude.com/docs/es/artifacts.md) 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:5273Claude intentó publicar un [artefacto](https://code.claude.com/docs/es/artifacts.md) 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:
5623 5738
5624* Vuelve a crear el directorio que nombra el mensaje, o haz el envío desde un directorio que exista, y luego inténtalo de nuevo5739* Vuelve a crear el directorio que nombra el mensaje, o haz el envío desde un directorio que exista, y luego inténtalo de nuevo
5625 5740
5741### Esta sesión bifurcada no se pudo iniciar
5742
5743[Bifurcaste una sesión de Remote Control](https://code.claude.com/docs/es/remote-control.md#fork-a-session-from-your-browser) desde claude.ai, y Claude Code no pudo terminar de iniciar la [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md) que ejecuta la bifurcación en tu máquina. Este aviso aparece en la transcripción de la sesión bifurcada:
5744
5745```text theme={null}
5746This forked session could not be started. Fork the conversation again to retry.
5747```
5748
5749La sesión que bifurcaste sigue ejecutándose.
5750
5751**Qué hacer:**
5752
5753* Vuelve a la sesión que bifurcaste y bifúrcala de nuevo una vez que la sesión esté inactiva
5754
5626### Espacio de trabajo no confiable al enviar una sesión en segundo plano5755### Espacio de trabajo no confiable al enviar una sesión en segundo plano
5627 5756
5628Iniciaste o reiniciaste una [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md) en un directorio en el que no has [confiado](https://code.claude.com/docs/es/permissions.md#project-allow-rules-and-workspace-trust), y el diálogo de confianza del espacio de trabajo no pudo aparecer para preguntarte. Claude Code no inicia la sesión:5757Iniciaste o reiniciaste una [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md) en un directorio en el que no has [confiado](https://code.claude.com/docs/es/permissions.md#project-allow-rules-and-workspace-trust), y el diálogo de confianza del espacio de trabajo no pudo aparecer para preguntarte. Claude Code no inicia la sesión:
6493 6622
6494**2. Actualiza todos los hosts que comparten el directorio home**6623**2. Actualiza todos los hosts que comparten el directorio home**
6495 6624
6496Si varios hosts comparten este directorio home, primero actualiza Claude Code en todos los hosts a la versión que indica el mensaje o a una posterior. Una versión anterior puede volver a escribir un `.config.json` que hayas movido.6625Si varios hosts comparten este directorio home, primero actualiza Claude Code en todos los hosts a la versión que indica el mensaje o a una posterior.
6497 6626
6498**3. Detén Claude Code**6627**3. Detén Claude Code**
6499 6628
