21Haga coincidir el mensaje que ve en su terminal con una sección a continuación.21Haga coincidir el mensaje que ve en su terminal con una sección a continuación.
22 22
23| Mensaje | Sección |23| Mensaje | Sección |
24| :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
25| `API Error: 500 Internal server error` | [Errores del servidor](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Errores del servidor](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Errores del servidor](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Errores del servidor](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Errores del servidor](#request-timed-out), o [Red](#unable-to-connect-to-api) si el mensaje menciona su conexión a Internet |27| `Request timed out` | [Errores del servidor](#request-timed-out), o [Red](#unable-to-connect-to-api) si el mensaje menciona su conexión a Internet |
39| `Not logged in · Please run /login` | [Autenticación](#not-logged-in) |39| `Not logged in · Please run /login` | [Autenticación](#not-logged-in) |
40| `Could not resolve authentication method` | [Autenticación](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Autenticación](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Autenticación](#invalid-api-key) |41| `Invalid API key` | [Autenticación](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Autenticación](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [Autenticación](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Autenticación](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [Autenticación](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Autenticación](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [Autenticación](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Autenticación](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [Autenticación](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Autenticación](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticación](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticación](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [Autenticación](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Autenticación](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [Autenticación](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticación](#login-expired) |
48| `does not meet scope requirement user:profile` | [Autenticación](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Autenticación](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [Autenticación](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Autenticación](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [Autenticación](#aws-authentication-failed) |53| `AWS authentication failed` | [Autenticación](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [Autenticación](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [Red](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Red](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [Reintentos automáticos](#automatic-retries), o [Red](#unable-to-connect-to-api) si persiste |56| `Waiting for API response · will retry in` | [Reintentos automáticos](#automatic-retries), o [Red](#unable-to-connect-to-api) si persiste |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Red](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [Red](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Red](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [Red](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Red](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Red](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Red](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [Errores de línea de comandos](#command-line-errors) |81| `--bg and --print conflict` | [Errores de línea de comandos](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [Errores de línea de comandos](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Errores de línea de comandos](#command-line-errors) |
78| `Could not import <server>: <reason>` | [Errores de línea de comandos](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Errores de línea de comandos](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Errores de línea de comandos](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [Errores de plugins](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Errores de plugins](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Errores de plugins](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errores de plugins](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errores de plugins](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [Errores de herramientas](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Errores de herramientas](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [Errores de sesión en segundo plano](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Errores de sesión en segundo plano](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Advertencias de configuración](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Advertencias de configuración](#workspace-has-not-been-trusted) |
81| Responses seem lower quality than usual | [Calidad de respuesta](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Calidad de respuesta](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude Code reintenta fallos transitorios antes de mostrarle un error. Los errores del servidor, respuestas sobrecargadas, tiempos de espera de solicitud, aceleraciones 429 temporales y conexiones perdidas se reintentan hasta 10 veces con retroceso exponencial. {/* min-version: 2.1.198 */}A partir de v2.1.198, esto cubre conexiones que se cierran en medio de una respuesta antes de que se haya transmitido ninguna salida visible: Claude Code reemite la solicitud con el mismo retroceso y el turno continúa en lugar de detenerse con un error de conexión. {/* min-version: 2.1.199 */}A partir de v2.1.199, las aceleraciones 429 temporales que no llevan los encabezados de cuota de su plan también se reintentan cuando ha iniciado sesión con una suscripción de claude.ai; las versiones anteriores las reintentaban solo para autenticaciones de clave de API y Enterprise.100Claude Code reintenta fallos transitorios antes de mostrarle un error. Los errores del servidor, respuestas sobrecargadas, tiempos de espera de solicitud, aceleraciones 429 temporales y conexiones perdidas se reintentan hasta 10 veces con retroceso exponencial. {/* min-version: 2.1.198 */}A partir de v2.1.198, esto cubre conexiones que se cierran en medio de una respuesta antes de que se haya transmitido ninguna salida visible: Claude Code reemite la solicitud con el mismo retroceso y el turno continúa en lugar de detenerse con un error de conexión. {/* min-version: 2.1.199 */}A partir de v2.1.199, las aceleraciones 429 temporales que no llevan los encabezados de cuota de su plan también se reintentan cuando ha iniciado sesión con una suscripción de claude.ai; las versiones anteriores las reintentaban solo para autenticaciones de clave de API y Enterprise.
88 101
89Dos clases de fallo no se reintentan, porque un reintento no puede tener éxito:102Algunas clases de fallo no se reintentan, porque un reintento no puede tener éxito:
90 103
91* {/* min-version: 2.1.199 */}A partir de v2.1.199, una falla de validación de certificado TLS, como un proxy que inspecciona TLS, un paquete `NODE_EXTRA_CA_CERTS` faltante, o un certificado expirado, falla en el primer intento para que la corrección aparezca inmediatamente en lugar de después del presupuesto de reintento completo. Consulte [Errores de certificado SSL](#ssl-certificate-errors). Las condiciones TLS transitorias como un tiempo de espera de protocolo de enlace aún se reintentan.104* {/* min-version: 2.1.199 */}A partir de v2.1.199, una falla de validación de certificado TLS, como un proxy que inspecciona TLS, un paquete `NODE_EXTRA_CA_CERTS` faltante, o un certificado expirado, falla en el primer intento para que la corrección aparezca inmediatamente en lugar de después del presupuesto de reintento completo. Consulte [Errores de certificado SSL](#ssl-certificate-errors). Las condiciones TLS transitorias como un tiempo de espera de protocolo de enlace aún se reintentan.
92* {/* min-version: 2.1.199 */}A partir de v2.1.199, un error del servidor que llega después de que Claude ya ha transmitido salida visible mantiene la respuesta parcial y agrega un [aviso de respuesta incompleta](#the-response-above-may-be-incomplete) en lugar de reintentar, ya que volver a ejecutar la solicitud podría ejecutar las mismas llamadas de herramientas dos veces. Las versiones anteriores descartaban la salida parcial e informaban el turno como un error.105* {/* min-version: 2.1.199 */}A partir de v2.1.199, un error del servidor que llega después de que Claude ya ha transmitido salida visible mantiene la respuesta parcial y agrega un [aviso de respuesta incompleta](#the-response-above-may-be-incomplete) en lugar de reintentar, ya que volver a ejecutar la solicitud podría ejecutar las mismas herramientas dos veces. Las versiones anteriores descartaban la salida parcial e informaban el turno como un error.
106* {/* min-version: 2.1.208 */}Una [respuesta de streaming de Amazon Bedrock con un tipo de contenido inesperado](#bedrock-streaming-response-has-an-unexpected-content-type) falla en el primer intento, porque la puerta de enlace o proxy que reescribe la respuesta reescribiría el reintento de la misma manera. Requiere Claude Code v2.1.208 o posterior.
93 107
94Mientras se reintenta, el spinner muestra una cuenta regresiva de `Retrying in Ns · attempt x/y` después de una etiqueta de error. La etiqueta nombra la razón específica del primer intento para fallos en los que puede actuar de inmediato: la red está caída, un protocolo de enlace TLS falló, o alcanzó un límite de velocidad. Para otros errores, dice `API error` al principio. {/* min-version: 2.1.198 */}A partir de v2.1.198, cambia a la razón específica del tercer intento, o en el intento final cuando `CLAUDE_CODE_MAX_RETRIES` permite menos de tres; las versiones anteriores cambian solo en el intento final.108Mientras se reintenta, el spinner muestra una cuenta regresiva de `Retrying in Ns · attempt x/y` después de una etiqueta de error. La etiqueta nombra la razón específica del primer intento para fallos en los que puede actuar de inmediato: la red está caída, un protocolo de enlace TLS falló, o alcanzó un límite de velocidad. Para otros errores, dice `API error` al principio. {/* min-version: 2.1.198 */}A partir de v2.1.198, cambia a la razón específica del tercer intento, o en el intento final cuando `CLAUDE_CODE_MAX_RETRIES` permite menos de tres; las versiones anteriores cambian solo en el intento final.
95 109
285 299
286Claude Code bloquea las solicitudes adicionales hasta la hora de reinicio que se muestra en el mensaje. Los límites de sesión y semanales se comparten entre todos los modelos, por lo que cambiar de modelo no restaura el acceso. El límite de Opus se aplica solo a las solicitudes de Opus, por lo que cambiar a otro modelo con `/model` le permite seguir trabajando.300Claude Code bloquea las solicitudes adicionales hasta la hora de reinicio que se muestra en el mensaje. Los límites de sesión y semanales se comparten entre todos los modelos, por lo que cambiar de modelo no restaura el acceso. El límite de Opus se aplica solo a las solicitudes de Opus, por lo que cambiar a otro modelo con `/model` le permite seguir trabajando.
287 301
302El uso se cuenta contra las asignaciones de sesión y semanales al mismo tiempo. Una única ráfaga de actividad intensa, como un gran fanout de flujo de trabajo, puede agotar la asignación semanal antes de que se reinicie la ventana de sesión.
303
288**Qué hacer:**304**Qué hacer:**
289 305
290* Espere a la hora de reinicio que se muestra en el error306* Espere a la hora de reinicio que se muestra en el error
430* Si la clave proviene de un script [`apiKeyHelper`](/es/settings#available-settings), ejecute el script directamente para confirmar que imprime una clave válida en stdout446* Si la clave proviene de un script [`apiKeyHelper`](/es/settings#available-settings), ejecute el script directamente para confirmar que imprime una clave válida en stdout
431* Ejecute `/status` para confirmar qué fuente de credencial está usando realmente Claude Code447* Ejecute `/status` para confirmar qué fuente de credencial está usando realmente Claude Code
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 Su script apiKeyHelper está fallando
451</h3>
452
453El comando configurado en la configuración [`apiKeyHelper`](/es/settings#available-settings) salió con un error, agotó el tiempo de espera o no imprimió nada en stdout. Sin una clave del script, la solicitud llega a la API con una credencial de marcador de posición, y la API la rechaza con `401`.
454
455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```
458
459Claude Code vuelve a ejecutar el script y reintenta la solicitud hasta dos veces más antes de mostrar este mensaje, por lo que el fallo aparece dentro de tres intentos. {/* min-version: 2.1.208 */}Antes de v2.1.208, Claude Code gastaba el [presupuesto de reintentos](#automatic-retries) completo reenviando la solicitud con la credencial de marcador de posición y luego reportaba un error de autenticación `401` genérico en lugar del fallo del script.
460
461Ejecutar `/login` no ayuda aquí: la salida del helper [tiene precedencia](/es/authentication#authentication-precedence) sobre un inicio de sesión guardado mientras la configuración esté presente.
462
463**Qué hacer:**
464
465* Ejecute el comando configurado en `apiKeyHelper` directamente en su shell para reproducir el fallo
466* Si el comando reporta una sesión expirada, vuelva a autenticarse con su proveedor de credenciales, por ejemplo iniciando sesión nuevamente en su SSO o bóveda de secretos
467* Corrija el comando para que imprima la clave en stdout y salga con código 0. Consulte [rotar credenciales con apiKeyHelper](/es/llm-gateway-connect#rotate-credentials-with-apikeyhelper) para una configuración funcional.
468* Ejecute `/status` para confirmar que `apiKeyHelper` es la fuente de credencial activa. Cada vez que el comando falla, su código de salida y salida de error aparecen en un panel `Cloud authentication` en la terminal.
469
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 Esta organización ha sido deshabilitada471 Esta organización ha sido deshabilitada
435</h3>472</h3>
532 569
533Su inicio de sesión guardado ya no es válido. Un token revocado significa que cerró sesión en todas partes o un administrador eliminó el acceso; un token expirado significa que la actualización automática falló a mitad de la sesión.570Su inicio de sesión guardado ya no es válido. Un token revocado significa que cerró sesión en todas partes o un administrador eliminó el acceso; un token expirado significa que la actualización automática falló a mitad de la sesión.
534 571
572Ambos mensajes reportan un rechazo que la API devolvió para una solicitud que Claude Code envió. Cuando el inicio de sesión guardado ya ha sido borrado después de una actualización fallida, verá [Login expirado](#login-expired) en su lugar.
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* Para solicitudes repetidas de inicio de sesión entre lanzamientos, consulte las verificaciones del reloj del sistema y Keychain de macOS en [Solución de problemas](/es/troubleshoot-install#not-logged-in-or-token-expired)584* Para solicitudes repetidas de inicio de sesión entre lanzamientos, consulte las verificaciones del reloj del sistema y Keychain de macOS en [Solución de problemas](/es/troubleshoot-install#not-logged-in-or-token-expired)
546* Para otras fallas incluyendo `403 Forbidden` y problemas del navegador OAuth, consulte [Inicio de sesión y autenticación](/es/troubleshoot-install#login-and-authentication)585* Para otras fallas incluyendo `403 Forbidden` y problemas del navegador OAuth, consulte [Inicio de sesión y autenticación](/es/troubleshoot-install#login-and-authentication)
547 586
587<h3 id="login-expired">
588 Login expirado
589</h3>
590
591Claude Code intentó renovar su inicio de sesión guardado de claude.ai o Claude Console y el servicio OAuth rechazó el token de actualización almacenado, por lo que Claude Code borró las credenciales guardadas. Después de eso, cada solicitud se detiene localmente antes de llegar a la API, porque solo `/login` puede crear nuevas credenciales. {/* min-version: 2.1.206 */}Antes de v2.1.206, Claude Code enviaba la solicitud de todas formas con cualquier credencial que permaneciera en el entorno, y luego cada modelo fallaba con [Hay un problema con el modelo seleccionado](#theres-an-issue-with-the-selected-model) o un 401 en lugar de un aviso para iniciar sesión.
592
593```text theme={null}
594Login expired · Please run /login
595```
596
597En [modo no interactivo](/es/headless) (`-p`) y el [SDK de Agent](/es/agent-sdk/overview), el mensaje se lee de la siguiente manera, y el código de error estructurado es `authentication_failed`:
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
602
603Este no es el mismo estado que [Token OAuth revocado o expirado](#oauth-token-revoked-or-expired). Esos mensajes reportan un 401 que la API devolvió. Claude Code mismo produce `Login expired` para un inicio de sesión que ya falló al renovar, por lo que no envía ninguna solicitud.
604
605Las sesiones autenticadas con una clave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/es/env-vars) o un proveedor de terceros no usan el inicio de sesión guardado y nunca ven este mensaje.
606
607**Qué hacer:**
608
609* Ejecute `/login` para iniciar sesión nuevamente. Reintentar sin iniciar sesión muestra el mismo mensaje en cada solicitud.
610* En modo no interactivo, ejecute `claude` en el mismo entorno, complete `/login`, luego reejecutar su comando. Para automatización que no puede iniciar sesión interactivamente, autentíquese con `ANTHROPIC_API_KEY` o [genere un token de larga duración con `claude setup-token`](/es/authentication#generate-a-long-lived-token).
611* Si iniciar sesión sigue fallando, consulte [Inicio de sesión y autenticación](/es/troubleshoot-install#login-and-authentication)
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 Requisito de alcance de OAuth614 Requisito de alcance de OAuth
550</h3>615</h3>
603* Si sus credenciales son actuales, confirme que los permisos de IAM en [Configuración de IAM](/es/amazon-bedrock#iam-configuration) estén adjuntos a la identidad que está usando y que el modelo seleccionado esté habilitado para su cuenta y región668* Si sus credenciales son actuales, confirme que los permisos de IAM en [Configuración de IAM](/es/amazon-bedrock#iam-configuration) estén adjuntos a la identidad que está usando y que el modelo seleccionado esté habilitado para su cuenta y región
604* Ejecute `aws sts get-caller-identity` para confirmar qué identidad usan sus solicitudes; un `AWS_PROFILE` obsoleto o perfil predeterminado es una causa común de una falta de coincidencia de permisos669* Ejecute `aws sts get-caller-identity` para confirmar qué identidad usan sus solicitudes; un `AWS_PROFILE` obsoleto o perfil predeterminado es una causa común de una falta de coincidencia de permisos
605 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 El tiempo de resolución de credenciales de la cadena predeterminada de AWS se agotó
673</h3>
674
675El proveedor de credenciales de cadena predeterminada de AWS no produjo credenciales dentro de 60 segundos, por lo que Claude Code detuvo la resolución y falló la solicitud. El fallo es resolución de credenciales local: la solicitud nunca llegó a [Amazon Bedrock](/es/amazon-bedrock), [Claude Platform on AWS](/es/claude-platform-on-aws) o el [punto final de Mantle](/es/amazon-bedrock#use-the-mantle-endpoint). Claude Code borra su [caché de credenciales](/es/amazon-bedrock#credential-caching-and-resolution-timeout) y reintenta antes de que este error aparezca, por lo que en el momento en que lo ve la cadena se ha estancado en intentos repetidos.
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
680
681Las causas comunes son un comando `credential_process` en su perfil de AWS que espera entrada que no puede recibir, y un contenedor o VM cuyo servicio de metadatos de instancia (IMDS) nunca responde a la prueba de la cadena. {/* min-version: 2.1.207 */}Antes de v2.1.207, una cadena estancada dejaba la solicitud esperando indefinidamente en lugar de fallar con este mensaje.
682
683**Qué hacer:**
684
685* Ejecute `aws sts get-caller-identity` en el mismo shell con el mismo `AWS_PROFILE`. Si también se cuelga, corrija el perfil; un comando `credential_process` que solicita interactivamente es una causa común.
686* Complete el paso de inicio de sesión antes de iniciar Claude Code, por ejemplo `aws sso login --profile myprofile`, para que la cadena se resuelva desde el caché de SSO local en lugar de esperar un flujo del navegador
687* Si su cadena ejecuta un inicio de sesión interactivo que legítimamente necesita más de 60 segundos, como SSO con MFA a través de un contenedor como `aws-vault`, aumente el límite en milisegundos con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/es/env-vars)
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 Errores de red y conexión690 Errores de red y conexión
608</h2>691</h2>
609 692
610Estos errores significan que una solicitud de red desde Claude Code no pudo llegar a su destino. Generalmente se originan en su red local, proxy o firewall, o en la política de red del entorno en la nube.693Estos errores significan que una solicitud de red desde Claude Code no pudo llegar a su destino, o algo entre Claude Code y la API alteró la respuesta en el camino de regreso. Generalmente se originan en su red local, proxy o firewall, o en la política de red del entorno en la nube.
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 No se puede conectar a la API696 No se puede conectar a la API
640* En macOS, un cliente VPN que fue desconectado o desinstalado puede dejar una interfaz de túnel o una regla de enrutamiento. Verifique `ifconfig` para interfaces `utun` obsoletas y elimine la extensión de red de la VPN en Configuración del Sistema.723* En macOS, un cliente VPN que fue desconectado o desinstalado puede dejar una interfaz de túnel o una regla de enrutamiento. Verifique `ifconfig` para interfaces `utun` obsoletas y elimine la extensión de red de la VPN en Configuración del Sistema.
641* Docker Desktop y tiempos de ejecución de contenedores similares pueden interceptar el tráfico saliente. Ciérrelos y reintente para descartar esto.724* Docker Desktop y tiempos de ejecución de contenedores similares pueden interceptar el tráfico saliente. Ciérrelos y reintente para descartar esto.
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 La respuesta de streaming de Bedrock tiene un content-type inesperado
728</h3>
729
730Una puerta de enlace o proxy entre Claude Code y [Amazon Bedrock](/es/amazon-bedrock) está transformando el cuerpo de la respuesta de streaming o su encabezado `Content-Type`. Amazon Bedrock transmite respuestas como `application/vnd.amazon.eventstream`, y Claude Code rechaza una respuesta de streaming exitosa que reporta un content-type diferente en lugar de decodificar un cuerpo que no puede leer. La solicitud no se reintenta.
731
732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```
735
736{/* min-version: 2.1.208 */}Antes de v2.1.208, la misma configuración incorrecta se presentaba como `API Error: Truncated event message received` después de que toda la respuesta había sido almacenada en búfer.
737
738**Qué hacer:**
739
740* Configure la puerta de enlace para pasar el cuerpo de la respuesta `InvokeModelWithResponseStream` y su encabezado `Content-Type` sin modificar. Un intermediario que reemite la transmisión como eventos enviados por el servidor es una causa común.
741* Si la puerta de enlace reescribe solo el encabezado y pasa el cuerpo binario intacto, establezca [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/es/env-vars) para omitir la verificación hasta que la puerta de enlace se corrija. Consulte [Errores de streaming detrás de una puerta de enlace o proxy](/es/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 Errores de certificado SSL744 Errores de certificado SSL
645</h3>745</h3>
859* **Agent SDK**: el texto de error omite la sugerencia porque el modelo se establece mediante programación. Establezca [`model` en `Options`](/es/agent-sdk/typescript#options) en TypeScript o [`ClaudeAgentOptions(model=...)`](/es/agent-sdk/python#claudeagentoptions) en Python, y maneje el error estructurado `model_not_found` para mostrar su propio reintento o selector de modelo.959* **Agent SDK**: el texto de error omite la sugerencia porque el modelo se establece mediante programación. Establezca [`model` en `Options`](/es/agent-sdk/typescript#options) en TypeScript o [`ClaudeAgentOptions(model=...)`](/es/agent-sdk/python#claudeagentoptions) en Python, y maneje el error estructurado `model_not_found` para mostrar su propio reintento o selector de modelo.
860* Use un alias como `sonnet` u `opus` en lugar de un ID versionado completo. Los alias se resuelven a un valor predeterminado mantenido para que no se vuelvan obsoletos. Consulte [Model configuration](/es/model-config).960* Use un alias como `sonnet` u `opus` en lugar de un ID versionado completo. Los alias se resuelven a un valor predeterminado mantenido para que no se vuelvan obsoletos. Consulte [Model configuration](/es/model-config).
861* Si el modelo incorrecto sigue apareciendo en la CLI, hay un ID obsoleto establecido en algún lugar. Verifique en [orden de prioridad](/es/model-config#setting-your-model): la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, luego el campo `model` en `.claude/settings.local.json`, el `.claude/settings.json` de su proyecto y `~/.claude/settings.json`. Elimine el valor obsoleto y Claude Code vuelve a su valor predeterminado de cuenta.961* Si el modelo incorrecto sigue apareciendo en la CLI, hay un ID obsoleto establecido en algún lugar. Verifique en [orden de prioridad](/es/model-config#setting-your-model): la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, luego el campo `model` en `.claude/settings.local.json`, el `.claude/settings.json` de su proyecto y `~/.claude/settings.json`. Elimine el valor obsoleto y Claude Code vuelve a su valor predeterminado de cuenta.
962* {/* min-version: 2.1.206 */}Claude Code reporta un inicio de sesión de claude.ai expirado como [Login expired](#login-expired), no como este error. Antes de v2.1.206, un inicio de sesión expirado que ya no podía actualizarse fallaba en cada modelo con este error; ejecute `/login` si ve eso en una versión anterior.
862* Para implementaciones de Google Cloud's Agent Platform, consulte [Google Cloud's Agent Platform troubleshooting](/es/google-vertex-ai#troubleshooting).963* Para implementaciones de Google Cloud's Agent Platform, consulte [Google Cloud's Agent Platform troubleshooting](/es/google-vertex-ai#troubleshooting).
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
1070 Conflicto entre --bg y --print1171 Conflicto entre --bg y --print
1071</h3>1172</h3>
1072 1173
1073Este mensaje requiere Claude Code v2.1.198 o posterior. Combinó `--bg` con `-p` o `--print` en la misma invocación de `claude`. `--bg` inicia una [sesión en segundo plano](/es/agent-view#from-your-shell) a la que se adjunta posteriormente con `claude agents`, mientras que `--print` se ejecuta [de forma no interactiva](/es/headless) y nunca inicia la sesión interactiva a la que se adjunta `claude agents`. Antes de v2.1.198, esta combinación creaba silenciosamente un trabajo en segundo plano que nunca podía adjuntarse.1174Este mensaje requiere Claude Code v2.1.198 o posterior. Combinó `--bg` con `-p` o `--print` en la misma invocación de `claude`. `--bg` inicia una [sesión en segundo plano](/es/agent-view#from-your-shell) a la que se conecta posteriormente con `claude agents`, mientras que `--print` se ejecuta [de forma no interactiva](/es/headless) y nunca inicia la sesión interactiva a la que se conecta `claude agents`. Antes de v2.1.198, esta combinación creaba silenciosamente un trabajo en segundo plano que nunca podía conectarse.
1074 1175
1075```text theme={null}1176```text theme={null}
1076--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.1177--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
1091Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1092```1193```
1093 1194
1094El texto después de los dos puntos es el diagnóstico del validador y nombra la palabra clave o ubicación que falló. Los esquemas que usan la palabra clave `format`, como `"format": "email"`, son válidos: Claude Code acepta `format` como una anotación y no la aplica.1195El texto después del segundo colon es el diagnóstico del validador y nombra la palabra clave o ubicación que falló. Los esquemas que usan la palabra clave `format`, como `"format": "email"`, son válidos: Claude Code acepta `format` como una anotación y no la aplica.
1095 1196
1096Claude Code ejecuta dos comprobaciones antes de la compilación del esquema: rechaza un valor que no es JSON analizable con `Error: --json-schema is not valid JSON`, y JSON válido que no es un objeto con `Error: --json-schema must be a JSON object`.1197Claude Code ejecuta dos comprobaciones antes de la compilación del esquema: rechaza un valor que no es JSON analizable con `Error: --json-schema is not valid JSON`, y JSON válido que no es un objeto con `Error: --json-schema must be a JSON object`.
1097 1198
1098**Qué hacer:**1199**Qué hacer:**
1099 1200
1100* Corrija la parte del esquema que nombra el diagnóstico, luego vuelva a ejecutar el comando1201* Corrija la parte del esquema que nombra el diagnóstico y luego vuelva a ejecutar el comando
1101* Si el diagnóstico es `schema too large`, reduzca el anidamiento del esquema y la reutilización de `$ref`1202* Si el diagnóstico es `schema too large`, reduzca el anidamiento del esquema y la reutilización de `$ref`
1102* Consulte [Get structured output](/es/headless#get-structured-output) para un esquema y comando funcionales1203* Consulte [Get structured output](/es/headless#get-structured-output) para un esquema y comando que funcionen
1103 1204
1104<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1105 No se pudo importar un servidor desde Claude Desktop1206 No se pudo importar un servidor desde Claude Desktop
1111Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
1112```1213```
1113 1214
1114El texto después del nombre del servidor es la razón. La más común es la comprobación de nombre: Claude Desktop permite caracteres en nombres de servidores, como espacios y puntos, que `claude mcp` restringe a letras, números, guiones e guiones bajos. Otras razones incluyen una configuración de servidor que falla en la validación y un servidor bloqueado por la [política MCP](/es/managed-mcp) de su organización.1215El texto después del nombre del servidor es la razón. La más común es la comprobación de nombre: Claude Desktop permite caracteres en nombres de servidores, como espacios y puntos, que `claude mcp` restringe a letras, números, guiones y guiones bajos. Otras razones incluyen una configuración de servidor que falla en la validación y un servidor bloqueado por la [política MCP](/es/managed-mcp) de su organización.
1115 1216
1116**Qué hacer:**1217**Qué hacer:**
1117 1218
1118* Cambie el nombre del servidor en `claude_desktop_config.json` para usar solo letras, números, guiones e guiones bajos, luego ejecute `claude mcp add-from-claude-desktop` nuevamente1219* Cambie el nombre del servidor en `claude_desktop_config.json` para usar solo letras, números, guiones y guiones bajos, luego ejecute `claude mcp add-from-claude-desktop` nuevamente
1119* Agregue ese servidor directamente con `claude mcp add` o `claude mcp add-json` bajo un nombre válido. Consulte [Import MCP servers from Claude Desktop](/es/mcp#import-mcp-servers-from-claude-desktop).1220* Agregue ese servidor directamente con `claude mcp add` o `claude mcp add-json` bajo un nombre válido. Consulte [Import MCP servers from Claude Desktop](/es/mcp#import-mcp-servers-from-claude-desktop).
1120 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Herramienta de solicitud de permiso MCP no encontrada
1224</h3>
1225
1226La herramienta que pasó a [`--permission-prompt-tool`](/es/cli-reference#cli-flags) no estaba entre las herramientas MCP conectadas cuando la ejecución necesitó por primera vez una decisión de permiso, ya sea porque su servidor nunca se conectó o porque ningún servidor conectado expone una herramienta con ese nombre. Claude Code aún envía su prompt: la ejecución [no interactiva](/es/headless) sale con este error, y código de salida 1, en la primera llamada de herramienta que necesita aprobación, por lo que no produce respuesta aunque la solicitud se haya realizado. Antes del primer prompt, Claude Code espera hasta el tiempo de espera de conexión por servidor de 30 segundos establecido por [`MCP_TIMEOUT`](/es/env-vars) para que ese servidor se conecte. {/* min-version: 2.1.206 */}Antes de v2.1.206, el inicio no esperaba a que el servidor terminara de conectarse, por lo que un servidor que se iniciaba lentamente pero estaba en buen estado también producía este error.
1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232La lista después de `Available MCP tools:` nombra las herramientas MCP que estaban conectadas cuando terminó la espera.
1233
1234**Qué hacer:**
1235
1236* Compruebe que el servidor se inicia y permanece conectado: ejecute `claude mcp list` en el mismo directorio y confirme que el servidor aparece como conectado
1237* Confirme que el nombre de la herramienta coincida con el nombre `mcp__<server>__<tool>` que expone el servidor
1238* Si el servidor necesita más de 30 segundos para iniciarse, aumente [`MCP_TIMEOUT`](/es/env-vars)
1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 Errores de plugins1241 Errores de plugins
1123</h2>1242</h2>
1140* Si publica un marketplace de terceros que utilizó el nombre antes de que se reservara, cámbielo de nombre y pida a los usuarios que lo vuelvan a agregar desde su fuente1259* Si publica un marketplace de terceros que utilizó el nombre antes de que se reservara, cámbielo de nombre y pida a los usuarios que lo vuelvan a agregar desde su fuente
1141* Consulte la lista de nombres reservados en [Marketplace schema](/es/plugin-marketplaces#marketplace-schema)1260* Consulte la lista de nombres reservados en [Marketplace schema](/es/plugin-marketplaces#marketplace-schema)
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 Plugin command references user\_config in a shell command
1264</h3>
1265
1266Un hook de plugin, [monitor](/es/plugins-reference#monitors), o comando MCP [`headersHelper`](/es/mcp#use-dynamic-headers-for-custom-authentication) hace referencia a una [opción de plugin](/es/plugins-reference#user-configuration) `${user_config.KEY}`, y la cadena sustituida se pasaría a un shell. Un valor configurado que contenga `$(...)`, comillas invertidas o `;` se ejecutaría como código allí, por lo que Claude Code se niega a iniciar el componente en lugar de sustituir el valor. La verificación se ejecuta en la plantilla de comando, por lo que el error aparece incluso cuando aún no hay ningún valor configurado. Antes de v2.1.207, el valor se sustituía en el comando del shell.
1267
1268La redacción depende de qué superficie hizo referencia a la opción. Un hook de forma de shell informa:
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274Un monitor informa:
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280Un `headersHelper` de MCP informa:
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**Qué hacer:**
1287
1288* Para un hook, agregue una matriz `args` para que se ejecute en [forma exec](/es/hooks#exec-form-and-shell-form), donde cada `${user_config.KEY}` se convierte en un argumento sin shell en el medio. O elimine la referencia y lea la variable de entorno `$CLAUDE_PLUGIN_OPTION_<KEY>` dentro del script
1289* Para un monitor, elimine la referencia y haga que el script del monitor lea el valor desde un archivo de configuración
1290* Para un `headersHelper`, mueva `${user_config.KEY}` al campo `headers` del servidor, que no se analiza como shell, o lea el valor dentro del script del helper
1291
1292<h2 id="tool-errors">
1293 Errores de herramientas
1294</h2>
1295
1296Estos errores provienen de las herramientas integradas de Claude que rechazan una entrada. Claude corrige la mayoría de los errores de herramientas por sí solo; los dos siguientes requieren un cambio de su parte, porque provienen de una definición de subagenteque usted controla o de una regla de permisos que usted controla.
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 El agente se generaría con cero herramientas
1300</h3>
1301
1302Nada en la [lista de `tools` de un subagente](/es/sub-agents#supported-frontmatter-fields) se resolvió en una herramienta, por lo que Claude Code se niega a lanzar el subagente en lugar de iniciar uno que no pueda actuar. El mensaje agrupa las entradas por la razón por la que no se resolvieron: no es una herramienta reconocida, una herramienta que no está disponible para subagentes, o reconocida pero sin coincidencia con ninguna herramienta en la sesión actual. Omitir el campo `tools` nunca activa este rechazo. Un patrón de servidor MCP como `mcp__github__*` no está exento: cuando ninguna herramienta conectada proviene de ese servidor, el lanzamiento se rechaza con el patrón en el grupo sin coincidencias. Antes de v2.1.208, el subagente se lanzaba sin herramientas y devolvía un resultado vacío o confuso.
1303
1304```text theme={null}
1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
1306```
1307
1308**Qué hacer:**
1309
1310* Corrija cada entrada que el error nombra contra las [herramientas disponibles para subagentes](/es/sub-agents#available-tools)
1311* Elimine las entradas de herramientas que la sesión no tiene, como herramientas MCP de un servidor que no está conectado
1312* Para dar al subagente todas las herramientas que tiene el padre, elimine el campo `tools` en lugar de listar herramientas
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 El archivo está cubierto por una regla de denegación de Read
1316</h3>
1317
1318La herramienta Edit fue llamada en una ruta coincidente con una [regla de denegación de `Read`](/es/permissions#read-and-edit), incluyendo la creación de un nuevo archivo en esa ruta. Editar reescribe contenido que Claude debe poder leer de nuevo, por lo que la llamada se rechaza antes de cualquier acceso a archivos. La regla bloquea solo la herramienta Edit: Write y NotebookEdit no están cubiertos por reglas de denegación de `Read`. Antes de v2.1.208, solo una regla de denegación de `Edit` bloqueaba ediciones, y una regla de denegación de `Read` sola no lo hacía.
1319
1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1322```
1323
1324**Qué hacer:**
1325
1326* Si Claude debe poder editar el archivo, elimine o reduzca la regla de denegación de `Read` en `/permissions` o en [configuración](/es/settings#permission-settings)
1327* Si el archivo debe permanecer intacto, mantenga la regla y agregue una regla de denegación de `Edit` para la misma ruta para que las herramientas Write y NotebookEdit también se bloqueen
1328
1329<h2 id="background-session-errors">
1330 Errores de sesión en segundo plano
1331</h2>
1332
1333[Las sesiones en segundo plano](/es/agent-view) se ejecutan sin una terminal interactiva propia, por lo que los comandos que necesitan una se comportan de manera diferente allí. Estos mensajes aparecen en la transcripción de una sesión en segundo plano, en la vista de agente o después de conectarse.
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 Comandos rechazados en una sesión en segundo plano
1337</h3>
1338
1339Los comandos que abren un diálogo interactivo se rechazan en una sesión en segundo plano con un mensaje que nombra un formulario que funciona allí o le indica que ejecute el comando desde una terminal normal. `/install-github-app`, la lista de configuración `/mcp`, y las acciones de autenticación en el menú del servidor MCP se rechazan de esta manera. Antes de v2.1.208, abrían su diálogo dentro de la sesión en segundo plano.
1340{/* max-version: 2.1.208 */}En v2.1.208 solamente, el selector `/model` también fue rechazado en una sesión en segundo plano, y `/upgrade` imprimió la URL de actualización en lugar de abrir un navegador.
1341
1342La redacción nombra el comando que fue rechazado. La lista de configuración `/mcp` reporta:
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**Qué hacer:**
1349
1350* Use el formulario que nombra el mensaje, como `/mcp reconnect <server>`, `/mcp enable`, o `/mcp disable`
1351* Para flujos de inicio de sesión y autorización, ejecute el comando desde una sesión `claude` normal en una terminal
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 Errores del lanzador CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>
1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/es/corporate-launcher) está configurado, y su valor no se puede usar, por lo que Claude Code se niega a iniciar el proceso afectado en lugar de ejecutarlo sin el lanzador. Los problemas de configuración se reportan con un mensaje que comienza con el nombre de la variable y establece la razón, por ejemplo:
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363Un lanzador que se inicia pero sale sin reemplazarse a sí mismo con Claude Code falla la sesión que estaba iniciando, y la fila de la sesión en la vista de agente reporta que el lanzador `must exec, not daemonize`, seguido de cualquier cosa que el lanzador haya impreso. Una sesión que no puede iniciarse o alcanzar el servicio en segundo plano debido al lanzador reporta el problema del lanzador como la razón dentro de `Couldn't reach the background service (...)`.
1364
1365**Qué hacer:**
1366
1367* Establezca la variable en la ruta absoluta de un ejecutable que termine llamando a `exec "$@"`. Consulte [el contrato del lanzador](/es/corporate-launcher#the-launcher-contract) para el contrato completo
1368* Verifique `/status`, que muestra el comando de lanzamiento resuelto en su entrada Self-exec y advierte cuando el servicio en segundo plano en ejecución no coincide con él, o ejecute `claude daemon status` desde un shell
1369* Después de corregir el valor en el bloque `env` de [configuración](/es/corporate-launcher#set-up-the-launcher), reinicie el servicio en segundo plano con `claude daemon stop --any` para que el siguiente envío inicie uno envuelto
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 Advertencias de configuración1372 Advertencias de configuración
1145</h2>1373</h2>
1147Claude Code escribe estos mensajes en stderr al inicio en lugar de mostrar un error en la conversación. Informan sobre la configuración que leyó pero no aplicó.1375Claude Code escribe estos mensajes en stderr al inicio en lugar de mostrar un error en la conversación. Informan sobre la configuración que leyó pero no aplicó.
1148 1376
1149<h3 id="workspace-has-not-been-trusted">1377<h3 id="workspace-has-not-been-trusted">
1150 El espacio de trabajo no ha sido confiado1378 El espacio de trabajo no ha sido confiable
1151</h3>1379</h3>
1152 1380
1153Claude Code encontró reglas `permissions.allow` o entradas `permissions.additionalDirectories` en el archivo `.claude/settings.json` o `.claude/settings.local.json` del proyecto y no las aplicó, porque [las reglas de permiso del proyecto requieren confianza del espacio de trabajo](/es/permissions#project-allow-rules-and-workspace-trust). El recuento, el nombre de la configuración y el archivo nombrado en el mensaje varían según su configuración. Las reglas `deny` y `ask` no se ven afectadas.1381Claude Code encontró reglas `permissions.allow` o entradas `permissions.additionalDirectories` en el archivo `.claude/settings.json` o `.claude/settings.local.json` del proyecto y no las aplicó, porque [las reglas de permiso del proyecto requieren confianza del espacio de trabajo](/es/permissions#project-allow-rules-and-workspace-trust). El recuento, el nombre de la configuración y el archivo nombrado en el mensaje varían según su configuración. Las reglas `deny` y `ask` no se ven afectadas.
1158 1386
1159**Qué hacer:**1387**Qué hacer:**
1160 1388
1161* Ejecute `claude` en el directorio y acepte el diálogo de confianza. {/* min-version: 2.1.200 */}El diálogo aparece incluso cuando un directorio padre ya es confiable, enumera las reglas que se están reteniendo y le permite rechazar y continuar trabajando sin ellas. Antes de v2.1.200, no aparecía ningún diálogo en esa situación, por lo que este paso no se podía completar allí.1389* Ejecute `claude` en el directorio y acepte el diálogo de confianza. {/* min-version: 2.1.200 */}El diálogo aparece incluso cuando un directorio principal ya es confiable, enumera las reglas que se están reteniendo y le permite rechazar y continuar trabajando sin ellas. Antes de v2.1.200, no aparecía ningún diálogo en esa situación, por lo que este paso no se podía completar allí.
1162* En [modo no interactivo](/es/headless) con `-p` no se muestra ningún diálogo. Establezca la entrada `hasTrustDialogAccepted` en `~/.claude.json` utilizando la clave exacta de `projects` que imprime el mensaje.1390* En [modo no interactivo](/es/headless) con `-p` no se muestra ningún diálogo. Establezca la entrada `hasTrustDialogAccepted` en `~/.claude.json` usando la clave exacta `projects` que imprime el mensaje.
1163* {/* min-version: 2.1.200 */}Si el mensaje nombra `.claude/settings.local.json` e inició Claude Code fuera de un repositorio git o en su directorio de inicio, actualice a v2.1.200 o posterior. Las versiones 2.1.196 a 2.1.199 trataban su propio `.claude/settings.local.json` como suministrado por el repositorio en esos espacios de trabajo. Consulte [Reglas de permiso del proyecto y confianza del espacio de trabajo](/es/permissions#project-allow-rules-and-workspace-trust).1391* {/* min-version: 2.1.200 */}Si el mensaje nombra `.claude/settings.local.json` e inició Claude Code fuera de un repositorio git o en su directorio de inicio, actualice a v2.1.200 o posterior. Las versiones 2.1.196 a 2.1.199 trataron su propio `.claude/settings.local.json` como suministrado por el repositorio en esos espacios de trabajo. {/* min-version: 2.1.207 */}En v2.1.207 y posterior, actualizar no es suficiente fuera de un repositorio git si no ha confiado en la carpeta: determinar que una carpeta no está dentro de un repositorio ejecuta git, y Claude Code ejecuta esa verificación solo después de que acepte el diálogo de confianza, así que use el primer paso. Su directorio de inicio y cualquier otro [directorio de configuración](/es/permissions#project-allow-rules-and-workspace-trust) están exentos y no esperan el diálogo. Consulte [Reglas de permiso del proyecto y confianza del espacio de trabajo](/es/permissions#project-allow-rules-and-workspace-trust).
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 Las respuestas parecen de menor calidad que lo habitual1394 Las respuestas parecen de menor calidad que lo habitual
1169Si 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 tres casos específicos:1397Si 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 tres casos específicos:
1170 1398
1171* Un [`--fallback-model`](/es/cli-reference#cli-flags) configurado toma el control después de un error de disponibilidad, solo para ese turno, con un aviso en la transcripción1399* Un [`--fallback-model`](/es/cli-reference#cli-flags) configurado toma el control después de un error de disponibilidad, solo para ese turno, con un aviso en la transcripción
1172* Una verificación de inicio de Amazon Bedrock o de la plataforma de agentes de Google Cloud encuentra su modelo predeterminado no disponible1400* Una verificación de inicio de Amazon Bedrock o de la plataforma de agentes de Google Cloud encuentra que su modelo predeterminado no está disponible
1173* [Respaldo automático de modelo](/es/model-config#automatic-model-fallback) en Fable 5 mueve la sesión al modelo Opus predeterminado y muestra un aviso en la transcripción1401* El [respaldo automático de modelo](/es/model-config#automatic-model-fallback) en Fable 5 mueve la sesión al modelo Opus predeterminado y muestra un aviso en la transcripción
1174 1402
1175La verificación de selección de modelo a continuación detecta el segundo y tercer casos; el primero aparece como un aviso de transcripción en lugar de un cambio de `/model`. [Configuración de modelo](/es/model-config) explica cuándo se aplica cada respaldo.1403La verificación de selección de modelo a continuación detecta el segundo y tercer caso; el primero aparece como un aviso de transcripción en lugar de un cambio de `/model`. La [configuración de modelo](/es/model-config) explica cuándo se aplica cada respaldo.
1176 1404
1177Verifique estos primero:1405Verifique estos primero:
1178 1406
1179* **Selección de modelo**: ejecute `/model` para confirmar que está en el modelo que espera. Una opción anterior de `/model` o una variable de entorno `ANTHROPIC_MODEL` pueden tenerlo en un modelo más pequeño del que pretendía.1407* **Selección de modelo**: ejecute `/model` para confirmar que está en el modelo que espera. Una opción anterior de `/model` o una variable de entorno `ANTHROPIC_MODEL` pueden tenerlo en un modelo más pequeño del que pretendía.
1180* **Nivel de esfuerzo**: ejecute `/effort` para verificar el nivel de razonamiento actual y auméntelo para depuración difícil o trabajo de diseño. Los valores predeterminados varían según el modelo, así que verifique antes de asumir que está por debajo del máximo. Consulte [Ajustar nivel de esfuerzo](/es/model-config#adjust-effort-level) para los valores predeterminados por modelo y el atajo `ultrathink`.1408* **Nivel de esfuerzo**: ejecute `/effort` para verificar el nivel de razonamiento actual y auméntelo para depuración difícil o trabajo de diseño. Los valores predeterminados varían según el modelo, así que verifique antes de asumir que está por debajo del máximo. Consulte [Ajustar nivel de esfuerzo](/es/model-config#adjust-effort-level) para los valores predeterminados por modelo y el atajo `ultrathink`.
1181* **Presión de contexto**: ejecute `/context` para ver qué tan llena está la ventana. Si está cerca de la capacidad, ejecute `/compact` en un punto natural o `/clear` para comenzar de nuevo. Consulte [Explorar la ventana de contexto](/es/context-window) para ver cómo auto-compact afecta los turnos anteriores.1409* **Presión de contexto**: ejecute `/context` para ver qué tan llena está la ventana. Si está cerca de la capacidad, ejecute `/compact` en un punto natural o `/clear` para comenzar de nuevo. Consulte [Explorar la ventana de contexto](/es/context-window) para ver cómo auto-compact afecta los turnos anteriores.
1182* **Instrucciones obsoletas**: los archivos `CLAUDE.md` grandes u obsoletos y las definiciones de herramientas MCP consumen contexto y pueden dirigir las respuestas. {/* min-version: 2.1.205 */}El `/doctor` marca archivos de memoria de tamaño excesivo y extensiones no utilizadas, y `/context` muestra el uso de tokens de herramientas MCP. Antes de v2.1.205, `/doctor` abría una pantalla de diagnósticos que marcaba archivos de memoria de tamaño excesivo y definiciones de subagentos.1410* **Instrucciones obsoletas**: los archivos `CLAUDE.md` grandes u obsoletos y las definiciones de herramientas MCP consumen contexto y pueden dirigir las respuestas. {/* min-version: 2.1.205 */}La revisión `/doctor` marca archivos de memoria de gran tamaño y extensiones no utilizadas, y `/context` muestra el uso de tokens de herramientas MCP. Antes de v2.1.205, `/doctor` abría una pantalla de diagnósticos que marcaba archivos de memoria de gran tamaño y definiciones de subagentos.
1183 1411
1184Cuando una respuesta sale mal, retroceder generalmente funciona mejor que responder con correcciones. Presione Esc dos veces o ejecute `/rewind` para retroceder antes del turno incorrecto, luego reformule la solicitud con más especificidades. Corregir en el hilo mantiene el intento incorrecto en el contexto, lo que puede anclar respuestas posteriores a él. Consulte [Checkpointing](/es/checkpointing).1412Cuando una respuesta sale mal, retroceder generalmente funciona mejor que responder con correcciones. Presione Esc dos veces o ejecute `/rewind` para retroceder antes del turno incorrecto, luego reformule el mensaje con más especificidades. Corregir en el hilo mantiene el intento incorrecto en contexto, lo que puede anclar respuestas posteriores a él. Consulte [Checkpointing](/es/checkpointing).
1185 1413
1186Si la calidad aún parece incorrecta después de verificar lo anterior, ejecute `/feedback` y describa qué esperaba versus qué obtuvo. La retroalimentación enviada de esta manera incluye la transcripción de la conversación, que es la forma más rápida para que Anthropic diagnostique una regresión real. Consulte [Reportar un error](#report-an-error) si `/feedback` no está disponible en su entorno.1414Si la calidad aún parece incorrecta después de verificar lo anterior, ejecute `/feedback` y describa qué esperaba versus qué obtuvo. La retroalimentación enviada de esta manera incluye la transcripción de la conversación, que es la forma más rápida para que Anthropic diagnostique una regresión real. Consulte [Reportar un error](#report-an-error) si `/feedback` no está disponible en su entorno.
1187 1415
1188{/* min-version: 2.1.201 */}Si Sonnet 5 rechaza una solicitud y cita una inyección de solicitud sospechada en Claude Code v2.1.200 o anterior, ejecute `claude update` para obtener la corrección v2.1.201.1416Si Claude advierte sobre una inyección de mensaje sospechosa, o rechaza una solicitud debido a una inyección sospechada, y el texto que nombra la advertencia es contexto que Claude Code agrega a la conversación automáticamente en lugar de contenido de archivo o web, ejecute `claude update` e intente de nuevo. Si la advertencia se repite después de actualizar, [repórtela](#report-an-error) en lugar de pegar el contenido marcado nuevamente en el mensaje. {/* min-version: 2.1.201 */}Antes de v2.1.201, Sonnet 5 rechazaba algunas solicitudes de la misma manera.
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 Reportar un error1419 Reportar un error
1199 1427
1200Si un error no aparece aquí o la corrección sugerida no ayuda:1428Si un error no aparece aquí o la corrección sugerida no ayuda:
1201 1429
1202* Ejecute `/feedback` dentro de Claude Code para enviar la transcripción y una descripción a Anthropic. El comando también ofrece abrir un problema de GitHub rellenado previamente. En Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y otros proveedores de terceros, `/feedback` guarda un archivo local que puede enviar a su representante de cuenta de Anthropic en su lugar.1430* Ejecute `/feedback` dentro de Claude Code para enviar la transcripción y una descripción a Anthropic. El comando también ofrece abrir un problema de GitHub rellenado previamente. El envío a Anthropic requiere [autenticación](/es/authentication). En Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y otros proveedores de terceros, o cuando no hay credenciales de Anthropic configuradas, `/feedback` guarda un archivo local que puede enviar a su representante de cuenta de Anthropic en su lugar.
1203* Ejecute `claude doctor` desde su shell para un diagnóstico de solo lectura de su instalación, o ejecute el checkup `/doctor` dentro de Claude Code para encontrar y solucionar problemas de configuración1431* Ejecute `claude doctor` desde su shell para un diagnóstico de solo lectura de su instalación, o ejecute la verificación `/doctor` dentro de Claude Code para encontrar y solucionar problemas de configuración
1204* Consulte [status.claude.com](https://status.claude.com) para incidentes activos1432* Consulte [status.claude.com](https://status.claude.com) para incidentes activos
1205* Busque [problemas existentes](https://github.com/anthropics/claude-code/issues) en GitHub1433* Busque [problemas existentes](https://github.com/anthropics/claude-code/issues) en GitHub
