Documentation 2026-11-12 23:02 UTC to 2026-11-13 23:02 UTC

117 --network none \117 --network none \

118 --memory 2g \118 --memory 2g \

119 --cpus 2 \119 --cpus 2 \

120 --pids-limit 100 \120 --pids-limit 600 \

121 --user 1000:1000 \121 --user 1000:1000 \

122 -v /path/to/code:/workspace:ro \122 -v /path/to/code:/workspace:ro \

123 -v /var/run/proxy.sock:/var/run/proxy.sock:ro \123 -v /var/run/proxy.sock:/var/run/proxy.sock:ro \

135| `--tmpfs /tmp:...` | Proporciona un directorio temporal escribible que se borra cuando el contenedor se detiene |135| `--tmpfs /tmp:...` | Proporciona un directorio temporal escribible que se borra cuando el contenedor se detiene |

136| `--network none` | Aísla el contenedor de las redes externas |136| `--network none` | Aísla el contenedor de las redes externas |

137| `--memory 2g` | Limita el uso de memoria para prevenir agotamiento de recursos |137| `--memory 2g` | Limita el uso de memoria para prevenir agotamiento de recursos |

138| `--pids-limit 100` | Limita el recuento de procesos para prevenir fork bombs |138| `--pids-limit 600` | Limita los procesos y subprocesos para prevenir fork bombs |

139| `--user 1000:1000` | Se ejecuta como un usuario no root |139| `--user 1000:1000` | Se ejecuta como un usuario no root |

140| `-v ...:/workspace:ro` | Monta código solo lectura para que el agente pueda analizarlo pero no modificarlo. **Evite montar directorios de host sensibles como `~/.ssh`, `~/.aws`, o `~/.config`** |140| `-v ...:/workspace:ro` | Monta código solo lectura para que el agente pueda analizarlo pero no modificarlo. **Evite montar directorios de host sensibles como `~/.ssh`, `~/.aws`, o `~/.config`** |

141| `-v .../proxy.sock:...` | Monta un socket Unix conectado a un proxy ejecutándose fuera del contenedor (ver a continuación) |141| `-v .../proxy.sock:...` | Monta un socket Unix conectado a un proxy ejecutándose fuera del contenedor (ver a continuación) |

