6 6
7> Busque mensajes de error en tiempo de ejecución de Claude Code con lo que significa cada uno y cómo solucionarlo.7> Busque mensajes de error en tiempo de ejecución de Claude Code con lo que significa cada uno y cómo solucionarlo.
8 8
9Esta página enumera los errores en tiempo de ejecución que Claude Code muestra y cómo recuperarse de cada uno, además de qué verificar cuando las respuestas parecen incorrectas sin un error. Para errores de instalación como `command not found` o fallos de TLS durante la configuración, consulte [Solucionar problemas de instalación e inicio de sesión](/es/troubleshoot-install).9Esta página enumera los errores en tiempo de ejecución que Claude Code muestra y cómo recuperarse de cada uno, además de qué verificar cuando las respuestas parecen incorrectas sin un error. Para errores de instalación como `command not found` o fallos de TLS durante la configuración, consulte [Solucionar problemas de instalación e inicio de sesión](/docs/es/troubleshoot-install).
10 10
11Estos errores y comandos de recuperación se aplican en la CLI, la [aplicación de escritorio](/es/desktop) y [Claude Code en la web](/es/claude-code-on-the-web), ya que los tres envuelven la misma CLI de Claude Code. Para problemas específicos de la superficie, consulte la sección de solución de problemas en la página de esa superficie.11Estos errores y comandos de recuperación se aplican en la CLI, la [aplicación de escritorio](/docs/es/desktop) y [Claude Code en la web](/docs/es/claude-code-on-the-web), ya que los tres envuelven la misma CLI de Claude Code. Para problemas específicos de la superficie, consulte la sección de solución de problemas en la página de esa superficie.
12 12
13<Note>13<Note>
14 Claude Code llama a la API de Claude para obtener respuestas del modelo, por lo que la mayoría de los errores en tiempo de ejecución se asignan a un código de error de API subyacente. Esta página cubre lo que significa cada error dentro de Claude Code y cómo recuperarse. Para las definiciones de código de estado HTTP sin procesar, consulte la [referencia de errores de la plataforma Claude](https://platform.claude.com/docs/en/api/errors).14 Claude Code llama a la API de Claude para obtener respuestas del modelo, por lo que la mayoría de los errores en tiempo de ejecución se asignan a un código de error de API subyacente. Esta página cubre lo que significa cada error dentro de Claude Code y cómo recuperarse. Para las definiciones de código de estado HTTP sin procesar, consulte la [referencia de errores de la plataforma Claude](https://platform.claude.com/docs/en/api/errors).
97 Reintentos automáticos97 Reintentos automáticos
98</h2>98</h2>
99 99
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.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. 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. 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.
101 101
102Algunas 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:
103 103
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.104* 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.
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.105* 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.106* 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.
107 107
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.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. 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.
109 109
110{/* min-version: 2.1.198 */}A partir de v2.1.198, el consejo del spinner habitual se suprime durante los reintentos. Una vez que se revela la razón del error, si el fallo es una sobrecarga 529, la línea debajo de la cuenta regresiva también nombra dónde verificar el estado del servicio: `status.claude.com` en la API de Anthropic, o el host del proveedor o puerta de enlace nombrado en el mensaje en otras configuraciones.110A partir de v2.1.198, el consejo del spinner habitual se suprime durante los reintentos. Una vez que se revela la razón del error, si el fallo es una sobrecarga 529, la línea debajo de la cuenta regresiva también nombra dónde verificar el estado del servicio: `status.claude.com` en la API de Anthropic, o el host del proveedor o puerta de enlace nombrado en el mensaje en otras configuraciones.
111 111
112{/* min-version: 2.1.185 */}Si no llegan datos en el flujo de respuesta durante 20 segundos mientras una solicitud aún está pendiente, el spinner muestra `Waiting for API response · will retry in … · check your network` antes de que comience cualquier reintento. La solicitud aún no ha fallado: la cuenta regresiva se ejecuta hasta el punto en que Claude Code interrumpe la conexión estancada y reintenta, por lo que el banner se borra por sí solo una vez que se reanuden los datos o el reintento tenga éxito. A partir de v2.1.185, el umbral es de 20 segundos; las versiones anteriores muestran el banner después de 10 segundos con una redacción diferente. Si reaparece en cada intento, trátelo como un [problema de red](#unable-to-connect-to-api).112Si no llegan datos en el flujo de respuesta durante 20 segundos mientras una solicitud aún está pendiente, el spinner muestra `Waiting for API response · will retry in … · check your network` antes de que comience cualquier reintento. La solicitud aún no ha fallado: la cuenta regresiva se ejecuta hasta el punto en que Claude Code interrumpe la conexión estancada y reintenta, por lo que el banner se borra por sí solo una vez que se reanuden los datos o el reintento tenga éxito. A partir de v2.1.185, el umbral es de 20 segundos; las versiones anteriores muestran el banner después de 10 segundos con una redacción diferente. Si reaparece en cada intento, trátelo como un [problema de red](#unable-to-connect-to-api).
113 113
114Cuando ve uno de los errores en esta página, esos reintentos ya se han agotado, a menos que pertenezca a una clase que no se reintenta, como una falla de validación de certificado. Puede ajustar el comportamiento con estas variables de entorno:114Cuando ve uno de los errores en esta página, esos reintentos ya se han agotado, a menos que pertenezca a una clase que no se reintenta, como una falla de validación de certificado. Puede ajustar el comportamiento con estas variables de entorno:
115 115
116| Variable | Predeterminado | Efecto |116| Variable | Predeterminado | Efecto |
117| :------------------------------------------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
118| [`CLAUDE_CODE_MAX_RETRIES`](/es/env-vars) | 10 | Número de intentos de reintento. {/* min-version: 2.1.186 */}Limitado a 15 a partir de v2.1.186; {/* min-version: 2.1.199 */}a partir de v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el valor predeterminado y elimina el límite. Redúzcalo para que los fallos aparezcan más rápido en scripts. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/es/env-vars) | 10 | Número de intentos de reintento. Limitado a 15 a partir de v2.1.186; a partir de v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el valor predeterminado y elimina el límite. Redúzcalo para que los fallos aparezcan más rápido en scripts. |
119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/es/env-vars) | sin establecer | Establézcalo en `1` en sesiones desatendidas como trabajos de CI para reintentar errores de capacidad `429` y `529` indefinidamente en lugar de fallar después de `CLAUDE_CODE_MAX_RETRIES` intentos. {/* min-version: 2.1.199 */}A partir de v2.1.199, también aumenta el recuento de reintento predeterminado para otros errores transitorios, como errores del servidor, tiempos de espera y conexiones perdidas, a 300, aproximadamente tres horas de retroceso, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si establece esa variable explícitamente. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/es/env-vars) | sin establecer | Establézcalo en `1` en sesiones desatendidas como trabajos de CI para reintentar errores de capacidad `429` y `529` indefinidamente en lugar de fallar después de `CLAUDE_CODE_MAX_RETRIES` intentos. A partir de v2.1.199, también aumenta el recuento de reintento predeterminado para otros errores transitorios, como errores del servidor, tiempos de espera y conexiones perdidas, a 300, aproximadamente tres horas de retroceso, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si establece esa variable explícitamente. |
120| [`API_TIMEOUT_MS`](/es/env-vars) | 600000 | Tiempo de espera por solicitud en milisegundos. Auméntelo para redes lentas o proxies. |120| [`API_TIMEOUT_MS`](/docs/es/env-vars) | 600000 | Tiempo de espera por solicitud en milisegundos. Auméntelo para redes lentas o proxies. |
121 121
122<h2 id="server-errors">122<h2 id="server-errors">
123 Errores del servidor123 Errores del servidor
196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.
197```197```
198 198
199* {/* min-version: 2.1.199 */}`Server error mid-response`: un error de servidor 5xx o sobrecargado a mitad de la transmisión. Esta variante requiere Claude Code v2.1.199 o posterior; antes de eso, ese caso descartaba la salida parcial e informaba todo el turno como un error.199* `Server error mid-response`: un error de servidor 5xx o sobrecargado a mitad de la transmisión. Esta variante requiere Claude Code v2.1.199 o posterior; antes de eso, ese caso descartaba la salida parcial e informaba todo el turno como un error.
200* `Connection closed mid-response`: la conexión se interrumpió.200* `Connection closed mid-response`: la conexión se interrumpió.
201* `Response stalled mid-stream`: la transmisión dejó de enviar datos.201* `Response stalled mid-stream`: la transmisión dejó de enviar datos.
202 202
210 El modo automático no puede determinar la seguridad de una acción210 El modo automático no puede determinar la seguridad de una acción
211</h3>211</h3>
212 212
213El modelo que [el modo automático](/es/permission-modes#eliminate-prompts-with-auto-mode) utiliza para clasificar acciones no pudo producir una decisión, por lo que el modo automático no aprobó la acción automáticamente. El mensaje que ve depende de por qué falló el clasificador.213El modelo que [el modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) utiliza para clasificar acciones no pudo producir una decisión, por lo que el modo automático no aprobó la acción automáticamente. El mensaje que ve depende de por qué falló el clasificador.
214 214
215Las lecturas, búsquedas y ediciones dentro de su directorio de trabajo omiten el clasificador, por lo que continúan funcionando en todos estos casos.215Las lecturas, búsquedas y ediciones dentro de su directorio de trabajo omiten el clasificador, por lo que continúan funcionando en todos estos casos.
216 216
224 224
225* Reintente después de unos segundos; Claude ve el mismo mensaje y generalmente reintenta por su cuenta225* Reintente después de unos segundos; Claude ve el mismo mensaje y generalmente reintenta por su cuenta
226* Si los reintentos continúan fallando, continúe con tareas de solo lectura y vuelva a la acción bloqueada más tarde226* Si los reintentos continúan fallando, continúe con tareas de solo lectura y vuelva a la acción bloqueada más tarde
227* Esto es transitorio e independiente de la [elegibilidad del modo automático](/es/permission-modes#eliminate-prompts-with-auto-mode); no necesita cambiar la configuración227* Esto es transitorio e independiente de la [elegibilidad del modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode); no necesita cambiar la configuración
228 228
229Cuando el clasificador devolvió una respuesta no analizable:229Cuando el clasificador devolvió una respuesta no analizable:
230 230
247 247
248* Esta no es una decisión sobre su acción. El contenido ya en su conversación activó un filtro de seguridad en la API cuando el modo automático envió la conversación al clasificador248* Esta no es una decisión sobre su acción. El contenido ya en su conversación activó un filtro de seguridad en la API cuando el modo automático envió la conversación al clasificador
249* Reintentar no ayudará; el mismo contenido de conversación activará el filtro nuevamente249* Reintentar no ayudará; el mismo contenido de conversación activará el filtro nuevamente
250* Cambie a un [modo de permiso](/es/permission-modes) diferente para que pueda aprobar la acción cuando se le solicite, o inicie una conversación nueva sin el contenido que activa el filtro250* Cambie a un [modo de permiso](/docs/es/permission-modes) diferente para que pueda aprobar la acción cuando se le solicite, o inicie una conversación nueva sin el contenido que activa el filtro
251 251
252Cuando la conversación ha crecido más que la ventana de contexto del clasificador:252Cuando la conversación ha crecido más que la ventana de contexto del clasificador:
253 253
255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
256```256```
257 257
258En una sesión interactiva, el modo automático vuelve a un aviso de permiso normal para esa acción para que pueda aprobar o denegar manualmente. En [modo no interactivo](/es/headless) la ejecución se cancela porque la transcripción solo crece y reintentar no puede tener éxito.258En una sesión interactiva, el modo automático vuelve a un aviso de permiso normal para esa acción para que pueda aprobar o denegar manualmente. En [modo no interactivo](/docs/es/headless) la ejecución se cancela porque la transcripción solo crece y reintentar no puede tener éxito.
259 259
260**Qué hacer:**260**Qué hacer:**
261 261
266 Agente terminado anticipadamente debido a un error de API266 Agente terminado anticipadamente debido a un error de API
267</h3>267</h3>
268 268
269{/* min-version: 2.1.199 */}La solicitud de API de un [subagente](/es/sub-agents) falló terminalmente, por ejemplo porque se alcanzó un límite de uso o los reintentos de un error del servidor se agotaron, por lo que el subagente se detuvo antes de terminar su tarea. Este mensaje requiere Claude Code v2.1.199 o posterior; antes de eso, el texto de error de la API se devolvía a Claude como si fuera el resultado del subagente.269La solicitud de API de un [subagente](/docs/es/sub-agents) falló terminalmente, por ejemplo porque se alcanzó un límite de uso o los reintentos de un error del servidor se agotaron, por lo que el subagente se detuvo antes de terminar su tarea. Este mensaje requiere Claude Code v2.1.199 o posterior; antes de eso, el texto de error de la API se devolvía a Claude como si fuera el resultado del subagente.
270 270
271```text theme={null}271```text theme={null}
272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>
275**Qué hacer:**275**Qué hacer:**
276 276
277* Haga coincidir el detalle del error después de los dos puntos con su propia sección en esta página, como [Límites de uso](#usage-limits) o [Errores del servidor](#server-errors), y siga los pasos de esa sección277* Haga coincidir el detalle del error después de los dos puntos con su propia sección en esta página, como [Límites de uso](#usage-limits) o [Errores del servidor](#server-errors), y siga los pasos de esa sección
278* Una vez que el error subyacente se resuelva, pida a Claude que reintente la tarea o [reanude el subagente](/es/sub-agents#resume-subagents)278* Una vez que el error subyacente se resuelva, pida a Claude que reintente la tarea o [reanude el subagente](/docs/es/sub-agents#resume-subagents)
279 279
280Cuando un límite de velocidad, sobrecarga o error del servidor interrumpe un subagente en primer plano que ya produjo salida de texto, Claude recibe esa salida parcial marcada como incompleta en lugar de este error. {/* min-version: 2.1.200 */}Un subagente cuya única salida fueron llamadas de herramienta también obtiene este error; en v2.1.199 eso devolvía un resultado parcial vacío en su lugar. Consulte [Errores de API en subagentes](/es/sub-agents#api-errors-in-subagents).280Cuando un límite de velocidad, sobrecarga o error del servidor interrumpe un subagente en primer plano que ya produjo salida de texto, Claude recibe esa salida parcial marcada como incompleta en lugar de este error. Un subagente cuya única salida fueron llamadas de herramienta también obtiene este error; en v2.1.199 eso devolvía un resultado parcial vacío en su lugar. Consulte [Errores de API en subagentes](/docs/es/sub-agents#api-errors-in-subagents).
281 281
282<h2 id="usage-limits">282<h2 id="usage-limits">
283 Límites de uso283 Límites de uso
309* Ejecute `/usage-credits` para comprar uso adicional en Pro y Max, o para solicitarlo a su administrador en Team y Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para obtener información sobre cómo se factura esto.309* Ejecute `/usage-credits` para comprar uso adicional en Pro y Max, o para solicitarlo a su administrador en Team y Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para obtener información sobre cómo se factura esto.
310* Para actualizar su plan a límites base más altos, consulte [claude.com/pricing](https://claude.com/pricing)310* Para actualizar su plan a límites base más altos, consulte [claude.com/pricing](https://claude.com/pricing)
311 311
312Para monitorear su asignación restante antes de alcanzar el límite, agregue los campos `rate_limits` a una [línea de estado personalizada](/es/statusline#rate-limit-usage), o en la aplicación de escritorio haga clic en el [anillo de uso](/es/desktop#check-usage) junto al selector de modelo.312Para monitorear su asignación restante antes de alcanzar el límite, agregue los campos `rate_limits` a una [línea de estado personalizada](/docs/es/statusline#rate-limit-usage), o en la aplicación de escritorio haga clic en el [anillo de uso](/docs/es/desktop#check-usage) junto al selector de modelo.
313 313
314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">
315 Se requieren créditos de uso para contexto de 1M315 Se requieren créditos de uso para contexto de 1M
321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
322```322```
323 323
324Esta es una verificación de derechos, no un agotamiento de cuota. Se activa incluso cuando sus asignaciones de sesión y semanales tienen capacidad restante. Consulte [Extended context](/es/model-config#extended-context) para ver qué planes incluyen contexto de 1M directamente y cuáles requieren créditos de uso.324Esta es una verificación de derechos, no un agotamiento de cuota. Se activa incluso cuando sus asignaciones de sesión y semanales tienen capacidad restante. Consulte [Extended context](/docs/es/model-config#extended-context) para ver qué planes incluyen contexto de 1M directamente y cuáles requieren créditos de uso.
325 325
326{/* min-version: 2.1.172 */}Cuando este error aparece a mitad de la conversación porque el contexto creció más allá de 200K tokens, Claude Code compacta automáticamente la conversación por debajo del límite de contexto estándar y mantiene la sesión en ese límite después, por lo que no se requiere ninguna acción. En versiones anteriores a v2.1.172, el error se repetía en cada solicitud posterior incluyendo `/compact`; ejecute `/clear` en esas versiones para recuperarse. Los pasos a continuación se aplican cuando seleccionó explícitamente un modelo `[1m]`.326Cuando este error aparece a mitad de la conversación porque el contexto creció más allá de 200K tokens, Claude Code compacta automáticamente la conversación por debajo del límite de contexto estándar y mantiene la sesión en ese límite después, por lo que no se requiere ninguna acción. En versiones anteriores a v2.1.172, el error se repetía en cada solicitud posterior incluyendo `/compact`; ejecute `/clear` en esas versiones para recuperarse. Los pasos a continuación se aplican cuando seleccionó explícitamente un modelo `[1m]`.
327 327
328**Qué hacer:**328**Qué hacer:**
329 329
330* Ejecute `/model` y seleccione la variante sin el sufijo `[1m]` para volver a la ventana de contexto estándar330* Ejecute `/model` y seleccione la variante sin el sufijo `[1m]` para volver a la ventana de contexto estándar
331* Ejecute `/usage-credits` para activar la facturación medida para la variante de 1M en Pro y Max, o para solicitarla a su administrador en Team y Enterprise331* Ejecute `/usage-credits` para activar la facturación medida para la variante de 1M en Pro y Max, o para solicitarla a su administrador en Team y Enterprise
332* Si el error persiste después de `/model`, es posible que una ID de modelo de 1M esté configurada en otro lugar. Consulte [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) para ver las ubicaciones de configuración a verificar en orden de prioridad.332* Si el error persiste después de `/model`, es posible que una ID de modelo de 1M esté configurada en otro lugar. Consulte [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) para ver las ubicaciones de configuración a verificar en orden de prioridad.
333* Para eliminar variantes de 1M del selector de modelo por completo, configure [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/es/env-vars)333* Para eliminar variantes de 1M del selector de modelo por completo, configure [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/es/env-vars)
334 334
335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">
336 El servidor está limitando temporalmente las solicitudes336 El servidor está limitando temporalmente las solicitudes
342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)
343```343```
344 344
345Claude Code distingue estos de su límite de plan por la ausencia de los encabezados de cuota unificada que lleva una respuesta de límite real. {/* min-version: 2.1.199 */}A partir de v2.1.199, esto se [reintenta automáticamente](#automatic-retries) con retroceso antes de mostrarse, independientemente de cómo se autentique. En versiones anteriores, una sesión iniciada con una suscripción de claude.ai falló el turno en la primera ocurrencia; solo las claves API y los inicios de sesión de Enterprise lo reintentaron.345Claude Code distingue estos de su límite de plan por la ausencia de los encabezados de cuota unificada que lleva una respuesta de límite real. A partir de v2.1.199, esto se [reintenta automáticamente](#automatic-retries) con retroceso antes de mostrarse, independientemente de cómo se autentique. En versiones anteriores, una sesión iniciada con una suscripción de claude.ai falló el turno en la primera ocurrencia; solo las claves API y los inicios de sesión de Enterprise lo reintentaron.
346 346
347**Qué hacer:**347**Qué hacer:**
348 348
366* Ejecute `/status` y confirme que la credencial activa es la que espera. Una `ANTHROPIC_API_KEY` extraviada en su entorno puede enrutar solicitudes a través de una clave de nivel bajo en lugar de su suscripción.366* Ejecute `/status` y confirme que la credencial activa es la que espera. Una `ANTHROPIC_API_KEY` extraviada en su entorno puede enrutar solicitudes a través de una clave de nivel bajo en lugar de su suscripción.
367* Consulte la consola de su proveedor para ver los límites activos y solicite un nivel más alto si es necesario367* Consulte la consola de su proveedor para ver los límites activos y solicite un nivel más alto si es necesario
368* Para claves API de Anthropic, consulte la [referencia de límites de velocidad](https://platform.claude.com/docs/en/api/rate-limits) para ver cómo funcionan los niveles y cómo establecer límites por espacio de trabajo368* Para claves API de Anthropic, consulte la [referencia de límites de velocidad](https://platform.claude.com/docs/en/api/rate-limits) para ver cómo funcionan los niveles y cómo establecer límites por espacio de trabajo
369* Reduzca la concurrencia: reduzca [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/es/env-vars), evite ejecutar muchos subagentos paralelos, o cambie a un modelo más pequeño con `/model` para ejecuciones de alto volumen con scripts369* Reduzca la concurrencia: reduzca [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/es/env-vars), evite ejecutar muchos subagentos paralelos, o cambie a un modelo más pequeño con `/model` para ejecuciones de alto volumen con scripts
370 370
371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">
372 El saldo de crédito es demasiado bajo372 El saldo de crédito es demasiado bajo
382 382
383* Agregue créditos en [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), y considere habilitar la recarga automática allí para que el saldo se reabastezca antes de llegar a cero383* Agregue créditos en [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), y considere habilitar la recarga automática allí para que el saldo se reabastezca antes de llegar a cero
384* Cambie a autenticación de suscripción con `/login` si tiene un plan Pro, Max, Team o Enterprise384* Cambie a autenticación de suscripción con `/login` si tiene un plan Pro, Max, Team o Enterprise
385* Establezca límites de gasto por espacio de trabajo en la Console para evitar que un único proyecto agote el saldo de la organización. Consulte [Manage costs effectively](/es/costs).385* Establezca límites de gasto por espacio de trabajo en la Console para evitar que un único proyecto agote el saldo de la organización. Consulte [Manage costs effectively](/docs/es/costs).
386 386
387<h2 id="authentication-errors">387<h2 id="authentication-errors">
388 Errores de autenticación388 Errores de autenticación
404 404
405* Ejecute `/login` para autenticarse con su suscripción de Claude o cuenta de Console405* Ejecute `/login` para autenticarse con su suscripción de Claude o cuenta de Console
406* Si esperaba que una variable de entorno lo autenticara, confirme que `ANTHROPIC_API_KEY` esté configurada y exportada en el shell donde lanzó `claude`406* Si esperaba que una variable de entorno lo autenticara, confirme que `ANTHROPIC_API_KEY` esté configurada y exportada en el shell donde lanzó `claude`
407* Para CI o automatización donde el inicio de sesión interactivo no es posible, configure un script [`apiKeyHelper`](/es/settings#available-settings) que obtenga una clave al iniciar407* Para CI o automatización donde el inicio de sesión interactivo no es posible, configure un script [`apiKeyHelper`](/docs/es/settings#available-settings) que obtenga una clave al iniciar
408* Consulte [Precedencia de autenticación](/es/authentication#authentication-precedence) para entender qué credencial usa Claude Code cuando hay varias presentes408* Consulte [Precedencia de autenticación](/docs/es/authentication#authentication-precedence) para entender qué credencial usa Claude Code cuando hay varias presentes
409 409
410Si se le solicita que inicie sesión repetidamente, consulte [No ha iniciado sesión o token expirado](/es/troubleshoot-install#not-logged-in-or-token-expired) para obtener correcciones del reloj del sistema y Keychain de macOS.410Si se le solicita que inicie sesión repetidamente, consulte [No ha iniciado sesión o token expirado](/docs/es/troubleshoot-install#not-logged-in-or-token-expired) para obtener correcciones del reloj del sistema y Keychain de macOS.
411 411
412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">
413 No se pudo resolver el método de autenticación413 No se pudo resolver el método de autenticación
414</h3>414</h3>
415 415
416La sesión llegó al cliente de API sin ninguna credencial. Esto aparece en [sesiones en segundo plano](/es/agent-view), sesiones en la nube y contextos del SDK de Agent donde la verificación de inicio de sesión interactivo no se ejecuta antes de la primera solicitud.416La sesión llegó al cliente de API sin ninguna credencial. Esto aparece en [sesiones en segundo plano](/docs/es/agent-view), sesiones en la nube y contextos del SDK de Agent donde la verificación de inicio de sesión interactivo no se ejecuta antes de la primera solicitud.
417 417
418```text theme={null}418```text theme={null}
419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted419Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
420```420```
421 421
422{/* min-version: 2.1.174 */}Antes de v2.1.174, una sesión en segundo plano o en la nube asignada a un worker pre-inicializado inactivo podría fallar de esta manera incluso cuando las credenciales válidas estaban configuradas. Actualice para recuperarse. En las versiones actuales, el error significa que no había credencial disponible para el proceso del worker.422Antes de v2.1.174, una sesión en segundo plano o en la nube asignada a un worker pre-inicializado inactivo podría fallar de esta manera incluso cuando las credenciales válidas estaban configuradas. Actualice para recuperarse. En las versiones actuales, el error significa que no había credencial disponible para el proceso del worker.
423 423
424**Qué hacer:**424**Qué hacer:**
425 425
426* Actualice a v2.1.174 o posterior si esto aparece en una sesión en segundo plano o en la nube y sus credenciales ya están configuradas426* Actualice a v2.1.174 o posterior si esto aparece en una sesión en segundo plano o en la nube y sus credenciales ya están configuradas
427* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` o sus credenciales del proveedor de nube estén configuradas en el entorno que lanza el worker, no solo en su shell interactivo427* Confirme que `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` o sus credenciales del proveedor de nube estén configuradas en el entorno que lanza el worker, no solo en su shell interactivo
428* Para el SDK de Agent, consulte [configuración de autenticación](/es/agent-sdk/overview#get-started)428* Para el SDK de Agent, consulte [configuración de autenticación](/docs/es/agent-sdk/overview#get-started)
429* Ejecute `/status` en una sesión interactiva en el mismo entorno para confirmar qué fuente de credencial se resuelve429* Ejecute `/status` en una sesión interactiva en el mismo entorno para confirmar qué fuente de credencial se resuelve
430 430
431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">
443* Verifique si hay errores tipográficos y confirme que la clave no haya sido revocada en la [Console](https://platform.claude.com/settings/keys)443* Verifique si hay errores tipográficos y confirme que la clave no haya sido revocada en la [Console](https://platform.claude.com/settings/keys)
444* Ejecute `env | grep ANTHROPIC` en el mismo shell. Herramientas como direnv, complementos de shell dotenv e IDE terminals pueden cargar una clave obsoleta de un archivo `.env` en su proyecto sin que la configure explícitamente.444* Ejecute `env | grep ANTHROPIC` en el mismo shell. Herramientas como direnv, complementos de shell dotenv e IDE terminals pueden cargar una clave obsoleta de un archivo `.env` en su proyecto sin que la configure explícitamente.
445* Desactive `ANTHROPIC_API_KEY` y ejecute `/login` para usar autenticación de suscripción en su lugar445* Desactive `ANTHROPIC_API_KEY` y ejecute `/login` para usar autenticación de suscripción en su lugar
446* 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`](/docs/es/settings#available-settings), ejecute el script directamente para confirmar que imprime una clave válida en stdout
447* 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
448 448
449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">
450 Su script apiKeyHelper está fallando450 Su script apiKeyHelper está fallando
451</h3>451</h3>
452 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`.453El comando configurado en la configuración [`apiKeyHelper`](/docs/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 454
455```text theme={null}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 output456Your 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```457```
458 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.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. 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 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.461Ejecutar `/login` no ayuda aquí: la salida del helper [tiene precedencia](/docs/es/authentication#authentication-precedence) sobre un inicio de sesión guardado mientras la configuración esté presente.
462 462
463**Qué hacer:**463**Qué hacer:**
464 464
465* Ejecute el comando configurado en `apiKeyHelper` directamente en su shell para reproducir el fallo465* 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 secretos466* 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.467* Corrija el comando para que imprima la clave en stdout y salga con código 0. Consulte [rotar credenciales con apiKeyHelper](/docs/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.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 469
470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
500```500```
501 501
502Las variables de entorno y `apiKeyHelper` tienen precedencia sobre `/login`, por lo que ejecutar `/login` solo no ayuda mientras cualquiera de ellos siga suministrando una clave. Consulte [Precedencia de autenticación](/es/authentication#authentication-precedence).502Las variables de entorno y `apiKeyHelper` tienen precedencia sobre `/login`, por lo que ejecutar `/login` solo no ayuda mientras cualquiera de ellos siga suministrando una clave. Consulte [Precedencia de autenticación](/docs/es/authentication#authentication-precedence).
503 503
504**Qué hacer:**504**Qué hacer:**
505 505
506* Si el mensaje menciona `ANTHROPIC_API_KEY`, desactívela en el shell actual y elimínela de su perfil de shell o archivo `.env`, luego relance `claude`506* Si el mensaje menciona `ANTHROPIC_API_KEY`, desactívela en el shell actual y elimínela de su perfil de shell o archivo `.env`, luego relance `claude`
507* Si el mensaje menciona `apiKeyHelper`, elimine la configuración [`apiKeyHelper`](/es/settings#available-settings) de su `settings.json`507* Si el mensaje menciona `apiKeyHelper`, elimine la configuración [`apiKeyHelper`](/docs/es/settings#available-settings) de su `settings.json`
508* Ejecute `/login` para iniciar sesión con su cuenta de claude.ai508* Ejecute `/login` para iniciar sesión con su cuenta de claude.ai
509* Ejecute `/status` después para confirmar que la credencial activa es su suscripción en lugar de una clave de API509* Ejecute `/status` después para confirmar que la credencial activa es su suscripción en lugar de una clave de API
510* Si necesita autenticación por clave de API para automatización, pida al administrador de su organización que la vuelva a habilitar en la Console510* Si necesita autenticación por clave de API para automatización, pida al administrador de su organización que la vuelva a habilitar en la Console
526**Qué hacer:**526**Qué hacer:**
527 527
528* Pida a su administrador que habilite el acceso a Claude Code para su organización528* Pida a su administrador que habilite el acceso a Claude Code para su organización
529* Autentíquese con una clave de API de Console en lugar de su suscripción. Consulte [Autenticación de Claude Console](/es/authentication#claude-console-authentication) para la configuración.529* Autentíquese con una clave de API de Console en lugar de su suscripción. Consulte [Autenticación de Claude Console](/docs/es/authentication#claude-console-authentication) para la configuración.
530* Si usted es el administrador y no ve una opción para habilitar el acceso, contacte con [soporte de Anthropic](https://support.claude.com)530* Si usted es el administrador y no ve una opción para habilitar el acceso, contacte con [soporte de Anthropic](https://support.claude.com)
531 531
532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">
533 Las rutinas están deshabilitadas por la política de su organización533 Las rutinas están deshabilitadas por la política de su organización
534</h3>534</h3>
535 535
536Un Propietario en su organización de Team o Enterprise ha desactivado las rutinas a nivel de organización. El error aparece cuando intenta crear o ejecutar una rutina, incluyendo desde `/schedule` y la interfaz de usuario de [Routines](/es/routines) en claude.ai/code.536Un Propietario en su organización de Team o Enterprise ha desactivado las rutinas a nivel de organización. El error aparece cuando intenta crear o ejecutar una rutina, incluyendo desde `/schedule` y la interfaz de usuario de [Routines](/docs/es/routines) en claude.ai/code.
537 537
538```text theme={null}538```text theme={null}
539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.
544**Qué hacer:**544**Qué hacer:**
545 545
546* Pida a un Propietario en su organización que habilite el interruptor **Routines** en [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Pida a un Propietario en su organización que habilite el interruptor **Routines** en [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
547* Para trabajo programado único que no requiere rutinas a nivel de organización, consulte [tareas programadas](/es/scheduled-tasks)547* Para trabajo programado único que no requiere rutinas a nivel de organización, consulte [tareas programadas](/docs/es/scheduled-tasks)
548 548
549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">
550 Remote Control requiere la API de Anthropic550 Remote Control requiere la API de Anthropic
551</h3>551</h3>
552 552
553La sesión no está hablando directamente con la API de Anthropic, por lo que no hay un backend de claude.ai para que [Remote Control](/es/remote-control) se empareje.553La sesión no está hablando directamente con la API de Anthropic, por lo que no hay un backend de claude.ai para que [Remote Control](/docs/es/remote-control) se empareje.
554 554
555```text theme={null}555```text theme={null}
556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.
557```557```
558 558
559Esto aparece en Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry. {/* min-version: 2.1.196 */}A partir de v2.1.196, también aparece cuando [`ANTHROPIC_BASE_URL`](/es/env-vars) apunta a un host diferente de `api.anthropic.com`, como una [puerta de enlace LLM](/es/llm-gateway) o proxy, incluso cuando inicia sesión con claude.ai.559Esto aparece en Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry. A partir de v2.1.196, también aparece cuando [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) apunta a un host diferente de `api.anthropic.com`, como una [puerta de enlace LLM](/docs/es/llm-gateway) o proxy, incluso cuando inicia sesión con claude.ai.
560 560
561**Qué hacer:**561**Qué hacer:**
562 562
563* Desactive `ANTHROPIC_BASE_URL` y reinicie la sesión, o inicie Remote Control desde una sesión que hable directamente con la API de Anthropic563* Desactive `ANTHROPIC_BASE_URL` y reinicie la sesión, o inicie Remote Control desde una sesión que hable directamente con la API de Anthropic
564* Para este y los otros mensajes de inicio de Remote Control, consulte [Solucionar problemas de Remote Control](/es/remote-control#troubleshooting)564* Para este y los otros mensajes de inicio de Remote Control, consulte [Solucionar problemas de Remote Control](/docs/es/remote-control#troubleshooting)
565 565
566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">
567 Token OAuth revocado o expirado567 Token OAuth revocado o expirado
581 581
582* Ejecute `/login` para iniciar sesión nuevamente582* Ejecute `/login` para iniciar sesión nuevamente
583* Si el error regresa dentro de la misma sesión después de volver a autenticarse, ejecute `/logout` primero para borrar completamente el token almacenado, luego `/login`583* Si el error regresa dentro de la misma sesión después de volver a autenticarse, ejecute `/logout` primero para borrar completamente el token almacenado, luego `/login`
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)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](/docs/es/troubleshoot-install#not-logged-in-or-token-expired)
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)585* Para otras fallas incluyendo `403 Forbidden` y problemas del navegador OAuth, consulte [Inicio de sesión y autenticación](/docs/es/troubleshoot-install#login-and-authentication)
586 586
587<h3 id="login-expired">587<h3 id="login-expired">
588 Login expirado588 Login expirado
589</h3>589</h3>
590 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.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. 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 592
593```text theme={null}593```text theme={null}
594Login expired · Please run /login594Login expired · Please run /login
595```595```
596 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`:597En [modo no interactivo](/docs/es/headless) (`-p`) y el [SDK de Agent](/docs/es/agent-sdk/overview), el mensaje se lee de la siguiente manera, y el código de error estructurado es `authentication_failed`:
598 598
599```text theme={null}599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed
602 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.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 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.605Las sesiones autenticadas con una clave de API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/es/env-vars) o un proveedor de terceros no usan el inicio de sesión guardado y nunca ven este mensaje.
606 606
607**Qué hacer:**607**Qué hacer:**
608 608
609* Ejecute `/login` para iniciar sesión nuevamente. Reintentar sin iniciar sesión muestra el mismo mensaje en cada solicitud.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).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`](/docs/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)611* Si iniciar sesión sigue fallando, consulte [Inicio de sesión y autenticación](/docs/es/troubleshoot-install#login-and-authentication)
612 612
613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
614 Requisito de alcance de OAuth614 Requisito de alcance de OAuth
628 Credenciales de AWS expiradas o no válidas628 Credenciales de AWS expiradas o no válidas
629</h3>629</h3>
630 630
631{/* min-version: 2.1.198 */}Este mensaje requiere Claude Code v2.1.198 o posterior y solo aparece cuando [`awsAuthRefresh`](/es/amazon-bedrock#advanced-credential-configuration) está configurado en su archivo de configuración. Su token de sesión de AWS expiró o fue rechazado, y la actualización automática que Claude Code ya ejecutó no produjo una credencial que la API acepte. Aparece en un 401 de [Claude Platform on AWS](/es/claude-platform-on-aws) o el [punto final de Mantle](/es/amazon-bedrock#use-the-mantle-endpoint), que es cómo esos proveedores reportan un token de seguridad expirado.631Este mensaje requiere Claude Code v2.1.198 o posterior y solo aparece cuando [`awsAuthRefresh`](/docs/es/amazon-bedrock#advanced-credential-configuration) está configurado en su archivo de configuración. Su token de sesión de AWS expiró o fue rechazado, y la actualización automática que Claude Code ya ejecutó no produjo una credencial que la API acepte. Aparece en un 401 de [Claude Platform on AWS](/docs/es/claude-platform-on-aws) o el [punto final de Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint), que es cómo esos proveedores reportan un token de seguridad expirado.
632 632
633La sugerencia de acción en el medio nombra el comando `awsAuthRefresh` de su configuración, por lo que varía. La parte estable es el `AWS credentials expired or invalid` inicial:633La sugerencia de acción en el medio nombra el comando `awsAuthRefresh` de su configuración, por lo que varía. La parte estable es el `AWS credentials expired or invalid` inicial:
634 634
641**Qué hacer:**641**Qué hacer:**
642 642
643* Ejecute el comando `awsAuthRefresh` nombrado en el mensaje, como `aws sso login --profile myprofile`, en otra terminal y complete el inicio de sesión del navegador, luego reintente643* Ejecute el comando `awsAuthRefresh` nombrado en el mensaje, como `aws sso login --profile myprofile`, en otra terminal y complete el inicio de sesión del navegador, luego reintente
644* En una sesión interactiva, ejecute `/login`, elija **plataforma de terceros**, luego seleccione **Claude Platform on AWS · refresh credentials** bajo **Usando plataformas de terceros** para ejecutar el mismo comando sin reiniciar Claude Code. Consulte [Configurar credenciales de AWS](/es/claude-platform-on-aws#1-configure-aws-credentials)644* En una sesión interactiva, ejecute `/login`, elija **plataforma de terceros**, luego seleccione **Claude Platform on AWS · refresh credentials** bajo **Usando plataformas de terceros** para ejecutar el mismo comando sin reiniciar Claude Code. Consulte [Configurar credenciales de AWS](/docs/es/claude-platform-on-aws#1-configure-aws-credentials)
645* Si el error se repite después de que el comando de actualización tenga éxito, confirme que la identidad es válida fuera de Claude Code con `aws sts get-caller-identity` en el mismo shell y perfil645* Si el error se repite después de que el comando de actualización tenga éxito, confirme que la identidad es válida fuera de Claude Code con `aws sts get-caller-identity` en el mismo shell y perfil
646 646
647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">
648 Falló la autenticación de AWS648 Falló la autenticación de AWS
649</h3>649</h3>
650 650
651{/* min-version: 2.1.198 */}Este mensaje requiere Claude Code v2.1.198 o posterior y solo aparece cuando [`awsAuthRefresh`](/es/amazon-bedrock#advanced-credential-configuration) está configurado en su archivo de configuración. Su proveedor de AWS devolvió un 403, o [Amazon Bedrock](/es/amazon-bedrock) devolvió un 401.651Este mensaje requiere Claude Code v2.1.198 o posterior y solo aparece cuando [`awsAuthRefresh`](/docs/es/amazon-bedrock#advanced-credential-configuration) está configurado en su archivo de configuración. Su proveedor de AWS devolvió un 403, o [Amazon Bedrock](/docs/es/amazon-bedrock) devolvió un 401.
652 652
653Claude Code no puede decir cuál es la causa que encontró. Amazon Bedrock reporta un token de seguridad expirado como un 403, pero un 403 también es cómo reporta una denegación de autorización, como un `AccessDeniedException` de un permiso de IAM faltante o un modelo que no está habilitado para su cuenta.653Claude Code no puede decir cuál es la causa que encontró. Amazon Bedrock reporta un token de seguridad expirado como un 403, pero un 403 también es cómo reporta una denegación de autorización, como un `AccessDeniedException` de un permiso de IAM faltante o un modelo que no está habilitado para su cuenta.
654 654
665**Qué hacer:**665**Qué hacer:**
666 666
667* Ejecute el comando `awsAuthRefresh` nombrado en el mensaje, o `aws sso login`, en caso de que una credencial expirada sea la causa667* Ejecute el comando `awsAuthRefresh` nombrado en el mensaje, o `aws sso login`, en caso de que una credencial expirada sea la causa
668* 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](/docs/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
669* 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
670 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">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ó672 El tiempo de resolución de credenciales de la cadena predeterminada de AWS se agotó
673</h3>673</h3>
674 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.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](/docs/es/amazon-bedrock), [Claude Platform on AWS](/docs/es/claude-platform-on-aws) o el [punto final de Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint). Claude Code borra su [caché de credenciales](/docs/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 676
677```text theme={null}677```text theme={null}
678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out
679```679```
680 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.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. Antes de v2.1.207, una cadena estancada dejaba la solicitud esperando indefinidamente en lugar de fallar con este mensaje.
682 682
683**Qué hacer:**683**Qué hacer:**
684 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.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 navegador686* 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)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`](/docs/es/env-vars)
688 688
689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
690 Errores de red y conexión690 Errores de red y conexión
712**Qué hacer:**712**Qué hacer:**
713 713
714* Confirme que puede alcanzar el host de la API desde el mismo shell ejecutando `curl -I https://api.anthropic.com`. En Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que no se use el alias `Invoke-WebRequest` integrado.714* Confirme que puede alcanzar el host de la API desde el mismo shell ejecutando `curl -I https://api.anthropic.com`. En Windows PowerShell use `curl.exe -I https://api.anthropic.com` para que no se use el alias `Invoke-WebRequest` integrado.
715* Si está detrás de un proxy corporativo, establezca `HTTPS_PROXY` antes de lanzar Claude Code y consulte [Configuración de red](/es/network-config)715* Si está detrás de un proxy corporativo, establezca `HTTPS_PROXY` antes de lanzar Claude Code y consulte [Configuración de red](/docs/es/network-config)
716* Si enruta a través de una puerta de enlace LLM o relé, establezca [`ANTHROPIC_BASE_URL`](/es/env-vars) en su dirección. Consulte [Conectar Claude Code a una puerta de enlace LLM](/es/llm-gateway-connect) para la configuración.716* Si enruta a través de una puerta de enlace LLM o relé, establezca [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) en su dirección. Consulte [Conectar Claude Code a una puerta de enlace LLM](/docs/es/llm-gateway-connect) para la configuración.
717* Asegúrese de que su firewall permita los hosts enumerados en [Requisitos de acceso a la red](/es/network-config#network-access-requirements)717* Asegúrese de que su firewall permita los hosts enumerados en [Requisitos de acceso a la red](/docs/es/network-config#network-access-requirements)
718* Los fallos intermitentes se [reintentan automáticamente](#automatic-retries); los fallos persistentes apuntan a un problema de red local718* Los fallos intermitentes se [reintentan automáticamente](#automatic-retries); los fallos persistentes apuntan a un problema de red local
719 719
720Si `curl` tiene éxito pero Claude Code aún falla, la causa suele ser algo entre el tiempo de ejecución y la red en lugar de la red misma:720Si `curl` tiene éxito pero Claude Code aún falla, la causa suele ser algo entre el tiempo de ejecución y la red en lugar de la red misma:
727 La respuesta de streaming de Bedrock tiene un content-type inesperado727 La respuesta de streaming de Bedrock tiene un content-type inesperado
728</h3>728</h3>
729 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.730Una puerta de enlace o proxy entre Claude Code y [Amazon Bedrock](/docs/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 731
732```text theme={null}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.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```734```
735 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.736Antes 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 737
738**Qué hacer:**738**Qué hacer:**
739 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.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).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`](/docs/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](/docs/es/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742 742
743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
744 Errores de certificado SSL744 Errores de certificado SSL
751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected
752```752```
753 753
754{/* min-version: 2.1.199 */}A partir de v2.1.199, un fallo de validación de certificado no se reintenta, por lo que este error aparece en el primer intento en lugar de después del [presupuesto de reintentos](#automatic-retries) completo. Las versiones anteriores pasaban unos minutos reintentando antes de mostrarlo. Las condiciones TLS transitorias, como un tiempo de espera de protocolo de enlace, aún se reintentan.754A partir de v2.1.199, un fallo de validación de certificado no se reintenta, por lo que este error aparece en el primer intento en lugar de después del [presupuesto de reintentos](#automatic-retries) completo. Las versiones anteriores pasaban unos minutos reintentando antes de mostrarlo. Las condiciones TLS transitorias, como un tiempo de espera de protocolo de enlace, aún se reintentan.
755 755
756Durante `/login` y la verificación de conectividad de inicio, el mismo fallo se reporta con el código OpenSSL y la solución en línea:756Durante `/login` y la verificación de conectividad de inicio, el mismo fallo se reporta con el código OpenSSL y la solución en línea:
757 757
762**Qué hacer:**762**Qué hacer:**
763 763
764* Exporte el paquete de CA de su organización y apunte Claude Code a él con `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Exporte el paquete de CA de su organización y apunte Claude Code a él con `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
765* Consulte [Configuración de red](/es/network-config#custom-ca-certificates) para obtener instrucciones de configuración completas765* Consulte [Configuración de red](/docs/es/network-config#custom-ca-certificates) para obtener instrucciones de configuración completas
766* No establezca `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desactiva completamente la validación de certificados766* No establezca `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desactiva completamente la validación de certificados
767 767
768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">
778 778
779También puede ver un certificado TLS que no coincide con el certificado real del destino. El entorno en la nube enruta el tráfico saliente a través de un proxy que aplica la política de red, por lo que un certificado no coincidente significa que el proxy terminó la conexión, no el destino.779También puede ver un certificado TLS que no coincide con el certificado real del destino. El entorno en la nube enruta el tráfico saliente a través de un proxy que aplica la política de red, por lo que un certificado no coincidente significa que el proxy terminó la conexión, no el destino.
780 780
781Este no es un problema de red del lado del cliente. Las sesiones en la nube y las [rutinas](/es/routines) se ejecutan dentro de un entorno aislado cuyo tráfico saliente se filtra a la lista de permitidos del entorno. El entorno **Default** utiliza acceso **Trusted**, que permite la [lista de permitidos predeterminada](/es/claude-code-on-the-web#default-allowed-domains) de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes, pero bloquea todo lo demás.781Este no es un problema de red del lado del cliente. Las sesiones en la nube y las [rutinas](/docs/es/routines) se ejecutan dentro de un entorno aislado cuyo tráfico saliente se filtra a la lista de permitidos del entorno. El entorno **Default** utiliza acceso **Trusted**, que permite la [lista de permitidos predeterminada](/docs/es/claude-code-on-the-web#default-allowed-domains) de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes, pero bloquea todo lo demás.
782 782
783**Qué hacer:**783**Qué hacer:**
784 784
785* Abra la rutina para editar, o inicie una sesión en la nube. Seleccione el icono de nube que muestra el nombre de su entorno, como **Default**, para abrir el selector. Pase el cursor sobre su entorno y haga clic en el icono de configuración.785* Abra la rutina para editar, o inicie una sesión en la nube. Seleccione el icono de nube que muestra el nombre de su entorno, como **Default**, para abrir el selector. Pase el cursor sobre su entorno y haga clic en el icono de configuración.
786* En el diálogo **Update cloud environment**, cambie **Network access** de **Trusted** a **Custom**, luego agregue el dominio bloqueado a **Allowed domains**. Ingrese un dominio por línea. Marque **Also include default list of common package managers** para mantener la [lista de permitidos predeterminada](/es/claude-code-on-the-web#default-allowed-domains) junto con sus dominios personalizados. Seleccione **Full** en su lugar si desea acceso sin restricciones.786* En el diálogo **Update cloud environment**, cambie **Network access** de **Trusted** a **Custom**, luego agregue el dominio bloqueado a **Allowed domains**. Ingrese un dominio por línea. Marque **Also include default list of common package managers** para mantener la [lista de permitidos predeterminada](/docs/es/claude-code-on-the-web#default-allowed-domains) junto con sus dominios personalizados. Seleccione **Full** en su lugar si desea acceso sin restricciones.
787* Haga clic en **Save changes**. La siguiente ejecución utiliza la lista de permitidos actualizada.787* Haga clic en **Save changes**. La siguiente ejecución utiliza la lista de permitidos actualizada.
788 788
789Consulte [Network access](/es/claude-code-on-the-web#network-access) para los niveles de acceso y la lista de permitidos predeterminada. Las sesiones de CLI locales no se ven afectadas por esta política.789Consulte [Network access](/docs/es/claude-code-on-the-web#network-access) para los niveles de acceso y la lista de permitidos predeterminada. Las sesiones de CLI locales no se ven afectadas por esta política.
790 790
791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">
792 No se pudo reconectar a su sesión de Remote Control792 No se pudo reconectar a su sesión de Remote Control
796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
797```797```
798 798
799Reanudar con `claude --resume` o `claude --continue` se reconecta a la sesión de [Remote Control](/es/remote-control) registrada en esa conversación. Este mensaje significa que la reconexión falló por una razón que puede ser temporal, como una interrupción de red o un error del servidor, por lo que Claude Code no puede confirmar si la sesión remota aún existe. Su sesión local continúa ejecutándose sin Remote Control.799Reanudar con `claude --resume` o `claude --continue` se reconecta a la sesión de [Remote Control](/docs/es/remote-control) registrada en esa conversación. Este mensaje significa que la reconexión falló por una razón que puede ser temporal, como una interrupción de red o un error del servidor, por lo que Claude Code no puede confirmar si la sesión remota aún existe. Su sesión local continúa ejecutándose sin Remote Control.
800 800
801**Qué hacer:**801**Qué hacer:**
802 802
803* Ejecute `/remote-control` para reintentar la conexión803* Ejecute `/remote-control` para reintentar la conexión
804* Inicie Claude Code sin `--resume` para crear una nueva sesión de Remote Control804* Inicie Claude Code sin `--resume` para crear una nueva sesión de Remote Control
805* Para otros mensajes de inicio de Remote Control, consulte [Solucionar problemas de Remote Control](/es/remote-control#troubleshooting)805* Para otros mensajes de inicio de Remote Control, consulte [Solucionar problemas de Remote Control](/docs/es/remote-control#troubleshooting)
806 806
807No verá este mensaje cuando el servidor confirme que la sesión anterior ya no existe; Claude Code crea una nueva en ese caso. {/* min-version: 2.1.200 */}Antes de v2.1.200, cualquier fallo de reconexión creaba una nueva sesión de Remote Control, que dejaba sesiones adicionales en la lista de sesiones en claude.ai/code.807No verá este mensaje cuando el servidor confirme que la sesión anterior ya no existe; Claude Code crea una nueva en ese caso. Antes de v2.1.200, cualquier fallo de reconexión creaba una nueva sesión de Remote Control, que dejaba sesiones adicionales en la lista de sesiones en claude.ai/code.
808 808
809<h2 id="request-errors">809<h2 id="request-errors">
810 Errores de solicitud810 Errores de solicitud
827* Ejecute `/compact` para resumir turnos anteriores y liberar espacio, o `/clear` para comenzar de nuevo827* Ejecute `/compact` para resumir turnos anteriores y liberar espacio, o `/clear` para comenzar de nuevo
828* Ejecute `/context` para ver un desglose de lo que está consumiendo la ventana: prompt del sistema, herramientas, archivos de memoria y mensajes828* Ejecute `/context` para ver un desglose de lo que está consumiendo la ventana: prompt del sistema, herramientas, archivos de memoria y mensajes
829* Deshabilite los servidores MCP que no está utilizando con `/mcp disable <name>` para eliminar sus definiciones de herramientas del contexto829* Deshabilite los servidores MCP que no está utilizando con `/mcp disable <name>` para eliminar sus definiciones de herramientas del contexto
830* Recorte archivos de memoria `CLAUDE.md` grandes, o mueva instrucciones a [reglas con alcance de ruta](/es/memory#path-specific-rules) que se carguen solo cuando sea relevante830* Recorte archivos de memoria `CLAUDE.md` grandes, o mueva instrucciones a [reglas con alcance de ruta](/docs/es/memory#path-specific-rules) que se carguen solo cuando sea relevante
831* Los suagentes heredan cada definición de herramienta MCP de la sesión principal, lo que puede llenar su ventana de contexto antes del primer turno. Deshabilite los servidores MCP que no está utilizando antes de generar suagentes.831* Los suagentes heredan cada definición de herramienta MCP de la sesión principal, lo que puede llenar su ventana de contexto antes del primer turno. Deshabilite los servidores MCP que no está utilizando antes de generar suagentes.
832* Auto-compact está habilitado de forma predeterminada y normalmente previene este error. Si ha establecido [`DISABLE_AUTO_COMPACT`](/es/env-vars), vuelva a habilitarlo o ejecute `/compact` manualmente antes de que la ventana se llene.832* Auto-compact está habilitado de forma predeterminada y normalmente previene este error. Si ha establecido [`DISABLE_AUTO_COMPACT`](/docs/es/env-vars), vuelva a habilitarlo o ejecute `/compact` manualmente antes de que la ventana se llene.
833 833
834Consulte [Explore the context window](/es/context-window) para una vista interactiva de cómo se llena el contexto.834Consulte [Explore the context window](/docs/es/context-window) para una vista interactiva de cómo se llena el contexto.
835 835
836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">
837 Error durante la compactación: Conversación demasiado larga837 Error durante la compactación: Conversación demasiado larga
879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size
880```880```
881 881
882{/* min-version: 2.1.142 */}Claude Code reemplaza la imagen no procesable con un marcador de posición de texto y reintenta, por lo que los mensajes posteriores tienen éxito. En versiones anteriores a 2.1.142, una imagen pegada podría permanecer en la conversación y repetir el mismo error en cada mensaje posterior. Para recuperarse en esas versiones, presione Esc dos veces y retroceda más allá del turno donde se agregó la imagen.882Claude Code reemplaza la imagen no procesable con un marcador de posición de texto y reintenta, por lo que los mensajes posteriores tienen éxito. En versiones anteriores a 2.1.142, una imagen pegada podría permanecer en la conversación y repetir el mismo error en cada mensaje posterior. Para recuperarse en esas versiones, presione Esc dos veces y retroceda más allá del turno donde se agregó la imagen.
883 883
884**Qué hacer:**884**Qué hacer:**
885 885
939 939
940**Qué hacer:**940**Qué hacer:**
941 941
942* Configure su puerta de enlace para reenviar el encabezado `anthropic-beta`. Consulte [feature pass-through](/es/llm-gateway-protocol#feature-pass-through) para saber qué deben reenviar las puertas de enlace.942* Configure su puerta de enlace para reenviar el encabezado `anthropic-beta`. Consulte [feature pass-through](/docs/es/llm-gateway-protocol#feature-pass-through) para saber qué deben reenviar las puertas de enlace.
943* Como alternativa, establezca [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/es/env-vars) antes de iniciar. Esto deshabilita características que requieren el encabezado beta para que las solicitudes tengan éxito a través de una puerta de enlace que no puede reenviarlo.943* Como alternativa, establezca [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/es/env-vars) antes de iniciar. Esto deshabilita características que requieren el encabezado beta para que las solicitudes tengan éxito a través de una puerta de enlace que no puede reenviarlo.
944 944
945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">
946 Hay un problema con el modelo seleccionado946 Hay un problema con el modelo seleccionado
955**Qué hacer:**955**Qué hacer:**
956 956
957* **CLI interactivo**: ejecute `/model` para elegir entre los modelos disponibles para su cuenta.957* **CLI interactivo**: ejecute `/model` para elegir entre los modelos disponibles para su cuenta.
958* **Modo no interactivo (`-p`)**: pase `--model` con un alias o ID válido, o establezca [`ANTHROPIC_MODEL`](/es/env-vars). El texto de error muestra `Run --model` en esta superficie.958* **Modo no interactivo (`-p`)**: pase `--model` con un alias o ID válido, o establezca [`ANTHROPIC_MODEL`](/docs/es/env-vars). El texto de error muestra `Run --model` en esta superficie.
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.959* **Agent SDK**: el texto de error omite la sugerencia porque el modelo se establece mediante programación. Establezca [`model` en `Options`](/docs/es/agent-sdk/typescript#options) en TypeScript o [`ClaudeAgentOptions(model=...)`](/docs/es/agent-sdk/python#claudeagentoptions) en Python, y maneje el error estructurado `model_not_found` para mostrar su propio reintento o selector de modelo.
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).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](/docs/es/model-config).
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.961* Si el modelo incorrecto sigue apareciendo en la CLI, hay un ID obsoleto establecido en algún lugar. Verifique en [orden de prioridad](/docs/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.962* 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.
963* 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](/docs/es/google-vertex-ai#troubleshooting).
964 964
965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
966 El modelo no es un ID de modelo reconocido966 El modelo no es un ID de modelo reconocido
974 974
975La sugerencia final nombra el alias o ID de modelo más cercano. Cuando nada es lo suficientemente cercano, dice `Run /model to see available models.` en su lugar.975La sugerencia final nombra el alias o ID de modelo más cercano. Cuando nada es lo suficientemente cercano, dice `Run /model to see available models.` en su lugar.
976 976
977Claude Code produce este error localmente en el momento en que se solicita el cambio, antes de que se realice cualquier solicitud de API. Se aplica cuando un modelo se establece a través del método [Agent SDK](/es/agent-sdk/typescript) `setModel()` o por una aplicación como la [Desktop app](/es/desktop) que ejecuta la CLI de Claude Code para usted.977Claude Code produce este error localmente en el momento en que se solicita el cambio, antes de que se realice cualquier solicitud de API. Se aplica cuando un modelo se establece a través del método [Agent SDK](/docs/es/agent-sdk/typescript) `setModel()` o por una aplicación como la [Desktop app](/docs/es/desktop) que ejecuta la CLI de Claude Code para usted.
978 978
979**Qué hacer:**979**Qué hacer:**
980 980
981* Ejecute `/model` sin argumento para abrir el selector y elegir entre los modelos disponibles para su cuenta, luego pase el alias o ID que se muestra allí981* Ejecute `/model` sin argumento para abrir el selector y elegir entre los modelos disponibles para su cuenta, luego pase el alias o ID que se muestra allí
982* Si utilizó un alias que una versión más nueva de Claude Code admite, ejecute `claude update`. Un ID completo que comienza con `claude-` pasa esta verificación incluso cuando el modelo es más nuevo que su versión de Claude Code, por lo que la actualización no es necesaria para esos.982* Si utilizó un alias que una versión más nueva de Claude Code admite, ejecute `claude update`. Un ID completo que comienza con `claude-` pasa esta verificación incluso cuando el modelo es más nuevo que su versión de Claude Code, por lo que la actualización no es necesaria para esos.
983* Un modelo guardado antes de v2.1.200 no se repara con esta verificación. Si un valor obsoleto sigue apareciendo, elimínelo de las ubicaciones enumeradas en [Hay un problema con el modelo seleccionado](#theres-an-issue-with-the-selected-model).983* Un modelo guardado antes de v2.1.200 no se repara con esta verificación. Si un valor obsoleto sigue apareciendo, elimínelo de las ubicaciones enumeradas en [Hay un problema con el modelo seleccionado](#theres-an-issue-with-the-selected-model).
984* La verificación se ejecuta solo en la API de Anthropic. En Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/es/claude-platform-on-aws) y detrás de una [LLM gateway](/es/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizado, su proveedor o puerta de enlace define los nombres de modelo, por lo que Claude Code acepta cualquier cadena y la pasa.984* La verificación se ejecuta solo en la API de Anthropic. En Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/es/claude-platform-on-aws) y detrás de una [LLM gateway](/docs/es/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizado, su proveedor o puerta de enlace define los nombres de modelo, por lo que Claude Code acepta cualquier cadena y la pasa.
985 985
986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
987 Claude Opus no está disponible con el plan Claude Pro987 Claude Opus no está disponible con el plan Claude Pro
1003 El modelo está restringido por la configuración de su organización1003 El modelo está restringido por la configuración de su organización
1004</h3>1004</h3>
1005 1005
1006Su administrador de organización ha deshabilitado este modelo en la consola de administración de claude.ai, o está excluido por una lista de permitidos [`availableModels`](/es/model-config#restrict-model-selection) en la configuración administrada. Cuando el modelo restringido se estableció con `--model`, `ANTHROPIC_MODEL` o la configuración `model`, Claude Code sustituye un modelo permitido y continúa. Escribir `/model <name>` para un modelo restringido se rechaza con `Run /model to choose a different model.` y la sesión mantiene su modelo actual.1006Su administrador de organización ha deshabilitado este modelo en la consola de administración de claude.ai, o está excluido por una lista de permitidos [`availableModels`](/docs/es/model-config#restrict-model-selection) en la configuración administrada. Cuando el modelo restringido se estableció con `--model`, `ANTHROPIC_MODEL` o la configuración `model`, Claude Code sustituye un modelo permitido y continúa. Escribir `/model <name>` para un modelo restringido se rechaza con `Run /model to choose a different model.` y la sesión mantiene su modelo actual.
1007 1007
1008```text theme={null}1008```text theme={null}
1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
1010```1010```
1011 1011
1012Claude Code trata un alias de familia de modelo, uno de `opus`, `sonnet`, `haiku` o `fable`, como una solicitud de esa familia en lugar de su versión más nueva. En la API de Anthropic y en [Claude Platform on AWS](/es/claude-platform-on-aws), un alias de familia restringido se resuelve a la versión más nueva de la familia que su organización y la lista de permitidos `availableModels` permiten, y el aviso de sustitución nombra esa versión. Claude Code rechaza `/model <alias>` solo cuando cada versión de la familia está restringida. Antes de v2.1.205, un alias de familia se sustituía o rechazaba basándose únicamente en su versión más nueva, incluso cuando una versión anterior de la misma familia estaba permitida.1012Claude Code trata un alias de familia de modelo, uno de `opus`, `sonnet`, `haiku` o `fable`, como una solicitud de esa familia en lugar de su versión más nueva. En la API de Anthropic y en [Claude Platform on AWS](/docs/es/claude-platform-on-aws), un alias de familia restringido se resuelve a la versión más nueva de la familia que su organización y la lista de permitidos `availableModels` permiten, y el aviso de sustitución nombra esa versión. Claude Code rechaza `/model <alias>` solo cuando cada versión de la familia está restringida. Antes de v2.1.205, un alias de familia se sustituía o rechazaba basándose únicamente en su versión más nueva, incluso cuando una versión anterior de la misma familia estaba permitida.
1013 1013
1014**Qué hacer:**1014**Qué hacer:**
1015 1015
1016* Ejecute `/model` para elegir entre los modelos que su organización permite. Los modelos restringidos están ocultos en el selector.1016* Ejecute `/model` para elegir entre los modelos que su organización permite. Los modelos restringidos están ocultos en el selector.
1017* Si el modelo restringido se estableció en `--model`, `ANTHROPIC_MODEL` o el campo `model` de un archivo de configuración, elimine o actualice ese valor para que el aviso no se repita en cada inicio1017* Si el modelo restringido se estableció en `--model`, `ANTHROPIC_MODEL` o el campo `model` de un archivo de configuración, elimine o actualice ese valor para que el aviso no se repita en cada inicio
1018* Si necesita acceso al modelo restringido, pida a su administrador de organización que lo habilite. Consulte [Organization model restrictions](/es/model-config#organization-model-restrictions).1018* Si necesita acceso al modelo restringido, pida a su administrador de organización que lo habilite. Consulte [Organization model restrictions](/docs/es/model-config#organization-model-restrictions).
1019 1019
1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">
1021 thinking.type.enabled no es compatible con este modelo1021 thinking.type.enabled no es compatible con este modelo
1031 1031
1032* Ejecute `claude update` y reinicie Claude Code. Opus 4.7 necesita v2.1.111 o posterior. Opus 4.8 necesita v2.1.154 o posterior. Sonnet 5 necesita v2.1.197 o posterior1032* Ejecute `claude update` y reinicie Claude Code. Opus 4.7 necesita v2.1.111 o posterior. Opus 4.8 necesita v2.1.154 o posterior. Sonnet 5 necesita v2.1.197 o posterior
1033* Si no puede actualizar, ejecute `/model` y seleccione Opus 4.6 o Sonnet 4.6 en su lugar1033* Si no puede actualizar, ejecute `/model` y seleccione Opus 4.6 o Sonnet 4.6 en su lugar
1034* {/* min-version: agent-sdk@0.3.197 */}Si encuentra esto en el [Agent SDK](/es/agent-sdk/overview), actualice el paquete SDK en su lugar. Opus 4.8 necesita TypeScript SDK v0.3.154 o posterior y Python SDK v0.2.88 o posterior. Sonnet 5 necesita TypeScript SDK v0.3.197 o posterior1034* Si encuentra esto en el [Agent SDK](/docs/es/agent-sdk/overview), actualice el paquete SDK en su lugar. Opus 4.8 necesita TypeScript SDK v0.3.154 o posterior y Python SDK v0.2.88 o posterior. Sonnet 5 necesita TypeScript SDK v0.3.197 o posterior
1035 1035
1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">
1037 El presupuesto de pensamiento excede el límite de salida1037 El presupuesto de pensamiento excede el límite de salida
1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
1044```1044```
1045 1045
1046Claude Code ajusta estos valores automáticamente en la API de Anthropic. Normalmente ve este error en Amazon Bedrock o Google Cloud's Agent Platform cuando [`MAX_THINKING_TOKENS`](/es/env-vars) se establece más alto que el límite de salida del proveedor, o cuando el modo de plan aumenta el presupuesto de pensamiento.1046Claude Code ajusta estos valores automáticamente en la API de Anthropic. Normalmente ve este error en Amazon Bedrock o Google Cloud's Agent Platform cuando [`MAX_THINKING_TOKENS`](/docs/es/env-vars) se establece más alto que el límite de salida del proveedor, o cuando el modo de plan aumenta el presupuesto de pensamiento.
1047 1047
1048**Qué hacer:**1048**Qué hacer:**
1049 1049
1050* Baje `MAX_THINKING_TOKENS`, o aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/es/env-vars) por encima del presupuesto de pensamiento1050* Baje `MAX_THINKING_TOKENS`, o aumente [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/es/env-vars) por encima del presupuesto de pensamiento
1051* Consulte [Extended thinking](/es/model-config#extended-thinking) para ver cómo el presupuesto interactúa con la longitud de salida1051* Consulte [Extended thinking](/docs/es/model-config#extended-thinking) para ver cómo el presupuesto interactúa con la longitud de salida
1052 1052
1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">
1054 Desajuste de bloque de uso de herramienta o pensamiento1054 Desajuste de bloque de uso de herramienta o pensamiento
1066 1066
1067**Qué hacer:**1067**Qué hacer:**
1068 1068
1069* {/* max-version: 2.1.155 */}Si está utilizando Opus 4.7 u Opus 4.8, ejecute `claude update` primero. Las versiones anteriores a v2.1.156 pueden desencadenar este error durante el uso normal de herramientas, y `/rewind` no lo borra.1069* Si está utilizando Opus 4.7 u Opus 4.8, ejecute `claude update` primero. Las versiones anteriores a v2.1.156 pueden desencadenar este error durante el uso normal de herramientas, y `/rewind` no lo borra.
1070* Ejecute `/rewind`, o presione Esc dos veces, para retroceder a un punto de control antes del turno corrupto y continuar desde allí. Consulte [Checkpointing](/es/checkpointing) para ver cómo se crean y restauran los puntos de control.1070* Ejecute `/rewind`, o presione Esc dos veces, para retroceder a un punto de control antes del turno corrupto y continuar desde allí. Consulte [Checkpointing](/docs/es/checkpointing) para ver cómo se crean y restauran los puntos de control.
1071 1071
1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">
1073 Rechazo de Política de Uso1073 Rechazo de Política de Uso
1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.1079API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
1080```1080```
1081 1081
1082La verificación evalúa la conversación completa, no solo su prompt más reciente, por lo que enviar un nuevo mensaje en la misma sesión generalmente reactiva el mismo rechazo. Lo mismo se aplica después de salir y reabrir la sesión con `--continue` o `--resume`, ya que la transcripción en disco aún contiene el contenido que desencadena. En [Amazon Bedrock](/es/amazon-bedrock), [Google Cloud's Agent Platform](/es/google-vertex-ai) y [Microsoft Foundry](/es/microsoft-foundry), este mensaje también cubre solicitudes que las medidas de seguridad del modelo marcaron como un tema de ciberseguridad. Consulte [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).1082La verificación evalúa la conversación completa, no solo su prompt más reciente, por lo que enviar un nuevo mensaje en la misma sesión generalmente reactiva el mismo rechazo. Lo mismo se aplica después de salir y reabrir la sesión con `--continue` o `--resume`, ya que la transcripción en disco aún contiene el contenido que desencadena. En [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) y [Microsoft Foundry](/docs/es/microsoft-foundry), este mensaje también cubre solicitudes que las medidas de seguridad del modelo marcaron como un tema de ciberseguridad. Consulte [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
1083 1083
1084**Qué hacer:**1084**Qué hacer:**
1085 1085
1086* Presione Esc dos veces o ejecute `/rewind` para retroceder a un punto de control antes del turno que desencadenó el rechazo, luego reformule o tome un enfoque diferente. Consulte [Checkpointing](/es/checkpointing).1086* Presione Esc dos veces o ejecute `/rewind` para retroceder a un punto de control antes del turno que desencadenó el rechazo, luego reformule o tome un enfoque diferente. Consulte [Checkpointing](/docs/es/checkpointing).
1087* Si no puede identificar qué turno lo causó, ejecute `/clear` para iniciar una conversación nueva en el mismo proyecto. Su conversación anterior se conserva en disco y permanece disponible en `/resume`.1087* Si no puede identificar qué turno lo causó, ejecute `/clear` para iniciar una conversación nueva en el mismo proyecto. Su conversación anterior se conserva en disco y permanece disponible en `/resume`.
1088* En [modo no interactivo](/es/headless) (`-p`), donde rewind no está disponible, reintente con un prompt reformulado en una sesión nueva sin `--continue`. Las verificaciones de política varían según el modelo, por lo que cambiar a un modelo diferente con `--model` también puede resolver el rechazo en algunos casos.1088* En [modo no interactivo](/docs/es/headless) (`-p`), donde rewind no está disponible, reintente con un prompt reformulado en una sesión nueva sin `--continue`. Las verificaciones de política varían según el modelo, por lo que cambiar a un modelo diferente con `--model` también puede resolver el rechazo en algunos casos.
1089 1089
1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">
1091 Las medidas de seguridad marcaron un tema de ciberseguridad1091 Las medidas de seguridad marcaron un tema de ciberseguridad
1103 1103
1104Lo que ve depende de su proveedor y modo:1104Lo que ve depende de su proveedor y modo:
1105 1105
1106* En [Amazon Bedrock](/es/amazon-bedrock), [Google Cloud's Agent Platform](/es/google-vertex-ai) y [Microsoft Foundry](/es/microsoft-foundry), una marca de ciberseguridad produce el mensaje de [rechazo de Política de Uso](#usage-policy-refusal) en su lugar.1106* En [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) y [Microsoft Foundry](/docs/es/microsoft-foundry), una marca de ciberseguridad produce el mensaje de [rechazo de Política de Uso](#usage-policy-refusal) en su lugar.
1107* [Modo no interactivo](/es/headless) omite la oración `/feedback`.1107* [Modo no interactivo](/docs/es/headless) omite la oración `/feedback`.
1108 1108
1109{/* max-version: 2.1.202 */}Antes de v2.1.203, el mensaje decía `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguido de un enlace de formulario de exención.1109Antes de v2.1.203, el mensaje decía `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` seguido de un enlace de formulario de exención.
1110 1110
1111**Qué hacer:**1111**Qué hacer:**
1112 1112
1113* Si su trabajo requiere este contenido, solicite acceso a través del [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Si su trabajo requiere este contenido, solicite acceso a través del [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
1114* Si su solicitud no era sobre un tema de ciberseguridad, ejecute `/feedback` para reportar el falso positivo1114* Si su solicitud no era sobre un tema de ciberseguridad, ejecute `/feedback` para reportar el falso positivo
1115* Para continuar trabajando en la misma sesión, presione Esc dos veces o ejecute `/rewind` para retroceder a un punto de control antes del turno que desencadenó la marca, luego tome un enfoque diferente. Consulte [Checkpointing](/es/checkpointing).1115* Para continuar trabajando en la misma sesión, presione Esc dos veces o ejecute `/rewind` para retroceder a un punto de control antes del turno que desencadenó la marca, luego tome un enfoque diferente. Consulte [Checkpointing](/docs/es/checkpointing).
1116 1116
1117<h2 id="installation-errors">1117<h2 id="installation-errors">
1118 Errores de instalación1118 Errores de instalación
1119</h2>1119</h2>
1120 1120
1121Estos errores aparecen durante la instalación o actualización de Claude Code, desde el [script de instalación](/es/setup#install-claude-code), `claude install`, o `claude update`. Para problemas de `command not found`, PATH, permisos y TLS durante la configuración, consulte [Solucionar problemas de instalación e inicio de sesión](/es/troubleshoot-install).1121Estos errores aparecen durante la instalación o actualización de Claude Code, desde el [script de instalación](/docs/es/setup#install-claude-code), `claude install`, o `claude update`. Para problemas de `command not found`, PATH, permisos y TLS durante la configuración, consulte [Solucionar problemas de instalación e inicio de sesión](/docs/es/troubleshoot-install).
1122 1122
1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">
1124 La instalación fue interrumpida antes de poder finalizar1124 La instalación fue interrumpida antes de poder finalizar
1136**Qué hacer:**1136**Qué hacer:**
1137 1137
1138* Detenga otros procesos para liberar memoria, luego vuelva a ejecutar el instalador1138* Detenga otros procesos para liberar memoria, luego vuelva a ejecutar el instalador
1139* Agregue espacio de intercambio o muévase a una instancia más grande. Consulte [Instalación interrumpida en servidores Linux con poca memoria](/es/troubleshoot-install#install-killed-on-low-memory-linux-servers) para los comandos del archivo de intercambio.1139* Agregue espacio de intercambio o muévase a una instancia más grande. Consulte [Instalación interrumpida en servidores Linux con poca memoria](/docs/es/troubleshoot-install#install-killed-on-low-memory-linux-servers) para los comandos del archivo de intercambio.
1140 1140
1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">
1142 La conexión se interrumpió mientras se descargaba la actualización1142 La conexión se interrumpió mientras se descargaba la actualización
1143</h3>1143</h3>
1144 1144
1145La conexión al servidor de descarga se cerró mientras `claude install`, `claude update`, o el [actualizador automático](/es/setup#auto-updates) estaba obteniendo el binario de Claude Code, y los reintentos no se recuperaron. Claude Code reintenta la descarga cuando la conexión se interrumpe, la transferencia se detiene o el archivo descargado falla su suma de verificación, hasta tres intentos en total. Un error HTTP completado, como un 404, no se reintenta porque el servidor ya respondió. {/* min-version: 2.1.202 */}Antes de v2.1.202, una única conexión interrumpida fallaba la descarga inmediatamente con el error simple `aborted` en lugar de reintentar.1145La conexión al servidor de descarga se cerró mientras `claude install`, `claude update`, o el [actualizador automático](/docs/es/setup#auto-updates) estaba obteniendo el binario de Claude Code, y los reintentos no se recuperaron. Claude Code reintenta la descarga cuando la conexión se interrumpe, la transferencia se detiene o el archivo descargado falla su suma de verificación, hasta tres intentos en total. Un error HTTP completado, como un 404, no se reintenta porque el servidor ya respondió. Antes de v2.1.202, una única conexión interrumpida fallaba la descarga inmediatamente con el error simple `aborted` en lugar de reintentar.
1146 1146
1147```text theme={null}1147```text theme={null}
1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
1157**Qué hacer:**1157**Qué hacer:**
1158 1158
1159* Ejecute `claude update` nuevamente. En una red de otro modo saludable, la descarga generalmente tiene éxito en la siguiente ejecución. Para el mensaje agotado, ejecútelo nuevamente desde una red más rápida o menos limitada.1159* Ejecute `claude update` nuevamente. En una red de otro modo saludable, la descarga generalmente tiene éxito en la siguiente ejecución. Para el mensaje agotado, ejecútelo nuevamente desde una red más rápida o menos limitada.
1160* Si su red requiere un proxy, establezca `HTTPS_PROXY` antes de ejecutar el instalador o `claude update`. Consulte [Verificar conectividad de red](/es/troubleshoot-install#check-network-connectivity).1160* Si su red requiere un proxy, establezca `HTTPS_PROXY` antes de ejecutar el instalador o `claude update`. Consulte [Verificar conectividad de red](/docs/es/troubleshoot-install#check-network-connectivity).
1161* Si un proxy corporativo sigue cerrando la transferencia, pida a su equipo de red que permita la descarga completa desde `downloads.claude.ai`. Consulte [Requisitos de acceso a la red](/es/network-config#network-access-requirements).1161* Si un proxy corporativo sigue cerrando la transferencia, pida a su equipo de red que permita la descarga completa desde `downloads.claude.ai`. Consulte [Requisitos de acceso a la red](/docs/es/network-config#network-access-requirements).
1162* Ejecute `claude doctor` desde su shell para diagnósticos de instalación1162* Ejecute `claude doctor` desde su shell para diagnósticos de instalación
1163 1163
1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">
1171 Conflicto entre --bg y --print1171 Conflicto entre --bg y --print
1172</h3>1172</h3>
1173 1173
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.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](/docs/es/agent-view#from-your-shell) a la que se conecta posteriormente con `claude agents`, mientras que `--print` se ejecuta [de forma no interactiva](/docs/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.
1175 1175
1176```text theme={null}1176```text theme={null}
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>'`.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>'`.
1179 1179
1180**Qué hacer:**1180**Qué hacer:**
1181 1181
1182* Elimine `-p` o `--print`. `--bg` toma el prompt como su argumento posicional, por lo que `claude --bg "<task>"` es el comando completo. Consulte [Dispatch new agents from your shell](/es/agent-view#from-your-shell).1182* Elimine `-p` o `--print`. `--bg` toma el prompt como su argumento posicional, por lo que `claude --bg "<task>"` es el comando completo. Consulte [Dispatch new agents from your shell](/docs/es/agent-view#from-your-shell).
1183* Para ejecutar el prompt de forma no interactiva e imprimir el resultado en lugar de crear una sesión en segundo plano, elimine `--bg` y ejecute `claude -p "<task>"`1183* Para ejecutar el prompt de forma no interactiva e imprimir el resultado en lugar de crear una sesión en segundo plano, elimine `--bg` y ejecute `claude -p "<task>"`
1184 1184
1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1186 El valor de --json-schema no es un JSON Schema válido1186 El valor de --json-schema no es un JSON Schema válido
1187</h3>1187</h3>
1188 1188
1189El esquema que pasó a [`--json-schema`](/es/cli-reference#cli-flags) en [modo no interactivo](/es/headless#get-structured-output) falló en la compilación del JSON Schema, por lo que `claude` sale con código 1 en lugar de ejecutar el prompt. Antes de v2.1.205, un esquema inválido producía salida no estructurada sin error, y cualquier esquema que usara la palabra clave `format` se trataba como inválido.1189El esquema que pasó a [`--json-schema`](/docs/es/cli-reference#cli-flags) en [modo no interactivo](/docs/es/headless#get-structured-output) falló en la compilación del JSON Schema, por lo que `claude` sale con código 1 en lugar de ejecutar el prompt. Antes de v2.1.205, un esquema inválido producía salida no estructurada sin error, y cualquier esquema que usara la palabra clave `format` se trataba como inválido.
1190 1190
1191```text theme={null}1191```text theme={null}
1192Error: --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
1200 1200
1201* Corrija la parte del esquema que nombra el diagnóstico y luego vuelva a ejecutar el comando1201* Corrija la parte del esquema que nombra el diagnóstico y luego vuelva a ejecutar el comando
1202* 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`
1203* Consulte [Get structured output](/es/headless#get-structured-output) para un esquema y comando que funcionen1203* Consulte [Get structured output](/docs/es/headless#get-structured-output) para un esquema y comando que funcionen
1204 1204
1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1206 No se pudo importar un servidor desde Claude Desktop1206 No se pudo importar un servidor desde Claude Desktop
1212Could 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.
1213```1213```
1214 1214
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.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](/docs/es/managed-mcp) de su organización.
1216 1216
1217**Qué hacer:**1217**Qué hacer:**
1218 1218
1219* 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` 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
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).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](/docs/es/mcp#import-mcp-servers-from-claude-desktop).
1221 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Herramienta de solicitud de permiso MCP no encontrada1223 Herramienta de solicitud de permiso MCP no encontrada
1224</h3>1224</h3>
1225 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.1226La herramienta que pasó a [`--permission-prompt-tool`](/docs/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](/docs/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`](/docs/es/env-vars) para que ese servidor se conecte. 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 1227
1228```text theme={null}1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1235 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 conectado1236* 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 servidor1237* 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)1238* Si el servidor necesita más de 30 segundos para iniciarse, aumente [`MCP_TIMEOUT`](/docs/es/env-vars)
1239 1239
1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1241 Errores de plugins1241 Errores de plugins
1242</h2>1242</h2>
1243 1243
1244Estos errores provienen de la configuración de [plugins](/es/plugins) y [marketplace](/es/plugin-marketplaces). Para problemas de plugins que no produzcan uno de los mensajes en esta página, como una URL de marketplace que no carga o un plugin que se instala pero no aparece, consulte [Solución de problemas de plugins](/es/discover-plugins#troubleshooting).1244Estos errores provienen de la configuración de [plugins](/docs/es/plugins) y [marketplace](/docs/es/plugin-marketplaces). Para problemas de plugins que no produzcan uno de los mensajes en esta página, como una URL de marketplace que no carga o un plugin que se instala pero no aparece, consulte [Solución de problemas de plugins](/docs/es/discover-plugins#troubleshooting).
1245 1245
1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1247 Marketplace registrado desde una fuente no confiable1247 Marketplace registrado desde una fuente no confiable
1248</h3>1248</h3>
1249 1249
1250El marketplace está registrado bajo un nombre que está [reservado para marketplaces oficiales de Anthropic](/es/plugin-marketplaces#marketplace-schema), pero su fuente registrada no es un repositorio de GitHub de `anthropics`. Claude Code vuelve a verificar los nombres reservados cada vez que carga o actualiza un marketplace, por lo que el marketplace y los plugins instalados desde él dejan de cargarse. Antes de v2.1.205, el nombre se verificaba solo cuando se agregaba el marketplace, por lo que una entrada registrada antes de que su nombre se reservara seguía cargándose.1250El marketplace está registrado bajo un nombre que está [reservado para marketplaces oficiales de Anthropic](/docs/es/plugin-marketplaces#marketplace-schema), pero su fuente registrada no es un repositorio de GitHub de `anthropics`. Claude Code vuelve a verificar los nombres reservados cada vez que carga o actualiza un marketplace, por lo que el marketplace y los plugins instalados desde él dejan de cargarse. Antes de v2.1.205, el nombre se verificaba solo cuando se agregaba el marketplace, por lo que una entrada registrada antes de que su nombre se reservara seguía cargándose.
1251 1251
1252```text theme={null}1252```text theme={null}
1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
1257 1257
1258* Ejecute `claude plugin marketplace remove <name>`, luego agregue el marketplace nuevamente desde el repositorio oficial `github.com/anthropics`1258* Ejecute `claude plugin marketplace remove <name>`, luego agregue el marketplace nuevamente desde el repositorio oficial `github.com/anthropics`
1259* 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
1260* Consulte la lista de nombres reservados en [Marketplace schema](/es/plugin-marketplaces#marketplace-schema)1260* Consulte la lista de nombres reservados en [Marketplace schema](/docs/es/plugin-marketplaces#marketplace-schema)
1261 1261
1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">
1263 Plugin command references user\_config in a shell command1263 Plugin command references user\_config in a shell command
1264</h3>1264</h3>
1265 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.1266Un hook de plugin, [monitor](/docs/es/plugins-reference#monitors), o comando MCP [`headersHelper`](/docs/es/mcp#use-dynamic-headers-for-custom-authentication) hace referencia a una [opción de plugin](/docs/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 1267
1268La redacción depende de qué superficie hizo referencia a la opción. Un hook de forma de shell informa:1268La redacción depende de qué superficie hizo referencia a la opción. Un hook de forma de shell informa:
1269 1269
1285 1285
1286**Qué hacer:**1286**Qué hacer:**
1287 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 script1288* Para un hook, agregue una matriz `args` para que se ejecute en [forma exec](/docs/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ón1289* 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 helper1290* 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 1291
1299 El agente se generaría con cero herramientas1299 El agente se generaría con cero herramientas
1300</h3>1300</h3>
1301 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.1302Nada en la [lista de `tools` de un subagente](/docs/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 1303
1304```text theme={null}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.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.
1307 1307
1308**Qué hacer:**1308**Qué hacer:**
1309 1309
1310* Corrija cada entrada que el error nombra contra las [herramientas disponibles para subagentes](/es/sub-agents#available-tools)1310* Corrija cada entrada que el error nombra contra las [herramientas disponibles para subagentes](/docs/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á conectado1311* 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 herramientas1312* Para dar al subagente todas las herramientas que tiene el padre, elimine el campo `tools` en lugar de listar herramientas
1313 1313
1315 El archivo está cubierto por una regla de denegación de Read1315 El archivo está cubierto por una regla de denegación de Read
1316</h3>1316</h3>
1317 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.1318La herramienta Edit fue llamada en una ruta coincidente con una [regla de denegación de `Read`](/docs/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 1319
1320```text theme={null}1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1323 1323
1324**Qué hacer:**1324**Qué hacer:**
1325 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)1326* Si Claude debe poder editar el archivo, elimine o reduzca la regla de denegación de `Read` en `/permissions` o en [configuración](/docs/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 bloqueen1327* 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 1328
1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">
1330 Errores de sesión en segundo plano1330 Errores de sesión en segundo plano
1331</h2>1331</h2>
1332 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.1333[Las sesiones en segundo plano](/docs/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 1334
1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">
1336 Comandos rechazados en una sesión en segundo plano1336 Comandos rechazados en una sesión en segundo plano
1337</h3>1337</h3>
1338 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.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.1340En 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 1341
1342La redacción nombra el comando que fue rechazado. La lista de configuración `/mcp` reporta:1342La redacción nombra el comando que fue rechazado. La lista de configuración `/mcp` reporta:
1343 1343
1354 Errores del lanzador CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Errores del lanzador CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>1355</h3>
1356 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:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/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 1358
1359```text theme={null}1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1364 1364
1365**Qué hacer:**1365**Qué hacer:**
1366 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 completo1367* Establezca la variable en la ruta absoluta de un ejecutable que termine llamando a `exec "$@"`. Consulte [el contrato del lanzador](/docs/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 shell1368* 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 envuelto1369* Después de corregir el valor en el bloque `env` de [configuración](/docs/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 1370
1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1372 Advertencias de configuración1372 Advertencias de configuración
1378 El espacio de trabajo no ha sido confiable1378 El espacio de trabajo no ha sido confiable
1379</h3>1379</h3>
1380 1380
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.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](/docs/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.
1382 1382
1383```text theme={null}1383```text theme={null}
1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.1384Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
1386 1386
1387**Qué hacer:**1387**Qué hacer:**
1388 1388
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í.1389* Ejecute `claude` en el directorio y acepte el diálogo de confianza. 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í.
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.1390* En [modo no interactivo](/docs/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.
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).1391* 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. 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](/docs/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](/docs/es/permissions#project-allow-rules-and-workspace-trust).
1392 1392
1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1394 Las respuestas parecen de menor calidad que lo habitual1394 Las respuestas parecen de menor calidad que lo habitual
1396 1396
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: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:
1398 1398
1399* 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`](/docs/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
1400* Una verificación de inicio de Amazon Bedrock o de la plataforma de agentes de Google Cloud encuentra que su modelo predeterminado no está 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
1401* 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ón1401* El [respaldo automático de modelo](/docs/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
1402 1402
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.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](/docs/es/model-config) explica cuándo se aplica cada respaldo.
1404 1404
1405Verifique estos primero:1405Verifique estos primero:
1406 1406
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.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.
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`.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](/docs/es/model-config#adjust-effort-level) para los valores predeterminados por modelo y el atajo `ultrathink`.
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.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](/docs/es/context-window) para ver cómo auto-compact afecta los turnos anteriores.
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.1410* **Instrucciones obsoletas**: los archivos `CLAUDE.md` grandes u obsoletos y las definiciones de herramientas MCP consumen contexto y pueden dirigir las respuestas. 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.
1411 1411
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).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](/docs/es/checkpointing).
1413 1413
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.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.
1415 1415
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.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. Antes de v2.1.201, Sonnet 5 rechazaba algunas solicitudes de la misma manera.
1417 1417
1418<h2 id="report-an-error">1418<h2 id="report-an-error">
1419 Reportar un error1419 Reportar un error
1421 1421
1422Para errores de componentes que esta página no cubre, consulte la guía relevante:1422Para errores de componentes que esta página no cubre, consulte la guía relevante:
1423 1423
1424* El servidor MCP no se pudo conectar o autenticar: [MCP](/es/mcp)1424* El servidor MCP no se pudo conectar o autenticar: [MCP](/docs/es/mcp)
1425* El script de hook falló o bloqueó una herramienta: [Depurar hooks](/es/hooks#debug-hooks)1425* El script de hook falló o bloqueó una herramienta: [Depurar hooks](/docs/es/hooks#debug-hooks)
1426* Permiso denegado o errores del sistema de archivos durante la instalación: [Solucionar problemas de instalación e inicio de sesión](/es/troubleshoot-install)1426* Permiso denegado o errores del sistema de archivos durante la instalación: [Solucionar problemas de instalación e inicio de sesión](/docs/es/troubleshoot-install)
1427 1427
1428Si 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:
1429 1429
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.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](/docs/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.
1431* 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ó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
1432* Consulte [status.claude.com](https://status.claude.com) para incidentes activos1432* Consulte [status.claude.com](https://status.claude.com) para incidentes activos
1433* Busque [problemas existentes](https://github.com/anthropics/claude-code/issues) en GitHub1433* Busque [problemas existentes](https://github.com/anthropics/claude-code/issues) en GitHub
