Documentation 2026-11-11 22:59 UTC to 2026-11-12 23:02 UTC

254| Fuente | Cuándo se carga | Impacto |254| Fuente | Cuándo se carga | Impacto |

255| :- | :- | :- |255| :- | :- | :- |

256| **Prompt del sistema** | Cada solicitud | Costo fijo pequeño, siempre presente |256| **Prompt del sistema** | Cada solicitud | Costo fijo pequeño, siempre presente |

257| **Archivos CLAUDE.md** | Inicio de sesión, a través de [`settingSources`](https://code.claude.com/docs/es/agent-sdk/claude-code-features) | Contenido completo en cada solicitud (pero almacenado en caché de prompt, así que solo la primera solicitud paga el costo completo) |257| **Archivos CLAUDE.md** | Inicio de sesión, a través de [`settingSources`](https://code.claude.com/docs/es/agent-sdk/claude-code-features) | Contenido completo en cada solicitud (pero almacenado en la caché de prompts) |

258| **Definiciones de herramientas** | Cada solicitud para las herramientas integradas principales como Bash, Read y Edit; bajo demanda para las herramientas MCP y otras herramientas integradas, que la [búsqueda de herramientas](https://code.claude.com/docs/es/agent-sdk/mcp.md#mcp-tool-search) difiere por defecto | Todos los esquemas se cargan por adelantado en los casos descritos en [Configurar búsqueda de herramientas](https://code.claude.com/docs/es/agent-sdk/tool-search.md#configure-tool-search) |258| **Definiciones de herramientas** | Cada solicitud para las herramientas integradas principales como Bash, Read y Edit; bajo demanda para las herramientas MCP y otras herramientas integradas, que la [búsqueda de herramientas](https://code.claude.com/docs/es/agent-sdk/mcp.md#mcp-tool-search) difiere por defecto | Todos los esquemas se cargan por adelantado en los casos descritos en [Configurar búsqueda de herramientas](https://code.claude.com/docs/es/agent-sdk/tool-search.md#configure-tool-search) |

259| **Historial de conversación** | Se acumula en turnos | Crece con cada turno: prompts, respuestas, entradas de herramientas, salidas de herramientas |259| **Historial de conversación** | Se acumula en turnos | Crece con cada turno: prompts, respuestas, entradas de herramientas, salidas de herramientas |

260| **Descripciones de skills** | Inicio de sesión, a través de fuentes de configuración | Resúmenes cortos; el contenido completo se carga solo cuando se invoca |260| **Descripciones de skills** | Inicio de sesión, a través de fuentes de configuración | Resúmenes cortos; el contenido completo se carga solo cuando se invoca |

298 298 

299### Las escrituras de espejo son de mejor esfuerzo299### Las escrituras de espejo son de mejor esfuerzo

300 300 

301Si `append()` rechaza, el SDK reintenta el lote hasta dos veces más con un retroceso corto, para un máximo de tres intentos en total. Una llamada que agota el tiempo de espera no se reintenta, ya que la llamada original aún puede llegar. Si el lote aún falla, el SDK registra el error, emite un mensaje `{ type: "system", subtype: "mirror_error" }` en el iterador, descarta el lote y continúa la consulta. Debido a que un lote reintentado puede volver a entregar entradas que ya llegaron, deduplique por `entry.uuid` en su implementación de `append()`.301Si `append()` rechaza, el SDK reintenta el lote hasta dos veces más con un retroceso corto, para un máximo de tres intentos en total. Una llamada que agota el tiempo de espera no se reintenta, ya que la llamada original aún puede llegar. Debido a que un lote reintentado puede volver a entregar entradas que ya llegaron, deduplica por `entry.uuid` en tu implementación de `append()`, y conserva cada entrada que no tenga `uuid`.

302 302 

303Una interrupción del almacén no interrumpe el agente, ya que el subproceso escribe localmente primero. Monitoree `mirror_error` si necesita detectar pérdida de datos del almacén. En una ejecución [reanudada desde el almacén](#resume-from-the-store), un lote descartado no tiene copia sobreviviente una vez que finaliza la ejecución.303Si el lote aún falla, el SDK registra el error, emite un mensaje `{ type: "system", subtype: "mirror_error" }` en el iterador, descarta el lote y continúa la consulta. Una interrupción del almacén no interrumpe el agente, ya que el subproceso escribe localmente primero. Monitorea `mirror_error` para detectar pérdida de datos del almacén. En una ejecución [reanudada desde el almacén](#resume-from-the-store), un lote descartado no tiene copia sobreviviente una vez que finaliza la ejecución.

304 304 

305### `getSessionMessages` devuelve la cadena posterior a la compactación305### `getSessionMessages` devuelve la cadena posterior a la compactación

306 306 

512 512 

513### Ejecutar Mantle junto con la API de Invoke513### Ejecutar Mantle junto con la API de Invoke

514 514 

515Los modelos disponibles para usted en Mantle pueden no incluir todos los modelos que usa hoy. Establecer tanto `CLAUDE_CODE_USE_BEDROCK` como `CLAUDE_CODE_USE_MANTLE` permite que Claude Code llame a ambos puntos finales desde la misma sesión. Los IDs de modelo que coinciden con el formato de Mantle se enrutan a Mantle, y todos los demás IDs de modelo van a la API de Invoke de Amazon Bedrock.515Es posible que los modelos disponibles para ti en Mantle no incluyan todos los modelos que usas hoy. Si te conectas sin un gateway, establece tanto `CLAUDE_CODE_USE_BEDROCK` como `CLAUDE_CODE_USE_MANTLE` para llamar a Mantle y a la API de Invoke desde la misma sesión. Los IDs de modelo que coinciden con el formato de Mantle se enrutan a Mantle, y todos los demás IDs de modelo van a la API de Invoke de Amazon Bedrock.

516 516 

517```bash theme={null}517```bash theme={null}

518export CLAUDE_CODE_USE_BEDROCK=1518export CLAUDE_CODE_USE_BEDROCK=1

618* Si el error nombra una acción `bedrock-mantle:`, otorgue esa acción a su identidad de IAM.618* Si el error nombra una acción `bedrock-mantle:`, otorgue esa acción a su identidad de IAM.

619* Si el error no nombra ninguna acción y sus credenciales son válidas, su cuenta de AWS no ha sido autorizada para acceder al modelo que solicitó. Póngase en contacto con su equipo de cuenta de AWS para solicitar acceso.619* Si el error no nombra ninguna acción y sus credenciales son válidas, su cuenta de AWS no ha sido autorizada para acceder al modelo que solicitó. Póngase en contacto con su equipo de cuenta de AWS para solicitar acceso.

620 620 

621Un `400` que nombra el ID del modelo significa que ese modelo no se sirve en Mantle. Mantle tiene su propio catálogo de modelos separado del catálogo estándar de Amazon Bedrock, por lo que los IDs de perfil de inferencia como `us.anthropic.claude-sonnet-4-6` no funcionan. Usa un ID con formato de Mantle, o habilita [ambos endpoints](#run-mantle-alongside-the-invoke-api) para que Claude Code envíe los IDs de perfil de inferencia a la API de Invoke.621Un `400` que nombra el ID del modelo significa que ese modelo no se sirve en Mantle. Mantle tiene su propio catálogo de modelos separado del catálogo estándar de Amazon Bedrock, por lo que los IDs de perfil de inferencia como `us.anthropic.claude-sonnet-4-6` no funcionan.

622 

623Para resolver el error:

624 

625* **Sin un gateway**: usa un [ID con formato de Mantle](#select-a-mantle-model) que Mantle sirva, o [ejecuta Mantle junto con la API de Invoke](#run-mantle-alongside-the-invoke-api) para enviar los IDs en otros formatos a esa API.

626* **A través de un gateway**: pregunta a su operador qué IDs de modelo usar.

622 627 

623## Recursos adicionales628## Recursos adicionales

624 629 

148 148 

149#### Desactivar scripts en las vistas previas de SSH y WSL para tu organización149#### Desactivar scripts en las vistas previas de SSH y WSL para tu organización

150 150 

151Para evitar que las [vistas previas HTML en sesiones SSH y WSL](#preview-html-files-in-ssh-and-wsl-sessions) ejecuten scripts, establece el [ajuste de configuración administrada `disableBrowserExternalNavigation`](#managed-settings) en `true`. Con este ajuste, los usuarios tampoco pueden [examinar sitios externos](#restrict-external-browsing-for-your-organization) en el panel del navegador.151Para evitar que las [vistas previas HTML en sesiones SSH y WSL](#preview-html-files-in-ssh-and-wsl-sessions) ejecuten scripts, establece el [ajuste de configuración administrada `disableRemotePreviewScripts`](#managed-settings) en `true`. Los usuarios aún pueden examinar sitios externos. Requiere Claude Desktop v5.1231.0 o posterior.

152 152 

153Establécelo en tu [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md), o en una [política MDM o archivo de configuración administrada de Claude Code](https://code.claude.com/docs/es/managed-settings.md#where-each-mechanism-stores-the-policy) en la computadora que ejecuta Desktop. Desktop no lo lee desde la máquina remota ni desde la distribución de WSL. Con un [proveedor externo](https://code.claude.com/docs/es/third-party-integrations.md), usa la política MDM o el archivo.153> [!NOTE]

154>

155> Las versiones anteriores ignoran `disableRemotePreviewScripts`. Para detener los scripts en esas versiones, actualiza Desktop o establece también `disableBrowserExternalNavigation` en `true`. En ese caso, los usuarios [no pueden examinar sitios externos](#restrict-external-browsing-for-your-organization) en ninguna computadora que reciba `disableBrowserExternalNavigation`.

156 

157Establece cada clave en tu [configuración administrada por el servidor](https://code.claude.com/docs/es/server-managed-settings.md), o en una [política MDM o archivo de configuración administrada de Claude Code](https://code.claude.com/docs/es/managed-settings.md#where-each-mechanism-stores-the-policy) en la computadora que ejecuta Desktop. Desktop no lee estas claves desde la máquina remota, la distribución de WSL, un [`policyHelper`](https://code.claude.com/docs/es/settings-reference#policyhelper) ni las [políticas propias de Desktop](#device-management-policies). Con un [proveedor externo](https://code.claude.com/docs/es/third-party-integrations.md), usa la política MDM o el archivo.

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161Luego pide a los usuarios que reinicien Desktop para asegurarte de que el ajuste se aplique, e indícales qué esperar:165Luego pide a los usuarios que reinicien Desktop para asegurarte de que el ajuste se aplique, e indícales qué esperar:

162 166 

163* **Archivos que abren**: la vista previa no ejecuta scripts, por lo que los gráficos y las tablas que dibujan los scripts permanecen vacíos167* **Archivos que abren**: la vista previa no ejecuta scripts, por lo que los gráficos y las tablas que dibujan los scripts permanecen vacíos. Su aviso comienza con `This preview doesn't run scripts`.

164* **Vistas previas que están ejecutando scripts**: si Desktop detecta el ajuste antes del reinicio, se cierran. Los usuarios ven `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`168* **Vistas previas que están ejecutando scripts**: si Desktop detecta el ajuste antes del reinicio, se cierran. Los usuarios ven `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.`

165* **Archivos que exportan**: si un usuario [exporta un archivo](#preview-html-files-in-ssh-and-wsl-sessions) y lo abre en un navegador, sus scripts se ejecutan allí, con o sin este ajuste169* **Archivos que exportan**: si un usuario [exporta un archivo](#preview-html-files-in-ssh-and-wsl-sessions) y lo abre en un navegador, sus scripts se ejecutan allí, con o sin este ajuste

166 170 

171##### Comprobar si los scripts aún se ejecutan en una computadora

172 

173Después del reinicio, abre un archivo HTML desde una sesión SSH o WSL en esa computadora. Si el aviso que aparece encima de la vista previa comienza con `This preview doesn't load anything from the web`, los scripts aún se ejecutan allí. Verifica la [versión de Desktop](#check-your-version), dónde colocaste la clave y que su valor sea el booleano JSON `true`.

174 

167### Examinar sitios externos175### Examinar sitios externos

168 176 

169El panel del navegador es un navegador con pestañas, por lo que puedes abrir documentación, rastreadores de problemas o cualquier otro sitio junto a tu aplicación en ejecución. Para abrir el navegador, presiona **Cmd+Shift+B** en macOS o **Ctrl+Shift+B** en Windows, o haz clic en **Browser** en la barra de título de la sesión. Puedes iniciar sesión en sitios en el panel, incluidos flujos de inicio de sesión emergentes como Google OAuth.177El panel del navegador es un navegador con pestañas, por lo que puedes abrir documentación, rastreadores de problemas o cualquier otro sitio junto a tu aplicación en ejecución. Para abrir el navegador, presiona **Cmd+Shift+B** en macOS o **Ctrl+Shift+B** en Windows, o haz clic en **Browser** en la barra de título de la sesión. Puedes iniciar sesión en sitios en el panel, incluidos flujos de inicio de sesión emergentes como Google OAuth.

2037| `browserExternalPageTools` | establécelo en `"disabled"` para evitar que Claude use herramientas para leer o actuar en páginas externas en el [panel del navegador](#browse-external-sites). Los usuarios aún pueden navegar a sitios externos por sí mismos, y las vistas previas del servidor de desarrollo local no se ven afectadas. |2045| `browserExternalPageTools` | establécelo en `"disabled"` para evitar que Claude use herramientas para leer o actuar en páginas externas en el [panel del navegador](#browse-external-sites). Los usuarios aún pueden navegar a sitios externos por sí mismos, y las vistas previas del servidor de desarrollo local no se ven afectadas. |

2038| `disableMobileSimulatorTools` | establécelo en `true` para bloquear las herramientas de Claude para controlar y capturar dispositivos en el [panel del simulador de iOS](https://code.claude.com/docs/es/desktop-ios-simulator.md#turn-off-simulator-access). El panel permanece utilizable para los toques del usuario; solo se elimina el acceso de Claude. El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |2046| `disableMobileSimulatorTools` | establécelo en `true` para bloquear las herramientas de Claude para controlar y capturar dispositivos en el [panel del simulador de iOS](https://code.claude.com/docs/es/desktop-ios-simulator.md#turn-off-simulator-access). El panel permanece utilizable para los toques del usuario; solo se elimina el acceso de Claude. El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |

2039| `disableBrowserExternalNavigation` | establécelo en `true` para desactivar completamente la navegación externa en el [panel del navegador](#browse-external-sites). Ni los usuarios ni Claude pueden navegar a sitios externos, y las vistas previas del servidor de desarrollo localhost no se ven afectadas. Las vistas previas HTML en sesiones SSH y WSL [no ejecutan scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |2047| `disableBrowserExternalNavigation` | establécelo en `true` para desactivar completamente la navegación externa en el [panel del navegador](#browse-external-sites). Ni los usuarios ni Claude pueden navegar a sitios externos, y las vistas previas del servidor de desarrollo localhost no se ven afectadas. Las vistas previas HTML en sesiones SSH y WSL [no ejecutan scripts](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization). El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |

2048| `disableRemotePreviewScripts` | establécelo en `true` para [desactivar solo los scripts en las vistas previas HTML](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) en sesiones SSH y WSL. Desktop no lo lee desde la máquina remota ni desde la distribución de WSL. El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. Requiere Claude Desktop v5.1231.0 o posterior. |

2040| `sshConfigs` | preconfigura [conexiones SSH](#pre-configure-ssh-connections-for-your-team) que aparecen en el selector de entorno. Los usuarios no pueden eliminar conexiones administradas ni editar nada excepto su propia **Worktree folder**. |2049| `sshConfigs` | preconfigura [conexiones SSH](#pre-configure-ssh-connections-for-your-team) que aparecen en el selector de entorno. Los usuarios no pueden eliminar conexiones administradas ni editar nada excepto su propia **Worktree folder**. |

2041| `sshHostCommands` | ofrece a los usuarios [conexiones SSH cuyo host proviene de un comando](#distribute-commands-to-your-team), junto con las suyas propias. Desktop lo lee desde el archivo de configuración administrada o la política MDM en la computadora, y lo ignora en la [configuración administrada por servidor](https://code.claude.com/docs/es/server-managed-settings.md). Requiere Claude Desktop v3.6556.0 o posterior en macOS o Linux, o v4.16336.0 o posterior en Windows, con la sesión iniciada con una cuenta de Claude. En Windows, Desktop también debe [conectarse a través del cliente OpenSSH](#use-your-ssh-configuration). |2050| `sshHostCommands` | ofrece a los usuarios [conexiones SSH cuyo host proviene de un comando](#distribute-commands-to-your-team), junto con las suyas propias. Desktop lo lee desde el archivo de configuración administrada o la política MDM en la computadora, y lo ignora en la [configuración administrada por servidor](https://code.claude.com/docs/es/server-managed-settings.md). Requiere Claude Desktop v3.6556.0 o posterior en macOS o Linux, o v4.16336.0 o posterior en Windows, con la sesión iniciada con una cuenta de Claude. En Windows, Desktop también debe [conectarse a través del cliente OpenSSH](#use-your-ssh-configuration). |

2042| `sshHostAllowlist` | restringe las [sesiones SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cuyo nombre de host resuelto coincida con uno de estos patrones. Se lee solo desde la configuración administrada. |2051| `sshHostAllowlist` | restringe las [sesiones SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cuyo nombre de host resuelto coincida con uno de estos patrones. Se lee solo desde la configuración administrada. |

2044| `disableSshSavedPasswords` | establécelo en `true` para que Desktop deje de ofrecer recordar las contraseñas SSH y deje de usar o mostrar las que guardó anteriormente. Activarlo no las elimina. Se lee solo desde la configuración administrada. Requiere Claude Desktop v1.49585.0 o posterior. |2053| `disableSshSavedPasswords` | establécelo en `true` para que Desktop deje de ofrecer recordar las contraseñas SSH y deje de usar o mostrar las que guardó anteriormente. Activarlo no las elimina. Se lee solo desde la configuración administrada. Requiere Claude Desktop v1.49585.0 o posterior. |

2045| `managedMcpServers` | envía configuraciones de servidores MCP a todos los usuarios. Disponible solo en despliegues de Desktop de terceros (3P). En cada entrada, establece un transporte `"http"`, `"sse"` o `"stdio"`, los detalles de conexión y, opcionalmente, un mapa `toolPolicy` para restringir qué herramientas de ese servidor pueden invocar los usuarios. Entrégalo a través del archivo de configuración administrada, MDM o el [bloque `desktop`](https://code.claude.com/docs/es/claude-apps-gateway-config#claude-desktop-overlay) de la política de un gateway de aplicaciones Claude, ya que los despliegues de terceros no reciben la configuración de la consola de administración. Para entregarlo a través del gateway, necesitas Claude Code v2.1.232 o posterior en el servidor del gateway. Esta es la clave propia de la aplicación de escritorio; Claude Code lee un [ajuste de configuración administrada con el mismo nombre](https://code.claude.com/docs/es/managed-mcp.md#provide-servers-through-managed-settings) propio, con una forma de entrada diferente. |2054| `managedMcpServers` | envía configuraciones de servidores MCP a todos los usuarios. Disponible solo en despliegues de Desktop de terceros (3P). En cada entrada, establece un transporte `"http"`, `"sse"` o `"stdio"`, los detalles de conexión y, opcionalmente, un mapa `toolPolicy` para restringir qué herramientas de ese servidor pueden invocar los usuarios. Entrégalo a través del archivo de configuración administrada, MDM o el [bloque `desktop`](https://code.claude.com/docs/es/claude-apps-gateway-config#claude-desktop-overlay) de la política de un gateway de aplicaciones Claude, ya que los despliegues de terceros no reciben la configuración de la consola de administración. Para entregarlo a través del gateway, necesitas Claude Code v2.1.232 o posterior en el servidor del gateway. Esta es la clave propia de la aplicación de escritorio; Claude Code lee un [ajuste de configuración administrada con el mismo nombre](https://code.claude.com/docs/es/managed-mcp.md#provide-servers-through-managed-settings) propio, con una forma de entrada diferente. |

2046 2055 

2047Si desactivas una función con `browserExternalPageTools`, `disableMobileSimulatorTools` o `disableBrowserExternalNavigation` en la [política MDM o el archivo de configuración administrada de mayor rango](https://code.claude.com/docs/es/managed-settings.md#how-claude-code-combines-managed-sources) de una computadora, la función permanece desactivada allí. Permanece desactivada incluso cuando tu [configuración administrada por servidor](https://code.claude.com/docs/es/server-managed-settings.md) deja esa clave sin establecer o permite la función. No uses un valor de registro `HKCU` a nivel de usuario para esto. Para volver a activar la función, elimina el valor dondequiera que lo hayas establecido. Requiere Claude Desktop v4.4212.0 o posterior.2056Si desactivas una función con una de estas cuatro claves en la [política MDM o el archivo de configuración administrada de mayor rango](https://code.claude.com/docs/es/managed-settings.md#how-claude-code-combines-managed-sources) de una computadora, la función permanece desactivada allí:

2057 

2058* **`browserExternalPageTools`, `disableMobileSimulatorTools`, `disableBrowserExternalNavigation`**: requiere Claude Desktop v4.4212.0 o posterior

2059* **`disableRemotePreviewScripts`**: requiere Claude Desktop v5.1231.0 o posterior

2060 

2061Permanece desactivada incluso cuando tu [configuración administrada por servidor](https://code.claude.com/docs/es/server-managed-settings.md) deja esa clave sin establecer o permite la función. No uses un valor de registro `HKCU` a nivel de usuario para esto. Para volver a activar la función, elimina el valor dondequiera que lo hayas establecido.

2048 2062 

2049Qué configuración administrada llega a una sesión de Desktop depende de dónde se ejecute esa sesión. Las restricciones de modelo como [`availableModels`](https://code.claude.com/docs/es/model-config#restrict-model-selection) se aplican en las sesiones de Claude Code de Desktop de la misma manera que en la CLI de la terminal; consulta [cobertura de superficie](https://code.claude.com/docs/es/model-config.md#surface-coverage).2063Qué configuración administrada llega a una sesión de Desktop depende de dónde se ejecute esa sesión. Las restricciones de modelo como [`availableModels`](https://code.claude.com/docs/es/model-config#restrict-model-selection) se aplican en las sesiones de Claude Code de Desktop de la misma manera que en la CLI de la terminal; consulta [cobertura de superficie](https://code.claude.com/docs/es/model-config.md#surface-coverage).

2050 2064 

2109>2123>

2110> Verifica el valor de `forceLoginOrgUUID` antes de desplegarlo. Si el ID no es el de tu organización, las personas de tu organización no pueden usar Claude Desktop a menos que también pertenezcan a una organización con ese ID. Para solucionarlo, despliega el ID correcto y pídeles que reinicien Claude Desktop.2124> Verifica el valor de `forceLoginOrgUUID` antes de desplegarlo. Si el ID no es el de tu organización, las personas de tu organización no pueden usar Claude Desktop a menos que también pertenezcan a una organización con ese ID. Para solucionarlo, despliega el ID correcto y pídeles que reinicien Claude Desktop.

2111 2125 

2112Si estableces `forceLoginMethod` y `forceLoginOrgUUID` en la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md) de Claude Code, no cambias la pantalla de inicio de sesión de Claude Desktop.2126Si estableces `forceLoginMethod` y `forceLoginOrgUUID` en la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md) de Claude Code, no cambias la pantalla de inicio de sesión de Claude Desktop. Una persona aún puede usar Claude Desktop con su propia clave de API de Claude o su [cuenta de Claude Console](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in), y ejecutar sesiones de la pestaña Code de esa manera.

2127 

2128Para impedirlo, despliega también `forceLoginOrgUUID` en la política de Claude Desktop (en `HKLM` en Windows), con el ID de tu organización de claude.ai. A menos que la propia política [seleccione la API de Claude](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach), Claude Desktop deja de usar la clave de API o la cuenta de Console propias de una persona en el siguiente inicio de la aplicación.

2129 

2130Verifica dos casos antes de desplegarlo:

2131 

2132* **Organizaciones de Claude Console**: no despliegues `forceLoginOrgUUID` por sí solo con el ID de una organización de Claude Console, o dejarías a tus usuarios sin acceso a Claude Desktop. En su lugar, consulta [Which devices offer the Claude API account sign-in](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in).

2133* **Enterprise Admin Console**: si entrega la configuración de Claude Desktop de tus computadoras, actualízalas primero a Claude Desktop v2.37337.0 o posterior, porque las versiones anteriores la ignoran una vez que se establece esta clave. Consulta [Keep a device on its managed profile](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile).

2113 2134 

2114### Requisitos de acceso a la red2135### Requisitos de acceso a la red

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**: una terminal mantiene la conversación, por ejemplo una donde la reanudaste con `claude --resume` o `/resume`. La fila también muestra `Open in a terminal`.5469* **`running in another terminal`**: un proceso que no es una sesión en segundo plano mantiene la conversación, por ejemplo una ejecución de `claude -p`, o una terminal donde la reanudaste con `claude --resume` o `/resume`. La fila también muestra `Open in a terminal`.

5470* **`already open in another running Claude session`**: otro proceso no interactivo de Claude Code la mantiene, por ejemplo un proceso de [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md#the-supervisor-process) para la misma conversación que aún no ha salido.5470* **`already open in another running Claude session`**: otra [sesión en segundo plano](https://code.claude.com/docs/es/agent-view.md#the-supervisor-process) la mantiene.

5471 5471 

5472**Qué hacer:**5472**Qué hacer:**

5473 5473 

5474* Continúa la conversación en el proceso que la tiene abierta, o sal de ese proceso y abre la fila nuevamente5474* Para `running in another terminal`: continúa en esa terminal, o sal de ese proceso o deja que termine, y luego inténtalo de nuevo

5475* Para `already open in another running Claude session`: usa esa sesión, o detenla y luego inténtalo de nuevo

5475 5476 

5476Antes de v2.1.248, solo existía el rechazo `already open in another running Claude session`: una conversación reanudada en una terminal no contaba como abierta, y abrir la fila iniciaba un segundo proceso de Claude Code que escribía en la misma conversación.5477Antes de v2.1.248, solo existía el rechazo `already open in another running Claude session`: una conversación reanudada en una terminal no contaba como abierta, y abrir la fila iniciaba un segundo proceso de Claude Code que escribía en la misma conversación.

5477 5478 

98 98 

99* **Pro, Max y Ultra**: pagas el modo rápido desde tus créditos de uso. Ve a [**Settings > Usage**](https://claude.ai/settings/usage) en claude.ai, donde la sección **Usage credits** muestra cuánto has gastado en créditos de uso este mes. Esa cifra incluye el modo rápido pero no lo desglosa por separado.99* **Pro, Max y Ultra**: pagas el modo rápido desde tus créditos de uso. Ve a [**Settings > Usage**](https://claude.ai/settings/usage) en claude.ai, donde la sección **Usage credits** muestra cuánto has gastado en créditos de uso este mes. Esa cifra incluye el modo rápido pero no lo desglosa por separado.

100* **Team y Enterprise**: su organización paga el uso del modo rápido desde sus créditos de uso. Para ver su propio gasto de créditos de uso, ejecute [`/usage`](https://code.claude.com/docs/es/costs#check-your-usage-credits-spend). Para ver dónde su organización ve ese gasto, consulte [Claude para Teams y Enterprise](https://code.claude.com/docs/es/costs.md#claude-for-teams-and-enterprise).100* **Team y Enterprise**: su organización paga el uso del modo rápido desde sus créditos de uso. Para ver su propio gasto de créditos de uso, ejecute [`/usage`](https://code.claude.com/docs/es/costs#check-your-usage-credits-spend). Para ver dónde su organización ve ese gasto, consulte [Claude para Teams y Enterprise](https://code.claude.com/docs/es/costs.md#claude-for-teams-and-enterprise).

101* **Claude Console**: tu organización paga el modo rápido junto con el resto de su uso de API. En las páginas [Usage](https://platform.claude.com/usage) y [Cost](https://platform.claude.com/cost) de Console, selecciona **Speed (research preview)** en el menú **Group by** para separar el modo rápido del uso de velocidad estándar. Ves esa opción solo cuando el rango de fechas seleccionado incluye uso del modo rápido.101* **Claude Console**: tu organización paga el modo rápido junto con el resto de su uso de API. En las páginas [Usage](https://platform.claude.com/usage) y [Cost](https://platform.claude.com/cost) de Console, selecciona **Speed** en el menú **Group by** para separar el modo rápido del uso de velocidad estándar. Ves esa opción solo cuando el rango de fechas seleccionado incluye uso del modo rápido.

102 102 

103## Decidir cuándo usar el modo rápido103## Decidir cuándo usar el modo rápido

104 104 

218 218 

219## Mods integrados en Claude Code219## Mods integrados en Claude Code

220 220 

221Algunas de las propias funciones de Claude Code son mods. Para ver los que tiene tu sesión, ejecuta `/plugin` en el prompt de Claude Code y ve a la pestaña **Installed**, que los lista bajo **Built-in**. No puedes actualizar ni desinstalar un mod integrado, y la última columna de la tabla indica cómo desactivar cada uno. La [línea `mods active`](#see-which-mods-a-session-loaded) omite los mods integrados.221Algunas de las propias funciones de Claude Code son mods. Para ver los que tiene tu sesión, ejecuta `/plugin` en el prompt de Claude Code y ve a la pestaña **Installed**, que los lista bajo **Built-in**. No puedes actualizar ni desinstalar un mod integrado. La [línea `mods active`](#see-which-mods-a-session-loaded) omite los mods integrados.

222 222 

223Esta tabla lista cada entrada por el nombre que muestra `/plugin`:223Esta tabla lista algunas de las entradas de **Built-in** por el nombre que muestra `/plugin`:

224 224 

225| Nombre en `/plugin` | Qué hace | Dónde está activo | Cómo desactivarlo |225| Nombre en `/plugin` | Qué hace | Dónde está activo | Cómo desactivarlo |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Envía los registros de analíticas que registran Claude Code y sus mods integrados | Dondequiera que las analíticas propias de Claude Code estén activadas | Deshabilítalo en `/plugin`, o desactiva las analíticas, por ejemplo con [`DISABLE_TELEMETRY`](https://code.claude.com/docs/es/env-vars) |231| `cc-plugin-telemetry` | Envía los registros de analíticas que registran Claude Code y sus mods integrados | Dondequiera que las analíticas propias de Claude Code estén activadas | Deshabilítalo en `/plugin`, o desactiva las analíticas, por ejemplo con [`DISABLE_TELEMETRY`](https://code.claude.com/docs/es/env-vars) |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions): un agente secundario muestra una nota encima del prompt cuando encuentra algo que podrías haber pasado por alto | Desactivado hasta que [lo actives](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions) | Deshabilítalo en `/plugin` |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions): un agente secundario muestra una nota encima del prompt cuando encuentra algo que podrías haber pasado por alto | Desactivado hasta que [lo actives](https://code.claude.com/docs/es/interactive-mode.md#you-should-know-suggestions) | Deshabilítalo en `/plugin` |

233 233 

234Para un plugin de **Built-in** que no está en la tabla, [abre sus detalles en `/plugin`](https://code.claude.com/docs/es/plugins/install#manage-installed-plugins) para leer qué hace o para deshabilitarlo.

235 

234Los ajustes y flags que detienen los mods instalados, como `disableAllHooks`, `--bare` y `--safe-mode`, no detienen los mods integrados.236Los ajustes y flags que detienen los mods instalados, como `disableAllHooks`, `--bare` y `--safe-mode`, no detienen los mods integrados.

235 237 

236### Lee el código fuente de los mods integrados238### Lee el código fuente de los mods integrados

194| `session.receive` | `($, e) => ({ text: e.text })`. Dispáralo con `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |194| `session.receive` | `($, e) => ({ text: e.text })`. Dispáralo con `$.session.receive({ origin: { kind: 'peer-send-message' }, text })`. |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` tiene las aserciones `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` y `toThrow`, y `.not` antes de cualquiera de ellas.197### Comprobar un resultado con `expect`

198 

199El kit tiene estas aserciones, y la que elijas va después del valor que estás comprobando, como en `expect(answer.text).toBe('ok')`:

200 

201* **Igualdad**: `toBe` para el mismo valor u objeto, `toEqual` para la estructura, `toStrictEqual` para la estructura más los campos `undefined` y el prototipo, y `toMatchObject` para los campos que nombres

202* **Texto**: `toMatch`, que acepta una expresión regular o una subcadena, `toStartWith` y `toEndWith`

203* **Números**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Contenido**: `toContain` para una subcadena o un miembro, `toContainEqual` para un miembro comparado por estructura, `toHaveLength` y `toHaveProperty`

205* **Presencia y tipo**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Lanzamiento de excepciones**: `toThrow`, para una función que llama `expect`, o para una promesa que compruebas con `.rejects`

207 

208Pon `.not` delante de una aserción para comprobar lo contrario, y `.resolves` o `.rejects` para comprobar con qué se resuelve o rechaza una promesa.

198 209 

199Cuando un `expect` falla dentro de un stub o hook que pasaste a `on` como una función simple en lugar de un generador asíncrono, la prueba falla. El motor omite ese hook, y la salida del fallo lo nombra, como `in the test's store.set hook`.210Cuando un `expect` falla dentro de un stub o hook que pasaste a `on` como una función simple en lugar de un generador asíncrono, la prueba falla. El motor omite ese hook, y la salida del fallo lo nombra, como `in the test's store.set hook`.

200 211 

26| Contexto del proyecto | CLAUDE.md, memoria automática, reglas sin alcance | La sesión comienza, o después de `/clear` o `/compact` |26| Contexto del proyecto | CLAUDE.md, memoria automática, reglas sin alcance | La sesión comienza, o después de `/clear` o `/compact` |

27| Conversación | Tus mensajes, respuestas de Claude, resultados de herramientas | Cada turno |27| Conversación | Tus mensajes, respuestas de Claude, resultados de herramientas | Cada turno |

28 28 

29Un cambio en la capa de conversación deja el prompt del sistema y el contexto del proyecto en caché. Un cambio en el prompt del sistema invalida todo, porque todo el contenido posterior ahora se encuentra detrás de un prefijo diferente. La tercera columna ofrece desencadenantes comunes en lugar de una lista exhaustiva, y las secciones a continuación cubren el conjunto completo.29Una adición a la capa de conversación deja el prompt del sistema y el contexto del proyecto en caché. Un cambio en el prompt del sistema invalida todo, porque todo el contenido posterior ahora se encuentra detrás de un prefijo diferente. La tercera columna ofrece desencadenantes comunes en lugar de una lista exhaustiva, y las secciones a continuación cubren el conjunto completo.

30 30 

31La regla de coincidencia de prefijos explica la mayoría de los comportamientos de esta página. El [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) y la [carga de skills](https://code.claude.com/docs/es/skills.md), por ejemplo, añaden sus instrucciones como mensajes de conversación, por lo que el prefijo en caché permanece intacto.31La regla de coincidencia de prefijos explica la mayoría de los comportamientos de esta página. El [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) y la [carga de skills](https://code.claude.com/docs/es/skills.md), por ejemplo, añaden sus instrucciones como mensajes de conversación, por lo que el prefijo en caché permanece intacto.

32 32 

174 174 

175### Compactar la conversación175### Compactar la conversación

176 176 

177[La compactación](https://code.claude.com/docs/es/context-window.md#what-survives-compaction) reemplaza tu historial de mensajes con un resumen. Por diseño, esto invalida la capa de conversación: la siguiente solicitud tiene un historial nuevo y más corto que no comparte un prefijo con el anterior. Las capas del prompt del sistema y del contexto del proyecto pueden permanecer en caché:177[La compactación](https://code.claude.com/docs/es/context-window.md#what-survives-compaction) reemplaza tu historial de mensajes con un resumen. Por diseño, esto invalida la capa de conversación: la siguiente solicitud tiene un historial nuevo y más corto que no comparte un prefijo con el anterior.

178 178 

179* **Prompt del sistema**: la siguiente solicitud lee esta capa desde la caché, a menos que una [conversación reanudada](#resuming-a-session) haya mantenido un prompt del sistema que ahora está desactualizado. La primera vez que esa conversación se compacta, Claude Code la cambia al prompt actual, y la siguiente solicitud reconstruye la caché de esta capa una vez.179* **Prompt del sistema**: la siguiente solicitud lee esta capa desde la caché, a menos que una [conversación reanudada](#resuming-a-session) haya mantenido un prompt del sistema que ahora está desactualizado. La primera vez que esa conversación se compacta, Claude Code la cambia al prompt actual, y la siguiente solicitud reconstruye la caché de esta capa una vez.

180* **Contexto del proyecto**: Claude Code recarga esta capa desde el disco. La siguiente solicitud la lee desde la caché solo si CLAUDE.md y la memoria no han cambiado desde que comenzó la sesión.180* **Contexto del proyecto**: Claude Code recarga esta capa desde el disco. Se almacena en caché junto con la conversación, por lo que después de `/compact` o de la compactación automática su caché se reconstruye aunque sus archivos no hayan cambiado.

181 181 

182Para producir el resumen, Claude Code envía una solicitud separada. La solicitud repite el prompt del sistema, las herramientas y el historial que se está resumiendo de tu conversación. Termina con una instrucción de resumen. Mientras la caché está activa, esa solicitud lee tu prefijo desde la caché. Así, un `/compact` a mitad de sesión cuesta una fracción de lo que sugiere el tamaño del contexto y pasa la mayor parte de su tiempo generando el resumen.182Para producir el resumen, Claude Code envía una solicitud separada. La solicitud repite el prompt del sistema, las herramientas y el historial que se está resumiendo de tu conversación. Termina con una instrucción de resumen. Mientras la caché está activa, esa solicitud lee tu prefijo desde la caché. Así, un `/compact` a mitad de sesión cuesta una fracción de lo que sugiere el tamaño del contexto y pasa la mayor parte de su tiempo generando el resumen.

183 183 

184Después de una pausa más larga que la [duración de caché](#cache-lifetime), no queda caché para leer, por lo que la solicitud de resumen reprocesa ese historial como entrada sin caché. Por eso `/compact` cuesta más cuando [reanudas una sesión antigua](https://code.claude.com/docs/es/sessions.md#resume-a-session). Tanto con la caché activa como con la caché expirada, el turno después de la compactación reconstruye la caché de conversación solo para el resumen, mucho más corto, por lo que ese turno no es la parte lenta.184Después de una pausa más larga que la [duración de caché](#cache-lifetime), no queda caché para leer, por lo que la solicitud de resumen reprocesa ese historial como entrada sin caché. Por eso `/compact` cuesta más cuando [reanudas una sesión antigua](https://code.claude.com/docs/es/sessions.md#resume-a-session). Tanto con la caché activa como con la caché expirada, el turno después de la compactación reconstruye la caché de conversación solo para el historial, mucho más corto, por lo que ese turno no es la parte lenta.

185 185 

186> [!TIP]186> [!TIP]

187>187>

31>31>

32> **macOS, Linux, WSL:**32> **macOS, Linux, WSL:**

33>33>

34> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}34> ```bash theme={null}

35> curl -fsSL https://claude.ai/install.sh | bash35> curl -fsSL https://claude.ai/install.sh | bash

36> ```36> ```

37>37>

39>39>

40> **Windows PowerShell:**40> **Windows PowerShell:**

41>41>

42> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}42> ```powershell theme={null}

43> irm https://claude.ai/install.ps1 | iex43> irm https://claude.ai/install.ps1 | iex

44> ```44> ```

45>45>

46> **Windows CMD:**46> **Windows CMD:**

47>47>

48> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}48> ```batch theme={null}

49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50> ```50> ```

51>51>

63 63 

64> [tab] Homebrew64> [tab] Homebrew

65>65>

66> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}66> ```bash theme={null}

67> brew install --cask claude-code67> brew install --cask claude-code

68> ```68> ```

69>69>

75 75 

76> [tab] WinGet76> [tab] WinGet

77>77>

78> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}78> ```powershell theme={null}

79> winget install Anthropic.ClaudeCode79> winget install Anthropic.ClaudeCode

80> ```80> ```

81>81>

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rechaza servidores específicos del [`.mcp.json`](https://code.claude.com/docs/es/mcp#project-scope) de un proyecto | MCP | Any file |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Rechaza servidores específicos del [`.mcp.json`](https://code.claude.com/docs/es/mcp#project-scope) de un proyecto | MCP | Any file |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloquea las herramientas de Claude en el panel iOS Simulator de [escritorio](https://code.claude.com/docs/es/desktop.md) | Herramientas | Managed |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Bloquea las herramientas de Claude en el panel iOS Simulator de [escritorio](https://code.claude.com/docs/es/desktop.md) | Herramientas | Managed |

88| [`disableRemoteControl`](#disableremotecontrol) | Desactiva [Remote Control](https://code.claude.com/docs/es/remote-control.md) en todos los lugares donde puede iniciarse | Remoto, escritorio y notificaciones | Any file |88| [`disableRemoteControl`](#disableremotecontrol) | Desactiva [Remote Control](https://code.claude.com/docs/es/remote-control.md) en todos los lugares donde puede iniciarse | Remoto, escritorio y notificaciones | Any file |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | Desactiva los scripts en las vistas previas HTML de la app de [escritorio](https://code.claude.com/docs/es/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) en las sesiones SSH y WSL | Remoto, escritorio y notificaciones | Managed |

89| [`disableSideloadFlags`](#disablesideloadflags) | Rechaza los flags de la CLI que cargan de forma lateral [plugins](https://code.claude.com/docs/es/plugins/overview.md), [subagentes](https://code.claude.com/docs/es/sub-agents.md) y [servidores MCP](https://code.claude.com/docs/es/mcp.md) | Configuración empresarial y administrada | Managed |90| [`disableSideloadFlags`](#disablesideloadflags) | Rechaza los flags de la CLI que cargan de forma lateral [plugins](https://code.claude.com/docs/es/plugins/overview.md), [subagentes](https://code.claude.com/docs/es/sub-agents.md) y [servidores MCP](https://code.claude.com/docs/es/mcp.md) | Configuración empresarial y administrada | Managed |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | Impide que los [skills](https://code.claude.com/docs/es/skills.md) y los comandos personalizados ejecuten shell en línea | Plugins y skills | Any file |91| [`disableSkillShellExecution`](#disableskillshellexecution) | Impide que los [skills](https://code.claude.com/docs/es/skills.md) y los comandos personalizados ejecuten shell en línea | Plugins y skills | Any file |

91| [`disableWorkflows`](#disableworkflows) | Desactiva los [workflows dinámicos](https://code.claude.com/docs/es/workflows.md) para todos; usa `enableWorkflows` para ti | Hooks y automatización | Any file |92| [`disableWorkflows`](#disableworkflows) | Desactiva los [workflows dinámicos](https://code.claude.com/docs/es/workflows.md) para todos; usa `enableWorkflows` para ti | Hooks y automatización | Any file |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Haz que las herramientas `Write`, `Edit` y `NotebookEdit` rechacen las rutas fuera de los [directorios de trabajo](https://code.claude.com/docs/es/permissions.md#working-directories) en todos los modos de permisos, salvo [algunos archivos propios de Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Configuración de permisos | Any file |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | Haz que las herramientas `Write`, `Edit` y `NotebookEdit` rechacen las rutas fuera de los [directorios de trabajo](https://code.claude.com/docs/es/permissions.md#working-directories) en todos los modos de permisos, salvo [algunos archivos propios de Claude Code](#what-the-write-block-refuses-and-what-stays-writable) | Configuración de permisos | Any file |

148| [`permissions.defaultMode`](#permissions-defaultmode) | Establece el [modo de permisos](https://code.claude.com/docs/es/permission-modes.md#which-mode-a-session-starts-in) predeterminado para las nuevas sesiones | Configuración de permisos | Any file |149| [`permissions.defaultMode`](#permissions-defaultmode) | Establece el [modo de permisos](https://code.claude.com/docs/es/permission-modes.md#which-mode-a-session-starts-in) predeterminado para las nuevas sesiones | Configuración de permisos | Any file |

149| [`permissions.deny`](#permissions-deny) | Bloquea los [usos de herramientas](https://code.claude.com/docs/es/permissions.md#permission-rule-syntax) enumerados, incluidas las lecturas de archivos que contienen secretos | Configuración de permisos | Any file |150| [`permissions.deny`](#permissions-deny) | Bloquea los [usos de herramientas](https://code.claude.com/docs/es/permissions.md#permission-rule-syntax) enumerados, incluidas las lecturas de archivos que contienen secretos | Configuración de permisos | Any file |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | Deniega las llamadas a herramientas que quedarían esperando una [solicitud de permiso](https://code.claude.com/docs/es/permissions.md#permission-system), para que una sesión que nadie está supervisando siga funcionando | Configuración de permisos | User or managed |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impide que cualquiera entre en el [modo bypassPermissions](https://code.claude.com/docs/es/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Configuración de permisos | Any file |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Impide que cualquiera entre en el [modo bypassPermissions](https://code.claude.com/docs/es/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Configuración de permisos | Any file |

151| [`plansDirectory`](#plansdirectory) | Elige dónde escribe el [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) los archivos de plan | Memoria y contexto | Any file |153| [`plansDirectory`](#plansdirectory) | Elige dónde escribe el [modo plan](https://code.claude.com/docs/es/permission-modes.md#analyze-before-you-edit-with-plan-mode) los archivos de plan | Memoria y contexto | Any file |

152| [`pluginConfigs`](#pluginconfigs) | Almacena las respuestas que diste en el diálogo de configuración de un [plugin](https://code.claude.com/docs/es/plugins/overview.md) | Plugins y skills | User or managed |154| [`pluginConfigs`](#pluginconfigs) | Almacena las respuestas que diste en el diálogo de configuración de un [plugin](https://code.claude.com/docs/es/plugins/overview.md) | Plugins y skills | User or managed |

228| [`statusLine`](#statusline) | Ejecuta tu propio comando para mostrar una [línea de estado](https://code.claude.com/docs/es/statusline.md) debajo del prompt | Interfaz y terminal | Any file |230| [`statusLine`](#statusline) | Ejecuta tu propio comando para mostrar una [línea de estado](https://code.claude.com/docs/es/statusline.md) debajo del prompt | Interfaz y terminal | Any file |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Define una lista de permitidos de las fuentes de [marketplaces](https://code.claude.com/docs/es/plugins/overview.md) que los usuarios pueden agregar y desde las que pueden instalar | Plugins y skills | Managed |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | Define una lista de permitidos de las fuentes de [marketplaces](https://code.claude.com/docs/es/plugins/overview.md) que los usuarios pueden agregar y desde las que pueden instalar | Plugins y skills | Managed |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloquea los [skills](https://code.claude.com/docs/es/skills.md), [agentes](https://code.claude.com/docs/es/sub-agents.md), [hooks](https://code.claude.com/docs/es/hooks.md) y [servidores MCP](https://code.claude.com/docs/es/mcp.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Bloquea los [skills](https://code.claude.com/docs/es/skills.md), [agentes](https://code.claude.com/docs/es/sub-agents.md), [hooks](https://code.claude.com/docs/es/hooks.md) y [servidores MCP](https://code.claude.com/docs/es/mcp.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Restringe los [agentes](https://code.claude.com/docs/es/sub-agents.md) a fuentes de plugins y administradas | Plugins y skills | Managed |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Bloquea los [agentes](https://code.claude.com/docs/es/sub-agents.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Restringe los [hooks](https://code.claude.com/docs/es/hooks.md) a fuentes de plugins y administradas | Plugins y skills | Managed |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Bloquea los [hooks](https://code.claude.com/docs/es/hooks.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Restringe los [servidores MCP](https://code.claude.com/docs/es/mcp.md) a fuentes de plugins y administradas | Plugins y skills | Managed |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Bloquea los [servidores MCP](https://code.claude.com/docs/es/mcp.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Restringe los [skills](https://code.claude.com/docs/es/skills.md) a fuentes de plugins y administradas | Plugins y skills | Managed |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Bloquea los [skills](https://code.claude.com/docs/es/skills.md) de fuentes de usuario y de proyecto | Plugins y skills | Managed |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Elige la [duración de la caché de prompts](https://code.claude.com/docs/es/prompt-caching.md#cache-lifetime) para los subagentes y otras solicitudes fuera de la conversación principal | Modelo y respuestas | Any file |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Elige la [duración de la caché de prompts](https://code.claude.com/docs/es/prompt-caching.md#cache-lifetime) para los subagentes y otras solicitudes fuera de la conversación principal | Modelo y respuestas | Any file |

236| [`subagentStatusLine`](#subagentstatusline) | Reescribe filas de la visualización de tareas del [subagente](https://code.claude.com/docs/es/sub-agents.md) con tu propio comando | Interfaz y terminal | Any file |238| [`subagentStatusLine`](#subagentstatusline) | Reescribe filas de la visualización de tareas del [subagente](https://code.claude.com/docs/es/sub-agents.md) con tu propio comando | Interfaz y terminal | Any file |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | Cambia de modelo automáticamente o haz una pausa cuando un [clasificador de seguridad](https://code.claude.com/docs/es/model-config.md#ask-before-switching) marca una solicitud | Modelo y respuestas | Any file |239| [`switchModelsOnFlag`](#switchmodelsonflag) | Cambia de modelo automáticamente o haz una pausa cuando un [clasificador de seguridad](https://code.claude.com/docs/es/model-config.md#ask-before-switching) marca una solicitud | Modelo y respuestas | Any file |

288}290}

289```291```

290 292 

291La clave no tiene efecto en los proveedores donde el advisor [no está disponible](https://code.claude.com/docs/es/advisor.md#requirements), como Amazon Bedrock y Claude Platform on AWS. `"fable"` requiere [acceso a Fable](https://code.claude.com/docs/es/advisor.md#choose-an-advisor-model).293La clave no tiene efecto en los proveedores donde el advisor [no está disponible](https://code.claude.com/docs/es/advisor.md#requirements), como Amazon Bedrock. En Claude Platform on AWS, la clave requiere Claude Code v2.1.300 o posterior. `"fable"` requiere [acceso a Fable](https://code.claude.com/docs/es/advisor.md#choose-an-advisor-model).

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449Activa el [modo rápido](https://code.claude.com/docs/es/fast-mode.md) en las sesiones donde esté disponible, para trabajo interactivo como iteración rápida o depuración en vivo, donde quieres velocidad a un costo mayor por token. Normalmente no editas esta clave tú mismo. Ejecutar `/fast` escribe `fastMode: true` en `~/.claude/settings.json`, y volver a ejecutarlo para desactivar el modo rápido elimina la clave.451Activa el [modo rápido](https://code.claude.com/docs/es/fast-mode.md) en las sesiones donde esté disponible, para trabajo interactivo como iteración rápida o depuración en vivo, donde quieres velocidad a un costo mayor por token. Normalmente no editas esta clave tú mismo. Ejecutar `/fast` escribe `fastMode: true` en `~/.claude/settings.json`, y volver a ejecutarlo para desactivar el modo rápido elimina la clave.

450 452 

451Solo Fable 5.2, Opus 5.5, Opus 5 y Opus 4.8 admiten el modo rápido. Ejecutar `/fast` desde otro modelo te cambia a Opus, y cambiar a un modelo no compatible desactiva el modo rápido. Consulta [Cambiar de modelo mientras el modo rápido está activado](https://code.claude.com/docs/es/fast-mode.md#switch-models-while-fast-mode-is-on).453En la API de Anthropic, solo Fable 5.2, Opus 5.5, Opus 5 y Opus 4.8 admiten el modo rápido. Ejecutar `/fast` desde otro modelo te cambia a Opus, y cambiar a un modelo no compatible desactiva el modo rápido. Consulta [Cambiar de modelo mientras el modo rápido está activado](https://code.claude.com/docs/es/fast-mode.md#switch-models-while-fast-mode-is-on). En Agent Platform de Google Cloud, [`/fast` te cambia a Fable 5.2](https://code.claude.com/docs/es/fast-mode#use-fast-mode-on-agent-platform) en su lugar y no escribe esta clave, y Claude Code ignora un `true` guardado.

452 454 

453* **Alcance**: [`Any file`](#scopes)455* **Alcance**: [`Any file`](#scopes)

454* **Tipo**: Boolean456* **Tipo**: Boolean

904Controla qué herramientas puede usar Claude sin preguntar, cuáles piden confirmación y cuáles están bloqueadas. También establece el [modo de permisos](https://code.claude.com/docs/es/permission-modes.md) predeterminado para las nuevas sesiones. Cada clave `permissions.*` a continuación se anida bajo este objeto.906Controla qué herramientas puede usar Claude sin preguntar, cuáles piden confirmación y cuáles están bloqueadas. También establece el [modo de permisos](https://code.claude.com/docs/es/permission-modes.md) predeterminado para las nuevas sesiones. Cada clave `permissions.*` a continuación se anida bajo este objeto.

905 907 

906* **Scope**: [`Any file`](#scopes)908* **Scope**: [`Any file`](#scopes)

907* **Type**: objeto con `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `disableBypassPermissionsMode` y `disableAutoMode`909* **Type**: objeto con `allow`, `ask`, `deny`, `additionalDirectories`, `blockReadsOutsideWorkingDirectories`, `blockWritesOutsideWorkingDirectories`, `defaultMode`, `denyInsteadOfPrompting`, `disableBypassPermissionsMode` y `disableAutoMode`

908* **Default**: sin establecer910* **Default**: sin establecer

909 911 

910Este ejemplo aprueba comandos `npm run` sin preguntar, pide confirmación antes de `git push`, bloquea lecturas de `.env` e inicia sesiones en `acceptEdits`:912Este ejemplo aprueba comandos `npm run` sin preguntar, pide confirmación antes de `git push`, bloquea lecturas de `.env` e inicia sesiones en `acceptEdits`:

1163 1165 

1164Las reglas de permisos se superponen a todos los modos: las reglas `deny` bloquean en todos los modos, incluido `bypassPermissions`. Consulta [Modos de permisos](https://code.claude.com/docs/es/permission-modes.md). En las sesiones en la nube, Claude Code respeta solo `acceptEdits`, `plan`, `default` y `auto` de esta clave. Para las conversaciones que inicia la extensión de VS Code, consulta [qué ajuste lee la extensión para el modo de permisos inicial](https://code.claude.com/docs/es/permission-modes.md#switch-permission-modes).1166Las reglas de permisos se superponen a todos los modos: las reglas `deny` bloquean en todos los modos, incluido `bypassPermissions`. Consulta [Modos de permisos](https://code.claude.com/docs/es/permission-modes.md). En las sesiones en la nube, Claude Code respeta solo `acceptEdits`, `plan`, `default` y `auto` de esta clave. Para las conversaciones que inicia la extensión de VS Code, consulta [qué ajuste lee la extensión para el modo de permisos inicial](https://code.claude.com/docs/es/permission-modes.md#switch-permission-modes).

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170Establece esto en `true` para mantener una sesión en ejecución cuando no hay nadie para responder una solicitud de permiso. Claude Code deniega una llamada a herramienta que de otro modo quedaría esperando una solicitud de confirmación, y el turno continúa. Requiere Claude Code v2.1.319 o posterior.

1171 

1172Una llamada sigue adelante si la aprueba una regla de permitir, tu [modo de permisos](https://code.claude.com/docs/es/permission-modes.md) o el clasificador del modo automático. Para permitir la mayoría de las llamadas que de otro modo pedirían confirmación, responde desde un [hook `PermissionRequest`](https://code.claude.com/docs/es/hooks#permissionrequest).

1173 

1174* **Scope**: [`User or managed`](#scopes), y `--settings`. Un repositorio no puede establecerlo por ti.

1175* **Type**: Boolean

1176 * `true`: Claude Code deniega las llamadas que de otro modo pedirían confirmación

1177 * `false`: lo mismo que sin establecer; las llamadas se siguen denegando si otra de estas fuentes establece `true`

1178* **Default**: sin establecer, por lo que una llamada que necesita aprobación te pide confirmación

1179 

1180En `~/.claude/settings.json`, este ejemplo inicia las sesiones en modo automático y deniega todo lo que aún recurriría a una solicitud de confirmación:

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191La clave se aplica en ejecuciones con `-p`, sesiones interactivas de terminal, la [extensión de VS Code](https://code.claude.com/docs/es/vs-code.md), sesiones locales en la [app de Desktop](https://code.claude.com/docs/es/desktop.md), [subagentes](https://code.claude.com/docs/es/sub-agents.md) y [equipos de agentes](https://code.claude.com/docs/es/agent-teams.md). Para denegar en su lugar lo que pediría confirmación en una sola ejecución [no interactiva](https://code.claude.com/docs/es/headless.md), pasa [`--permission-prompts none`](https://code.claude.com/docs/es/headless#turn-off-permission-prompts-in-unattended-runs) con `-p`.

1192 

1193#### Qué más detiene `denyInsteadOfPrompting`

1194 

1195Con el ajuste activado, Claude Code también detiene estas solicitudes de respuesta:

1196 

1197* **Herramientas de preguntas y de plan**: Claude Code omite [`AskUserQuestion`](https://code.claude.com/docs/es/tools-reference#askuserquestion-tool-behavior), `EnterPlanMode` y `ExitPlanMode`, por lo que una sesión en modo plan no puede salir de él por sí sola. Un compañero de equipo en un equipo de agentes conserva `EnterPlanMode` y `ExitPlanMode`

1198* **Elicitación MCP**: Claude Code cancela una [solicitud de elicitación](https://code.claude.com/docs/es/mcp.md#respond-to-mcp-elicitation-requests) a menos que un [hook `Elicitation`](https://code.claude.com/docs/es/hooks#elicitation) la responda

1199* **Hosts de permisos**: Claude Code no consulta tu [callback `canUseTool`](https://code.claude.com/docs/es/agent-sdk/user-input) ni [`--permission-prompt-tool`](https://code.claude.com/docs/es/cli-reference#cli-flags). Para aprobar llamadas desde código, responde desde un hook `PermissionRequest`. Algunas llamadas se deniegan antes de consultar cualquier hook, como una [eliminación de ruta crítica](https://code.claude.com/docs/es/permission-modes.md#critical-path-removals-in-each-permission-mode) en modo `auto` que ninguna regla ask cubre.

1200* **Aviso de facturación del clasificador**: donde el [aviso sobre las solicitudes facturadas del clasificador](https://code.claude.com/docs/es/auto-mode-classifier-billing.md) abriría un diálogo, Claude Code no lo muestra y deniega las acciones que necesitan esas solicitudes

1201 

1202Una sesión aún puede quedar esperando el [diálogo de confianza del espacio de trabajo](https://code.claude.com/docs/es/permissions.md#project-allow-rules-and-workspace-trust) y la [aprobación de servidores MCP del proyecto](https://code.claude.com/docs/es/mcp.md#project-server-approvals-and-workspace-trust). Responde ambos antes de dejar la sesión en ejecución.

1203 

1204#### Mensajes de `denyInsteadOfPrompting`

1205 

1206Estos mensajes informan de llamadas rechazadas. No son solicitudes de confirmación, así que nada espera tu respuesta.

1207 

1208La denegación que lee Claude puede comenzar con este texto:

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214En la salida `stream-json`, [las ejecuciones que emiten un mensaje `permission_denied`](https://code.claude.com/docs/es/agent-sdk/typescript#sdkpermissiondeniedmessage) informan este `decision_reason`:

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220En modo automático con el ajuste activado, el turno termina después de 20 llamadas seguidas que el clasificador bloqueó o que una [verificación de seguridad rechazó](https://code.claude.com/docs/es/errors.md#auto-mode-cannot-determine-the-safety-of-an-action), y ves este mensaje:

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226Una ejecución con `-p` informa ese turno como `error_during_execution`.

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168Impide que cualquiera entre en el modo `bypassPermissions`. Claude Code rechaza entonces el flag `--dangerously-skip-permissions` e ignora el `permissionMode: bypassPermissions` de una [definición de agente](https://code.claude.com/docs/es/sub-agents.md#permission-modes), por lo que el subagente se ejecuta con el modo de permisos de la sesión principal.1230Impide que cualquiera entre en el modo `bypassPermissions`. Claude Code rechaza entonces el flag `--dangerously-skip-permissions` e ignora el `permissionMode: bypassPermissions` de una [definición de agente](https://code.claude.com/docs/es/sub-agents.md#permission-modes), por lo que el subagente se ejecuta con el modo de permisos de la sesión principal.

1202 1264 

1203Omite el diálogo de confirmación que Claude Code muestra antes de que una sesión entre en el modo `bypassPermissions`, ya sea desde `--dangerously-skip-permissions` o desde `defaultMode: "bypassPermissions"`. Claude Code escribe `true` aquí en tu configuración de usuario cuando aceptas ese diálogo una vez.1265Omite el diálogo de confirmación que Claude Code muestra antes de que una sesión entre en el modo `bypassPermissions`, ya sea desde `--dangerously-skip-permissions` o desde `defaultMode: "bypassPermissions"`. Claude Code escribe `true` aquí en tu configuración de usuario cuando aceptas ese diálogo una vez.

1204 1266 

1205* **Scope**: [`User, local, or managed`](#scopes). Un repositorio que no es de confianza no puede omitir el diálogo por ti.1267* **Scope**: [`User, local, or managed`](#scopes), y los archivos pasados con `--settings`. Las [sesiones en segundo plano](https://code.claude.com/docs/es/permission-modes.md#bypass-permissions-ignored-in-a-background-session) solo tienen en cuenta la configuración de usuario y la administrada. Un repositorio que no es de confianza no puede omitir el diálogo por ti.

1206* **Type**: Boolean1268* **Type**: Boolean

1207 * `true`: Claude Code omite el diálogo de confirmación antes de que una sesión entre en el modo `bypassPermissions`1269 * `true`: Claude Code omite el diálogo de confirmación antes de que una sesión entre en el modo `bypassPermissions`

1208 * `false`: lo mismo que sin establecer; el diálogo aparece a menos que otro de estos archivos establezca `true`1270 * `false`: lo mismo que sin establecer; el diálogo aparece a menos que otro de estos archivos establezca `true`

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code colorea el código según el lenguaje en los diffs, bloques de código y vistas previas de archivos que muestra en la terminal, con su resaltador integrado; no interviene ningún plugin ni servidor de lenguaje. Establece esta clave en `true` para mostrarlos como texto plano, por ejemplo si los colores chocan con el tema de tu terminal o ralentizan un lector de pantalla.3197Claude Code colorea el código según el lenguaje en los diffs, bloques de código y vistas previas de archivos que muestra en la terminal, con su resaltador integrado. Establece esta clave en `true` para mostrarlos como texto plano en su lugar, por ejemplo si los colores chocan con el tema de tu terminal o ralentizan un lector de pantalla.

3136 3198 

3137* **Alcance**: [`Any file`](#scopes)3199* **Alcance**: [`Any file`](#scopes)

3138* **Tipo**: Boolean3200* **Tipo**: Boolean

3336Activa el [dictado por voz](https://code.claude.com/docs/es/voice-dictation.md) y elige cómo se comporta la tecla de dictado. Claude Code escribe este objeto por ti cuando ejecutas `/voice`.3398Activa el [dictado por voz](https://code.claude.com/docs/es/voice-dictation.md) y elige cómo se comporta la tecla de dictado. Claude Code escribe este objeto por ti cuando ejecutas `/voice`.

3337 3399 

3338* **Alcance**: [`Any file`](#scopes)3400* **Alcance**: [`Any file`](#scopes)

3339* **Tipo**: objeto con `enabled` como Boolean, `autoSubmit` como Boolean que solo se aplica en el modo `hold` (mantener pulsada la tecla), y `mode`, uno de:3401* **Tipo**: objeto con `enabled` como Boolean, `autoSubmit` como Boolean que solo se aplica en el modo de mantener pulsada la tecla, y `mode`, uno de:

3340 * `"hold"`: mantienes pulsada la tecla de dictado mientras hablas y la sueltas para detenerte3402 * `"hold"`: mantienes pulsada la tecla de dictado mientras hablas y la sueltas para detenerte

3341 * `"tap"`: pulsas la tecla una vez para empezar a grabar y otra vez para enviar3403 * `"tap"`: pulsas la tecla una vez para empezar a grabar y otra vez para enviar

3342* **Predeterminado**: sin establecer, por lo que el dictado está desactivado; cuando `enabled` es `true` y `mode` no está establecido, Claude Code usa `"hold"`3404* **Predeterminado**: sin establecer, por lo que el dictado está desactivado; cuando `enabled` es `true` y `mode` no está establecido, Claude Code usa `"hold"`

3352}3414}

3353```3415```

3354 3416 

3355`autoSubmit` envía el prompt cuando sueltas la tecla en el modo `hold` (mantener pulsada la tecla). El dictado por voz requiere una cuenta de claude.ai.3417`autoSubmit` envía el prompt cuando sueltas la tecla en el modo de mantener pulsada la tecla. El dictado por voz requiere una cuenta de claude.ai.

3356 3418 

3357### `voiceEnabled`3419### `voiceEnabled`

3358 3420 

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113Bloquee skills, agentes, hooks y servidores MCP de fuentes de usuario y proyecto, para que solo puedan provenir de plugins o configuración administrada. Combínelo con [`strictKnownMarketplaces`](#strictknownmarketplaces) para controlar la cadena de suministro de personalización completa: la lista de permitidos de mercado controla qué plugins pueden instalar los usuarios.4175Bloquea skills, agentes, hooks y servidores MCP de fuentes de usuario y de proyecto. Combínalo con [`strictKnownMarketplaces`](#strictknownmarketplaces) para elegir desde qué marketplaces pueden instalar plugins los usuarios. Agrega [`disableSideloadFlags`](#disablesideloadflags) para rechazar los flags de la CLI que cargan plugins, agentes y servidores MCP de forma lateral para una sola ejecución.

4114 4176 

4115* **Scope**: [`Managed`](#scopes)4177* **Scope**: [`Managed`](#scopes)

4116* **Type**: `true` para bloquear los cuatro tipos de personalización, o una matriz que nombre los tipos a bloquear, de `"skills"`, `"agents"`, `"hooks"` y `"mcp"`4178* **Type**: `true` para bloquearlos todos, o una matriz que nombre los que se bloquean, entre `"skills"`, `"agents"`, `"hooks"` y `"mcp"`

4117* **Default**: sin establecer, por lo que nada está bloqueado4179* **Default**: sin establecer, por lo que nada está bloqueado

4118 4180 

4119Este ejemplo bloquea skills y hooks y deja agentes y servidores MCP desbloqueados:4181Este ejemplo bloquea skills y hooks y deja agentes y servidores MCP desbloqueados:

4216Cada scope sirve un propósito diferente:4278Cada scope sirve un propósito diferente:

4217 4279 

4218* **Configuración de usuario**: sus preferencias personales de plugin4280* **Configuración de usuario**: sus preferencias personales de plugin

4219* **Configuración de proyecto**: plugins compartidos con todos en el repositorio4281* **Configuración de proyecto**: plugins activados para todas las personas del repositorio. Esto no los instala, por lo que cada usuario [los instala](https://code.claude.com/docs/es/plugins/org.md#require-plugins-per-repository).

4220* **Configuración local**: anulaciones por máquina, gitignored cuando Claude Code guarda una configuración allí4282* **Configuración local**: anulaciones por máquina, gitignored cuando Claude Code guarda una configuración allí

4221* **Configuración administrada**: política de toda la organización. Un plugin establecido en `false` aquí está bloqueado de instalación en cada scope y oculto del mercado4283* **Configuración administrada**: política de toda la organización. Un plugin establecido en `false` aquí está bloqueado de instalación en cada scope y oculto del mercado

4222 4284 

4223La configuración de proyecto tiene precedencia sobre la configuración de usuario, por lo que establecer un plugin en `false` en `~/.claude/settings.json` no deshabilita un plugin que el `.claude/settings.json` del proyecto habilita. Para optar por no participar en un plugin habilitado por proyecto en su máquina, establézcalo en `false` en `.claude/settings.local.json` en su lugar. Los plugins forzados habilitados por configuración administrada no pueden deshabilitarse de esta manera, ya que la configuración administrada anula la configuración local.4285La configuración de proyecto tiene precedencia sobre la configuración de usuario, por lo que establecer un plugin en `false` en `~/.claude/settings.json` no deshabilita un plugin que el `.claude/settings.json` del proyecto habilita. Para optar por no participar en un plugin habilitado por proyecto en su máquina, establézcalo en `false` en `.claude/settings.local.json` en su lugar. Los plugins forzados habilitados por configuración administrada no pueden deshabilitarse de esta manera, ya que la configuración administrada anula la configuración local.

4224 4286 

4225Habilitar un plugin de una fuente externa como un repositorio de GitHub o paquete npm en el `.claude/settings.json` de un proyecto no lo instala para otras personas. En cada ruta que carga plugins, Claude Code reporta el plugin como no instalado hasta que cada usuario lo [instale ellos mismos](https://code.claude.com/docs/es/plugins/org.md#require-plugins-per-repository).

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229Registre mercados de plugins adicionales por nombre, para que las personas que abran el repositorio, o todos los que alcance su configuración administrada, obtengan el mercado sin agregarlo ellos mismos. Claude Code registra cada mercado que aún no conoce. Si un plugin que [`enabledPlugins`](#enabledplugins) nombra desde él se instala depende de la fuente del plugin y qué archivo lo habilita; esa entrada tiene las reglas.4289Registra marketplaces de plugins adicionales por nombre, para que las personas que abren el repositorio, o todas aquellas a las que llega tu configuración administrada, obtengan el marketplace sin tener que agregarlo ellas mismas. Claude Code registra cada marketplace que todavía no conoce. Que se instale un plugin de ese marketplace nombrado en [`enabledPlugins`](#enabledplugins) depende de la fuente del plugin y del archivo que lo habilita; las reglas están en [Habilitado en la configuración de proyecto pero no instalado](https://code.claude.com/docs/es/plugins/loading.md#enabled-in-project-settings-but-not-installed).

4230 4290 

4231* **Scope**: [`Any file`](#scopes). Claude Code respeta entradas en el `.claude/settings.json` o `.claude/settings.local.json` de un repositorio solo después de que acepte el diálogo de confianza del espacio de trabajo para esa carpeta; en una carpeta que no ha confiado, incluida una ejecución `-p` allí, las ignora sin un mensaje.4291* **Scope**: [`Any file`](#scopes). Claude Code respeta entradas en el `.claude/settings.json` o `.claude/settings.local.json` de un repositorio solo después de que acepte el diálogo de confianza del espacio de trabajo para esa carpeta; en una carpeta que no ha confiado, incluida una ejecución `-p` allí, las ignora sin un mensaje.

4232* **Type**: objeto que asigna un nombre de mercado a un objeto con un objeto `source` y un Boolean `autoUpdate` opcional4292* **Type**: objeto que asigna un nombre de mercado a un objeto con un objeto `source` y un Boolean `autoUpdate` opcional

4354 4414 

4355Liste los plugins administrados cuyos [mods](https://code.claude.com/docs/es/plugins/mods/overview.md) se ejecutan antes de cada mod que instala un usuario, en el orden listado. Cuando establece esta clave en configuración administrada, nombre `sec-default@builtin` en la lista para mantener la guardia integrada. En configuración administrada, Claude Code omite un id cuyo plugin no cuenta como el de su organización. Consulte [Instale los mods de su organización y establezca el orden](https://code.claude.com/docs/es/plugins/mods/admin.md#install-your-organizations-mods) para esas condiciones y cómo funcionan juntas las dos claves de ordenamiento.4415Liste los plugins administrados cuyos [mods](https://code.claude.com/docs/es/plugins/mods/overview.md) se ejecutan antes de cada mod que instala un usuario, en el orden listado. Cuando establece esta clave en configuración administrada, nombre `sec-default@builtin` en la lista para mantener la guardia integrada. En configuración administrada, Claude Code omite un id cuyo plugin no cuenta como el de su organización. Consulte [Instale los mods de su organización y establezca el orden](https://code.claude.com/docs/es/plugins/mods/admin.md#install-your-organizations-mods) para esas condiciones y cómo funcionan juntas las dos claves de ordenamiento.

4356 4416 

4357* **Scope**: [`User or managed`](#scopes). Claude Code lee la clave desde la configuración administrada. La lee desde la configuración de usuario solo en una máquina sin configuración administrada, en una sesión cuya credencial no sea un `/login` de Team o Enterprise. Ignora la clave en la configuración de proyecto y local y en un archivo `--settings`.4417* **Scope**: [`User or managed`](#scopes). Claude Code lee la clave desde la configuración administrada. La lee desde la configuración de usuario solo en una máquina sin configuración administrada ni archivo `managed-mcp.json`, en una sesión cuya credencial no sea un `/login` de Team o Enterprise. Ignora la clave en la configuración de proyecto y local y en un archivo `--settings`.

4358* **Type**: matriz de cadenas `plugin-name@marketplace-name`4418* **Type**: matriz de cadenas `plugin-name@marketplace-name`

4359* **Default**: sin establecer4419* **Default**: sin establecer

4360 4420 

4374 4434 

4375Liste los plugins administrados cuyos [mods](https://code.claude.com/docs/es/plugins/mods/overview.md) se ejecutan después de cada mod que instala un usuario, en el orden listado. Un id listado en ambos `prependPlugins` y `appendPlugins` se antepone. En configuración administrada, Claude Code omite un id cuyo plugin no [cuenta como el de su organización](https://code.claude.com/docs/es/plugins/mods/admin.md#install-your-organizations-mods).4435Liste los plugins administrados cuyos [mods](https://code.claude.com/docs/es/plugins/mods/overview.md) se ejecutan después de cada mod que instala un usuario, en el orden listado. Un id listado en ambos `prependPlugins` y `appendPlugins` se antepone. En configuración administrada, Claude Code omite un id cuyo plugin no [cuenta como el de su organización](https://code.claude.com/docs/es/plugins/mods/admin.md#install-your-organizations-mods).

4376 4436 

4377* **Scope**: [`User or managed`](#scopes). Claude Code lee la clave desde la configuración administrada. La lee desde la configuración de usuario solo en una máquina sin configuración administrada, en una sesión cuya credencial no sea un `/login` de Team o Enterprise. Ignora la clave en la configuración de proyecto y local y en un archivo `--settings`.4437* **Scope**: [`User or managed`](#scopes). Claude Code lee la clave desde la configuración administrada. La lee desde la configuración de usuario solo en una máquina sin configuración administrada ni archivo `managed-mcp.json`, en una sesión cuya credencial no sea un `/login` de Team o Enterprise. Ignora la clave en la configuración de proyecto y local y en un archivo `--settings`.

4378* **Type**: matriz de cadenas `plugin-name@marketplace-name`4438* **Type**: matriz de cadenas `plugin-name@marketplace-name`

4379* **Default**: sin establecer4439* **Default**: sin establecer

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615Elija qué hace esta sesión con [mensajes que llegan desde sus otras sesiones de Claude Code](https://code.claude.com/docs/es/cross-session-messaging.md#control-inbound-messages). Cuando no se aplica ningún valor, Claude Code decide por mensaje según las clases de modo de permisos de las dos sesiones. Requiere Claude Code v2.1.224 o posterior.4675Elige qué hace esta sesión con [mensajes que llegan desde tus otras sesiones de Claude Code](https://code.claude.com/docs/es/cross-session-messaging.md#control-inbound-messages). Cuando no se aplica ningún valor, Claude Code decide por mensaje según las clases de modo de permisos de las dos sesiones.

4616 4676 

4617* **Alcance**: [`Cualquier archivo`](#scopes). Un valor de proyecto o local se aplica solo cuando es más estricto que el valor de configuración administrada, la bandera `--settings` o la configuración del usuario proporcionan.4677* **Alcance**: [`Cualquier archivo`](#scopes). Un valor de proyecto o local se aplica solo cuando es más estricto que el valor de configuración administrada, la bandera `--settings` o la configuración del usuario proporcionan.

4618* **Tipo**: cadena, una de:4678* **Tipo**: cadena, una de:

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011Impide que se ejecuten scripts cuando las personas [previsualizan un archivo HTML](https://code.claude.com/docs/es/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) desde una sesión SSH o WSL en la aplicación de escritorio. La navegación externa en el panel Browser no se ve afectada.

5012 

5013La aplicación de escritorio lee esta clave; la CLI de la terminal la ignora. Requiere Claude Desktop v5.1231.0 o posterior. Las versiones anteriores ignoran la clave: para detener los scripts en ellas, establece también [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation), que también desactiva la navegación externa.

5014 

5015* **Scope**: [`Managed`](#scopes). La aplicación de escritorio no lee la clave desde la máquina remota ni desde la distribución de WSL.

5016* **Type**: Boolean; solo el Boolean JSON `true` tiene efecto

5017 * `true`: las vistas previas HTML en sesiones SSH y WSL no ejecutan scripts

5018 * `false`: la clave no desactiva los scripts

5019* **Default**: unset, por lo que la clave no tiene efecto

5020 

5021Si la computadora que ejecuta la aplicación de escritorio no recibe ninguna otra configuración administrada de Claude Code, establece también [`parentSettingsBehavior`](#parentsettingsbehavior) en `"merge"` en la configuración administrada que crees. En Windows, si creas un archivo de configuración administrada, los usuarios también pierden las sesiones WSL hasta que [las permitas](https://code.claude.com/docs/es/admin-setup.md#wsl-sessions-in-claude-code-desktop). [Desactivar los scripts en las vistas previas SSH y WSL para tu organización](https://code.claude.com/docs/es/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) explica ambas cosas e indica dónde establecer la clave.

5022 

5023Este ejemplo muestra la clave sola, tal como la agregarías a la configuración administrada que una computadora ya recibe:

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031La aplicación de escritorio ignora cualquier otro valor, y un valor que no sea un Boolean, como la cadena `"true"` o `1`, también registra una advertencia.

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951Desactiva la herramienta [Artifact](https://code.claude.com/docs/es/artifacts.md), que publica la salida de la sesión como una página web privada en claude.ai. Cuando desactivas la fila **Artifacts** en `/config`, Claude Code escribe esta clave en tu configuración de usuario, por lo que normalmente no la editas a mano.5035Desactiva la herramienta [Artifact](https://code.claude.com/docs/es/artifacts.md), que publica la salida de la sesión como una página web privada en claude.ai. Cuando desactivas la fila **Artifacts** en `/config`, Claude Code escribe esta clave en tu configuración de usuario, por lo que normalmente no la editas a mano.

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222Restringe con qué tipo de cuenta pueden iniciar sesión las personas. Establece `"claudeai"` para permitir solo cuentas de claude.ai, `"console"` para permitir solo cuentas de Claude Console, o `"gateway"` para enviar a las personas a un [cloud gateway](https://code.claude.com/docs/es/claude-apps-gateway) en lugar de un inicio de sesión propio de Anthropic. Los administradores lo establecen en la configuración administrada y lo combinan con [`forceLoginOrgUUID`](#forceloginorguuid) para mantener los inicios de sesión de claude.ai de los desarrolladores dentro de una organización.5306Restringe con qué tipo de cuenta pueden iniciar sesión las personas: `"claudeai"` para el inicio de sesión en claude.ai o `"console"` para el inicio de sesión en Claude Console. Establece `"gateway"` para enviar a las personas a un [cloud gateway](https://code.claude.com/docs/es/claude-apps-gateway) en lugar de un inicio de sesión propio de Anthropic. Los administradores lo establecen en la configuración administrada y lo combinan con [`forceLoginOrgUUID`](#forceloginorguuid) para mantener los inicios de sesión de claude.ai de los desarrolladores dentro de una organización.

5223 5307 

5224Si lo estableces en `"claudeai"` en cualquier archivo de configuración, Claude Code también deja de ofrecer el [inicio de sesión en Console sin clave](https://code.claude.com/docs/es/authentication.md#sign-in-without-an-api-key) en las sesiones a las que se aplica ese archivo. Con solo `"console"`, las personas aún pueden llegar al inicio de sesión sin clave tras un inicio de sesión fallido. Para que Claude Code deje de ofrecerlo, consulta [Dejar de ofrecer el inicio de sesión sin clave en máquinas administradas](https://code.claude.com/docs/es/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), que también enumera qué más cambia `forceLoginOrgUUID`.5308Si lo estableces en `"claudeai"` en cualquier archivo de configuración, Claude Code también deja de ofrecer el [inicio de sesión en Console sin clave](https://code.claude.com/docs/es/authentication.md#sign-in-without-an-api-key) en las sesiones a las que se aplica ese archivo. Con solo `"console"`, las personas aún pueden llegar al inicio de sesión sin clave tras un inicio de sesión fallido. Para que Claude Code deje de ofrecerlo, consulta [Dejar de ofrecer el inicio de sesión sin clave en máquinas administradas](https://code.claude.com/docs/es/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines), que también enumera qué más cambia `forceLoginOrgUUID`.

5225 5309 

5226* **Alcance**: [`Any file`](#scopes). Claude Code respeta `"gateway"` desde las mismas fuentes que [`forceLoginGatewayUrl`](#forcelogingatewayurl) y lo trata como sin definir en cualquier otro lugar.5310* **Alcance**: [`Any file`](#scopes). Claude Code respeta `"gateway"` desde las mismas fuentes que [`forceLoginGatewayUrl`](#forcelogingatewayurl) y lo trata como sin definir en cualquier otro lugar.

5227* **Tipo**: cadena, una de:5311* **Tipo**: cadena, una de:

5228 * `"claudeai"`: solo las cuentas de claude.ai pueden iniciar sesión5312 * `"claudeai"`: inicio de sesión en claude.ai

5229 * `"console"`: solo las cuentas de Claude Console pueden iniciar sesión5313 * `"console"`: inicio de sesión en Claude Console

5230 * `"gateway"`: Claude Code envía a las personas a un cloud gateway en lugar de un inicio de sesión propio de Anthropic5314 * `"gateway"`: Claude Code envía a las personas a un cloud gateway en lugar de un inicio de sesión propio de Anthropic

5231* **Valor predeterminado**: sin definir, por lo que las personas eligen un método de inicio de sesión5315* **Valor predeterminado**: sin definir, por lo que las personas eligen un método de inicio de sesión

5232 5316 

5471 5555 

5472Establezca cuántos días Claude Code mantiene [transcripciones de sesión y otros datos de aplicación](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically) antes de eliminarlos. Claude Code ejecuta la eliminación como un barrido de fondo después de que comienza una sesión, siempre que pueda determinar de forma segura el período de retención. El barrido elimina transcripciones sin mostrar un mensaje, por lo que una sesión que no ha utilizado durante más tiempo que el período de retención ya no aparece en el selector [`/resume`](https://code.claude.com/docs/es/sessions#resume-a-session).5556Establezca cuántos días Claude Code mantiene [transcripciones de sesión y otros datos de aplicación](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically) antes de eliminarlos. Claude Code ejecuta la eliminación como un barrido de fondo después de que comienza una sesión, siempre que pueda determinar de forma segura el período de retención. El barrido elimina transcripciones sin mostrar un mensaje, por lo que una sesión que no ha utilizado durante más tiempo que el período de retención ya no aparece en el selector [`/resume`](https://code.claude.com/docs/es/sessions#resume-a-session).

5473 5557 

5558De forma predeterminada, Claude Code mantiene más allá de este período las transcripciones de las sesiones que iniciaste o continuaste más recientemente en Claude Desktop o Cowork, incluso si estableces esta clave tú mismo. Este período [aún se les aplica en algunos casos](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically), como con la configuración de HIPAA. Antes de la v2.1.248, Claude Code las eliminaba después de este período.

5559 

5474* **Scope**: [`Any file`](#scopes)5560* **Scope**: [`Any file`](#scopes)

5475* **Type**: número de días, un número entero, mínimo `1`5561* **Type**: número de días, un número entero, mínimo `1`

5476* **Default**: `30`5562* **Default**: `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Establece un límite de antigüedad en días para las transcripciones de sesiones que iniciaste o continuaste más recientemente en Claude Desktop o Cowork. Sin esta clave, Claude Code [mantiene esas transcripciones a cualquier edad](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically). Claude Code elimina cada una una vez que es más antigua que tanto este límite como [`cleanupPeriodDays`](#cleanupperioddays), así que con `cleanupPeriodDays` en su valor predeterminado de 30, un valor de `7` aún las mantiene 30 días. [Cleaned up automatically](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically) enumera los casos en los que se aplica `cleanupPeriodDays` en su lugar y Claude Code ignora esta clave. Requiere Claude Code v2.1.248 o posterior.5574Establece un límite de antigüedad en días para las transcripciones de sesiones que iniciaste o continuaste más recientemente en Claude Desktop o Cowork. Sin esta clave, Claude Code [mantiene esas transcripciones a cualquier edad](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically), excepto en casos como una sesión que eliminaste en Claude Desktop. Requiere Claude Code v2.1.248 o posterior.

5575 

5576Claude Code elimina cada transcripción una vez que es más antigua que tanto este límite como [`cleanupPeriodDays`](#cleanupperioddays), así que con `cleanupPeriodDays` en su valor predeterminado de 30, un valor de `7` aún las mantiene 30 días. [Cleaned up automatically](https://code.claude.com/docs/es/claude-directory.md#cleaned-up-automatically) enumera los casos en los que se aplica `cleanupPeriodDays` en su lugar y Claude Code ignora esta clave.

5489 5577 

5490* **Scope**: [`User or managed`](#scopes). Claude Code también lee la clave de un archivo que pasa con `--settings`, e la ignora en la configuración de proyecto y local.5578* **Scope**: [`User or managed`](#scopes). Claude Code también lee la clave de un archivo que pasa con `--settings`, e la ignora en la configuración de proyecto y local.

5491* **Type**: número de días, un número entero, mínimo `0`5579* **Type**: número de días, un número entero, mínimo `0`