104| `options` | [`Options`](#options) | Objeto de configuración opcional. Igual que el parámetro `options` para `query()` |104| `options` | [`Options`](#options) | Objeto de configuración opcional. Igual que el parámetro `options` para `query()` |

105| `initializeTimeoutMs` | `number` | Tiempo máximo en milisegundos para esperar la inicialización del subproceso. Por defecto es `60000`. Si la inicialización no se completa a tiempo, la promesa se rechaza con un error de tiempo de espera |105| `initializeTimeoutMs` | `number` | Tiempo máximo en milisegundos para esperar la inicialización del subproceso. Por defecto es `60000`. Si la inicialización no se completa a tiempo, la promesa se rechaza con un error de tiempo de espera |

106 106 

107Los [hooks de comando](https://code.claude.com/docs/es/hooks.md#command-hook-fields) [SessionStart](https://code.claude.com/docs/es/hooks.md#sessionstart) y [Setup](https://code.claude.com/docs/es/hooks.md#setup) lentos obtienen tiempo adicional solo cuando `initializeTimeoutMs` no está establecido:

108 

109* **Si lo dejas sin establecer:** el tiempo que estos hooks pasan ejecutándose no cuenta para el valor predeterminado de 60 segundos, hasta 10 minutos en total, por lo que la inicialización puede tardar 11 minutos como máximo.

110* **Si estableces un valor, incluido `60000`:** ese valor es el límite, incluso mientras se ejecuta un hook.

111 

112El tiempo adicional requiere TypeScript Agent SDK v0.3.304 o posterior.

113 

107#### Devuelve114#### Devuelve

108 115 

109Devuelve una `Promise<`[`WarmQuery`](#warmquery)`>` que se resuelve una vez que el subproceso se ha generado y ha completado su protocolo de inicialización.116Devuelve una `Promise<`[`WarmQuery`](#warmquery)`>` que se resuelve una vez que el subproceso se ha generado y ha completado su protocolo de inicialización.

128 135 

129### `prewarm()`136### `prewarm()`

130 137 

131*Alfa.* Inicia un proceso de Claude Code como repuesto antes de saber qué sesión servirá, para que puedas vincularlo a una sesión más tarde con [`claim()`](#spareprocess). Úsalo en una aplicación que se inicia antes de que el usuario elija una carpeta. Requiere TypeScript Agent SDK v0.3.282 o posterior.138*Alfa.* Inicia un proceso de Claude Code como repuesto antes de saber qué sesión servirá, para que puedas vincularlo a una sesión más tarde con [`claim()`](#spareprocess). Requiere TypeScript Agent SDK v0.3.282 o posterior.

132 139 

133`prewarm()` completa el mismo protocolo de inicialización que [`startup()`](#startup), con el proceso esperando en `options.cwd` cuando lo estableces y, de lo contrario, en un directorio temporal privado dentro de tu directorio de configuración de Claude Code. El directorio de trabajo de la sesión, sus hooks `SessionStart`, sus servidores MCP de stdio, y su contexto de CLAUDE.md y git esperan a la reclamación. Un repuesto ocupa aproximadamente de 230 a 260 MB de memoria mientras espera. Si tu [`spawnClaudeCodeProcess`](#options) ejecuta Claude Code en otra máquina o en un contenedor, establece `options.cwd` en un directorio que exista allí para que el repuesto espere en él.140Usa `prewarm()` cuando tu aplicación se inicia antes de que el usuario elija una carpeta.

134 141 

135```typescript theme={null}142```typescript theme={null}

136function prewarm(params?: {143function prewarm(params?: {

139}): Promise<SpareProcess>;146}): Promise<SpareProcess>;

140```147```

141 148 

142`options` e `initializeTimeoutMs` significan lo mismo que para `startup()`, excepto que `options.cwd` establece solo el directorio en el que el repuesto espera. La promesa se resuelve con un [`SpareProcess`](#spareprocess) una vez que el proceso ha completado su protocolo de inicialización. `prewarm()` lanza una excepción si `options` establece `resume`, `continue` o `forkSession`, porque un repuesto aún no tiene sesión. Todo lo que una reclamación no puede establecer, como `mcpServers`, `hooks`, `canUseTool`, `settingSources`, `systemPrompt` y `plugins`, queda fijo durante la vida útil del repuesto, así que mantén un repuesto por cada conjunto distinto de esas opciones y precalienta de nuevo cuando cambien.149#### Parámetros

150 

151| Parámetro | Tipo | Descripción |

152| :- | :- | :- |

153| `options` | [`Options`](#options) | Objeto de configuración opcional, del mismo tipo que acepta `startup()` |

154| `initializeTimeoutMs` | `number` | Tiempo máximo en milisegundos para esperar la inicialización del repuesto. Por defecto es `60000`. Si la inicialización no se completa a tiempo, la promesa se rechaza con un error de tiempo de espera |

155 

156`prewarm()` cuenta el tiempo empleado en los hooks [Setup](https://code.claude.com/docs/es/hooks.md#setup) para `initializeTimeoutMs`, incluso cuando lo dejas sin establecer. Para dar más tiempo a los hooks Setup lentos, establece un valor más largo.

157 

158#### Devuelve

159 

160Devuelve una `Promise<`[`SpareProcess`](#spareprocess)`>` que se resuelve una vez que el repuesto está listo para reclamarse.

161 

162La promesa se rechaza si pides `resume`, `continue` o `forkSession` en `options`, porque un repuesto aún no tiene sesión.

163 

164#### Cómo funciona un repuesto

165 

166* **Dónde espera un repuesto:** en un directorio temporal privado dentro de tu directorio de configuración de Claude Code, o en `options.cwd` si lo estableces en `prewarm()`.

167* **Si tu [`spawnClaudeCodeProcess`](#options) ejecuta Claude Code en otra máquina o en un contenedor:** pasa a `prewarm()` un `options.cwd` que exista allí, porque el directorio temporal predeterminado se crea en tu máquina.

168* **Memoria:** cada repuesto usa aproximadamente de 230 a 260 MB mientras espera.

169* **Lo que no ocurre hasta que llamas a `claim()`:**

170 * Moverse al directorio de trabajo que pasas a `claim()`

171 * Ejecutar los hooks SessionStart

172 * Iniciar los servidores MCP de stdio

173 * Cargar CLAUDE.md y el contexto de git

174* **Lo que una reclamación no puede cambiar:** opciones como `mcpServers`, `hooks`, `canUseTool`, `settingSources` y `plugins` conservan sus valores de `prewarm()`. [`SpareProcess`](#spareprocess) enumera lo que una reclamación puede establecer.

175* **Si las sesiones necesitan valores distintos para estas opciones:** mantén un repuesto separado para cada conjunto de valores.

143 176 

144#### Ejemplo177#### Ejemplo

145 178 

8 8 

9La vista de agentes, abierta con `claude agents`, es una pantalla para todas sus sesiones en segundo plano: qué se está ejecutando, qué necesita su entrada y qué está hecho. Distribuya nuevas sesiones, observe su estado de un vistazo en lugar de desplazarse por transcripciones, e intervenga solo cuando una lo necesite. Cada sesión en segundo plano es una conversación completa de Claude Code que sigue ejecutándose sin una terminal conectada, por lo que puede abrirla, responder y marcharse cuando quiera.9La vista de agentes, abierta con `claude agents`, es una pantalla para todas sus sesiones en segundo plano: qué se está ejecutando, qué necesita su entrada y qué está hecho. Distribuya nuevas sesiones, observe su estado de un vistazo en lugar de desplazarse por transcripciones, e intervenga solo cuando una lo necesite. Cada sesión en segundo plano es una conversación completa de Claude Code que sigue ejecutándose sin una terminal conectada, por lo que puede abrirla, responder y marcharse cuando quiera.

10 10 

11![Vista de agentes en una terminal. Una línea en la parte superior cuenta las sesiones que esperan entrada, las que están trabajando y las completadas. Cuatro sesiones se agrupan bajo Necesita entrada, Trabajando y Completado. Cada fila muestra el nombre de la sesión, su estado más reciente o pregunta, y una hora. En la parte inferior hay una entrada para describir una nueva tarea y una fila de sugerencias de teclado.](https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max\&auto=format\&n=HDAmBwgbrZVk0pOt\&q=85\&s=d6905012bee31f3e6b3920b09c05dd02)11![Vista de agentes en una terminal. Una línea en la parte superior cuenta las sesiones que esperan entrada, las que están trabajando y las completadas. Cuatro sesiones se agrupan bajo Necesita entrada, Trabajando y Completado. Cada fila muestra el nombre de la sesión, su estado más reciente o pregunta, y una hora. En la parte inferior hay una entrada para describir una nueva tarea y una fila de sugerencias de teclado.](https://mintcdn.com/claude-code/v_J840yKc6uuKDX_/images/agent-view-light.png?fit=max\&auto=format\&n=v_J840yKc6uuKDX_\&q=85\&s=bd95fda83ea66ca8b2e0e7b68f8cb29e)

12 12 

13Utilice la vista de agentes cuando tenga varias tareas independientes en las que Claude pueda trabajar sin que usted observe cada paso. Distribuya una corrección de errores, una revisión de solicitud de extracción y una investigación de prueba inestable como tres filas, continúe trabajando en otra ventana y verifique cuando una fila muestre que la necesita o tenga un resultado.13Utilice la vista de agentes cuando tenga varias tareas independientes en las que Claude pueda trabajar sin que usted observe cada paso. Distribuya una corrección de errores, una revisión de solicitud de extracción y una investigación de prueba inestable como tres filas, continúe trabajando en otra ventana y verifique cuando una fila muestre que la necesita o tenga un resultado.

14 14 

628 628 

629* La vista de agentes lo elimina, incluidos los cambios sin commit, así que primero haz commit de lo que quieras conservar.629* La vista de agentes lo elimina, incluidos los cambios sin commit, así que primero haz commit de lo que quieras conservar.

630* `claude rm` lo conserva, junto con la fila de la sesión, cuando tiene cambios sin commit.630* `claude rm` lo conserva, junto con la fila de la sesión, cuando tiene cambios sin commit.

631* Ni la vista de agentes ni `claude rm` eliminan un worktree que otra sesión en ejecución está usando o ha bloqueado, y volver a eliminar no cambia eso. Claude Code conserva el worktree y la sesión, e indica el directorio conservado y el motivo; en la vista de agentes, la fila de la sesión muestra `not deleted`. Cierra la otra sesión y luego vuelve a eliminar.631* Ni la vista de agentes ni `claude rm` eliminan un worktree que otra sesión en ejecución está usando o ha bloqueado, y volver a eliminar no cambia eso. Claude Code conserva el worktree y la sesión, e indica el directorio conservado y el motivo; en la vista de agentes, la fila de la sesión muestra `not removed`. Cierra la otra sesión y luego vuelve a eliminar.

632* Cuando eliminas una sesión cuyo worktree tiene commits que Claude Code no puede confirmar que estén guardados en otro lugar, Claude Code conserva el worktree y la sesión, y el mensaje indica la rama del worktree y cuántos commits no tienen push. El mensaje también ofrece las dos formas de continuar: hacer push de los commits, o volver a eliminar para descartarlos.632* Cuando eliminas una sesión cuyo worktree tiene commits que Claude Code no puede confirmar que estén guardados en otro lugar, Claude Code conserva el worktree y la sesión, y el mensaje indica la rama del worktree y cuántos commits no tienen push. El mensaje también ofrece las dos formas de continuar: hacer push de los commits, o volver a eliminar para descartarlos.

633 633 

634 Los commits que están en un remoto no bloquean la eliminación. Tampoco los commits en la copia local de la rama predeterminada de tu remoto `origin`, siempre que esa rama esté extraída en tu checkout principal, es decir, el propio directorio del repositorio y no un worktree.634 Los commits que están en un remoto no bloquean la eliminación. Tampoco los commits en la copia local de la rama predeterminada de tu remoto `origin`, siempre que esa rama esté extraída en tu checkout principal, es decir, el propio directorio del repositorio y no un worktree.

935Apagar o reiniciar tu máquina detiene las sesiones en segundo plano en ejecución. Una sesión que estaba esperando tu entrada permanece bajo `Needs input` cuando regresas. Para cualquier otra sesión en ejecución, lo que muestra la vista de agentes depende de cuánto tiempo hace que avanzó por última vez:935Apagar o reiniciar tu máquina detiene las sesiones en segundo plano en ejecución. Una sesión que estaba esperando tu entrada permanece bajo `Needs input` cuando regresas. Para cualquier otra sesión en ejecución, lo que muestra la vista de agentes depende de cuánto tiempo hace que avanzó por última vez:

936 936 

937* Dentro de las 48 horas, la sesión se muestra como fallida. Conéctate o responde a ella y se reiniciará desde su conversación guardada. Para retomar el trabajo interrumpido, envíale una respuesta pidiéndole que continúe.937* Dentro de las 48 horas, la sesión se muestra como fallida. Conéctate o responde a ella y se reiniciará desde su conversación guardada. Para retomar el trabajo interrumpido, envíale una respuesta pidiéndole que continúe.

938* Pasadas 48 horas, como después de que la máquina estuvo apagada durante días, la sesión se muestra como detenida con `ended while the background service was off`. Presiona `Enter` en la fila y el pie de página muestra `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` Presiona `Enter` en la misma fila nuevamente para reanudar su conversación guardada. Una respuesta, o `claude attach <id>`, la reanuda sin esa solicitud del pie de página.938* Pasadas 48 horas, como después de que la máquina estuvo apagada durante días, la sesión se muestra como detenida con `ended while the background service was off`.

939 

940 Presiona `Enter` en la fila y el pie de página muestra `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to remove it.` Presiona `Enter` en la misma fila nuevamente para reanudar su conversación guardada. Una respuesta, o `claude attach <id>`, la reanuda sin esa solicitud del pie de página.

939 941 

940Cuando la [limpieza de transcripciones](https://code.claude.com/docs/es/settings-reference.md#cleanupperioddays) ha eliminado la conversación guardada de una sesión detenida, Claude Code se niega a abrir la fila: el mensaje dice que no hay nada que reanudar. `claude rm <id>` elimina la fila, excepto en los [casos en que se conserva](#what-deleting-a-session-removes) descritos anteriormente, y `claude respawn <id>` ejecuta su prompt original nuevamente. Consulta [La conversación guardada de esta sesión ya no está en el disco](https://code.claude.com/docs/es/errors.md#this-sessions-saved-conversation-is-no-longer-on-disk).942Cuando la [limpieza de transcripciones](https://code.claude.com/docs/es/settings-reference.md#cleanupperioddays) ha eliminado la conversación guardada de una sesión detenida, Claude Code se niega a abrir la fila: el mensaje dice que no hay nada que reanudar. `claude rm <id>` elimina la fila, excepto en los [casos en que se conserva](#what-deleting-a-session-removes) descritos anteriormente, y `claude respawn <id>` ejecuta su prompt original nuevamente. Consulta [La conversación guardada de esta sesión ya no está en el disco](https://code.claude.com/docs/es/errors.md#this-sessions-saved-conversation-is-no-longer-on-disk).

941 943 

349 349 

350### Cuando un modelo se deshabilita durante la sesión350### Cuando un modelo se deshabilita durante la sesión

351 351 

352Si tu cuenta pierde acceso al modelo con el que se ejecuta tu sesión, por ejemplo porque un administrador lo deshabilita en tu cuenta de Amazon Bedrock, Claude Code cambia la sesión a otro modelo en lugar de fallar en cada solicitud, y muestra `Switched to <fallback> because <model> is not available`. Intenta los mismos modelos que el respaldo de inicio: primero versiones anteriores del mismo nivel y, para una sesión de Opus sin ninguna versión de Opus disponible, el modelo Sonnet predeterminado.352Cuando Amazon Bedrock rechaza el modelo de tu sesión por no estar disponible para tu cuenta, Claude Code cambia tu sesión a otro modelo y puedes seguir trabajando. Verás un mensaje que comienza con `Switched to <fallback> because <model> is not available`. Esto ocurre, por ejemplo, cuando un administrador deshabilita el modelo o cuando el modelo más nuevo aún no está disponible para tu cuenta.

353 353 

354El cambio se aplica solo a un nivel que no hayas fijado, la misma condición que el respaldo de inicio. Una sesión con una versión específica que elegiste, o con un [ARN de perfil de inferencia de aplicación](#map-each-model-version-to-an-inference-profile), mantiene su modelo y, sin una cadena de modelos de respaldo, la solicitud falla. En [modo automático](https://code.claude.com/docs/es/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code cambia solo a un modelo que el modo automático admite en Amazon Bedrock. Si ninguno de esos modelos está disponible tampoco, la solicitud falla con [AWS authentication failed](https://code.claude.com/docs/es/errors.md#aws-authentication-failed) y una sugerencia para habilitar el modelo.354Si configuraste una [cadena de modelos de respaldo](https://code.claude.com/docs/es/model-config.md#fallback-model-chains), Claude Code cambia en su lugar al respaldo que configuraste. Sin una cadena, la solicitud falla en casos como estos:

355 355 

356Una [cadena de modelos de respaldo](https://code.claude.com/docs/es/model-config.md#fallback-model-chains) que configures reemplaza el cambio de nivel: ante estos rechazos, Claude Code cambia en su lugar al respaldo que configuraste. Para que las solicitudes rechazadas fallen en lugar de cambiar, establece [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/es/env-vars). Una cadena de respaldo que hayas configurado sigue cambiando ante estos rechazos; elimina también la cadena si quieres que todas las solicitudes rechazadas fallen.356* Tu sesión usa un modelo fijado, una versión específica que elegiste o un [ARN de perfil de inferencia de aplicación](#map-each-model-version-to-an-inference-profile)

357* Ninguno de los [modelos que Claude Code intenta](#startup-model-checks) está disponible. En [modo automático](https://code.claude.com/docs/es/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code cambia solo a un modelo que el modo automático admite en Amazon Bedrock.

358 

359Para seguir trabajando, ejecuta `/model` en la sesión y presiona `s` sobre un modelo que tu cuenta pueda usar, lo que deja tu predeterminado sin cambios. Un `403` se muestra como [AWS authentication failed](https://code.claude.com/docs/es/errors.md#aws-authentication-failed).

360 

361Para que las solicitudes rechazadas fallen en lugar de cambiar, establece [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/es/env-vars). Si configuraste una cadena de modelos de respaldo, elimínala también, ya que Claude Code sigue cambiando a ese respaldo.

357 362 

358## Prefijos de perfil de inferencia entre regiones363## Prefijos de perfil de inferencia entre regiones

359 364 

222 222 

223Cada uno es una matriz de descripciones en prosa, leídas como reglas en lenguaje natural. Para bloqueos estrictos basados en patrones de herramientas que se ejecutan antes del clasificador, usa [`permissions.deny`](https://code.claude.com/docs/es/permissions).223Cada uno es una matriz de descripciones en prosa, leídas como reglas en lenguaje natural. Para bloqueos estrictos basados en patrones de herramientas que se ejecutan antes del clasificador, usa [`permissions.deny`](https://code.claude.com/docs/es/permissions).

224 224 

225> [!NOTE]

226>

227> En una sesión de [Code Mode](https://code.claude.com/docs/es/code-mode.md#permission-checks), el clasificador aplica `hard_deny` y `soft_deny` cuando revisa el código de Claude, y no a cada llamada a herramienta que hace el código. Las reglas `permissions.deny` se aplican a cada llamada.

228 

225Dentro del clasificador, la precedencia funciona en cuatro niveles:229Dentro del clasificador, la precedencia funciona en cuatro niveles:

226 230 

227* Las reglas `hard_deny` bloquean incondicionalmente. La intención del usuario y las excepciones `allow` no se aplican.231* Las reglas `hard_deny` bloquean incondicionalmente. La intención del usuario y las excepciones `allow` no se aplican.

283 287 

284De forma predeterminada, las reglas estrechas de Bash y PowerShell como `Bash(npm test)` permanecen en vigor en modo automático. Claude Code las resuelve antes de que se ejecute el clasificador, a menos que el comando lleve [dominios permitidos por comando](https://code.claude.com/docs/es/sandboxing.md#per-command-allowed-domains-in-auto-mode). Claude Code suspende solo las reglas amplias que otorgan ejecución de código arbitrario, como `Bash(*)` o intérpretes con comodines, junto con cada regla que nombra [`Monitor`](https://code.claude.com/docs/es/tools-reference#monitor-tool), porque los comandos Monitor se ejecutan a través del shell. Esto significa que una regla estrecha aún puede dejar pasar un argumento destructivo sin que el clasificador lo vea, por ejemplo una ruta de script o bandera que el prefijo de la regla no anticipó.288De forma predeterminada, las reglas estrechas de Bash y PowerShell como `Bash(npm test)` permanecen en vigor en modo automático. Claude Code las resuelve antes de que se ejecute el clasificador, a menos que el comando lleve [dominios permitidos por comando](https://code.claude.com/docs/es/sandboxing.md#per-command-allowed-domains-in-auto-mode). Claude Code suspende solo las reglas amplias que otorgan ejecución de código arbitrario, como `Bash(*)` o intérpretes con comodines, junto con cada regla que nombra [`Monitor`](https://code.claude.com/docs/es/tools-reference#monitor-tool), porque los comandos Monitor se ejecutan a través del shell. Esto significa que una regla estrecha aún puede dejar pasar un argumento destructivo sin que el clasificador lo vea, por ejemplo una ruta de script o bandera que el prefijo de la regla no anticipó.

285 289 

286Establezca `autoMode.classifyAllShell` en `true` para suspender cada regla de permiso de Bash y PowerShell mientras el modo automático está activo, de modo que el clasificador evalúe cada comando de shell independientemente de su lista de permisos, excepto [eliminaciones de rutas críticas](https://code.claude.com/docs/es/permission-modes.md#critical-paths).290Establece `autoMode.classifyAllShell` en `true` para suspender cada regla de permiso de Bash y PowerShell mientras el modo automático está activo, de modo que el clasificador evalúe cada comando de shell independientemente de tu lista de permisos, excepto [eliminaciones de rutas críticas](https://code.claude.com/docs/es/permission-modes.md#critical-paths). En una sesión de [Code Mode](https://code.claude.com/docs/es/code-mode.md#permission-checks), el clasificador revisa el código que ejecuta los comandos, incluso con este ajuste activado.

287 291 

288```json theme={null}292```json theme={null}

289{293{

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

74| PostgreSQL 11 o posterior | Respalda el flujo de inicio de sesión de dispositivo y los contadores de rate limit. Funciona un servicio administrado de PostgreSQL, incluido el nivel más pequeño; consulta [qué bases de datos son compatibles](https://code.claude.com/docs/es/claude-apps-gateway-deploy.md#postgres). Con [límites de gasto](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md), también almacena tablas duraderas de gasto, auditoría e identidad que deben respaldarse. Se recomienda TLS mediante `?sslmode=require`. PostgreSQL 11, 12 y 13 requieren Claude Code v2.1.290 o posterior en el servidor del gateway. El proyecto PostgreSQL ya no mantiene esas versiones, así que usa una más reciente cuando puedas. |74| PostgreSQL 11 o posterior | Respalda el flujo de inicio de sesión de dispositivo y los contadores de rate limit. Funciona un servicio administrado de PostgreSQL, incluido el nivel más pequeño; consulta [qué bases de datos son compatibles](https://code.claude.com/docs/es/claude-apps-gateway-deploy.md#postgres). Con [límites de gasto](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md), también almacena tablas duraderas de gasto, auditoría e identidad que deben respaldarse. Se recomienda TLS mediante `?sslmode=require`. PostgreSQL 11, 12 y 13 requieren Claude Code v2.1.290 o posterior en el servidor del gateway. El proyecto PostgreSQL ya no mantiene esas versiones, así que usa una más reciente cuando puedas. |

75| Upstream de modelos | Credenciales de Amazon Bedrock, credenciales de Claude Platform on AWS, credenciales de Google Cloud, un recurso de Microsoft Foundry o una clave de API de Anthropic. Se admiten varios upstreams con conmutación por error. |75| Upstream de modelos | Credenciales de Amazon Bedrock, credenciales de Claude Platform on AWS, credenciales de Google Cloud, un recurso de Microsoft Foundry o una clave de API de Anthropic. Se admiten varios upstreams con conmutación por error. |

76| HTTPS | El gateway debe ser accesible mediante `https://` desde las laptops de los desarrolladores y desde cualquier navegador que se use para iniciar sesión; el gateway sirve la página de verificación de dispositivo en el mismo listener. Proporciona un certificado TLS mediante `listen.tls` o ejecútalo detrás de un ingress que termine TLS, y en ambos casos establece `listen.public_url` en el origen externo. En `/login`, Claude Code acepta un origen `http://` simple solo cuando el host del gateway es loopback: `localhost`, `127.0.0.1` o `::1`. |76| HTTPS | El gateway debe ser accesible mediante `https://` desde las laptops de los desarrolladores y desde cualquier navegador que se use para iniciar sesión; el gateway sirve la página de verificación de dispositivo en el mismo listener. Proporciona un certificado TLS mediante `listen.tls` o ejecútalo detrás de un ingress que termine TLS, y en ambos casos establece `listen.public_url` en el origen externo. En `/login`, Claude Code acepta un origen `http://` simple solo cuando el host del gateway es loopback: `localhost`, `127.0.0.1` o `::1`. |

77| Dirección de red privada | En `/login`, Claude Code requiere que el hostname o la dirección IP del gateway resuelva solo a direcciones privadas: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` o loopback. Para un gateway que alojas tú, se rechaza cualquier dirección pública fuera de un bloque que declares; consulta el [modelo de amenazas](https://code.claude.com/docs/es/claude-apps-gateway-deploy.md#threat-model-summary) en la guía de despliegue. Si las máquinas de los desarrolladores enrutan HTTPS a través de un proxy corporativo, el inicio de sesión también requiere que el host del proxy resuelva a direcciones privadas; si no es así, agrega el host del gateway a `NO_PROXY` para que la CLI se conecte directamente. Si tu red interna está numerada con espacio IPv4 público que pertenece a tu organización, [declara esos bloques](#allow-a-gateway-on-public-address-space-you-own) para que `/login` acepte un gateway ahí. |77| Dirección de red privada | En `/login`, Claude Code requiere que el hostname o la dirección IP del gateway resuelva solo a direcciones privadas: RFC 1918 y rangos link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` y loopback. Consulta el [modelo de amenazas](https://code.claude.com/docs/es/claude-apps-gateway-deploy.md#threat-model-summary). Si tu red interna está numerada con espacio IPv4 público que pertenece a tu organización, [declara esos bloques](#allow-a-gateway-on-public-address-space-you-own) para que `/login` acepte un gateway ahí. |

78| Entorno de ejecución Linux | El servidor del gateway solo se ejecuta en el binario nativo de Linux. macOS funciona para desarrollo local. Windows no es compatible como plataforma de servidor. |78| Entorno de ejecución Linux | El servidor del gateway solo se ejecuta en el binario nativo de Linux. macOS funciona para desarrollo local. Windows no es compatible como plataforma de servidor. |

79 79 

80Cuando `HTTPS_PROXY` o `HTTP_PROXY` se aplica al host del gateway, el inicio de sesión también requiere un proxy cuyo hostname resuelva a direcciones privadas o bien el host del gateway en `NO_PROXY` en las máquinas de los desarrolladores. Si esas máquinas también establecen `no_proxy`, agrega ahí también el host del gateway; de lo contrario, las solicitudes de modelos seguirán pasando por el proxy.

81 

80### Pasos82### Pasos

81 83 

82**1. Registra un cliente OAuth en tu IdP**84**1. Registra un cliente OAuth en tu IdP**

16 16 

17## Estructura del archivo17## Estructura del archivo

18 18 

19Cinco secciones son [requeridas](#required-sections). Todas las demás secciones son [opcionales](#optional-sections), y una sección omitida toma sus valores predeterminados. Las claves desconocidas fallan al arrancar, por lo que un error tipográfico aparece como un error nombrado en lugar de una configuración silenciosamente ignorada.19Cinco secciones son [requeridas](#required-sections). Todas las demás secciones son [opcionales](#optional-sections), y una sección omitida toma sus valores predeterminados.

20 20 

21**Secciones requeridas:**21**Secciones requeridas:**

22 22 

519 519 

520Requiere un gateway que ejecute Claude Code v2.1.281 o posterior. [Atribución de costos en AWS](https://code.claude.com/docs/es/claude-apps-gateway-on-aws.md#cost-attribution) explica el rol de IAM y dónde muestra la facturación de AWS las sesiones.520Requiere un gateway que ejecute Claude Code v2.1.281 o posterior. [Atribución de costos en AWS](https://code.claude.com/docs/es/claude-apps-gateway-on-aws.md#cost-attribution) explica el rol de IAM y dónde muestra la facturación de AWS las sesiones.

521 521 

522> [!NOTE]

523>

524> Para la atribución por desarrollador, establece `assume_role` con `session_name` en todos los upstreams `bedrock` y [`mantle`](#amazon-bedrock-mantle-endpoint), excepto los que usan `aws_bearer_token`. Esos [no pueden usar `assume_role`](#bedrock-in-another-aws-account), por lo que sus solicitudes permanecen bajo una sola entidad principal.

525 

522```yaml theme={null}526```yaml theme={null}

523upstreams:527upstreams:

524 - provider: bedrock528 - provider: bedrock

535 539 

536El gateway también hace una llamada propia con este rol: el conteo de tokens de una solicitud que el cliente abandonó, para que los [límites de gasto](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md) se mantengan precisos. Ese conteo y su [solicitud de respaldo de un token](#amazon-bedrock) se firman con la sesión compartida `claude-apps-gateway`, por lo que AWS atribuye el respaldo a `claude-apps-gateway` en lugar de al desarrollador.540El gateway también hace una llamada propia con este rol: el conteo de tokens de una solicitud que el cliente abandonó, para que los [límites de gasto](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md) se mantengan precisos. Ese conteo y su [solicitud de respaldo de un token](#amazon-bedrock) se firman con la sesión compartida `claude-apps-gateway`, por lo que AWS atribuye el respaldo a `claude-apps-gateway` en lugar de al desarrollador.

537 541 

538Para una atribución estricta por desarrollador, establece `assume_role` con `session_name` en cada upstream de Bedrock que enumeres. Un upstream sin él firma las solicitudes que sirve con sus propias credenciales.

539 

540#### Endpoint Mantle de Amazon Bedrock542#### Endpoint Mantle de Amazon Bedrock

541 543 

542El proveedor `mantle` envía la inferencia al [endpoint Mantle](https://code.claude.com/docs/es/amazon-bedrock.md#use-the-mantle-endpoint) de Amazon Bedrock. Requiere Claude Code v2.1.283 o posterior en el servidor del gateway. Las versiones anteriores del gateway lo rechazan al arrancar, así que actualiza todas las réplicas antes de agregarlo.544El proveedor `mantle` envía la inferencia al [endpoint Mantle](https://code.claude.com/docs/es/amazon-bedrock.md#use-the-mantle-endpoint) de Amazon Bedrock. Requiere Claude Code v2.1.283 o posterior en el servidor del gateway. Las versiones anteriores del gateway lo rechazan al arrancar, así que actualiza todas las réplicas antes de agregarlo.

656 658 

657| Configuración | Cómo |659| Configuración | Cómo |

658| - | - |660| - | - |

659| RBAC | Otorga a la identidad del gateway `Azure AI User` o `Cognitive Services User` sobre el recurso de Microsoft Foundry |661| RBAC | Concede a la identidad del gateway el rol `Foundry User` o `Cognitive Services User` en el recurso de Microsoft Foundry |

660| Despliegues | Microsoft Foundry usa nombres de despliegue elegidos por el administrador, no IDs de modelo canónicos. Agrega un bloque [`models:`](#models) que asigne cada ID canónico a tu nombre de despliegue. |662| Despliegues | Microsoft Foundry usa nombres de despliegue elegidos por el administrador, no IDs de modelo canónicos. Agrega un bloque [`models:`](#models) que asigne cada ID canónico a tu nombre de despliegue. |

661| AKS (workload identity) | Federa una User-Assigned Managed Identity con el emisor de OIDC del clúster y vincúlala a la cuenta de servicio del gateway. `use_azure_ad: true` la recoge a través de `WorkloadIdentityCredential`. |663| AKS (workload identity) | Federa una User-Assigned Managed Identity con el emisor de OIDC del clúster y vincúlala a la cuenta de servicio del gateway. `use_azure_ad: true` la recoge a través de `WorkloadIdentityCredential`. |

662| ACI / App Service | Habilita la managed identity asignada por el sistema o por el usuario en el recurso. `use_azure_ad: true` la recoge. |664| ACI / App Service | Habilita la managed identity asignada por el sistema o por el usuario en el recurso. `use_azure_ad: true` la recoge. |

1001 1003 

1002Cada clave bajo `upstream_model` debe coincidir con el `name` de un upstream configurado, que de forma predeterminada es el nombre del proveedor. Una clave que no coincide con ningún upstream hace fallar el arranque, así que omite las líneas de los proveedores que no uses.1004Cada clave bajo `upstream_model` debe coincidir con el `name` de un upstream configurado, que de forma predeterminada es el nombre del proveedor. Una clave que no coincide con ningún upstream hace fallar el arranque, así que omite las líneas de los proveedores que no uses.

1003 1005 

1006Para permitir que los desarrolladores usen el alias `fable` con `auto_include_builtin_models: false`, agrega una entrada `claude-fable-5` a `models`. Ese es el ID al que se resuelve el [alias `fable`](https://code.claude.com/docs/es/model-config#fable-alias-resolution) para los desarrolladores con sesión iniciada en el gateway. Sin ella, sus mensajes fallan con un error que empieza por `API Error: 400 model claude-fable-5 is not in the operator's model allowlist`.

1007 

1004### `managed`1008### `managed`

1005 1009 

1006El bloque `managed` define políticas de acceso basadas en roles según los grupos del IdP o el dominio de correo electrónico. Las políticas se evalúan en orden; de forma predeterminada se selecciona la primera coincidencia, que luego se combina sobre la base general `match: {}`. Un usuario que coincide con dos políticas de rol obtiene solo la primera, por lo que las reglas de denegación de la segunda política no se aplican a menos que [apliques todas las políticas coincidentes](#apply-every-matching-policy). Las políticas se sirven por usuario en `GET /managed/settings` con caché ETag/304.1010El bloque `managed` define políticas de acceso basadas en roles según los grupos del IdP o el dominio de correo electrónico. Las políticas se evalúan en orden; de forma predeterminada se selecciona la primera coincidencia, que luego se combina sobre la base general `match: {}`. Un usuario que coincide con dos políticas de rol obtiene solo la primera, por lo que las reglas de denegación de la segunda política no se aplican a menos que [apliques todas las políticas coincidentes](#apply-every-matching-policy). Las políticas se sirven por usuario en `GET /managed/settings` con caché ETag/304.

1025Una captura general `match: {}`, que por convención se coloca al final, se trata como una capa base. Todas las demás políticas heredan de la captura general cualquier clave que no establezcan, por lo que las entradas por rol solo necesitan enumerar lo que difiere del valor predeterminado de la organización. Las reglas de fusión dependen del tipo de clave:1029Una captura general `match: {}`, que por convención se coloca al final, se trata como una capa base. Todas las demás políticas heredan de la captura general cualquier clave que no establezcan, por lo que las entradas por rol solo necesitan enumerar lo que difiere del valor predeterminado de la organización. Las reglas de fusión dependen del tipo de clave:

1026 1030 

1027* **Listas de permitidos**: `availableModels` y `permissions.allow`. La lista de una política específica reemplaza por completo la de la base.1031* **Listas de permitidos**: `availableModels` y `permissions.allow`. La lista de una política específica reemplaza por completo la de la base.

1028* **Listas de denegación y arrays de hooks**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces`, `deniedModels` y cada array de tipo de evento de `hooks`. Estas toman la unión de la base y la política, de modo que una denegación o un hook de auditoría de toda la organización no se pueda descartar accidentalmente con una sobrescritura por rol.1032* **Listas de denegación y arrays de hooks**: toman la unión de la base y la política:

1033 * `permissions.deny` y `permissions.ask`

1034 * `disabledMcpjsonServers` y `deniedMcpServers`

1035 * `blockedMarketplaces` y `deniedModels`

1036 * Los arrays de tipos de evento de `hooks`

1029* **Claves de tipo registro**: `env`, `modelOverrides` y `skillOverrides`. Estas se fusionan superficialmente, por lo que un bloque `env` por rol sobrescribe las claves que establece y hereda el resto de la base.1037* **Claves de tipo registro**: `env`, `modelOverrides` y `skillOverrides`. Estas se fusionan superficialmente, por lo que un bloque `env` por rol sobrescribe las claves que establece y hereda el resto de la base.

1030 1038 

1031`availableModels` también se aplica del lado del servidor en `/v1/messages`, por lo que un modelo denegado devuelve `400` independientemente de lo que envíe el cliente. Una lista vacía deniega todos los modelos. La comprobación también cubre el modelo con el que empieza una sesión antes de que el desarrollador elija uno, así que [inicia las sesiones en un modelo que la política permita](#start-sessions-on-a-model-the-policy-allows).1039`availableModels` también se aplica del lado del servidor en `/v1/messages`, por lo que un modelo denegado devuelve `400` independientemente de lo que envíe el cliente. Una lista vacía deniega todos los modelos. La comprobación también cubre el modelo con el que empieza una sesión antes de que el desarrollador elija uno, así que [inicia las sesiones en un modelo que la política permita](#start-sessions-on-a-model-the-policy-allows).

1277 1285 

1278Para desactivar el contexto de 1M, establece [`CLAUDE_CODE_DISABLE_1M_CONTEXT: "1"`](https://code.claude.com/docs/es/model-config#extended-context) en el mismo bloque `env`. Claude Code trata entonces todos los modelos como si tuvieran una ventana de 200K. En las sesiones interactivas, cada desarrollador aprueba esta variable en el [diálogo de aprobación](#what-goes-in-cli) antes de que surta efecto.1286Para desactivar el contexto de 1M, establece [`CLAUDE_CODE_DISABLE_1M_CONTEXT: "1"`](https://code.claude.com/docs/es/model-config#extended-context) en el mismo bloque `env`. Claude Code trata entonces todos los modelos como si tuvieran una ventana de 200K. En las sesiones interactivas, cada desarrollador aprueba esta variable en el [diálogo de aprobación](#what-goes-in-cli) antes de que surta efecto.

1279 1287 

1288> [!NOTE]

1289>

1290> Claude Code no lee el `upstream_model` de un alias para dimensionar su ventana de contexto. Para dar la ventana de su modelo a un alias de `models` que Claude Code no reconoce, consulta [Corregir la ventana para un gateway o un ID de modelo personalizado](https://code.claude.com/docs/es/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id).

1291 

1280#### Caché de prompts de una hora1292#### Caché de prompts de una hora

1281 1293 

1282Para solicitar el [TTL de la caché de prompts](https://code.claude.com/docs/es/prompt-caching.md#cache-lifetime) de una hora en lugar de los cinco minutos predeterminados, agrega estas claves al [bloque `code`, `cli` o `settings`](#choose-cli-or-code) existente de una política y reinicia el gateway. Las claves necesitan Claude Code v2.1.242 o posterior en el servidor del gateway y en los clientes.1294Para solicitar el [TTL de la caché de prompts](https://code.claude.com/docs/es/prompt-caching.md#cache-lifetime) de una hora en lugar de los cinco minutos predeterminados, agrega estas claves al [bloque `code`, `cli` o `settings`](#choose-cli-or-code) existente de una política y reinicia el gateway. Las claves necesitan Claude Code v2.1.242 o posterior en el servidor del gateway y en los clientes.

1379 1391 

1380##### Qué rechaza el gateway al arrancar1392##### Qué rechaza el gateway al arrancar

1381 1393 

1382El gateway valida cada bloque `desktop` al arrancar con el mismo esquema de configuración que usa Claude Desktop, por lo que un error aparece al iniciar el gateway como un mensaje que nombra la clave, en lugar de llegar a cada escritorio conectado. El gateway falla al arrancar cuando un bloque contiene:1394El gateway falla al arrancar cuando un bloque `desktop` contiene:

1383 1395 

1384* Una clave desconocida1396* Una clave reconocida cuyo valor Claude Desktop rechazaría o descartaría silenciosamente, como un valor vacío.

1385* Una clave reconocida cuyo valor Claude Desktop rechazaría o descartaría silenciosamente, como un valor vacío o una subclave mal escrita dentro de una entrada anidada. Antes de v2.1.260, el gateway descartaba silenciosamente un campo mal escrito dentro de un objeto anidado de una entrada `managedMcpServers` u `orgPluginSettings` en lugar de fallar al arrancar.

1386* Una clave que el propio gateway calcula: la conexión de inferencia, la lista de modelos y la retransmisión OTLP. Configúralas mediante [`upstreams`](#upstreams), [`models`](#models) y el `forward_to` de la sección [`telemetry`](#telemetry).1397* Una clave que el propio gateway calcula: la conexión de inferencia, la lista de modelos y la retransmisión OTLP. Configúralas mediante [`upstreams`](#upstreams), [`models`](#models) y el `forward_to` de la sección [`telemetry`](#telemetry).

1387* Un alias heredado de una clave actual. En el error de arranque, el gateway nombra la clave canónica que debes escribir.1398* Un alias heredado de una clave actual. En el error de arranque, el gateway nombra la clave canónica que debes escribir.

1399* Desde v2.1.300, cualquier clave cuyo nombre empiece por `selfHosted`, como las claves de un host de sesiones autoalojado. Elimina estas claves antes de actualizar el gateway a v2.1.300 o posterior.

1388 1400 

1389Si usas un valor o una forma de entrada obsoletos, como una entrada `managedMcpServers` sin `transport`, el gateway arranca y registra una advertencia que nombra el reemplazo.1401Si usas un valor o una forma de entrada obsoletos, como una entrada `managedMcpServers` sin `transport`, el gateway arranca y registra una advertencia que nombra el reemplazo.

1390 1402 

1391Antes de v2.1.232, el gateway aceptaba una lista fija de 11 claves de activación de funciones, como `chatTabEnabled` y `disableAutoUpdates`, y rechazaba todas las demás claves al arrancar. Antes de v2.1.227, el gateway también rechazaba `chatTabEnabled` y `chatAdvancedFileAnalysisEnabled` al arrancar.1403Antes de v2.1.232, el gateway aceptaba una lista fija de 11 claves de activación de funciones, como `chatTabEnabled` y `disableAutoUpdates`, y rechazaba todas las demás claves al arrancar. Antes de v2.1.227, el gateway también rechazaba `chatTabEnabled` y `chatAdvancedFileAnalysisEnabled` al arrancar.

1392 1404 

1405##### Claves que el gateway no conoce

1406 

1407En un gateway que ejecuta Claude Code v2.1.295 o posterior, la mayoría de las claves de una versión más nueva de Claude Desktop no requieren actualizar el gateway. En v2.1.321 o posterior, tampoco lo requieren la mayoría de las subclaves nuevas dentro de una clave conocida.

1408 

1409Algunas claves y valores siguen fallando al arrancar, como estos:

1410 

1411* Una nueva opción en la lista fija de valores de una clave conocida.

1412* Un probable error tipográfico de una clave que puedes establecer en un bloque `desktop`, como `disable_auto_updates` en lugar de `disableAutoUpdates`. El error sugiere un nombre.

1413 

1414En cada caso, si el nombre o el valor existe en una versión más nueva de Claude Desktop, [actualiza el gateway](https://code.claude.com/docs/es/claude-apps-gateway-deploy.md#upgrades) a la versión más reciente. De lo contrario, corrígelo o elimínalo. Para averiguarlo antes de desplegar, [prueba la política](#test-a-policy-before-deployment).

1415 

1393##### Claves que necesitan una versión posterior del gateway o de Claude Desktop1416##### Claves que necesitan una versión posterior del gateway o de Claude Desktop

1394 1417 

1395El gateway valida un bloque `desktop` con el esquema incluido en su versión instalada, igual que hace con el bloque `cli`. Para entregar un ajuste introducido por una versión más reciente de Claude Desktop, actualiza primero el gateway. Por ejemplo, `userPluginMarketplacesEnabled` y `userPluginUploadsEnabled` necesitan Claude Code v2.1.260 o posterior en el servidor del gateway y Claude Desktop 1.37937.0 o posterior en las máquinas de los miembros.1418`userPluginMarketplacesEnabled` y `userPluginUploadsEnabled` necesitan Claude Code v2.1.260 o posterior en el servidor del gateway y Claude Desktop 1.37937.0 o posterior en las máquinas de los miembros.

1396 1419 

1397`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` y `sshClientPath` necesitan Claude Code v2.1.281 o posterior en el servidor del gateway. Lo mismo ocurre con el valor `required` de `microsoftAuthBroker` y el campo `continuousAccessEvaluation` de una entrada `managedMcpServers` de Microsoft 365. Las versiones de Claude Desktop anteriores al valor `required` lo leen como `disabled`, así que establece `required` solo después de que el Claude Desktop de todos los miembros lo admita. La [referencia de configuración administrada](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop indica la versión que lee por primera vez cada clave.1420`blockReadsOutsideWorkingDirectories`, `disableBypassPermissionsMode`, `configRecheckIntervalMinutes` y `sshClientPath` necesitan Claude Code v2.1.281 o posterior en el servidor del gateway. Lo mismo ocurre con el valor `required` de `microsoftAuthBroker` y el campo `continuousAccessEvaluation` de una entrada `managedMcpServers` de Microsoft 365. Las versiones de Claude Desktop anteriores al valor `required` lo leen como `disabled`, así que establece `required` solo después de que el Claude Desktop de todos los miembros lo admita. La [referencia de configuración administrada](https://claude.com/docs/third-party/claude-desktop/configuration) de Claude Desktop indica la versión que lee por primera vez cada clave.

1398 1421 

92 92 

93Más allá del binario, la imagen necesita:93Más allá del binario, la imagen necesita:

94 94 

95* **Una imagen basada en glibc**: las únicas dependencias dinámicas de la compilación de glibc son las bibliotecas de glibc. Las imágenes basadas en Musl necesitan la compilación `linux-x64-musl` o `linux-arm64-musl` más paquetes adicionales; consulte [Configuración de Alpine Linux](https://code.claude.com/docs/es/setup.md#alpine-linux-and-musl-based-distributions).95* **Una imagen basada en glibc**: las únicas dependencias dinámicas de la compilación de glibc son bibliotecas de glibc. Las imágenes basadas en musl necesitan la compilación `linux-x64-musl` o `linux-arm64-musl`, cuya única dependencia dinámica es musl.

96* **Un directorio de estado escribible**: la puerta de enlace se ejecuta como cualquier usuario, pero las imágenes mínimas no tienen inicio escribible. Establezca `CLAUDE_CONFIG_DIR` en una ruta escribible como `/tmp/.claude`.96* **Un directorio de estado escribible**: la puerta de enlace se ejecuta como cualquier usuario, pero las imágenes mínimas no tienen inicio escribible. Establezca `CLAUDE_CONFIG_DIR` en una ruta escribible como `/tmp/.claude`.

97* **El comando del contenedor**: `claude gateway --config /etc/claude/gateway.yaml`, con el archivo de configuración montado de solo lectura y secretos suministrados como variables de entorno; la puerta de enlace escucha en `listen.port`, predeterminado `8080`.97* **El comando del contenedor**: `claude gateway --config /etc/claude/gateway.yaml`, con el archivo de configuración montado de solo lectura y secretos suministrados como variables de entorno; la puerta de enlace escucha en `listen.port`, predeterminado `8080`.

98 98 

189 189 

190```190```

191Sent to cloud session.191Sent to cloud session.

192Session ID: session_01DiUkqY2kzbUbDmW1w96rfi192Session ID: session_01HJKLMNOPQRSTUVWXYZ

193View: https://claude.ai/code/session_01DiUkqY2kzbUbDmW1w96rfi?from=cli&m=0193View: https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli&m=0

194```194```

195 195 

196Pase `--output-format json` para un resultado legible por máquina: `{ok, session_id, url}` en caso de éxito, o `{ok: false, session_id, error}` cuando el envío falla, por ejemplo cuando falta la sesión o está archivada. Los errores de configuración, como un proveedor no compatible o una política de organización deshabilitada, se imprimen en stderr sin JSON. `--output-format stream-json` no es compatible con `--cloud <session-id>`.196Pase `--output-format json` para un resultado legible por máquina: `{ok, session_id, url}` en caso de éxito, o `{ok: false, session_id, error}` cuando el envío falla, por ejemplo cuando falta la sesión o está archivada. Los errores de configuración, como un proveedor no compatible o una política de organización deshabilitada, se imprimen en stderr sin JSON. `--output-format stream-json` no es compatible con `--cloud <session-id>`.

274 274 

275El hilo se ejecuta en [modo automático](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode), por lo que Claude ejecuta comandos y edita archivos en esa carpeta sin pedirle cada vez. Si el modo automático no está disponible o está desactivado en Claude Code de esa computadora, el hilo se ejecuta sin él, y cualquier aviso de permiso que genere espera su respuesta en el hilo, como [Desbloquear un hilo esperando aprobación](#unblock-a-thread-waiting-on-approval) describe.275El hilo se ejecuta en [modo automático](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode), por lo que Claude ejecuta comandos y edita archivos en esa carpeta sin pedirle cada vez. Si el modo automático no está disponible o está desactivado en Claude Code de esa computadora, el hilo se ejecuta sin él, y cualquier aviso de permiso que genere espera su respuesta en el hilo, como [Desbloquear un hilo esperando aprobación](#unblock-a-thread-waiting-on-approval) describe.

276 276 

277Para ejecutar el hilo en otro modo, inicia `claude remote-control` con [`--settings`](https://code.claude.com/docs/es/remote-control#start-a-remote-control-session). Luego [`permissions.defaultMode`](https://code.claude.com/docs/es/permission-modes#start-in-a-different-mode), en ese archivo o en la configuración de esa computadora, puede elegir otro modo.

278 

277Mientras el hilo se ejecuta, un icono de portátil en su encabezado muestra si tu computadora está conectada. Haz clic en él para ver qué carpeta está usando el hilo o para desactivar la conexión. El hilo se pausa mientras esa computadora está en reposo, y se detiene si la aplicación de escritorio o `claude remote-control` se cierra.279Mientras el hilo se ejecuta, un icono de portátil en su encabezado muestra si tu computadora está conectada. Haz clic en él para ver qué carpeta está usando el hilo o para desactivar la conexión. El hilo se pausa mientras esa computadora está en reposo, y se detiene si la aplicación de escritorio o `claude remote-control` se cierra.

278 280 

279* **Para volver a poner en marcha el hilo**: consulta [Lost contact with your folder](#lost-contact-with-your-folder)281* **Para volver a poner en marcha el hilo**: consulta [Lost contact with your folder](#lost-contact-with-your-folder)

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Ejecuta llamadas a herramientas desde código con Code Mode

6 

7> Prueba Code Mode, una función experimental en la que Claude escribe JavaScript que realiza varias llamadas a herramientas en un solo paso.

8 

9Code Mode cambia la forma en que Claude usa sus [herramientas](https://code.claude.com/docs/es/tools-reference.md). Sin Code Mode, Claude solicita llamadas a herramientas como Bash, Read o Edit directamente y lee cada resultado antes de decidir qué hacer a continuación. Con Code Mode, Claude escribe un fragmento de JavaScript que realiza las llamadas a herramientas, y Claude Code ejecuta ese código en tu sesión.

10 

11> [!NOTE]

12>

13> Code Mode es experimental y está desactivado de forma predeterminada. Puede cambiar o eliminarse en cualquier versión. Para compartir comentarios, ejecuta `/feedback`.

14 

15## Cómo funciona Code Mode

16 

17En una sesión de Code Mode, sigues describiendo tu tarea en un prompt, y Claude escribe JavaScript para llevarla a cabo. Un solo fragmento de código puede ejecutar comandos en paralelo, usar un resultado en la siguiente llamada y devolver la parte de la salida que Claude necesita leer.

18 

19Por ejemplo, si le pides a Claude que aumente un límite de reintentos, Claude podría escribir este código para encontrar el archivo, editarlo y ejecutar las pruebas. La última línea devuelve a Claude la ruta del archivo y la salida de las pruebas:

20 

21```javascript theme={null}

22const files = await $`rg -l "function retryPolicy" src`.text();

23const target = files.trim().split("\n")[0];

24await edit(target, "maxAttempts: 3", "maxAttempts: 5");

25({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

26```

27 

28En la conversación, ves las llamadas a herramientas, como el diff de la edición, y no el código. Para leer el código, presiona `Ctrl+O` para abrir el [visor de transcripciones](https://code.claude.com/docs/es/interactive-mode.md#transcript-viewer). Cada fragmento de código aparece ahí como una fila **Code** contraída, con una indicación de cómo expandirla.

29 

30### Cuándo usar Code Mode

31 

32Prueba Code Mode en tareas que requieren muchas llamadas a herramientas relacionadas, como:

33 

34* Un cambio que se repite en muchos archivos

35* Una búsqueda cuyos resultados necesitan filtrarse antes de que Claude los lea

36* Varios comandos independientes que pueden ejecutarse al mismo tiempo

37 

38### Limitaciones de Code Mode

39 

40Antes de activar Code Mode, comprueba que puedes aceptar estas limitaciones:

41 

42* **Reanudación**: solo puedes reanudar una sesión de Code Mode en la terminal, con Code Mode activado

43* **Modo automático**: el clasificador del modo automático [revisa el código, no cada llamada a herramienta](#permission-checks)

44* **Código de larga duración**: a menos que [el código pueda ejecutarse en segundo plano](#long-running-code), esperas a que termine, y se detiene después de diez minutos

45* **Hooks**: puedes ver [llamadas a herramientas rechazadas](#tool-call-refused-by-a-hook) cuando un hook `PreToolUse` no puede ejecutarse o se agota su tiempo de espera, y [salida de código bloqueada](#code-output-withheld-by-a-hook) por un hook `UserPromptSubmit`

46* **Funciones no disponibles**: no puedes usar [Remote Control](https://code.claude.com/docs/es/remote-control.md), [Claude in Chrome](https://code.claude.com/docs/es/chrome.md) ni [computer use](https://code.claude.com/docs/es/computer-use.md)

47* **Mover la sesión**: no puedes mover la sesión a la aplicación de escritorio ni convertirla en una [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md), y `/fork` no puede iniciar una copia en segundo plano

48 

49## Requisitos

50 

51* **Versión**: Claude Code v2.1.323 o posterior, en cualquiera de los dos [canales de versiones](https://code.claude.com/docs/es/setup.md#configure-release-channel). Una versión anterior se inicia sin Code Mode, con o sin el motivo `it isn't open to your account yet`

52* **Cuenta**: una suscripción a Claude o una cuenta de Console. No puedes usar Code Mode a través de un gateway, Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud ni Microsoft Foundry

53* **Organización**: tu organización no usa la [configuración HIPAA](https://code.claude.com/docs/es/hipaa-setup.md) ni la [retención cero de datos](https://code.claude.com/docs/es/zero-data-retention.md)

54* **Modelo**: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2

55* **Superficie**: una sesión interactiva de `claude` en una terminal. Code Mode no funciona con `-p`, el Agent SDK, el panel de VS Code, la aplicación de escritorio ni las sesiones en la nube

56* **Instalación**: la [compilación nativa](https://code.claude.com/docs/es/setup.md) de Claude Code

57* **Windows**: [Git for Windows](https://git-scm.com/downloads/win) está instalado

58 

59Tampoco puedes iniciar Code Mode con algunos ajustes activados, como un asistente de clave de API, equipos de agentes, exportación de OpenTelemetry o `DISABLE_TELEMETRY`. Para ver la solución de cada uno, consulta [Code Mode no se inicia](#code-mode-doesnt-start).

60 

61## Prueba Code Mode

62 

63Activa Code Mode, dale una tarea a Claude y revisa el código que Claude escribió.

64 

65**1. Comprueba tu versión**

66 

67Ejecuta `claude --version`. Si la versión es anterior a v2.1.323, ejecuta `claude update`. Si estás en el canal `stable` y la actualización no llega a v2.1.323, espera a que `stable` se ponga al día o [cambia a `latest`](https://code.claude.com/docs/es/setup#configure-release-channel).

68 

69**2. Inicia Claude Code con Code Mode activado**

70 

71Establece la variable de entorno [`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`](https://code.claude.com/docs/es/env-vars#variables) en `1`. Para probar Code Mode, establécela en tu shell. Para activar Code Mode en cada sesión nueva, establécela en tu configuración de usuario.

72 

73> [tab] macOS, Linux, WSL

74>

75> ```bash theme={null}

76> CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

77> ```

78 

79> [tab] Windows PowerShell

80>

81> ```powershell theme={null}

82> $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"

83> claude

84> ```

85 

86> [tab] settings.json

87>

88> Guarda este bloque `env` en `~/.claude/settings.json` e inicia `claude`:

89>

90> ```json theme={null}

91> {

92> "env": {

93> "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"

94> }

95> }

96> ```

97>

98> Claude Code [ignora esta variable en los archivos de configuración de un proyecto](https://code.claude.com/docs/es/settings-reference.md#variables-claude-code-ignores-in-env), por lo que un repositorio que clones no puede activar Code Mode por ti.

99 

100**3. Confirma que quieres Code Mode**

101 

102Claude Code te pide que confirmes antes de tu primera sesión de Code Mode. Selecciona **Yes, turn on Code Mode**. Claude Code se reinicia y muestra esta línea cerca de la parte superior de la sesión:

103 

104```text theme={null}

105Code Mode (experimental) is on · this session can be resumed only with Code Mode on

106```

107 

108Si ves una línea diferente o ninguna, consulta [Code Mode no se inicia](#code-mode-doesnt-start).

109 

110**4. Dale a Claude una tarea con muchas llamadas a herramientas**

111 

112En un proyecto que conozcas, envía un prompt como este:

113 

114```text theme={null}

115Read every Markdown file in this project and list the links that point to local files that don't exist.

116```

117 

118**5. Lee el código que escribió Claude**

119 

120Presiona `Ctrl+O` y expande una fila **Code** para ver el JavaScript detrás de las llamadas a herramientas. Presiona `Ctrl+O` de nuevo para volver a la conversación.

121 

122> [!WARNING]

123>

124> Para reanudar una sesión de Code Mode más tarde, mantén `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` establecida en `1` cuando ejecutes `claude --continue` o `claude --resume`. Con Code Mode desactivado, Claude Code se niega a reanudar la sesión. Las sesiones que iniciaste sin Code Mode se reanudan sin Code Mode, incluso con la variable establecida.

125 

126### Desactiva Code Mode

127 

128Elimina `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` de tu shell y de `~/.claude/settings.json`, y luego inicia una sesión nueva. También puedes conservar la variable y cambiar su valor a `0` en cualquiera de los dos lugares. Con un `0` en un lugar, Code Mode permanece desactivado aunque establezcas `1` en el otro.

129 

130### Bloquea Code Mode para tu organización

131 

132Agrega `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` con el valor `0` a tu [configuración administrada](https://code.claude.com/docs/es/managed-settings.md) para que nadie en tu organización pueda usar Code Mode:

133 

134```json theme={null}

135{

136 "env": {

137 "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"

138 }

139}

140```

141 

142Los usuarios que estén en una sesión de Code Mode permanecen en ella hasta que salgan o reinicien Claude Code. Después de eso, tus usuarios inician sin Code Mode y no pueden reanudar sus sesiones de Code Mode mientras el `0` esté establecido. No puedes activar Code Mode para tus usuarios desde la configuración administrada.

143 

144## Permisos y código de larga duración

145 

146Tu modo de permisos decide cómo se revisa el código de Claude y si puedes hablar con Claude mientras el código se ejecuta.

147 

148### Comprobaciones de permisos

149 

150Cada llamada a herramienta que realiza el código de Claude pasa por tus [reglas de permisos](https://code.claude.com/docs/es/permissions.md) `deny` y `ask` y tus [hooks `PreToolUse`](https://code.claude.com/docs/es/hooks#pretooluse). No necesitas cambiar una regla ni un matcher para una herramienta como `Bash`. Además de las reglas y los hooks, un clasificador revisa el código en el modo automático, y tú respondes a las solicitudes en los modos que preguntan:

151 

152* **[Modo automático](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode)**: el clasificador revisa cada fragmento de código antes de que se ejecute, no cada llamada a herramienta. No ve los valores calculados en tiempo de ejecución, como una ruta tomada de la salida de una búsqueda, así que mantén reglas o hooks para las llamadas que debas controlar. Aun así, se te puede [pedir confirmación cuando se inicia código nuevo mientras se ejecuta código anterior](#permission-prompt-with-a-countdown)

153* **Otros [modos de permisos](https://code.claude.com/docs/es/permission-modes.md)**: el código se inicia sin revisión, y se te pide confirmación para cada llamada a herramienta que te la pediría en ese modo

154 

155Para revisar el código en sí, escribe un hook `PreToolUse` que coincida con `REPL`, la herramienta que ejecuta el código de Claude, y lee el JavaScript de `tool_input.code`.

156 

157> [!WARNING]

158>

159> Las reglas de Bash coinciden con el texto del comando, por lo que Claude puede ejecutar un comando denegado [en una forma que la regla no detecta](https://code.claude.com/docs/es/permissions.md#bash-rule-limits), con o sin Code Mode. Para límites que no dependen del texto del comando, consulta [sandboxing](https://code.claude.com/docs/es/sandboxing.md).

160 

161### Código de larga duración

162 

163Mientras el código ejecuta una compilación o una prueba larga, Claude espera a que termine o lo deja continuar en segundo plano:

164 

165* **Esperando**: Claude responde después de que el código termina, y el código se detiene después de diez minutos, incluido el tiempo que pasas en las solicitudes de permiso

166* **Segundo plano**: puedes seguir hablando con Claude, y el código puede ejecutarse hasta dos horas

167 

168Para código en segundo plano, inicia tu sesión en el modo automático o en el modo `bypassPermissions`. Si Claude sigue esperando, comprueba tu modo actual y cómo iniciaste la sesión:

169 

170* **Cambiaste a otro modo**: presiona `Shift+Tab` hasta volver al modo en el que iniciaste

171* **Iniciaste en otro modo, o elegiste la sesión de la lista de `claude --resume`**: si [el modo automático está disponible](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode) para ti, sal y luego ejecuta `claude --continue --permission-mode auto` con Code Mode activado

172* **Pasaste nombres de herramientas a `--tools`**: vuelve a iniciar en el modo automático sin ese flag

173 

174## Solución de problemas

175 

176### Code Mode no se inicia

177 

178`Code Mode (experimental) isn't available` cerca de la parte superior de la sesión significa que Claude Code se inició sin Code Mode. El motivo aparece en la misma línea, y `/status` también lo muestra. Busca el motivo en esta tabla, haz el cambio e inicia una sesión nueva. Para un motivo que no aparezca en la lista, revisa los [requisitos](#requirements).

179 

180| El motivo incluye | Qué hacer |

181| :- | :- |

182| `it isn't open to your account yet` | Si tu versión es anterior a v2.1.323, [actualiza](#try-code-mode). De lo contrario, comprueba tu conexión de red y vuelve a iniciar. Si el motivo persiste, vuelve a intentarlo otro día |

183| `it only works with the Anthropic API` | Elimina los ajustes que enrutan las solicitudes a través de un proveedor de nube, un gateway o un `ANTHROPIC_BASE_URL` personalizado |

184| `it doesn't work with an API key helper` | Elimina `apiKeyHelper`, `ANTHROPIC_AUTH_TOKEN` y cualquier encabezado `Authorization` o `X-Api-Key` en `ANTHROPIC_CUSTOM_HEADERS`. Luego inicia sesión o establece `ANTHROPIC_API_KEY` |

185| `it only works with Opus 5.5, Sonnet 5.5 and later models` | Inicia con un [modelo compatible](#requirements), por ejemplo con `--model opus`. Haiku 5.5 y Fable 5.2 también funcionan |

186| `it doesn't work in background jobs` | Inicia en primer plano, sin `--remote-control` |

187| `it needs settings that Claude Code downloads from Anthropic` | Elimina la variable que [desactiva la obtención de feature flags](https://code.claude.com/docs/es/env-vars.md#features-that-need-feature-flag-fetching), como `DISABLE_TELEMETRY` |

188| `OpenTelemetry is on` | Elimina `CLAUDE_CODE_ENABLE_TELEMETRY` y `ENABLE_BETA_TRACING_DETAILED` si puedes trabajar sin la [exportación de OpenTelemetry](https://code.claude.com/docs/es/monitoring-usage.md) |

189| `it doesn't yet work with an installed mod` | Desactiva el [mod](https://code.claude.com/docs/es/plugins/mods/overview.md) que revisa las llamadas a herramientas |

190| `it can't be used together with agent teams yet` | Elimina `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` |

191| `this launch's tool options` | Inicia sin `--restricted`, agrega `REPL` a `--tools` y elimina `REPL` de `--disallowedTools` y de tus reglas `deny` |

192| `couldn't save your answer` | Haz que `~/.claude.json` tenga permisos de escritura |

193| `your organization's settings don't allow it` | Pregunta a tu administrador por el [ajuste administrado](#block-code-mode-for-your-organization) |

194 

195Si no ves ninguna línea sobre Code Mode, ejecuta `claude --version`. Si tu versión es anterior a v2.1.323, actualiza. Luego comprueba que `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` sea `1` en tu shell o en tu configuración de usuario, y elimina cualquier `0` de ahí y de cualquier archivo de `--settings`.

196 

197### Solicitud de permiso con cuenta regresiva

198 

199Cuando Claude inicia más código en el modo automático mientras el código anterior aún se está ejecutando, el código anterior pierde la revisión del clasificador. Claude Code entonces te pregunta por las llamadas restantes del código anterior que necesitarían una revisión. Sin un IDE conectado, la solicitud muestra una cuenta regresiva:

200 

201```text theme={null}

202Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

203```

204 

205Responde antes de que termine la cuenta regresiva. De lo contrario, esa llamada se rechaza, y las llamadas posteriores que mostrarían una cuenta regresiva se rechazan sin solicitud. Para volver a ver las solicitudes, envía un mensaje a Claude.

206 

207### Llamada a herramienta rechazada por un hook

208 

209Si Claude informa de una llamada a herramienta rechazada, pídele el texto del error. Estos errores significan que un hook `PreToolUse` no dio una decisión, lo que rechaza la llamada incluso cuando [`onFailure`](https://code.claude.com/docs/es/hooks#block-the-action-when-a-hook-fails) no está establecido:

210 

211* **`the hook failed`**: en una llamada desde el código de Claude, tu hook no pudo iniciarse, fue terminado, salió con 126, 127 o un código superior a 128, o devolvió un error HTTP o una salida no válida. Corrige el hook

212* **`the hook did not finish`**: se agotó el tiempo de espera de tu hook en una llamada desde el código de Claude, o en cualquier otra llamada a herramienta una vez que Claude ha ejecutado código en la sesión. Aumenta el [`timeout`](https://code.claude.com/docs/es/hooks#common-fields) del hook

213 

214Para permitir que las llamadas continúen cuando un hook `command` o `http` falla o se agota su tiempo de espera, establece `"onFailure": "continue"` en él. Si un hook `command` sale con un código común como 1, la llamada continúa, a menos que establezcas `"onFailure": "block"`.

215 

216### Salida de código retenida por un hook

217 

218Si Claude informa del motivo de bloqueo de un hook donde esperabas la salida del código de Claude, revisa tus hooks [`UserPromptSubmit`](https://code.claude.com/docs/es/hooks#userpromptsubmit). Cuando [el código puede ejecutarse en segundo plano](#long-running-code), los hooks `command`, `http` y `mcp_tool` en ese evento también se ejecutan sobre la salida del código. Para dejar pasar la salida, cambia el hook para que no bloquee cuando `source` en su entrada sea `poll_event`.

219 

220## Recursos relacionados

221 

222* [Modos de permisos](https://code.claude.com/docs/es/permission-modes.md): compara el modo automático con los modos que te piden confirmación

223* [Referencia de hooks](https://code.claude.com/docs/es/hooks.md): escribe hooks `PreToolUse` y `UserPromptSubmit`

224* [Configuración administrada](https://code.claude.com/docs/es/managed-settings.md): aplica una configuración en toda una organización

35La tabla siguiente enumera todos los comandos incluidos en Claude Code. La mayoría son comandos integrados cuyo comportamiento está codificado en la CLI. Se marcan dos tipos de entradas:35La tabla siguiente enumera todos los comandos incluidos en Claude Code. La mayoría son comandos integrados cuyo comportamiento está codificado en la CLI. Se marcan dos tipos de entradas:

36 36 

37* **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills)**: un skill incluido. Funciona como los skills que escribes tú mismo: un prompt que se le entrega a Claude.37* **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills)**: un skill incluido. Funciona como los skills que escribes tú mismo: un prompt que se le entrega a Claude.

38 * `/verify` solo se ejecuta cuando lo invocas.

39* **[Workflow](https://code.claude.com/docs/es/workflows.md#bundled-workflows)**: un [flujo de trabajo dinámico](https://code.claude.com/docs/es/workflows.md) incluido que distribuye el trabajo entre muchos subagentes y se ejecuta en segundo plano.38* **[Workflow](https://code.claude.com/docs/es/workflows.md#bundled-workflows)**: un [flujo de trabajo dinámico](https://code.claude.com/docs/es/workflows.md) incluido que distribuye el trabajo entre muchos subagentes y se ejecuta en segundo plano.

40 * `/deep-research` solo se ejecuta cuando lo invocas.

41 39 

42Para agregar tus propios comandos, consulta [skills](https://code.claude.com/docs/es/skills.md).40Para agregar tus propios comandos, consulta [skills](https://code.claude.com/docs/es/skills.md).

43 41 

149| `/stats` | Alias de `/usage`. Se abre en la pestaña Stats |147| `/stats` | Alias de `/usage`. Se abre en la pestaña Stats |

150| `/status` | Abre la interfaz de Configuración en la pestaña Status, que muestra la versión, el modelo, la cuenta y la conectividad. Una fila `Session kind` indica `background job · attached` o `background job · unattended` en una [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md), según si hay una terminal adjunta, e `interactive` en cualquier otra sesión. Antes de v2.1.221, `/status` no mostraba esta fila. Funciona mientras Claude está respondiendo |148| `/status` | Abre la interfaz de Configuración en la pestaña Status, que muestra la versión, el modelo, la cuenta y la conectividad. Una fila `Session kind` indica `background job · attached` o `background job · unattended` en una [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md), según si hay una terminal adjunta, e `interactive` en cualquier otra sesión. Antes de v2.1.221, `/status` no mostraba esta fila. Funciona mientras Claude está respondiendo |

151| `/statusline` | Configura la [línea de estado](https://code.claude.com/docs/es/statusline.md) de Claude Code. Describe lo que quieres, o ejecútalo sin argumentos para configurarla automáticamente a partir del prompt de tu shell |149| `/statusline` | Configura la [línea de estado](https://code.claude.com/docs/es/statusline.md) de Claude Code. Describe lo que quieres, o ejecútalo sin argumentos para configurarla automáticamente a partir del prompt de tu shell |

152| `/stickers` | Pide stickers de Claude Code |150| `/stickers` | Comprueba la disponibilidad de stickers de Claude Code |

153| `/stop` | Detiene la [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md) a la que estás adjunto, o aquella a la que lo envías como [respuesta desde el vistazo](https://code.claude.com/docs/es/agent-view.md#peek-and-reply); se conservan la transcripción y cualquier worktree. Para separarte sin detenerla, usa `/exit` o presiona `←` |151| `/stop` | Detiene la [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md) a la que estás adjunto, o aquella a la que lo envías como [respuesta desde el vistazo](https://code.claude.com/docs/es/agent-view.md#peek-and-reply); se conservan la transcripción y cualquier worktree. Para separarte sin detenerla, usa `/exit` o presiona `←` |

154| `/subtask <task>` | Inicia un [subagente bifurcado](https://code.claude.com/docs/es/sub-agents.md#fork-the-current-conversation): un subagente en segundo plano que hereda la conversación completa y trabaja en la tarea mientras tú sigues trabajando. Su resultado vuelve a esta conversación cuando termina. Para copiar la conversación en una sesión en segundo plano separada, usa `/fork` en su lugar. Cuando la [vista de agentes está desactivada](https://code.claude.com/docs/es/agent-view.md#turn-off-agent-view), `/subtask` no está disponible y `/fork` inicia en su lugar el subagente bifurcado |152| `/subtask <task>` | Inicia un [subagente bifurcado](https://code.claude.com/docs/es/sub-agents.md#fork-the-current-conversation): un subagente en segundo plano que hereda la conversación completa y trabaja en la tarea mientras tú sigues trabajando. Su resultado vuelve a esta conversación cuando termina. Para copiar la conversación en una sesión en segundo plano separada, usa `/fork` en su lugar. Cuando la [vista de agentes está desactivada](https://code.claude.com/docs/es/agent-view.md#turn-off-agent-view), `/subtask` no está disponible y `/fork` inicia en su lugar el subagente bifurcado |

155| `/tasks` | Consulta y administra el trabajo en segundo plano de la sesión actual, incluidos los subagentes que ya terminaron. También disponible como `/bashes` |153| `/tasks` | Consulta y administra el trabajo en segundo plano de la sesión actual, incluidos los subagentes que ya terminaron. También disponible como `/bashes` |

161| `/ultraplan <prompt>` | Eliminado. Usa el [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) en su lugar. Anteriormente enviaba una tarea de planificación a una [sesión en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md) para revisarla en tu navegador |159| `/ultraplan <prompt>` | Eliminado. Usa el [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) en su lugar. Anteriormente enviaba una tarea de planificación a una [sesión en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md) para revisarla en tu navegador |

162| `/ultrareview [PR or branch]` | Ejecuta una revisión de código profunda y multiagente en un sandbox en la nube con [ultrareview](https://code.claude.com/docs/es/ultrareview.md). Pasa una referencia de PR para revisar ese pull request, o una rama base o un commit para cambiar la base de comparación. La invocación preferida es `/code-review ultra`, y `/ultrareview` es un alias. Incluye 3 ejecuciones gratuitas en Pro, Max y Ultra; después requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |160| `/ultrareview [PR or branch]` | Ejecuta una revisión de código profunda y multiagente en un sandbox en la nube con [ultrareview](https://code.claude.com/docs/es/ultrareview.md). Pasa una referencia de PR para revisar ese pull request, o una rama base o un commit para cambiar la base de comparación. La invocación preferida es `/code-review ultra`, y `/ultrareview` es un alias. Incluye 3 ejecuciones gratuitas en Pro, Max y Ultra; después requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills).** Describe un cambio de configuración, como permitir un comando, establecer una variable de entorno o agregar un [hook](https://code.claude.com/docs/es/hooks.md), y Claude edita el archivo [`settings.json`](https://code.claude.com/docs/es/settings) correspondiente. Para opciones como el tema y el modelo, usa `/config` en su lugar |161| `/update-config [request]` | **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills).** Describe un cambio de configuración, como permitir un comando, establecer una variable de entorno o agregar un [hook](https://code.claude.com/docs/es/hooks.md), y Claude edita el archivo [`settings.json`](https://code.claude.com/docs/es/settings) correspondiente. Para opciones como el tema y el modelo, usa `/config` en su lugar |

164| `/upgrade` | Abre la página de mejora de plan en tu navegador para cambiar a un nivel de plan superior. Cuando el navegador no se abre, el comando muestra una solicitud de inicio de sesión sin imprimir la URL |162| `/upgrade` | Abre la página de mejora de plan en tu navegador para cambiar a un nivel de plan superior. Cuando ningún navegador puede abrir la página, por ejemplo a través de SSH, el comando imprime la URL de la página encima de su solicitud de inicio de sesión. Imprimir la URL requiere Claude Code v2.1.323 o posterior |

165| `/usage` | Muestra el costo de la sesión, los límites de uso del plan y las estadísticas de actividad. En un plan Pro, Max, Ultra, Team o Enterprise, incluye un [desglose de lo que cuenta para los límites de tu plan](https://code.claude.com/docs/es/costs.md#plan-usage-breakdown). Detrás de un gateway de Claude apps que registra el gasto, muestra [tu gasto a través del gateway](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code). `/cost` y `/stats` son alias |163| `/usage` | Muestra el costo de la sesión, los límites de uso del plan y las estadísticas de actividad. En un plan Pro, Max, Ultra, Team o Enterprise, incluye un [desglose de lo que cuenta para los límites de tu plan](https://code.claude.com/docs/es/costs.md#plan-usage-breakdown). Detrás de un gateway de Claude apps que registra el gasto, muestra [tu gasto a través del gateway](https://code.claude.com/docs/es/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code). `/cost` y `/stats` son alias |

166| `/usage-credits` | Configura créditos de uso, o solicítalos a tu administrador, cuando alcanzas un límite. Abre tu [configuración de facturación de créditos de uso](https://code.claude.com/docs/es/costs.md#add-usage-credits-to-your-subscription) en el navegador, excepto que los miembros de Team y Enterprise sin acceso a facturación envían en su lugar una solicitud de créditos de uso a su administrador desde la CLI, después de confirmar en un diálogo que la solicitud notifica a sus administradores. Cuando ningún navegador puede abrir la página de facturación, por ejemplo a través de SSH, el comando imprime en su lugar la URL que debes visitar; esto requiere Claude Code v2.1.205 o posterior, y las versiones anteriores no mostraban nada en ese caso. Anteriormente `/extra-usage` |164| `/usage-credits` | Configura créditos de uso, o solicítalos a tu administrador, cuando alcanzas un límite. Abre tu [configuración de facturación de créditos de uso](https://code.claude.com/docs/es/costs.md#add-usage-credits-to-your-subscription) en el navegador. Los miembros de Team y Enterprise sin acceso a facturación envían en su lugar una solicitud de créditos de uso a su administrador desde la CLI. En una terminal donde ningún navegador puede abrir la página, por ejemplo a través de SSH, el comando imprime la URL. Imprimirla requiere Claude Code v2.1.205 o posterior. Anteriormente `/extra-usage` |

167| `/verify` | **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills).** Confirma que un cambio de código hace lo que debe compilando la app de tu proyecto, ejecutándola y observando el resultado, en lugar de depender de pruebas o comprobaciones de tipos. Consulta [Ejecutar y verificar tu app](https://code.claude.com/docs/es/skills.md#run-and-verify-your-app) |165| `/verify` | **[Skill](https://code.claude.com/docs/es/skills.md#bundled-skills).** Confirma que un cambio de código hace lo que debe compilando la app de tu proyecto, ejecutándola y observando el resultado, en lugar de depender de pruebas o comprobaciones de tipos. Consulta [Ejecutar y verificar tu app](https://code.claude.com/docs/es/skills.md#run-and-verify-your-app) |

168| `/vim` | Se eliminó en v2.1.92. Para alternar entre los modos de edición Vim y Normal, usa `/config` → Editor mode |166| `/vim` | Se eliminó en v2.1.92. Para alternar entre los modos de edición Vim y Normal, usa `/config` → Editor mode |

169| `/voice [hold\|tap\|off]` | Activa o desactiva el [dictado por voz](https://code.claude.com/docs/es/voice-dictation.md), o habilítalo en un modo específico. Requiere una cuenta de Claude.ai |167| `/voice [hold\|tap\|off]` | Activa o desactiva el [dictado por voz](https://code.claude.com/docs/es/voice-dictation.md), o habilítalo en un modo específico. Requiere una cuenta de Claude.ai |

2261 2261 

2262La aplicación Desktop carga servidores MCP de `claude_desktop_config.json` en sesiones de la pestaña Code local, junto con servidores de `~/.claude.json` y `.mcp.json`. Un servidor que definas en `claude_desktop_config.json` está disponible tanto en la superficie de chat de Desktop como en sesiones de la pestaña Code local.2262La aplicación Desktop carga servidores MCP de `claude_desktop_config.json` en sesiones de la pestaña Code local, junto con servidores de `~/.claude.json` y `.mcp.json`. Un servidor que definas en `claude_desktop_config.json` está disponible tanto en la superficie de chat de Desktop como en sesiones de la pestaña Code local.

2263 2263 

2264Si defines el mismo nombre de servidor en `claude_desktop_config.json` y en `~/.claude.json` o `.mcp.json`, la pestaña Code en sesiones locales se conecta una vez y usa la definición de `claude_desktop_config.json`.

2265 

2266La aplicación también reentrega servidores stdio de `~/.claude.json` a la CLI integrada en sesiones locales. Cuando el nivel superior de `~/.claude.json` (alcance de usuario) y `.mcp.json` definen el mismo nombre de servidor stdio, la pestaña Code usa la definición de `~/.claude.json`, apartándose de la [jerarquía de alcance](https://code.claude.com/docs/es/mcp.md#scope-hierarchy-and-precedence) de la CLI.

2267 

2268> [!NOTE]2264> [!NOTE]

2269>2265>

2270> La CLI independiente no lee `claude_desktop_config.json`. En macOS y WSL, ejecuta `claude mcp add-from-claude-desktop` para copiar esos servidores en `~/.claude.json`. Consulta [Importar servidores MCP desde Claude Desktop](https://code.claude.com/docs/es/mcp.md#import-mcp-servers-from-claude-desktop) para el flujo de importación y las opciones de alcance.2266> La CLI independiente no lee `claude_desktop_config.json`. En macOS y WSL, ejecuta `claude mcp add-from-claude-desktop` para copiar esos servidores en `~/.claude.json`. Consulta [Importar servidores MCP desde Claude Desktop](https://code.claude.com/docs/es/mcp.md#import-mcp-servers-from-claude-desktop) para el flujo de importación y las opciones de alcance.

71 71 

72Lanza **Claude** desde tu lanzador de aplicaciones, o ejecuta `claude-desktop` desde una terminal, e inicia sesión con tu cuenta de Anthropic.72Lanza **Claude** desde tu lanzador de aplicaciones, o ejecuta `claude-desktop` desde una terminal, e inicia sesión con tu cuenta de Anthropic.

73 73 

74La aplicación de Linux inicia sesión de la misma manera que en macOS y Windows: con una suscripción a claude.ai, o a través del SSO de tu organización. Para la autenticación con clave de API, usa la [CLI](https://code.claude.com/docs/es/quickstart.md). Para usar Desktop con Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry o un gateway de LLM en su lugar, consulta [Claude Desktop en 3P](https://claude.com/docs/third-party/claude-desktop/overview). Para servidores proxy y autoridades de certificación personalizadas en esos despliegues, consulta [configuración de red](https://code.claude.com/docs/es/network-config.md).74La aplicación de Linux inicia sesión de la misma manera que en macOS y Windows: con una suscripción a claude.ai, o a través del SSO de tu organización. Para usar Desktop con una clave de API de Claude, Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry o un gateway de LLM en su lugar, consulta [Claude Desktop en 3P](https://claude.com/docs/third-party/claude-desktop/overview). Para servidores proxy y autoridades de certificación personalizadas en esos despliegues, consulta [configuración de red](https://code.claude.com/docs/es/network-config.md).

75 75 

76### Instalar desde un archivo descargado76### Instalar desde un archivo descargado

77 77 

83 83 

84**8. Elige el modo de permisos y el modelo**84**8. Elige el modo de permisos y el modelo**

85 85 

86En la barra de herramientas del cuadro de instrucciones, selecciona un [modo de permisos](#permissions-for-scheduled-tasks) y un modelo. Si no los cambias, las ejecuciones usan tu configuración de Claude Code y el modelo predeterminado.86En la barra de herramientas del cuadro de instrucciones, selecciona un [modo de permisos](#permissions-for-scheduled-tasks) y un modelo.

87 

88* **Modo de permisos**: si no lo cambias, las ejecuciones usan tu configuración de Claude Code.

89* **Modelo**: si el menú de modelos muestra **Default · Set by admin** y no eliges otro modelo, las ejecuciones usan el modelo que tu organización estableció en la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md). Una [ejecución de recuperación](#missed-runs) que se inicia al abrir la aplicación puede usar en su lugar el [modelo predeterminado en tiempo de ejecución para tu cuenta](https://code.claude.com/docs/es/model-config.md#default-model-setting).

87 90 

88**9. Crea la tarea**91**9. Crea la tarea**

89 92 

90Haz clic en **Create**. Si aún no has confiado en la carpeta, Desktop te pide que confíes en ella en este momento. Se abre la página de detalles de la tarea.93Haz clic en **Create**. Si aún no has confiado en la carpeta, Desktop te pide que confíes en ella en este momento. Se abre la página de detalles de la tarea.

91 94 

95Para ver qué modelo representa **Default · Set by admin**, haz clic en **Run now** en la página de detalles para ejecutar la tarea de inmediato. Luego [abre la sesión de la ejecución](#find-a-runs-session), donde la fila debajo del cuadro del prompt muestra el nombre del modelo.

96 

92En la página de detalles, haz clic en el ícono de lápiz para abrir el [formulario **Edit**](#manage-scheduled-tasks). Ahí puedes cambiar la **Description** que Desktop completó a partir de tus instrucciones, seleccionar **Worktree** o cambiar la programación a **Manual** o **Custom**.97En la página de detalles, haz clic en el ícono de lápiz para abrir el [formulario **Edit**](#manage-scheduled-tasks). Ahí puedes cambiar la **Description** que Desktop completó a partir de tus instrucciones, seleccionar **Worktree** o cambiar la programación a **Manual** o **Custom**.

93 98 

94También puedes crear una tarea describiendo lo que deseas en cualquier sesión. Por ejemplo, "configura una revisión de código diaria que se ejecute cada mañana a las 9am" crea una tarea recurrente. Una solicitud como "recuérdame mañana a las 3pm que verifique el deploy" crea una tarea única que se desactiva después de ejecutarse.99También puedes crear una tarea describiendo lo que deseas en cualquier sesión. Por ejemplo, "configura una revisión de código diaria que se ejecute cada mañana a las 9am" crea una tarea recurrente. Una solicitud como "recuérdame mañana a las 3pm que verifique el deploy" crea una tarea única que se desactiva después de ejecutarse.

181 186 

182Para permitir que una tarea cambie su propia programación o prompt con la herramienta MCP `update_scheduled_task`, haz clic en **Run now** y aprueba la llamada cada vez.187Para permitir que una tarea cambie su propia programación o prompt con la herramienta MCP `update_scheduled_task`, haz clic en **Run now** y aprueba la llamada cada vez.

183 188 

184Para editar el prompt de una tarea en disco, abra `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (o bajo [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/es/env-vars) si está configurado). El archivo utiliza frontmatter YAML para `name` y `description`, con el prompt como cuerpo. Los cambios surten efecto en la próxima ejecución. La programación, carpeta, modelo y estado habilitado no están en este archivo: cámbielos a través del formulario Edit o pídale a Claude.189Para editar el prompt de una tarea en disco, abre `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (o bajo [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/es/env-vars) si está configurado). El archivo utiliza frontmatter YAML para `name` y `description`, con el prompt como cuerpo. Los cambios surten efecto en la próxima ejecución. La programación, la carpeta y el estado habilitado no están en este archivo: cámbialos a través del formulario Edit o pídeselo a Claude.

185 190 

186## Recursos relacionados191## Recursos relacionados

187 192 

211| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescribe la [conexión automática con el IDE](https://code.claude.com/docs/es/vs-code.md). De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de la terminal integrada de un IDE compatible. Establécela en `false` para evitarlo. Establécela en `true` para forzar un intento de conexión cuando falla la detección automática, por ejemplo cuando tmux oculta la terminal principal. Tiene precedencia sobre el ajuste de configuración global [`autoConnectIde`](https://code.claude.com/docs/es/settings-reference#autoconnectide) |211| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sobrescribe la [conexión automática con el IDE](https://code.claude.com/docs/es/vs-code.md). De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de la terminal integrada de un IDE compatible. Establécela en `false` para evitarlo. Establécela en `true` para forzar un intento de conexión cuando falla la detección automática, por ejemplo cuando tmux oculta la terminal principal. Tiene precedencia sobre el ajuste de configuración global [`autoConnectIde`](https://code.claude.com/docs/es/settings-reference#autoconnectide) |

212| `CLAUDE_CODE_AUTO_MODE_MODEL` | Establece el modelo para las solicitudes del clasificador que Claude Code envía en el [modo automático](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode). Usa un ID de modelo completo como `claude-sonnet-4-6`. Para los casos en que Claude Code la ignora, consulta [Elegir el modelo del clasificador](https://code.claude.com/docs/es/permission-modes.md#choose-the-classifier-model). Requiere Claude Code v2.1.302 o posterior |212| `CLAUDE_CODE_AUTO_MODE_MODEL` | Establece el modelo para las solicitudes del clasificador que Claude Code envía en el [modo automático](https://code.claude.com/docs/es/permission-modes.md#eliminate-prompts-with-auto-mode). Usa un ID de modelo completo como `claude-sonnet-4-6`. Para los casos en que Claude Code la ignora, consulta [Elegir el modelo del clasificador](https://code.claude.com/docs/es/permission-modes.md#choose-the-classifier-model). Requiere Claude Code v2.1.302 o posterior |

213| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla si Claude Code pide al servidor que [revise las acciones del modo automático](https://code.claude.com/docs/es/permission-modes.md#server-side-classifier-review). Establécela en `0` para usar en su lugar las propias solicitudes de clasificador de Claude Code. En una conexión directa a la API de Anthropic, requiere v2.1.281 o posterior. La sección enlazada indica qué sesiones consultan al servidor cuando la variable no está establecida, y desde qué versión. Requiere Claude Code v2.1.271 o posterior |213| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controla si Claude Code pide al servidor que [revise las acciones del modo automático](https://code.claude.com/docs/es/permission-modes.md#server-side-classifier-review). Establécela en `0` para usar en su lugar las propias solicitudes de clasificador de Claude Code. En una conexión directa a la API de Anthropic, requiere v2.1.281 o posterior. La sección enlazada indica qué sesiones consultan al servidor cuando la variable no está establecida, y desde qué versión. Requiere Claude Code v2.1.271 o posterior |

214| `CLAUDE_CODE_AUTOMOUNT_ROOTS` | Carpetas raíz de automontaje que Claude Code debe omitir cuando busca, en las carpetas por encima de tu directorio de trabajo, archivos como `CLAUDE.md`, skills y `.mcp.json`. Establécela cuando esas búsquedas tengan que esperar a tu automontador. Separa varias rutas con `:` en Unix o `;` en Windows, e indica cada una como una ruta absoluta que no contenga ningún enlace simbólico. Requiere Claude Code v2.1.323 o posterior |

214| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tiempo en milisegundos que Claude Code espera a que la cadena predeterminada de proveedores de credenciales de AWS produzca credenciales antes de que la solicitud falle con [`AWS default-chain credential resolve timed out`](https://code.claude.com/docs/es/errors#aws-default-chain-credential-resolve-timed-out) (predeterminado: `60000`). Auméntalo cuando un paso de tu cadena legítimamente necesite más tiempo, como un inicio de sesión SSO basado en navegador con MFA a través de un wrapper como `aws-vault`. Se aplica en Amazon Bedrock, [Claude Platform on AWS](https://code.claude.com/docs/es/claude-platform-on-aws.md) y el [endpoint de Mantle](https://code.claude.com/docs/es/amazon-bedrock.md#use-the-mantle-endpoint). Consulta [almacenamiento en caché de credenciales y tiempo de espera de resolución](https://code.claude.com/docs/es/amazon-bedrock.md#credential-caching-and-resolution-timeout). Requiere Claude Code v2.1.207 o posterior |215| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tiempo en milisegundos que Claude Code espera a que la cadena predeterminada de proveedores de credenciales de AWS produzca credenciales antes de que la solicitud falle con [`AWS default-chain credential resolve timed out`](https://code.claude.com/docs/es/errors#aws-default-chain-credential-resolve-timed-out) (predeterminado: `60000`). Auméntalo cuando un paso de tu cadena legítimamente necesite más tiempo, como un inicio de sesión SSO basado en navegador con MFA a través de un wrapper como `aws-vault`. Se aplica en Amazon Bedrock, [Claude Platform on AWS](https://code.claude.com/docs/es/claude-platform-on-aws.md) y el [endpoint de Mantle](https://code.claude.com/docs/es/amazon-bedrock.md#use-the-mantle-endpoint). Consulta [almacenamiento en caché de credenciales y tiempo de espera de resolución](https://code.claude.com/docs/es/amazon-bedrock.md#credential-caching-and-resolution-timeout). Requiere Claude Code v2.1.207 o posterior |

215| `CLAUDE_CODE_BASH_EDIT_DIFF` | Establécela en `0` para desactivar el [diff de los archivos que cambiaron mientras se ejecutaba un comando de Bash](https://code.claude.com/docs/es/hooks.md#bash), o en `1` para registrarlo en todos los modos de permisos. Tiene precedencia sobre el ajuste [`bashEditDiffEnabled`](https://code.claude.com/docs/es/settings-reference#basheditdiffenabled). Requiere Claude Code v2.1.269 o posterior |216| `CLAUDE_CODE_BASH_EDIT_DIFF` | Establécela en `0` para desactivar el [diff de los archivos que cambiaron mientras se ejecutaba un comando de Bash](https://code.claude.com/docs/es/hooks.md#bash), o en `1` para registrarlo en todos los modos de permisos. Tiene precedencia sobre el ajuste [`bashEditDiffEnabled`](https://code.claude.com/docs/es/settings-reference#basheditdiffenabled). Requiere Claude Code v2.1.269 o posterior |

216| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Establécela en `0` para que una sesión no interactiva informe un estado inactivo a su host al final de cada turno, incluso mientras aún se ejecuta trabajo en segundo plano. De forma predeterminada, la sesión sigue informando un estado de ejecución después del final del turno mientras el trabajo en segundo plano, como un agente en segundo plano o una ejecución de un [flujo de trabajo](https://code.claude.com/docs/es/workflows.md), sigue activo. Esto evita que un host que vigila el estado, como una lista de sesiones remotas, anuncie que Claude espera tu respuesta en medio del trabajo. Los comandos de shell en segundo plano, como un servidor de desarrollo, no mantienen el estado de ejecución. El estado de ejecución predeterminado y la exclusión con `0` requieren Claude Code v2.1.269 o posterior; en versiones anteriores, establece `1` para mantener el estado de ejecución |217| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Establécela en `0` para que una sesión no interactiva informe un estado inactivo a su host al final de cada turno, incluso mientras aún se ejecuta trabajo en segundo plano. De forma predeterminada, la sesión sigue informando un estado de ejecución después del final del turno mientras el trabajo en segundo plano, como un agente en segundo plano o una ejecución de un [flujo de trabajo](https://code.claude.com/docs/es/workflows.md), sigue activo. Esto evita que un host que vigila el estado, como una lista de sesiones remotas, anuncie que Claude espera tu respuesta en medio del trabajo. Los comandos de shell en segundo plano, como un servidor de desarrollo, no mantienen el estado de ejecución. El estado de ejecución predeterminado y la exclusión con `0` requieren Claude Code v2.1.269 o posterior; en versiones anteriores, establece `1` para mantener el estado de ejecución |

298| `CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS` | Establécela en `1` para [ejecutar comandos `rm` peligrosos sin solicitud](https://code.claude.com/docs/es/permission-modes#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode) en el modo `bypassPermissions`, lo que elimina una solicitud de seguridad para los borrados destructivos. La sección enlazada indica dónde no tiene efecto. [Establécela en el entorno que inicia Claude Code](#set-variables-in-your-shell), porque Claude Code [la ignora en un bloque `env` de la configuración](https://code.claude.com/docs/es/settings-reference#variables-claude-code-ignores-in-env). Requiere Claude Code v2.1.311 o posterior |299| `CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS` | Establécela en `1` para [ejecutar comandos `rm` peligrosos sin solicitud](https://code.claude.com/docs/es/permission-modes#turn-off-the-critical-path-removal-prompt-in-bypasspermissions-mode) en el modo `bypassPermissions`, lo que elimina una solicitud de seguridad para los borrados destructivos. La sección enlazada indica dónde no tiene efecto. [Establécela en el entorno que inicia Claude Code](#set-variables-in-your-shell), porque Claude Code [la ignora en un bloque `env` de la configuración](https://code.claude.com/docs/es/settings-reference#variables-claude-code-ignores-in-env). Requiere Claude Code v2.1.311 o posterior |

299| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tiempo en milisegundos que se espera después de que el bucle de consultas queda inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que usan el modo SDK |300| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tiempo en milisegundos que se espera después de que el bucle de consultas queda inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que usan el modo SDK |

300| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Establécela en `1` para habilitar los [equipos de agentes](https://code.claude.com/docs/es/agent-teams.md). Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada |301| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Establécela en `1` para habilitar los [equipos de agentes](https://code.claude.com/docs/es/agent-teams.md). Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada |

302| `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` | Establécela en `1` para iniciar las sesiones en [Code Mode](https://code.claude.com/docs/es/code-mode.md), una función experimental. Establécela en `0` para mantenerlo desactivado, o en la configuración administrada para [bloquearlo para una organización](https://code.claude.com/docs/es/code-mode.md#block-code-mode-for-your-organization). La variable [no cuenta en todos los archivos de configuración](https://code.claude.com/docs/es/settings-reference.md#variables-claude-code-ignores-in-env). Consulta los [requisitos de versión y de cuenta](https://code.claude.com/docs/es/code-mode.md#requirements) |

301| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON que se combina en el nivel superior de los cuerpos de las solicitudes al modelo, excepto en algunas solicitudes fuera de la conversación, como las comprobaciones de `/model`. Útil para pasar parámetros específicos del proveedor que Claude Code no expone directamente. Un valor exportado en tu shell también se aplica a las [sesiones en segundo plano](https://code.claude.com/docs/es/agent-view.md) que inicias con `claude agents` o `--bg`. Antes de v2.1.206, las sesiones en segundo plano ignoraban un valor exportado en el shell y usaban la copia que hubiera heredado el proceso supervisor en segundo plano |303| `CLAUDE_CODE_EXTRA_BODY` | Objeto JSON que se combina en el nivel superior de los cuerpos de las solicitudes al modelo, excepto en algunas solicitudes fuera de la conversación, como las comprobaciones de `/model`. Útil para pasar parámetros específicos del proveedor que Claude Code no expone directamente. Un valor exportado en tu shell también se aplica a las [sesiones en segundo plano](https://code.claude.com/docs/es/agent-view.md) que inicias con `claude agents` o `--bg`. Antes de v2.1.206, las sesiones en segundo plano ignoraban un valor exportado en el shell y usaban la copia que hubiera heredado el proceso supervisor en segundo plano |

302| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescribe el límite de tokens predeterminado para la [lectura de archivos](https://code.claude.com/docs/es/tools-reference.md#large-files), que es de 25,000 tokens. Útil cuando necesitas leer archivos más grandes completos. Una lectura que Claude hace con el parámetro `allow_large` puede superar este límite cuando la ventana de contexto tiene espacio |304| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sobrescribe el límite de tokens predeterminado para la [lectura de archivos](https://code.claude.com/docs/es/tools-reference.md#large-files), que es de 25,000 tokens. Útil cuando necesitas leer archivos más grandes completos. Una lectura que Claude hace con el parámetro `allow_large` puede superar este límite cuando la ventana de contexto tiene espacio |

303| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Establécela en `1` para forzar la persistencia de la transcripción, el historial de prompts y el registro en `claude agents` incluso cuando este `claude` se haya iniciado desde dentro de otra sesión de Claude Code. Úsala cuando un valor heredado de `CLAUDE_CODE_CHILD_SESSION`, por ejemplo de una sesión de `screen` o de un lanzador en segundo plano iniciado por primera vez por la herramienta Bash de Claude Code, haga que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de la v2.1.178, Claude Code detecta automáticamente el caso de tmux e ignora el marcador heredado, por lo que tmux ya no necesita esta variable. También se respeta en la v2.1.169 y anteriores; no tiene efecto en la v2.1.170 ni en la v2.1.171, donde se eliminó la detección de sesiones anidadas que sobrescribe |305| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Establécela en `1` para forzar la persistencia de la transcripción, el historial de prompts y el registro en `claude agents` incluso cuando este `claude` se haya iniciado desde dentro de otra sesión de Claude Code. Úsala cuando un valor heredado de `CLAUDE_CODE_CHILD_SESSION`, por ejemplo de una sesión de `screen` o de un lanzador en segundo plano iniciado por primera vez por la herramienta Bash de Claude Code, haga que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de la v2.1.178, Claude Code detecta automáticamente el caso de tmux e ignora el marcador heredado, por lo que tmux ya no necesita esta variable. También se respeta en la v2.1.169 y anteriores; no tiene efecto en la v2.1.170 ni en la v2.1.171, donde se eliminó la detección de sesiones anidadas que sobrescribe |

348| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tiempo de espera en milisegundos para vaciar los spans de OpenTelemetry pendientes (predeterminado: 5000). Consulta [Monitoreo](https://code.claude.com/docs/es/monitoring-usage.md) |350| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tiempo de espera en milisegundos para vaciar los spans de OpenTelemetry pendientes (predeterminado: 5000). Consulta [Monitoreo](https://code.claude.com/docs/es/monitoring-usage.md) |

349| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para actualizar los encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulta [Encabezados dinámicos](https://code.claude.com/docs/es/monitoring-usage.md#dynamic-headers) |351| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para actualizar los encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulta [Encabezados dinámicos](https://code.claude.com/docs/es/monitoring-usage.md#dynamic-headers) |

350| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagarse (predeterminado: 2000). Auméntalo si se pierden métricas al salir. Consulta [Monitoreo](https://code.claude.com/docs/es/monitoring-usage.md) |352| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagarse (predeterminado: 2000). Auméntalo si se pierden métricas al salir. Consulta [Monitoreo](https://code.claude.com/docs/es/monitoring-usage.md) |

351| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | Retraso inicial en milisegundos, en lugar del predeterminado de 500, del backoff exponencial entre los [reintentos automáticos](https://code.claude.com/docs/es/errors.md#tune-retry-behavior) de una solicitud que la API rechaza con un error `529` de sobrecarga. Auméntalo para repartir los reintentos en un intervalo más largo cuando la API está al límite de su capacidad. Indica milisegundos enteros de 500 a 32000 con dígitos simples; Claude Code trata cualquier otro valor como no establecido. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecida en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior |353| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | Retraso inicial en milisegundos del backoff entre reintentos de una solicitud que la API rechaza con un error `529` de sobrecarga (predeterminado: 500). Auméntalo para repartir los reintentos en un intervalo más largo cuando la API está al límite de su capacidad. Indica milisegundos enteros de 500 a 32000 en dígitos simples; Claude Code trata cualquier otro valor como no establecido. Consulta [cuándo no tiene efecto](https://code.claude.com/docs/es/errors.md#tune-retry-behavior). Requiere Claude Code v2.1.292 o posterior |

352| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | Techo en milisegundos, en lugar del valor predeterminado de 32000, del backoff exponencial entre los [reintentos automáticos](https://code.claude.com/docs/es/errors.md#tune-retry-behavior) de una solicitud que la API rechaza con un error `529` de sobrecarga. Auméntalo para que los reintentos posteriores se sigan espaciando cuando la API está al límite de su capacidad. Indica milisegundos enteros de 32000 a 64000 en dígitos simples; Claude Code trata cualquier otro valor como no establecido. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecida en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior |354| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | Tope en milisegundos del backoff entre reintentos de una solicitud que la API rechaza con un error `529` de sobrecarga (predeterminado: 32000). Auméntalo para que los reintentos posteriores sigan espaciándose. Indica milisegundos enteros de 32000 a 300000 en dígitos simples; Claude Code trata cualquier otro valor como no establecido. Los valores superiores a 64000 requieren v2.1.323 o posterior. Consulta [cuándo no tiene efecto](https://code.claude.com/docs/es/errors.md#tune-retry-behavior). Requiere Claude Code v2.1.296 o posterior |

353| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Establécela en `1` para permitir que Claude Code ejecute en segundo plano el comando de actualización de tu gestor de paquetes cuando haya una nueva versión disponible. Se aplica a las instalaciones con Homebrew y WinGet. Los demás gestores de paquetes siguen mostrando el comando de actualización sin ejecutarlo. Consulta [Actualizaciones automáticas](https://code.claude.com/docs/es/setup.md#auto-updates) |355| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Establécela en `1` para permitir que Claude Code ejecute en segundo plano el comando de actualización de tu gestor de paquetes cuando haya una nueva versión disponible. Se aplica a las instalaciones con Homebrew y WinGet. Los demás gestores de paquetes siguen mostrando el comando de actualización sin ejecutarlo. Consulta [Actualizaciones automáticas](https://code.claude.com/docs/es/setup.md#auto-updates) |

354| `CLAUDE_CODE_PERFORCE_MODE` | Establécela en `1` para habilitar la protección contra escritura compatible con Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una indicación de `p4 edit <file>` si el archivo de destino no tiene el bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que `p4 edit` los abre. Esto impide que Claude Code eluda el seguimiento de cambios de Perforce |356| `CLAUDE_CODE_PERFORCE_MODE` | Establécela en `1` para habilitar la protección contra escritura compatible con Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una indicación de `p4 edit <file>` si el archivo de destino no tiene el bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que `p4 edit` los abre. Esto impide que Claude Code eluda el seguimiento de cambios de Perforce |

355| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sobrescribe el directorio raíz de los plugins. A pesar del nombre, establece el directorio padre, no la caché en sí: los marketplaces y la caché de plugins se encuentran en subdirectorios de esta ruta. El valor predeterminado es `~/.claude/plugins` |357| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sobrescribe el directorio raíz de los plugins. A pesar del nombre, establece el directorio padre, no la caché en sí: los marketplaces y la caché de plugins se encuentran en subdirectorios de esta ruta. El valor predeterminado es `~/.claude/plugins` |

370| `CLAUDE_CODE_REMOTE` | Se establece automáticamente en `true` cuando Claude Code se ejecuta como una [sesión en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md). Léela desde un hook o un script de configuración para detectar si estás en una sesión en la nube |372| `CLAUDE_CODE_REMOTE` | Se establece automáticamente en `true` cuando Claude Code se ejecuta como una [sesión en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md). Léela desde un hook o un script de configuración para detectar si estás en una sesión en la nube |

371| `CLAUDE_CODE_REMOTE_SESSION_ID` | Se establece automáticamente en las [sesiones en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md) con el ID de la sesión actual. Léela para construir un enlace de vuelta a la transcripción de la sesión. Consulta [Enlazar la salida de vuelta a la sesión](https://code.claude.com/docs/es/cloud-environments.md#link-output-back-to-the-session) |373| `CLAUDE_CODE_REMOTE_SESSION_ID` | Se establece automáticamente en las [sesiones en la nube](https://code.claude.com/docs/es/claude-code-on-the-web.md) con el ID de la sesión actual. Léela para construir un enlace de vuelta a la transcripción de la sesión. Consulta [Enlazar la salida de vuelta a la sesión](https://code.claude.com/docs/es/cloud-environments.md#link-output-back-to-the-session) |

372| `CLAUDE_CODE_RESTRICTED` | Establécela en `1` para iniciar la sesión en modo restringido, lo mismo que pasar [`--restricted`](https://code.claude.com/docs/es/cli-reference#cli-flags). Claude Code ignora esta variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.248 o posterior |374| `CLAUDE_CODE_RESTRICTED` | Establécela en `1` para iniciar la sesión en modo restringido, lo mismo que pasar [`--restricted`](https://code.claude.com/docs/es/cli-reference#cli-flags). Claude Code ignora esta variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.248 o posterior |

375| `CLAUDE_CODE_RESUME_HINT_COMMAND` | En un script contenedor que inicia Claude Code, establécela en el nombre que escribes para ejecutar el contenedor, como `mytool`. Así, una sesión local imprime `mytool --resume <session-id>` al salir en lugar de `claude --resume <session-id>`. Claude Code ignora un nombre que no coincide con `^\w[\w-]*$`. También ignora la variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.323 o posterior |

373| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Establécela en `1` para reanudar automáticamente si la sesión anterior terminó a mitad de un turno. Se usa en el modo SDK para que el modelo continúe sin que el SDK tenga que volver a enviar el prompt. Para desactivarla, elimina la variable o establécela en `0`. Para el panel de chat de VS Code, consulta [Continuar conversaciones después de recargar](https://code.claude.com/docs/es/vs-code.md#continue-conversations-after-a-reload) |376| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Establécela en `1` para reanudar automáticamente si la sesión anterior terminó a mitad de un turno. Se usa en el modo SDK para que el modelo continúe sin que el SDK tenga que volver a enviar el prompt. Para desactivarla, elimina la variable o establécela en `0`. Para el panel de chat de VS Code, consulta [Continuar conversaciones después de recargar](https://code.claude.com/docs/es/vs-code.md#continue-conversations-after-a-reload) |

374| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Antigüedad máxima en milisegundos del último mensaje de la transcripción para que una sesión que terminó a mitad de un turno continúe automáticamente al reanudarse. Cuando el último mensaje es más antiguo que este límite, Claude Code omite la reanudación automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` y su mensaje de continuación `CLAUDE_CODE_RESUME_PROMPT`, y la sesión se inicia inactiva para que continúes de forma explícita. Sin establecer o con `0` no hay límite, salvo que algunos turnos solo se reanudan dentro de las seis horas posteriores a su último mensaje, como uno que terminó con un error de la API. Un valor positivo limita todos los turnos, incluidos esos; un valor negativo o no numérico aplica un límite de una hora. Los scripts que inician agentes de larga duración pueden establecerla para que un reinicio sobre una transcripción antigua no vuelva a ejecutar un prompt obsoleto. Claude Code establece por sí mismo un límite de una hora cuando reinicia una sesión de la [vista de agentes](https://code.claude.com/docs/es/agent-view.md) que falló y que heredó su conversación de una sesión interactiva. Requiere Claude Code v2.1.211 o posterior |377| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Antigüedad máxima en milisegundos del último mensaje de la transcripción para que una sesión que terminó a mitad de un turno continúe automáticamente al reanudarse. Cuando el último mensaje es más antiguo que este límite, Claude Code omite la reanudación automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` y su mensaje de continuación `CLAUDE_CODE_RESUME_PROMPT`, y la sesión se inicia inactiva para que continúes de forma explícita. Sin establecer o con `0` no hay límite, salvo que algunos turnos solo se reanudan dentro de las seis horas posteriores a su último mensaje, como uno que terminó con un error de la API. Un valor positivo limita todos los turnos, incluidos esos; un valor negativo o no numérico aplica un límite de una hora. Los scripts que inician agentes de larga duración pueden establecerla para que un reinicio sobre una transcripción antigua no vuelva a ejecutar un prompt obsoleto. Claude Code establece por sí mismo un límite de una hora cuando reinicia una sesión de la [vista de agentes](https://code.claude.com/docs/es/agent-view.md) que falló y que heredó su conversación de una sesión interactiva. Requiere Claude Code v2.1.211 o posterior |

375| `CLAUDE_CODE_RESUME_PROMPT` | Sobrescribe el mensaje de continuación que Claude Code envía a Claude cuando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continúa un turno interrumpido en lugar de volver a enviar su prompt, o cuando reanudas una [llamada a herramienta diferida](https://code.claude.com/docs/es/hooks.md#defer-a-tool-call-for-later) con `-p`. El valor predeterminado es `Continue from where you left off.`. Una cadena vacía usa el valor predeterminado |378| `CLAUDE_CODE_RESUME_PROMPT` | Sobrescribe el mensaje de continuación que Claude Code envía a Claude cuando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continúa un turno interrumpido en lugar de volver a enviar su prompt, o cuando reanudas una [llamada a herramienta diferida](https://code.claude.com/docs/es/hooks.md#defer-a-tool-call-for-later) con `-p`. El valor predeterminado es `Continue from where you left off.`. Una cadena vacía usa el valor predeterminado |

405| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Establécela en `1` para eliminar las credenciales de los entornos de los subprocesos que inicia Claude Code, como los comandos de Bash, los hooks y los servidores MCP stdio. La limpieza reconoce una credencial por el nombre de su variable o por su valor, y deja en su lugar los tokens de GitHub y la configuración del proxy. Consulta [Qué elimina la limpieza del entorno de los subprocesos](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la establece automáticamente cuando se configura `allowed_non_write_users` |408| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Establécela en `1` para eliminar las credenciales de los entornos de los subprocesos que inicia Claude Code, como los comandos de Bash, los hooks y los servidores MCP stdio. La limpieza reconoce una credencial por el nombre de su variable o por su valor, y deja en su lugar los tokens de GitHub y la configuración del proxy. Consulta [Qué elimina la limpieza del entorno de los subprocesos](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la establece automáticamente cuando se configura `allowed_non_write_users` |

406| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Establécela en `1` en modo no interactivo (el flag `-p`) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y es posible que no estén disponibles en el primer turno. Combínala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar la espera |409| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Establécela en `1` en modo no interactivo (el flag `-p`) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y es posible que no estén disponibles en el primer turno. Combínala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar la espera |

407| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Tiempo de espera en milisegundos para la instalación síncrona de plugins. Cuando se supera, Claude Code continúa sin plugins y registra un error. Sin valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse |410| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Tiempo de espera en milisegundos para la instalación síncrona de plugins. Cuando se supera, Claude Code continúa sin plugins y registra un error. Sin valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse |

408| `CLAUDE_CODE_SYNC_SKILLS` | Establécela en `1` en modo no interactivo con el flag `-p` para que Claude Code descargue en esa ejecución los skills habilitados para tu cuenta de claude.ai y espere la lista de ellos, hasta `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de ejecutar la primera consulta. Requiere autenticación de claude.ai. Las sesiones de terminal en las que inicias sesión con tu cuenta de claude.ai [sincronizan estos skills](https://code.claude.com/docs/es/skills.md#where-synced-skills-load) sin esta variable, así que establécela solo cuando una ejecución con `-p` necesite tus skills actuales en su primera consulta |411| `CLAUDE_CODE_SYNC_SKILLS` | Establécela en `1` para que Claude Code descargue los skills habilitados para tu cuenta de claude.ai. En modo no interactivo con el flag `-p`, Claude Code también espera hasta `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` la lista de skills antes de ejecutar la primera consulta. Requiere autenticación con claude.ai. Las sesiones de terminal en las que inicias sesión con tu cuenta de claude.ai [sincronizan estos skills](https://code.claude.com/docs/es/skills.md#where-synced-skills-load) sin esta variable. En una sesión interactiva, la variable requiere v2.1.323 o posterior |

409| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Tiempo de espera en milisegundos para la resincronización de skills que se ejecuta a mitad de la sesión cuando una aplicación creada con el [Agent SDK](https://code.claude.com/docs/es/agent-sdk/typescript.md#query-object) recarga los skills (predeterminado: 30000). Cuando se supera, la recarga continúa con los skills que hayan llegado, y las descargas restantes terminan en segundo plano |412| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Tiempo de espera en milisegundos para la resincronización de skills que se ejecuta a mitad de la sesión cuando una aplicación creada con el [Agent SDK](https://code.claude.com/docs/es/agent-sdk/typescript.md#query-object) recarga los skills (predeterminado: 30000). Cuando se supera, la recarga continúa con los skills que hayan llegado, y las descargas restantes terminan en segundo plano |

410| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Tiempo de espera en milisegundos durante el cual la primera consulta espera la lista inicial de skills cuando `CLAUDE_CODE_SYNC_SKILLS` está establecida (predeterminado: 5000). Cuando se supera, la primera consulta se ejecuta con los skills que hayan llegado. Las descargas terminan en segundo plano en cualquier caso, y Claude espera la descarga de un skill cuando invoca ese skill |413| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Tiempo de espera en milisegundos durante el cual la primera consulta espera la lista inicial de skills cuando `CLAUDE_CODE_SYNC_SKILLS` está establecida (predeterminado: 5000). Cuando se supera, la primera consulta se ejecuta con los skills que hayan llegado. Las descargas terminan en segundo plano en cualquier caso, y Claude espera la descarga de un skill cuando invoca ese skill |

411| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Establécela en `false` para deshabilitar el resaltado de sintaxis en la salida de diff. Útil cuando los colores interfieren con la configuración de tu terminal. Para deshabilitar también el resaltado en los bloques de código y en las vistas previas de archivos, usa el ajuste [`syntaxHighlightingDisabled`](https://code.claude.com/docs/es/settings-reference#syntaxhighlightingdisabled) |414| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Establécela en `false` para deshabilitar el resaltado de sintaxis en la salida de diff. Útil cuando los colores interfieren con la configuración de tu terminal. Para deshabilitar también el resaltado en los bloques de código y en las vistas previas de archivos, usa el ajuste [`syntaxHighlightingDisabled`](https://code.claude.com/docs/es/settings-reference#syntaxhighlightingdisabled) |

585* Activar el [mod You should know](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions)588* Activar el [mod You should know](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions)

586* Usar [la herramienta advisor](https://code.claude.com/docs/es/advisor.md#requirements), excepto en Claude Platform on AWS con Claude Code v2.1.300 o posterior589* Usar [la herramienta advisor](https://code.claude.com/docs/es/advisor.md#requirements), excepto en Claude Platform on AWS con Claude Code v2.1.300 o posterior

587* Usar [tareas de MCP](https://code.claude.com/docs/es/mcp.md#mcp-tasks-that-run-on-the-server)590* Usar [tareas de MCP](https://code.claude.com/docs/es/mcp.md#mcp-tasks-that-run-on-the-server)

591* Activar [Code Mode](https://code.claude.com/docs/es/code-mode.md#requirements)

588* Leer o responder [comentarios en un artefacto](https://code.claude.com/docs/es/artifacts.md#collect-comments-on-an-artifact)592* Leer o responder [comentarios en un artefacto](https://code.claude.com/docs/es/artifacts.md#collect-comments-on-an-artifact)

589* Hacer que Claude lea [el artefacto público de otra organización](https://code.claude.com/docs/es/artifacts.md#read-an-artifact-shared-with-you)593* Hacer que Claude lea [el artefacto público de otra organización](https://code.claude.com/docs/es/artifacts.md#read-an-artifact-shared-with-you)

590* Obtener la [herramienta PowerShell](https://code.claude.com/docs/es/tools-reference.md#powershell-tool) de forma predeterminada para cuentas de claude.ai y Console en Windows con Git Bash instalado; Claude Code enruta los comandos de shell a través de Git Bash a menos que establezcas `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. En Windows sin Git Bash, la herramienta permanece activada594* Obtener la [herramienta PowerShell](https://code.claude.com/docs/es/tools-reference.md#powershell-tool) de forma predeterminada para cuentas de claude.ai y Console en Windows con Git Bash instalado; Claude Code enruta los comandos de shell a través de Git Bash a menos que establezcas `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. En Windows sin Git Bash, la herramienta permanece activada

122| `A request to MCP server "<name>" was sent without your stored credentials` | [Autenticación](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Autenticación](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Autenticación](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Autenticación](#mcp-server-url-is-missing-or-not-a-valid-url) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [Autenticación](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [Autenticación](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [Autenticación](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Autenticación](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Autenticación](#refusing-to-send-credentials-to-non-https-token-endpoint) |

126| `Cloud gateway session expired — run /login to reconnect.` | [Autenticación](#cloud-gateway-session-expired) |127| `Cloud gateway session expired — run /login to reconnect.` | [Autenticación](#cloud-gateway-session-expired) |

127| `Cloud gateway <url> no longer accepts this session` | [Autenticación](#cloud-gateway-session-expired) |128| `Cloud gateway <url> no longer accepts this session` | [Autenticación](#cloud-gateway-session-expired) |

153| `403` con `GitHub GraphQL is not available from Claude Code sessions` en una sesión en la nube | [Proxy de GitHub](https://code.claude.com/docs/es/cloud-environments.md#github-proxy) |154| `403` con `GitHub GraphQL is not available from Claude Code sessions` en una sesión en la nube | [Proxy de GitHub](https://code.claude.com/docs/es/cloud-environments.md#github-proxy) |

154| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Red](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |155| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Red](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |

155| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Red](#failed-to-fetch-session-from-sessions-api) |156| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [Red](#failed-to-fetch-session-from-sessions-api) |

157| `Couldn't load the history of cloud session` | [Red](#couldnt-load-the-history-of-cloud-session) |

156| `Couldn't reconnect to your Remote Control session` | [Red](#couldnt-reconnect-to-your-remote-control-session) |158| `Couldn't reconnect to your Remote Control session` | [Red](#couldnt-reconnect-to-your-remote-control-session) |

157| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Red](#sessions-ended-while-this-machine-was-offline) |159| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Red](#sessions-ended-while-this-machine-was-offline) |

158| `Couldn't share the transcript.` | [Red](#couldnt-share-the-transcript) |160| `Couldn't share the transcript.` | [Red](#couldnt-share-the-transcript) |

180| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Errores de solicitud](#pdf-errors) |182| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [Errores de solicitud](#pdf-errors) |

181| `Extra inputs are not permitted` | [Errores de solicitud](#extra-inputs-are-not-permitted) |183| `Extra inputs are not permitted` | [Errores de solicitud](#extra-inputs-are-not-permitted) |

182| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Errores de solicitud](#tool-input-schema-is-invalid) |184| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Errores de solicitud](#tool-input-schema-is-invalid) |

185| `N tools left out` junto a un servidor en `/mcp` / `Claude wasn't given N tools because the Anthropic API would reject their input schemas` | [Herramientas con esquemas de entrada no válidos](https://code.claude.com/docs/es/mcp.md#tools-with-invalid-input-schemas) |

183| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Errores de solicitud](#mcp-tool-name-over-128-characters) |186| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [Errores de solicitud](#mcp-tool-name-over-128-characters) |

184| `tools.N.custom.name: String should have at most 128 characters` | [Errores de solicitud](#mcp-tool-name-over-128-characters) |187| `tools.N.custom.name: String should have at most 128 characters` | [Errores de solicitud](#mcp-tool-name-over-128-characters) |

185| `tool_use.name: String should have at most 200 characters` | [Errores de solicitud](#tool-use-name-over-200-characters) |188| `tool_use.name: String should have at most 200 characters` | [Errores de solicitud](#tool-use-name-over-200-characters) |

251| `Ultrareview did not start` | [Errores de línea de comandos](#ultrareview-did-not-start) |254| `Ultrareview did not start` | [Errores de línea de comandos](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [Errores de línea de comandos](#remote-control-did-not-start-got-no-answer) |255| `Remote Control did not start: "<question>" got no answer` | [Errores de línea de comandos](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errores de línea de comandos](#not-carried-over-to-the-sessions-remote-control-starts) |256| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errores de línea de comandos](#not-carried-over-to-the-sessions-remote-control-starts) |

257| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Errores de línea de comandos](#remote-control-did-not-start-because-of-the-settings-file) |

258| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Errores de línea de comandos](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errores de línea de comandos](#sandbox-is-not-supported-by-claude-remote-control) |259| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errores de línea de comandos](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [Errores de línea de comandos](#claude-import-is-not-yet-available-in-this-build) |260| `` `claude import` is not yet available in this build `` | [Errores de línea de comandos](#claude-import-is-not-yet-available-in-this-build) |

256| `Could not read Claude Code config` | [Errores de línea de comandos](#could-not-read-claude-code-config) |261| `Could not read Claude Code config` | [Errores de línea de comandos](#could-not-read-claude-code-config) |

268| `No available ports for OAuth redirect` | [Errores de línea de comandos](#no-available-ports-for-oauth-redirect) |273| `No available ports for OAuth redirect` | [Errores de línea de comandos](#no-available-ports-for-oauth-redirect) |

269| `Shell command failed for pattern "..."`, de `/security-review` o de cualquier skill que inyecte contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |274| `Shell command failed for pattern "..."`, de `/security-review` o de cualquier skill que inyecte contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |

270| `Shell command permission check failed for pattern "..."`, de un skill que inyecta contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |275| `Shell command permission check failed for pattern "..."`, de un skill que inyecta contexto dinámico | [Errores de línea de comandos](#security-review-fails-without-origin-head) |

276| ``Couldn't run `<command>` for <name>. A file named HEAD or .git in this folder or one above it may not be yours``, desde un skill que inyecta contexto dinámico | [Comprobaciones de permisos en comandos inyectados](https://code.claude.com/docs/es/skills.md#permission-checks-on-injected-commands) |

271| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Errores de línea de comandos](#security-review-fails-without-origin-head) |277| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Errores de línea de comandos](#security-review-fails-without-origin-head) |

272| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Errores de línea de comandos](#no-shell-command-was-run) |278| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Errores de línea de comandos](#no-shell-command-was-run) |

273| `Input must be provided either through stdin or as a prompt argument when using --print` | [Errores de línea de comandos](#input-must-be-provided-when-using-print) |279| `Input must be provided either through stdin or as a prompt argument when using --print` | [Errores de línea de comandos](#input-must-be-provided-when-using-print) |

425| `Workspace not trusted.` al iniciar o reiniciar una sesión en segundo plano | [Errores de sesión en segundo plano](#workspace-not-trusted-when-dispatching-a-background-session) |431| `Workspace not trusted.` al iniciar o reiniciar una sesión en segundo plano | [Errores de sesión en segundo plano](#workspace-not-trusted-when-dispatching-a-background-session) |

426| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Errores de sesión en segundo plano](#eacces-when-starting-a-background-session) |432| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Errores de sesión en segundo plano](#eacces-when-starting-a-background-session) |

427| `Claude Code process exited with code N` | [Errores de contenedor e IDE](#claude-code-process-exited-with-code-n) |433| `Claude Code process exited with code N` | [Errores de contenedor e IDE](#claude-code-process-exited-with-code-n) |

434| `Subprocess initialization did not complete within 60000ms` | [Errores de wrappers e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |

435| `Claude Code did not finish starting` | [Errores de wrappers e IDE](#subprocess-initialization-did-not-complete-within-60000ms) |

428| `The connection to Claude Code ended before this message completed` | [Errores de contenedor e IDE](#the-connection-to-claude-code-ended-before-this-message-completed) |436| `The connection to Claude Code ended before this message completed` | [Errores de contenedor e IDE](#the-connection-to-claude-code-ended-before-this-message-completed) |

429| `Could not locate the Claude CLI on PATH` | [Errores de contenedor e IDE](#could-not-locate-the-claude-cli-on-path) |437| `Could not locate the Claude CLI on PATH` | [Errores de contenedor e IDE](#could-not-locate-the-claude-cli-on-path) |

430| `The Claude Code program for this computer, the <build> build, could not be found` | [Errores del wrapper y del IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |438| `The Claude Code program for this computer, the <build> build, could not be found` | [Errores del wrapper y del IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |

560| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sin límite | Con `CLAUDE_CODE_RETRY_WATCHDOG` establecido, el tiempo máximo en milisegundos que una solicitud espera a que se restablezca el [límite de uso](#youve-hit-your-session-limit) de tu plan, como el límite de sesión o el semanal. Cuando el restablecimiento está más lejos que este límite, la solicitud falla de inmediato, a menos que los créditos de uso tengan margen o la API no haya podido comprobarlos. En esos casos se reintenta, y falla si se supera el límite antes de que tenga éxito. Requiere Claude Code v2.1.301 o posterior. |568| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | sin límite | Con `CLAUDE_CODE_RETRY_WATCHDOG` establecido, el tiempo máximo en milisegundos que una solicitud espera a que se restablezca el [límite de uso](#youve-hit-your-session-limit) de tu plan, como el límite de sesión o el semanal. Cuando el restablecimiento está más lejos que este límite, la solicitud falla de inmediato, a menos que los créditos de uso tengan margen o la API no haya podido comprobarlos. En esos casos se reintenta, y falla si se supera el límite antes de que tenga éxito. Requiere Claude Code v2.1.301 o posterior. |

561| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Intervalo mínimo en milisegundos entre comprobaciones de si un [límite de uso](#youve-hit-your-session-limit) ya se levantó, mientras una solicitud espera a que ese límite se restablezca con `CLAUDE_CODE_RETRY_WATCHDOG` establecido. Cuando una comprobación encuentra que el límite se levantó, la solicitud se envía de inmediato. Indica solo dígitos, de `60000` a `10800000`. Si no está establecido o está fuera de ese rango, no se realizan comprobaciones. Para saber cuándo Claude Code omite estas comprobaciones, consulta la [referencia de variables de entorno](https://code.claude.com/docs/es/env-vars.md). Requiere Claude Code v2.1.305 o posterior. |569| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Intervalo mínimo en milisegundos entre comprobaciones de si un [límite de uso](#youve-hit-your-session-limit) ya se levantó, mientras una solicitud espera a que ese límite se restablezca con `CLAUDE_CODE_RETRY_WATCHDOG` establecido. Cuando una comprobación encuentra que el límite se levantó, la solicitud se envía de inmediato. Indica solo dígitos, de `60000` a `10800000`. Si no está establecido o está fuera de ese rango, no se realizan comprobaciones. Para saber cuándo Claude Code omite estas comprobaciones, consulta la [referencia de variables de entorno](https://code.claude.com/docs/es/env-vars.md). Requiere Claude Code v2.1.305 o posterior. |

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/es/env-vars) | 500 | Retraso inicial en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 32000, para distribuir los reintentos en un período más largo cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |570| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/es/env-vars) | 500 | Retraso inicial en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 32000, para distribuir los reintentos en un período más largo cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.292 o posterior. |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/es/env-vars) | 32000 | Límite máximo en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 64000, para que los reintentos posteriores sigan espaciándose cuando la API está al límite de su capacidad. No tiene efecto cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecido en `1`, ni cuando la solicitud rechazada se envió en [modo rápido](https://code.claude.com/docs/es/fast-mode.md#handle-rate-limits). Requiere Claude Code v2.1.296 o posterior. |571| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/es/env-vars) | 32000 | Límite máximo en milisegundos del retroceso entre reintentos de una solicitud que la API rechaza con un error de sobrecarga `529`. Auméntalo, hasta 300000, para que los reintentos posteriores sigan espaciándose cuando la API está al límite de su capacidad. Los valores superiores a 64000 requieren v2.1.323 o posterior. No tiene efecto en los mismos casos que `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`. Requiere Claude Code v2.1.296 o posterior. |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/es/env-vars) | 600000 | Tiempo en milisegundos que tiene cada intento de solicitud para recibir sus encabezados de respuesta. No limita cuánto dura una respuesta en streaming después de eso. Auméntalo para redes lentas o proxies. Para saber cómo limita el plazo del primer byte, consulta [No response from API](#no-response-from-api). |572| [`API_TIMEOUT_MS`](https://code.claude.com/docs/es/env-vars) | 600000 | Tiempo en milisegundos que tiene cada intento de solicitud para recibir sus encabezados de respuesta. No limita cuánto dura una respuesta en streaming después de eso. Auméntalo para redes lentas o proxies. Para saber cómo limita el plazo del primer byte, consulta [No response from API](#no-response-from-api). |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/es/env-vars) | sin establecer | Límite de reenvíos de una [solicitud sin streaming](#streaming-response-ended-before-any-complete-data-was-received) cuyo tiempo de espera se agota. Al alcanzar el límite, la solicitud falla. Una respuesta de Claude que tarda en generarse más que el tiempo de espera vuelve a agotar el tiempo de espera en cada reenvío, así que establece un número bajo, como `0`, para que falle antes. Para conocer el tiempo de espera de cada intento, consulta [Cuánto espera un intento sin streaming](#how-long-a-non-streaming-attempt-waits). Requiere Claude Code v2.1.285 o posterior. |573| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/es/env-vars) | sin establecer | Límite de reenvíos de una [solicitud sin streaming](#streaming-response-ended-before-any-complete-data-was-received) cuyo tiempo de espera se agota. Al alcanzar el límite, la solicitud falla. Una respuesta de Claude que tarda en generarse más que el tiempo de espera vuelve a agotar el tiempo de espera en cada reenvío, así que establece un número bajo, como `0`, para que falle antes. Para conocer el tiempo de espera de cada intento, consulta [Cuánto espera un intento sin streaming](#how-long-a-non-streaming-attempt-waits). Requiere Claude Code v2.1.285 o posterior. |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Plazo en milisegundos para el primer byte de respuesta de una solicitud en streaming. Requiere Claude Code v2.1.242 o posterior. Para saber cómo elige Claude Code el plazo cuando esta variable no está establecida, consulta [No response from API](#no-response-from-api). |574| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/es/env-vars) | sin establecer | Plazo en milisegundos para el primer byte de respuesta de una solicitud en streaming. Requiere Claude Code v2.1.242 o posterior. Para saber cómo elige Claude Code el plazo cuando esta variable no está establecida, consulta [No response from API](#no-response-from-api). |

825Las llamadas posteriores en la misma respuesta de Claude pueden denegarse con este motivo:833Las llamadas posteriores en la misma respuesta de Claude pueden denegarse con este motivo:

826 834 

827```text theme={null}835```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged836another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```837```

830 838 

831Claude puede entonces volver a emitir cada llamada denegada para que el servidor la revise. Si se abre una solicitud de permiso, respóndela. No necesitas hacer nada más, a menos que Claude diga en su respuesta que el modo automático no pudo verificar la llamada. En ese caso, detén el cambio o aprueba la llamada tú mismo, y pídele a Claude que vuelva a intentar la llamada:839Claude puede entonces volver a emitir cada llamada denegada para que el servidor la revise. Si se abre una solicitud de permiso, respóndela. No necesitas hacer nada más, a menos que Claude diga en su respuesta que el modo automático no pudo verificar la llamada. En ese caso, detén el cambio o aprueba la llamada tú mismo, y pídele a Claude que vuelva a intentar la llamada:

978 986 

979### You've hit your monthly spend limit987### You've hit your monthly spend limit

980 988 

981El uso incluido en tu plan no puede cubrir esta solicitud, y los [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) que de otro modo la pagarían alcanzaron un límite de gasto. Eso sucede cuando se agotó una de las ventanas de uso de tu plan, o cuando la solicitud es de las que solo pagan los créditos de uso, como una solicitud a un modelo que [se factura con créditos de uso](https://code.claude.com/docs/es/model-config.md#fable-and-usage-credits). El mensaje indica de quién es el límite que te bloqueó. El texto después del `·` dice cómo conseguir que se aumente ese límite, y varía según tu plan y si gestionas la facturación:989El uso incluido en tu plan no puede cubrir esta solicitud, y los [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) que de otro modo la pagarían alcanzaron un límite de gasto. Tu plan no puede cubrir una solicitud cuando se agotó una de sus ventanas de uso, o cuando solo los créditos de uso pagan la solicitud. Un ejemplo es una solicitud a un modelo que [se factura con créditos de uso](https://code.claude.com/docs/es/model-config.md#fable-and-usage-credits).

990 

991Las palabras antes del `·` nombran el límite que te bloqueó, como el límite de gasto mensual de tu organización, y el texto después dice cómo conseguir que se aumente ese límite. En una sesión en la nube o con [Remote Control](https://code.claude.com/docs/es/remote-control.md), ese texto no incluye ninguna URL, y un mensaje sobre tu propio `monthly spend limit` no dice cómo aumentarlo. Otras sesiones muestran formas como estas:

982 992 

983```text theme={null}993```text theme={null}

984You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message994You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message

1822 1832 

1823Antes de la v2.1.232, Claude Code usaba el runtime v2 solo en un despliegue gradual o cuando definías `MCP_SDK_GENERATION=v2`.1833Antes de la v2.1.232, Claude Code usaba el runtime v2 solo en un despliegue gradual o cuando definías `MCP_SDK_GENERATION=v2`.

1824 1834 

1835### Stopped an OAuth request

1836 

1837Este mensaje significa que Claude Code detuvo una [solicitud OAuth para un servidor MCP](https://code.claude.com/docs/es/mcp.md#authenticate-with-remote-mcp-servers) porque un endpoint OAuth la redirigió. En ambas formas del mensaje, la primera dirección es la que envió la redirección:

1838 

1839```text theme={null}

1840Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1841Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1842```

1843 

1844**Qué hacer:**

1845 

1846* Pide a quien administre la primera dirección, como el operador del servidor MCP, que elimine o corrija la redirección. Luego vuelve a intentarlo desde `/mcp`.

1847 

1825### Se rechaza enviar credenciales a un endpoint de token que no es https1848### Se rechaza enviar credenciales a un endpoint de token que no es https

1826 1849 

1827En el [runtime v2](https://code.claude.com/docs/es/mcp.md#mcp-client-runtimes), Claude Code envía una solicitud de token de [OAuth de MCP](https://code.claude.com/docs/es/mcp.md#authenticate-with-remote-mcp-servers) solo a un endpoint de token servido por HTTPS o en `localhost`, `127.0.0.1` o `::1`. Este mensaje significa que el endpoint de token del servidor no es ninguna de esas opciones, así que Claude Code se detuvo antes de enviar la solicitud. Eso ocurre después del inicio de sesión en el navegador, así que el paso del navegador se completa primero, y de nuevo cada vez que Claude Code renueva el token del servidor.1850En el [runtime v2](https://code.claude.com/docs/es/mcp.md#mcp-client-runtimes), Claude Code envía una solicitud de token de [OAuth de MCP](https://code.claude.com/docs/es/mcp.md#authenticate-with-remote-mcp-servers) solo a un endpoint de token servido por HTTPS o en `localhost`, `127.0.0.1` o `::1`. Este mensaje significa que el endpoint de token del servidor no es ninguna de esas opciones, así que Claude Code se detuvo antes de enviar la solicitud. Eso ocurre después del inicio de sesión en el navegador, así que el paso del navegador se completa primero, y de nuevo cada vez que Claude Code renueva el token del servidor.

2207 2230 

2208### Host no permitido en una sesión en la nube2231### Host no permitido en una sesión en la nube

2209 2232 

2210La política de red del entorno bloqueó una solicitud HTTP saliente de una sesión en la nube o de una tarea programada en la nube.2233En una sesión en la nube o en una tarea programada en la nube, un `403` o un error de DNS como `ENOTFOUND` puede significar que el host solicitado no está en la [lista de permitidos del entorno en la nube](https://code.claude.com/docs/es/cloud-environments.md#access-levels). Para confirmarlo, compara el host con esa lista. Un `403` con este encabezado confirma el bloqueo, pero no todos los `403` de solicitudes bloqueadas lo incluyen:

2211 2234 

2212```text theme={null}2235```text theme={null}

2213HTTP 4032236HTTP 403

2290 2313 

2291Antes de v2.1.296, Claude Code no reintentaba una lectura fallida y, después de una, podía abrir la sesión con una conversación vacía e informar éxito en lugar de imprimir este mensaje.2314Antes de v2.1.296, Claude Code no reintentaba una lectura fallida y, después de una, podía abrir la sesión con una conversación vacía e informar éxito en lugar de imprimir este mensaje.

2292 2315 

2316### Couldn't load the history of cloud session

2317 

2318Este mensaje significa que Claude Code encontró la [sesión en la nube que pediste traer a tu terminal](https://code.claude.com/docs/es/claude-code-on-the-web.md#from-cloud-to-terminal), pero la solicitud de su historial de conversación devolvió que no se encontró:

2319 

2320```text theme={null}

2321Couldn't load the history of cloud session session_01HJKLMNOPQRSTUVWXYZ. Check it at https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ?from=cli

2322```

2323 

2324**Qué hacer:**

2325 

2326* Abre el enlace del mensaje para revisar la sesión en tu navegador. Si se abre ahí y el mismo teleport vuelve a fallar de esta manera, [reporta el problema](#report-an-error).

2327 

2293### Couldn't reconnect to your Remote Control session2328### Couldn't reconnect to your Remote Control session

2294 2329 

2295```text theme={null}2330```text theme={null}

2565 2600 

2566Claude Code normalmente cambia el tamaño de las imágenes grandes de forma automática. Estos errores significan que la imagen no se pudo decodificar ni redimensionar para que cupiera dentro de los límites de la API.2601Claude Code normalmente cambia el tamaño de las imágenes grandes de forma automática. Estos errores significan que la imagen no se pudo decodificar ni redimensionar para que cupiera dentro de los límites de la API.

2567 2602 

2603El error que ves puede nombrar un límite de píxeles diferente, como `2576x2576px` donde estos ejemplos dicen `2000x2000px`.

2604 

2568**Qué hacer:**2605**Qué hacer:**

2569 2606 

2570* Si el mensaje te pide que conviertas la imagen, conviértela a PNG, JPEG, GIF o WebP y vuelve a adjuntarla. Claude Code puede verificar las dimensiones de estos formatos a partir del encabezado del archivo, sin decodificar la imagen.2607* Si el mensaje te pide que conviertas la imagen, conviértela a PNG, JPEG, GIF o WebP y vuelve a adjuntarla. Claude Code puede verificar las dimensiones de estos formatos a partir del encabezado del archivo, sin decodificar la imagen.

2873* **Un motivo escrito por un hook**: un hook PreModelSwitch proporcionó ese motivo cuando [denegó el cambio o pidió confirmación](https://code.claude.com/docs/es/hooks.md#premodelswitch-decision-control). Atiende lo que pide, o elige un modelo que tus hooks permitan.2910* **Un motivo escrito por un hook**: un hook PreModelSwitch proporcionó ese motivo cuando [denegó el cambio o pidió confirmación](https://code.claude.com/docs/es/hooks.md#premodelswitch-decision-control). Atiende lo que pide, o elige un modelo que tus hooks permitan.

2874* **`PreModelSwitch hook <name> did not respond before its timeout`**: un hook que no responde antes de que se agote su [tiempo de espera](https://code.claude.com/docs/es/hooks.md#timeouts) bloquea el cambio. Corrige el comando que se queda colgado o aumenta el `timeout` de ese hook, y luego vuelve a cambiar.2911* **`PreModelSwitch hook <name> did not respond before its timeout`**: un hook que no responde antes de que se agote su [tiempo de espera](https://code.claude.com/docs/es/hooks.md#timeouts) bloquea el cambio. Corrige el comando que se queda colgado o aumenta el `timeout` de ese hook, y luego vuelve a cambiar.

2875* **`confirmation required, and this session cannot ask`**: un hook respondió `ask` sin un motivo, y una solicitud de control no tiene forma de mostrar la solicitud de confirmación. Un comando `/model` en una [ejecución con `-p`](https://code.claude.com/docs/es/headless) reporta la misma condición con `(run /model interactively to confirm)` después del motivo. Haz el cambio desde una sesión interactiva, o cambia la decisión del hook para este modelo.2912* **`confirmation required, and this session cannot ask`**: un hook respondió `ask` sin un motivo, y una solicitud de control no tiene forma de mostrar la solicitud de confirmación. Un comando `/model` en una [ejecución con `-p`](https://code.claude.com/docs/es/headless) reporta la misma condición con `(run /model interactively to confirm)` después del motivo. Haz el cambio desde una sesión interactiva, o cambia la decisión del hook para este modelo.

2876* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code no pudo determinar qué hooks PreModelSwitch entregan los [plugins administrados](https://code.claude.com/docs/es/settings-reference.md#enabledplugins) de tu organización, por ejemplo porque un plugin administrado no se cargó. Uno de esos hooks podría bloquear el cambio, así que Claude Code lo rechaza en lugar de aplicarlo sin verificar. El principio del motivo indica qué falló. Claude Code vuelve a verificar en cada intento de cambio, por lo que un fallo que ya se resolvió deja de bloquear; si sigue fallando, ejecuta `claude --debug` y vuelve a cambiar para capturar los detalles, y luego corrige el plugin o pídele a tu administrador que lo corrija.2913* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code anterior a la v2.1.323 rechaza el cambio cuando no puede determinar qué hooks PreModelSwitch proporcionan tus [plugins administrados](https://code.claude.com/docs/es/settings-reference.md#enabledplugins). El texto antes de esta frase indica qué falló. Para detener el rechazo, actualiza Claude Code. Para que además se ejecuten los hooks de un plugin que falló, corrige el plugin o consulta a tu administrador. Para más detalles, inicia `claude --debug` en tu shell y cambia de modelo; luego lee el [registro de depuración](https://code.claude.com/docs/es/hooks.md#debug-hooks).

2877* **`a PreModelSwitch hook failed before answering`** o **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: la ejecución del hook terminó sin un veredicto, y Claude Code no lo trata como una aprobación. Ejecuta `claude --debug` para ver qué falló y luego vuelve a cambiar.2914* **`a PreModelSwitch hook failed before answering`** o **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: la ejecución del hook terminó sin un veredicto, y Claude Code no lo trata como una aprobación. Ejecuta `claude --debug` para ver qué falló y luego vuelve a cambiar.

2878 2915 

2879Antes de v2.1.260, el rechazo por plugins administrados decía `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code reintentaba la carga del plugin una vez y luego rechazaba los cambios posteriores en la sesión, incluso cuando tu organización no administraba ningún plugin. En esas versiones, reinicia la sesión para volver a ejecutar la carga del plugin.2916Antes de v2.1.260, el rechazo por plugins administrados decía `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code reintentaba la carga del plugin una vez y luego rechazaba los cambios posteriores en la sesión, incluso cuando tu organización no administraba ningún plugin. En esas versiones, reinicia la sesión para volver a ejecutar la carga del plugin.

3522Iniciaste [Remote Control](https://code.claude.com/docs/es/remote-control.md) con un flag global de `claude` antes del verbo `remote-control`, uno que restringiría o configuraría las sesiones que inicia Remote Control, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag colocado antes del verbo nunca llega a esas sesiones. En su lugar, Claude Code se niega a iniciar y nombra el flag:3559Iniciaste [Remote Control](https://code.claude.com/docs/es/remote-control.md) con un flag global de `claude` antes del verbo `remote-control`, uno que restringiría o configuraría las sesiones que inicia Remote Control, como `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag colocado antes del verbo nunca llega a esas sesiones. En su lugar, Claude Code se niega a iniciar y nombra el flag:

3523 3560 

3524```text theme={null}3561```text theme={null}

3525Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3562Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.

3526```3563```

3527 3564 

3528Claude Code no rechaza los flags globales que es inofensivo descartar, como `--verbose`, `--model`, o un `--session-id` o `--plugin-dir` inyectado por un wrapper: los ignora y Remote Control se inicia.3565Claude Code no rechaza los flags globales que es inofensivo descartar, como `--verbose`, `--model`, o un `--session-id` o `--plugin-dir` inyectado por un wrapper: los ignora y Remote Control se inicia.

3536 3573 

3537Antes de v2.1.248, `claude remote-control` no aceptaba sus propios flags cuando un flag global iba primero, y el comando fallaba con un error `unknown option`.3574Antes de v2.1.248, `claude remote-control` no aceptaba sus propios flags cuando un flag global iba primero, y el comando fallaba con un error `unknown option`.

3538 3575 

3576### Remote Control no se inició por el archivo de `--settings`

3577 

3578El archivo que pasaste a [`claude remote-control --settings`](https://code.claude.com/docs/es/remote-control#start-a-remote-control-session) tiene un problema:

3579 

3580```text theme={null}

3581Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3582```

3583 

3584**Qué hacer:**

3585 

3586* Corrige el problema que indica el mensaje y luego vuelve a ejecutar tu comando `claude remote-control`

3587 

3588### The settings file has changed since Remote Control started

3589 

3590Este mensaje en la terminal que ejecuta `claude remote-control` significa que las sesiones no se iniciarán a partir del archivo que pasaste a [`--settings`](https://code.claude.com/docs/es/remote-control#start-a-remote-control-session) tal como está ahora:

3591 

3592```text theme={null}

3593Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3594```

3595 

3596**Qué hacer:**

3597 

3598* Para usar el archivo tal como está ahora, detén `claude remote-control` y vuelve a ejecutar el mismo comando. Para recuperar las sesiones que estaba atendiendo, consulta [Reanudar sesiones después de detener el servidor](https://code.claude.com/docs/es/remote-control.md#resume-sessions-after-stopping-the-server).

3599* Para conservar la configuración con la que se inició Remote Control, restaura el contenido del archivo tal como estaba y luego vuelve a ejecutar el comando si `claude remote-control` ha terminado

3600 

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3601### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3602 

3541Este error significa que el comando que inicia tu servidor de [Remote Control](https://code.claude.com/docs/es/remote-control.md) pasa `--sandbox` o `--no-sandbox` después de `remote-control`, y `claude remote-control` no acepta ninguno de los dos flags. El servidor termina con el código 1 en lugar de iniciarse:3603Este error significa que el comando que inicia tu servidor de [Remote Control](https://code.claude.com/docs/es/remote-control.md) pasa `--sandbox` o `--no-sandbox` después de `remote-control`, y `claude remote-control` no acepta ninguno de los dos flags. El servidor termina con el código 1 en lugar de iniciarse:

3806 3868 

3807Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:3869Hay cadenas similares que se activan antes de que el comando llegue a ejecutarse:

3808 3870 

3809* `Shell command permission check failed for pattern "..."`: la comprobación de permisos del comando no lo permitió. [Comprobaciones de permisos en comandos inyectados](https://code.claude.com/docs/es/skills.md#permission-checks-on-injected-commands) explica qué resultados abortan en cada modo de permisos y cómo aprobar previamente un comando con `allowed-tools`3871* `Shell command permission check failed for pattern "..."`: la verificación de permisos del comando no lo permitió. Consulta [Verificaciones de permisos en comandos inyectados](https://code.claude.com/docs/es/skills.md#permission-checks-on-injected-commands) para ver qué resultados abortan en cada modo de permisos y cuándo `allowed-tools` aprueba previamente un comando

3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: el frontmatter del skill exige bash en una máquina que no lo tiene. Instala Git for Windows o cambia el frontmatter a `shell: powershell`. Consulta [Cómo se ejecutan los comandos inyectados](https://code.claude.com/docs/es/skills.md#how-injected-commands-run)3872* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: el frontmatter del skill exige bash en una máquina que no lo tiene. Instala Git for Windows o cambia el frontmatter a `shell: powershell`. Consulta [Cómo se ejecutan los comandos inyectados](https://code.claude.com/docs/es/skills.md#how-injected-commands-run)

3811 3873 

3812**Qué hacer:**3874**Qué hacer:**

3960 4022 

3961* **No pasaste una rama base**: Claude Code comparó contra la rama predeterminada del repositorio y sugiere pasar tu base explícitamente, como en el ejemplo anterior4023* **No pasaste una rama base**: Claude Code comparó contra la rama predeterminada del repositorio y sugiere pasar tu base explícitamente, como en el ejemplo anterior

3962* **Pasaste una rama base que ya estaba en tu clon**: la sugerencia dice ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``4024* **Pasaste una rama base que ya estaba en tu clon**: la sugerencia dice ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3963* **Pasaste una rama base que no estaba en tu clon**: Claude Code la obtuvo de origin antes de comparar. La sugerencia dice ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; cuando Claude Code no puede saber si tu clon es superficial, sugiere `git fetch --unshallow origin` en su lugar. Antes de v2.1.221, la sugerencia proponía `git fetch --unshallow origin` para cada rama base obtenida, y en un clon completo ese comando falla con `fatal: --unshallow on a complete repository does not make sense`.4025* **Pasaste una rama base que no estaba en tu clon**: Claude Code la obtuvo de origin antes de comparar. La sugerencia dice ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; cuando Claude Code no puede determinar si tu clon es superficial, sugiere `git fetch --unshallow origin` en su lugar. Antes de la v2.1.221, la sugerencia proponía `git fetch --unshallow origin` para toda rama base obtenida, y en un clon completo ese comando falla con `fatal: --unshallow on a complete repository does not make sense`.

3964 4026 

3965**Qué hacer:**4027**Qué hacer:**

3966 4028 

4333 4395 

4334## Errores de plugins4396## Errores de plugins

4335 4397 

4336Estos errores provienen de la configuración de [plugins](https://code.claude.com/docs/es/plugins/overview.md) y [marketplace](https://code.claude.com/docs/es/plugins/overview.md). Para problemas de plugins que no producen 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](https://code.claude.com/docs/es/plugins/troubleshooting.md).4398Estos errores provienen de la configuración de [plugins](https://code.claude.com/docs/es/plugins/overview.md) y [marketplaces](https://code.claude.com/docs/es/plugins/overview.md). Para problemas de plugins que no producen uno de los mensajes de esta página, como una URL de marketplace que no carga o un plugin que se instala pero no aparece, consulta [Solución de problemas de plugins](https://code.claude.com/docs/es/plugins/troubleshooting.md).

4337 4399 

4338### plugin eval is currently in early access4400### plugin eval is currently in early access

4339 4401 

4340Ejecutó [`claude plugin eval`](https://code.claude.com/docs/es/plugin-evals) o `claude plugin eval init` y salió con código 1 con uno de estos mensajes antes de hacer nada:4402Ejecutaste [`claude plugin eval`](https://code.claude.com/docs/es/plugin-evals) o `claude plugin eval init` y terminó con código 1 mostrando uno de estos mensajes antes de hacer nada:

4341 4403 

4342```text theme={null}4404```text theme={null}

4343`plugin eval` is currently in early access4405`plugin eval` is currently in early access

4347`plugin eval` is currently unavailable4409`plugin eval` is currently unavailable

4348```4410```

4349 4411 

4350El primer mensaje significa que su compilación es anterior a v2.1.269, la primera versión donde el comando está disponible en general. El segundo significa que Anthropic ha desactivado el comando del lado del servidor; nada en su máquina lo vuelve a activar.4412El primer mensaje significa que tu compilación es anterior a la v2.1.269, la primera versión en la que el comando está disponible de forma general. El segundo significa que Anthropic desactivó el comando del lado del servidor; nada en tu máquina lo vuelve a activar.

4351 4413 

4352**Qué hacer:**4414**Qué hacer:**

4353 4415 

4354* Ejecute `claude --version`, luego `claude update`, y ejecute el comando nuevamente en una sesión nueva. Consulte los [requisitos para plugin evals](https://code.claude.com/docs/es/plugin-evals.md#requirements)4416* Ejecuta `claude --version`, luego `claude update`, y vuelve a ejecutar el comando en una sesión nueva. Consulta los [requisitos para las evaluaciones de plugins](https://code.claude.com/docs/es/plugin-evals.md#requirements)

4355* Si ve el segundo mensaje en una compilación actual, intente nuevamente más tarde después de otro `claude update`4417* Si ves el segundo mensaje en una compilación actual, vuelve a intentarlo más tarde después de otro `claude update`

4356 4418 

4357### Marketplace is registered from an untrusted source4419### Marketplace is registered from an untrusted source

4358 4420 

4359El marketplace está registrado bajo un nombre que está [reservado para marketplaces oficiales de Anthropic](https://code.claude.com/docs/es/plugins/marketplace-reference.md#marketplace-file), 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, una entrada registrada antes de que su nombre se reservara seguía cargándose.4421El marketplace está registrado con un nombre que está [reservado para los marketplaces oficiales de Anthropic](https://code.claude.com/docs/es/plugins/marketplace-reference.md#marketplace-file), pero su origen registrado no es un repositorio de GitHub de `anthropics`. Claude Code vuelve a comprobar 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 la v2.1.205, una entrada registrada antes de que su nombre quedara reservado seguía cargándose.

4360 4422 

4361```text theme={null}4423```text theme={null}

4362Marketplace "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.4424Marketplace "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.

4363```4425```

4364 4426 

4365Para un marketplace cuya fuente no es un repositorio de GitHub o una URL de Git, como un directorio local, la oración del medio dice `can only be used with GitHub sources from the 'anthropics' organization` en su lugar. `claude plugin marketplace add` ejecuta la misma verificación y rechaza un nombre reservado con `Failed to add marketplace:` seguido de la misma oración de nombre reservado.4427Para un marketplace cuyo origen no es un repositorio de GitHub ni una URL de Git, como un directorio local, la oración del medio dice en cambio `can only be used with GitHub sources from the 'anthropics' organization`. `claude plugin marketplace add` ejecuta la misma comprobación y rechaza un nombre reservado con `Failed to add marketplace:` seguido de la misma oración sobre el nombre reservado.

4366 4428 

4367**Qué hacer:**4429**Qué hacer:**

4368 4430 

4369* Si el marketplace ya está registrado, ejecute `claude plugin marketplace remove <name>`, luego agréguelo nuevamente desde el repositorio oficial `github.com/anthropics`4431* Si el marketplace ya está registrado, ejecuta `claude plugin marketplace remove <name>` y luego agrégalo de nuevo desde el repositorio oficial `github.com/anthropics`

4370* 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 fuente4432* Si publicas un marketplace de terceros que usaba el nombre antes de que quedara reservado, cámbiale el nombre y pide a los usuarios que lo vuelvan a agregar desde tu origen

4371* Consulte la lista de nombres reservados en [Marketplace schema](https://code.claude.com/docs/es/plugins/marketplace-reference.md#marketplace-file)4433* Consulta la lista de nombres reservados en [Esquema del marketplace](https://code.claude.com/docs/es/plugins/marketplace-reference.md#marketplace-file)

4372 4434 

4373### Marketplace name is another spelling of a reserved name4435### El nombre del marketplace es otra grafía de un nombre reservado

4374 4436 

4375El nombre del marketplace no es en sí mismo un nombre reservado, pero Claude Code lo trata como otra ortografía de uno. [Nombres reservados](https://code.claude.com/docs/es/plugins/marketplace-reference.md#reserved-name-spellings) enumera qué ortografías cuentan como un nombre reservado. Claude Code rechaza tal nombre cuando agrega el marketplace:4437El nombre del marketplace no es en sí un nombre reservado, pero Claude Code lo trata como otra grafía de uno. [Nombres reservados](https://code.claude.com/docs/es/plugins/marketplace-reference.md#reserved-name-spellings) enumera qué grafías cuentan como un nombre reservado. Claude Code rechaza ese nombre cuando agregas el marketplace:

4376 4438 

4377```text theme={null}4439```text theme={null}

4378Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.4440Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.

4379```4441```

4380 4442 

4381Cuando un marketplace ya está registrado bajo tal nombre, su entrada deja de cargarse, y `/plugin`, `claude plugin install`, y `claude plugin update` advierten:4443Cuando un marketplace ya está registrado con ese nombre, su entrada deja de cargarse, y `/plugin`, `claude plugin install` y `claude plugin update` advierten:

4382 4444 

4383```text wrap theme={null}4445```text wrap theme={null}

4384known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins4446known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins

4385```4447```

4386 4448 

4387Cuando el nombre requeriría entrecomillado de shell, la negativa en tiempo de adición dice `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.`4449Cuando el nombre necesitaría comillas en el shell, el rechazo al agregarlo dice `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.`

4388 4450 

4389**Qué hacer:**4451**Qué hacer:**

4390 4452 

4391* Cambie el nombre del marketplace a un nombre que no deletree un nombre reservado y agréguelo nuevamente4453* Cambia el nombre del marketplace por uno que no escriba un nombre reservado y agrégalo de nuevo

4392* Para la advertencia de entrada ignorada, ejecute el comando `claude plugin marketplace remove` que proporciona, o elimine la entrada de `~/.claude/plugins/known_marketplaces.json`4454* Para la advertencia de entrada ignorada, ejecuta el comando `claude plugin marketplace remove` que indica, o elimina la entrada de `~/.claude/plugins/known_marketplaces.json`

4393 4455 

4394### Claude Code refuses the marketplace name4456### Claude Code refuses the marketplace name

4395 4457 

4396Un marketplace registrado cuyo nombre [suplanta un marketplace oficial de Anthropic](https://code.claude.com/docs/es/plugins/marketplace-reference.md#reserved-names) según las reglas que esa sección enumera.4458El nombre de un marketplace registrado [suplanta a un marketplace oficial de Anthropic](https://code.claude.com/docs/es/plugins/marketplace-reference.md#reserved-names) según las reglas que enumera esa sección.

4397 4459 

4398Si un marketplace fue registrado bajo tal nombre antes de que la verificación lo bloqueara, el marketplace y los plugins instalados desde él dejan de cargarse, porque Claude Code verifica el nombre cada vez que lee el catálogo del marketplace. Cuando el nombre imita uno oficial, `claude plugin list` y la pestaña **Errors** de `/plugin` informan cada plugin afectado con un mensaje que comienza:4460Si un marketplace se registró con ese nombre antes de que la comprobación lo bloqueara, el marketplace y los plugins instalados desde él dejan de cargarse, porque Claude Code comprueba el nombre cada vez que lee el catálogo del marketplace. Cuando el nombre imita a uno oficial, `claude plugin list` y la pestaña **Errors** de `/plugin` informan cada plugin afectado con un mensaje que comienza así:

4399 4461 

4400```text theme={null}4462```text theme={null}

4401Claude Code refuses the marketplace name "anthropic-plugins-v2"4463Claude Code refuses the marketplace name "anthropic-plugins-v2"

4402```4464```

4403 4465 

4404Para un nombre que imita, el error del marketplace en sí dice `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own` en su lugar. `claude plugin marketplace add` rechaza cualquier nombre que suplante con `Marketplace name impersonates an official Anthropic/Claude marketplace`.4466Para un nombre que imita a uno oficial, el error propio del marketplace dice en cambio `Claude Code refuses this marketplace's name: it looks like one of Anthropic's own`. `claude plugin marketplace add` rechaza cualquier nombre que suplante a uno oficial con `Marketplace name impersonates an official Anthropic/Claude marketplace`.

4405 4467 

4406Antes de v2.1.282, `claude plugin list` y `/plugin` informaban los plugins de un nombre que imita como fallidos al cargar también, sin nombrar el nombre del marketplace como la causa.4468Antes de la v2.1.282, `claude plugin list` y `/plugin` también informaban que los plugins de un nombre imitador no se habían podido cargar, sin señalar el nombre del marketplace como la causa.

4407 4469 

4408**Qué hacer:**4470**Qué hacer:**

4409 4471 

4410* Para conservar un marketplace que un archivo de configuración declara en línea con `"source": "settings"`, cámbiale el nombre antes de eliminar el nombre anterior, porque eliminar el marketplace también borra su entrada de tus archivos de configuración. Claude Code v2.1.292 o posterior enumera estos pasos en el mensaje:4472* Para conservar un marketplace que un archivo de configuración declara en línea con `"source": "settings"`, cámbiale el nombre antes de eliminar el nombre anterior, porque eliminar el marketplace también borra su entrada de tus archivos de configuración. Claude Code v2.1.292 o posterior enumera estos pasos en el mensaje:

4411 1. En cada archivo de configuración que incluya el marketplace en `extraKnownMarketplaces`, asigna a la clave de la entrada y a su `source.name` un mismo nombre nuevo en ASCII simple que no parezca oficial. Si un administrador agrega el marketplace mediante la configuración administrada de tu organización, el administrador realiza este paso4473 1. En cada archivo de configuración que incluya el marketplace en `extraKnownMarketplaces`, asigna a la clave de la entrada y a su `source.name` un mismo nombre nuevo en ASCII simple que no parezca uno oficial. Si un administrador agrega el marketplace mediante la configuración administrada de tu organización, el administrador se encarga de este paso

4412 2. Ejecuta `claude plugin marketplace remove <old-name>`, o elimina el nombre anterior en la pestaña **Marketplaces** de `/plugin`. Esto también desinstala sus plugins y elimina sus datos, opciones y secretos4474 2. Ejecuta `claude plugin marketplace remove <old-name>`, o elimina el nombre anterior en la pestaña **Marketplaces** de `/plugin`. Esto también desinstala sus plugins y borra sus datos, opciones y secretos

4413 3. Inicia Claude Code de nuevo, en la carpeta del proyecto si el archivo es un archivo de configuración de un proyecto. Luego instala los plugins desde el marketplace renombrado4475 3. Inicia Claude Code de nuevo, en la carpeta del proyecto si el archivo es el archivo de configuración de un proyecto. Luego instala los plugins desde el marketplace renombrado

4414* Para conservar cualquier otro marketplace, espera hasta que su mantenedor lo renombre y luego ejecuta `claude plugin marketplace update <name>`4476* Para conservar cualquier otro marketplace, espera a que su mantenedor le cambie el nombre y luego ejecuta `claude plugin marketplace update <name>`

4415* Para eliminar el marketplace, ejecuta `claude plugin marketplace remove <name>`. Esto también desinstala los plugins instalados desde el marketplace y elimina sus datos, opciones y secretos4477* Para eliminar el marketplace, ejecuta `claude plugin marketplace remove <name>`. Esto también desinstala los plugins instalados desde el marketplace y borra sus datos, opciones y secretos

4416* Si publica el marketplace, cámbielo de nombre en su `marketplace.json`; los usuarios luego actualizan el marketplace en lugar de eliminarlo4478* Si publicas el marketplace, cámbiale el nombre en tu `marketplace.json`; así los usuarios actualizan el marketplace en lugar de eliminarlo

4417 4479 

4418### Marketplace is already added from a different source4480### Marketplace is already added from a different source

4419 4481 

4420Indicaste una nueva fuente de marketplace con [`--marketplace <source>` en el comando de instalación](https://code.claude.com/docs/es/plugins/install#add-a-marketplace-and-install-in-one-command), en una sesión o desde tu shell. El catálogo que Claude Code obtuvo de esa fuente tiene el mismo nombre que un marketplace que ya agregaste desde una fuente diferente. Claude Code mantiene el marketplace existente en lugar de reemplazarlo, y el plugin no se instala.4482Indicaste un nuevo origen de marketplace con [`--marketplace <source>` en el comando de instalación](https://code.claude.com/docs/es/plugins/install#add-a-marketplace-and-install-in-one-command), en una sesión o desde tu shell. El catálogo que Claude Code obtuvo de ese origen tiene el mismo nombre que un marketplace que ya agregaste desde un origen diferente. Claude Code conserva el marketplace existente en lugar de reemplazarlo, y el plugin no se instala.

4421 4483 

4422```text theme={null}4484```text theme={null}

4423Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.4485Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

4425 4487 

4426**Qué hacer:**4488**Qué hacer:**

4427 4489 

4428* Si el marketplace que ya agregó es el que desea, instale desde él por nombre: `/plugin install <plugin>@<name>`4490* Si el marketplace que ya agregaste es el que quieres, instala desde él por nombre: `/plugin install <plugin>@<name>`

4429* Para cambiar a la nueva fuente, ejecute `/plugin marketplace remove <name>`, luego reintente la instalación4491* Para cambiar al nuevo origen, ejecuta `/plugin marketplace remove <name>` y luego reintenta la instalación

4430 4492 

4431### Plugin command references user\_config in a shell command4493### Un comando de plugin hace referencia a user\_config en un comando de shell

4432 4494 

4433Un hook de plugin, [monitor](https://code.claude.com/docs/es/plugins/components.md#monitors), o comando MCP [`headersHelper`](https://code.claude.com/docs/es/mcp#use-dynamic-headers-for-custom-authentication) hace referencia a una [opción de plugin](https://code.claude.com/docs/es/plugins/manifest-reference.md#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 se ha configurado ningún valor. Antes de v2.1.207, el valor se sustituía en el comando del shell.4495Un comando de hook, [monitor](https://code.claude.com/docs/es/plugins/components.md#monitors) o [`headersHelper`](https://code.claude.com/docs/es/mcp#use-dynamic-headers-for-custom-authentication) de MCP de un plugin hace referencia a una [opción del plugin](https://code.claude.com/docs/es/plugins/manifest-reference.md#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 allí como código, así que Claude Code se niega a iniciar el componente en lugar de sustituir el valor. La comprobación se ejecuta sobre la plantilla del comando, por lo que el error aparece incluso cuando todavía no hay ningún valor configurado. Antes de la v2.1.207, el valor se sustituía en el comando de shell.

4434 4496 

4435La redacción depende de qué superficie hizo referencia a la opción. Un hook de forma de shell informa:4497La redacción depende de qué superficie hizo referencia a la opción. Un hook en forma de shell informa:

4436 4498 

4437```text theme={null}4499```text theme={null}

4438Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}4500Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

4452 4514 

4453**Qué hacer:**4515**Qué hacer:**

4454 4516 

4455* Para un hook, agregue una matriz `args` para que se ejecute en [forma exec](https://code.claude.com/docs/es/hooks.md#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 script4517* Para un hook, agrega un arreglo `args` para que se ejecute en [forma exec](https://code.claude.com/docs/es/hooks.md#exec-form-and-shell-form), donde cada `${user_config.KEY}` se convierte en un argumento sin un shell de por medio. O quita la referencia y lee la variable de entorno `$CLAUDE_PLUGIN_OPTION_<KEY>` dentro del script

4456* Para un monitor, elimine la referencia y haga que el script del monitor lea el valor de un archivo de configuración4518* Para un monitor, quita la referencia y haz que el script del monitor lea el valor desde un archivo de configuración

4457* Para un `headersHelper`, mueva `${user_config.KEY}` al campo `headers` del servidor, que no se analiza con shell, o lea el valor dentro del script del helper4519* Para un `headersHelper`, mueve `${user_config.KEY}` al campo `headers` del servidor, que no es analizado por el shell, o lee el valor dentro del script auxiliar

4458 4520 

4459### Plugin archive integrity check failed4521### Plugin archive integrity check failed

4460 4522 

4461La entrada del marketplace del plugin utiliza una [fuente `archive`](https://code.claude.com/docs/es/plugins/marketplace-reference#archive-plugin-source) con un pin `sha256`, y el resumen del archivo descargado no coincide con el pin. Claude Code rechaza la instalación, por lo que nada cambia en la caché de plugins. La falta de coincidencia tiene tres causas posibles:4523La entrada del plugin en el marketplace usa un [origen `archive`](https://code.claude.com/docs/es/plugins/marketplace-reference#archive-plugin-source) con un valor fijado `sha256`, y el resumen del archivo descargado no coincide con ese valor. Claude Code rechaza la instalación, así que nada cambia en la caché de plugins. La discrepancia tiene tres causas posibles:

4462 4524 

4463* El archivo en la URL cambió después de que el autor calculó el pin4525* El archivo en la URL cambió después de que el autor calculó el valor fijado

4464* El autor ingresó el resumen incorrecto en la entrada del marketplace4526* El autor ingresó un resumen incorrecto en la entrada del marketplace

4465* La URL sirve un archivo diferente al que el autor fijó4527* La URL sirve un archivo distinto del que el autor fijó

4466 4528 

4467```text theme={null}4529```text theme={null}

4468Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.4530Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

4470 4532 

4471**Qué hacer:**4533**Qué hacer:**

4472 4534 

4473* Si publica el plugin, recalcule el resumen del archivo exacto que sirve la URL, por ejemplo con `shasum -a 256 my-plugin.zip`, o `Get-FileHash -Algorithm SHA256 my-plugin.zip` en PowerShell, y actualice el `sha256` en la entrada del marketplace4535* Si publicas el plugin, vuelve a calcular el resumen del archivo exacto que sirve la URL, por ejemplo con `shasum -a 256 my-plugin.zip`, o `Get-FileHash -Algorithm SHA256 my-plugin.zip` en PowerShell, y actualiza el `sha256` en la entrada del marketplace

4474* Si instala el plugin, ejecute `/plugin marketplace update <name>` para actualizar el catálogo en caso de que la entrada se haya corregido, luego reintente la instalación4536* Si instalas el plugin, ejecuta `/plugin marketplace update <name>` para actualizar el catálogo por si la entrada se corrigió, y luego reintenta la instalación

4475* Si los resúmenes aún no coinciden después de una actualización, pregunte al propietario del marketplace qué archivo fijaron antes de instalar4537* Si los resúmenes siguen sin coincidir después de la actualización, pregunta al propietario del marketplace qué archivo fijó antes de instalar

4476 4538 

4477### Path escapes plugin directory4539### Path escapes plugin directory

4478 4540 

4479Una de las rutas de componentes del plugin conduce fuera del directorio del plugin o no se pudo confirmar que esté dentro de él, por lo que Claude Code descarta esa ruta y carga el resto del plugin. Para una ruta que el plugin declara en `plugin.json` o en su [entrada de marketplace](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-entries), el nombre del componente en el mensaje, como `commands` o `hooks`, indica el campo que declaró la ruta.4541Una de las rutas de componentes del plugin lleva fuera del directorio del plugin o no se pudo confirmar que esté dentro de él, así que Claude Code descarta esa ruta y carga el resto del plugin. Para una ruta que el plugin declara en `plugin.json` o en su [entrada del marketplace](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-entries), el nombre del componente en el mensaje, como `commands` o `hooks`, indica el campo que declaró la ruta.

4480 4542 

4481```text theme={null}4543```text theme={null}

4482commands path escapes plugin directory: ./../shared.md4544commands path escapes plugin directory: ./../shared.md

4484 4546 

4485En la salida del comando `claude plugin`, el mismo error dice `Path escapes plugin directory: ./../shared.md (commands)`.4547En la salida del comando `claude plugin`, el mismo error dice `Path escapes plugin directory: ./../shared.md (commands)`.

4486 4548 

4487Claude Code rechaza tanto una ruta que apunta fuera del plugin tal como está escrita, como `../shared-utils`, como un enlace simbólico que conduce fuera del plugin y no es uno que las [reglas de enlace simbólico del marketplace](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks) permitan. Para un enlace simbólico, el mensaje también dice dónde se resuelve la ruta:4549Claude Code rechaza tanto una ruta que apunta fuera del plugin tal como está escrita, como `../shared-utils`, como un enlace simbólico que lleva fuera del plugin y que no está permitido por las [reglas de enlaces simbólicos del marketplace](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks). Para un enlace simbólico, el mensaje también indica adónde se resuelve la ruta:

4488 4550 

4489```text theme={null}4551```text theme={null}

4490commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4552commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

4491```4553```

4492 4554 

4493Un mensaje que da la ruta completa de uno de los archivos propios de un plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code omitió ese archivo. Eso ocurre cuando Claude Code no puede confirmar que el archivo está dentro del plugin o, para un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), dentro de ese marketplace. El mensaje informa cada uno de estos archivos bajo el nombre de componente indicado:4555Un mensaje que da la ruta completa de uno de los propios archivos de un plugin de marketplace, como `hooks/hooks.json`, significa que Claude Code omitió ese archivo. Cuando Claude Code no puede confirmar que el archivo está dentro del plugin, o dentro de su marketplace en el caso de un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), omite el archivo. El mensaje informa estos archivos con el nombre de componente indicado:

4494 4556 

4495* `hooks/hooks.json`: `hooks`4557* `hooks/hooks.json`: `hooks`

4496* `monitors/monitors.json`: `monitors`4558* `monitors/monitors.json`: `monitors`

4497* `settings.json`: `settings`

4498* `SKILL.md` en la raíz del plugin: `skills`4559* `SKILL.md` en la raíz del plugin: `skills`

4499 4560 

4500Por ejemplo, este mensaje corresponde a un `hooks/hooks.json` que se resuelve fuera tanto del plugin como de su marketplace local:4561Por ejemplo, este mensaje corresponde a un `hooks/hooks.json` que se resuelve fuera tanto del plugin como de su marketplace local:

4503hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory4564hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory

4504```4565```

4505 4566 

4506En macOS y Linux, Claude Code también rechaza una ruta de componente que contenga una barra invertida en cualquier lugar, incluso cuando la ruta permanece dentro del plugin. Un plugin cuyas rutas de componentes utilizan separadores de estilo Windows se carga en Windows y activa este rechazo en las otras plataformas:4567En macOS y Linux, Claude Code también rechaza una ruta de componente que contenga una barra invertida en cualquier parte, incluso cuando la ruta permanece dentro del plugin. Un plugin cuyas rutas de componentes usan separadores al estilo de Windows se carga en Windows y provoca este rechazo en las demás plataformas:

4507 4568 

4508```text theme={null}4569```text theme={null}

4509commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform4570commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

4510```4571```

4511 4572 

4512Antes de v2.1.251, Claude Code cargaba una ruta `commands` declarada en una entrada de marketplace incluso cuando apuntaba fuera del directorio del plugin.4573Antes de la v2.1.251, Claude Code cargaba una ruta `commands` declarada en una entrada del marketplace incluso cuando apuntaba fuera del directorio del plugin.

4513 4574 

4514Antes de v2.1.257, la verificación de las rutas que declara el plugin solo miraba la forma en que estaba escrita la ruta, no adónde conducía un enlace simbólico.4575Antes de la v2.1.257, la comprobación de las rutas que declara el plugin solo miraba cómo estaba escrita la ruta, no adónde lleva un enlace simbólico.

4515 4576 

4516**Qué hacer:**4577**Qué hacer:**

4517 4578 

4518* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor4579* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor

4519* Para una ruta que declara el plugin, mueve el archivo referenciado dentro del directorio del plugin y haz que la ruta apunte a él con una ruta relativa `./`4580* Para una ruta que declara el plugin, mueve el archivo referenciado dentro del directorio del plugin y haz que la ruta apunte a él con una ruta relativa `./`

4520* Si la ruta, o una carpeta por encima de ella dentro del plugin, es un enlace simbólico que conduce fuera del plugin, reemplaza el enlace simbólico con una copia de aquello a lo que apunta4581* Si la ruta, o una carpeta superior a ella dentro del plugin, es un enlace simbólico que lleva fuera del plugin, reemplaza el enlace simbólico por una copia de aquello a lo que apunta

4521* Si el mensaje dice que una ruta que declara el plugin contiene una barra invertida, escribe la ruta con barras diagonales, por ejemplo `./commands/deploy.md`4582* Si el mensaje dice que una ruta que declara el plugin contiene una barra invertida, escribe la ruta con barras diagonales, por ejemplo `./commands/deploy.md`

4522* Si el mensaje termina con `EACCES`, restaura tu permiso de ejecución en cada directorio que conduce al archivo o carpeta que indica la ruta. Revisa los directorios por encima de la ruta y luego sigue cada enlace simbólico que encuentres y revisa los directorios que conducen a donde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo verificar](#path-could-not-be-checked).4583* Si el mensaje termina con `EACCES`, restablece tu permiso de ejecución en cada directorio que lleva al archivo o carpeta que indica la ruta. Revisa los directorios por encima de la ruta, luego sigue cada enlace simbólico que encuentres y revisa los directorios que llevan adonde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo comprobar](#path-could-not-be-checked).

4523* Para compartir archivos con otros plugins en el mismo marketplace, vincúlelos con un enlace simbólico dentro del directorio del plugin, siguiendo las [reglas de enlace simbólico](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)4584* Para compartir archivos con otros plugins del mismo marketplace, vincúlalos con un enlace simbólico dentro del directorio del plugin, siguiendo las [reglas de enlaces simbólicos](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

4524 4585 

4525### Server file path not read4586### No se leyó la ruta del archivo de servidor

4526 4587 

4527El mensaje `path not read` significa que Claude Code no leyó un archivo de servidor MCP o LSP que nombra un plugin, debido a la ruta del archivo. El resto del plugin se carga, sin los servidores que define el archivo.4588El mensaje `path not read` significa que Claude Code no leyó un archivo de servidor MCP o LSP que un plugin indica, debido a la ruta del archivo. El resto del plugin se carga, sin los servidores que define el archivo.

4528 4589 

4529Una parte `..` cuenta incluso cuando la ruta permanece dentro del plugin, como en este ejemplo:4590Una parte `..` cuenta incluso cuando la ruta permanece dentro del plugin, como en este ejemplo:

4530 4591 

4535**Qué hacer:**4596**Qué hacer:**

4536 4597 

4537* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor4598* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor

4538* Si mantienes el plugin, conserva el archivo de servidor dentro del directorio del plugin. Nómbralo en el manifiesto o en la entrada de marketplace con una ruta que comience con `./` y no tenga `..`, por ejemplo `./servers/x.json`4599* Si mantienes el plugin, conserva el archivo de servidor dentro del directorio del plugin. Indícalo en el manifiesto o en la entrada del marketplace con una ruta que comience con `./` y no tenga `..`, por ejemplo `./servers/x.json`

4539* Para compartir un archivo de servidor entre plugins del mismo marketplace, vincula el archivo en cada plugin con un enlace simbólico, siguiendo las [reglas de enlaces simbólicos](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)4600* Para compartir un archivo de servidor entre plugins del mismo marketplace, vincula el archivo en cada plugin con un enlace simbólico, siguiendo las [reglas de enlaces simbólicos](https://code.claude.com/docs/es/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

4540 4601 

4541### Plugin not loaded: its manifest was not read4602### Plugin not loaded: its manifest was not read

4542 4603 

4543Claude Code no pudo confirmar que el [manifiesto](https://code.claude.com/docs/es/plugins/manifest-reference.md) de un plugin de marketplace en `.claude-plugin/plugin.json` está dentro del plugin, por lo que no carga nada de ese plugin. Para un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), Claude Code tampoco pudo confirmar que el manifiesto está dentro de ese marketplace. El mensaje aparece en la pestaña **Errors** de `/plugin`, y el motivo al final indica lo que encontró Claude Code.4604Claude Code no pudo confirmar que el [manifiesto](https://code.claude.com/docs/es/plugins/manifest-reference.md) de un plugin de marketplace en `.claude-plugin/plugin.json` esté dentro del plugin, así que no carga nada de ese plugin. Para un plugin en un [marketplace local](https://code.claude.com/docs/es/plugins/loading.md#in-place-and-copied-plugins), Claude Code tampoco pudo confirmar que el manifiesto esté dentro de ese marketplace. El mensaje aparece en la pestaña **Errors** de `/plugin`, y el motivo al final indica lo que encontró Claude Code.

4544 4605 

4545Por ejemplo, este mensaje corresponde a un plugin en un marketplace local cuya carpeta `.claude-plugin` es un enlace simbólico que conduce fuera del marketplace:4606Por ejemplo, este mensaje corresponde a un plugin en un marketplace local cuya carpeta `.claude-plugin` es un enlace simbólico que lleva fuera del marketplace:

4546 4607 

4547```text theme={null}4608```text theme={null}

4548Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory4609Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory

4550 4611 

4551**Qué hacer:**4612**Qué hacer:**

4552 4613 

4553* Si el motivo termina con `EACCES`, restaura tu permiso de ejecución en cada directorio que conduce al manifiesto. Revisa los directorios por encima del manifiesto y luego sigue cada enlace simbólico que encuentres y revisa los directorios que conducen a donde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo verificar](#path-could-not-be-checked).4614* Si el motivo termina con `EACCES`, restablece tu permiso de ejecución en cada directorio que lleva al manifiesto. Revisa los directorios por encima del manifiesto, luego sigue cada enlace simbólico que encuentres y revisa los directorios que llevan adonde apunta. Para cualquier otro código de error, búscalo en las [causas y pasos para una ruta que no se pudo comprobar](#path-could-not-be-checked).

4554* Si mantienes el plugin y el motivo indica dónde se resuelve el manifiesto, la carpeta `.claude-plugin` o el propio `plugin.json` es un enlace simbólico que conduce allí. Reemplaza ese enlace con una copia de aquello a lo que apunta.4615* Si mantienes el plugin y el motivo indica adónde se resuelve el manifiesto, la carpeta `.claude-plugin` o el propio `plugin.json` es un enlace simbólico que lleva allí. Reemplaza ese enlace por una copia de aquello a lo que apunta.

4555* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor4616* Si instalaste el plugin y no lo mantienes, informa el mensaje a su autor

4556 4617 

4557### Path could not be checked4618### La ruta no se pudo comprobar

4558 4619 

4559Claude Code le preguntó al sistema operativo si existe una ruta de plugin y obtuvo un error que no sea "no encontrado", por lo que no carga lo que la ruta nombra. Cuánto del plugin se carga depende de qué ruta falló:4620Claude Code preguntó al sistema operativo si existe una ruta del plugin y obtuvo un error distinto de "no encontrado", así que no carga lo que indica la ruta. Cuánto del plugin se carga depende de qué ruta falló:

4560 4621 

4561* Una de las [ubicaciones de componentes predeterminadas](https://code.claude.com/docs/es/plugins/manifest-reference.md#standard-layout) de un plugin, como la carpeta `skills/`, el archivo `monitors/monitors.json`, o un [`SKILL.md` en la raíz del plugin](https://code.claude.com/docs/es/plugins/components#skills): los otros componentes del plugin aún se cargan4622* Una de las [ubicaciones predeterminadas de componentes](https://code.claude.com/docs/es/plugins/manifest-reference.md#standard-layout) de un plugin, como la carpeta `skills/`, el archivo `monitors/monitors.json` o un [`SKILL.md` en la raíz del plugin](https://code.claude.com/docs/es/plugins/components#skills): los demás componentes del plugin se siguen cargando

4562* El directorio del plugin en sí: nada de ese plugin se carga4623* El propio directorio del plugin: no se carga nada de ese plugin

4563 4624 

4564No ve este error para una ruta que no existe en absoluto. En `/plugin`, el error aparece bajo el plugin y nombra la ruta y el código que devolvió el sistema operativo:4625No ves este error para una ruta que no existe en absoluto. En `/plugin`, el error aparece bajo el plugin e indica la ruta y el código que devolvió el sistema operativo:

4565 4626 

4566```text theme={null}4627```text theme={null}

4567skills path could not be checked: /home/user/my-plugin/skills (ELOOP)4628skills path could not be checked: /home/user/my-plugin/skills (ELOOP)

4569 4630 

4570En `claude plugin list`, el mismo error dice `Path not found: /home/user/my-plugin/skills (skills, ELOOP)`.4631En `claude plugin list`, el mismo error dice `Path not found: /home/user/my-plugin/skills (skills, ELOOP)`.

4571 4632 

4572Las causas que producen este error incluyen:4633Entre las causas que producen este error están:

4573 4634 

4574* `ELOOP`: un enlace simbólico en la ruta apunta a sí mismo o forma un bucle4635* `ELOOP`: un enlace simbólico en la ruta apunta a sí mismo o forma un bucle

4575* `EIO` o `ESTALE`: la ruta está en un montaje de red que está roto o obsoleto4636* `EIO` o `ESTALE`: la ruta está en un montaje de red roto u obsoleto

4576* `EACCES`: uno de los directorios por encima de la ruta le niega permiso para atravesarlo4637* `EACCES`: uno de los directorios por encima de la ruta te niega el permiso para recorrerlo

4577 4638 

4578**Qué hacer:**4639**Qué hacer:**

4579 4640 

4580* Reemplace un enlace simbólico que apunta a sí mismo con una carpeta real, o elimínelo4641* Reemplaza un enlace simbólico que apunta a sí mismo por una carpeta real, o elimínalo

4581* Si la ruta está en un montaje de red, remonte el recurso compartido4642* Si la ruta está en un montaje de red, vuelve a montar el recurso compartido

4582* Si el código es `EACCES`, restaure su permiso de ejecución en los directorios por encima de la ruta4643* Si el código es `EACCES`, restablece tu permiso de ejecución en los directorios por encima de la ruta

4583* Ejecute `/reload-plugins` después de corregir la ruta, o reinicie Claude Code, para cargar el plugin o componente4644* Ejecuta `/reload-plugins` después de corregir la ruta, o reinicia Claude Code, para cargar el plugin o componente

4584 4645 

4585Antes de v2.1.265, Claude Code trataba una carpeta de componentes predeterminada que no podía verificar como ausente y cargaba el plugin sin ese componente, sin error.4646Antes de la v2.1.265, Claude Code trataba una carpeta de componente predeterminada que no podía comprobar como ausente y cargaba el plugin sin ese componente, sin mostrar ningún error.

4586 4647 

4587### Marketplace entry path does not stay inside the marketplace directory4648### La ruta de la entrada del marketplace no permanece dentro del directorio del marketplace

4588 4649 

4589La [entrada de marketplace](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-entries) del plugin declara una ruta de fuente que Claude Code no puede resolver a una ubicación dentro del directorio del marketplace en sí, por lo que el plugin no se instala ni se carga. La negativa cubre:4650La [entrada del marketplace](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-entries) del plugin declara una ruta de origen que Claude Code no puede resolver a una ubicación dentro del propio directorio del marketplace, así que el plugin no se instala ni se carga. El rechazo abarca:

4590 4651 

4591* Una ruta de entrada que es absoluta, sube fuera del marketplace con `..`, o está escrita como una ruta de red4652* Una ruta de entrada que es absoluta, sale del marketplace con `..` o está escrita como una ruta de red

4592* En macOS y Linux, una ruta de entrada que contiene una barra invertida en cualquier lugar después del `./` inicial4653* En macOS y Linux, una ruta de entrada que contiene una barra invertida en cualquier parte después del `./` inicial

4593* Una entrada en un marketplace obtenido de una fuente remota, como git o una URL, que alcanza su destino a través de un enlace simbólico que se resuelve fuera del directorio del marketplace4654* Una entrada en un marketplace obtenido desde un origen remoto, como git o una URL, que llega a su destino a través de un enlace simbólico que se resuelve fuera del directorio del marketplace

4594* Una entrada relativa en un marketplace agregado desde una URL directa a su `marketplace.json`: Claude Code descarga solo ese archivo, por lo que no existen archivos de plugin locales para que la ruta nombre. Consulte [Plugins with relative paths fail in URL-based marketplaces](https://code.claude.com/docs/es/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces)4655* Una entrada relativa en un marketplace agregado desde una URL directa a su `marketplace.json`: Claude Code descarga solo ese archivo, así que no existen archivos locales del plugin que la ruta pueda indicar. Consulta [Los plugins con rutas relativas fallan en marketplaces basados en URL](https://code.claude.com/docs/es/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces)

4595 4656 

4596`claude plugin install` informa la negativa así:4657`claude plugin install` informa el rechazo así:

4597 4658 

4598```text theme={null}4659```text theme={null}

4599Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)4660Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)

4600```4661```

4601 4662 

4602Cuando la entrada de un plugin ya instalado falla la misma verificación, `claude plugin list` muestra el plugin como `failed to load` con:4663Cuando la entrada de un plugin ya instalado no supera la misma comprobación, `claude plugin list` muestra el plugin como `failed to load` con:

4603 4664 

4604```text theme={null}4665```text theme={null}

4605Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.4666Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.

4607 4668 

4608**Qué hacer:**4669**Qué hacer:**

4609 4670 

4610* Si mantiene el marketplace, escriba la `source` de la entrada como una ruta relativa simple con barras diagonales, como `./plugins/my-plugin`, y mantenga cualquier enlace simbólico que cruce apuntado dentro del directorio del marketplace4671* Si mantienes el marketplace, escribe el `source` de la entrada como una ruta relativa simple con barras diagonales, como `./plugins/my-plugin`, y mantén cualquier enlace simbólico que atraviese apuntando dentro del directorio del marketplace

4611* Si agregó el marketplace desde una URL directa, las entradas relativas no pueden resolverse. Pida al autor del marketplace que use [otra fuente de plugin](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-sources), o agregue el marketplace desde su repositorio de git en su lugar4672* Si agregaste el marketplace desde una URL directa, las entradas relativas no se pueden resolver. Pide al autor del marketplace que use [otro origen de plugin](https://code.claude.com/docs/es/plugins/marketplace-reference.md#plugin-sources), o agrega el marketplace desde su repositorio git

4612 4673 

4613### Failed to load marketplace configuration4674### Failed to load marketplace configuration

4614 4675 

4615Claude Code mantiene los marketplaces de plugins que ha agregado en un archivo de registro en `~/.claude/plugins/known_marketplaces.json`. Un comando de plugin que necesita el registro, como `claude plugin install`, falla con uno de dos mensajes cuando Claude Code no puede usar el archivo:4676Claude Code guarda los marketplaces de plugins que agregaste en un archivo de registro en `~/.claude/plugins/known_marketplaces.json`. Un comando de plugin que necesita el registro, como `claude plugin install`, falla con uno de dos mensajes cuando Claude Code no puede usar el archivo:

4616 4677 

4617* `Failed to load marketplace configuration`: el archivo no es JSON válido, o no se puede leer. Un archivo vacío falla de esta manera también.4678* `Failed to load marketplace configuration`: el archivo existe, pero no es JSON válido o no se puede leer. Un archivo vacío también falla de esta manera.

4618* `Marketplace configuration file is corrupted`: el archivo es JSON válido pero su contenido no coincide con el esquema del registro.4679* `Marketplace configuration file is corrupted`: el archivo es JSON válido, pero su contenido no coincide con el esquema del registro.

4619 4680 

4620Con un archivo vacío, `claude plugin install` informa:4681Con un archivo vacío, `claude plugin install` informa:

4621 4682 

4623✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF4684✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF

4624```4685```

4625 4686 

4626Antes de v2.1.246, `claude plugin install` no informaba esta falla.4687Antes de la v2.1.246, `claude plugin install` no informaba este fallo.

4627 4688 

4628**Qué hacer:**4689**Qué hacer:**

4629 4690 

4630* Abra `~/.claude/plugins/known_marketplaces.json` y repare el JSON, o corrija las entradas que el mensaje nombra como no coincidentes con el esquema del registro4691* Abre `~/.claude/plugins/known_marketplaces.json` y repara el JSON, o corrige las entradas que el mensaje indica que no coinciden con el esquema del registro

4631* Si no puede repararlo, elimine el archivo o reemplace su contenido con `{}`, luego vuelva a agregar cada marketplace con `claude plugin marketplace add <source>`. Claude Code vuelve a registrar los marketplaces que su configuración de usuario o administrada declara en [`extraKnownMarketplaces`](https://code.claude.com/docs/es/settings-reference#extraknownmarketplaces) la próxima vez que lo inicie en una carpeta que haya confiado.4692* Si no puedes repararlo, elimina el archivo o reemplaza su contenido por `{}`, y luego vuelve a agregar cada marketplace con `claude plugin marketplace add <source>`. Claude Code vuelve a registrar los marketplaces que tu configuración de usuario o tu configuración administrada declaran en [`extraKnownMarketplaces`](https://code.claude.com/docs/es/settings-reference#extraknownmarketplaces) la próxima vez que lo inicies en una carpeta en la que hayas confiado.

4632 4693 

4633### Plugin is required by your organization4694### El plugin es obligatorio en tu organización

4634 4695 

4635Ejecutó `claude plugin disable`, o utilizó la pestaña **Installed** de `/plugin`, para desactivar un [plugin sincronizado desde claude.ai](https://code.claude.com/docs/es/plugins/loading.md#synced-plugins) que su organización marca como requerido:4696Ejecutaste `claude plugin disable`, o usaste la pestaña **Installed** de `/plugin`, para desactivar un [plugin sincronizado desde claude.ai](https://code.claude.com/docs/es/plugins/loading.md#synced-plugins) que tu organización marca como obligatorio:

4636 4697 

4637```text theme={null}4698```text theme={null}

4638Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.4699Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

4639```4700```

4640 4701 

4641Claude Code no guarda nada y el plugin permanece habilitado.4702Claude Code no guarda nada y el plugin permanece activado.

4642 4703 

4643Cuando intenta desactivar un plugin del que depende un plugin requerido, Claude Code rechaza de la misma manera, con un mensaje que nombra el plugin requerido que lo necesita.4704Cuando intentas desactivar un plugin del que depende un plugin obligatorio, Claude Code lo rechaza de la misma manera, con un mensaje que indica el plugin obligatorio que lo necesita.

4644 4705 

4645**Qué hacer:**4706**Qué hacer:**

4646 4707