55| `spend limit reached` / `spend limit unavailable` | [Límites de uso](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` | [Límites de uso](#spend-limit-reached) |
56| `Not logged in · Please run /login` | [Autenticación](#not-logged-in) |56| `Not logged in · Please run /login` | [Autenticación](#not-logged-in) |
57| `Couldn't save your login` | [Autenticación](#couldnt-save-your-login) |57| `Couldn't save your login` | [Autenticación](#couldnt-save-your-login) |
58| `Sign in again to take your previous account or API key off the config file.` | [Autenticación](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |
59| `Your account or API key may still be in the config file. Run claude auth logout.` | [Autenticación](#your-account-or-api-key-may-still-be-in-the-config-file) |
58| `Authentication required · Sign in again to continue` | [Autenticación](#not-logged-in) |60| `Authentication required · Sign in again to continue` | [Autenticación](#not-logged-in) |
59| `Could not resolve authentication method` | [Autenticación](#could-not-resolve-authentication-method) |61| `Could not resolve authentication method` | [Autenticación](#could-not-resolve-authentication-method) |
60| `Invalid API key` | [Autenticación](#invalid-api-key) |62| `Invalid API key` | [Autenticación](#invalid-api-key) |
82| `Couldn't verify your organization's policy for remote control` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |84| `Couldn't verify your organization's policy for remote control` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#couldnt-verify-your-organizations-policy-for-remote-control) |
83| `Remote Control is disabled by your organization's policy` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |85| `Remote Control is disabled by your organization's policy` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#remote-control-is-disabled-by-your-organizations-policy) |
84| `Remote Control was turned off by your organization's policy` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |86| `Remote Control was turned off by your organization's policy` | [Solucionar problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#remote-control-was-turned-off-by-your-organizations-policy) |
87| `Session failed: working folder not found:` | [Solución de problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#working-folder-not-found) |
88| `The program file this Remote Control started from is gone` | [Solución de problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#program-file-is-gone) |
89| `Session failed: spawn error:` seguido de un mensaje `ENOENT` | [Solución de problemas de Remote Control](https://code.claude.com/docs/es/remote-control.md#program-file-is-gone) |
85| `OAuth token revoked` / `OAuth token has expired` | [Autenticación](#oauth-token-revoked-or-expired) |90| `OAuth token revoked` / `OAuth token has expired` | [Autenticación](#oauth-token-revoked-or-expired) |
86| `Failed to authenticate: OAuth token revoked` | [Autenticación](#oauth-token-revoked-or-expired) |91| `Failed to authenticate: OAuth token revoked` | [Autenticación](#oauth-token-revoked-or-expired) |
87| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Autenticación](#oauth-token-revoked-or-expired) |92| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Autenticación](#oauth-token-revoked-or-expired) |
165| `Request too large for the API's 32MB request limit` | [Errores de solicitud](#request-too-large) |170| `Request too large for the API's 32MB request limit` | [Errores de solicitud](#request-too-large) |
166| `Image was too large` | [Errores de solicitud](#image-was-too-large) |171| `Image was too large` | [Errores de solicitud](#image-was-too-large) |
167| `API Error: an image in the conversation could not be processed and was removed` | [Errores de solicitud](#image-was-too-large) |172| `API Error: an image in the conversation could not be processed and was removed` | [Errores de solicitud](#image-was-too-large) |
173| `An image in the conversation exceeds the dimension limit for many-image requests` | [Errores de solicitud](#image-was-too-large) |
168| `Unable to resize image` | [Errores de solicitud](#unable-to-resize-image) |174| `Unable to resize image` | [Errores de solicitud](#unable-to-resize-image) |
169| `Request rejected as unprocessable by the model` | [Errores de solicitud](#request-rejected-as-unprocessable-by-the-model) |175| `Request rejected as unprocessable by the model` | [Errores de solicitud](#request-rejected-as-unprocessable-by-the-model) |
170| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Errores de solicitud](#pdf-errors) |176| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Errores de solicitud](#pdf-errors) |
229| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Errores de línea de comandos](#invalid-agents-configuration) |235| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [Errores de línea de comandos](#invalid-agents-configuration) |
230| `Error: --agents file not found` | [Errores de línea de comandos](#invalid-agents-configuration) |236| `Error: --agents file not found` | [Errores de línea de comandos](#invalid-agents-configuration) |
231| `Error: Settings file exceeds the 2MiB limit` | [Errores de línea de comandos](#settings-file-exceeds-the-2mib-limit) |237| `Error: Settings file exceeds the 2MiB limit` | [Errores de línea de comandos](#settings-file-exceeds-the-2mib-limit) |
238| `Configuration error in` | [Errores de línea de comandos](#configuration-error-in-claude-json) |
239| `Claude configuration file at <path> was empty and no backup holds anything: starting with defaults.` | [Errores de línea de comandos](#claude-configuration-file-was-empty) |
232| `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) |240| `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) |
233| `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) |241| `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) |
234| `ENOSPC: no space left on device, mkdir '<dir>'` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |242| `ENOSPC: no space left on device, mkdir '<dir>'` | [Errores de línea de comandos](#temp-directory-refused-or-cannot-be-created) |
252| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Errores de línea de comandos](#mcp-permission-prompt-tool-not-found) |260| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Errores de línea de comandos](#mcp-permission-prompt-tool-not-found) |
253| `OAuth callback port <port> is already in use — another process may be holding it` | [Errores de línea de comandos](#oauth-callback-port-is-already-in-use) |261| `OAuth callback port <port> is already in use — another process may be holding it` | [Errores de línea de comandos](#oauth-callback-port-is-already-in-use) |
254| `No available ports for OAuth redirect` | [Errores de línea de comandos](#no-available-ports-for-oauth-redirect) |262| `No available ports for OAuth redirect` | [Errores de línea de comandos](#no-available-ports-for-oauth-redirect) |
255| `Shell command failed for pattern "..."`, de `/security-review` o de cualquier skill que inyecte contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |263| `Shell command failed for pattern "..."`, desde `/security-review` o cualquier skill que inyecte contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |
256| `Shell command permission check failed for pattern "..."`, de un skill que inyecta contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |264| `Shell command permission check failed for pattern "..."`, de un skill que inyecta contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |
257| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Errores de línea de comandos](#security-review-fails-without-origin-head) |265| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Errores de línea de comandos](#security-review-fails-without-origin-head) |
258| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Errores de línea de comandos](#no-shell-command-was-run) |266| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Errores de línea de comandos](#no-shell-command-was-run) |
334| `cannot contain null bytes (\0)` | [Errores de herramientas](#path-cannot-contain-null-bytes) |342| `cannot contain null bytes (\0)` | [Errores de herramientas](#path-cannot-contain-null-bytes) |
335| `Path contains null bytes` | [Errores de herramientas](#path-cannot-contain-null-bytes) |343| `Path contains null bytes` | [Errores de herramientas](#path-cannot-contain-null-bytes) |
336| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Errores de herramientas](#command-contains-an-invisible-character) |344| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [Errores de herramientas](#command-contains-an-invisible-character) |
345| `This call was not run. The command was approved before Claude Code restarted` | [Errores de herramientas](#command-approved-before-a-restart-was-not-run) |
337| `File is too large to read as an image (the limit is 128MB)` | [Errores de herramientas](#file-is-too-large-to-read-as-an-image) |346| `File is too large to read as an image (the limit is 128MB)` | [Errores de herramientas](#file-is-too-large-to-read-as-an-image) |
338| `Cannot read this as an image: <path> is a pipe or a device` | [Errores de herramientas](#file-is-too-large-to-read-as-an-image) |347| `Cannot read this as an image: <path> is a pipe or a device` | [Errores de herramientas](#file-is-too-large-to-read-as-an-image) |
339| `subagent_type is required: the general-purpose agent is not available in this session` | [Errores de herramientas](#subagent-type-is-required) |348| `subagent_type is required: the general-purpose agent is not available in this session` | [Errores de herramientas](#subagent-type-is-required) |
420| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Advertencias de configuración](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |429| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Advertencias de configuración](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |
421| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Advertencias de configuración](#skill-or-command-name-refused) |430| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Advertencias de configuración](#skill-or-command-name-refused) |
422| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Advertencias de configuración](#workspace-has-not-been-trusted) |431| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Advertencias de configuración](#workspace-has-not-been-trusted) |
432| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Advertencias de configuración](#make-this-change-again-later) |
423| `is a network path, which cannot be added as a working directory` | [Advertencias de configuración](#working-directory-is-a-network-path) |433| `is a network path, which cannot be added as a working directory` | [Advertencias de configuración](#working-directory-is-a-network-path) |
424| `Remote managed settings failed to load (<cause>)` | [Advertencias de configuración](#remote-managed-settings-failed-to-load) |434| `Remote managed settings failed to load (<cause>)` | [Advertencias de configuración](#remote-managed-settings-failed-to-load) |
435| `Your organization requires remote managed settings to load, but they could not be loaded` | [Aplicar inicio fail-closed](https://code.claude.com/docs/es/server-managed-settings.md#enforce-fail-closed-startup) |
436| `Remote managed settings are still loading` | [Advertencias de configuración](#remote-managed-settings-failed-to-load) |
437| `Remote managed settings did not load` | [Advertencias de configuración](#remote-managed-settings-failed-to-load) |
438| `Claude Code couldn't load your organization's settings` / `Claude Code couldn't reach Anthropic to load your organization's settings` / `requires them before a session can start` | [Advertencias de configuración](#couldnt-load-your-organizations-settings) |
439| `Claude Code can't start this session yet` | [Advertencias de configuración](#couldnt-load-your-organizations-settings) |
440| `Your Claude session has expired. Sign in again to continue (claude auth login).` | [Advertencias de configuración](#couldnt-load-your-organizations-settings) |
425| `Managed settings were not approved; exiting without applying them.` | [Advertencias de configuración](#managed-settings-were-not-approved) |441| `Managed settings were not approved; exiting without applying them.` | [Advertencias de configuración](#managed-settings-were-not-approved) |
426| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Advertencias de configuración](#managed-settings-need-your-approval) |442| `Your organization's managed settings need your approval, which couldn't be asked for here.` | [Advertencias de configuración](#managed-settings-need-your-approval) |
427| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Advertencias de configuración](#managed-settings-block-the-default-model) |443| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Advertencias de configuración](#managed-settings-block-the-default-model) |
454| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Advertencias de configuración](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |470| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Advertencias de configuración](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |
455| `Sandbox mask files left behind at write-deny paths` | [Advertencias de configuración](#stale-sandbox-mask-files-left-by-a-killed-session) |471| `Sandbox mask files left behind at write-deny paths` | [Advertencias de configuración](#stale-sandbox-mask-files-left-by-a-killed-session) |
456| `Stale sandbox mask files left by a killed session` | [Advertencias de configuración](#stale-sandbox-mask-files-left-by-a-killed-session) |472| `Stale sandbox mask files left by a killed session` | [Advertencias de configuración](#stale-sandbox-mask-files-left-by-a-killed-session) |
473| `Ubuntu's AppArmor restriction on user namespaces stops bubblewrap here` | [Solución de problemas del sandboxing](https://code.claude.com/docs/es/sandboxing.md#apparmor-restriction-stops-bubblewrap) |
474| `bwrap: setting up uid map: Permission denied` / `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` | [Solución de problemas del sandboxing](https://code.claude.com/docs/es/sandboxing.md#bwrap-uid-map-permission-denied) |
457| Las respuestas parecen ser de menor calidad que lo habitual | [Calidad de respuesta](#responses-seem-lower-quality-than-usual) |475| Las respuestas parecen ser de menor calidad que lo habitual | [Calidad de respuesta](#responses-seem-lower-quality-than-usual) |
458 476
459## Reintentos automáticos477## Reintentos automáticos
1031* Ejecuta `/login` para autenticarte con tu suscripción de Claude o tu cuenta de Console1049* Ejecuta `/login` para autenticarte con tu suscripción de Claude o tu cuenta de Console
1032* Si esperabas que una variable de entorno te autenticara, confirma que `ANTHROPIC_API_KEY` está definida y exportada en el shell desde el que iniciaste `claude`1050* Si esperabas que una variable de entorno te autenticara, confirma que `ANTHROPIC_API_KEY` está definida y exportada en el shell desde el que iniciaste `claude`
1033* Para CI o automatización donde el inicio de sesión interactivo no es posible, configura un script [`apiKeyHelper`](https://code.claude.com/docs/es/settings-reference#apikeyhelper) que obtenga una clave al inicio1051* Para CI o automatización donde el inicio de sesión interactivo no es posible, configura un script [`apiKeyHelper`](https://code.claude.com/docs/es/settings-reference#apikeyhelper) que obtenga una clave al inicio
1052* Si los trabajos de `claude -p` terminan con este mensaje cuando alguien vuelve a iniciar sesión en la misma cuenta y organización de claude.ai, actualiza Claude Code donde se ejecuta ese inicio de sesión. Antes de la v2.1.318, Claude Code eliminaba el inicio de sesión almacenado durante ese inicio de sesión, antes de guardar el nuevo.
1034* Consulta [Precedencia de autenticación](https://code.claude.com/docs/es/authentication.md#authentication-precedence) para entender qué credencial usa Claude Code cuando hay varias presentes1053* Consulta [Precedencia de autenticación](https://code.claude.com/docs/es/authentication.md#authentication-precedence) para entender qué credencial usa Claude Code cuando hay varias presentes
1035 1054
1036Si se te pide iniciar sesión repetidamente, consulta [No has iniciado sesión o el token expiró](https://code.claude.com/docs/es/troubleshoot-install.md#not-logged-in-or-token-expired) para ver las comprobaciones del reloj del sistema y los pasos de recuperación del almacenamiento de credenciales en macOS.1055Si se te pide iniciar sesión repetidamente, consulta [No has iniciado sesión o el token expiró](https://code.claude.com/docs/es/troubleshoot-install.md#not-logged-in-or-token-expired) para ver las comprobaciones del reloj del sistema y los pasos de recuperación del almacenamiento de credenciales en macOS.
1441* En otras plataformas, vuelve a ejecutar `/login`1460* En otras plataformas, vuelve a ejecutar `/login`
1442* Si el inicio de sesión sigue sin guardarse, consulta [No has iniciado sesión o el token expiró](https://code.claude.com/docs/es/troubleshoot-install.md#not-logged-in-or-token-expired) para ver el comando para desbloquear el llavero y otros pasos de recuperación del almacenamiento de credenciales1461* Si el inicio de sesión sigue sin guardarse, consulta [No has iniciado sesión o el token expiró](https://code.claude.com/docs/es/troubleshoot-install.md#not-logged-in-or-token-expired) para ver el comando para desbloquear el llavero y otros pasos de recuperación del almacenamiento de credenciales
1443 1462
1463### Sign in again to take your previous account or API key off the config file
1464
1465Esta advertencia después de iniciar sesión significa que cualquier cuenta con la que tuvieras la sesión iniciada antes puede seguir almacenada en [`~/.claude.json`](https://code.claude.com/docs/es/claude-directory#ce-claude-json):
1466
1467```text theme={null}
1468Sign in again to take your previous account or API key off the config file.
1469```
1470
1471También puede seguir habiendo una clave de API en `~/.claude.json` si un inicio de sesión de Console creó una en Linux o Windows.
1472
1473**Qué hacer:**
1474
1475* Ejecuta `claude auth login` en tu shell para volver a iniciar sesión. Claude Code reintenta entonces el guardado que quita del archivo la cuenta o la clave de API reemplazada.
1476
1477### Your account or API key may still be in the config file
1478
1479Ejecutaste `/logout` o `claude auth logout`, y Claude Code cerró la sesión de este proceso, pero no pudo confirmar que [`~/.claude.json`](https://code.claude.com/docs/es/claude-directory#ce-claude-json) ya no contenga tu cuenta. O el guardado no se aplicó, o el archivo no se pudo volver a leer para comprobarlo.
1480
1481```text theme={null}
1482Your account or API key may still be in the config file. Run claude auth logout.
1483```
1484
1485También puede seguir habiendo una clave de API en `~/.claude.json` si un inicio de sesión de Console creó una en Linux o Windows.
1486
1487**Qué hacer:**
1488
1489* Ejecuta `claude auth logout` en tu shell para volver a intentar el guardado. Cuando el guardado se completa, el comando imprime `Successfully logged out from your Anthropic account.`
1490
1444### Couldn't start the local listener that receives the browser sign-in1491### Couldn't start the local listener that receives the browser sign-in
1445 1492
1446Cada uno de estos mensajes de `/login`, `claude auth login` o `claude setup-token` significa que Claude Code no pudo abrir el puerto en `127.0.0.1` donde tu navegador devuelve el resultado del inicio de sesión.1493Cada uno de estos mensajes de `/login`, `claude auth login` o `claude setup-token` significa que Claude Code no pudo abrir el puerto en `127.0.0.1` donde tu navegador devuelve el resultado del inicio de sesión.
2420Image was too large. Double press esc to go back and try again with a smaller image.2467Image was too large. Double press esc to go back and try again with a smaller image.
2421API Error: 400 ... image dimensions exceed max allowed size2468API Error: 400 ... image dimensions exceed max allowed size
2422API Error: an image in the conversation could not be processed and was removed.2469API Error: an image in the conversation could not be processed and was removed.
2470An image in the conversation exceeds the dimension limit for many-image requests (3000px). Run /compact to remove old images from context, or start a new session.
2423```2471```
2424 2472
2425La línea `could not be processed and was removed` significa que la API rechazó una imagen de la conversación, por ejemplo una que supera los límites de tamaño o dimensiones.2473La línea `could not be processed and was removed` significa que la API rechazó una imagen de la conversación, por ejemplo una que supera los límites de tamaño o dimensiones.
2434 2482
2435* Cambia el tamaño de la imagen antes de pegarla. La API acepta imágenes de hasta 8000 píxeles en el lado más largo para una sola imagen, o 3000 píxeles cuando hay más de 20 imágenes en el contexto.2483* Cambia el tamaño de la imagen antes de pegarla. La API acepta imágenes de hasta 8000 píxeles en el lado más largo para una sola imagen, o 3000 píxeles cuando hay más de 20 imágenes en el contexto.
2436* Toma una captura de pantalla más ajustada de la región relevante en lugar de la pantalla completa2484* Toma una captura de pantalla más ajustada de la región relevante en lugar de la pantalla completa
2485* Para el mensaje `dimension limit for many-image requests`, ejecuta `/compact` en el prompt de Claude Code si el mensaje lo menciona, o inicia una nueva sesión con menos imágenes
2486
2487El mensaje `dimension limit for many-image requests` muestra el límite de píxeles indicado en el error de la API.
2437 2488
2438### No se pudo cambiar el tamaño de la imagen2489### No se pudo cambiar el tamaño de la imagen
2439 2490
3223 3274
3224* Apunta `--settings` a un archivo de configuración JSON regular de menos de 2 MiB. Consulta [Configuración](https://code.claude.com/docs/es/settings.md) para ver el formato.3275* Apunta `--settings` a un archivo de configuración JSON regular de menos de 2 MiB. Consulta [Configuración](https://code.claude.com/docs/es/settings.md) para ver el formato.
3225 3276
3277### Configuration error in \~/.claude.json
3278
3279Claude 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.
3280
3281Cuando 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:
3282
3283```text wrap theme={null}
3284Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>
3285The corrupted file has been backed up to: /home/user/.claude/backups/.claude.json.corrupted.1793664000000
3286A backup file exists at: /home/user/.claude/backups/.claude.json.backup.1793660400000
3287You can manually restore it by running: cp -f "/home/user/.claude/backups/.claude.json.backup.1793660400000" "/home/user/.claude.json"
3288
3289Configuration error in /home/user/.claude.json: <JSON parser's message>
3290```
3291
3292**Qué hacer:**
3293
3294* **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`.
3295* **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.
3296
3297Antes 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.
3298
3299### Claude configuration file was empty and no backup holds anything
3300
3301Este mensaje al iniciar significa que el archivo que menciona estaba en blanco y ninguna de las [copias `.backup`](https://code.claude.com/docs/es/claude-directory#cleaned-up-automatically) del archivo contiene nada. Claude Code se inició con los valores predeterminados para lo que contiene ese archivo. Tus archivos `settings.json` y `.mcp.json` son archivos separados.
3302
3303```text wrap theme={null}
3304Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.
3305```
3306
3307**Qué hacer:**
3308
3309* Vuelve a configurar lo que tenías en ese archivo. Por ejemplo, agrega tus [servidores MCP](https://code.claude.com/docs/es/mcp.md#mcp-installation-scopes) de alcance `user` y `local` con `claude mcp add` desde tu terminal.
3310* Vuelve a iniciar sesión si Claude Code te lo pide
3311
3312Antes de v2.1.318, Claude Code informaba un archivo en blanco sin copia de seguridad como [dañado](#configuration-error-in-claude-json).
3313
3226### El directorio actual ya no existe3314### El directorio actual ya no existe
3227 3315
3228Iniciaste `claude` desde un directorio que se eliminó o se movió después de que tu shell entrara en él, por ejemplo un worktree o un directorio temporal que otro shell eliminó. Claude Code no puede leer su directorio de trabajo, así que termina con código 1 antes de iniciar la sesión, tanto en modo interactivo como [no interactivo](https://code.claude.com/docs/es/headless.md). Antes de v2.1.239, Claude Code fallaba mostrando código fuente minificado del bundle y un stack `ENOENT ... uv_cwd` sin procesar en stderr en lugar de este mensaje.3316Iniciaste `claude` desde un directorio que se eliminó o se movió después de que tu shell entrara en él, por ejemplo un worktree o un directorio temporal que otro shell eliminó. Claude Code no puede leer su directorio de trabajo, así que termina con código 1 antes de iniciar la sesión, tanto en modo interactivo como [no interactivo](https://code.claude.com/docs/es/headless.md). Antes de v2.1.239, Claude Code fallaba mostrando código fuente minificado del bundle y un stack `ENOENT ... uv_cwd` sin procesar en stderr en lugar de este mensaje.
3626 3714
3627Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:3715Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:
3628 3716
3629* `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 abortan en cada modo de permisos y cómo aprobar previamente un comando con `allowed-tools`3717* `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 abortan en cada modo de permisos y cómo preaprobar un comando con `allowed-tools`
3630* ``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)3718* ``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)
3631 3719
3632**Qué hacer:**3720**Qué hacer:**
3780 3868
3781* **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 anterior3869* **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
3782* **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>`)``3870* **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>`)``
3783* **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, 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`.3871* **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 cada rama base obtenida, y en un clon completo ese comando falla con `fatal: --unshallow on a complete repository does not make sense`.
3784 3872
3785**Qué hacer:**3873**Qué hacer:**
3786 3874
4666* **Para un comando que escribió Claude**: no tienes nada que corregir. El mensaje le indica a Claude cómo reescribir el comando.4754* **Para un comando que escribió Claude**: no tienes nada que corregir. El mensaje le indica a Claude cómo reescribir el comando.
4667* **Para un archivo de skill o de comando**: el mensaje aparece después de `No shell command in <name> was run`. Consulta [dónde encontrar el carácter y eliminarlo](#no-shell-command-was-run).4755* **Para un archivo de skill o de comando**: el mensaje aparece después de `No shell command in <name> was run`. Consulta [dónde encontrar el carácter y eliminarlo](#no-shell-command-was-run).
4668 4756
4757### Command approved before Claude Code restarted was not run
4758
4759Un comando de shell que aprobaste no se ejecutó, y Claude recibe este mensaje como resultado del comando:
4760
4761```text wrap theme={null}
4762This call was not run. The command was approved before Claude Code restarted, and Claude Code could not confirm that the shell is back in the directory where it was approved. That directory may be gone or replaced, lie outside the directory where the session started, or be one that Claude Code needs approval to enter or is not allowed to examine. The shell's directory is <directory>. If the command still makes sense, cd to the directory it was meant for and make the call again; it may need approval again.
4763```
4764
4765La tercera oración del mensaje puede decir en cambio `It does not keep track of that directory across a restart in a session that has been in a worktree.`
4766
4767**Qué hacer:**
4768
4769* Deja que Claude continúe, y responde la solicitud si se te pide que vuelvas a aprobar el comando.
4770
4669### File is too large to read as an image4771### File is too large to read as an image
4670 4772
4671Claude intentó leer un archivo como imagen con la [herramienta Read](https://code.claude.com/docs/es/tools-reference.md#read-tool-behavior), y el archivo supera los 128 MB, el máximo que Read carga de un archivo de imagen. No se leyó nada, y Claude recibe este error como resultado de la herramienta:4773Claude intentó leer un archivo como imagen con la [herramienta Read](https://code.claude.com/docs/es/tools-reference.md#read-tool-behavior), y el archivo supera los 128 MB, el máximo que Read carga de un archivo de imagen. No se leyó nada, y Claude recibe este error como resultado de la herramienta:
5818 5920
5819### Remote managed settings failed to load5921### Remote managed settings failed to load
5820 5922
5821Tu sesión cumple los requisitos para la [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md), pero Claude Code no pudo obtenerla o no pudo aplicar lo que devolvió el servidor, por lo que muestra esta advertencia en las sesiones interactivas.5923Tu sesión cumple los requisitos para la [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md), pero Claude Code no pudo obtenerla o no pudo aplicar lo que devolvió el servidor, por lo que muestra esta advertencia en las sesiones interactivas y en la pestaña Code de Claude Desktop.
5822 5924
5823La causa entre paréntesis indica qué falló, como `network error`, `request timed out` o `authentication rejected (401)`. La causa `no setting in the server response could be applied as written` significa que el servidor respondió, pero ninguno de los ajustes que devolvió superó la [validación](https://code.claude.com/docs/es/server-managed-settings.md#invalid-entries-in-delivered-settings). Antes de v2.1.282, esta causa decía `server returned invalid settings`.5925La causa entre paréntesis indica qué falló, como `network error`, `request timed out` o `authentication rejected (401)`. La causa `no setting in the server response could be applied as written` significa que el servidor respondió, pero ninguno de los ajustes que devolvió superó la [validación](https://code.claude.com/docs/es/server-managed-settings.md#invalid-entries-in-delivered-settings). Antes de v2.1.282, esta causa decía `server returned invalid settings`.
5824 5926
5827* **Configuración almacenada en caché de una obtención anterior exitosa**: Claude Code ejecuta la sesión con esa política en caché, excepto las [variables de entorno retenidas](https://code.claude.com/docs/es/server-managed-settings.md#fetch-and-caching-behavior), y la línea dice `using cached policy`.5929* **Configuración almacenada en caché de una obtención anterior exitosa**: Claude Code ejecuta la sesión con esa política en caché, excepto las [variables de entorno retenidas](https://code.claude.com/docs/es/server-managed-settings.md#fetch-and-caching-behavior), y la línea dice `using cached policy`.
5828* **Sin caché**: Claude Code ejecuta la sesión sin configuración administrada por el servidor, y la línea dice `no remote policy applied`.5930* **Sin caché**: Claude Code ejecuta la sesión sin configuración administrada por el servidor, y la línea dice `no remote policy applied`.
5829 5931
5932En la pestaña Code, la advertencia aparece como una línea en la conversación cuando envías un mensaje, y aparece una nueva línea cuando cambia el estado de la obtención. Tres mensajes relacionados aparecen de la misma manera:
5933
5934* `Remote managed settings are still loading`: la obtención todavía estaba en curso cuando la sesión continuó
5935* `Remote managed settings did not load`: la obtención terminó sin una respuesta
5936* `Remote managed settings have now loaded`: la configuración se cargó después de una de estas advertencias, y el resto de la línea indica si se aplica una política remota
5937
5830**Qué hacer:**5938**Qué hacer:**
5831 5939
5832* Actúa según la causa que indica el mensaje: para una causa de red, comprueba que esta máquina pueda acceder a `api.anthropic.com`; para una causa de autenticación, comprueba tu inicio de sesión con `/status`5940* Actúa según la causa que indica el mensaje: para una causa de red, comprueba que esta máquina pueda acceder a `api.anthropic.com`; para una causa de autenticación, comprueba tu inicio de sesión con `/status`
5835 5943
5836Antes de v2.1.248, Claude Code informaba de una obtención de configuración fallida solo en el registro de depuración.5944Antes de v2.1.248, Claude Code informaba de una obtención de configuración fallida solo en el registro de depuración.
5837 5945
5946### Claude Code couldn't load your organization's settings
5947
5948Tu sesión no se ha iniciado porque la configuración de tu organización, incluida su [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md), tiene que cargarse primero y Claude Code no pudo cargarla. Por ejemplo:
5949
5950```text theme={null}
5951Claude Code couldn't reach Anthropic to load your organization's settings (could not connect). <Organization name> requires them before a session can start.
5952```
5953
5954Si el mensaje aparece en un diálogo titulado `Claude Code can't start this session yet`, el diálogo se cierra y la sesión se inicia en cuanto se carga la configuración.
5955
5956En [modo no interactivo](https://code.claude.com/docs/es/headless.md) y en [sesiones en segundo plano](https://code.claude.com/docs/es/agent-view.md), Claude Code en cambio imprime el mensaje y se cierra con el estado 1.
5957
5958**Qué hacer:**
5959
5960* **`could not connect`, o `the reply came from a network proxy, not Anthropic`**: comprueba tu conexión de red y, en una red corporativa, pídele a TI que permita HTTPS hacia `api.anthropic.com/api/claude_code/policy_limits` y `api.anthropic.com/api/claude_code/settings`. Luego selecciona **Retry now**, o vuelve a ejecutar tu comando.
5961* **`timed out`, `Anthropic returned an error` o `Anthropic asked it to retry shortly`**: deja que el diálogo reintente, o vuelve a ejecutar tu comando más tarde. Consulta [status.anthropic.com](https://status.anthropic.com) si sigue ocurriendo.
5962* **`still loading`, o `couldn't verify your sign-in with Anthropic yet`**: deja que el diálogo reintente, o vuelve a ejecutar tu comando. Si el mensaje sobre el inicio de sesión sigue apareciendo, vuelve a iniciar sesión ejecutando `claude auth login` en tu shell.
5963* **`Your Claude session has expired`**: el inicio de sesión almacenado en esta máquina ya no es válido, así que reintentar no servirá. En el diálogo, selecciona **Sign in again** para cerrar Claude Code; luego, en tu shell, ejecuta `claude auth login`, que funciona incluso mientras no se pueden iniciar sesiones.
5964* **`none of the settings the server returned could be applied as written`**: pídele a tu administrador que corrija la [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md#invalid-entries-in-delivered-settings) de la organización y luego reintenta.
5965
5838### Managed settings were not approved5966### Managed settings were not approved
5839 5967
5840La [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md) de tu organización incluye ajustes que necesitan tu aprobación, y rechazaste el [diálogo de aprobación de seguridad](https://code.claude.com/docs/es/server-managed-settings.md#security-approval-dialogs), por lo que Claude Code se cierra sin aplicarlos:5968La [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md) de tu organización incluye ajustes que necesitan tu aprobación, y rechazaste el [diálogo de aprobación de seguridad](https://code.claude.com/docs/es/server-managed-settings.md#security-approval-dialogs), por lo que Claude Code se cierra sin aplicarlos:
6294 6422
6295Antes de v2.1.257, `claude doctor` no señalaba estos archivos; las versiones anteriores dejan los mismos marcadores de posición cuando se termina una sesión a la fuerza.6423Antes de v2.1.257, `claude doctor` no señalaba estos archivos; las versiones anteriores dejan los mismos marcadores de posición cuando se termina una sesión a la fuerza.
6296 6424
6425### Make this change again later: \~/.claude.json could not be updated
6426
6427Este aviso en stderr significa que un cambio en [`~/.claude.json`](https://code.claude.com/docs/es/claude-directory#ce-claude-json), como un inicio de sesión o una respuesta a una solicitud de confianza, no se guardó en el archivo:
6428
6429```text theme={null}
6430Make this change again later: /home/user/.claude.json could not be updated, so it applies to this session only.
6431```
6432
6433**Qué hacer:**
6434
6435* Vuelve a hacer el cambio en una sesión posterior. Por ejemplo, ejecuta `/login` de nuevo o vuelve a responder la solicitud de confianza.
6436
6297## Las respuestas parecen de menor calidad que lo habitual6437## Las respuestas parecen de menor calidad que lo habitual
6298 6438
6299Si las respuestas de Claude parecen menos capaces de lo que espera pero no se muestra ningún error, la causa suele ser el estado de la conversación en lugar del modelo en sí. Claude Code no cambia silenciosamente las versiones del modelo. Puede cambiar a un modelo de respaldo en estos casos:6439Si las respuestas de Claude parecen menos capaces de lo que espera pero no se muestra ningún error, la causa suele ser el estado de la conversación en lugar del modelo en sí. Claude Code no cambia silenciosamente las versiones del modelo. Puede cambiar a un modelo de respaldo en estos casos:
