SpyBara
Go Premium

Documentation 2026-10-05 23:58 UTC to 2026-10-06 15:00 UTC

78 files changed +920 −740. View all changes and history on the product overview
2026
Tue 6 16:00 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59

admin-setup.md +5 −4

Details

169 Revisar el manejo de datos169 Revisar el manejo de datos

170</h2>170</h2>

171 171 

172En planes de Team, Enterprise, Claude API y proveedores de nube, Anthropic no entrena modelos con su código o indicaciones. Su proveedor de API determina la retención y la postura de cumplimiento.172En planes de Team, Enterprise, Claude API y proveedores de nube, Anthropic no entrena modelos con tu código o prompts. Tu proveedor de API determina la retención y la postura de cumplimiento.

173 173 

174| Tema | Lo que debe saber | Dónde comenzar |174| Tema | Lo que debes saber | Dónde comenzar |

175| :- | :- | :- |175| :- | :- | :- |

176| Data usage policy | Qué recopila Anthropic, cuánto tiempo se retiene, qué nunca se usa para entrenamiento | [Data usage](/docs/es/data-usage) |176| Data usage policy | Qué recopila Anthropic, cuánto tiempo se retiene, qué nunca se usa para entrenamiento | [Data usage](/docs/es/data-usage) |

177| Zero Data Retention (ZDR) | Nada almacenado después de que se completa la solicitud. Disponible en Claude for Enterprise | [Zero data retention](/docs/es/zero-data-retention) |177| Zero Data Retention (ZDR) | Nada almacenado después de que se completa la solicitud. Disponible para cuentas calificadas en Claude for Enterprise | [Zero data retention](/docs/es/zero-data-retention) |

178| Configuración de HIPAA | Para organizaciones de Claude for Enterprise que tienen HIPAA habilitado. Algunas funciones de Claude Code (modo local) están desactivadas y otras están desactivadas de forma predeterminada | [Configurar Claude Code (modo local) para una organización preparada para HIPAA](/docs/es/hipaa-setup) |

178| Security architecture | Modelo de red, cifrado, autenticación, pista de auditoría | [Security](/docs/es/security) |179| Security architecture | Modelo de red, cifrado, autenticación, pista de auditoría | [Security](/docs/es/security) |

179 180 

180Si necesita registro de auditoría a nivel de solicitud o enrutar tráfico por sensibilidad de datos, coloque una puerta de enlace entre desarrolladores y su proveedor: una [Claude apps gateway](/docs/es/claude-apps-gateway) autohospedada registra un registro de auditoría por solicitud con identidad de IdP, o use otra [LLM gateway](/docs/es/llm-gateway). Para requisitos regulatorios y certificaciones, consulte [Legal and compliance](/docs/es/legal-and-compliance).181Si necesitas registro de auditoría a nivel de solicitud o enrutar tráfico por sensibilidad de datos, te recomendamos colocar un gateway entre los desarrolladores y tu proveedor: un [Claude apps gateway](/docs/es/claude-apps-gateway) autohospedado guarda un registro de auditoría por solicitud con la identidad del IdP, o puedes usar otro [LLM gateway](/docs/es/llm-gateway). Las sesiones que pasan por un gateway no son elegibles para la configuración de HIPAA. [Verificar cómo los desarrolladores inician sesión y se conectan](/docs/es/hipaa-setup#check-how-developers-sign-in-and-connect) enumera las conexiones que sí lo son. Para requisitos regulatorios y certificaciones, consulta [Legal and compliance](/docs/es/legal-and-compliance).

181 182 

182<h2 id="verify-and-onboard">183<h2 id="verify-and-onboard">

183 Verificar e incorporar184 Verificar e incorporar

Details

107 Instrucciones de proyecto (CLAUDE.md y reglas)107 Instrucciones de proyecto (CLAUDE.md y reglas)

108</h2>108</h2>

109 109 

110Los archivos `CLAUDE.md` y los archivos `.claude/rules/*.md` proporcionan a su agente contexto persistente sobre su proyecto: convenciones de codificación, comandos de compilación, decisiones de arquitectura e instrucciones. Cuando `settingSources` incluye `"project"`, como en el [ejemplo de `settingSources`](#control-filesystem-settings-with-settingsources), el SDK carga estos archivos en el contexto al inicio de la sesión. El agente luego sigue sus convenciones de proyecto sin que tenga que repetirlas en cada mensaje.110Los archivos `CLAUDE.md` y los archivos `.claude/rules/*.md` proporcionan a tu agente contexto persistente sobre tu proyecto: convenciones de codificación, comandos de compilación, decisiones de arquitectura e instrucciones. Cuando `settingSources` incluye `"project"`, como en el [ejemplo de `settingSources`](#control-filesystem-settings-with-settingsources), el SDK carga estos archivos en el contexto al inicio de la sesión. El agente luego sigue tus convenciones de proyecto sin que tengas que repetirlas en cada prompt.

111 111 

112<h3 id="claude-md-load-locations">112<h3 id="claude-md-load-locations">

113 Ubicaciones de carga de CLAUDE.md113 Ubicaciones de carga de CLAUDE.md


118| Proyecto (raíz) | `<cwd>/CLAUDE.md` o `<cwd>/.claude/CLAUDE.md` | `settingSources` incluye `"project"` |118| Proyecto (raíz) | `<cwd>/CLAUDE.md` o `<cwd>/.claude/CLAUDE.md` | `settingSources` incluye `"project"` |

119| Reglas del proyecto | `<cwd>/.claude/rules/*.md` y `.claude/rules/*.md` en cada directorio padre | `settingSources` incluye `"project"` |119| Reglas del proyecto | `<cwd>/.claude/rules/*.md` y `.claude/rules/*.md` en cada directorio padre | `settingSources` incluye `"project"` |

120| Proyecto (directorios padre) | Archivos `CLAUDE.md` en directorios por encima de `cwd` | `settingSources` incluye `"project"`, se carga al inicio de la sesión |120| Proyecto (directorios padre) | Archivos `CLAUDE.md` en directorios por encima de `cwd` | `settingSources` incluye `"project"`, se carga al inicio de la sesión |

121| Proyecto (directorios hijo) | Archivos `CLAUDE.md` en subdirectorios de `cwd` | `settingSources` incluye `"project"`, se carga bajo demanda cuando el agente lee un archivo en ese subárbol |121| Proyecto (directorios hijo) | Archivos `CLAUDE.md` en subdirectorios de `cwd` | `settingSources` incluye `"project"`, se carga [bajo demanda](/docs/es/memory#how-claude-md-files-load) |

122| Local | `<cwd>/CLAUDE.local.md` y `CLAUDE.local.md` en cada directorio padre | `settingSources` incluye `"local"` |122| Local | `<cwd>/CLAUDE.local.md` y `CLAUDE.local.md` en cada directorio padre | `settingSources` incluye `"local"` |

123| Usuario | `~/.claude/CLAUDE.md` | `settingSources` incluye `"user"` |123| Usuario | `~/.claude/CLAUDE.md` | `settingSources` incluye `"user"` |

124| Reglas del usuario | `~/.claude/rules/*.md` | `settingSources` incluye `"user"` |124| Reglas del usuario | `~/.claude/rules/*.md` | `settingSources` incluye `"user"` |

125 125 

126Todos los niveles son aditivos: si existen archivos `CLAUDE.md` tanto de proyecto como de usuario, el agente ve ambos. No hay una regla de precedencia dura entre niveles; si las instrucciones entran en conflicto, el resultado depende de cómo Claude las interprete. Escriba reglas que no entren en conflicto, o indique la precedencia explícitamente en el archivo más específico ("Estas instrucciones de proyecto anulan cualquier valor predeterminado conflictivo a nivel de usuario").126Todos los niveles son aditivos: si existen archivos CLAUDE.md tanto de proyecto como de usuario, el agente ve ambos. No hay una regla de precedencia estricta entre niveles; si las instrucciones entran en conflicto, el resultado depende de cómo Claude las interprete. Escribe reglas que no entren en conflicto, o indica la precedencia explícitamente en el archivo más específico ("Estas instrucciones de proyecto sobrescriben cualquier valor predeterminado conflictivo a nivel de usuario").

127 127 

128<Tip>128<Tip>

129 También puede inyectar contexto directamente a través de `systemPrompt` sin usar archivos `CLAUDE.md`. Consulte [Modificar mensajes del sistema](/docs/es/agent-sdk/modifying-system-prompts). Use `CLAUDE.md` cuando desee que el mismo contexto se comparta entre sesiones interactivas de Claude Code y sus agentes SDK.129 También puedes inyectar contexto directamente a través de `systemPrompt` sin usar archivos CLAUDE.md. Consulta [Modificar prompts del sistema](/docs/es/agent-sdk/modifying-system-prompts). Usa CLAUDE.md cuando quieras que el mismo contexto se comparta entre sesiones interactivas de Claude Code y tus agentes del SDK.

130</Tip>130</Tip>

131 131 

132Para saber cómo estructurar y organizar el contenido de `CLAUDE.md`, consulte [Administrar la memoria de Claude](/docs/es/memory).132Para saber cómo estructurar y organizar el contenido de CLAUDE.md, consulta [Administrar la memoria de Claude](/docs/es/memory).

133 133 

134<h2 id="skills">134<h2 id="skills">

135 Skills135 Skills

Details

10 10 

11Para obtener la documentación completa de la API, consulte la [referencia del SDK de TypeScript](/docs/es/agent-sdk/typescript) y la [referencia del SDK de Python](/docs/es/agent-sdk/python).11Para obtener la documentación completa de la API, consulte la [referencia del SDK de TypeScript](/docs/es/agent-sdk/typescript) y la [referencia del SDK de Python](/docs/es/agent-sdk/python).

12 12 

13<span id="estimates-not-billing" />

14 

13<Warning>15<Warning>

14 Los campos `total_cost_usd` y `costUSD` son estimaciones del lado del cliente, no datos de facturación autorizados. El SDK los calcula localmente a partir de una tabla de precios incluida en el momento de la compilación, a menos que una tabla [`modelPricing`](/docs/es/settings-reference#modelpricing) esté en vigor. Pueden desviarse de lo que realmente se le factura cuando:16 Los campos `total_cost_usd` y `costUSD` son estimaciones del lado del cliente, no datos de facturación autorizados. El SDK los calcula localmente a partir de una tabla de precios incluida en el momento de la compilación, a menos que una tabla [`modelPricing`](/docs/es/settings-reference#modelpricing) esté en vigor. Pueden desviarse de lo que realmente se le factura cuando:

15 17 


242* **Llamadas independientes, sin opción `resume` o `continue`**: cada resultado cubre solo su propia llamada, por lo que debe sumar los totales usted mismo, como hacen los ejemplos a continuación.244* **Llamadas independientes, sin opción `resume` o `continue`**: cada resultado cubre solo su propia llamada, por lo que debe sumar los totales usted mismo, como hacen los ejemplos a continuación.

243* **Llamadas que reanudan la misma sesión**: Claude Code guarda los totales de la sesión en su [transcripción](/docs/es/sessions#where-transcripts-are-stored) cuando el proceso se cierra normalmente y los restaura cuando una llamada posterior reanuda o bifurca la sesión. Cada resultado ya incluye el gasto anterior de la sesión. Lea el resultado más reciente para el total de la sesión; sumar resultados cuenta dos veces el gasto restaurado. Antes de v2.1.277, una sesión que reanudaba a través del SDK o `claude -p` iniciaba sus totales en cero, por lo que cada resultado de llamada cubría solo esa llamada.245* **Llamadas que reanudan la misma sesión**: Claude Code guarda los totales de la sesión en su [transcripción](/docs/es/sessions#where-transcripts-are-stored) cuando el proceso se cierra normalmente y los restaura cuando una llamada posterior reanuda o bifurca la sesión. Cada resultado ya incluye el gasto anterior de la sesión. Lea el resultado más reciente para el total de la sesión; sumar resultados cuenta dos veces el gasto restaurado. Antes de v2.1.277, una sesión que reanudaba a través del SDK o `claude -p` iniciaba sus totales en cero, por lo que cada resultado de llamada cubría solo esa llamada.

244 246 

247En cualquier caso, la cifra combinada sigue siendo una [estimación del lado del cliente](#estimates-not-billing).

248 

245En modo de entrada de transmisión, lea el total de cada llamada como se describe en [Rastrear costos en modo de entrada de transmisión](#track-costs-in-streaming-input-mode). Para una llamada que terminó en un bloqueo, consulte [Recuperar totales después de un bloqueo de sesión](#recover-totals-after-a-session-crash).249En modo de entrada de transmisión, lea el total de cada llamada como se describe en [Rastrear costos en modo de entrada de transmisión](#track-costs-in-streaming-input-mode). Para una llamada que terminó en un bloqueo, consulte [Recuperar totales después de un bloqueo de sesión](#recover-totals-after-a-session-crash).

246 250 

247Los siguientes ejemplos ejecutan dos llamadas a `query()` secuencialmente, agregan el `total_cost_usd` de cada llamada a un total acumulado e imprimen tanto el costo por llamada como el costo combinado:251Los siguientes ejemplos ejecutan dos llamadas a `query()` secuencialmente, agregan el `total_cost_usd` de cada llamada a un total acumulado e imprimen tanto el costo por llamada como el costo combinado:

Details

15| Si desea... | Haga esto |15| Si desea... | Haga esto |

16| :- | :- |16| :- | :- |

17| Definir una herramienta | Use [`@tool`](/docs/es/agent-sdk/python#tool) (Python) o [`tool()`](/docs/es/agent-sdk/typescript#tool) (TypeScript) con un nombre, descripción, esquema y controlador. Vea [Crear una herramienta personalizada](#create-a-custom-tool). |17| Definir una herramienta | Use [`@tool`](/docs/es/agent-sdk/python#tool) (Python) o [`tool()`](/docs/es/agent-sdk/typescript#tool) (TypeScript) con un nombre, descripción, esquema y controlador. Vea [Crear una herramienta personalizada](#create-a-custom-tool). |

18| Hacer que un parámetro sea opcional | Decláralo como opcional en el esquema y aplica el valor predeterminado en el controlador. Consulta [Hacer que un parámetro sea opcional](#make-a-parameter-optional). |

18| Registrar una herramienta con Claude | Envuelva en `create_sdk_mcp_server` / `createSdkMcpServer` y pase a `mcpServers` en `query()`. Vea [Llamar a una herramienta personalizada](#call-a-custom-tool). |19| Registrar una herramienta con Claude | Envuelva en `create_sdk_mcp_server` / `createSdkMcpServer` y pase a `mcpServers` en `query()`. Vea [Llamar a una herramienta personalizada](#call-a-custom-tool). |

19| Preaprobación de una herramienta | Agregue a sus herramientas permitidas. Vea [Configurar herramientas permitidas](#configure-allowed-tools). |20| Preaprobación de una herramienta | Agregue a sus herramientas permitidas. Vea [Configurar herramientas permitidas](#configure-allowed-tools). |

20| Eliminar una herramienta integrada del contexto de Claude | Pase un array `tools` listando solo los integrados que desea. Vea [Configurar herramientas permitidas](#configure-allowed-tools). |21| Eliminar una herramienta integrada del contexto de Claude | Pase un array `tools` listando solo los integrados que desea. Vea [Configurar herramientas permitidas](#configure-allowed-tools). |


32 33 

33* **Nombre:** un identificador único que Claude utiliza para llamar a la herramienta.34* **Nombre:** un identificador único que Claude utiliza para llamar a la herramienta.

34* **Descripción:** qué hace la herramienta. Claude lee esto para decidir cuándo llamarla.35* **Descripción:** qué hace la herramienta. Claude lee esto para decidir cuándo llamarla.

35* **Esquema de entrada:** los argumentos que Claude debe proporcionar. En TypeScript esto es siempre un [esquema Zod](https://zod.dev/), y los `args` del manejador se tipan automáticamente a partir de él. En Python esto es un diccionario que asigna nombres a tipos, como `{"latitude": float}`, que el SDK convierte a JSON Schema para usted. El decorador de Python también acepta un diccionario completo de [JSON Schema](https://json-schema.org/understanding-json-schema/about) directamente cuando necesita enumeraciones, rangos, campos opcionales u objetos anidados.36* **Esquema de entrada:** los argumentos que acepta la herramienta, declarados según el lenguaje:

37 * **TypeScript**: un [esquema Zod](https://zod.dev/). Los `args` del manejador toman sus tipos a partir de él. Llama a `.describe()` en un campo para darle una descripción que Claude ve.

38 * **Python**: un diccionario que asigna nombres a tipos, como `{"latitude": float}`, que el SDK convierte a JSON Schema por ti. Envuelve un tipo en `Annotated`, como `{"latitude": Annotated[float, "Latitude coordinate"]}`, para darle al campo una descripción que Claude ve. El decorador también acepta un diccionario completo de [JSON Schema](https://json-schema.org/understanding-json-schema/about) directamente cuando necesitas enumeraciones, rangos, campos opcionales u objetos anidados.

36* **Manejador:** la función asincrónica que se ejecuta cuando Claude llama a la herramienta. Recibe los argumentos validados y debe devolver un objeto con:39* **Manejador:** la función asincrónica que se ejecuta cuando Claude llama a la herramienta. Recibe los argumentos validados y debe devolver un objeto con:

37 * `content` (requerido): una matriz de bloques de resultado, cada uno con un `type` de `"text"`, `"image"`, `"audio"`, `"resource"` o `"resource_link"`. Consulte [Devolver imágenes y recursos](#return-images-and-resources) para bloques que no sean texto.40 * `content` (requerido): una matriz de bloques de resultado, cada uno con un `type` de `"text"`, `"image"`, `"audio"`, `"resource"` o `"resource_link"`. Consulte [Devolver imágenes y recursos](#return-images-and-resources) para bloques que no sean texto.

38 * `structuredContent` (opcional): un objeto JSON que contiene el resultado como datos legibles por máquina, devuelto junto con `content`. Consulte [Devolver datos estructurados](#return-structured-data).41 * `structuredContent` (opcional): un objeto JSON que contiene el resultado como datos legibles por máquina, devuelto junto con `content`. Consulte [Devolver datos estructurados](#return-structured-data).


40 43 

41Después de definir una herramienta, envuélvala en un servidor con [`createSdkMcpServer`](/docs/es/agent-sdk/typescript#createsdkmcpserver) (TypeScript) o [`create_sdk_mcp_server`](/docs/es/agent-sdk/python#create_sdk_mcp_server) (Python). El servidor se ejecuta en el proceso dentro de su aplicación, no como un proceso separado.44Después de definir una herramienta, envuélvala en un servidor con [`createSdkMcpServer`](/docs/es/agent-sdk/typescript#createsdkmcpserver) (TypeScript) o [`create_sdk_mcp_server`](/docs/es/agent-sdk/python#create_sdk_mcp_server) (Python). El servidor se ejecuta en el proceso dentro de su aplicación, no como un proceso separado.

42 45 

46Los ejemplos de Python de esta página que realizan solicitudes HTTP usan [httpx](https://www.python-httpx.org/). Agrégalo con el gestor de paquetes que usa tu proyecto:

47 

48<Tabs>

49 <Tab title="Python (uv)">

50 ```bash theme={null}

51 uv add httpx

52 ```

53 </Tab>

54 

55 <Tab title="Python (pip)">

56 ```bash theme={null}

57 pip install httpx

58 ```

59 </Tab>

60</Tabs>

61 

43<h3 id="weather-tool-example">62<h3 id="weather-tool-example">

44 Ejemplo de herramienta meteorológica63 Ejemplo de herramienta meteorológica

45</h3>64</h3>

46 65 

47Este ejemplo define una herramienta `get_temperature` y la envuelve en un servidor MCP. Solo configura la herramienta; para pasarla a `query` y ejecutarla, consulte [Llamar a una herramienta personalizada](#call-a-custom-tool) a continuación.66Este ejemplo define una herramienta `get_temperature` y la envuelve en un servidor MCP, sin pasar el servidor a `query`. Para ejecutar la herramienta, consulta [Llamar a una herramienta personalizada](#call-a-custom-tool) a continuación.

48 67 

49<CodeGroup>68<CodeGroup>

50 ```python Python theme={null}69 ```python Python theme={null}

51 from typing import Any70 from typing import Annotated, Any

52 import httpx71 import httpx

53 from claude_agent_sdk import tool, create_sdk_mcp_server72 from claude_agent_sdk import tool, create_sdk_mcp_server

54 73 


57 @tool(76 @tool(

58 "get_temperature",77 "get_temperature",

59 "Get the current temperature at a location",78 "Get the current temperature at a location",

60 {"latitude": float, "longitude": float},79 {

80 "latitude": Annotated[float, "Latitude coordinate"],

81 "longitude": Annotated[float, "Longitude coordinate"],

82 },

61 )83 )

62 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:84 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:

63 async with httpx.AsyncClient() as client:85 async with httpx.AsyncClient() as client:


128 150 

129Consulte la referencia de TypeScript [`tool()`](/docs/es/agent-sdk/typescript#tool) o la referencia de Python [`@tool`](/docs/es/agent-sdk/python#tool) para obtener detalles completos de parámetros, incluidos formatos de entrada de JSON Schema y estructura de valores de retorno.151Consulte la referencia de TypeScript [`tool()`](/docs/es/agent-sdk/typescript#tool) o la referencia de Python [`@tool`](/docs/es/agent-sdk/python#tool) para obtener detalles completos de parámetros, incluidos formatos de entrada de JSON Schema y estructura de valores de retorno.

130 152 

131<Tip>153<h3 id="make-a-parameter-optional">

132 Para hacer un parámetro opcional: en TypeScript, agregue `.optional()` al campo Zod y aplique el valor predeterminado en el manejador. En Python, el esquema de diccionario trata cada clave como requerida, así que deje el parámetro fuera del esquema, menciónelo en la cadena de descripción y léalo con `args.get()` en el manejador. La herramienta [`get_precipitation_chance` a continuación](#add-more-tools) muestra ambos patrones.154 Hacer un parámetro opcional

133</Tip>155</h3>

156 

157Para hacer un parámetro opcional, decláralo como opcional en el esquema y aplica el valor predeterminado en el manejador:

158 

159* **TypeScript**: agrega `.optional()` al campo Zod.

160* **Python**: el esquema de diccionario requiere cada clave. Usa la forma de JSON Schema, deja el parámetro fuera de `required` y léelo con `args.get()`. Para un esquema tipado con claves opcionales, consulta [clase TypedDict](/docs/es/agent-sdk/python#input-schema-options).

161 

162La herramienta [`get_precipitation_chance` a continuación](#add-more-tools) muestra ambos patrones.

134 163 

135<h3 id="call-a-custom-tool">164<h3 id="call-a-custom-tool">

136 Llamar a una herramienta personalizada165 Llamar a una herramienta personalizada


182 ```211 ```

183</CodeGroup>212</CodeGroup>

184 213 

185Combine este fragmento con las definiciones de herramienta y servidor del [ejemplo de herramienta meteorológica](#weather-tool-example) en un archivo, luego ejecútelo con `python weather.py` para Python o `npx tsx weather.ts` para TypeScript. Claude llama a `get_temperature` y el script imprime una respuesta de una línea con la temperatura actual en San Francisco.214Combina este fragmento con las definiciones de herramienta y servidor del [ejemplo de herramienta meteorológica](#weather-tool-example) en un archivo, `weather.py` o `weather.ts`, y luego ejecútalo desde tu terminal:

215 

216<Tabs>

217 <Tab title="TypeScript">

218 ```bash theme={null}

219 npx tsx weather.ts

220 ```

221 </Tab>

222 

223 <Tab title="Python (uv)">

224 ```bash theme={null}

225 uv run weather.py

226 ```

227 </Tab>

228 

229 <Tab title="Python (pip)">

230 Activa el entorno virtual donde instalaste el SDK y luego ejecuta:

231 

232 ```bash theme={null}

233 python weather.py

234 ```

235 </Tab>

236</Tabs>

237 

238Claude llama a `get_temperature` y el script imprime una respuesta de una línea con la temperatura actual en San Francisco.

186 239 

187<h3 id="add-more-tools">240<h3 id="add-more-tools">

188 Agregar más herramientas241 Agregar más herramientas


197 # Define a second tool for the same server250 # Define a second tool for the same server

198 @tool(251 @tool(

199 "get_precipitation_chance",252 "get_precipitation_chance",

200 "Get the hourly precipitation probability for a location. "253 "Get the hourly precipitation probability for a location",

201 "Optionally pass 'hours' (1-24) to control how many hours to return.",254 {

202 {"latitude": float, "longitude": float},255 "type": "object",

256 "properties": {

257 "latitude": {"type": "number"},

258 "longitude": {"type": "number"},

259 "hours": {

260 "type": "integer",

261 "minimum": 1,

262 "maximum": 24,

263 "description": "How many hours of forecast to return",

264 },

265 },

266 # 'hours' is left out of required, so Claude can omit it

267 "required": ["latitude", "longitude"],

268 },

203 )269 )

204 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:270 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:

205 # 'hours' isn't in the schema - read it with .get() to make it optional271 # 'hours' isn't in required - read it with .get() to fall back to a default

206 hours = args.get("hours", 12)272 hours = args.get("hours", 12)

207 async with httpx.AsyncClient() as client:273 async with httpx.AsyncClient() as client:

208 response = await client.get(274 response = await client.get(

Details

147 }147 }

148 ```148 ```

149 149 

1503. **Clase TypedDict**: un esquema tipado cuyas claves `NotRequired` quedan fuera de `required`.

151 

152 * **Python 3.11 y posteriores**: importa `TypedDict` y `NotRequired` desde `typing`.

153 * **Python 3.10**: `typing` no tiene `NotRequired`. Importa `TypedDict` y `NotRequired` desde `typing_extensions`, que el SDK instala en Python 3.10.

154 

155 ```python theme={null}

156 from typing import Annotated, Any, NotRequired, TypedDict

157 from claude_agent_sdk import tool

158 

159 

160 class ForecastArgs(TypedDict):

161 latitude: Annotated[float, "Latitude coordinate"]

162 hours: NotRequired[Annotated[int, "How many hours of forecast to return"]]

163 

164 

165 @tool("get_forecast", "Get the hourly forecast for a location", ForecastArgs)

166 async def get_forecast(args: dict[str, Any]) -> dict[str, Any]:

167 hours = args.get("hours", 12)

168 return {"content": [{"type": "text", "text": f"{hours}-hour forecast for {args['latitude']}"}]}

169 ```

170 

171En las formas de mapeo simple y TypedDict, envuelve un tipo en `Annotated[type, "description"]` para establecer la descripción del campo.

172 

150<h4 id="returns-2">173<h4 id="returns-2">

151 Devuelve174 Devuelve

152</h4>175</h4>


1781 data: dict[str, Any]1804 data: dict[str, Any]

1782```1805```

1783 1806 

1807Los subtipos que no tienen una clase de datos propia llegan como `SystemMessage`. Para seguir la sesión entre turnos, establece [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/es/env-vars#variables) y lee `message.data["state"]` en cada mensaje cuyo `subtype` sea `session_state_changed`. [`SDKSessionStateChangedMessage`](/docs/es/agent-sdk/typescript#sdksessionstatechangedmessage) enumera los estados que puede llevar. Itera con `receive_messages()` para leerlos: `receive_response()` se detiene en el `ResultMessage`, y un mensaje `session_state_changed` puede llegar después de ese resultado.

1808 

1784<h3 id="resultmessage">1809<h3 id="resultmessage">

1785 `ResultMessage`1810 `ResultMessage`

1786</h3>1811</h3>

Details

130 Consulte las guías de configuración para [Amazon Bedrock](/docs/es/amazon-bedrock), [Claude Platform on AWS](/docs/es/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), o [Microsoft Foundry](/docs/es/microsoft-foundry) para obtener más detalles.130 Consulte las guías de configuración para [Amazon Bedrock](/docs/es/amazon-bedrock), [Claude Platform on AWS](/docs/es/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), o [Microsoft Foundry](/docs/es/microsoft-foundry) para obtener más detalles.

131 131 

132 <Note>132 <Note>

133 A menos que haya sido aprobado previamente, Anthropic no permite que desarrolladores de terceros ofrezcan inicio de sesión en claude.ai o límites de velocidad para sus productos, incluidos los agentes construidos en el SDK de Agent de Claude. Por favor, utilice los métodos de autenticación de clave de API descritos en este documento en su lugar.133 A menos que haya sido aprobado previamente, Anthropic no permite que desarrolladores de terceros ofrezcan inicio de sesión en claude.ai o rate limits para sus productos, incluidos los agentes construidos con el Claude Agent SDK. En su lugar, usa los métodos de autenticación con clave de API descritos en este documento.

134 </Note>134 </Note>

135 </Step>135 </Step>

136</Steps>136</Steps>

Details

317 317 

318Este enfoque maneja cualquier servicio basado en HTTP sin escribir herramientas personalizadas, pero agrega complejidad alrededor de la gestión de certificados.318Este enfoque maneja cualquier servicio basado en HTTP sin escribir herramientas personalizadas, pero agrega complejidad alrededor de la gestión de certificados.

319 319 

320Tenga en cuenta que no todos los programas respetan `HTTP_PROXY`/`HTTPS_PROXY`. La mayoría de herramientas (curl, pip, npm, git) lo hacen, pero algunas pueden omitir estas variables y conectarse directamente. Por ejemplo, `fetch()` de Node.js ignora estas variables por defecto; en Node 24+ puede establecer `NODE_USE_ENV_PROXY=1` para habilitar soporte. Para cobertura completa, puede usar [proxychains](https://github.com/haad/proxychains) para interceptar llamadas de red, o configurar iptables para redirigir tráfico saliente a un proxy transparente.320Ten en cuenta que no todos los programas respetan `HTTP_PROXY`/`HTTPS_PROXY`. La mayoría de herramientas (curl, pip, npm, git) lo hacen, pero algunas pueden omitir estas variables y conectarse directamente. Por ejemplo, `fetch()` de Node.js ignora estas variables por defecto; en Node 24+ puedes establecer `NODE_USE_ENV_PROXY=1` para habilitar soporte. Para cubrir las herramientas que ignoran estas variables, puedes usar [proxychains](https://github.com/haad/proxychains) para interceptar llamadas de red, o configurar iptables para redirigir tráfico saliente a un proxy transparente.

321 321 

322<Info>322<Info>

323 Un **proxy transparente** intercepta tráfico a nivel de red, por lo que el cliente no necesita ser configurado para usarlo. Los proxies regulares requieren que los clientes se conecten explícitamente y hablen HTTP CONNECT o SOCKS. Los proxies transparentes (como Squid o mitmproxy en modo transparente) pueden manejar conexiones TCP sin procesar redirigidas.323 Un **proxy transparente** intercepta tráfico a nivel de red, por lo que el cliente no necesita ser configurado para usarlo. Los proxies regulares requieren que los clientes se conecten explícitamente y hablen HTTP CONNECT o SOCKS. Los proxies transparentes (como Squid o mitmproxy en modo transparente) pueden manejar conexiones TCP sin procesar redirigidas.

Details

8 8 

9Agent Skills extienden Claude con capacidades especializadas que Claude invoca cuando es relevante. Las Skills se empaquetan como archivos `SKILL.md` que contienen instrucciones, descripciones y recursos de apoyo opcionales. Esta página también cubre [comandos en sesiones del Agent SDK](#commands-in-agent-sdk-sessions).9Agent Skills extienden Claude con capacidades especializadas que Claude invoca cuando es relevante. Las Skills se empaquetan como archivos `SKILL.md` que contienen instrucciones, descripciones y recursos de apoyo opcionales. Esta página también cubre [comandos en sesiones del Agent SDK](#commands-in-agent-sdk-sessions).

10 10 

11Para obtener información completa sobre skills, incluidos beneficios, arquitectura y directrices de autoría, consulte la [descripción general de Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).11Para obtener más información sobre skills, incluidos beneficios, arquitectura y directrices de autoría, consulta la [descripción general de Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).

12 12 

13<h2 id="how-skills-work-with-the-agent-sdk">13<h2 id="how-skills-work-with-the-agent-sdk">

14 Cómo funcionan las skills con el Agent SDK14 Cómo funcionan las skills con el Agent SDK

Details

8 8 

9Las salidas estructuradas le permiten definir la forma exacta de los datos que desea recuperar de un agente. El agente puede usar cualquier herramienta que necesite para completar la tarea, y aún así obtiene JSON validado que coincide con su esquema al final. Defina un [JSON Schema](https://json-schema.org/understanding-json-schema/about) para la estructura que necesita, y el SDK valida la salida en su contra, re-solicitando en caso de discrepancia. Si la validación no tiene éxito dentro del límite de reintentos, el resultado es un error en lugar de datos estructurados; consulte [Manejo de errores](#error-handling).9Las salidas estructuradas le permiten definir la forma exacta de los datos que desea recuperar de un agente. El agente puede usar cualquier herramienta que necesite para completar la tarea, y aún así obtiene JSON validado que coincide con su esquema al final. Defina un [JSON Schema](https://json-schema.org/understanding-json-schema/about) para la estructura que necesita, y el SDK valida la salida en su contra, re-solicitando en caso de discrepancia. Si la validación no tiene éxito dentro del límite de reintentos, el resultado es un error en lugar de datos estructurados; consulte [Manejo de errores](#error-handling).

10 10 

11Para una seguridad de tipos completa, use [Zod](#type-safe-schemas-with-zod-and-pydantic) (TypeScript) o [Pydantic](#type-safe-schemas-with-zod-and-pydantic) (Python) para definir su esquema y obtener objetos fuertemente tipados.11Para una seguridad de tipos completa, usa [Zod](#type-safe-schemas-with-zod-and-pydantic) (TypeScript) o [Pydantic](#type-safe-schemas-with-zod-and-pydantic) (Python) para definir tu esquema y obtener objetos fuertemente tipados.

12 12 

13<h2 id="why-structured-outputs">13<h2 id="why-structured-outputs">

14 ¿Por qué salidas estructuradas?14 ¿Por qué salidas estructuradas?

Details

768 Documentación relacionada768 Documentación relacionada

769</h2>769</h2>

770 770 

771* [Subagentes de Claude Code](/docs/es/sub-agents): documentación completa de subagentes incluyendo definiciones basadas en sistema de archivos771* [Subagentes de Claude Code](/docs/es/sub-agents): documentación de subagentes incluyendo definiciones basadas en sistema de archivos

772* [Flujos de trabajo dinámicos](/docs/es/workflows): orqueste muchos subagentes desde un script para trabajos demasiado grandes para una conversación772* [Flujos de trabajo dinámicos](/docs/es/workflows): orqueste muchos subagentes desde un script para trabajos demasiado grandes para una conversación

773* [Descripción general del SDK](/docs/es/agent-sdk/overview): introducción al Claude Agent SDK773* [Descripción general del SDK](/docs/es/agent-sdk/overview): introducción al Claude Agent SDK

Details

2299 Tipos de Hook2299 Tipos de Hook

2300</h2>2300</h2>

2301 2301 

2302Para una guía completa sobre el uso de hooks con ejemplos y patrones comunes, vea la [guía de Hooks](/docs/es/agent-sdk/hooks).2302Para una guía sobre el uso de hooks con ejemplos y patrones comunes, consulta la [guía de Hooks](/docs/es/agent-sdk/hooks).

2303 2303 

2304<h3 id="hookevent">2304<h3 id="hookevent">

2305 `HookEvent`2305 `HookEvent`


3362};3362};

3363```3363```

3364 3364 

3365Herramienta de búsqueda poderosa construida en ripgrep con soporte de expresiones regulares.3365Herramienta de búsqueda construida sobre ripgrep con soporte de expresiones regulares.

3366 3366 

3367<h3 id="taskstop">3367<h3 id="taskstop">

3368 TaskStop3368 TaskStop


5880};5880};

5881```5881```

5882 5882 

5883<h3 id="sdksessionstatechangedmessage">

5884 `SDKSessionStateChangedMessage`

5885</h3>

5886 

5887Se emite cuando Claude Code reporta el estado de la sesión. Para recibir estos mensajes, establece [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/es/env-vars#variables). Claude Code puede reportar el mismo estado más de una vez, así que interpreta un mensaje como el estado actual de la sesión y no como una transición.

5888 

5889El campo `state` lleva uno de estos valores:

5890 

5891* `running`: la sesión está trabajando.

5892* `idle`: Claude Code está esperando tu siguiente prompt.

5893* `requires_action`: la sesión está bloqueada a la espera de una respuesta a una solicitud que envió a tu host, como una solicitud de permiso.

5894 

5895El mensaje `idle` de un turno y su mensaje `result` pueden llegar en cualquier orden. Para cambiar si `idle` espera el trabajo en segundo plano, como un subagente en segundo plano o una ejecución de un [flujo de trabajo](/docs/es/workflows), consulta [`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`](/docs/es/env-vars#variables).

5896 

5897```typescript theme={null}

5898type SDKSessionStateChangedMessage = {

5899 type: "system";

5900 subtype: "session_state_changed";

5901 state: "idle" | "running" | "requires_action";

5902 uuid: UUID;

5903 session_id: string;

5904};

5905```

5906 

5883<h3 id="sdkfilespersistedevent">5907<h3 id="sdkfilespersistedevent">

5884 `SDKFilesPersistedEvent`5908 `SDKFilesPersistedEvent`

5885</h3>5909</h3>

agent-view.md +398 −395

Details

95Para iniciar una sesión regular mientras la configuración está activada, pase un mensaje: `claude "fix the login test"`. Para desactivar la configuración, ejecute `/config defaultToAgentsView=false` en una sesión regular o en una a la que se conecte desde la vista de agentes.95Para iniciar una sesión regular mientras la configuración está activada, pase un mensaje: `claude "fix the login test"`. Para desactivar la configuración, ejecute `/config defaultToAgentsView=false` en una sesión regular o en una a la que se conecte desde la vista de agentes.

96 96 

97<h2 id="monitor-sessions-with-agent-view">97<h2 id="monitor-sessions-with-agent-view">

98 Monitorear sesiones con vista de agentes98 Monitorear sesiones con la vista de agentes

99</h2>99</h2>

100 100 

101Ejecute `claude agents` para abrir la vista de agentes. Toma el control de la terminal completa y enumera cada sesión agrupada por estado, con sesiones fijadas y las que necesitan su atención en la parte superior. Cada fila muestra el nombre de la sesión, la actividad actual y su antigüedad, contada desde cuándo se creó la sesión; la antigüedad de una sesión finalizada se congela en cuánto tiempo tardó la ejecución.101Ejecuta `claude agents` para abrir la vista de agentes. Ocupa la terminal completa y enumera cada sesión agrupada por estado, con las sesiones fijadas y las que necesitan tu atención en la parte superior. Cada fila muestra el nombre de la sesión, la actividad actual y su antigüedad, contada desde que se creó la sesión; la antigüedad de una sesión finalizada se congela en lo que tardó la ejecución.

102 102 

103El nombre está teñido con el color establecido por [`/color`](/docs/es/commands) en esa sesión, incluyendo cuando [coloca una sesión en segundo plano](#from-inside-a-session) con `←` o `/background`.103El nombre está teñido con el color establecido por [`/color`](/docs/es/commands) en esa sesión, incluso cuando [pasas una sesión a segundo plano](#from-inside-a-session) con `←` o `/background`.

104 104 

105De forma predeterminada, la lista muestra cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que funciona en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Para reducir la lista a un proyecto, pase `--cwd`:105De forma predeterminada, la lista muestra cada sesión en segundo plano que has iniciado, en todos tus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente del directorio desde el que abriste la vista de agentes. Para reducir la lista a un proyecto, pasa `--cwd`:

106 106 

107```bash theme={null}107```bash theme={null}

108claude agents --cwd ~/projects/my-app108claude agents --cwd ~/projects/my-app


110 110 

111Esto muestra solo las sesiones iniciadas en ese directorio. Aún enumera una sesión que se ha [movido a un worktree](#how-file-edits-are-isolated) bajo `~/projects/my-app/.claude/worktrees/`.111Esto muestra solo las sesiones iniciadas en ese directorio. Aún enumera una sesión que se ha [movido a un worktree](#how-file-edits-are-isolated) bajo `~/projects/my-app/.claude/worktrees/`.

112 112 

113Las sesiones interactivas que tiene abiertas en otras terminales no aparecen hasta que las [coloque en segundo plano](#from-inside-a-session). Los [subagentes](/docs/es/sub-agents) y [compañeros de equipo](/docs/es/agent-teams) que una sesión genera no se enumeran como filas separadas.113Las sesiones interactivas que tienes abiertas en otras terminales no aparecen hasta que las [pases a segundo plano](#from-inside-a-session). Los [subagentes](/docs/es/sub-agents) y [compañeros de equipo](/docs/es/agent-teams) que genera una sesión no se enumeran como filas separadas.

114 114 

115```text theme={null}115```text theme={null}

116Pinned116Pinned


124 124 

125Working125Working

126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

127 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m127 ✢ playtest level 3 all checkpoints cleared ×12 in 4m

128 128 

129Completed129Completed

130 ✻ title screen result: menu, options, and credits done 9m130 ✻ title screen menu, options, and credits done 9m

131 ∙ sound effects result: 14 SFX exported to assets/audio 4h131 ∙ sound effects 14 SFX exported to assets/audio 4h

132 … 6 more132 … 6 more

133```133```

134 134 


141| Estado | El icono se muestra como | Qué significa |141| Estado | El icono se muestra como | Qué significa |

142| :- | :- | :- |142| :- | :- | :- |

143| Working | Animado | Claude está ejecutando activamente herramientas o generando una respuesta |143| Working | Animado | Claude está ejecutando activamente herramientas o generando una respuesta |

144| Needs input | Amarillo | Claude está esperando algo que solo usted puede proporcionar: una respuesta a una pregunta, una decisión de permiso, u otro mensaje que solo usted puede responder, como un mensaje de [sandbox](/docs/es/sandboxing) para permitir un host de red o la [solicitud de entrada](/docs/es/mcp#respond-to-mcp-elicitation-requests) de un servidor MCP. Un comando que necesita una terminal adjunta, como `/install-github-app` o la lista de configuración `/mcp`, también [mantiene una sesión desatendida aquí](#attach-to-a-session) |144| Needs input | Amarillo | Claude está esperando algo que solo tú puedes proporcionar: una respuesta a una pregunta, una decisión de permiso u otra solicitud que solo tú puedes responder, como una solicitud del [sandbox](/docs/es/sandboxing) para permitir un host de red o la [solicitud de entrada](/docs/es/mcp#respond-to-mcp-elicitation-requests) de un servidor MCP. Un comando que necesita una terminal adjunta, como `/install-github-app` o la lista de configuración de `/mcp`, también [mantiene aquí una sesión desatendida](#attach-to-a-session) |

145| Idle | Atenuado | La sesión no tiene nada que hacer y está lista para su próximo mensaje |145| Idle | Atenuado | La sesión no tiene nada que hacer y está lista para tu próximo prompt |

146| Completed | Verde | La tarea se completó exitosamente |146| Completed | Verde | La tarea se completó correctamente |

147| Failed | Rojo | La tarea terminó con un error |147| Failed | Rojo | La tarea terminó con un error |

148| Stopped | Gris | Detuvo la sesión con `Ctrl+X` o `claude stop`, [su proceso fue terminado desde fuera de Claude Code](#the-supervisor-process), o [terminó mientras el servicio en segundo plano estaba apagado](#sessions-show-as-failed-after-shutdown) |148| Stopped | Gris | Detuviste la sesión con `Ctrl+X` o `claude stop`, [su proceso se terminó desde fuera de Claude Code](#the-supervisor-process), o [terminó mientras el servicio en segundo plano estaba apagado](#sessions-show-as-failed-after-shutdown) |

149 149 

150Por separado, la forma del icono muestra si el proceso subyacente se está ejecutando:150Por separado, la forma del icono tiene su propio significado:

151 151 

152| Forma | Qué significa |152| Forma | Qué significa |

153| :- | :- |153| :- | :- |

154| `✻` o `✽` animado | El proceso de sesión está vivo y responde inmediatamente |154| `✻` o `✽` animado | El proceso de la sesión se está ejecutando, o la sesión necesita tu entrada |

155| `∙` | El proceso ha salido. Aún puede ver la fila, y cuando responda o se adjunte, Claude reinicia desde donde lo dejó |155| `∙` | El proceso ha terminado. Aún puedes echar un vistazo a la fila, y cuando respondas o te adjuntes, Claude se reinicia desde donde lo dejó |

156| `✢` | Una sesión [`/loop`](/docs/es/scheduled-tasks) durmiendo entre iteraciones. La fila muestra su recuento de ejecuciones y una cuenta regresiva |156| `✢` | Una sesión de [`/loop`](/docs/es/scheduled-tasks) en reposo entre iteraciones. La fila muestra su recuento de ejecuciones y una cuenta regresiva |

157 157 

158La etiqueta `#N` o `!N` que puede aparecer en el borde derecho de una fila es un enlace al [pull request o merge request](#pull-request-status) de la sesión, no parte del icono de estado.158La etiqueta `#N` o `!N` que puede aparecer en el borde derecho de una fila es un enlace al [pull request o merge request](#pull-request-status) de la sesión, no parte del icono de estado.

159 159 

160El título de la pestaña de terminal muestra el recuento de entrada pendiente mientras la vista de agentes está abierta: `2 awaiting input · claude agents` cuando las sesiones necesitan entrada, o `claude agents` cuando no la necesitan.160El título de la pestaña de la terminal muestra el recuento de sesiones en espera de entrada mientras la vista de agentes está abierta: `2 awaiting input · claude agents` cuando hay sesiones que necesitan entrada, o `claude agents` cuando ninguna la necesita.

161 161 

162Para leer el estado de la sesión desde un script u otro programa, use [`claude agents --json`](#read-session-state-from-a-script) en lugar de los archivos bajo `~/.claude/jobs/`.162Para leer el estado de la sesión desde un script u otro programa, usa [`claude agents --json`](#read-session-state-from-a-script) en lugar de los archivos bajo `~/.claude/jobs/`.

163 163 

164Mientras la vista de agentes está abierta, Claude Code también envía una notificación a través de su [canal de notificación de terminal](/docs/es/terminal-config#get-a-terminal-bell-or-notification) configurado cuando una sesión en segundo plano local comienza a necesitar su entrada, se completa o falla. Las sesiones que se ejecutan según un cronograma, como las sesiones [`/loop`](/docs/es/scheduled-tasks), notifican solo cuando necesitan su entrada. Las notificaciones utilizan la misma configuración [`preferredNotifChannel`](/docs/es/settings-reference#preferrednotifchannel) que el resto de Claude Code e invocan el hook [`Notification`](/docs/es/hooks#notification) con el tipo `agent_needs_input` o `agent_completed`.164Mientras la vista de agentes está abierta, Claude Code también envía una notificación a través de tu [canal de notificación de terminal](/docs/es/terminal-config#get-a-terminal-bell-or-notification) configurado cuando una sesión local en segundo plano empieza a necesitar tu entrada, termina o falla. Las sesiones que se ejecutan según un cronograma, como las sesiones de [`/loop`](/docs/es/scheduled-tasks), notifican solo cuando necesitan tu entrada. Las notificaciones usan el mismo [ajuste `preferredNotifChannel`](/docs/es/settings-reference#preferrednotifchannel) que el resto de Claude Code y activan el [hook `Notification`](/docs/es/hooks#notification) con el tipo `agent_needs_input` o `agent_completed`.

165 165 

166Las sesiones en segundo plano no necesitan ninguna terminal abierta para seguir funcionando. Un [proceso supervisor](#the-supervisor-process) separado las ejecuta, por lo que puede cerrar la vista de agentes, cerrar su shell o iniciar una nueva sesión interactiva y su trabajo despachado sigue adelante.166Las sesiones en segundo plano no necesitan ninguna terminal abierta para seguir trabajando. Un [proceso supervisor](#the-supervisor-process) separado las ejecuta, por lo que puedes cerrar la vista de agentes, cerrar tu shell o iniciar una nueva sesión interactiva y el trabajo que despachaste sigue adelante.

167 167 

168El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando su máquina se duerme. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar la brecha de tiempo como inactividad. El apagado aún detiene las sesiones en ejecución; consulte [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown) para saber cómo recuperarlas.168El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando tu máquina entra en suspensión. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar el intervalo de tiempo como inactividad. Apagar la máquina sí detiene las sesiones en ejecución; consulta [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown) para saber cómo recuperarlas.

169 169 

170Una sesión que estaba en medio de una respuesta cuando la máquina se durmió puede volver sin responder. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde la dejó.170Una sesión que estaba a mitad de una respuesta cuando la máquina entró en suspensión puede volver sin responder. Cuando abres una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde la dejó.

171 171 

172<h3 id="row-summaries">172<h3 id="row-summaries">

173 Resúmenes de filas173 Resúmenes de filas

174</h3>174</h3>

175 175 

176El resumen de una línea en cada fila es generado por un [modelo de clase Haiku](/docs/es/model-config) para que la fila pueda decirle qué está haciendo la sesión, qué necesita o qué produjo sin abrir la transcripción. Mientras una sesión está funcionando activamente, el texto de la fila se actualiza como máximo una vez cada 15 segundos desde la salida reciente de la sesión sin enviar una solicitud de modelo, y el modelo escribe un resumen nuevo cuando cada turno termina.176El resumen de una línea en cada fila lo genera un [modelo de clase Haiku](/docs/es/model-config) para que la fila pueda decirte qué está haciendo la sesión, qué necesita o qué produjo sin abrir la transcripción. Mientras una sesión está trabajando activamente, el texto de la fila se actualiza como máximo una vez cada 15 segundos a partir de la salida reciente de la propia sesión sin enviar una solicitud al modelo, y el modelo escribe un resumen nuevo cuando termina cada turno.

177 177 

178Una fila de trabajo muestra lo que la sesión dice que está haciendo, y una fila bloqueada muestra la pregunta que está haciendo. Durante un turno largo, el modelo también reescribe el resumen cada pocos minutos para que una fila ocupada no siga mostrando uno desactualizado. El texto del resumen llena el ancho restante de la fila; abra el [panel de vista previa](#peek-and-reply) para leer una oración que el borde de la terminal recorta.178Una fila en curso muestra lo que la sesión dice que está haciendo, y una fila bloqueada muestra la pregunta que está haciendo. Durante un turno largo, el modelo también reescribe el resumen cada pocos minutos para que una fila ocupada no siga mostrando uno desactualizado. El texto del resumen ocupa el ancho restante de la fila; abre el [panel de vista previa](#peek-and-reply) para leer una oración que el borde de la terminal recorta.

179 179 

180Cuando la lista está [agrupada por directorio](#organize-the-list), el resumen se abre con el estado de la sesión como una palabra coloreada, como `Needs input · double jump or wall climb?`. En la agrupación de estado predeterminada, el encabezado del grupo ya nombra el estado, por lo que la fila muestra solo el resumen.180Cuando la lista está [agrupada por directorio](#organize-the-list), el resumen comienza con el estado de la sesión como una palabra coloreada, como `Needs input · double jump or wall climb?`. En la agrupación predeterminada por estado, el encabezado del grupo ya nombra el estado, por lo que la fila muestra solo el resumen.

181 181 

182El resumen de fin de turno y cada reescritura a mitad de turno son una solicitud corta de clase Haiku a través de su proveedor normal, facturada y manejada bajo los mismos [términos de uso de datos](/docs/es/data-usage) que la sesión misma. Las actualizaciones de 15 segundos entre reescrituras de modelo reutilizan la salida de la sesión y no envían una solicitud. En un proveedor de terceros o puerta de enlace sin un modelo de clase Haiku configurado, la solicitud utiliza el modelo principal de la sesión; establezca [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/es/model-config#environment-variables) para elegir uno.182El resumen de fin de turno y cada reescritura a mitad de turno son una solicitud corta de clase Haiku a través de tu proveedor habitual, facturada y gestionada bajo los mismos [términos de uso de datos](/docs/es/data-usage) que la propia sesión. Las actualizaciones de 15 segundos entre reescrituras del modelo reutilizan la salida de la propia sesión y no envían una solicitud. En un proveedor de terceros o un gateway sin un modelo de clase Haiku configurado, la solicitud usa en su lugar el modelo principal de la sesión; establece [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/es/model-config#environment-variables) para elegir uno.

183 183 

184<h3 id="pull-request-status">184<h3 id="pull-request-status">

185 Estado del pull request185 Estado del pull request


188Cuando una sesión [abre un pull request](#how-file-edits-are-isolated), Claude Code agrega una etiqueta en el borde derecho de la fila, vinculada al pull request:188Cuando una sesión [abre un pull request](#how-file-edits-are-isolated), Claude Code agrega una etiqueta en el borde derecho de la fila, vinculada al pull request:

189 189 

190* Claude Code escribe la etiqueta como `#1234` para un pull request y como `!1234` para un merge request de GitLab.190* Claude Code escribe la etiqueta como `#1234` para un pull request y como `!1234` para un merge request de GitLab.

191* Claude Code emite el enlace incluso cuando no puede detectar soporte de hipervínculo, por ejemplo sobre SSH o tmux. Establezca [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para renderizar la etiqueta como texto sin formato.191* Claude Code emite el enlace incluso cuando no puede detectar soporte de hipervínculos, por ejemplo a través de SSH o tmux. Establece [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para mostrar la etiqueta como texto sin formato.

192* Después de enviar un seguimiento a la sesión, Claude Code mantiene la etiqueta mientras la fila vuelve al progreso en vivo.192* Después de enviar un seguimiento a la sesión, Claude Code mantiene la etiqueta mientras la fila vuelve a mostrar el progreso en vivo.

193 193 

194Una sesión que funciona en un pull request existente está vinculada de la misma manera. Claude Code encuentra el pull request de manera diferente dependiendo del comando que ejecute Claude:194Una sesión que trabaja en un pull request existente se vincula a él de la misma manera. Claude Code encuentra el pull request de forma diferente según el comando que ejecute Claude:

195 195 

196* Cuando Claude edita, comenta, cierra o marca un pull request como listo con `gh`, Claude Code vincula el pull request que la salida del comando nombra. Un comando `gh` cuya salida capturada no nombra ningún pull request no crea un enlace; `gh pr merge` es el caso común, porque imprime su resultado solo en una terminal interactiva.196* Cuando Claude edita, comenta, cierra o marca como listo un pull request con `gh`, Claude Code vincula el pull request que nombra la propia salida del comando. Un comando `gh` cuya salida capturada no nombra ningún pull request no crea un enlace; `gh pr merge` es el caso común, porque imprime su resultado solo en una terminal interactiva.

197* Cuando Claude extrae un pull request con `gh pr checkout` o empuja a una rama, Claude Code busca la rama con `gh pr view` y vincula su pull request abierto.197* Cuando Claude hace checkout de un pull request con `gh pr checkout` o hace push a una rama, Claude Code busca la rama con `gh pr view` y vincula su pull request abierto.

198* El pull request no necesita existir aún cuando Claude empuja: Claude Code reintenta la búsqueda de rama después de hasta cinco comandos posteriores de `git`, `gh`, `glab` o `curl` ejecutados en el mismo directorio, por lo que un pull request creado después del empuje, incluido uno que Claude crea a través de la API REST de GitHub, se vincula cuando un reintento lo encuentra.198* No hace falta que el pull request exista todavía cuando Claude hace push: Claude Code reintenta la búsqueda de la rama después de hasta cinco comandos posteriores de `git`, `gh`, `glab` o `curl` ejecutados en el mismo directorio, por lo que un pull request creado después del push, incluido uno que Claude crea a través de la API REST de GitHub, se vincula cuando un reintento lo encuentra.

199 199 

200Cuando una sesión está vinculada a más de un pull request, la etiqueta muestra un recuento en su lugar, como `3 PRs`, coloreado por el pull request abierto que más necesita atención. Abra el [panel de vista previa](#peek-and-reply) para verlos todos.200Cuando una sesión está vinculada a más de un pull request, la etiqueta muestra en su lugar un recuento, como `3 PRs`, coloreado según el pull request abierto que más necesita atención. Abre el [panel de vista previa](#peek-and-reply) para verlos todos.

201 201 

202El número del pull request está coloreado por su estado:202El número del pull request se colorea según su estado:

203 203 

204| Color | Estado del pull request |204| Color | Estado del pull request |

205| :- | :- |205| :- | :- |

206| Amarillo | Esperando verificaciones o revisión, o las verificaciones fallaron |206| Amarillo | Esperando verificaciones o revisión, o las verificaciones fallaron |

207| Verde | Las verificaciones pasaron y ninguna revisión está bloqueando |207| Verde | Las verificaciones pasaron y ninguna revisión lo bloquea |

208| Púrpura | Fusionado |208| Púrpura | Fusionado |

209| Gris | Borrador o cerrado |209| Gris | Borrador o cerrado |

210 210 

211Para una tarea que termina en un pull request, verifique esta etiqueta para el resultado: revise y fusione el pull request cuando su número se vuelva verde.211Para una tarea que termina en un pull request, consulta esta etiqueta para ver el resultado: revisa y fusiona el pull request cuando su número se vuelva verde.

212 212 

213<h3 id="peek-and-reply">213<h3 id="peek-and-reply">

214 Peek and reply214 Vista previa y respuesta

215</h3>215</h3>

216 216 

217Presione `Space` en una fila seleccionada para abrir el panel de vista previa. Se abre con la oración que la fila trunca en el borde de la terminal, y qué oración es depende del estado de la sesión:217Presiona `Space` en una fila seleccionada para abrir el panel de vista previa. Se abre con la oración que la fila trunca en el borde de la terminal, y cuál es esa oración depende del estado de la sesión:

218 218 

219* Una sesión que está esperando por usted: la pregunta exacta que está haciendo, encima de la entrada de respuesta219* Una sesión que te está esperando: la pregunta exacta que está haciendo, encima de la entrada de respuesta

220* Una sesión finalizada: su resultado220* Una sesión finalizada: su resultado

221* Una sesión de trabajo: su oración de estado completa221* Una sesión en curso: su oración de estado completa

222 222 

223Cualquier pull request vinculado a la sesión se enumera a continuación. Para una sesión que está esperando por usted, una línea como `waiting 3m` debajo de ellos muestra cuánto tiempo ha estado esperando, y es la única vez que se muestra en el panel. La antigüedad en el borde derecho de la fila es un número diferente: cuenta desde cuándo comenzó la sesión.223A continuación se enumeran los pull requests vinculados a la sesión. Para una sesión que te está esperando, una línea como `waiting 3m` debajo de ellos muestra cuánto tiempo lleva esperando, y es el único tiempo que se muestra en el panel. La antigüedad en el borde derecho de la fila es un número diferente: cuenta desde que se inició la sesión.

224 224 

225La mayoría de las veces el panel de vista previa es suficiente y no necesita abrir la transcripción completa.225La mayoría de las veces el panel de vista previa es suficiente y no necesitas abrir la transcripción completa.

226 226 

227Escribe una respuesta en el panel de vista previa y presiona `Enter` para enviarla a esa sesión. Antepón `!` a una respuesta para enviar en su lugar un comando Bash. Lo que pasa con la respuesta depende de la sesión y de lo que envíes:227Escribe una respuesta en el panel de vista previa y presiona `Enter` para enviarla a esa sesión. Antepón `!` a una respuesta para enviar en su lugar un comando Bash. Lo que pasa con la respuesta depende de la sesión y de lo que envíes:

228 228 


236* Una pregunta sin opciones predefinidas: escribe tu respuesta. Cuando la entrada vacía muestra una respuesta sugerida, presiona `Tab` para rellenarla y editarla antes de enviarla236* Una pregunta sin opciones predefinidas: escribe tu respuesta. Cuando la entrada vacía muestra una respuesta sugerida, presiona `Tab` para rellenarla y editarla antes de enviarla

237* Una solicitud de permiso u otro diálogo, como un prompt del [sandbox](/docs/es/sandboxing) o la [solicitud de entrada](/docs/es/mcp#respond-to-mcp-elicitation-requests) de un servidor MCP: responder no lo contesta. Tu respuesta espera en la cola. Para contestar el diálogo, adjúntate con `→`237* Una solicitud de permiso u otro diálogo, como un prompt del [sandbox](/docs/es/sandboxing) o la [solicitud de entrada](/docs/es/mcp#respond-to-mcp-elicitation-requests) de un servidor MCP: responder no lo contesta. Tu respuesta espera en la cola. Para contestar el diálogo, adjúntate con `→`

238 238 

239Cuando un hook [`PermissionRequest`](/docs/es/hooks#permissionrequest) o [`PreToolUse`](/docs/es/hooks#pretooluse) devuelve una salida que Claude Code no puede validar para la llamada que la sesión está pidiendo, la fila muestra el evento del hook y `hook output invalid:` con el error de validación antes del texto de la solicitud pendiente. Para un hook que falla de otra manera, la fila dice que el hook falló. La sesión aún espera la misma solicitud.239Cuando un hook [`PermissionRequest`](/docs/es/hooks#permissionrequest) o [`PreToolUse`](/docs/es/hooks#pretooluse) devuelve una salida que Claude Code no puede validar para la llamada que la sesión está pidiendo, la fila muestra el evento del hook y `hook output invalid:` con el error de validación antes del texto de la solicitud pendiente. Para un hook que falla de otra manera, la fila dice que el hook falló. La sesión sigue esperando la misma solicitud.

240 240 

241Una respuesta que no se puede entregar, porque el servicio en segundo plano es inaccesible o el envío falla, se guarda y se envía a la sesión como su próximo mensaje cuando su proceso se inicia nuevamente, y el mensaje de error dice que la respuesta se guardó. Una respuesta prefijada con `!` no se guarda, porque el texto guardado llegaría a la sesión como un mensaje simple en lugar de ejecutarse como un comando Bash.241Una respuesta que no se puede entregar, porque el servicio en segundo plano es inaccesible o el envío falla, se guarda y se envía a la sesión como su próximo prompt cuando su proceso vuelve a iniciarse, y el mensaje de error dice que la respuesta se guardó. Una respuesta con el prefijo `!` no se guarda, porque el texto guardado llegaría a la sesión como un prompt simple en lugar de ejecutarse como un comando Bash.

242 242 

243Con [dictado de voz](/docs/es/voice-dictation) habilitado, mantenga o toque su tecla de pulsar para hablar mientras la entrada de respuesta está enfocada para dictar una respuesta en lugar de escribirla. Lo mismo funciona en la entrada de envío en la parte inferior de la vista de agentes.243Con el [dictado de voz](/docs/es/voice-dictation) habilitado en [modo de mantener](/docs/es/voice-dictation#hold-to-record), mantén presionada tu tecla de pulsar para hablar mientras la entrada de respuesta tiene el foco para dictar una respuesta en lugar de escribirla. Lo mismo funciona en la entrada de despacho en la parte inferior de la vista de agentes.

244 244 

245Use `↑` y `↓` para ver sesiones adyacentes sin cerrar el panel, o `→` para adjuntarse.245Usa `↑` y `↓` para echar un vistazo a las sesiones adyacentes sin cerrar el panel, o `→` para adjuntarte.

246 246 

247<h3 id="attach-to-a-session">247<h3 id="attach-to-a-session">

248 Adjuntarse a una sesión248 Adjuntarse a una sesión

249</h3>249</h3>

250 250 

251Presione `Enter` o `→` en una fila seleccionada para adjuntarse. La vista de agentes es reemplazada por la sesión interactiva completa. Cuando se adjunta, Claude publica un breve resumen de lo que sucedió mientras estaba fuera.251Presiona `Enter` o `→` en una fila seleccionada para adjuntarte. La vista de agentes se reemplaza por la sesión interactiva completa. Cuando te adjuntas, Claude publica un breve resumen de lo que sucedió mientras no estabas.

252 252 

253Mientras está adjunto, la sesión se comporta como cualquier otra sesión de Claude Code: [comandos](/docs/es/commands), atajos de teclado y características funcionan todos, con las excepciones a continuación.253Mientras estás adjunto, la sesión se comporta como cualquier otra sesión de Claude Code: los [comandos](/docs/es/commands), los atajos de teclado y las funciones funcionan todos, con las excepciones que se indican a continuación.

254 254 

255Mientras está adjunto, `/install-github-app` y la lista de configuración [`/mcp`](/docs/es/mcp) funcionan normalmente, ya que un humano en la terminal puede completar sus diálogos. Cuando nadie está adjunto, estos comandos no pueden abrir sus diálogos, por lo que la sesión aparece bajo `Needs input` en la vista de agentes con una fila como `open this session to manage MCP servers`, y la respuesta de transcripción dice lo mismo. Adjúntese y ejecute el comando nuevamente para continuar; la fila de entrada necesaria se borra cuando se adjunta. `/mcp reconnect <server>`, `/mcp enable` y `/mcp disable` funcionan sin adjuntarse de cualquier manera.255Mientras estás adjunto, `/install-github-app` y la lista de configuración de [`/mcp`](/docs/es/mcp) funcionan con normalidad, ya que una persona en la terminal puede completar sus diálogos. Cuando nadie está adjunto, estos comandos no pueden abrir sus diálogos, por lo que la sesión aparece bajo `Needs input` en la vista de agentes con una fila como `open this session to manage MCP servers`, y la respuesta en la transcripción dice lo mismo. Adjúntate y vuelve a ejecutar el comando para continuar; la fila de entrada necesaria desaparece cuando te adjuntas. `/mcp reconnect <server>`, `/mcp enable` y `/mcp disable` funcionan sin adjuntarte en cualquier caso.

256 256 

257Las sesiones adjuntas siempre se renderizan en [modo de pantalla completa](/docs/es/fullscreen), independientemente de su configuración `tui`, porque una sesión en segundo plano no tiene desplazamiento de terminal para adjuntar. Desplácese con `PgUp`, `PgDn` o la rueda del ratón, y presione `Ctrl+O` para el modo de transcripción. El desplazamiento nativo de su terminal y el modo de copia de tmux muestran solo la ventana gráfica actual, lo mismo que cuando ejecuta cualquier aplicación de pantalla completa.257Las sesiones adjuntas siempre se muestran en [modo de pantalla completa](/docs/es/fullscreen), independientemente de tu ajuste `tui`, porque una sesión en segundo plano no tiene historial de desplazamiento de terminal al que agregar contenido. Desplázate con `PgUp`, `PgDn` o la rueda del ratón, y presiona `Ctrl+O` para el modo de transcripción. El desplazamiento nativo de tu terminal y el modo de copia de tmux muestran solo la ventana visible actual, igual que cuando ejecutas cualquier aplicación de pantalla completa.

258 258 

259Presione `←` en un mensaje vacío, o ejecute `/exit`, para desconectarse y volver a la vista de agentes, ya sea que haya abierto la sesión desde la vista de agentes o con `claude attach <id>` desde su shell.259Presiona `←` en un prompt vacío, o ejecuta `/exit`, para desconectarte y volver a la vista de agentes, ya sea que hayas abierto la sesión desde la vista de agentes o con `claude attach <id>` desde tu shell.

260 260 

261`←` también se desconecta mientras la [superposición `/btw`](/docs/es/interactive-mode#side-questions-with-%2Fbtw) está abierta. Requiere Claude Code v2.1.257 o posterior. Una pregunta secundaria que aún está respondiendo sigue ejecutándose mientras está fuera. La próxima vez que se adjunte, la superposición se reabre con ella, o con su respuesta.261`←` también te desconecta mientras la [superposición de `/btw`](/docs/es/interactive-mode#side-questions-with-%2Fbtw) está abierta. Requiere Claude Code v2.1.257 o posterior. Una pregunta secundaria que aún se está respondiendo sigue ejecutándose mientras no estás. La próxima vez que te adjuntes, la superposición se vuelve a abrir con ella o con su respuesta.

262 262 

263En Windows, si presiona `←` dentro de aproximadamente medio segundo de adjuntarse, Claude Code muestra `Ambiguous ←, press again to detach`, porque en esa ventana la terminal puede reentrega un presión de antes de que se adjuntara. Presione `←` nuevamente para desconectarse.263En Windows, si presionas `←` en aproximadamente medio segundo después de adjuntarte, Claude Code muestra `Ambiguous ←, press again to detach`, porque en ese intervalo la terminal puede volver a entregar una pulsación de antes de que te adjuntaras. Presiona `←` de nuevo para desconectarte.

264 264 

265`Ctrl+Z` también se desconecta pero vuelve a donde comenzó: vista de agentes si se adjuntó desde allí, o su shell si ejecutó `claude attach`. Use `Ctrl+Z` cuando un diálogo tiene el foco y no responde a `←`.265`Ctrl+Z` también te desconecta, pero en su lugar vuelve a donde empezaste: a la vista de agentes si te adjuntaste desde allí, o a tu shell si ejecutaste `claude attach`. Usa `Ctrl+Z` cuando un diálogo tiene el foco y no responde a `←`.

266 266 

267`Ctrl+C` mantiene su comportamiento de interrupción estándar mientras está adjunto: cancela una respuesta en ejecución o un comando shell `!` en lugar de desconectarse. Presionar `Ctrl+C` dos veces en un mensaje vacío se desconecta, lo mismo que en cualquier sesión.267`Ctrl+C` mantiene su comportamiento de interrupción estándar mientras estás adjunto: cancela una respuesta en ejecución o un comando de shell `!` en lugar de desconectarte. Presionar `Ctrl+C` dos veces en un prompt vacío te desconecta, igual que en cualquier sesión.

268 268 

269Desconectarse nunca detiene una sesión en segundo plano: `←`, `Ctrl+Z`, `/exit` y `Ctrl+C` o `Ctrl+D` doble dejan que siga ejecutándose. Para finalizar una sesión desde dentro de ella, ejecute `/stop`.269Desconectarte nunca detiene una sesión en segundo plano: `←`, `Ctrl+Z`, `/exit` y `Ctrl+C` o `Ctrl+D` dobles la dejan en ejecución. Para finalizar una sesión desde dentro de ella, ejecuta `/stop`.

270 270 

271<h4 id="switch-sessions-without-leaving-the-terminal">271<h4 id="switch-sessions-without-leaving-the-terminal">

272 Cambiar sesiones sin dejar la terminal272 Cambiar de sesión sin salir de la terminal

273</h4>273</h4>

274 274 

275En una sesión que se ejecuta en primer plano, una que inició en la terminal en lugar de adjuntarse desde la vista de agentes, presionar `←` en un mensaje vacío la coloca en segundo plano y abre la vista de agentes con esa fila seleccionada, para que pueda cambiar sesiones sin dejar la terminal. El mismo presión única desconecta una sesión adjunta.275En una sesión que se ejecuta en primer plano, una que iniciaste en la terminal en lugar de adjuntarte a ella desde la vista de agentes, presionar `←` en un prompt vacío la pasa a segundo plano y abre la vista de agentes con esa fila seleccionada, para que puedas cambiar de sesión sin salir de la terminal. La misma pulsación única desconecta una sesión adjunta.

276 276 

277Si presiona `←` justo después de eliminar el último del texto del mensaje o moverse a través del historial de mensajes, Claude Code le pide que confirme: el primer presión muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y el segundo presión cambia.277Si presionas `←` justo después de borrar el último texto del prompt o de moverte por el historial de prompts, Claude Code te pide que confirmes: la primera pulsación muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y la segunda pulsación hace el cambio.

278 278 

279Cuando `←` coloca una sesión en primer plano en segundo plano, la vista de agentes muestra `Your conversation moved to the background` encima de la lista, con la fila de esa sesión ya seleccionada. Desde allí:279Cuando `←` pasa a segundo plano una sesión en primer plano, la vista de agentes muestra `Your conversation moved to the background` encima de la lista, con la fila de esa sesión ya seleccionada. Desde allí:

280 280 

281* Presione `Enter` para reabrir la conversación.281* Presiona `Enter` para volver a abrir la conversación.

282* Presione `Esc` para deshacer el cambio y volver a la conversación. Si `Esc` muestra `Still starting — try again in a moment`, la sesión en segundo plano aún no está lista, así que presione `Esc` nuevamente en un momento.282* Presiona `Esc` para deshacer el cambio y volver a la conversación. Si `Esc` muestra `Still starting — try again in a moment`, la sesión en segundo plano aún no está lista, así que vuelve a presionar `Esc` en un momento.

283* Presione `Ctrl+C` dos veces para salir a su shell.283* Presiona `Ctrl+C` dos veces para salir a tu shell.

284 284 

285Cuando Claude Code no puede reabrir la conversación, sale e imprime un comando `claude --resume` que la reanuda.285Cuando Claude Code no puede volver a abrir la conversación, sale e imprime un comando `claude --resume` que la reanuda.

286 286 

287[La lista de tareas de Claude](/docs/es/interactive-mode#task-list) se mueve a la sesión en segundo plano con la conversación, por lo que la lista de verificación está intacta cuando regresa a esa fila.287[La lista de tareas de Claude](/docs/es/interactive-mode#task-list) se traslada a la sesión en segundo plano junto con la conversación, por lo que la lista de verificación está intacta cuando vuelves a esa fila.

288 288 

289La fila en la que presionó `←` también mantiene un nombre en negrita y sin atenuar después de mover la selección con las teclas de flecha o el ratón, para que pueda saber de qué sesión vino.289La fila desde la que presionaste `←` también mantiene un nombre en negrita y sin atenuar después de que muevas la selección con las teclas de flecha o el ratón, para que puedas saber de qué sesión viniste.

290 290 

291Si una herramienta se está ejecutando cuando presiona `←`, Claude Code espera aproximadamente diez segundos para que se complete antes de colocar en segundo plano, y Claude continúa la respuesta en la sesión en segundo plano. Presione `←` nuevamente para colocar en segundo plano inmediatamente en lugar de esperar. Cuando el trabajo en vuelo no puede trasladarse a la sesión en segundo plano, Claude Code muestra el diálogo `Background this session?` primero, lo mismo que con [`/background`](#from-inside-a-session).291Si una herramienta se está ejecutando cuando presionas `←`, Claude Code espera hasta unos diez segundos a que termine antes de pasar a segundo plano, y Claude continúa la respuesta en la sesión en segundo plano. Presiona `←` de nuevo para pasar a segundo plano de inmediato en lugar de esperar. Cuando el trabajo en curso no puede trasladarse a la sesión en segundo plano, Claude Code muestra primero el diálogo `Background this session?`, igual que con [`/background`](#from-inside-a-session).

292 292 

293El límite de diez segundos no se aplica mientras los [subagentes en primer plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background) que Claude inició en la conversación aún se están ejecutando. Claude Code sigue esperando para que su trabajo se traslade, y muestra un aviso `Still backgrounding after the current tool` mientras espera. Presione `←` nuevamente para colocar en segundo plano sin esperar, lo que reinicia esos subagentes desde el principio. Claude Code no espera a los subagentes que un [flujo de trabajo dinámico](/docs/es/workflows) está ejecutando. Cuando un flujo de trabajo tiene subagentes ejecutándose, Claude Code muestra el diálogo `Background this session?` en su lugar.293El límite de diez segundos no se aplica mientras los [subagentes en primer plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background) que Claude inició en la conversación sigan ejecutándose. Claude Code sigue esperando para que su trabajo se traslade, y muestra un aviso `Still backgrounding after the current tool` mientras espera. Presiona `←` de nuevo para pasar a segundo plano sin esperar, lo que reinicia esos subagentes desde el principio. Claude Code no espera a los subagentes que está ejecutando un [flujo de trabajo dinámico](/docs/es/workflows). Cuando un flujo de trabajo tiene subagentes en ejecución, Claude Code muestra en su lugar el diálogo `Background this session?`.

294 294 

295Claude Code no coloca la sesión en segundo plano mientras tiene texto no enviado en la entrada del mensaje, porque el texto permanece en el cuadro de entrada de su terminal y no se movería a la sesión en segundo plano. Si escribe en la entrada mientras Claude Code espera para colocar la sesión en segundo plano, cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`295Claude Code no pasa la sesión a segundo plano mientras tienes texto sin enviar en la entrada del prompt, porque el texto permanece en el cuadro de entrada de tu terminal y no se trasladaría a la sesión en segundo plano. Si escribes en la entrada mientras Claude Code espera para pasar la sesión a segundo plano, cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

296 296 

297Presionar `←` crea la fila de la sesión incluso cuando la conversación no tiene mensajes aún, por lo que `→` aún regresa a ella.297Presionar `←` crea la fila de la sesión incluso cuando la conversación aún no tiene mensajes, por lo que `→` sigue volviendo a ella.

298 298 

299Puede desactivar este atajo con la configuración [`leftArrowOpensAgents`](/docs/es/settings-reference#leftarrowopensagents) en `/config`.299Puedes desactivar este atajo para las sesiones en primer plano con el ajuste [`leftArrowOpensAgents`](/docs/es/settings-reference#leftarrowopensagents) en `/config`.

300 300 

301<h3 id="organize-the-list">301<h3 id="organize-the-list">

302 Organizar la lista302 Organizar la lista

303</h3>303</h3>

304 304 

305La vista de agentes agrupa sesiones para que las que necesitan entrada estén en la parte superior, con `Ready for review` y `Needs input` encima de `Working` y `Completed`. Estos nombres de grupo no se asignan uno a uno a los [estados](#read-session-state) anteriores: una sesión se mueve a `Ready for review` cuando tiene un pull request abierto, y `Completed` recopila sesiones terminadas, fallidas y detenidas juntas.305La vista de agentes agrupa las sesiones para que las que necesitan entrada estén en la parte superior, con `Ready for review` y `Needs input` encima de `Working` y `Completed`. Estos nombres de grupo no se corresponden uno a uno con los [estados](#read-session-state) anteriores: una sesión pasa a `Ready for review` cuando tiene un pull request abierto que necesita revisión o tiene verificaciones fallidas, y `Completed` reúne las sesiones terminadas, fallidas y detenidas.

306 306 

307Presione `Ctrl+S` para agrupar por directorio en su lugar. Su elección persiste en todas las ejecuciones.307Presiona `Ctrl+S` para agrupar por directorio en su lugar. Tu elección persiste entre ejecuciones.

308 308 

309Dentro de un grupo:309Dentro de un grupo:

310 310 

311* Presione `Ctrl+T` para fijar una sesión en la parte superior y [mantener su proceso ejecutándose](#the-supervisor-process) mientras está inactivo311* Presiona `Ctrl+T` para fijar una sesión en la parte superior y [mantener su proceso en ejecución](#the-supervisor-process) mientras está inactiva

312* Presione `Shift+↑` o `Shift+↓` para reordenar sesiones312* Presiona `Shift+↑` o `Shift+↓` para reordenar las sesiones

313* Presione `Ctrl+R` para renombrar una sesión313* Presiona `Ctrl+R` para cambiar el nombre de una sesión

314* Presiona `Enter` en un encabezado de grupo para contraerlo, excepto mientras hay un [filtro](#filter-sessions) activo, cuando todos los grupos permanecen expandidos314* Presiona `Enter` en un encabezado de grupo para contraerlo, excepto mientras hay un [filtro](#filter-sessions) activo, cuando todos los grupos permanecen expandidos

315 315 

316Para eliminar una sesión de la lista, presione `Ctrl+X` para detenerla y `Ctrl+X` nuevamente dentro de dos segundos para eliminarla. Presionar `Ctrl+X` en un encabezado de grupo elimina cada sesión en ese grupo después de la confirmación.316Para quitar una sesión de la lista, presiona `Ctrl+X` para detenerla y `Ctrl+X` de nuevo en menos de dos segundos para eliminarla. Presionar `Ctrl+X` en un encabezado de grupo elimina todas las sesiones de ese grupo después de una confirmación.

317 317 

318El segundo presión elimina la sesión incluso cuando el intento de detención falla, por ejemplo porque el [servicio en segundo plano no responde](#agent-view-says-the-background-service-did-not-respond): la confirmación permanece activa durante otros dos segundos, y la eliminación termina el proceso de la sesión en sí. Presione `Esc` para descartar la confirmación sin eliminar.318La segunda pulsación elimina la sesión incluso cuando el intento de detenerla falla, por ejemplo porque el [servicio en segundo plano no responde](#agent-view-says-the-background-service-did-not-respond): la confirmación permanece activa otros dos segundos, y la eliminación termina por sí misma el proceso de la sesión. Presiona `Esc` para descartar la confirmación sin eliminar.

319 319 

320Excepto en los casos mantenidos cubiertos en [Lo que elimina una sesión elimina](#what-deleting-a-session-removes), eliminar elimina la sesión de la lista, y un worktree que Claude creó para ella se elimina, se mantiene o se deja en su lugar dependiendo de cómo elimine y qué contenga el worktree. La transcripción de conversación siempre permanece en su máquina local, disponible a través de `claude --resume`.320Salvo en los casos de conservación descritos en [Qué elimina borrar una sesión](#what-deleting-a-session-removes), eliminar quita la sesión de la lista, y un worktree que Claude creó para ella se elimina, se conserva o se deja en su lugar según cómo la elimines y lo que contenga el worktree. La transcripción de la conversación siempre permanece en tu máquina local, disponible mediante `claude --resume`.

321 321 

322Para traer una sesión de vuelta en Claude Code v2.1.212 o posterior, escriba `/resume` en la entrada de envío. Se abre un selector con sesiones pasadas del repositorio desde el que abrió la vista de agentes, más recientes primero, incluidas las sesiones que eliminó de la lista; las sesiones que ya tienen una fila no se enumeran. `↑`/`↓` mueven la selección, `Enter` reanuda la sesión seleccionada como una sesión en segundo plano para que se reúna con la lista como una fila, y `Esc` cierra el selector.322Para recuperar una sesión en Claude Code v2.1.212 o posterior, escribe `/resume` en la entrada de despacho. Se abre un selector con las sesiones anteriores del repositorio desde el que abriste la vista de agentes, de la más reciente a la más antigua, incluidas las sesiones que eliminaste de la lista; las sesiones que ya tienen una fila no se enumeran. `↑`/`↓` mueven la selección, `Enter` reanuda la sesión seleccionada como sesión en segundo plano para que vuelva a la lista como una fila, y `Esc` cierra el selector.

323 323 

324El selector se abre solo para un `/resume` simple. Un resumen dirigido, con alcance o restringido no puede ser servido por el selector, por lo que la vista de agentes muestra la sugerencia `attach to a session to run it` en su lugar cuando:324El selector se abre solo con un `/resume` sin argumentos. Una reanudación dirigida, acotada o restringida no puede resolverse con el selector, por lo que la vista de agentes muestra en su lugar la sugerencia `attach to a session to run it` cuando:

325 325 

326* `/resume` nombra un id o un término de búsqueda326* `/resume` nombra un id o un término de búsqueda

327* la vista está limitada con `--cwd`327* la vista está acotada con `--cwd`

328* la vista se inició con [`--safe-mode`](/docs/es/cli-reference#cli-flags)328* la vista se inició con [`--safe-mode`](/docs/es/cli-reference#cli-flags)

329* la vista se abrió con una bandera como `--permission-mode` o `--settings`329* la vista se abrió con un flag como `--permission-mode` o `--settings`

330 330 

331Las sesiones completadas que no caben en la pantalla se pliegan en una fila `… N more`. Los fallos y las sesiones con un pull request abierto siempre permanecen visibles. El grupo `Completed` llena el espacio vertical dejado después de los grupos en vivo, y en una terminal corta el encabezado se compacta en una sola línea de resumen para que las sesiones que están funcionando o necesitan entrada permanezcan visibles.331Las sesiones completadas que no caben en la pantalla se pliegan en una fila `… N more`. El grupo `Completed` ocupa el espacio vertical que queda después de los grupos activos, y en una terminal corta el encabezado se compacta en una sola línea de resumen para que las sesiones que están trabajando o necesitan entrada sigan visibles.

332 332 

333<h3 id="filter-sessions">333<h3 id="filter-sessions">

334 Filtrar sesiones334 Filtrar sesiones


343| `n:<text>` | Sesiones cuyo nombre o primer prompt contiene el texto, como `n:login`. Requiere Claude Code v2.1.287 o posterior |343| `n:<text>` | Sesiones cuyo nombre o primer prompt contiene el texto, como `n:login`. Requiere Claude Code v2.1.287 o posterior |

344| `o:<text>` | Sesiones cuyo resultado contiene el texto, como `o:merged`. Un `o:` sin texto enumera todas las sesiones que han informado un resultado |344| `o:<text>` | Sesiones cuyo resultado contiene el texto, como `o:merged`. Un `o:` sin texto enumera todas las sesiones que han informado un resultado |

345| Un número de pull request o merge request, como `#1234`, o su URL | La sesión que trabaja en ese pull request o merge request |345| Un número de pull request o merge request, como `#1234`, o su URL | La sesión que trabaja en ese pull request o merge request |

346| Cualquier otra URL | La sesión cuyo primer mensaje contenía esa URL |346| Cualquier otra URL | La sesión cuyo primer prompt contenía esa URL |

347 347 

348Para combinar filtros, comienza con `a:`, `s:`, `n:` u `o:` y agrega más, separados por espacios. La lista muestra las sesiones que coinciden con todos ellos. Por ejemplo, `s:blocked a:reviewer` enumera las sesiones `reviewer` que te están esperando.348Para combinar filtros, comienza con `a:`, `s:`, `n:` u `o:` y agrega más, separados por espacios. La lista muestra las sesiones que coinciden con todos ellos. Por ejemplo, `s:blocked a:reviewer` enumera las sesiones `reviewer` que te están esperando.

349 349 


353 Atajos de teclado353 Atajos de teclado

354</h3>354</h3>

355 355 

356Presione `?` en la vista de agentes para ver cada atajo en contexto. La tabla a continuación los resume.356Presiona `?` en la vista de agentes para ver los atajos en contexto. La siguiente tabla los resume.

357 357 

358| Atajo | Acción |358| Atajo | Acción |

359| :- | :- |359| :- | :- |


361| `PgUp` / `PgDn` | Subir o bajar una pantalla de filas |361| `PgUp` / `PgDn` | Subir o bajar una pantalla de filas |

362| `Home` / `End` | Saltar a la primera o a la última fila |362| `Home` / `End` | Saltar a la primera o a la última fila |

363| `Enter` | Adjuntarse a la sesión seleccionada, o enviar el texto de la entrada si no es un [filtro](#filter-sessions) |363| `Enter` | Adjuntarse a la sesión seleccionada, o enviar el texto de la entrada si no es un [filtro](#filter-sessions) |

364| `Space` | Abrir o cerrar el panel de vista previa para la sesión seleccionada |364| `Space` | Abrir o cerrar el panel de vista previa de la sesión seleccionada |

365| `Shift+Enter` | Insertar una nueva línea en la entrada de envío, [como en el mensaje principal](/docs/es/terminal-config#enter-multiline-prompts) |365| `Shift+Enter` | Insertar una nueva línea en la entrada de despacho, [como en el prompt principal](/docs/es/terminal-config#enter-multiline-prompts) |

366| `Ctrl+Enter` | Enviar y adjuntarse inmediatamente, en terminales donde la superposición `?` enumera `ctrl+enter to start and open` |366| `Ctrl+Enter` | Despachar y adjuntarse de inmediato, en terminales donde la superposición de `?` enumera `ctrl+enter to start and open` |

367| `→` | Adjuntarse a la sesión seleccionada |367| `→` | Adjuntarse a la sesión seleccionada |

368| `Alt+1`..`Alt+9` | Adjuntarse a la sesión 1–9 en el directorio de la sesión enfocada |368| `Alt+1`..`Alt+9` | Adjuntarse a la sesión 1–9 del directorio de la sesión con el foco |

369| `Tab` | En una entrada vacía, examinar todos los subagentes. De lo contrario, aplicar la sugerencia resaltada |369| `Tab` | Con la entrada vacía, explorar todos los subagentes. De lo contrario, aplicar la sugerencia resaltada |

370| `Ctrl+S` | Cambiar agrupación entre estado y directorio |370| `Ctrl+S` | Cambiar la agrupación entre estado y directorio |

371| `Ctrl+T` | Fijar o desfijar la sesión seleccionada |371| `Ctrl+T` | Fijar o desfijar la sesión seleccionada |

372| `Ctrl+F` | Buscar sesiones por nombre, con el [filtro `n:`](#filter-sessions) |372| `Ctrl+F` | Buscar sesiones por nombre, con el [filtro `n:`](#filter-sessions) |

373| `Alt+↑` / `Alt+↓` | Saltar al encabezado de grupo anterior o siguiente |373| `Alt+↑` / `Alt+↓` | Saltar al encabezado de grupo anterior o siguiente |

374| `Ctrl+R` | Renombrar la sesión seleccionada |374| `Ctrl+R` | Cambiar el nombre de la sesión seleccionada |

375| `Ctrl+G` | Abrir el mensaje de envío en su `$VISUAL` o `$EDITOR` |375| `Ctrl+G` | Abrir el prompt de despacho en tu `$VISUAL` o `$EDITOR` |

376| `Ctrl+J` | Insertar una nueva línea en la entrada de envío |376| `Ctrl+J` | Insertar una nueva línea en la entrada de despacho |

377| `Ctrl+X` | Detener la sesión; presione nuevamente dentro de dos segundos para eliminarla |377| `Ctrl+X` | Detener la sesión; presiona de nuevo en menos de dos segundos para eliminarla |

378| `Shift+↑` / `Shift+↓` | Reordenar la sesión seleccionada |378| `Shift+↑` / `Shift+↓` | Reordenar la sesión seleccionada |

379| `Esc` | Cerrar el panel de vista previa, borrar la entrada o salir. Cuando abrió la vista de agentes colocando su sesión en segundo plano con `←`, el `Esc` final regresa a esa conversación en lugar de salir. Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada cambia de modo INSERT a modo NORMAL y mantiene su texto, como en el mensaje principal |379| `Esc` | Cerrar el panel de vista previa, borrar la entrada o salir. Cuando abriste la vista de agentes pasando tu sesión a segundo plano con `←`, el `Esc` final vuelve a esa conversación en lugar de salir. Con el [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada cambia del modo INSERT al modo NORMAL y conserva tu texto, como en el prompt principal |

380| `Ctrl+C` | Borrar la entrada; presione dos veces para salir |380| `Ctrl+C` | Borrar la entrada; presiona dos veces para salir |

381| `?` | Mostrar todos los atajos |381| `?` | Mostrar atajos |

382 382 

383Los atajos que tienen una acción en el [contexto `Agents`](/docs/es/keybindings#agents-actions) siguen tu [`keybindings.json`](/docs/es/keybindings). También lo hace `Ctrl+G`, a través del atajo `chat:externalEditor` del contexto `Chat`.383Los atajos que tienen una acción en el [contexto `Agents`](/docs/es/keybindings#agents-actions) siguen tu [`keybindings.json`](/docs/es/keybindings). También lo hace `Ctrl+G`, a través del atajo `chat:externalEditor` del contexto `Chat`.

384 384 


386 Enviar nuevos agentes386 Enviar nuevos agentes

387</h2>387</h2>

388 388 

389Puede enviar nuevas sesiones en segundo plano desde la vista de agentes, enviar o copiar una sesión interactiva existente al fondo, o iniciar una directamente desde el shell.389Puedes enviar nuevas sesiones en segundo plano desde la vista de agentes, enviar o copiar una sesión interactiva existente al segundo plano, o iniciar una directamente desde el shell.

390 390 

391<h3 id="from-agent-view">391<h3 id="from-agent-view">

392 Desde la vista de agentes392 Desde la vista de agentes

393</h3>393</h3>

394 394 

395Escriba un prompt en la entrada en la parte inferior de la vista de agentes y presione `Enter` para iniciar una nueva sesión en segundo plano. La sesión se nombra automáticamente a partir del prompt; cámbiela más tarde con `Ctrl+R`.395Escribe un prompt en la entrada de la parte inferior de la vista de agentes y presiona `Enter` para iniciar una nueva sesión en segundo plano. La sesión se nombra automáticamente a partir del prompt; cámbiale el nombre más tarde con `Ctrl+R`.

396 396 

397El nombre automático es una etiqueta corta escrita por un [modelo de clase Haiku](/docs/es/model-config). Un nombre que la sesión obtiene más tarde también aparece en su fila, incluido el [título generado](/docs/es/sessions#name-your-sessions) que la sesión obtiene cuando [acepta un plan](/docs/es/permission-modes#review-and-approve-a-plan) en esa sesión.397El nombre automático es una etiqueta corta escrita por un [modelo de clase Haiku](/docs/es/model-config). Un nombre que la sesión obtiene más tarde también aparece en su fila, incluido el [título generado](/docs/es/sessions#name-your-sessions) que la sesión obtiene cuando [aceptas un plan](/docs/es/permission-modes#review-and-approve-a-plan) en esa sesión.

398 398 

399Pegue una imagen en el prompt para incluir una captura de pantalla o diagrama con la tarea.399Pega una imagen en el prompt para incluir una captura de pantalla o un diagrama con la tarea.

400 400 

401El texto pegado más largo que 800 caracteres o más de tres líneas se contrae a un marcador de posición `[Pasted text #N]` para que la entrada permanezca en una línea; el texto completo se envía cuando envía. Para revisar o editar el texto contraído antes de enviar, pegue el mismo texto nuevamente y el marcador de posición se expande nuevamente en la entrada.401El texto pegado de más de 800 caracteres o más de tres líneas se contrae en un marcador de posición `[Pasted text #N]` para que la entrada permanezca en una sola línea; el texto completo se envía cuando haces el envío. Para revisar o editar el texto contraído antes de enviarlo, pega el mismo texto de nuevo y el marcador de posición se vuelve a expandir en la entrada.

402 402 

403Prefije o mencione partes del prompt para controlar cómo comienza la sesión:403Usa prefijos o menciones en partes del prompt para controlar cómo comienza la sesión:

404 404 

405| Entrada | Efecto |405| Entrada | Efecto |

406| :- | :- |406| :- | :- |

407| `<agent-name> <prompt>` | Si la primera palabra coincide con un nombre de [subagente](/docs/es/sub-agents) personalizado, ese subagente se ejecuta como el agente principal de la sesión con la configuración de su frontmatter |407| `<agent-name> <prompt>` | Si la primera palabra coincide con el nombre de un [subagente](/docs/es/sub-agents) personalizado, ese subagente se ejecuta como el agente principal de la sesión con la configuración de su frontmatter |

408| `@<agent-name>` | Mencione un subagente personalizado en cualquier lugar del prompt para ejecutarlo como el agente principal |408| `@<agent-name>` | Menciona un subagente personalizado en cualquier lugar del prompt para ejecutarlo como el agente principal |

409| `@<repo>` | Mencione un repositorio para ejecutar la sesión allí. Consulte [Enviar a un directorio específico](#dispatch-to-a-specific-directory) para ver qué repositorios se enumeran |409| `@<repo>` | Menciona un repositorio para ejecutar la sesión allí. Consulta [Enviar a un directorio específico](#dispatch-to-a-specific-directory) para ver qué repositorios se enumeran |

410| `/<command>` | Sugiera [skills](/docs/es/skills) y [comandos](/docs/es/commands) para enviar como el prompt |410| `/<command>` | Sugiere [skills](/docs/es/skills) y [comandos](/docs/es/commands) para enviar como el prompt |

411| `! <command>` | Ejecute un comando de shell como un trabajo en segundo plano en lugar de iniciar una sesión de Claude. El trabajo aparece como una fila que puede adjuntar, ver y desasociar |411| `! <command>` | Ejecuta un comando de shell como un trabajo en segundo plano en lugar de iniciar una sesión de Claude. El trabajo aparece como una fila a la que puedes adjuntarte, que puedes observar y de la que puedes desasociarte |

412| `#<number>` o una URL de solicitud de extracción o fusión | Si una sesión ya está trabajando en esa solicitud de extracción o fusión, Claude Code selecciona su fila en lugar de enviar una nueva sesión |412| `#<number>` o una URL de pull request o merge request | Si una sesión ya está trabajando en ese pull request o merge request, Claude Code selecciona su fila en lugar de enviar una nueva sesión |

413 413 

414Un pequeño conjunto de comandos se ejecutan en la vista de agentes en lugar de enviar:414Un pequeño conjunto de comandos se ejecuta en la propia vista de agentes en lugar de enviarse:

415 415 

416* `/exit` y `/quit` cierran la vista de agentes416* `/exit` y `/quit` cierran la vista de agentes

417* `/logout` lo desconecta417* `/logout` cierra tu sesión

418* `/model` establece el [modelo de envío](#set-the-model)418* `/model` establece el [modelo de envío](#set-the-model)

419* `/login` abre el diálogo de inicio de sesión para que pueda iniciar sesión nuevamente sin adjuntarse a una sesión419* `/login` abre el diálogo de inicio de sesión para que puedas iniciar sesión de nuevo sin adjuntarte a una sesión

420* Un `/resume` desnudo, o su alias `/continue`, abre un selector de sesiones pasadas del repositorio para [traer una de vuelta](#organize-the-list) como una sesión en segundo plano. Requiere Claude Code v2.1.212 o posterior420* Un `/resume` sin argumentos, o su alias `/continue`, abre un selector de sesiones anteriores del repositorio para [recuperar una](#organize-the-list) como sesión en segundo plano. Requiere Claude Code v2.1.212 o posterior

421 421 

422Las skills, sus propios comandos y los comandos integrados que expanden prompts como `/init` se envían a una nueva sesión en segundo plano como su primer prompt. Otros comandos integrados muestran una sugerencia `attach to a session to run it` en su lugar. Todo lo que escribió permanece en la entrada junto a la sugerencia para que pueda editarlo.422Los skills, tus propios comandos y los comandos integrados que expanden prompts, como `/init`, se envían a una nueva sesión en segundo plano como su primer prompt. Otros comandos integrados muestran en su lugar la sugerencia `attach to a session to run it`. Todo lo que escribiste permanece en la entrada junto a la sugerencia para que puedas editarlo.

423 423 

424Empaquetar una tarea recurrente como una [skill](/docs/es/skills) le permite iniciar el mismo flujo de trabajo desde la vista de agentes repetidamente sin reescribir el prompt.424Empaquetar una tarea recurrente como un [skill](/docs/es/skills) te permite iniciar el mismo flujo de trabajo desde la vista de agentes repetidamente sin volver a escribir el prompt.

425 425 

426Cuando el mismo `@name` coincide tanto con un subagente como con un repositorio hermano, el subagente tiene prioridad. La coincidencia de primera palabra desnuda también se aplica, por lo que un prompt que comienza con uno de sus nombres de subagente envía ese subagente en lugar de tratar la palabra como texto sin formato. Use la forma `@` cuando desee ser explícito, o comience el prompt con una palabra diferente para evitar la coincidencia.426Cuando el mismo `@name` coincide tanto con un subagente como con un repositorio hermano, el subagente tiene prioridad. La coincidencia con la primera palabra sin `@` también se aplica, por lo que un prompt que casualmente comienza con uno de los nombres de tus subagentes envía ese subagente en lugar de tratar la palabra como texto sin formato. Usa la forma `@` cuando quieras ser explícito, o comienza el prompt con otra palabra para evitar la coincidencia.

427 427 

428<h4 id="dispatch-to-a-specific-directory">428<h4 id="dispatch-to-a-specific-directory">

429 Enviar a un directorio específico429 Enviar a un directorio específico

430</h4>430</h4>

431 431 

432Una nueva sesión se ejecuta en el directorio desde el que abrió la vista de agentes. Para dirigirse a un directorio diferente, use cualquiera de estos:432Una nueva sesión se ejecuta en el directorio desde el que abriste la vista de agentes. Para apuntar a un directorio diferente, usa cualquiera de estas opciones:

433 433 

434* Abra `claude agents` en ese directorio.434* Abre `claude agents` en ese directorio.

435* Abra `claude agents` en un directorio principal y mencione un repositorio secundario con `@<repo>` en el prompt. Escribir `@` enumera estos objetivos:435* Abre `claude agents` en un directorio principal y menciona un repositorio secundario con `@<repo>` en el prompt. Al escribir `@` se enumeran estos destinos:

436 436 

437 * Repositorios Git un nivel por debajo del directorio de inicio437 * Repositorios Git un nivel por debajo del directorio de inicio

438 * Los [git worktrees](/docs/es/worktrees) registrados del repositorio desde el que inició que viven dentro de su árbol de directorios, como los que Claude crea bajo `.claude/worktrees/`, etiquetados con su rama extraída. Los worktrees agregados fuera del repositorio, como con `git worktree add ../feature`, no se enumeran438 * Los [git worktrees](/docs/es/worktrees) registrados del repositorio desde el que iniciaste que se encuentran dentro de su árbol de directorios, como los que Claude crea en `.claude/worktrees/`, etiquetados con su rama extraída. Los worktrees agregados fuera del repositorio, como con `git worktree add ../feature`, no se enumeran

439 * Cualquier directorio que ya tenga una sesión en la lista439 * Cualquier directorio que ya tenga una sesión en la lista

440 440 

441 Un directorio cuyo nombre contiene un espacio no se enumera.441 Un directorio cuyo nombre contiene un espacio no se enumera.

442* Desde el shell, `cd` al directorio y ejecute `claude --bg "<prompt>"`.442* Desde el shell, haz `cd` al directorio y ejecuta `claude --bg "<prompt>"`.

443 443 

444Cuando la vista de agentes se agrupa por directorio, enviar envía el prompt al directorio de la fila seleccionada, para que pueda seleccionar un grupo y enviar a él sin reescribir la ruta.444Cuando la vista de agentes está agrupada por directorio, el envío manda el prompt al directorio de la fila seleccionada, para que puedas seleccionar un grupo y enviar a él sin volver a escribir la ruta.

445 445 

446<h3 id="from-inside-a-session">446<h3 id="from-inside-a-session">

447 Desde dentro de una sesión447 Desde dentro de una sesión

448</h3>448</h3>

449 449 

450Dos comandos mueven el trabajo de la sesión en la que se encuentra al fondo: `/background` envía la conversación actual allí y libera su terminal, y `/fork` envía una copia mientras continúa trabajando donde está.450Dos comandos mueven el trabajo de la sesión en la que estás al segundo plano: `/background` envía allí la conversación actual y libera tu terminal, y `/fork` envía una copia mientras sigues trabajando donde estás.

451 451 

452<h4 id="send-the-session-to-the-background">452<h4 id="send-the-session-to-the-background">

453 Enviar la sesión al fondo453 Enviar la sesión al segundo plano

454</h4>454</h4>

455 455 

456Ejecute `/background` o su alias `/bg` para mover la conversación actual a una sesión en segundo plano. Pase un prompt como `/bg run the test suite and fix any failures` para dar una instrucción más primero. Si Claude está respondiendo cuando ejecuta `/bg`, la respuesta continúa en la sesión en segundo plano.456Ejecuta `/background` o su alias `/bg` para mover la conversación actual a una sesión en segundo plano. Pasa un prompt como `/bg run the test suite and fix any failures` para dar antes una instrucción más. Si Claude está respondiendo cuando ejecutas `/bg`, la respuesta continúa en la sesión en segundo plano.

457 457 

458Salir de una sesión que aún tiene trabajo en segundo plano en ejecución, como subagentes, comandos de shell en segundo plano, flujos de trabajo o [monitores](/docs/es/tools-reference#monitor-tool), muestra un diálogo `Background work is running` en lugar de salir inmediatamente. Elija `Move to background and exit` para enviar la sesión al fondo de la misma manera que lo hace `/background` y volver a su shell. La opción no se muestra cuando la vista de agentes está [desactivada](#turn-off-agent-view).458Salir de una sesión que aún tiene trabajo en segundo plano en ejecución, como subagentes, comandos de shell en segundo plano, flujos de trabajo o [monitores](/docs/es/tools-reference#monitor-tool), muestra un diálogo `Background work is running` en lugar de salir inmediatamente. Elige `Move to background and exit` para enviar la sesión al segundo plano de la misma manera que lo hace `/background` y volver a tu shell. La opción no se muestra cuando la vista de agentes está [desactivada](#turn-off-agent-view).

459 459 

460Si una sesión en segundo plano en la lista ya tiene el nombre de la conversación, Claude Code numera el nombre de la nueva fila, como `my-session (2)`, y deja el nombre de la fila existente sin cambios. Para cambiar el nombre de la nueva fila, selecciónela en la vista de agentes y presione `Ctrl+R`.460Si una sesión en segundo plano de la lista ya tiene el nombre de la conversación, Claude Code numera el nombre de la nueva fila, como `my-session (2)`, y deja sin cambios el nombre de la fila existente. Para cambiar el nombre de la nueva fila, selecciónala en la vista de agentes y presiona `Ctrl+R`.

461 461 

462<h4 id="copy-the-session-with-/fork">462<h4 id="copy-the-session-with-/fork">

463 Copiar la sesión con /fork463 Copiar la sesión con /fork

464</h4>464</h4>

465 465 

466Ejecute `/fork` para copiar la conversación actual en una nueva sesión en segundo plano mientras el original continúa ejecutándose. La copia comienza con todo en la conversación hasta ese punto; consulte los puntos a continuación para ver dónde se ejecuta la copia. También lleva el modelo, modo de permiso, nivel de esfuerzo y cualquier directorio o concesión de permiso "no preguntar de nuevo" que agregó durante la sesión. La copia aparece como su propia fila en la vista de agentes.466Ejecuta `/fork` para copiar la conversación actual en una nueva sesión en segundo plano mientras la original sigue ejecutándose. La copia comienza con todo lo que hay en la conversación hasta ese punto; consulta los puntos a continuación para ver dónde se ejecuta la copia. También conserva el modelo, el modo de permisos, el nivel de esfuerzo y cualquier directorio o concesión de permisos "no volver a preguntar" que agregaste durante la sesión. La copia aparece como su propia fila en la vista de agentes.

467 467 

468Después de la bifurcación, las dos conversaciones son independientes: nada de lo que hace la copia entra en la conversación original por sí sola, aunque en sesiones donde [mensajería entre sesiones](/docs/es/cross-session-messaging) está habilitada, Claude en cualquiera de las sesiones puede enviar un mensaje explícitamente al otro.468Después del fork, las dos conversaciones son independientes: nada de lo que hace la copia entra por sí solo en la conversación original, aunque en las sesiones donde la [mensajería entre sesiones](/docs/es/cross-session-messaging) está habilitada, el Claude de cualquiera de las dos sesiones puede enviarle un mensaje explícito a la otra.

469 469 

470Copiar la sesión requiere Claude Code v2.1.212 o posterior; en v2.1.161 a v2.1.211, `/fork` inicia un [subagente bifurcado](/docs/es/sub-agents#fork-the-current-conversation) en su lugar, que ahora es `/subtask`. Cuando [la vista de agentes está desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente bifurcado y `/subtask` no está disponible.470Copiar la sesión requiere Claude Code v2.1.212 o posterior; en las versiones v2.1.161 a v2.1.211, `/fork` inicia en su lugar un [subagente bifurcado](/docs/es/sub-agents#fork-the-current-conversation), que ahora es `/subtask`. Cuando [la vista de agentes está desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente bifurcado y `/subtask` no está disponible.

471 471 

472Pase un prompt como `/fork open a draft pull request with the work so far` y la copia comienza a trabajar en él inmediatamente. Sin un prompt, la copia espera su primera instrucción: seleccione su fila en `claude agents` y presione `Space` para enviar una, o ejecute `claude attach <id>`. La fila seleccionada muestra `space to send it a prompt` mientras espera.472Pasa un prompt como `/fork open a draft pull request with the work so far` y la copia comienza a trabajar en él de inmediato. Sin un prompt, la copia espera su primera instrucción: selecciona su fila en `claude agents` y presiona `Space` para enviarle una, o ejecuta `claude attach <id>`. La fila seleccionada muestra `space to send it a prompt` mientras espera.

473 473 

474La confirmación de `/fork` es una línea que muestra el estado de la copia, como `session running`, el nombre de su fila de vista de agentes y su ID de sesión para `claude attach`. Haga clic en el nombre para cambiar a la copia: esta sesión se mueve al fondo, igual que presionar `←`, y la vista de agentes abre la sesión de la copia.474La confirmación de `/fork` es una línea que muestra el estado de la copia, como `session running`, el nombre de su fila en la vista de agentes y su ID de sesión para `claude attach`. Haz clic en el nombre para cambiar a la copia: esta sesión pasa al segundo plano, igual que al presionar `←`, y la vista de agentes abre la sesión de la copia.

475 475 

476Excepto cuando la copia [edita en su lugar](#how-file-edits-are-isolated), Claude Code le indica que cree su propio worktree antes de hacer cambios de código. Fuera de un repositorio git, solo una copia movida fuera de un worktree creado por hook obtiene la instrucción; sin un hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate), la copia edita en su lugar. Una copia movida fuera de su worktree también se le indica que nunca edite, ejecute comandos en, o entre en ese worktree, sea cual sea la configuración de aislamiento.476Excepto cuando la copia [edita en el mismo lugar](#how-file-edits-are-isolated), Claude Code le indica que cree un worktree propio antes de hacer cambios en el código. Fuera de un repositorio git, solo una copia que sale de un worktree creado por un hook recibe la instrucción; sin un [hook `WorktreeCreate`](/docs/es/hooks#worktreecreate), la copia edita en el mismo lugar. A una copia que sale de tu worktree también se le indica que nunca edite, ejecute comandos ni entre en ese worktree, sea cual sea el ajuste de aislamiento.

477 477 

478Dónde comienza la copia depende de dónde se ejecuta la sesión actual:478Dónde comienza la copia depende de dónde se esté ejecutando la sesión actual:

479 479 

480* Como cualquier sesión enviada, la copia [se mueve a su propio worktree antes de editar archivos](#how-file-edits-are-isolated). En ese caso, la confirmación no menciona dónde se ejecuta la copia.480* Como cualquier sesión enviada, la copia [se mueve a su propio worktree antes de editar archivos](#how-file-edits-are-isolated). En ese caso, la confirmación no menciona dónde se ejecuta la copia.

481* Cuando su sesión se movió a su [worktree](/docs/es/worktrees) vinculado después de que comenzó, la copia comienza de nuevo donde estaba la sesión antes del movimiento y, a menos que [edite en su lugar](#how-file-edits-are-isolated), realiza sus cambios de código en un worktree propio allí. Cuando su worktree se extrae en una rama, esa instrucción también le dice a una copia cuya tarea se basa en su trabajo que base su nueva rama en la suya, ya que su rama permanece extraída en su worktree. La confirmación termina con `runs in the origin tree`.481* Cuando tu sesión se movió a su [worktree](/docs/es/worktrees) vinculado después de iniciarse, la copia comienza de nuevo donde estaba la sesión antes del movimiento y, a menos que [edite en el mismo lugar](#how-file-edits-are-isolated), hace sus cambios de código en un worktree propio allí. Cuando tu worktree tiene extraída una rama, esa instrucción también le indica a una copia cuya tarea se basa en tu trabajo que base su nueva rama en la tuya, ya que tu rama permanece extraída en tu worktree. La confirmación termina con `runs in the origin tree`.

482* Cuando inició la sesión dentro de un worktree vinculado de un repositorio que tiene un árbol de trabajo principal, la copia comienza en ese árbol de trabajo principal, con la misma regla de worktree propio pero sin instrucción de rama. La confirmación termina con `runs in the origin tree` aquí también.482* Cuando iniciaste la sesión dentro de un worktree vinculado de un repositorio que tiene un árbol de trabajo principal, la copia comienza en ese árbol de trabajo principal, con la misma regla de worktree propio pero sin instrucción sobre la rama. Aquí la confirmación también termina con `runs in the origin tree`.

483* Una sesión iniciada dentro de un worktree de un diseño de repositorio desnudo no tiene un árbol de trabajo principal al que volver, por lo que la copia permanece donde está, y la confirmación termina con `edits this checkout`. La misma nota aparece cuando el aislamiento de worktree está [desactivado](#how-file-edits-are-isolated) en una sesión que no está dentro de un worktree vinculado, porque la copia luego edita los archivos que tiene abiertos.483* Una sesión iniciada dentro de un worktree de una estructura de repositorio bare no tiene un árbol de trabajo principal al que volver, por lo que la copia permanece donde está y la confirmación termina con `edits this checkout`. La misma nota aparece cuando el aislamiento con worktrees está [desactivado](#how-file-edits-are-isolated) en una sesión que no está dentro de un worktree vinculado, porque entonces la copia edita los archivos que tienes abiertos.

484 484 

485Las sesiones iniciadas con indicadores de inicio que la copia no heredaría, como un prompt del sistema reemplazado o una lista de permitidos `--tools`, no se pueden bifurcar; Claude Code lo dice en lugar de hacer una copia parcial. Una sesión enviada desde la vista de agentes se bifurca normalmente: la copia se inicia con la misma [definición de agente](/docs/es/sub-agents) e instrucciones anexadas que la sesión de la que proviene.485Las sesiones iniciadas con flags de inicio que la copia no heredaría, como un prompt del sistema reemplazado o una lista de permitidos `--tools`, no se pueden bifurcar; Claude Code lo indica en lugar de hacer una copia parcial. Una sesión enviada desde la vista de agentes se bifurca normalmente: la copia se inicia con la misma [definición de agente](/docs/es/sub-agents) e instrucciones añadidas que la sesión de la que proviene.

486 486 

487<h4 id="what-carries-over-when-you-background">487<h4 id="what-carries-over-when-you-background">

488 Qué se lleva cuando envía al fondo488 Qué se conserva al enviar al segundo plano

489</h4>489</h4>

490 490 

491Enviar al fondo inicia un proceso nuevo que se reanuda desde la conversación guardada, y el trabajo en vuelo se mueve a él: comandos de shell en segundo plano en ejecución, subagentes en segundo plano, flujos de trabajo dinámicos, tareas programadas que creó con [`/loop`](/docs/es/scheduled-tasks), y [respuestas automáticas de Claude a comentarios de artefactos](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own) todos se llevan y continúan ejecutándose allí. Un subagente se mueve junto con todo lo que inició, por lo que se lleva solo cuando todo ese trabajo también puede moverse. Para detener el trabajo en vuelo en lugar de llevarlo, establezca la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code luego le pide que confirme antes de enviar al fondo.491Enviar al segundo plano inicia un proceso nuevo que se reanuda desde la conversación guardada, y el trabajo en curso pasa a él: los comandos de shell en segundo plano en ejecución, los subagentes en segundo plano, los flujos de trabajo dinámicos, las tareas programadas que creaste con [`/loop`](/docs/es/scheduled-tasks) y las [respuestas automáticas de Claude a comentarios de artefactos](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own) se conservan y siguen ejecutándose allí. Un subagente se mueve junto con todo lo que inició, por lo que solo se conserva cuando todo ese trabajo también puede moverse. Para detener el trabajo en curso en lugar de conservarlo, establece la variable de entorno [`CLAUDE_DISABLE_ADOPT=1`](/docs/es/env-vars#variables); Claude Code entonces te pide que confirmes antes de enviar al segundo plano.

492 492 

493Cuando un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al fondo con el diálogo `Background this session?`, que dice cuántos subagentes se reiniciarían. Elija `Stay` para dejarlos terminar primero. Si confirma, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se ejecutaban comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ahora se gastan nuevamente. Consulte [Reanudar después de una pausa](/docs/es/workflows#resume-after-a-pause) para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan nuevamente.493Cuando un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución, Claude Code pregunta antes de enviar al segundo plano con el diálogo `Background this session?`, que indica cuántos subagentes se reiniciarían. Elige `Stay` para dejar que terminen primero. Si confirmas, Claude Code reproduce la ejecución en la sesión en segundo plano: los subagentes que aún se estaban ejecutando comienzan de nuevo desde el principio, por lo que los tokens que usaron hasta ese momento se gastan otra vez. Consulta [Reanudar después de una pausa](/docs/es/workflows#resume-after-a-pause) para ver qué subagentes completados devuelven sus resultados guardados y cuáles se ejecutan de nuevo.

494 494 

495Claude Code detiene el trabajo que no puede llevarse, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y detiene un subagente en segundo plano que posee un monitor junto con él. Cuando cualquier trabajo de este tipo se está ejecutando, Claude Code muestra el diálogo `Background this session?` para que pueda confirmar antes de que detenga el trabajo.495Claude Code detiene el trabajo que no se puede conservar, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución, y detiene también un subagente en segundo plano que posee un monitor. Cuando hay trabajo de este tipo en ejecución, Claude Code muestra el diálogo `Background this session?` para que puedas confirmar antes de que detenga el trabajo.

496 496 

497Una vez en el fondo, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desasociaciones y readjuntos posteriores.497Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y estos siguen ejecutándose tras desasociaciones y nuevas conexiones posteriores.

498 498 

499Las banderas de configuración del inicio original se llevan a través de la sesión en segundo plano, por lo que sus servidores MCP, configuración y modelo de respaldo permanecen en vigor:499Los flags de configuración del inicio original se conservan en la sesión en segundo plano, por lo que sus servidores MCP, su configuración y su modelo de respaldo siguen en vigor:

500 500 

501* `--mcp-config` y `--strict-mcp-config`501* `--mcp-config` y `--strict-mcp-config`

502* `--settings`502* `--settings`


506* `--fallback-model`506* `--fallback-model`

507* `--allow-dangerously-skip-permissions`507* `--allow-dangerously-skip-permissions`

508 508 

509Los directorios que agregó durante la sesión con [`/add-dir`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) también se llevan. Llevar `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` alcanzable en la sesión en segundo plano, pero no otorga nada nuevo: el modo aún requiere la aceptación interactiva única descrita en [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort).509Los directorios que agregaste durante la sesión con [`/add-dir`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) también se conservan. Conservar `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` disponible en la sesión en segundo plano, pero no otorga nada nuevo: el modo sigue requiriendo la aceptación interactiva única descrita en [Modo de permisos, modelo y esfuerzo](#permission-mode-model-and-effort).

510 510 

511<h3 id="from-your-shell">511<h3 id="from-your-shell">

512 Desde su shell512 Desde tu shell

513</h3>513</h3>

514 514 

515Pase `--bg` o su forma larga `--background` para iniciar una sesión que vaya directamente al fondo:515Pasa `--bg` o su forma larga `--background` para iniciar una sesión que va directamente al segundo plano:

516 516 

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

518claude --bg "investigate the flaky SettingsChangeDetector test"518claude --bg "investigate the flaky SettingsChangeDetector test"

519```519```

520 520 

521El prompt es el argumento posicional, no un valor `-p`. Claude Code rechaza `--bg` combinado con `-p` o `--print` antes de que se cree cualquier sesión, porque `--print` nunca inicia la sesión interactiva a la que se adjunta `claude agents`.521El prompt es el argumento posicional, no un valor de `-p`. Claude Code rechaza `--bg` combinado con `-p` o `--print` antes de crear ninguna sesión, porque `--print` nunca inicia la sesión interactiva a la que se adjunta `claude agents`.

522 522 

523Si ejecuta `claude --bg` desde una terminal en un directorio que no ha [confiado](/docs/es/permissions#project-allow-rules-and-workspace-trust), el diálogo de confianza del espacio de trabajo aparece primero y la sesión comienza una vez que acepta. Si rechaza, Claude Code sale sin iniciar una sesión. Donde no puede aparecer ningún diálogo, como en un script, el comando sale con un error [`Workspace not trusted`](/docs/es/errors#workspace-not-trusted-when-dispatching-a-background-session) en su lugar.523Si ejecutas `claude --bg` desde una terminal en un directorio en el que no has [confiado](/docs/es/permissions#project-allow-rules-and-workspace-trust), primero aparece el diálogo de confianza del espacio de trabajo y la sesión comienza una vez que aceptas. Si rechazas, Claude Code sale sin iniciar una sesión. Donde no puede aparecer ningún diálogo, como en un script, el comando sale en su lugar con un error [`Workspace not trusted`](/docs/es/errors#workspace-not-trusted-when-dispatching-a-background-session).

524 524 

525Para ejecutar un [subagente](/docs/es/sub-agents) específico que haya definido, como un `code-reviewer`, como el agente principal de la sesión, combine `--bg` con `--agent`:525Para ejecutar un [subagente](/docs/es/sub-agents) específico que hayas definido, como un `code-reviewer`, como el agente principal de la sesión, combina `--bg` con `--agent`:

526 526 

527```bash theme={null}527```bash theme={null}

528claude --agent code-reviewer --bg "address review comments on PR 1234"528claude --agent code-reviewer --bg "address review comments on PR 1234"

529```529```

530 530 

531Si el nombre no coincide con ninguno de sus subagentes, el inicio falla: Claude Code imprime una advertencia `no agent named` y aún informa la sesión como enviada al fondo, pero la sesión sale inmediatamente con un error `--agent '<name>' not found`.531Si el nombre no coincide con ninguno de tus subagentes, el inicio falla: Claude Code imprime una advertencia `no agent named` y aun así informa que la sesión se envió al segundo plano, pero la sesión sale inmediatamente con un error `--agent '<name>' not found`.

532 532 

533Cuando la sesión en segundo plano se reanuda o reinicia más tarde, Claude Code restaura el agente y sus restricciones de herramientas; para su prompt del sistema, consulte [Indicadores de prompt del sistema en conversaciones reanudadas](/docs/es/cli-reference#system-prompt-flags-in-resumed-conversations). Busca el agente en el directorio de la sesión primero, siempre que haya [confiado en ese espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust), por lo que un agente con alcance de proyecto aún se carga cuando la sesión se reanuda desde otro directorio. Si el agente ya no existe, la sesión continúa con las herramientas predeterminadas y su transcripción se abre con una [advertencia que nombra el agente](/docs/es/errors#session-agent-no-longer-available).533Cuando la sesión en segundo plano se reanuda o se reinicia más tarde, Claude Code restaura el agente y sus restricciones de herramientas; para su prompt del sistema, consulta [Flags de prompt del sistema en conversaciones reanudadas](/docs/es/cli-reference#system-prompt-flags-in-resumed-conversations). Primero busca el agente en el propio directorio de la sesión, siempre que hayas [confiado en ese espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust), por lo que un agente con alcance de proyecto se sigue cargando cuando la sesión se reanuda desde otro directorio. Si el agente ya no existe, la sesión continúa con las herramientas predeterminadas y su transcripción se abre con una [advertencia que nombra al agente](/docs/es/errors#session-agent-no-longer-available).

534 534 

535Para continuar una conversación existente en el fondo, pase su ID de sesión completo con `--resume`:535Para continuar una conversación existente en segundo plano, pasa su ID de sesión completo con `--resume`:

536 536 

537```bash theme={null}537```bash theme={null}

538claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"538claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

539```539```

540 540 

541En Claude Code v2.1.257 o posterior, Claude Code continúa esa sesión bajo el mismo ID, o inicia una copia bajo un ID nuevo e imprime una línea `note:` explicando por qué no pudo continuar en su lugar. Cuando la sesión continúa en su lugar, `claude agents` muestra una fila para ella.541En Claude Code v2.1.257 o posterior, Claude Code continúa esa sesión con el mismo ID, o inicia una copia con un ID nuevo e imprime una línea `note:` que explica por qué no pudo continuar en el mismo lugar. Cuando la sesión continúa en el mismo lugar, `claude agents` muestra una sola fila para ella.

542 542 

543Cuando combina `--bg` con `--continue`, un `--resume` desnudo, o `--resume` con un nombre o ruta de archivo, Claude Code siempre inicia una copia de este tipo. Agregue `--fork-session` para iniciar una copia a propósito, sin la nota.543Cuando combinas `--bg` con `--continue`, con un `--resume` sin argumentos o con `--resume` seguido de un nombre o una ruta de archivo, Claude Code siempre inicia una copia de este tipo. Agrega `--fork-session` para iniciar una copia a propósito, sin la nota.

544 544 

545Pase `--name` para establecer el nombre de visualización de la sesión en la vista de agentes en lugar del generado automáticamente:545Pasa `--name` para establecer el nombre visible de la sesión en la vista de agentes en lugar del generado automáticamente:

546 546 

547```bash theme={null}547```bash theme={null}

548claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"548claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

549```549```

550 550 

551Después de enviar al fondo, Claude imprime el ID corto de la sesión y los comandos para administrarla. Cuando el servicio que aloja sesiones en segundo plano aún no se está ejecutando, `--bg` puede imprimir primero `Starting background service…` encima de esta salida. Cuando pasa `--name`, el nombre aparece después del ID corto:551Después de enviar al segundo plano, Claude imprime el ID corto de la sesión y los comandos para administrarla. Cuando el servicio que aloja las sesiones en segundo plano aún no se está ejecutando, `--bg` puede imprimir primero `Starting background service…` encima de esta salida. Cuando pasas `--name`, el nombre aparece después del ID corto:

552 552 

553```text theme={null}553```text theme={null}

554backgrounded · 7c5dcf5d · flaky-test-fix554backgrounded · 7c5dcf5d · flaky-test-fix


562 Ejecutar un comando de shell562 Ejecutar un comando de shell

563</h4>563</h4>

564 564 

565Para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, pase `--exec`. El siguiente ejemplo ejecuta `pytest -x` como un trabajo en segundo plano:565Para ejecutar un comando de shell como un trabajo en segundo plano en lugar de una sesión de Claude, pasa `--exec`. El siguiente ejemplo ejecuta `pytest -x` como un trabajo en segundo plano:

566 566 

567```bash theme={null}567```bash theme={null}

568claude --bg --exec 'pytest -x'568claude --bg --exec 'pytest -x'

569```569```

570 570 

571Desde la vista de agentes, envíe el mismo tipo de trabajo escribiendo `!` como el primer carácter de la entrada de envío: el `!` se muestra como un prefijo, todo después de él es el comando, y `Enter` inicia el trabajo.571Desde la vista de agentes, envía el mismo tipo de trabajo escribiendo `!` como primer carácter de la entrada de envío: el `!` se muestra como prefijo, todo lo que viene después es el comando, y `Enter` inicia el trabajo.

572 572 

573El comando se ejecuta como un trabajo respaldado por PTY y aparece como una fila en la vista de agentes, con la línea de salida más reciente como su estado. Un trabajo de shell ejecuta el comando en lugar de Claude, por lo que no se invoca ningún modelo y la salida no se envía a ninguna sesión.573El comando se ejecuta como un trabajo respaldado por un PTY y aparece como una fila en la vista de agentes, con la línea de salida más reciente como su estado. Un trabajo de shell ejecuta el comando en lugar de Claude, por lo que no se invoca ningún modelo y la salida no se envía a ninguna sesión.

574 574 

575Para ver la salida, adjúntese a la fila, presione `Space` para ver sin adjuntarse, o ejecute `claude logs <id>` desde su shell. La salida capturada permanece en la memoria y no se escribe en el disco. La fila y su salida se limpian automáticamente aproximadamente cinco minutos después de que el comando sale, así que léalo antes de entonces si necesita el resultado.575Para ver la salida, adjúntate a la fila, presiona `Space` para echar un vistazo sin adjuntarte, o ejecuta `claude logs <id>` desde tu shell. La salida capturada permanece en memoria y no se escribe en el disco. La fila y su salida se limpian automáticamente unos cinco minutos después de que el comando termina, así que léela antes si necesitas el resultado.

576 576 

577<h3 id="how-file-edits-are-isolated">577<h3 id="how-file-edits-are-isolated">

578 Cómo se aíslan las ediciones de archivos578 Cómo se aíslan las ediciones de archivos


583Claude omite el worktree cuando:583Claude omite el worktree cuando:

584 584 

585* [Moviste al segundo plano una sesión que ya tenías abierta](#from-inside-a-session) con `←` o `/background`. Esa sesión sigue editando archivos donde ya estaba trabajando585* [Moviste al segundo plano una sesión que ya tenías abierta](#from-inside-a-session) con `←` o `/background`. Esa sesión sigue editando archivos donde ya estaba trabajando

586* La sesión ya está dentro de un git worktree vinculado, ya sea que Claude lo creara bajo `.claude/worktrees/` o lo creara con `git worktree add` en otro lugar586* La sesión ya está dentro de un git worktree vinculado, ya sea que Claude lo haya creado en `.claude/worktrees/` o que tú lo hayas creado con `git worktree add` en otro lugar

587* El archivo que Claude está editando está dentro de un git worktree vinculado, como uno que la sesión o su subagente creó con `git worktree add`587* El archivo que Claude está editando está dentro de un git worktree vinculado, como uno que la sesión o su subagente creó con `git worktree add`

588* El directorio de trabajo no es un repositorio git y no hay ningún hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate) configurado588* El directorio de trabajo no es un repositorio git y no hay ningún [hook `WorktreeCreate`](/docs/es/hooks#worktreecreate) configurado

589* La escritura está fuera del directorio de trabajo589* La escritura está fuera del directorio de trabajo

590 590 

591Para desactivar el aislamiento de worktree para un repositorio donde los git worktrees no son prácticos, establezca [`worktree.bgIsolation`](/docs/es/settings-reference#worktree-bgisolation) en `"none"`. Las sesiones en segundo plano luego editan su copia de trabajo directamente sin moverse a un worktree primero. Agregue la configuración al `.claude/settings.json` del proyecto:591Para desactivar el aislamiento con worktrees en un repositorio donde los git worktrees no son prácticos, establece [`worktree.bgIsolation`](/docs/es/settings-reference#worktree-bgisolation) en `"none"`. Las sesiones en segundo plano editan entonces tu copia de trabajo directamente sin moverse antes a un worktree. Agrega el ajuste al `.claude/settings.json` del proyecto:

592 592 

593```json theme={null}593```json theme={null}

594{594{


598}598}

599```599```

600 600 

601Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no se aíslan entre sí, por lo que evite enviar sesiones paralelas que editen los mismos archivos. Si usa un sistema de control de versiones diferente, configure un hook [`WorktreeCreate`](/docs/es/worktrees#non-git-version-control) y Claude aísla las ediciones de la misma manera que lo hace para git.601Fuera de un repositorio git, las sesiones escriben directamente en el directorio de trabajo y no están aisladas entre sí, así que evita enviar sesiones paralelas que editen los mismos archivos. Si usas un sistema de control de versiones diferente, configura un [hook `WorktreeCreate`](/docs/es/worktrees#non-git-version-control) y Claude aísla las ediciones de la misma manera que lo hace con git.

602 602 

603Cuando el hook falla en un directorio que no es un repositorio git, Claude omite el aislamiento para ese directorio y edita el directorio de trabajo en el mismo lugar. Dentro de un repositorio git, una sesión que Claude mueve a un worktree antes de editar no puede editar archivos en el checkout compartido hasta que se produce ese movimiento.603Cuando el hook falla en un directorio que no es un repositorio git, Claude omite el aislamiento para ese directorio y edita el directorio de trabajo en el mismo lugar. Dentro de un repositorio git, una sesión que Claude mueve a un worktree antes de editar no puede editar archivos en el checkout compartido hasta que se produce ese movimiento.

604 604 

605Para encontrar la ruta del worktree de una sesión, vea la sesión o adjúntese y verifique su directorio de trabajo.605Para encontrar la ruta del worktree de una sesión, adjúntate y revisa su directorio de trabajo.

606 606 

607Un [subagente](/docs/es/sub-agents) que genera la sesión en segundo plano hereda el directorio de trabajo de la sesión. Una vez que la sesión está en un worktree, las ediciones de archivos del subagente quedan en ese worktree y no en tu copia de trabajo. Para darle en cambio a un subagente su propio worktree separado, establece [`isolation: worktree`](/docs/es/sub-agents#supported-frontmatter-fields) en su frontmatter o pasa `isolation: "worktree"` al generarlo.607Un [subagente](/docs/es/sub-agents) que genera la sesión en segundo plano hereda el directorio de trabajo de la sesión. Una vez que la sesión está en un worktree, las ediciones de archivos del subagente quedan en ese worktree y no en tu copia de trabajo. Para darle en cambio a un subagente su propio worktree separado, establece [`isolation: worktree`](/docs/es/sub-agents#supported-frontmatter-fields) en su frontmatter o pasa `isolation: "worktree"` al generarlo.

608 608 

609Cuando una sesión en segundo plano ha realizado cambios de código en un worktree que Claude ingresó, Claude Code le indica a Claude que preserve el trabajo antes de terminar, para que sobreviva si elimina la sesión y su worktree:609Cuando una sesión en segundo plano ha hecho cambios de código en un worktree en el que entró Claude, Claude Code le indica a Claude que preserve el trabajo antes de terminar, para que se conserve si eliminas la sesión y su worktree:

610 610 

611* **Confirmar e impulsar**: Claude confirma sin preguntar, e impulsa la rama cuando el repositorio tiene un remoto.611* **Hacer commit y push**: Claude hace commit sin preguntar y hace push de la rama cuando el repositorio tiene un remoto.

612* **Solicitud de extracción de borrador**: Claude abre una cuando la tarea lo requiere, y la etiqueta [`#N`](#pull-request-status) aparece en la fila.612* **Pull request en borrador**: Claude abre uno cuando la tarea lo requiere, y la [etiqueta `#N`](#pull-request-status) aparece en la fila.

613* **Nunca**: impulsar a `main` o `master`, impulsar forzadamente y fusionar.613* **Nunca**: hacer push a `main` o `master`, hacer force push ni fusionar.

614* **Sus instrucciones de git tienen prioridad**: si la tarea, `CLAUDE.md`, o [memoria](/docs/es/memory) dice que maneja la confirmación o el impulso usted mismo, Claude le deja git a usted.614* **Tus instrucciones de git tienen prioridad**: si la tarea, `CLAUDE.md` o la [memoria](/docs/es/memory) indican que tú te encargas de hacer commit o push, Claude te deja git a ti.

615 615 

616Una sesión que edita un checkout que no se aisló a sí misma aún pregunta antes de confirmar o cambiar de rama. Esto se aplica cuando el aislamiento se establece en `"none"`, cuando el movimiento de worktree falló, o cuando la sesión comenzó dentro de un worktree que ya existía.616Una sesión que edita un checkout que no aisló ella misma sigue preguntando antes de hacer commit o cambiar de rama. Esto se aplica cuando el aislamiento está establecido en `"none"`, cuando falló el movimiento al worktree o cuando la sesión comenzó dentro de un worktree que ya existía.

617 617 

618Sea cual sea la tarea, Claude termina el trabajo con un informe que dice qué hizo y dónde está el trabajo: una ruta, una rama, una solicitud de extracción, o la respuesta en sí.618Sea cual sea la tarea, Claude termina el trabajo con un informe que dice qué hizo y dónde está el trabajo: una ruta, una rama, un pull request o la propia respuesta.

619 619 

620<h4 id="what-deleting-a-session-removes">620<h4 id="what-deleting-a-session-removes">

621 Qué elimina una sesión621 Qué elimina borrar una sesión

622</h4>622</h4>

623 623 

624Elimine una sesión con `Ctrl+X` dos veces en [vista de agentes](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Excepto en los casos mantenidos a continuación, la sesión sale de la lista. Su transcripción permanece en su máquina a través de `claude --resume`, y la eliminación sobrevive a los reinicios del supervisor.624Elimina una sesión con `Ctrl+X` dos veces en la [vista de agentes](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Excepto en los casos conservados que se indican a continuación, la sesión sale de la lista. Su transcripción permanece en tu máquina a través de `claude --resume`, y la eliminación se mantiene tras los reinicios del supervisor.

625 625 

626Qué sucede con un worktree que Claude creó para la sesión:626Qué sucede con un worktree que Claude creó para la sesión:

627 627 

628* La vista de agentes lo elimina, incluidos los cambios sin confirmar, así que confirme lo que desea mantener primero.628* La vista de agentes lo elimina, incluidos los cambios sin commit, así que primero haz commit de lo que quieras conservar.

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

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

631* Cuando elimina una sesión cuyo worktree tiene confirmaciones que Claude Code no puede confirmar que se guardan en otro lugar, Claude Code mantiene el worktree y la sesión, y el mensaje nombra la rama del worktree y cuántas confirmaciones no se impulsan. El mensaje también ofrece las dos formas de avanzar: impulsar las confirmaciones, o eliminar nuevamente para descartarlas.631* Cuando eliminas una sesión cuyo worktree tiene commits que Claude Code no puede confirmar que estén guardados en otro lugar, Claude Code conserva el worktree y la sesión, y el mensaje indica la rama del worktree y cuántos commits no tienen push. El mensaje también ofrece las dos formas de continuar: hacer push de los commits, o volver a eliminar para descartarlos.

632 632 

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

634 634 

635 Después de esa negativa, elige:635 Después de ese rechazo, tú eliges:

636 636 

637 * Para mantener las confirmaciones, impúlselas, o fusionelas en esa rama predeterminada, luego elimine la sesión nuevamente.637 * Para conservar los commits, haz push de ellos o fusiónalos en esa rama predeterminada, y luego vuelve a eliminar la sesión.

638 * Para descartarlas, elimine la sesión nuevamente sin impulsar: presione `Ctrl+X` dos veces en su fila en la vista de agentes, o ejecute el comando `claude rm <id> --discard-unpushed` que la negativa imprimió. Esto elimina la sesión y el worktree junto con su rama, descartando las confirmaciones no impulsadas y cualquier cambio sin confirmar.638 * Para descartarlos, vuelve a eliminar la sesión sin hacer push: presiona `Ctrl+X` dos veces en su fila en la vista de agentes, o ejecuta el comando `claude rm <id> --discard-unpushed` que imprimió el rechazo. Esto elimina la sesión y el worktree junto con su rama, descartando los commits sin push y cualquier cambio sin commit.

639 639 

640 Cuando elimina nuevamente, Claude Code descarta solo lo que mostró la negativa: si el worktree ha ganado una confirmación desde entonces, Claude Code lo mantiene nuevamente y muestra el estado actualizado.640 Cuando vuelves a eliminar, Claude Code descarta solo lo que mostró el rechazo: si el worktree ha ganado un commit desde entonces, Claude Code lo conserva de nuevo y muestra el estado actualizado.

641 641 

642 Cuando el registro de otra sesión terminada también nombra el worktree, permanece cuando elimina nuevamente; impulse las confirmaciones, luego elimine nuevamente.642 Cuando los registros de otra sesión terminada también mencionan el worktree, este se conserva cuando vuelves a eliminar; haz push de los commits y luego vuelve a eliminar.

643* Un worktree que git ya no reconoce, por ejemplo después de `git worktree prune`, no bloquea la eliminación. Claude Code elimina la sesión y deja el directorio en el disco.643* Un worktree que git ya no reconoce, por ejemplo después de `git worktree prune`, no bloquea la eliminación. Claude Code elimina la sesión y deja el directorio en el disco.

644* Cuando git o su hook [`WorktreeRemove`](/docs/es/hooks#worktreeremove) falla al eliminar el worktree, Claude Code mantiene el worktree y la sesión, y el mensaje nombra la causa. Para un hook, el mensaje dice cómo terminó, como `exited 1`, y cita el inicio de su stderr. El mensaje también le dice cuál de estos hacer a continuación:644* Cuando git o tu [hook `WorktreeRemove`](/docs/es/hooks#worktreeremove) no logra eliminar el worktree, Claude Code conserva el worktree y la sesión, y el mensaje indica la causa. En el caso de un hook, el mensaje dice cómo terminó, como `exited 1`, y cita el inicio de su stderr. El mensaje también te indica cuál de estas opciones seguir:

645 645 

646 * Elimine la sesión nuevamente para eliminar el directorio de todas formas, presionando `Ctrl+X` dos veces en su fila en la vista de agentes o ejecutando el comando `claude rm <id> --force-remove-worktree <worktree-id>` que la negativa de `claude rm` imprimió. La rama del worktree permanece en el repositorio.646 * Vuelve a eliminar la sesión para eliminar el directorio de todos modos, presionando `Ctrl+X` dos veces en su fila en la vista de agentes o ejecutando el comando `claude rm <id> --force-remove-worktree <worktree-id>` que imprimió el rechazo de `claude rm`. La rama del worktree permanece en el repositorio.

647 647 

648 Claude Code ofrece esto solo cuando puede confirmar todo lo siguiente:648 Claude Code ofrece esto solo cuando puede confirmar todo lo siguiente:

649 649 

650 * El directorio es uno de los worktrees vinculados del repositorio bajo `.claude/worktrees/`650 * El directorio es uno de los worktrees vinculados del repositorio en `.claude/worktrees/`

651 * Ni el worktree ni un submódulo extraído tiene cambios sin confirmar en archivos rastreados651 * Ni el worktree ni un submódulo extraído tienen cambios sin commit en archivos rastreados

652 * Ningún registro de otra sesión lo nombra652 * Ningún registro de otra sesión lo menciona

653 653 

654 Cuando Claude Code no puede verificar el estado de un checkout de submódulo, como uno reemplazado por un repositorio git separado, tampoco ofrece esto.654 Cuando Claude Code no puede verificar el estado del checkout de un submódulo, como uno reemplazado por un repositorio git separado, tampoco ofrece esto.

655 * Arregle lo que se interpone, como confirmar o guardar los cambios sin confirmar, mover un repositorio git separado fuera del worktree, cerrar lo que esté usando el directorio, o arreglar el hook, luego elimine la sesión nuevamente.655 * Corrige lo que lo impide, como hacer commit o stash de los cambios sin commit, mover un repositorio git separado fuera del worktree, cerrar lo que esté usando el directorio o corregir el hook, y luego vuelve a eliminar la sesión.

656 * Elimine el directorio usted mismo, luego elimine la sesión nuevamente.656 * Elimina tú mismo el directorio y luego vuelve a eliminar la sesión.

657 657 

658Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar de cualquier forma.658Un worktree que creaste tú mismo y dentro del cual iniciaste la sesión se deja en su lugar en cualquier caso.

659 659 

660Una sesión cuyo directorio de worktree no pertenece a ningún repositorio git, porque el repositorio fue eliminado o un hook [`WorktreeCreate`](/docs/es/hooks#worktreecreate) creó el directorio en otro lugar, aún se puede eliminar. Mientras los archivos permanezcan en el directorio:660Una sesión cuyo directorio de worktree no pertenece a ningún repositorio git, porque el repositorio se eliminó o porque un [hook `WorktreeCreate`](/docs/es/hooks#worktreecreate) creó el directorio en otro lugar, aún se puede eliminar. Mientras queden archivos en el directorio:

661 661 

662* La vista de agentes pide la misma doble pulsación de `Ctrl+X` antes de descartarlos. Para un directorio creado por hook, ejecuta su hook [`WorktreeRemove`](/docs/es/hooks#worktreeremove) en su lugar, y sin uno rechaza la eliminación y mantiene la sesión.662* La vista de agentes pide la misma doble pulsación de `Ctrl+X` antes de descartarlos. Para un directorio creado por un hook, ejecuta en su lugar tu [hook `WorktreeRemove`](/docs/es/hooks#worktreeremove), y si no hay uno, rechaza la eliminación y conserva la sesión.

663* `claude rm` mantiene la sesión y el worktree, y nombra la razón.663* `claude rm` conserva la sesión y el worktree, e indica el motivo.

664 664 

665Cualquiera de los caminos mantiene un directorio que los registros de otra sesión terminada nombran.665Cualquiera de las dos vías conserva un directorio que mencionan los registros de otra sesión terminada.

666 666 

667<h3 id="set-the-model">667<h3 id="set-the-model">

668 Establecer el modelo668 Establecer el modelo

669</h3>669</h3>

670 670 

671El nombre del modelo que se muestra en el encabezado de la vista de agentes es el predeterminado de envío. Las nuevas sesiones que inicia desde la entrada usan este modelo, que proviene de la [configuración `model`](/docs/es/settings-reference#model) en su configuración de usuario. Establézcalo seleccionando un modelo en el selector [`/model`](/docs/es/model-config), o edite la configuración directamente.671El nombre del modelo que se muestra en el encabezado de la vista de agentes es el predeterminado de envío. Las nuevas sesiones que inicias desde la entrada usan este modelo, que proviene del [ajuste `model`](/docs/es/settings-reference#model) de tu configuración de usuario. Establécelo seleccionando un modelo en el [selector `/model`](/docs/es/model-config), o edita el ajuste directamente.

672 672 

673Para anular el predeterminado de envío para toda la sesión de vista de agentes, pase `--model` cuando abra la vista de agentes. Consulte [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort).673Para sobrescribir el predeterminado de envío durante toda la sesión de la vista de agentes, pasa `--model` al abrir la vista de agentes. Consulta [Modo de permisos, modelo y esfuerzo](#permission-mode-model-and-effort).

674 674 

675Para cambiar el predeterminado de envío desde dentro de la vista de agentes, escriba `/model` seguido de un nombre de modelo en la entrada de envío y presione `Enter`. El encabezado se actualiza para mostrar ese modelo con un marcador `(session)`, y las sesiones que envía después lo usan. Escriba `/model default` para borrar la anulación y volver al predeterminado de envío. Esta anulación dura el resto de la ejecución actual de `claude agents` y no escribe en su archivo de configuración. El siguiente ejemplo envía una sesión en Opus y la siguiente en Sonnet:675Para cambiar el predeterminado de envío desde dentro de la vista de agentes, escribe `/model` seguido del nombre de un modelo en la entrada de envío y presiona `Enter`. El encabezado se actualiza para mostrar ese modelo con un marcador `(session)`, y las sesiones que envíes después lo usan. Escribe `/model default` para borrar la sobrescritura y volver al predeterminado de envío. Esta sobrescritura dura el resto de la ejecución actual de `claude agents` y no escribe en tu archivo de configuración. El siguiente ejemplo envía una sesión con Opus y la siguiente con Sonnet:

676 676 

677```text theme={null}677```text theme={null}

678/model opus678/model opus


681run the test suite681run the test suite

682```682```

683 683 

684Cada sesión en segundo plano puede ejecutarse en un modelo diferente. Para anularlo para una sesión:684Cada sesión en segundo plano puede ejecutarse con un modelo diferente. Para sobrescribirlo en una sesión:

685 685 

686* Desde el shell, pase `--model` con `claude --bg`.686* Desde el shell, pasa `--model` con `claude --bg`.

687* Adjúntese a una sesión en ejecución y ejecute `/model` para cambiar: una selección del selector, o un `/model <name>` escrito, se guarda como su predeterminado para nuevas sesiones a menos que presione `s` en el selector para un cambio solo de sesión. Un cambio solo de sesión persiste si la sesión se reaparece.687* Adjúntate a una sesión en ejecución y ejecuta `/model` para cambiarlo: una selección en el selector, o un `/model <name>` escrito, se guarda como tu predeterminado para nuevas sesiones, a menos que presiones `s` en el selector para un cambio solo de la sesión. Un cambio solo de la sesión se mantiene si la sesión se vuelve a generar.

688* Envíe un [subagente](/docs/es/sub-agents) cuyo frontmatter establece un campo `model`.688* Envía un [subagente](/docs/es/sub-agents) cuyo frontmatter establezca un campo `model`.

689 689 

690<h3 id="permission-mode-model-and-effort">690<h3 id="permission-mode-model-and-effort">

691 Modo de permiso, modelo y esfuerzo691 Modo de permisos, modelo y esfuerzo

692</h3>692</h3>

693 693 

694Una sesión en segundo plano toma su configuración, proveedor, modo de permiso, modelo y esfuerzo de dónde y cómo la envió. Las subsecciones a continuación cubren cada fuente, y qué persiste cuando el supervisor reinicia la sesión.694Una sesión en segundo plano toma su configuración, proveedor, modo de permisos, modelo y esfuerzo de dónde y cómo la enviaste. Las subsecciones a continuación cubren cada fuente y lo que persiste cuando el supervisor reinicia la sesión.

695 695 

696<h4 id="settings-and-provider">696<h4 id="settings-and-provider">

697 Configuración y proveedor697 Configuración y proveedor

698</h4>698</h4>

699 699 

700Una sesión en segundo plano lee su [configuración](/docs/es/settings) del directorio en el que se ejecuta, igual que si hubiera iniciado `claude` allí con las [banderas de configuración que llevó](#what-carries-over-when-you-background). Esto incluye [valores `env`](/docs/es/settings-reference#env) en la configuración del proyecto, por lo que una variable `ANTHROPIC_MODEL` o proveedor establecida allí se aplica a cada sesión en segundo plano en ese directorio.700Una sesión en segundo plano lee su [configuración](/docs/es/settings) del directorio en el que se ejecuta, igual que si hubieras iniciado `claude` allí con los [flags de configuración que conservó](#what-carries-over-when-you-background). Esto incluye los [valores `env`](/docs/es/settings-reference#env) de la configuración del proyecto, por lo que un `ANTHROPIC_MODEL` o una variable de proveedor establecidos allí se aplican a todas las sesiones en segundo plano de ese directorio.

701 701 

702Una sesión en segundo plano también se ejecuta con el `PATH` del shell desde el que la envió, por lo que los comandos que ejecuta encuentran las mismas herramientas que su terminal. También mantiene la selección del proveedor de nube de ese shell, como `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, junto con sus alias `ANTHROPIC_DEFAULT_*_MODEL` y cualquier anulación [`CLAUDE_CODE_EXTRA_BODY`](/docs/es/env-vars) que exportó allí.702Una sesión en segundo plano también se ejecuta con el `PATH` del shell desde el que la enviaste, por lo que los comandos que ejecuta encuentran las mismas herramientas que tu terminal. También conserva la selección de proveedor de nube de ese shell, como `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, junto con sus alias `ANTHROPIC_DEFAULT_*_MODEL` y cualquier sobrescritura de [`CLAUDE_CODE_EXTRA_BODY`](/docs/es/env-vars) que hayas exportado allí.

703 703 

704<h4 id="llm-gateway">704<h4 id="llm-gateway">

705 Puerta de enlace LLM705 Gateway LLM

706</h4>706</h4>

707 707 

708Si enruta Claude Code a través de una [puerta de enlace LLM](/docs/es/llm-gateway), coloque las variables de puerta de enlace en el bloque `env` de un archivo de configuración en lugar de exportarlas en su shell, y las sesiones en segundo plano las leen con el resto de su configuración. [Establecer en un archivo de configuración](/docs/es/llm-gateway-connect#set-in-a-settings-file) muestra el bloque y qué archivo de configuración usar para la credencial.708Si enrutas Claude Code a través de un [gateway LLM](/docs/es/llm-gateway), coloca las variables del gateway en el bloque `env` de un archivo de configuración en lugar de exportarlas en tu shell, y las sesiones en segundo plano las leen con el resto de su configuración. [Establecer en un archivo de configuración](/docs/es/llm-gateway-connect#set-in-a-settings-file) muestra el bloque y qué archivo de configuración usar para la credencial.

709 709 

710Si exporta una puerta de enlace `ANTHROPIC_BASE_URL` solo en su shell en su lugar, llega a una sesión en segundo plano, junto con el `ANTHROPIC_CUSTOM_HEADERS` y la credencial que exportó con ella, solo cuando el [supervisor](#the-supervisor-process) fue iniciado desde un shell que exportó la misma puerta de enlace, y solo en estos casos:710Si en cambio exportas un `ANTHROPIC_BASE_URL` de gateway solo en tu shell, este llega a una sesión en segundo plano, junto con el `ANTHROPIC_CUSTOM_HEADERS` y la credencial que exportaste con él, solo cuando el propio [supervisor](#the-supervisor-process) se inició desde un shell que exportó el mismo gateway, y solo en estos casos:

711 711 

712* Envía su propia sesión al fondo con `←` o `/background`712* Envías tu propia sesión al segundo plano con `←` o `/background`

713* Envía una sesión al directorio en el que está713* Envías una sesión al directorio en el que estás

714* Despierta una sesión detenida en el directorio en el que está adjuntándose o respondiendo a ella714* Reactivas una sesión detenida en el directorio en el que estás adjuntándote a ella o respondiéndole

715 715 

716Claude Code reenvía una puerta de enlace frente a un proveedor de nube. Si el shell desde el que envía selecciona el proveedor y exporta su punto final de puerta de enlace con su bandera de omisión de autenticación, Claude Code reenvía el par punto final-y-bandera a la sesión bajo las condiciones que se aplican a `ANTHROPIC_BASE_URL`, junto con `ANTHROPIC_CUSTOM_HEADERS`. Por ejemplo, exporte `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` y `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, y Claude Code reenvía ese punto final y bandera.716Claude Code reenvía un gateway situado delante de un proveedor de nube. Si el shell desde el que haces el envío selecciona el proveedor y exporta su endpoint de gateway con su flag para omitir la autenticación, Claude Code reenvía el par de endpoint y flag a la sesión en las condiciones que se aplican a `ANTHROPIC_BASE_URL`, junto con `ANTHROPIC_CUSTOM_HEADERS`. Por ejemplo, exporta `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` y `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, y Claude Code reenvía ese endpoint y ese flag.

717 717 

718Claude Code aplica una puerta de enlace reenviada solo al proceso en ejecución de esa sesión y nunca la escribe en el disco.718Claude Code aplica un gateway reenviado solo al proceso en ejecución de esa sesión y nunca lo escribe en el disco.

719 719 

720<h4 id="permission-mode">720<h4 id="permission-mode">

721 Modo de permiso721 Modo de permisos

722</h4>722</h4>

723 723 

724El [modo de permiso](/docs/es/permissions) depende de cómo inició la sesión:724El [modo de permisos](/docs/es/permissions) depende de cómo iniciaste la sesión:

725 725 

726* **Enviada al fondo con `/bg` o `←`**: Claude Code mantiene el modo de permiso en el que estaba la sesión, por lo que uno que cambió a `acceptEdits` o `auto` permanece allí después de desasociarse726* **Enviada al segundo plano con `/bg` o `←`**: Claude Code conserva el modo de permisos en el que estaba la sesión, por lo que una que cambiaste a `acceptEdits` o `auto` se mantiene así después de desasociarte

727* **Enviada desde una vista de agentes que abrió con `←`**: la configuración propia del objetivo viene primero, y el modo de permiso de la sesión de la que vino se aplica cuando nada más establece uno727* **Enviada desde una vista de agentes que abriste con `←`**: la configuración propia del destino tiene prioridad, y el modo de permisos de la sesión de la que viniste se aplica cuando nada más establece uno

728* **Enviada desde `claude agents` iniciada en un shell, o con `claude --bg`**: la nueva sesión comienza de la manera que lo haría una nueva sesión `claude` en ese directorio, a menos que la haya enviado desde una vista de agentes que abrió con [predeterminados de envío](#dispatch-defaults). [Qué modo de permiso comienza una sesión](/docs/es/permission-modes#which-mode-a-session-starts-in) enumera el orden728* **Enviada desde `claude agents` iniciado en un shell, o con `claude --bg`**: la nueva sesión comienza como lo haría una nueva sesión de `claude` en ese directorio, a menos que la hayas enviado desde una vista de agentes que abriste con [predeterminados de envío](#dispatch-defaults). [En qué modo de permisos comienza una sesión](/docs/es/permission-modes#which-mode-a-session-starts-in) enumera el orden

729 729 

730Para una sesión que envía desde una vista de agentes abierta con `←`, Claude Code toma el modo de permiso del primero de estos que se aplica:730Para una sesión que envías desde una vista de agentes abierta con `←`, Claude Code toma el modo de permisos de la primera de estas fuentes que se aplique:

731 731 

7321. El [`permissions.defaultMode`](/docs/es/settings-reference#permissions-defaultmode) del directorio objetivo. Se aplican dos reglas de fuente:7321. El [`permissions.defaultMode`](/docs/es/settings-reference#permissions-defaultmode) del directorio de destino. Se aplican dos reglas sobre la fuente:

733 * `auto` y `bypassPermissions` [toman efecto solo desde la configuración administrada, un archivo `--settings`, o `~/.claude/settings.json`](/docs/es/settings-reference#permissions-defaultmode).733 * `auto` y `bypassPermissions` [solo surten efecto desde la configuración administrada, un archivo `--settings` o `~/.claude/settings.json`](/docs/es/settings-reference#permissions-defaultmode).

734 * Claude Code rechaza un `defaultMode` del `.claude/settings.json` o `.claude/settings.local.json` del proyecto que selecciona un modo más permisivo que el modo en el que estaba la sesión de la que vino.734 * Claude Code rechaza un `defaultMode` del `.claude/settings.json` o `.claude/settings.local.json` del proyecto que seleccione un modo más permisivo que el modo en el que estaba la sesión de la que viniste.

7352. El modo de permiso de la sesión de la que vino7352. El modo de permisos de la sesión de la que viniste

736 736 

737Cuando Claude Code rechaza el modo de una fuente como demasiado permisivo, la siguiente fuente en la lista decide. Por ejemplo, si envía desde una sesión en modo de plan a un directorio cuya configuración registrada pide `acceptEdits`, la nueva sesión comienza en modo de plan. Si mueve ese `defaultMode` a `~/.claude/settings.json`, se aplica independientemente del modo de permiso de la sesión de la que vino.737Cuando Claude Code rechaza el modo de una fuente por ser demasiado permisivo, decide la siguiente fuente de la lista. Por ejemplo, si haces el envío desde una sesión en modo plan a un directorio cuya configuración registrada en el repositorio pide `acceptEdits`, la nueva sesión comienza en modo plan. Si mueves ese `defaultMode` a `~/.claude/settings.json`, se aplica sin importar el modo de permisos de la sesión de la que viniste.

738 738 

739La permisividad corre plan, luego Manual y `dontAsk`, luego `acceptEdits` y auto, que cada uno cuenta como más permisivo que el otro, luego `bypassPermissions`.739El orden de permisividad es plan, luego Manual y `dontAsk`, luego `acceptEdits` y auto, cada uno de los cuales cuenta como más permisivo que el otro, y luego `bypassPermissions`.

740 740 

741<h4 id="dispatch-defaults">741<h4 id="dispatch-defaults">

742 Predeterminados de envío742 Predeterminados de envío

743</h4>743</h4>

744 744 

745Para establecer predeterminados para cada sesión que envía desde la vista de agentes, pase cualquiera de `--permission-mode`, `--model`, `--effort`, o `--agent` cuando la abre:745Para establecer predeterminados para cada sesión que envíes desde la vista de agentes, pasa cualquiera de `--permission-mode`, `--model`, `--effort` o `--agent` al abrirla:

746 746 

747```bash theme={null}747```bash theme={null}

748claude agents --permission-mode plan --model opus --effort high748claude agents --permission-mode plan --model opus --effort high

749```749```

750 750 

751`--effort` aquí acepta los mismos valores que la [bandera `--effort` de nivel superior](/docs/es/cli-reference#cli-flags), incluido `ultracode`.751Aquí `--effort` acepta los mismos valores que el [flag `--effort` de nivel superior](/docs/es/cli-reference#cli-flags), incluido `ultracode`.

752 752 

753`--agent` establece el [subagente](/docs/es/sub-agents) usado cuando un prompt de envío no nombra uno, ya sea con `@name` o como la primera palabra. Por defecto es la [configuración `agent`](/docs/es/settings-reference#agent) si se establece una, de lo contrario el agente integrado `claude` que lo atrapa todo. Nombrar un subagente en la entrada de envío anula ambos.753`--agent` establece el [subagente](/docs/es/sub-agents) que se usa cuando un prompt de envío no nombra ninguno, ya sea con `@name` o como primera palabra. Su valor predeterminado es el [ajuste `agent`](/docs/es/settings-reference#agent) si hay uno establecido; de lo contrario, el agente integrado genérico `claude`. Nombrar un subagente en la entrada de envío sobrescribe ambos.

754 754 

755`claude agents` también acepta `--dangerously-skip-permissions` como abreviatura de `--permission-mode bypassPermissions`, y `--allow-dangerously-skip-permissions` para hacer que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de cada sesión enviada sin comenzar en ese modo. Ambos coinciden con las [banderas CLI de nivel superior](/docs/es/cli-reference).755`claude agents` también acepta `--dangerously-skip-permissions` como abreviatura de `--permission-mode bypassPermissions`, y `--allow-dangerously-skip-permissions` para que `bypassPermissions` esté disponible en el ciclo de `Shift+Tab` de cada sesión enviada sin comenzar en ese modo. Ambos coinciden con los [flags de nivel superior de la CLI](/docs/es/cli-reference).

756 756 

757Pase `--restricted` para iniciar cada sesión que envía desde la vista en [modo restringido](/docs/es/cli-reference#cli-flags), como si cada una se iniciara con la bandera de nivel superior `--restricted`. Requiere Claude Code v2.1.248 o posterior.757Pasa `--restricted` para iniciar cada sesión que envíes desde la vista en [modo restringido](/docs/es/cli-reference#cli-flags), como si cada una se iniciara con el flag de nivel superior `--restricted`. Requiere Claude Code v2.1.248 o posterior.

758 758 

759Los predeterminados activos aparecen en el pie de página debajo de la entrada de envío.759Los predeterminados activos aparecen en el pie, debajo de la entrada de envío.

760 760 

761Claude Code rechaza `claude --bg --permission-mode bypassPermissions` hasta que haya aceptado la exención de omisión ejecutando `claude --dangerously-skip-permissions` una vez de forma interactiva, ya que ese modo permite que una sesión que no está viendo actúe sin aprobación. Pasar `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` muestra la misma exención cuando no la ha aceptado antes, y aceptar aplica `bypassPermissions` a las sesiones que inicia desde la vista. Pasar `--allow-dangerously-skip-permissions` muestra la misma exención también, y aceptar hace que `bypassPermissions` esté disponible en el ciclo `Shift+Tab` de esas sesiones sin iniciarlas en él.761Claude Code rechaza `claude --bg --permission-mode bypassPermissions` hasta que hayas aceptado el descargo de responsabilidad de omisión ejecutando `claude --dangerously-skip-permissions` una vez de forma interactiva, ya que ese modo permite que una sesión que no estás observando actúe sin aprobación. Pasar `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` muestra el mismo descargo de responsabilidad si no lo has aceptado antes, y aceptarlo aplica `bypassPermissions` a las sesiones que inicies desde la vista. Pasar `--allow-dangerously-skip-permissions` también muestra el mismo descargo de responsabilidad, y aceptarlo hace que `bypassPermissions` esté disponible en el ciclo de `Shift+Tab` de esas sesiones sin iniciarlas en ese modo.

762 762 

763<h4 id="what-persists-across-restarts">763<h4 id="what-persists-across-restarts">

764 Qué persiste en los reinicios764 Qué persiste tras los reinicios

765</h4>765</h4>

766 766 

767El modo de permiso, modelo y esfuerzo que eligió para una sesión en segundo plano, junto con las [banderas de configuración que llevó](#what-carries-over-when-you-background), todos persisten cuando el supervisor más tarde [detiene y reinicia](#the-supervisor-process) su proceso. Una sesión que inició con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` permanece en `bypassPermissions` después de ese reinicio. Un modelo o esfuerzo que cambió a mitad de sesión con `/model` o `/effort` también se mantiene.767El modo de permisos, el modelo y el esfuerzo que elegiste para una sesión en segundo plano, junto con los [flags de configuración que conserva](#what-carries-over-when-you-background), persisten cuando el supervisor más tarde [detiene y reinicia](#the-supervisor-process) su proceso. Una sesión que iniciaste con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` permanece en `bypassPermissions` después de ese reinicio. Un modelo o esfuerzo que cambiaste a mitad de la sesión con `/model` o `/effort` también se conserva.

768 768 

769Si la sesión tomó su esfuerzo de su configuración en lugar de `--effort` o `/effort`, Claude Code lee su configuración nuevamente cada vez que inicia un proceso para la sesión. Después de editar el esfuerzo guardado en `settings.json`, el cambio llega a las sesiones que envía al fondo con `←` o `/bg`, y sus reinicios posteriores. El esfuerzo guardado es la clave [`effortLevel`](/docs/es/settings-reference#effortlevel) o una entrada [`modelSettings`](/docs/es/settings-reference#modelsettings).769Si la sesión tomó su esfuerzo de tu configuración en lugar de `--effort` o `/effort`, Claude Code vuelve a leer tu configuración cada vez que inicia un proceso para la sesión. Después de editar el esfuerzo guardado en `settings.json`, el cambio llega a las sesiones que envíes al segundo plano con `←` o `/bg` y a sus reinicios posteriores. El esfuerzo guardado es la clave [`effortLevel`](/docs/es/settings-reference#effortlevel) o una entrada de [`modelSettings`](/docs/es/settings-reference#modelsettings).

770 770 

771Claude Code también mantiene un nombre que estableció con [`/rename`](/docs/es/commands) o `Ctrl+R` en ese reinicio, para que aún pueda ejecutar [`claude --resume <name>`](/docs/es/sessions#name-your-sessions) para llegar a la sesión.771Claude Code también conserva tras ese reinicio un nombre que hayas establecido con [`/rename`](/docs/es/commands) o `Ctrl+R`, para que puedas seguir ejecutando [`claude --resume <name>`](/docs/es/sessions#name-your-sessions) para acceder a la sesión.

772 772 

773Un prompt que guardó con [`Ctrl+S`](/docs/es/interactive-mode#general-controls) mientras estaba adjunto se mantiene con la sesión también. Reabra la sesión después de que su proceso fue detenido o reiniciado, y `Ctrl+S` restaura el texto guardado. El contenido pegado en el almacenamiento no sobrevive al reinicio.773Un prompt que guardaste con [`Ctrl+S`](/docs/es/interactive-mode#general-controls) mientras estabas adjunto también se conserva con la sesión. Vuelve a abrir la sesión después de que su proceso se haya detenido o reiniciado, y presiona `Ctrl+S` para restaurar el texto guardado. El contenido pegado en lo guardado no se conserva tras el reinicio.

774 774 

775<h3 id="settings-plugins-and-mcp-servers">775<h3 id="settings-plugins-and-mcp-servers">

776 Configuración, plugins y servidores MCP776 Configuración, plugins y servidores MCP

777</h3>777</h3>

778 778 

779La vista de agentes acepta las mismas banderas de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. La vista de agentes aplica `--settings`, `--setting-sources` y `--plugin-dir` a sí misma y pasa cada bandera de configuración a las sesiones que envía desde ella, por lo que un plugin o servidor MCP que carga de esta manera está disponible en esas sesiones.779La vista de agentes acepta los mismos flags de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. La vista de agentes aplica `--settings`, `--setting-sources` y `--plugin-dir` a sí misma y pasa todos los flags de configuración a las sesiones que envías desde ella, por lo que un plugin o servidor MCP que cargues de esta manera está disponible en esas sesiones.

780 780 

781| Bandera | Efecto |781| Flag | Efecto |

782| :- | :- |782| :- | :- |

783| [`--settings <file-or-json>`](/docs/es/settings) | Anular configuración para vista de agentes y sesiones enviadas |783| [`--settings <file-or-json>`](/docs/es/settings) | Sobrescribe la configuración para la vista de agentes y las sesiones enviadas |

784| [`--setting-sources <sources>`](/docs/es/cli-reference#cli-flags) | Cargar solo las fuentes de configuración nombradas, en vista de agentes y sesiones enviadas |784| [`--setting-sources <sources>`](/docs/es/cli-reference#cli-flags) | Carga solo las fuentes de configuración indicadas, en la vista de agentes y en las sesiones enviadas |

785| [`--add-dir <path>`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) | Otorgar acceso a archivos a un directorio adicional |785| [`--add-dir <path>`](/docs/es/permissions#additional-directories-grant-file-access-not-configuration) | Otorga acceso a archivos en un directorio adicional |

786| [`--plugin-dir <path>`](/docs/es/plugins/create#load-a-directory-or-archive-for-one-session) | Cargar un plugin desde un directorio local |786| [`--plugin-dir <path>`](/docs/es/plugins/create#load-a-directory-or-archive-for-one-session) | Carga un plugin desde un directorio local |

787| [`--mcp-config <file-or-json>`](/docs/es/mcp) | Cargar servidores MCP desde un archivo de configuración o cadena JSON |787| [`--mcp-config <file-or-json>`](/docs/es/mcp) | Carga servidores MCP desde un archivo de configuración o una cadena JSON |

788| `--strict-mcp-config` | Usar solo los servidores MCP de `--mcp-config`, ignorando otra configuración de MCP. Consulte [Control exclusivo con managed-mcp.json](/docs/es/managed-mcp#exclusive-control-with-managed-mcp-json) para ver qué hace la bandera bajo un archivo MCP administrado |788| `--strict-mcp-config` | Usa solo los servidores MCP de `--mcp-config` e ignora el resto de la configuración de MCP. Consulta [Control exclusivo con managed-mcp.json](/docs/es/managed-mcp#exclusive-control-with-managed-mcp-json) para ver qué hace el flag con un archivo MCP administrado |

789 789 

790Repita `--add-dir`, `--plugin-dir`, o `--mcp-config` una vez por valor. `claude agents` no admite la forma separada por espacios, como `--add-dir a b c`.790Repite `--add-dir`, `--plugin-dir` o `--mcp-config` una vez por valor. `claude agents` no admite la forma separada por espacios, como `--add-dir a b c`.

791 791 

792Puede colocar `--settings`, `--setting-sources` y `--plugin-dir` antes o después de `agents`. Mantenga `--add-dir` y `--mcp-config` después de `agents`: si coloca cualquiera de ellos antes de `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) falla con un error `unknown option`.792Puedes colocar `--settings`, `--setting-sources` y `--plugin-dir` antes o después de `agents`. Mantén `--add-dir` y `--mcp-config` después de `agents`: si colocas cualquiera de ellos antes de `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) falla con un error `unknown option`.

793 793 

794El siguiente ejemplo abre la vista de agentes con una anulación de configuración y un directorio adicional:794El siguiente ejemplo abre la vista de agentes con una sobrescritura de configuración y un directorio adicional:

795 795 

796```bash theme={null}796```bash theme={null}

797claude agents --settings ./ci-settings.json --add-dir ../shared-lib797claude agents --settings ./ci-settings.json --add-dir ../shared-lib

798```798```

799 799 

800`--settings` acepta una ruta de archivo o una cadena JSON en línea. Una ruta de archivo debe apuntar a un archivo existente; Claude Code sale con un error `Settings file not found` si no lo hace.800`--settings` acepta una ruta de archivo o una cadena JSON en línea. Una ruta de archivo debe apuntar a un archivo existente; si no es así, Claude Code sale con un error `Settings file not found`.

801 801 

802<h2 id="manage-sessions-from-the-shell">802<h2 id="manage-sessions-from-the-shell">

803 Gestionar sesiones desde el shell803 Gestionar sesiones desde el shell

804</h2>804</h2>

805 805 

806Cada sesión en segundo plano tiene un ID corto que puede usar desde el shell. El ID se imprime cuando inicia una sesión con `claude --bg`, y el ID de cada sesión es su nombre de directorio bajo `~/.claude/jobs/`. Estos comandos son útiles para scripting o cuando no desea abrir la vista de agentes.806Cada sesión en segundo plano tiene un ID corto que puedes usar desde el shell. El ID se imprime cuando inicias una sesión con `claude --bg`, y el ID de cada sesión es su nombre de directorio bajo `~/.claude/jobs/`. Estos comandos son útiles para scripting o cuando no quieres abrir la vista de agentes.

807 807 

808| Comando | Propósito |808| Comando | Propósito |

809| :- | :- |809| :- | :- |

810| `claude agents` | Abrir la vista de agentes |810| `claude agents` | Abrir la vista de agentes |

811| `claude agents --cwd <path>` | Abrir la vista de agentes limitada a sesiones iniciadas bajo `<path>` |811| `claude agents --cwd <path>` | Abrir la vista de agentes limitada a sesiones iniciadas bajo `<path>` |

812| `claude agents --json` | Imprimir sesiones como un array JSON y salir. Consulte [Listar sesiones como JSON](#list-sessions-as-json) |812| `claude agents --json` | Imprimir sesiones como un array JSON y salir. Consulta [Listar sesiones como JSON](#list-sessions-as-json) |

813| `claude attach <id>` | Conectarse a una sesión en esta terminal |813| `claude attach <id\|name>` | Conectarse a una sesión en esta terminal |

814| `claude logs <id>` | Imprimir la salida reciente de la sesión |814| `claude logs <id\|name>` | Imprimir la salida reciente de la sesión |

815| `claude stop <id>` | Detener una sesión. También acepta `claude kill` |815| `claude stop <id>` | Detener una sesión. También acepta `claude kill` |

816| `claude respawn <id>` | Reiniciar una sesión, en ejecución o detenida, por ejemplo para usar un binario Claude Code actualizado. La sesión reiniciada reanuda su conversación guardada; cuando ninguna está en disco, ejecuta su prompt original nuevamente como una nueva conversación |816| `claude respawn <id>` | Reiniciar una sesión, en ejecución o detenida, por ejemplo para usar un binario Claude Code actualizado. La sesión reiniciada reanuda su conversación guardada; cuando ninguna está en disco, ejecuta su prompt original nuevamente como una nueva conversación |

817| `claude respawn --all` | Reiniciar cada sesión en ejecución, por ejemplo para mover todas las sesiones a un binario Claude Code actualizado a la vez |817| `claude respawn --all` | Reiniciar cada sesión en ejecución, por ejemplo para mover todas las sesiones a un binario Claude Code actualizado a la vez |

818| `claude rm <id>` | Eliminar una sesión de la lista, junto con un worktree que Claude creó para ella cuando es seguro eliminarlo; consulte [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). La transcripción de la conversación permanece en su máquina local y sigue disponible a través de `claude --resume` |818| `claude rm <id>` | Eliminar una sesión de la lista, junto con un worktree que Claude creó para ella cuando es seguro eliminarlo; consulta [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). La transcripción de la conversación permanece en tu máquina local y sigue disponible a través de `claude --resume` |

819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Eliminar una sesión cuya eliminación fue rechazada por commits no enviados, descartando el worktree junto con su rama y commits. Pase el valor exacto que imprimió el rechazo; consulte [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). Requiere v2.1.260 o posterior |819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Eliminar una sesión cuya eliminación fue rechazada por commits no enviados, descartando el worktree junto con su rama y commits. Pasa el valor exacto que imprimió el rechazo; consulta [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). Requiere v2.1.260 o posterior |

820| `claude rm <id> --force-remove-worktree <worktree-id>` | Eliminar una sesión cuya eliminación fue rechazada porque git o el hook `WorktreeRemove` no pudieron eliminar su worktree, eliminando el directorio worktree de todas formas y dejando su rama en el repositorio. Pase el valor exacto que imprimió el rechazo; consulte [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). Requiere v2.1.268 o posterior |820| `claude rm <id> --force-remove-worktree <worktree-id>` | Eliminar una sesión cuya eliminación fue rechazada porque git o el hook `WorktreeRemove` no pudieron eliminar su worktree, eliminando el directorio worktree de todas formas y dejando su rama en el repositorio. Pasa el valor exacto que imprimió el rechazo; consulta [Qué elimina la eliminación de una sesión](#what-deleting-a-session-removes). Requiere v2.1.268 o posterior |

821| `claude daemon status` | Imprimir el estado del [supervisor](#the-supervisor-process), versión, directorio de socket y número de workers |821| `claude daemon status` | Imprimir el estado del [supervisor](#the-supervisor-process), versión, directorio de socket y número de workers |

822| `claude daemon stop --any` | Detener el proceso supervisor y las sesiones en segundo plano que aloja. Pase `--keep-workers` para dejar las sesiones en segundo plano en ejecución de modo que el siguiente supervisor se reconecte a ellas. El siguiente `claude agents` o `claude --bg` inicia un nuevo supervisor |822| `claude daemon stop --any` | Detener el proceso supervisor y las sesiones en segundo plano que aloja. Pasa `--keep-workers` para dejar las sesiones en segundo plano en ejecución de modo que el siguiente supervisor se reconecte a ellas. El siguiente `claude agents` o `claude --bg` inicia un nuevo supervisor |

823 

824`claude attach` y `claude logs` pueden recibir parte del nombre de una sesión en ejecución en lugar del ID, como en `claude logs "auth refactor"`. Pasar un nombre requiere Claude Code v2.1.290 o posterior.

823 825 

824<h3 id="list-sessions-as-json">826<h3 id="list-sessions-as-json">

825 Listar sesiones como JSON827 Listar sesiones como JSON

826</h3>828</h3>

827 829 

828`claude agents --json` imprime sesiones activas como un array JSON y sale: cada sesión activa, más sesiones en segundo plano que aún están funcionando o bloqueadas incluso cuando su proceso ha salido. Agregue `--all` para incluir también sesiones en segundo plano completadas, y `--cwd <path>` para limitar la lista a sesiones iniciadas bajo ese directorio.830`claude agents --json` imprime sesiones activas como un array JSON y sale: cada sesión activa, más sesiones en segundo plano que aún están funcionando o bloqueadas incluso cuando su proceso ha salido. Agrega `--all` para incluir también sesiones en segundo plano completadas, y `--cwd <path>` para limitar la lista a sesiones iniciadas bajo ese directorio.

829 831 

830Cada entrada describe una sesión:832Cada entrada describe una sesión:

831 833 


833| :- | :- | :- |835| :- | :- | :- |

834| `cwd`, `kind`, `startedAt` | Siempre | El directorio de trabajo, `interactive` o `background`, y la hora de inicio en milisegundos Unix |836| `cwd`, `kind`, `startedAt` | Siempre | El directorio de trabajo, `interactive` o `background`, y la hora de inicio en milisegundos Unix |

835| `id` | Sesiones en segundo plano | ID corto, utilizable con `claude attach`, `claude logs` y `claude stop` |837| `id` | Sesiones en segundo plano | ID corto, utilizable con `claude attach`, `claude logs` y `claude stop` |

836| `state` | Sesiones en segundo plano | Uno de `working`, `blocked`, `done`, `failed` o `stopped`. Consulte [Leer el estado de la sesión desde un script](#read-session-state-from-a-script) para saber qué significa cada valor |838| `state` | Sesiones en segundo plano | Uno de `working`, `blocked`, `done`, `failed` o `stopped`. Consulta [Leer el estado de la sesión desde un script](#read-session-state-from-a-script) para saber qué significa cada valor |

837| `pid`, `status` | Mientras el proceso está activo | ID del proceso y uno de `busy`, `waiting` o `idle` |839| `pid`, `status` | Mientras el proceso está activo | ID del proceso y uno de `busy`, `waiting` o `idle` |

838| `waitingFor` | Cuando `status` es `waiting` | En qué está bloqueada la sesión: `permission prompt` para una aprobación, `input needed` para una pregunta de Claude o una solicitud de entrada de un servidor MCP, `sandbox request`, `worker request` o `dialog open` |840| `waitingFor` | Cuando `status` es `waiting` | En qué está bloqueada la sesión: `permission prompt` para una aprobación, `input needed` para una pregunta de Claude o una solicitud de entrada de un servidor MCP, `sandbox request`, `worker request` o `dialog open` |

839| `sessionId`, `name` | Cuando está configurado | `sessionId` es el UUID de sesión completo, utilizable con [`claude --resume`](/docs/es/sessions). El `name` de una sesión interactiva es su [nombre de visualización predeterminado](/docs/es/sessions#name-your-sessions) hasta que nombre la sesión o acepte un plan en ella |841| `sessionId`, `name` | Cuando está configurado | `sessionId` es el UUID de sesión completo, utilizable con [`claude --resume`](/docs/es/sessions). El `name` de una sesión interactiva es su [nombre de visualización predeterminado](/docs/es/sessions#name-your-sessions) hasta que nombres la sesión o aceptes un plan en ella |

840 842 

841<h3 id="read-session-state-from-a-script">843<h3 id="read-session-state-from-a-script">

842 Leer el estado de la sesión desde un script844 Leer el estado de la sesión desde un script

843</h3>845</h3>

844 846 

845`claude agents --json` es la forma compatible para leer el estado de la sesión desde fuera de Claude Code, por ejemplo desde una barra de estado, un programador o otra sesión de Claude que supervisa el trabajo en segundo plano. Consulte `claude agents --json --all`, que sigue listando sesiones cuyo proceso ha salido, y lea el `state`, `status` y `waitingFor` de cada entrada.847`claude agents --json` es la forma compatible para leer el estado de la sesión desde fuera de Claude Code, por ejemplo desde una barra de estado, un programador u otra sesión de Claude que supervisa el trabajo en segundo plano. Consulta `claude agents --json --all`, que sigue listando sesiones cuyo proceso ha salido, y lee el `state`, `status` y `waitingFor` de cada entrada.

846 848 

847| `state` | Qué significa |849| `state` | Qué significa |

848| :- | :- |850| :- | :- |

849| `working` | Se está ejecutando un turno, o la sesión está entre pasos de trabajo que impulsa por sí sola, como una iteración de [`/loop`](/docs/es/scheduled-tasks) o una espera en CI. `status` le indica si su proceso está `busy` en este momento |851| `working` | Se está ejecutando un turno, o la sesión está entre pasos de trabajo que impulsa por sí sola, como una iteración de [`/loop`](/docs/es/scheduled-tasks) o una espera en CI. `status` te indica si su proceso está `busy` en este momento |

850| `blocked` | La sesión está esperando por usted: una pregunta que hizo, una decisión de permiso o sandbox, un error que solo usted puede aclarar como un inicio de sesión expirado, o su primer prompt si la inició sin uno. Cuando la espera es un prompt abierto en un proceso activo, `waitingFor` lo nombra |852| `blocked` | La sesión está esperando por ti: una pregunta que hizo, una decisión de permiso o sandbox, un error que solo tú puedes resolver como un inicio de sesión expirado, o su primer prompt si la iniciaste sin uno. Cuando la espera es un prompt abierto en un proceso activo, `waitingFor` lo nombra |

851| `done` | El último turno terminó lo que pidió y la sesión está lista para su siguiente prompt, independientemente de si su proceso aún está activo |853| `done` | El último turno terminó lo que pediste y la sesión está lista para tu siguiente prompt, independientemente de si su proceso aún está activo |

852| `failed`, `stopped` | La tarea terminó con un error, o la sesión fue detenida |854| `failed`, `stopped` | La tarea terminó con un error, o la sesión fue detenida |

853 855 

854Una sesión que terminó su turno y está esperando su siguiente instrucción lee `done`, no `blocked`. `blocked` siempre significa que la sesión necesita algo de usted antes de poder continuar.856Una sesión que terminó su turno y está esperando tu siguiente instrucción lee `done`, no `blocked`. `blocked` siempre significa que la sesión necesita algo de ti antes de poder continuar.

855 857 

856Los archivos bajo `~/.claude/jobs/<id>/` no son una interfaz estable. Los valores que una sesión u otro programa escribe en `state`, `detail`, `tempo` o `needs` se reemplazan en la siguiente actualización.858Los archivos bajo `~/.claude/jobs/<id>/` no son una interfaz estable. Los valores que una sesión u otro programa escribe en `state`, `detail`, `tempo` o `needs` se reemplazan en la siguiente actualización.

857 859 

858Si desea que una sesión informe el progreso con sus propias palabras, haga que escriba un archivo propio, por ejemplo bajo `$CLAUDE_JOB_DIR/tmp`, en lugar de editar `state.json`.860Si quieres que una sesión informe el progreso con sus propias palabras, haz que escriba un archivo propio, por ejemplo bajo `$CLAUDE_JOB_DIR/tmp`, en lugar de editar `state.json`.

859 861 

860<h2 id="how-background-sessions-are-hosted">862<h2 id="how-background-sessions-are-hosted">

861 Cómo se alojan las sesiones en segundo plano863 Cómo se alojan las sesiones en segundo plano

862</h2>864</h2>

863 865 

864Claude Code trata cada sesión listada en la vista de agentes como una sesión en segundo plano, independientemente de si está actualmente conectado a ella. Por el contrario, una sesión iniciada ejecutando `claude` directamente está vinculada a esa terminal y finaliza cuando se cierra, a menos que la [envíe al segundo plano](#from-inside-a-session).866Claude Code trata cada sesión listada en la vista de agentes como una sesión en segundo plano, independientemente de si estás actualmente conectado a ella. Por el contrario, una sesión iniciada ejecutando `claude` directamente está vinculada a esa terminal y finaliza cuando se cierra, a menos que la [envíes al segundo plano](#from-inside-a-session).

865 867 

866Para verificar qué tipo de sesión está usando, ejecute [`/status`](/docs/es/commands). La fila `Session kind` muestra `background job · attached` o `background job · unattended` en una sesión en segundo plano, dependiendo de si una terminal está conectada, e `interactive` en cualquier otra sesión.868Para verificar qué tipo de sesión estás usando, ejecuta [`/status`](/docs/es/commands). La fila `Session kind` muestra `background job · attached` o `background job · unattended` en una sesión en segundo plano, dependiendo de si una terminal está conectada, e `interactive` en cualquier otra sesión.

867 869 

868<h3 id="the-supervisor-process">870<h3 id="the-supervisor-process">

869 El proceso supervisor871 El proceso supervisor

870</h3>872</h3>

871 873 

872El supervisor es un servicio en segundo plano que ejecuta sus sesiones en segundo plano para que sigan funcionando después de cerrar la vista de agentes o su terminal. Claude Code lo inicia la primera vez que envía una sesión al segundo plano o abre la vista de agentes, y no necesita administrarlo usted mismo.874El supervisor es un servicio en segundo plano que ejecuta tus sesiones en segundo plano para que sigan funcionando después de cerrar la vista de agentes o tu terminal. Claude Code lo inicia la primera vez que envías una sesión al segundo plano o abres la vista de agentes, y no necesitas administrarlo tú mismo.

873 875 

874Cada sesión es su propio proceso de Claude Code bajo el supervisor, y lo que sucede con ese proceso depende del estado de la sesión:876Cada sesión es su propio proceso de Claude Code bajo el supervisor, y lo que sucede con ese proceso depende del estado de la sesión:

875 877 

876* **Funcionando, pausado en un aviso de permiso u otro diálogo, o conectado**: el proceso sigue ejecutándose. Un subagente, flujo de trabajo o monitor en ejecución cuenta como funcionando.878* **Funcionando, pausado en una solicitud de permiso u otro diálogo, o conectado**: el proceso sigue ejecutándose. Un subagente, flujo de trabajo o monitor en ejecución cuenta como funcionando.

877* **Finalizado o esperando su próximo mensaje, y sin conectar durante aproximadamente una hora**: el supervisor detiene el proceso para liberar recursos. Una sesión que terminó su turno haciéndole una pregunta cuenta como esperando su próximo mensaje. La conversación permanece en el disco, y la próxima vez que se conecte o responda, la sesión se reanuda donde se quedó. Fije una sesión con `Ctrl+T` para mantener su proceso ejecutándose.879* **Finalizado o esperando tu próximo mensaje, y sin conectar durante aproximadamente una hora**: el supervisor detiene el proceso para liberar recursos. Una sesión que terminó su turno haciéndote una pregunta cuenta como esperando tu próximo mensaje. La conversación permanece en el disco, y la próxima vez que te conectes o respondas, la sesión se reanuda donde se quedó. Fija una sesión con `Ctrl+T` para mantener su proceso ejecutándose.

878* **Salió inesperadamente mientras el supervisor está ejecutándose**: el supervisor reinicia el proceso. Finalizar una sesión que envió al segundo plano usted mismo con `←` o `/background`, por ejemplo con `kill`, la marca como detenida en lugar de reiniciarla. Para sesiones que finalizaron con un apagado, consulte [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown).880* **Salió inesperadamente mientras el supervisor está ejecutándose**: el supervisor reinicia el proceso. Finalizar una sesión que enviaste al segundo plano tú mismo con `←` o `/background`, por ejemplo con `kill`, la marca como detenida en lugar de reiniciarla. Para sesiones que finalizaron con un apagado, consulta [Las sesiones se muestran como fallidas o detenidas después del apagado](#sessions-show-as-failed-after-shutdown).

879* **Después de una actualización automática**: el supervisor se reinicia en la nueva versión y mueve las sesiones inactivas al segundo plano. Las sesiones que están funcionando, esperando su entrada o conectadas no se interrumpen.881* **Después de una actualización automática**: el supervisor se reinicia en la nueva versión y mueve las sesiones inactivas en segundo plano. Las sesiones que están funcionando, esperando tu respuesta o conectadas no se interrumpen.

880 882 

881Cuando el proceso de una sesión se detiene o se reinicia, los comandos de shell en segundo plano, los flujos de trabajo dinámicos y los subagentes en segundo plano que Claude inició en ella se transfieren al siguiente proceso; los monitores en ejecución y los comandos de shell que un subagente inició se detienen con el proceso. Eliminar la sesión detiene todo lo que se transfirió. Para detener todo con el proceso en lugar de transferirlo, establezca [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/es/env-vars#variables) en `1`.883Cuando el proceso de una sesión se detiene o se reinicia, los comandos de shell en segundo plano, los flujos de trabajo dinámicos y los subagentes en segundo plano que Claude inició en ella se transfieren al siguiente proceso; los monitores en ejecución y los comandos de shell que un subagente inició se detienen con el proceso. Eliminar la sesión detiene todo lo que se transfirió. Para detener todo con el proceso en lugar de transferirlo, establece [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/es/env-vars#variables) en `1`.

882 884 

883El supervisor y sus sesiones se autentican con las mismas credenciales almacenadas que sus sesiones interactivas. Para saber qué configuraciones y variables de shell llegan a una sesión, incluido `PATH`, consulte [Configuración y proveedor](#settings-and-provider). Para puntos finales de puerta de enlace, consulte [Puerta de enlace LLM](#llm-gateway).885El supervisor y sus sesiones se autentican con las mismas credenciales almacenadas que tus sesiones interactivas. Para saber qué ajustes y variables de shell llegan a una sesión, incluido `PATH`, consulta [Configuración y proveedor](#settings-and-provider). Para endpoints de gateway, consulta [Gateway LLM](#llm-gateway).

884 886 

885<h3 id="where-state-is-stored">887<h3 id="where-state-is-stored">

886 Dónde se almacena el estado888 Dónde se almacena el estado

887</h3>889</h3>

888 890 

889El estado de la sesión se almacena en su directorio de configuración de Claude Code. Si establece [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars), el supervisor usa ese directorio en lugar de `~/.claude` y se ejecuta como una instancia separada con sus propias sesiones.891El estado de la sesión se almacena en tu directorio de configuración de Claude Code. Si estableces [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars), el supervisor usa ese directorio en lugar de `~/.claude` y se ejecuta como una instancia separada con sus propias sesiones.

890 892 

891| Ruta | Contenidos |893| Ruta | Contenidos |

892| :- | :- |894| :- | :- |

893| `~/.claude/daemon.log` | Registro del supervisor |895| `~/.claude/daemon.log` | Registro del supervisor |

894| `~/.claude/daemon/roster.json` | Lista de sesiones en segundo plano en ejecución, utilizada para reconectarse después de un reinicio |896| `~/.claude/daemon/roster.json` | Lista de sesiones en segundo plano en ejecución, utilizada para reconectarse después de un reinicio |

895| `~/.claude/jobs/<id>/state.json` | Estado por sesión mostrado en la vista de agentes. Léalo a través de [`claude agents --json`](#read-session-state-from-a-script) en lugar de analizar el archivo |897| `~/.claude/jobs/<id>/state.json` | Estado por sesión mostrado en la vista de agentes. Léelo a través de [`claude agents --json`](#read-session-state-from-a-script) en lugar de analizar el archivo |

896| `~/.claude/jobs/<id>/tmp/` | Directorio de trabajo temporal por sesión. Las llamadas `Write` y `Edit` de Claude aquí no solicitan permiso. Se elimina cuando se elimina la sesión |898| `~/.claude/jobs/<id>/tmp/` | Directorio de trabajo temporal por sesión. Las llamadas `Write` y `Edit` de Claude aquí no solicitan permiso. Se elimina cuando se elimina la sesión |

897 899 

898Cada sesión en segundo plano tiene la variable de entorno `CLAUDE_JOB_DIR` establecida en su directorio `~/.claude/jobs/<id>`, por lo que los comandos de shell que ejecuta la sesión pueden escribir archivos temporales en `$CLAUDE_JOB_DIR/tmp` sin colisionar con sesiones paralelas.900Cada sesión en segundo plano tiene la variable de entorno `CLAUDE_JOB_DIR` establecida en su directorio `~/.claude/jobs/<id>`, por lo que los comandos de shell que ejecuta la sesión pueden escribir archivos temporales en `$CLAUDE_JOB_DIR/tmp` sin colisionar con sesiones paralelas.

899 901 

900Para inspeccionar este estado sin leer los archivos directamente, ejecute `claude daemon status`. Informa si el supervisor es accesible, su ID de proceso y versión, el directorio de socket y cuántas sesiones en segundo plano están activas.902Para inspeccionar este estado sin leer los archivos directamente, ejecuta `claude daemon status`. Informa si el supervisor es accesible, su ID de proceso y versión, el directorio de socket y cuántas sesiones en segundo plano están activas.

901 903 

902El comando también advierte cuando el supervisor en ejecución está en una versión diferente a la de `claude` que invocó, lo que sucede después de una actualización en la que el supervisor aún no se ha reiniciado. La advertencia muestra ambas versiones y le indica que ejecute `claude daemon stop --any` para adoptar la nueva versión. Cuando Claude Code se instala como un servicio del sistema operativo, el comando sugerido es `claude daemon stop` sin la bandera.904El comando también advierte cuando el supervisor en ejecución está en una versión diferente a la de `claude` que invocaste, lo que sucede después de una actualización en la que el supervisor aún no se ha reiniciado. La advertencia muestra ambas versiones y te indica que ejecutes `claude daemon stop --any` para adoptar la nueva versión. Cuando Claude Code se instala como un servicio del sistema operativo, el comando sugerido es `claude daemon stop` sin el flag.

903 905 

904Las sesiones sobreviven a ese desajuste de versión intactas: una versión anterior de Claude Code que actualiza el `state.json` de una sesión preserva campos que no reconoce y mantiene la sesión listada. La lista de sesiones en `roster.json` sigue la misma regla, por lo que las sesiones iniciadas por la versión más nueva permanecen accesibles y continúan aceptando entrada después de que el supervisor se reinicia.906Las sesiones sobreviven intactas a ese desajuste de versión: una versión anterior de Claude Code que actualiza el `state.json` de una sesión preserva campos que no reconoce y mantiene la sesión listada. La lista de sesiones en `roster.json` sigue la misma regla, por lo que las sesiones iniciadas por la versión más nueva permanecen accesibles y continúan aceptando entrada después de que el supervisor se reinicia.

905 907 

906<h3 id="turn-off-agent-view">908<h3 id="turn-off-agent-view">

907 Desactivar la vista de agentes909 Desactivar la vista de agentes

908</h3>910</h3>

909 911 

910Para desactivar completamente los agentes en segundo plano y la vista de agentes, establezca la configuración `disableAgentView` [setting](/docs/es/settings) en `true` o establezca la variable de entorno `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Los administradores pueden aplicar esto a través de [configuraciones administradas](/docs/es/managed-settings).912Para desactivar completamente los agentes en segundo plano y la vista de agentes, establece el [ajuste](/docs/es/settings) `disableAgentView` en `true` o establece la variable de entorno `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Los administradores pueden aplicar esto a través de la [configuración administrada](/docs/es/managed-settings).

911 913 

912<h2 id="troubleshooting">914<h2 id="troubleshooting">

913 Solución de problemas915 Solución de problemas


917 `claude agents` enumera subagentes en lugar de abrir la vista de agentes919 `claude agents` enumera subagentes en lugar de abrir la vista de agentes

918</h3>920</h3>

919 921 

920Si `claude agents` imprime un recuento seguido de sus subagentes configurados y luego sale, la vista de agentes no está disponible en su entorno. Ejecute `claude update` para instalar la versión más reciente.922Si `claude agents` imprime un recuento seguido de tus subagentes configurados y luego sale, la vista de agentes no está disponible en tu entorno. Ejecuta `claude update` para instalar la versión más reciente.

921 923 

922Si la vista de agentes aún no se abre después de actualizar, verifique si ha sido [desactivada](#turn-off-agent-view) por una configuración o variable de entorno.924Si la vista de agentes aún no se abre después de actualizar, verifica si ha sido [desactivada](#turn-off-agent-view) por un ajuste o una variable de entorno.

923 925 

924<h3 id="agent-view-opens-with-no-sessions">926<h3 id="agent-view-opens-with-no-sessions">

925 La vista de agentes se abre sin sesiones927 La vista de agentes se abre sin sesiones

926</h3>928</h3>

927 929 

928Antes de distribuir su primera sesión, la vista de agentes muestra las secciones de encabezado vacías con una descripción debajo de cada una, más una explicación de una línea encima de la entrada, en lugar de la lista de sesiones. Escriba un mensaje en la entrada en la parte inferior y presione `Enter` para distribuir su primera sesión.930Antes de distribuir tu primera sesión, la vista de agentes muestra las secciones de encabezado vacías con una descripción debajo de cada una, más una explicación de una línea encima de la entrada, en lugar de la lista de sesiones. Escribe un prompt en la entrada en la parte inferior y presiona `Enter` para distribuir tu primera sesión.

929 931 

930<h3 id="backgrounding-shows-a-background-this-session-dialog">932<h3 id="backgrounding-shows-a-background-this-session-dialog">

931 Backgrounding muestra un diálogo `Background this session?`933 Enviar al segundo plano muestra un diálogo `Background this session?`

932</h3>934</h3>

933 935 

934Si presiona `←` para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo `Background this session?`, la sesión tiene trabajo en vuelo que el backgrounding detendría, reiniciaría o dejaría ejecutándose desatendido, y Claude Code pregunta antes de hacer cualquiera de esos:936Si presionas `←` para enviar al segundo plano la sesión actual y Claude Code muestra un diálogo `Background this session?`, la sesión tiene trabajo en curso que enviarla al segundo plano detendría, reiniciaría o dejaría ejecutándose sin supervisión, y Claude Code pregunta antes de hacer cualquiera de esas cosas:

935 937 

936* **Trabajo que no se puede mover**: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución. El diálogo nombra el trabajo que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.938* **Trabajo que no se puede mover**: la sesión tiene trabajo que no se puede mover a la sesión en segundo plano, como un [monitor](/docs/es/tools-reference#monitor-tool) en ejecución. El diálogo nombra el trabajo que Claude Code detendría y, por separado, cuenta las tareas que se trasladan.

937* **Un flujo de trabajo con subagentes en ejecución**: un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.939* **Un flujo de trabajo con subagentes en ejecución**: un [flujo de trabajo dinámico](/docs/es/workflows) aún tiene subagentes en ejecución. El flujo de trabajo en sí se traslada, pero sus subagentes en ejecución se reinician desde el principio, y el diálogo dice cuántos.

938* **Respuestas automáticas de artefactos**: Claude está [respondiendo a comentarios en un artefacto por su cuenta](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own). Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo dice.940* **Respuestas automáticas de artefactos**: Claude está [respondiendo a comentarios en un artefacto por su cuenta](/docs/es/artifacts#let-claude-reply-to-comments-on-its-own). Esas respuestas continúan en la sesión en segundo plano, y el diálogo lo indica.

939 941 

940Ejecute `/tasks` para ver todo lo que se está ejecutando, luego confirme para enviar al segundo plano de todas formas o elija `Stay` para dejar que el trabajo termine primero. Consulte [Qué se traslada cuando envía al segundo plano](#what-carries-over-when-you-background) para saber qué tipos de trabajo se trasladan y cuáles Claude Code detiene.942Ejecuta `/tasks` para ver todo lo que se está ejecutando, luego confirma para enviar al segundo plano de todas formas o elige `Stay` para dejar que el trabajo termine primero. Consulta [Qué se traslada cuando envías al segundo plano](#what-carries-over-when-you-background) para saber qué tipos de trabajo se trasladan y cuáles detiene Claude Code.

941 943 

942<h3 id="prompt-rejected-as-too-short">944<h3 id="prompt-rejected-as-too-short">

943 Mensaje rechazado por ser demasiado corto945 Prompt rechazado por ser demasiado corto

944</h3>946</h3>

945 947 

946La entrada de distribución espera una descripción de tarea, no un abridor conversacional. Un mensaje más corto de cuatro caracteres se rechaza con una sugerencia `Too short` para que una pulsación de tecla extraviada no inicie una sesión. Describa lo que desea que haga la sesión, como `investigate the flaky checkout test`.948La entrada de distribución espera una descripción de tarea, no un saludo conversacional. Un prompt de menos de cuatro caracteres se rechaza con una sugerencia `Too short` para que una pulsación de tecla accidental no inicie una sesión. Describe lo que quieres que haga la sesión, como `investigate the flaky checkout test`.

947 949 

948<h3 id="sessions-show-as-failed-after-shutdown">950<h3 id="sessions-show-as-failed-after-shutdown">

949 Las sesiones se muestran como fallidas o detenidas después del apagado951 Las sesiones se muestran como fallidas o detenidas después del apagado

950</h3>952</h3>

951 953 

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

953 955 

954* Dentro de 48 horas, la sesión se muestra como fallida. Conéctese, eche un vistazo o responda a ella y se reiniciará desde donde se quedó.956* Dentro de las 48 horas, la sesión se muestra como fallida. Conéctate o responde a ella y se reiniciará desde donde se quedó.

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

956 958 

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

958 960 

959El sueño solo no detiene las sesiones. Las sesiones se conservan durante el sueño y el supervisor se reconecta a ellas al despertar.961La suspensión por sí sola no detiene las sesiones. Las sesiones se conservan durante la suspensión y el supervisor se reconecta a ellas al reactivarse.

960 962 

961<h3 id="opening-a-session-says-the-conversation-is-already-open">963<h3 id="opening-a-session-says-the-conversation-is-already-open">

962 Abrir una sesión dice que la conversación ya está abierta964 Abrir una sesión dice que la conversación ya está abierta

963</h3>965</h3>

964 966 

965Dos procesos no pueden escribir en la misma transcripción. Cuando la conversación guardada de una sesión detenida ya está abierta en otro proceso Claude Code en vivo, Claude Code se niega a iniciar el proceso de la sesión. Lo que ve depende de lo que mantenga la conversación:967Dos procesos no pueden escribir en la misma transcripción. Cuando la conversación guardada de una sesión detenida ya está abierta en otro proceso de Claude Code activo, Claude Code se niega a iniciar el proceso propio de la sesión. Lo que ves depende de qué tiene abierta la conversación:

966 968 

967* Una terminal donde reanudó la conversación, por ejemplo con `claude --resume` o `/resume`: la fila muestra `Open in a terminal` con una sugerencia para continuarla allí, y abrir la fila muestra `Can't open — this session is running in another terminal`. Continúe en esa terminal, o salga de ella y abra la fila nuevamente.969* Una terminal donde reanudaste la conversación, por ejemplo con `claude --resume` o `/resume`: la fila muestra `Open in a terminal` con una sugerencia para continuarla allí, y abrir la fila muestra `Can't open — this session is running in another terminal`. Continúa en esa terminal, o sal de ella y abre la fila nuevamente.

968* Otro proceso Claude Code no interactivo, por ejemplo un proceso de sesión en segundo plano para la misma conversación que aún no ha salido: abrir la fila muestra `This conversation is already open in another running Claude session`. Use ese proceso, o espere a que salga y abra la fila nuevamente.970* Otro proceso de Claude Code no interactivo, por ejemplo un proceso de sesión en segundo plano para la misma conversación que aún no ha salido: abrir la fila muestra `This conversation is already open in another running Claude session`. Usa ese proceso, o espera a que salga y abre la fila nuevamente.

969 971 

970Claude Code guarda una respuesta que escribió con el intento rechazado y la envía la próxima vez que se inicia la sesión.972Claude Code guarda una respuesta que escribiste con el intento rechazado y la envía la próxima vez que se inicia la sesión.

971 973 

972<h3 id="opening-a-session-says-it-has-no-saved-transcript">974<h3 id="opening-a-session-says-it-has-no-saved-transcript">

973 Abrir una sesión dice que no tiene transcripción guardada975 Abrir una sesión dice que no tiene transcripción guardada

974</h3>976</h3>

975 977 

976Una sesión detenida que fue [enviada al segundo plano desde otra conversación](#from-inside-a-session) y se detuvo antes de que su primera respuesta terminara no tiene nada que reanudar: hasta que esa primera respuesta termine, la conversación aún vive solo en la sesión desde la que fue enviada al segundo plano. `claude attach` se niega a abrirla con `This session has no saved transcript`.978Una sesión detenida que fue [enviada al segundo plano desde otra conversación](#from-inside-a-session) y se detuvo antes de que terminara su primera respuesta no tiene nada que reanudar: hasta que esa primera respuesta termine, la conversación aún vive solo en la sesión desde la que fue enviada al segundo plano. `claude attach` se niega a abrirla con `This session has no saved transcript`.

977 979 

978En la vista de agentes, abrir esa fila muestra `Press enter again to restart this session fresh` debajo de la lista. Presione `Enter` en la misma fila nuevamente para reiniciar la sesión con una conversación vacía, o ejecute `claude respawn <id>` desde el shell.980En la vista de agentes, abrir esa fila muestra `Press enter again to restart this session fresh` debajo de la lista. Presiona `Enter` en la misma fila nuevamente para reiniciar la sesión con una conversación vacía, o ejecuta `claude respawn <id>` desde el shell.

979 981 

980La conversación original está intacta; reanúdela con `claude --resume` o continúe trabajando en ella. Consulte la [referencia de errores](/docs/es/errors#this-session-has-no-saved-transcript) para obtener detalles.982La conversación original está intacta; reanúdala con `claude --resume` o sigue trabajando en ella. Consulta la [referencia de errores](/docs/es/errors#this-session-has-no-saved-transcript) para obtener detalles.

981 983 

982<h3 id="the-terminal-host-died-or-the-session-stopped-responding">984<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

983 El host de terminal murió o la sesión dejó de responder985 El host de terminal murió o la sesión dejó de responder


985 987 

986El [supervisor](#the-supervisor-process) ejecuta la terminal de cada sesión en segundo plano en su propio proceso host. Cuando ese proceso muere o deja de responder, Claude Code muestra la razón y ofrece un reinicio; en ambos casos la conversación se guarda y el reinicio la reanuda. La [referencia de errores](/docs/es/errors#terminal-host-process-died) cita los mensajes completos.988El [supervisor](#the-supervisor-process) ejecuta la terminal de cada sesión en segundo plano en su propio proceso host. Cuando ese proceso muere o deja de responder, Claude Code muestra la razón y ofrece un reinicio; en ambos casos la conversación se guarda y el reinicio la reanuda. La [referencia de errores](/docs/es/errors#terminal-host-process-died) cita los mensajes completos.

987 989 

988Claude Code nunca reinicia una fila que ejecuta un [comando shell](#run-a-shell-command), desde `Enter` o desde `claude attach`, porque eso ejecutaría el comando nuevamente; el mensaje de la fila y `claude attach` ambos dicen que el comando no se ejecuta nuevamente.990Claude Code nunca reinicia una fila que ejecuta un [comando de shell](#run-a-shell-command), ni desde `Enter` ni desde `claude attach`, porque eso ejecutaría el comando nuevamente; tanto el mensaje de la fila como `claude attach` indican que el comando no se vuelve a ejecutar.

989 991 

990<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">992<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

991 Una sesión falla antes de iniciarse con una nota `possibly low memory`993 Una sesión falla antes de iniciarse con una nota `possibly low memory`

992</h3>994</h3>

993 995 

994Cuando el proceso de una sesión en segundo plano sale antes de terminar de iniciarse y el host tiene poca memoria, el estado de la fila nombra la salida y añade `possibly low memory — free some up and retry`.996Cuando el proceso de una sesión en segundo plano sale antes de terminar de iniciarse y el host tiene poca memoria del sistema, el estado de la fila nombra la salida y añade `possibly low memory — free some up and retry`.

995 997 

996La nota es una hipótesis, no una causa confirmada. Claude Code la añade solo cuando el proceso salió silenciosamente, sin escribir un error y sin ser detenido por una señal, y el host reportó poca memoria en ese momento. Cuando el proceso escribió un error antes de salir, la fila muestra ese error en su lugar.998La nota es una hipótesis, no una causa confirmada. Claude Code la añade solo cuando el proceso salió silenciosamente, sin escribir un error y sin ser detenido por una señal, y el host reportó poca memoria en ese momento. Cuando el proceso sí escribió un error antes de salir, la fila muestra ese error en su lugar.

997 999 

998Libere memoria en la máquina, luego conéctese, eche un vistazo o responda a la fila y el supervisor inicia un proceso nuevo para la sesión. Cuando la memoria se mantiene baja, el supervisor también [detiene las sesiones inactivas](#the-supervisor-process) para liberar recursos por su cuenta, y detiene las sesiones fijadas inactivas también si detener las otras no liberó nada.1000Libera memoria en la máquina, luego conéctate o responde a la fila y el supervisor inicia un proceso nuevo para la sesión. Cuando la memoria sigue siendo baja, el supervisor también [detiene las sesiones inactivas](#the-supervisor-process) para liberar recursos por su cuenta, y detiene también las sesiones fijadas inactivas si detener las demás no liberó nada.

999 1001 

1000<h3 id="agent-view-says-the-background-service-did-not-respond">1002<h3 id="agent-view-says-the-background-service-did-not-respond">

1001 La vista de agentes dice que el servicio en segundo plano no respondió1003 La vista de agentes dice que el servicio en segundo plano no respondió

1002</h3>1004</h3>

1003 1005 

1004Si conectarse, echar un vistazo o `claude logs` reporta que el servicio en segundo plano no respondió, el proceso supervisor probablemente se ha estancado. Deténgalo y deje que el siguiente `claude agents` inicie uno nuevo. Para mantener sus sesiones en segundo plano ejecutándose durante el reinicio, pase `--keep-workers`:1006Si al conectarte, echar un vistazo o usar `claude logs` se reporta que el servicio en segundo plano no respondió, probablemente el proceso supervisor se ha bloqueado. Detenlo y deja que el siguiente `claude agents` inicie uno nuevo. Para mantener tus sesiones en segundo plano en ejecución durante el reinicio, pasa `--keep-workers`:

1005 1007 

1006```bash theme={null}1008```bash theme={null}

1007claude daemon stop --any --keep-workers1009claude daemon stop --any --keep-workers

1008```1010```

1009 1011 

1010El nuevo supervisor se reconecta a las sesiones en ejecución. Sin `--keep-workers`, el comando también termina las sesiones en segundo plano. La bandera `--any` confirma que desea detener un supervisor que se inició bajo demanda en lugar de como un servicio instalado, que es el predeterminado.1012El nuevo supervisor se reconecta a las sesiones en ejecución. Sin `--keep-workers`, el comando también termina las sesiones en segundo plano. El flag `--any` confirma que quieres detener un supervisor que se inició bajo demanda en lugar de como un servicio instalado, que es lo predeterminado.

1011 1013 

1012Un supervisor que se inicia pero no puede aceptar conexiones sale y libera su bloqueo por sí solo, por lo que el siguiente `claude agents` inicia uno nuevo sin este detención manual. Los pasos anteriores se aplican cuando un supervisor en ejecución se estanca.1014Un supervisor que se inicia pero no puede aceptar conexiones sale y libera su bloqueo por sí solo, por lo que el siguiente `claude agents` inicia uno nuevo sin esta detención manual. Los pasos anteriores se aplican cuando un supervisor en ejecución se bloquea.

1013 1015 

1014Si el comando en su lugar sale diciendo que el proceso registrado no pudo verificarse como el supervisor, verifique el ID de proceso reportado: si es un supervisor que posee, deténgalo usted mismo, luego elimine `~/.claude/daemon.lock` para que el siguiente `claude agents` inicie nuevo.1016Si en cambio el comando sale diciendo que el proceso registrado no pudo verificarse como el supervisor, revisa el ID de proceso reportado: si es un supervisor tuyo, detenlo tú mismo y luego elimina `~/.claude/daemon.lock` para que el siguiente `claude agents` inicie desde cero.

1015 1017 

1016En Windows, si el supervisor no responde a la solicitud de detención, el comando imprime su ID de proceso. Termine ese proceso con `taskkill /PID <pid>` para finalizar la recuperación. Las sesiones en segundo plano aún se conservan cuando pasó `--keep-workers`.1018En Windows, si el supervisor no responde a la solicitud de detención, el comando imprime su ID de proceso. Termina ese proceso con `taskkill /PID <pid>` para completar la recuperación. Las sesiones en segundo plano se siguen conservando si pasaste `--keep-workers`.

1017 1019 

1018<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">1020<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

1019 La distribución falla con `Could not resolve authentication method`1021 La distribución falla con `Could not resolve authentication method`

1020</h3>1022</h3>

1021 1023 

1022Si una distribución en segundo plano falla con `Could not resolve authentication method` mientras las sesiones interactivas se autentican normalmente, el worker que recibió la distribución no recogió las credenciales. Las sesiones en segundo plano obtienen sus credenciales del [supervisor](#the-supervisor-process), por lo que este error significa que no había credencial almacenada disponible para el proceso supervisor en sí. Confirme que ha ejecutado `/login` o ha configurado una clave API, luego detenga el supervisor:1024Si una distribución en segundo plano falla con `Could not resolve authentication method` mientras las sesiones interactivas se autentican normalmente, el worker que recibió la distribución no obtuvo las credenciales. Las sesiones en segundo plano obtienen sus credenciales del [supervisor](#the-supervisor-process), por lo que este error significa que no había ninguna credencial almacenada disponible para el propio proceso supervisor. Confirma que ejecutaste `/login` o configuraste una clave de API, luego detén el supervisor:

1023 1025 

1024```bash theme={null}1026```bash theme={null}

1025claude daemon stop --any --keep-workers1027claude daemon stop --any --keep-workers

1026```1028```

1027 1029 

1028El siguiente `claude agents` o `claude --bg` inicia un supervisor nuevo que lee sus credenciales almacenadas. Si se autentica con una variable de entorno como `ANTHROPIC_API_KEY` en lugar de `/login`, ejecute ese comando siguiente desde un shell donde la variable esté configurada.1030El siguiente `claude agents` o `claude --bg` inicia un supervisor nuevo que lee tus credenciales almacenadas. Si te autenticas con una variable de entorno como `ANTHROPIC_API_KEY` en lugar de `/login`, ejecuta ese siguiente comando desde un shell donde la variable esté definida.

1029 1031 

1030Consulte la [referencia de errores](/docs/es/errors#could-not-resolve-authentication-method) para la lista completa de causas y soluciones.1032Consulta la [referencia de errores](/docs/es/errors#could-not-resolve-authentication-method) para ver la lista completa de causas y soluciones.

1031 1033 

1032<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">1034<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

1033 Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS1035 Las sesiones en segundo plano no pueden leer Desktop, Documents o Downloads en macOS

1034</h3>1036</h3>

1035 1037 

1036En macOS, el host de sesión en segundo plano se ejecuta como su propio proceso y solicita acceso a carpetas protegidas por separado desde su terminal. Si una sesión en segundo plano reporta `Operation not permitted` al leer `~/Desktop`, `~/Documents`, `~/Downloads` u otra ubicación protegida, otorgue acceso en Configuración del Sistema bajo Privacidad y Seguridad > Archivos y Carpetas, o habilite Acceso Total al Disco para la entrada.1038En macOS, el host de sesiones en segundo plano se ejecuta como su propio proceso y solicita acceso a las carpetas protegidas por separado de tu terminal. Si una sesión en segundo plano reporta `Operation not permitted` al leer `~/Desktop`, `~/Documents`, `~/Downloads` u otra ubicación protegida, otorga acceso en Configuración del Sistema, en Privacidad y Seguridad > Archivos y Carpetas, o habilita Acceso Total al Disco para la entrada.

1037 1039 

1038Con el instalador nativo, la entrada aparece como Claude Code y la concesión persiste en las actualizaciones. Con otros métodos de instalación como Homebrew o npm, la entrada muestra la ruta del binario y puede necesitar ser otorgada nuevamente después de actualizar.1040Con el instalador nativo, la entrada aparece como Claude Code y el permiso se mantiene entre actualizaciones. Con otros métodos de instalación como Homebrew o npm, la entrada muestra la ruta del binario y es posible que debas otorgar el permiso nuevamente después de actualizar.

1039 1041 

1040<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">1042<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">

1041 Las sesiones en segundo plano no pueden alcanzar hosts de red local en macOS1043 Las sesiones en segundo plano no pueden alcanzar hosts de la red local en macOS

1042</h3>1044</h3>

1043 1045 

1044En macOS 15 y posterior, el sistema bloquea un proceso para que no alcance dispositivos en su red local hasta que otorgue permiso de Red Local, por lo que un comando dirigido a una dirección LAN puede fallar con `connect: no route to host` en una sesión en segundo plano aunque funcione en una terminal en primer plano. El primer comando en una sesión en segundo plano que se conecta a una dirección de red local activa la solicitud de permiso de Red Local de macOS para Claude Code. Otórguelo una vez y esos comandos alcanzarán hosts LAN de la misma manera que lo hacen en una terminal en primer plano.1046En macOS 15 y posteriores, el sistema impide que un proceso acceda a dispositivos de tu red local hasta que otorgues el permiso de Red Local, por lo que un comando dirigido a una dirección LAN puede fallar con `connect: no route to host` en una sesión en segundo plano aunque funcione en una terminal en primer plano. El primer comando en una sesión en segundo plano que se conecta a una dirección de la red local activa la solicitud de permiso de Red Local de macOS para Claude Code. Otórgalo una vez y esos comandos alcanzarán los hosts LAN de la misma manera que en una terminal en primer plano.

1045 1047 

1046<h3 id="a-session-is-slow-to-respond-after-attaching">1048<h3 id="a-session-is-slow-to-respond-after-attaching">

1047 Una sesión es lenta para responder después de conectarse1049 Una sesión tarda en responder después de conectarte

1048</h3>1050</h3>

1049 1051 

1050Una vez que una sesión ha terminado y se ha quedado sin conectar durante aproximadamente una hora, el supervisor detiene su proceso para liberar recursos. Conectarse inicia un proceso nuevo desde donde se quedó y cambia a la sesión inmediatamente mientras el proceso se reinicia. Las sesiones que están funcionando, esperando su entrada o [fijadas](#organize-the-list) no se detienen de esta manera, así que fije una sesión con `Ctrl+T` para mantenerla receptiva.1052Cuando una sesión que ha terminado o que está esperando tu siguiente mensaje permanece sin conexión durante aproximadamente una hora, el supervisor detiene su proceso para liberar recursos. Conectarte inicia un proceso nuevo desde donde se quedó y cambia a la sesión inmediatamente mientras el proceso se reinicia. Las sesiones que están trabajando, en pausa en una solicitud de permiso u otro diálogo, o [fijadas](#organize-the-list) no se detienen de esta manera, así que fija una sesión con `Ctrl+T` para mantenerla receptiva.

1051 1053 

1052Mientras el proceso se inicia, Claude Code muestra la cola de la transcripción de la sesión formateada de la manera que la sesión en vivo la renderiza, con markdown, bloques de código resaltados y llamadas de herramientas como filas atenuadas, encima de un área de mensaje atenuada con una nota `Session is starting`. La sesión en vivo la reemplaza tan pronto como esté lista.1054Mientras el proceso se inicia, Claude Code muestra el final de la transcripción de la sesión con el mismo formato con que la renderiza la sesión activa, con markdown, bloques de código resaltados y llamadas a herramientas como filas atenuadas, encima de un área de prompt atenuada con una nota `Session is starting`. La sesión activa la reemplaza en cuanto está lista.

1053 1055 

1054<h3 id="claude/worktrees/-is-filling-up">1056<h3 id="claude/worktrees/-is-filling-up">

1055 `.claude/worktrees/` se está llenando1057 `.claude/worktrees/` se está llenando

1056</h3>1058</h3>

1057 1059 

1058Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella, pero [algunos deletes mantienen el worktree o dejan su directorio en el disco](#what-deleting-a-session-removes), por lo que los directorios sobrantes pueden acumularse. Los directorios que git ya no reconoce no aparecen en `git worktree list`, así que elimine esos a mano.1060Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella, pero [algunas eliminaciones conservan el worktree o dejan su directorio en el disco](#what-deleting-a-session-removes), por lo que los directorios sobrantes pueden acumularse. Los directorios que git ya no reconoce no aparecen en `git worktree list`, así que elimínalos a mano.

1059 1061 

1060Enumere las entradas sobrantes con `git worktree list` en el directorio del proyecto y elimine cada una con `git worktree remove <path>`. Consulte [Limpiar worktrees](/docs/es/worktrees#clean-up-worktrees).1062Enumera las entradas sobrantes con `git worktree list` en el directorio del proyecto y elimina cada una con `git worktree remove <path>`. Consulta [Limpiar worktrees](/docs/es/worktrees#clean-up-worktrees).

1061 1063 

1062<h2 id="limitations">1064<h2 id="limitations">

1063 Limitaciones1065 Limitaciones


1085 Historial de versiones1087 Historial de versiones

1086</h2>1088</h2>

1087 1089 

1088La vista de agentes ha evolucionado rápidamente durante la vista previa de investigación. Si está en una versión anterior de Claude Code, algunos comportamientos en esta página pueden diferir; en particular, `claude agents` rechaza banderas que aún no admite con un error `unknown option`. La tabla a continuación enumera cuándo se agregó cada bandera y comportamiento.1090La vista de agentes ha evolucionado rápidamente durante la vista previa de investigación. Si estás en una versión anterior de Claude Code, algunos comportamientos en esta página pueden diferir; en particular, `claude agents` rechaza los flags que aún no admite con un error `unknown option`. La tabla a continuación enumera cuándo se agregó cada flag y comportamiento.

1089 1091 

1090| Versión | Cambio |1092| Versión | Cambio |

1091| - | - |1093| - | - |

1094| v2.1.290 | [`claude attach` y `claude logs`](#manage-sessions-from-the-shell) pueden recibir parte del nombre de una sesión en ejecución en lugar del ID. |

1092| v2.1.288 | `Ctrl+F` encuentra sesiones por nombre, y `Alt+↑` / `Alt+↓` saltan entre los encabezados de grupo. Ambos, y `Ctrl+R`, se pueden [reasignar](/docs/es/keybindings#agents-actions). |1095| v2.1.288 | `Ctrl+F` encuentra sesiones por nombre, y `Alt+↑` / `Alt+↓` saltan entre los encabezados de grupo. Ambos, y `Ctrl+R`, se pueden [reasignar](/docs/es/keybindings#agents-actions). |

1093| v2.1.287 | El [filtro `n:<text>`](#filter-sessions) encuentra sesiones por nombre o por primer prompt. Mientras cualquier filtro está activo, los grupos que contrajiste se expanden para mostrar sus coincidencias y se selecciona la primera coincidencia, por lo que `Enter` la abre. |1096| v2.1.287 | El [filtro `n:<text>`](#filter-sessions) encuentra sesiones por nombre o por primer prompt. Mientras cualquier filtro está activo, los grupos que contrajiste se expanden para mostrar sus coincidencias y se selecciona la primera coincidencia, por lo que `Enter` la abre. |

1094| v2.1.287 | Un comando enviado como [respuesta desde el panel de vista previa](#peek-and-reply) se ejecuta cuando termina el turno actual de la sesión, incluidos los comandos que se ejecutan en cuanto los escribes en el propio prompt de una sesión. Una respuesta que es exactamente `/stop` detiene la sesión de inmediato. |1097| v2.1.287 | Un comando enviado como [respuesta desde el panel de vista previa](#peek-and-reply) se ejecuta cuando termina el turno actual de la sesión, incluidos los comandos que se ejecutan en cuanto los escribes en el propio prompt de una sesión. Una respuesta que es exactamente `/stop` detiene la sesión de inmediato. |

1095| v2.1.281 | Una restricción [`--setting-sources`](/docs/es/cli-reference#cli-flags) [se traslada](#what-carries-over-when-you-background) a una sesión que envía al segundo plano con `←` o `/bg` y a las sesiones que distribuye desde la vista de agentes. Antes de esta versión, la sesión generada cargaba cada fuente de configuración. |1098| v2.1.281 | Una restricción [`--setting-sources`](/docs/es/cli-reference#cli-flags) [se traslada](#what-carries-over-when-you-background) a una sesión que envías al segundo plano con `←` o `/bg` y a las sesiones que distribuyes desde la vista de agentes. Antes de esta versión, la sesión generada cargaba cada fuente de configuración. |

1096| v2.1.281 | `claude --bg`, y los comandos que reinician una sesión, verifican la confianza del espacio de trabajo para el directorio de la sesión primero. Desde una terminal en ese directorio, [el diálogo de confianza aparece](#from-your-shell) si no lo ha aceptado; donde no puede aparecer ningún diálogo, como en un script, el comando sale con un error [`Workspace not trusted`](/docs/es/errors#workspace-not-trusted-when-dispatching-a-background-session). |1099| v2.1.281 | `claude --bg`, y los comandos que reinician una sesión, verifican primero la confianza del espacio de trabajo para el directorio de la sesión. Desde una terminal en ese directorio, [el diálogo de confianza aparece](#from-your-shell) si no lo has aceptado; donde no puede aparecer ningún diálogo, como en un script, el comando sale con un error [`Workspace not trusted`](/docs/es/errors#workspace-not-trusted-when-dispatching-a-background-session). |

1097| v2.1.274 | Después de una auto-actualización, una vista de agentes de la que ha estado ausente durante aproximadamente una hora puede relanzarse a sí misma en la nueva compilación. Cuando lo hace, mantiene los [valores predeterminados de distribución](#dispatch-defaults) con los que la abrió: `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions` y `--agent`. Antes de esta versión, la vista relanzada mantenía solo `--cwd` y banderas de configuración como `--settings` y `--mcp-config`, por lo que las sesiones que distribuía después comenzaban sin esos valores predeterminados. |1100| v2.1.274 | Después de una actualización automática, una vista de agentes de la que has estado ausente durante aproximadamente una hora puede relanzarse a sí misma en la nueva compilación. Cuando lo hace, mantiene los [valores predeterminados de distribución](#dispatch-defaults) con los que la abriste: `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions` y `--agent`. Antes de esta versión, la vista relanzada mantenía solo `--cwd` y flags de configuración como `--settings` y `--mcp-config`, por lo que las sesiones que distribuías después comenzaban sin esos valores predeterminados. |

1098| v2.1.274 | Cuando una [eliminación se rechaza](#what-deleting-a-session-removes) porque git o su hook `WorktreeRemove` no pudieron eliminar el worktree, un submódulo verificado que Claude Code verifica que no tiene cambios sin confirmar en archivos rastreados no bloquea la oferta de eliminar nuevamente y eliminar el directorio de todas formas. El trabajo sin confirmar dentro de un submódulo verificado cuenta como cambios sin confirmar, y el mensaje nombra el submódulo. Antes de esta versión, cualquier verificación de submódulo en el worktree bloqueaba la oferta, con un mensaje diciendo que el worktree contiene un repositorio anidado. |1101| v2.1.274 | Cuando una [eliminación se rechaza](#what-deleting-a-session-removes) porque git o tu hook `WorktreeRemove` no pudieron eliminar el worktree, un submódulo con checkout que Claude Code verifica que no tiene cambios sin confirmar en archivos rastreados no bloquea la oferta de eliminar nuevamente y eliminar el directorio de todas formas. El trabajo sin confirmar dentro de un submódulo con checkout cuenta como cambios sin confirmar, y el mensaje nombra el submódulo. Antes de esta versión, cualquier checkout de submódulo en el worktree bloqueaba la oferta, con un mensaje diciendo que el worktree contiene un repositorio anidado. |

1099| v2.1.268 | Cuando una [eliminación se rechaza](#what-deleting-a-session-removes) porque git o su hook `WorktreeRemove` no pudieron eliminar el worktree, el mensaje nombra la causa, incluyendo cómo terminó un hook y el inicio de su stderr. Para un worktree vinculado bajo el directorio `.claude/worktrees/` del repositorio sin cambios sin confirmar en archivos rastreados, sin repositorio anidado dentro de él, y sin que el registro de otra sesión lo nombre, eliminar la sesión nuevamente elimina el directorio de todas formas, desde la vista de agentes o con `claude rm <id> --force-remove-worktree <worktree-id>`. Antes de esta versión, la fila mostraba solo `worktree could not be removed (WorktreeRemove hook failed)` o el error de git, el stderr del hook iba solo al registro de depuración, y eliminar nuevamente se rechazaba de la misma manera. |1102| v2.1.268 | Cuando una [eliminación se rechaza](#what-deleting-a-session-removes) porque git o tu hook `WorktreeRemove` no pudieron eliminar el worktree, el mensaje nombra la causa, incluyendo cómo terminó un hook y el inicio de su stderr. Para un worktree vinculado bajo el directorio `.claude/worktrees/` del repositorio sin cambios sin confirmar en archivos rastreados, sin repositorio anidado dentro de él, y sin que el registro de otra sesión lo nombre, eliminar la sesión nuevamente elimina el directorio de todas formas, desde la vista de agentes o con `claude rm <id> --force-remove-worktree <worktree-id>`. Antes de esta versión, la fila mostraba solo `worktree could not be removed (WorktreeRemove hook failed)` o el error de git, el stderr del hook iba solo al registro de depuración, y eliminar nuevamente se rechazaba de la misma manera. |

1100| v2.1.268 | Después de que la primera `←` muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, [el primer presionar que llega al menos un segundo después cambia](#switch-sessions-without-leaving-the-terminal), incluso cuando los presionamientos más rápidos entre medias fueron ignorados. Antes de esta versión, cada presionar ignorado reiniciaba la espera, por lo que presionar `←` nuevamente a un ritmo constante no cambiaba hasta que pausaba durante más de un segundo. |1103| v2.1.268 | Después de que la primera `←` muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, [la primera pulsación que llega al menos un segundo después cambia](#switch-sessions-without-leaving-the-terminal), incluso cuando las pulsaciones más rápidas entre medias fueron ignoradas. Antes de esta versión, cada pulsación ignorada reiniciaba la espera, por lo que presionar `←` nuevamente a un ritmo constante no cambiaba hasta que pausabas durante más de un segundo. |

1101| v2.1.260 | Cuando [envía una sesión al segundo plano](#from-inside-a-session), el [listado de agentes](/docs/es/cross-session-messaging#see-which-sessions-claude-can-reach) de sus otras sesiones muestra la conversación una vez, como su sesión de fondo, y sus mensajes a ella ya no llegan a la terminal desde la que la movió. Antes de esta versión, esa terminal podría permanecer listada como una segunda sesión interactiva bajo el nombre de la conversación, y una sesión que había enviado un mensaje a la conversación antes del movimiento continuaba entregando a esa terminal. |1104| v2.1.260 | Cuando [envías una sesión al segundo plano](#from-inside-a-session), el [listado de agentes](/docs/es/cross-session-messaging#see-which-sessions-claude-can-reach) de tus otras sesiones muestra la conversación una vez, como su sesión en segundo plano, y sus mensajes a ella ya no llegan a la terminal desde la que la moviste. Antes de esta versión, esa terminal podía permanecer listada como una segunda sesión interactiva bajo el nombre de la conversación, y una sesión que había enviado un mensaje a la conversación antes del movimiento continuaba entregando a esa terminal. |

1102| v2.1.260 | Cuando una [eliminación se rechaza sobre commits sin enviar](#what-deleting-a-session-removes), el mensaje nombra la rama del worktree y cuántos commits no se han enviado, y eliminar la sesión nuevamente descarta el worktree y sus commits. Antes de esta versión, el rechazo decía solo `worktree has commits that are not pushed anywhere`, eliminar nuevamente se rechazaba de la misma manera, y eliminar la sesión requería enviar los commits o eliminar el worktree manualmente. |1105| v2.1.260 | Cuando una [eliminación se rechaza por commits sin enviar](#what-deleting-a-session-removes), el mensaje nombra la rama del worktree y cuántos commits no se han enviado, y eliminar la sesión nuevamente descarta el worktree y sus commits. Antes de esta versión, el rechazo decía solo `worktree has commits that are not pushed anywhere`, eliminar nuevamente se rechazaba de la misma manera, y eliminar la sesión requería enviar los commits o eliminar el worktree manualmente. |

1103| v2.1.257 | `←` [se desadjunta de una sesión adjunta mientras la superposición `/btw` está abierta](#attach-to-a-session), incluso a mitad de respuesta, y la superposición se reabre cuando se adjunta nuevamente. Antes de esta versión, `←` no se desadjuntaba mientras la superposición estaba abierta. |1106| v2.1.257 | `←` [se desadjunta de una sesión adjunta mientras la superposición `/btw` está abierta](#attach-to-a-session), incluso a mitad de respuesta, y la superposición se reabre cuando te adjuntas nuevamente. Antes de esta versión, `←` no se desadjuntaba mientras la superposición estaba abierta. |

1104| v2.1.257 | Cuando ejecuta [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continúa esa sesión bajo su propio ID, o inicia una copia bajo un nuevo ID e imprime una línea `note:` explicando por qué. `--continue`, un `--resume` desnudo, y `--resume` con un nombre o ruta inician una copia con la misma nota. Antes de esta versión, `--resume` con `--bg` siempre iniciaba una copia bajo un nuevo ID y no decía nada. |1107| v2.1.257 | Cuando ejecutas [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continúa esa sesión bajo su propio ID, o inicia una copia bajo un nuevo ID e imprime una línea `note:` explicando por qué. `--continue`, un `--resume` sin argumentos, y `--resume` con un nombre o ruta inician una copia con la misma nota. Antes de esta versión, `--resume` con `--bg` siempre iniciaba una copia bajo un nuevo ID y no decía nada. |

1105| v2.1.257 | Cuando distribuye una sesión desde una vista de agentes que abrió con `←`, Claude Code la inicia en [el modo de permiso que el directorio de destino configura](#permission-mode) a través de `permissions.defaultMode`. Cuando el directorio no establece uno, se aplica el modo de permiso de la sesión de la que vino. Antes de esta versión, la sesión distribuida siempre se iniciaba en el modo de permiso de la sesión de la que vino, anulándolo. |1108| v2.1.257 | Cuando distribuyes una sesión desde una vista de agentes que abriste con `←`, Claude Code la inicia en [el modo de permisos que el directorio de destino configura](#permission-mode) a través de `permissions.defaultMode`. Cuando el directorio no establece uno, se aplica el modo de permisos de la sesión de la que viniste. Antes de esta versión, la sesión distribuida siempre se iniciaba en el modo de permisos de la sesión de la que viniste, sobrescribiéndolo. |

1106| v2.1.257 | `Ctrl+S`, `Ctrl+T` y `Ctrl+G` en la vista de agentes [siguen su `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` y `Ctrl+T` a través de las acciones `agents:switchView` y `agents:togglePin` del contexto `Agents`, y `Ctrl+G` a través del enlace `chat:externalEditor` del contexto `Chat`. Antes de esta versión, la vista de agentes ignoraba `keybindings.json` y estas teclas eran fijas. |1109| v2.1.257 | `Ctrl+S`, `Ctrl+T` y `Ctrl+G` en la vista de agentes [siguen tu `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` y `Ctrl+T` a través de las acciones `agents:switchView` y `agents:togglePin` del contexto `Agents`, y `Ctrl+G` a través del atajo `chat:externalEditor` del contexto `Chat`. Antes de esta versión, la vista de agentes ignoraba `keybindings.json` y estas teclas eran fijas. |

1107| v2.1.257 | Iniciar el [servicio de fondo](#the-supervisor-process) se recupera de dos causas de fallo. En una instalación de npm en macOS, un inicio durante una auto-actualización [espera a que la instalación termine](/docs/es/errors#eacces-when-starting-a-background-session) en lugar de ejecutar el marcador de posición que npm coloca mientras reemplaza el binario. En Windows, un `daemon.lock` obsoleto escrito antes del último arranque de la máquina, o cuyo ID de proceso registrado ahora pertenece a un proceso diferente, se reemplaza. Antes de esta versión, el inicio en macOS falló con `Error: claude native binary not installed.` durante la ventana de instalación, y el bloqueo en Windows hizo que cada inicio fallara con [`exited before it became reachable`](/docs/es/errors#background-service-exited-before-it-became-reachable) hasta que eliminó `~/.claude/daemon.lock`. |1110| v2.1.257 | Iniciar el [servicio en segundo plano](#the-supervisor-process) se recupera de dos causas de fallo. En una instalación de npm en macOS, un inicio durante una actualización automática [espera a que la instalación termine](/docs/es/errors#eacces-when-starting-a-background-session) en lugar de ejecutar el marcador de posición que npm coloca mientras reemplaza el binario. En Windows, un `daemon.lock` obsoleto escrito antes del último arranque de la máquina, o cuyo ID de proceso registrado ahora pertenece a un proceso diferente, se reemplaza. Antes de esta versión, el inicio en macOS fallaba con `Error: claude native binary not installed.` durante la ventana de instalación, y el bloqueo en Windows hacía que cada inicio fallara con [`exited before it became reachable`](/docs/es/errors#background-service-exited-before-it-became-reachable) hasta que eliminabas `~/.claude/daemon.lock`. |

1108| v2.1.257 | Cuando abre o distribuye una sesión de fondo mientras otro proceso de Claude Code está descargando una actualización de npm, Claude Code [continúa esperando hasta dos minutos](/docs/es/errors#eacces-when-starting-a-background-session) mientras se ejecuta la instalación, luego falla diciendo `Claude Code is being updated by npm on this machine`. Antes de esta versión, la espera se detenía a los diez segundos, por lo que la apertura falló con `Couldn't start the background service` mientras la descarga aún se estaba ejecutando. |1111| v2.1.257 | Cuando abres o distribuyes una sesión en segundo plano mientras otro proceso de Claude Code está descargando una actualización de npm, Claude Code [continúa esperando hasta dos minutos](/docs/es/errors#eacces-when-starting-a-background-session) mientras se ejecuta la instalación, y luego falla diciendo `Claude Code is being updated by npm on this machine`. Antes de esta versión, la espera se detenía a los diez segundos, por lo que la apertura fallaba con `Couldn't start the background service` mientras la descarga aún se estaba ejecutando. |

1109| v2.1.257 | Una sesión de fondo que sostiene un [mensaje entre sesiones](/docs/es/cross-session-messaging#control-inbound-messages) para su aprobación muestra `approve message from` en su fila `Needs input`, con la dirección del remitente y el nombre que el remitente reclama. Antes de esta versión, la fila se movía a `Needs input` pero mantenía su texto anterior, por lo que nada en `claude agents` nombraba el mensaje esperado o su remitente. |1112| v2.1.257 | Una sesión en segundo plano que retiene un [mensaje entre sesiones](/docs/es/cross-session-messaging#control-inbound-messages) para tu aprobación muestra `approve message from` en su fila `Needs input`, con la dirección del remitente y el nombre que el remitente declara. Antes de esta versión, la fila se movía a `Needs input` pero mantenía su texto anterior, por lo que nada en `claude agents` nombraba el mensaje en espera ni su remitente. |

1110| v2.1.257 | Un prompt guardado con `Ctrl+S` dentro de una sesión de fondo abierta [se mantiene con la sesión](#what-persists-across-restarts), por lo que `Ctrl+S` lo restaura después de que el proceso de la sesión se detiene e inicia nuevamente. Antes de esta versión, el almacenamiento vivía solo en el proceso en ejecución y se perdía cuando la sesión se quedaba inactiva el tiempo suficiente para que su proceso se detuviera, o cuando se detenía y luego se reabriera. |1113| v2.1.257 | Un prompt guardado con `Ctrl+S` dentro de una sesión en segundo plano abierta [se mantiene con la sesión](#what-persists-across-restarts), por lo que `Ctrl+S` lo restaura después de que el proceso de la sesión se detiene y se inicia nuevamente. Antes de esta versión, lo guardado vivía solo en el proceso en ejecución y se perdía cuando la sesión quedaba inactiva el tiempo suficiente para que su proceso se detuviera, o cuando se detenía y luego se reabría. |

1111| v2.1.251 | En una sesión de fondo que no ha [entrado en un worktree](#how-file-edits-are-isolated), Claude y los subagentes que genera pueden editar archivos dentro de un worktree de git vinculado. |1114| v2.1.251 | En una sesión en segundo plano que no ha [entrado en un worktree](#how-file-edits-are-isolated), Claude y los subagentes que genera pueden editar archivos dentro de un worktree de git vinculado. |

1112| v2.1.251 | Claude Code reenvía una puerta de enlace de proveedor de nube exportada en el shell desde el que distribuye, como `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con su bandera de bypass de autenticación, al [worker de la sesión](#llm-gateway) bajo las mismas condiciones que `ANTHROPIC_BASE_URL`. Antes de esta versión, si enviaba al segundo plano o distribuía desde un shell autenticado solo a través de tal puerta de enlace, cada solicitud que la sesión realizaba fallaba, porque el punto final y la bandera se eliminaban de su entorno. |1115| v2.1.251 | Claude Code reenvía un gateway de proveedor de nube exportado en el shell desde el que distribuyes, como `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con su flag de bypass de autenticación, al [worker de la sesión](#llm-gateway) bajo las mismas condiciones que `ANTHROPIC_BASE_URL`. Antes de esta versión, si enviabas al segundo plano o distribuías desde un shell autenticado solo a través de tal gateway, cada solicitud que la sesión realizaba fallaba, porque el endpoint y el flag se eliminaban de su entorno. |

1113| v2.1.251 | Cuando una sesión de fondo se inicia mientras otro proceso de Claude Code está actualizando un [marketplace de plugins](/docs/es/plugins/overview), como una sesión hermana ejecutando la [actualización automática del marketplace](/docs/es/plugins/install#keep-plugins-updated), Claude Code mantiene los plugins de ese marketplace disponibles. Antes de esta versión, tal sesión podría iniciarse sin ninguna de las skills, agentes, hooks y servidores MCP de ese marketplace y permanecer así durante toda su ejecución. |1116| v2.1.251 | Cuando una sesión en segundo plano se inicia mientras otro proceso de Claude Code está actualizando un [marketplace de plugins](/docs/es/plugins/overview), como una sesión hermana ejecutando la [actualización automática del marketplace](/docs/es/plugins/install#keep-plugins-updated), Claude Code mantiene disponibles los plugins de ese marketplace. Antes de esta versión, tal sesión podía iniciarse sin ninguno de los skills, agentes, hooks y servidores MCP de ese marketplace y permanecer así durante toda su ejecución. |

1114| v2.1.248 | `Shift+Enter` en la [entrada de distribución](#keyboard-shortcuts) inserta una nueva línea, coincidiendo con el prompt principal, y `Ctrl+Enter` distribuye y se adjunta inmediatamente en terminales donde la superposición `?` enumera `ctrl+enter to start and open`. Antes de esta versión, `Shift+Enter` distribuía y se adjuntaba. |1117| v2.1.248 | `Shift+Enter` en la [entrada de distribución](#keyboard-shortcuts) inserta una nueva línea, igual que el prompt principal, y `Ctrl+Enter` distribuye y se adjunta inmediatamente en terminales donde la superposición `?` enumera `ctrl+enter to start and open`. Antes de esta versión, `Shift+Enter` distribuía y se adjuntaba. |

1115| v2.1.248 | [Eliminar una sesión](#what-deleting-a-session-removes) tiene éxito cuando los commits del worktree ya están en la copia local de la rama predeterminada de su remoto `origin` y su checkout principal tiene esa rama verificada; antes de esta versión, la eliminación se rechazaba con `has commits that are not pushed anywhere`. |1118| v2.1.248 | [Eliminar una sesión](#what-deleting-a-session-removes) tiene éxito cuando los commits del worktree ya están en la copia local de la rama predeterminada de tu remoto `origin` y tu checkout principal tiene esa rama activa; antes de esta versión, la eliminación se rechazaba con `has commits that are not pushed anywhere`. |

1116| v2.1.248 | Una sesión enviada al segundo plano con `←` o `/background` mantiene el [`git worktree lock`](/docs/es/worktrees#clean-up-subagent-and-background-session-worktrees) en su worktree mientras se ejecuta; antes de esta versión, enviar al segundo plano liberaba el bloqueo, y la limpieza o `git worktree remove` podría eliminar el worktree bajo la sesión en ejecución. |1119| v2.1.248 | Una sesión enviada al segundo plano con `←` o `/background` mantiene el [`git worktree lock`](/docs/es/worktrees#clean-up-subagent-and-background-session-worktrees) en su worktree mientras se ejecuta; antes de esta versión, enviar al segundo plano liberaba el bloqueo, y la limpieza o `git worktree remove` podían eliminar el worktree bajo la sesión en ejecución. |

1117| v2.1.248 | Una sesión de fondo que no estaba esperando su entrada y se encuentra muerta más de 48 horas después de su última actividad, como después de que la máquina estuvo apagada durante días, [se muestra como detenida](#sessions-show-as-failed-after-shutdown) con `ended while the background service was off`, y `Enter` en ella pregunta antes de reanudar su conversación guardada. Antes de esta versión, tal sesión reaparecía como un fallo nuevo ordenado en la parte superior de la lista, y un único `Enter` traía la conversación de hace semanas al primer plano. |1120| v2.1.248 | Una sesión en segundo plano que no estaba esperando tu entrada y se encuentra muerta más de 48 horas después de su última actividad, como después de que la máquina estuvo apagada durante días, [se muestra como detenida](#sessions-show-as-failed-after-shutdown) con `ended while the background service was off`, y `Enter` en ella pregunta antes de reanudar su conversación guardada. Antes de esta versión, tal sesión reaparecía como un fallo nuevo ordenado en la parte superior de la lista, y un único `Enter` traía al primer plano la conversación de hace semanas. |

1118| v2.1.248 | Abrir una fila detenida cuya conversación [reanudó en otra terminal](#opening-a-session-says-the-conversation-is-already-open) se rechaza con `Can't open — this session is running in another terminal`, y la fila muestra `Open in a terminal` en lugar de mostrarse bajo `Working`. Antes de esta versión, abrir la fila iniciaba un segundo proceso escribiendo en la misma conversación. |1121| v2.1.248 | Abrir una fila detenida cuya conversación [reanudaste en otra terminal](#opening-a-session-says-the-conversation-is-already-open) se rechaza con `Can't open — this session is running in another terminal`, y la fila muestra `Open in a terminal` en lugar de mostrarse bajo `Working`. Antes de esta versión, abrir la fila iniciaba un segundo proceso escribiendo en la misma conversación. |

1119| v2.1.248 | Una sesión de fondo esperando una decisión de permiso mientras un hook `PermissionRequest` o `PreToolUse` imprimía una respuesta inválida [nombra el evento del hook y el error de esquema en su fila](#peek-and-reply). Antes de esta versión, la fila mostraba solo la solicitud pendiente. |1122| v2.1.248 | Una sesión en segundo plano esperando una decisión de permiso mientras un hook `PermissionRequest` o `PreToolUse` imprimía una respuesta inválida [nombra el evento del hook y el error de esquema en su fila](#peek-and-reply). Antes de esta versión, la fila mostraba solo la solicitud pendiente. |

1120| v2.1.248 | En Windows, `claude agents` responde al teclado cuando se lanza en una pestaña de terminal que un programa anterior dejó en win32-input-mode. Antes de esta versión, Claude Code no decodificaba los registros de teclas que tal pestaña envía. |1123| v2.1.248 | En Windows, `claude agents` responde al teclado cuando se lanza en una pestaña de terminal que un programa anterior dejó en win32-input-mode. Antes de esta versión, Claude Code no decodificaba los registros de teclas que tal pestaña envía. |

1121| v2.1.247 | En Linux y WSL, una sesión [cuyo proceso host de terminal murió](#the-terminal-host-died-or-the-session-stopped-responding) falla dentro de segundos con la razón. Una apertura que no produce salida termina después de aproximadamente diez segundos con una oferta de reinicio, y `Enter` en la fila reinicia la sesión con su conversación; `claude attach <id>` reporta la causa y sale. Antes de esta versión, abrir tal sesión mostraba `opening… · esc to cancel` indefinidamente y `claude attach <id>` esperaba sin reportar un error. |1124| v2.1.247 | En Linux y WSL, una sesión [cuyo proceso host de terminal murió](#the-terminal-host-died-or-the-session-stopped-responding) falla en cuestión de segundos con la razón. Una apertura que no produce salida termina después de aproximadamente diez segundos con una oferta de reinicio, y `Enter` en la fila reinicia la sesión con su conversación; `claude attach <id>` informa la causa y sale. Antes de esta versión, abrir tal sesión mostraba `opening… · esc to cancel` indefinidamente y `claude attach <id>` esperaba sin informar un error. |

1122| v2.1.246 | En una instalación de npm, cuando el [servicio de fondo](#the-supervisor-process) falla al iniciarse mientras `npm install -g @anthropic-ai/claude-code` está reemplazando el binario, Claude Code espera hasta diez segundos a que la instalación termine y reintenta antes de reportar [`EACCES: permission denied`](/docs/es/errors#eacces-when-starting-a-background-session). |1125| v2.1.246 | En una instalación de npm, cuando el [servicio en segundo plano](#the-supervisor-process) falla al iniciarse mientras `npm install -g @anthropic-ai/claude-code` está reemplazando el binario, Claude Code espera hasta diez segundos a que la instalación termine y reintenta antes de informar [`EACCES: permission denied`](/docs/es/errors#eacces-when-starting-a-background-session). |

1123| v2.1.246 | Cuando el proceso del [servicio de fondo](#the-supervisor-process) muere después de imprimir un error, Claude Code reporta el fallo y [cita la primera línea de error del servicio](/docs/es/errors#background-service-exited-before-it-became-reachable). |1126| v2.1.246 | Cuando el proceso del [servicio en segundo plano](#the-supervisor-process) muere después de imprimir un error, Claude Code informa el fallo y [cita la primera línea de error del servicio](/docs/es/errors#background-service-exited-before-it-became-reachable). |

1124| v2.1.246 | Si su máquina se duerme mientras el [servicio de fondo](#the-supervisor-process) se está iniciando, Claude Code reintenta el inicio una vez en lugar de fallar. |1127| v2.1.246 | Si tu máquina entra en suspensión mientras el [servicio en segundo plano](#the-supervisor-process) se está iniciando, Claude Code reintenta el inicio una vez en lugar de fallar. |

1125| v2.1.246 | Claude Code espera aproximadamente dos minutos en lugar de 45 segundos para un [servicio de fondo](#the-supervisor-process) recién iniciado que está vivo pero lento para aceptar conexiones. |1128| v2.1.246 | Claude Code espera aproximadamente dos minutos en lugar de 45 segundos a un [servicio en segundo plano](#the-supervisor-process) recién iniciado que está vivo pero tarda en aceptar conexiones. |

1126| v2.1.246 | El [servicio de fondo](#the-supervisor-process) se inicia desde su directorio de inicio, por lo que en macOS y Linux un directorio de inicio que fue eliminado o movido ya no bloquea el inicio. |1129| v2.1.246 | El [servicio en segundo plano](#the-supervisor-process) se inicia desde tu directorio home, por lo que en macOS y Linux un directorio de partida que fue eliminado o movido ya no bloquea el inicio. |

1127| v2.1.246 | `/fork` [copia la conversación completa](#copy-the-session-with-%2Ffork) de una sesión que ella misma se inició como una copia y no ha registrado un nuevo prompt desde: una copia `/fork` a la que se adjuntó, una sesión reajustada después de que `←` o `/background` la movió al segundo plano, o una sesión iniciada con `claude --resume <id> --fork-session`. Antes de esta versión, si ejecutaba `/fork` en tal sesión antes de enviarle un nuevo prompt, Claude Code imprimía la confirmación normal pero iniciaba la copia con una conversación vacía. Mover tal sesión al segundo plano con `←` o `/background` perdía la conversación de la misma manera. |1130| v2.1.246 | `/fork` [copia la conversación completa](#copy-the-session-with-%2Ffork) de una sesión que a su vez se inició como una copia y no ha registrado un nuevo prompt desde entonces: una copia de `/fork` a la que te adjuntaste, una sesión readjuntada después de que `←` o `/background` la movió al segundo plano, o una sesión iniciada con `claude --resume <id> --fork-session`. Antes de esta versión, si ejecutabas `/fork` en tal sesión antes de enviarle un nuevo prompt, Claude Code imprimía la confirmación normal pero iniciaba la copia con una conversación vacía. Mover tal sesión al segundo plano con `←` o `/background` perdía la conversación de la misma manera. |

1128| v2.1.246 | Cuando abre una sesión que acaba de distribuir mientras su proceso worker aún se está iniciando, como presionando `Enter` en su fila, Claude Code espera al proceso y luego se adjunta. Antes de esta versión, si presionaba `Enter` mientras el proceso aún se estaba iniciando, Claude Code podría detener la sesión con [`Session <id> was stopped while the respawn was in flight`](/docs/es/errors#session-was-stopped-while-the-respawn-was-in-flight). |1131| v2.1.246 | Cuando abres una sesión que acabas de distribuir mientras su proceso worker aún se está iniciando, por ejemplo presionando `Enter` en su fila, Claude Code espera al proceso y luego se adjunta. Antes de esta versión, si presionabas `Enter` mientras el proceso aún se estaba iniciando, Claude Code podía detener la sesión con [`Session <id> was stopped while the respawn was in flight`](/docs/es/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1129| v2.1.246 | Cuando [envía al segundo plano](#from-inside-a-session) una sesión nombrada, Claude Code la enumera una vez, y cuando envía al segundo plano la misma conversación nuevamente, numera el nombre de la nueva fila, como `my-session (2)`, con la fila existente manteniendo su nombre. Antes de esta versión, la terminal en la que presionó `←` podría aparecer en `claude agents --json` como una segunda sesión bajo el mismo nombre, y si enviaba al segundo plano la misma conversación nuevamente, Claude Code agregaba otra fila bajo el nombre idéntico. |1132| v2.1.246 | Cuando [envías al segundo plano](#from-inside-a-session) una sesión con nombre, Claude Code la enumera una vez, y cuando envías al segundo plano la misma conversación nuevamente, numera el nombre de la nueva fila, como `my-session (2)`, y la fila existente mantiene su nombre. Antes de esta versión, la terminal en la que presionaste `←` podía aparecer en `claude agents --json` como una segunda sesión bajo el mismo nombre, y si enviabas al segundo plano la misma conversación nuevamente, Claude Code agregaba otra fila bajo el nombre idéntico. |

1130| v2.1.239 | Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada de la vista de agentes cambia de modo INSERT a NORMAL y mantiene su texto, coincidiendo con el prompt principal; en modo NORMAL con texto aún en la entrada, presionar `Esc` lo borra, y presionar `Esc` en una entrada vacía sale, como describe el atajo [`Esc`](#keyboard-shortcuts). Antes de esta versión, `Esc` borraba la entrada. |1133| v2.1.239 | Con el [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `Esc` en la entrada de la vista de agentes cambia del modo INSERT a NORMAL y mantiene tu texto, igual que el prompt principal; en modo NORMAL con texto aún en la entrada, presionar `Esc` lo borra, y presionar `Esc` en una entrada vacía sale, como describe el [atajo `Esc`](#keyboard-shortcuts). Antes de esta versión, `Esc` borraba la entrada. |

1131| v2.1.233 | Para una sesión vinculada a una solicitud de fusión de GitLab, Claude Code escribe la etiqueta de la fila en la sintaxis de referencia `!1234` de GitLab. También puede pegar la URL de la solicitud de fusión en la [entrada de distribución](#filter-sessions) para seleccionar esa sesión. Antes de esta versión, la etiqueta se representaba como `#1234`, y una URL de solicitud de fusión pegada coincidía con una sesión solo cuando su primer prompt contenía la URL. |1134| v2.1.233 | Para una sesión vinculada a un merge request de GitLab, Claude Code escribe la etiqueta de la fila en la sintaxis de referencia `!1234` de GitLab. También puedes pegar la URL del merge request en la [entrada de distribución](#filter-sessions) para seleccionar esa sesión. Antes de esta versión, la etiqueta se mostraba como `#1234`, y una URL de merge request pegada coincidía con una sesión solo cuando su primer prompt contenía la URL. |

1132| v2.1.227 | [Eliminar una sesión](#what-deleting-a-session-removes) mantiene la sesión y su worktree mientras otra sesión de Claude Code en vivo se ejecuta dentro de ese directorio de worktree. La vista de agentes muestra `not deleted` en la fila y la razón en el pie de página, y `claude rm` imprime `kept <id>` con la razón, que nombra el ID de proceso de la otra sesión. Antes de esta versión, eliminar la sesión eliminaba el worktree mientras la otra sesión aún estaba trabajando en él. |1135| v2.1.227 | [Eliminar una sesión](#what-deleting-a-session-removes) mantiene la sesión y su worktree mientras otra sesión activa de Claude Code se ejecuta dentro de ese directorio de worktree. La vista de agentes muestra `not deleted` en la fila y la razón en el pie de página, y `claude rm` imprime `kept <id>` con la razón, que nombra el ID de proceso de la otra sesión. Antes de esta versión, eliminar la sesión eliminaba el worktree mientras la otra sesión aún estaba trabajando en él. |

1133| v2.1.225 | `claude agents` en un directorio que no ha confiado muestra el mismo [diálogo de confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) que `claude` muestra al inicio, antes de que se abra la vista de agentes. Aceptar guarda la confianza para ese espacio de trabajo; rechazar sale sin abrir la vista de agentes. Antes de esta versión, `claude agents` se abría sin preguntar, por lo que las sesiones que distribuía desde él se ejecutaban en un directorio en el que nunca le habían pedido que confiara.<br /><br />Con la lista agrupada por directorio, pasar el ratón sobre una fila la resalta sin cambiar el [destino de distribución](#dispatch-to-a-specific-directory); seleccionar una fila con las teclas de flecha o un clic aún cambia el destino. Antes de esta versión, mover el ratón sobre una sesión en otro proyecto silenciosamente cambiaba el directorio en el que se iniciaba la siguiente sesión distribuida. |1136| v2.1.225 | `claude agents` en un directorio en el que no has confiado muestra el mismo [diálogo de confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) que `claude` muestra al inicio, antes de que se abra la vista de agentes. Aceptar guarda la confianza para ese espacio de trabajo; rechazar sale sin abrir la vista de agentes. Antes de esta versión, `claude agents` se abría sin preguntar, por lo que las sesiones que distribuías desde él se ejecutaban en un directorio en el que nunca te habían pedido que confiaras.<br /><br />Con la lista agrupada por directorio, pasar el ratón sobre una fila la resalta sin cambiar el [destino de distribución](#dispatch-to-a-specific-directory); seleccionar una fila con las teclas de flecha o un clic aún cambia el destino. Antes de esta versión, mover el ratón sobre una sesión en otro proyecto cambiaba silenciosamente el directorio en el que se iniciaba la siguiente sesión distribuida. |

1134| v2.1.221 | `/status` muestra una fila `Session kind`: `background job · attached` o `background job · unattended` en una sesión de fondo, dependiendo de si una terminal está adjunta, e `interactive` en cualquier otra sesión. Antes de esta versión, `/status` no reportaba el tipo de sesión.<br /><br />`/fork`: Claude Code instruye a [la copia](#from-inside-a-session) para aislar su trabajo del de la sesión original: la copia crea su propio worktree antes de hacer cambios de código, se mantiene fuera del worktree de la sesión original, y basa una nueva rama en la rama de la original cuando su tarea se basa en ese trabajo. Vea la sección vinculada para las condiciones exactas. Antes de esta versión, la copia no recibía instrucción de aislamiento y podría terminar editando el worktree o verificando el checkout en el que la sesión original aún estaba trabajando.<br /><br />Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` justo después de deshacer el prompt de vuelta a vacío con `u` pide la misma confirmación que eliminar el texto o moverse a través del historial de prompts, y cambia solo en el segundo presionar; antes de esta versión el presionar cambiaba inmediatamente. |1137| v2.1.221 | `/status` muestra una fila `Session kind`: `background job · attached` o `background job · unattended` en una sesión en segundo plano, dependiendo de si hay una terminal adjunta, e `interactive` en cualquier otra sesión. Antes de esta versión, `/status` no informaba el tipo de sesión.<br /><br />`/fork`: Claude Code indica a [la copia](#from-inside-a-session) que aísle su trabajo del de la sesión original: la copia crea su propio worktree antes de hacer cambios de código, se mantiene fuera del worktree de la sesión original, y basa una nueva rama en la rama de la original cuando su tarea se basa en ese trabajo. Consulta la sección vinculada para las condiciones exactas. Antes de esta versión, la copia no recibía ninguna instrucción de aislamiento y podía terminar editando el worktree o el checkout en el que la sesión original aún estaba trabajando.<br /><br />Con el [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` justo después de deshacer el prompt hasta dejarlo vacío con `u` pide la misma confirmación que eliminar el texto o moverse por el historial de prompts, y cambia solo con la segunda pulsación; antes de esta versión la pulsación cambiaba inmediatamente. |

1135| v2.1.219 | Con [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` en un prompt vacío abre la vista de agentes desde modo NORMAL así como INSERT, y la sugerencia `←` del pie de página se muestra en modo NORMAL; antes de esta versión el gesto y la sugerencia eran solo INSERT, y en modo NORMAL `←` en un prompt vacío no hacía nada. Escribir en la entrada mientras Claude Code espera enviar la sesión al segundo plano cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` para que un borrador escrito no se pierda. |1138| v2.1.219 | Con el [modo de editor vim](/docs/es/interactive-mode#vim-editor-mode) activado, presionar `←` en un prompt vacío abre la vista de agentes desde el modo NORMAL además de INSERT, y la sugerencia `←` del pie de página se muestra en modo NORMAL; antes de esta versión el gesto y la sugerencia eran solo de INSERT, y en modo NORMAL `←` en un prompt vacío no hacía nada. Escribir en la entrada mientras Claude Code espera para enviar la sesión al segundo plano cancela el cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` para que un borrador escrito no se pierda. |

1136| v2.1.218 | Presionar `←` dentro de dos segundos de una eliminación que vació el prompt, o de moverse a través del historial de prompts, muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y cambia solo en un segundo presionar al menos un segundo después; antes de esta versión el presionar cambiaba inmediatamente. Un `←` que llega dentro de entrada pegada o escrita por script ya no activa el cambio. Enviar al segundo plano una sesión en primer plano con `←` muestra `Your conversation moved to the background` encima de la lista, y `Esc` en la raíz de la vista de agentes regresa a esa conversación en lugar de salir al shell, con doble `Ctrl+C` permaneciendo como la salida; si la conversación no se puede reabrir, Claude Code sale e imprime un comando `claude --resume` para ella. En Windows, un `←` presionado dentro de aproximadamente medio segundo de adjuntarse muestra `Ambiguous ←, press again to detach` y se desadjunta en el segundo presionar. |1139| v2.1.218 | Presionar `←` dentro de los dos segundos posteriores a una eliminación que vació el prompt, o a moverse por el historial de prompts, muestra `Press ← again to open agents`, o `Press ← again to go back to agents` en una sesión adjunta, y cambia solo con una segunda pulsación al menos un segundo después; antes de esta versión la pulsación cambiaba inmediatamente. Un `←` que llega dentro de entrada pegada o escrita por script ya no activa el cambio. Enviar al segundo plano una sesión en primer plano con `←` muestra `Your conversation moved to the background` encima de la lista, y `Esc` en la raíz de la vista de agentes regresa a esa conversación en lugar de salir al shell, y el doble `Ctrl+C` sigue siendo la forma de salir; si la conversación no se puede reabrir, Claude Code sale e imprime un comando `claude --resume` para ella. En Windows, un `←` presionado dentro de aproximadamente medio segundo después de adjuntarse muestra `Ambiguous ←, press again to detach` y se desadjunta con la segunda pulsación. |

1137| v2.1.217 | La insignia de solicitud de extracción en la fila de una sesión se representa como un hipervínculo incluso cuando Claude Code no puede detectar soporte de hipervínculo de terminal, por ejemplo sobre SSH o tmux; establezca [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para representarla como texto sin formato. Antes de esta versión, la insignia se representaba como texto sin formato cuando el soporte no se detectaba. |1140| v2.1.217 | La insignia de pull request en la fila de una sesión se muestra como un hipervínculo incluso cuando Claude Code no puede detectar el soporte de hipervínculos de la terminal, por ejemplo a través de SSH o tmux; establece [`FORCE_HYPERLINK=0`](/docs/es/env-vars) para mostrarla como texto sin formato. Antes de esta versión, la insignia se mostraba como texto sin formato cuando no se detectaba el soporte. |

1138| v2.1.216 | `/fork`: la [confirmación](#from-inside-a-session) es una línea, mostrando el estado de la copia, el nombre de su fila de vista de agentes, y su ID de sesión para `claude attach`, terminando con `runs in the origin tree` o `edits this checkout` solo cuando la copia se ejecuta en el árbol de trabajo principal o edita el checkout que tiene abierto. Hacer clic en el nombre envía esta sesión al segundo plano y abre la vista de agentes en la sesión de la copia. La confirmación ya no reafirma el modo de permiso heredado de la copia; las versiones anteriores imprimían una confirmación de varias líneas sin nombre clickeable.<br /><br />Necesita entrada: `/install-github-app` y la lista de configuración `/mcp`, ejecutadas mientras nadie está adjunto, muestran la sesión bajo `Needs input` con una fila que nombra el comando, y adjuntarse y re-ejecutar el comando continúa; de v2.1.208 a v2.1.215 fueron rechazadas directamente en ese estado.<br /><br />Restauración de `--agent`: reanudar o reiniciar una [sesión `--agent` enviada al segundo plano](#from-your-shell) restaura el prompt del sistema del agente y las restricciones de herramientas, buscando el agente en el directorio de la sesión primero, cuando su espacio de trabajo es confiable; una sesión cuyo agente ya no existe continúa con las herramientas predeterminadas y el prompt del sistema y se abre con una advertencia visible, en lugar de revertir silenciosamente al agente predeterminado.<br /><br />`Ctrl+X`: presionarlo dos veces elimina una sesión incluso cuando el intento de detención falla, en lugar de que una detención fallida cancele la eliminación pendiente, y una sesión eliminada cuyo proceso worker había muerto ya no reaparece en el próximo refresco.<br /><br />Eliminación de worktree: una sesión cuyo directorio de worktree no pertenece a ningún repositorio de git puede ser eliminada; antes de esta versión cada intento de eliminar tal sesión fue rechazado. Un directorio que ya se ha ido se borra inmediatamente. El doble presionar de la vista de agentes elimina un directorio que aún tiene archivos, ejecutando su hook `WorktreeRemove` para un directorio creado por hook, a menos que otra sesión también lo nombre. `claude rm` mantiene tal directorio siempre que los archivos permanezcan. |1141| v2.1.216 | `/fork`: la [confirmación](#from-inside-a-session) es una línea, que muestra el estado de la copia, el nombre de su fila en la vista de agentes y su ID de sesión para `claude attach`, y termina con `runs in the origin tree` o `edits this checkout` solo cuando la copia se ejecuta en el árbol de trabajo principal o edita el checkout que tienes abierto. Hacer clic en el nombre envía esta sesión al segundo plano y abre la vista de agentes en la sesión de la copia. La confirmación ya no repite el modo de permisos heredado de la copia; las versiones anteriores imprimían una confirmación de varias líneas sin nombre en el que se pudiera hacer clic.<br /><br />Necesita entrada: `/install-github-app` y la lista de configuración de `/mcp`, ejecutados mientras nadie está adjunto, muestran la sesión bajo `Needs input` con una fila que nombra el comando, y adjuntarse y volver a ejecutar el comando continúa; de v2.1.208 a v2.1.215 se rechazaban directamente en ese estado.<br /><br />Restauración de `--agent`: reanudar o reiniciar una [sesión `--agent` enviada al segundo plano](#from-your-shell) restaura el prompt del sistema del agente y las restricciones de herramientas, buscando primero el agente en el propio directorio de la sesión, cuando su espacio de trabajo es de confianza; una sesión cuyo agente ya no existe continúa con las herramientas y el prompt del sistema predeterminados y se abre con una advertencia visible, en lugar de revertir silenciosamente al agente predeterminado.<br /><br />`Ctrl+X`: presionarlo dos veces elimina una sesión incluso cuando el intento de detención falla, en lugar de que una detención fallida cancele la eliminación pendiente, y una sesión eliminada cuyo proceso worker había muerto ya no reaparece en la siguiente actualización.<br /><br />Eliminación de worktree: una sesión cuyo directorio de worktree no pertenece a ningún repositorio de git se puede eliminar; antes de esta versión se rechazaba cada intento de eliminar tal sesión. Un directorio que ya no existe se borra inmediatamente. La doble pulsación de la vista de agentes elimina un directorio que aún tiene archivos, ejecutando tu hook `WorktreeRemove` para un directorio creado por un hook, a menos que los registros de otra sesión también lo nombren. `claude rm` mantiene tal directorio siempre que queden archivos. |

1139| v2.1.214 | Una sesión enviada al segundo plano con `←` o `/background` e inactiva sin nada ejecutándose tiene su proceso detenido como cualquier otra sesión inactiva, en lugar de mantener su proceso y el servicio de fondo ejecutándose indefinidamente. Una sesión completada puede ser eliminada con `claude rm` o desde la vista de agentes después de que el servicio de fondo se haya quedado inactivo, y una sesión que entró en un worktree después de ser distribuida desde un directorio que no es un repositorio de git, como una carpeta de espacio de trabajo multi-repo, puede ser eliminada desde la vista de agentes cuando el worktree mismo pertenece a un repositorio de git, porque la limpieza se resuelve desde el worktree en lugar del directorio desde el que se distribuyó la sesión; ambas eliminaciones fueron rechazadas en cada intento antes. Reabrir una sesión detenida restaura su conversación guardada incluso cuando una carpeta en el almacén de transcripción no se puede leer. |1142| v2.1.214 | Una sesión enviada al segundo plano con `←` o `/background` y dejada inactiva sin nada en ejecución tiene su proceso detenido como cualquier otra sesión inactiva, en lugar de mantener su proceso y el servicio en segundo plano en ejecución indefinidamente. Una sesión completada se puede eliminar con `claude rm` o desde la vista de agentes después de que el servicio en segundo plano haya quedado inactivo, y una sesión que entró en un worktree después de ser distribuida desde un directorio que no es un repositorio de git, como una carpeta de espacio de trabajo con varios repositorios, se puede eliminar desde la vista de agentes cuando el propio worktree pertenece a un repositorio de git, porque la limpieza se resuelve desde el worktree en lugar del directorio desde el que se distribuyó la sesión; antes, ambas eliminaciones se rechazaban en cada intento. Reabrir una sesión detenida restaura su conversación guardada incluso cuando no se puede leer una carpeta del almacén de transcripciones. |

1140| v2.1.213 | `/install-github-app`, la lista de configuración [`/mcp`](/docs/es/mcp), y acciones de autenticación MCP funcionan en una sesión de fondo mientras una terminal está adjunta, y se rechazan solo cuando nadie está adjunto, con un mensaje diciéndole que se adjunte y ejecute el comando nuevamente; de v2.1.208 a v2.1.212 fueron rechazadas incluso con una terminal adjunta. |1143| v2.1.213 | `/install-github-app`, la lista de configuración de [`/mcp`](/docs/es/mcp) y las acciones de autenticación de MCP funcionan en una sesión en segundo plano mientras hay una terminal adjunta, y se rechazan solo cuando nadie está adjunto, con un mensaje que te indica que te adjuntes y ejecutes el comando nuevamente; de v2.1.208 a v2.1.212 se rechazaban incluso con una terminal adjunta. |

1141| v2.1.212 | [`/fork` en una sesión interactiva](#from-inside-a-session) copia la conversación en una nueva sesión de fondo que aparece como su propia fila, nombrada después de la sesión de la que provino o, para un fork solicitado de una sesión sin nombre, después del prompt de fork, mientras la original continúa ejecutándose; el comportamiento anterior de subagente forked de `/fork` se movió a `/subtask`. Con [vista de agentes desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente forked. Una fila enfocada que está esperando su primer prompt muestra `space to send it a prompt`. `Ctrl+J` inserta una nueva línea en la entrada de distribución en terminales con reporte de tecla extendida, donde el presionar de tecla fue previamente ignorado, y la superposición `?` enumera el atajo. La sugerencia de pie de página `←` en una sesión interactiva brevemente muestra `N done` cuando una sesión de fondo termina mientras ninguna necesita su entrada. Escribir un `/resume` desnudo en la vista de agentes abre un selector de sesiones pasadas del repositorio desde el que abrió la vista de agentes, incluyendo sesiones eliminadas de la lista, y seleccionar una la reanuda como una sesión de fondo; antes de esta versión `/resume` no estaba disponible en la vista de agentes y las sesiones eliminadas eran alcanzables solo con `claude --resume` o `/resume` desde una sesión interactiva. Los formularios dirigidos, con alcance y restringidos mantienen la sugerencia `attach to a session to run it` que las versiones anteriores mostraban para cada formulario. Las sesiones esperando un prompt de host de red de sandbox, una solicitud de entrada MCP, o un prompt de configuración administrada se muestran como `Needs input` en lugar de `Working`, en la vista de agentes y en `claude agents --json`, y una pregunta de Claude reporta `waitingFor: input needed` en lugar de `permission prompt`. Adjuntarse a una sesión cuyo proceso se ha detenido muestra su transcripción formateada de la manera en que la sesión en vivo la representa, en lugar de como texto sin procesar. Una sesión detenida cuya transcripción está en un lugar inesperado se reanuda desde ella a través de un escaneo de último recurso de sus transcripciones guardadas, y abrir una fila que no tiene transcripción guardada muestra `Press enter again to restart this session fresh`, reiniciándola de nuevo en el segundo presionar; v2.1.211 mostró el rechazo sin forma de reiniciar desde la vista de agentes. |1144| v2.1.212 | [`/fork` en una sesión interactiva](#from-inside-a-session) copia la conversación en una nueva sesión en segundo plano que aparece como su propia fila, nombrada a partir de la sesión de la que provino o, para un fork con prompt de una sesión sin nombre, a partir del prompt del fork, mientras la original continúa ejecutándose; el comportamiento anterior de subagente bifurcado de `/fork` se movió a `/subtask`. Con la [vista de agentes desactivada](#turn-off-agent-view), `/fork` mantiene el comportamiento de subagente bifurcado. Una fila enfocada que está esperando su primer prompt muestra `space to send it a prompt`. `Ctrl+J` inserta una nueva línea en la entrada de distribución en terminales con reporte extendido de teclas, donde antes la pulsación se ignoraba, y la superposición `?` enumera el atajo. La sugerencia `←` del pie de página en una sesión interactiva muestra brevemente `N done` cuando una sesión en segundo plano termina mientras ninguna necesita tu entrada. Escribir un `/resume` sin argumentos en la vista de agentes abre un selector de sesiones pasadas del repositorio desde el que abriste la vista de agentes, incluidas las sesiones eliminadas de la lista, y elegir una la reanuda como una sesión en segundo plano; antes de esta versión `/resume` no estaba disponible en la vista de agentes y las sesiones eliminadas solo eran accesibles con `claude --resume` o `/resume` desde una sesión interactiva. Las formas dirigidas, con alcance y restringidas mantienen la sugerencia `attach to a session to run it` que las versiones anteriores mostraban para cada forma. Las sesiones que esperan una solicitud de host de red del sandbox, una solicitud de entrada de MCP o una solicitud de configuración administrada se muestran como `Needs input` en lugar de `Working`, en la vista de agentes y en `claude agents --json`, y una pregunta de Claude informa `waitingFor: input needed` en lugar de `permission prompt`. Adjuntarse a una sesión cuyo proceso se ha detenido muestra su transcripción con el formato en que la muestra la sesión activa, en lugar de como texto sin procesar. Una sesión detenida cuya transcripción está en un lugar inesperado se reanuda desde ella mediante un escaneo de último recurso de tus transcripciones guardadas, y abrir una fila que no tiene transcripción guardada muestra `Press enter again to restart this session fresh`, y la reinicia desde cero con la segunda pulsación; v2.1.211 mostraba el rechazo sin forma de reiniciar desde la vista de agentes. |

1142| v2.1.211 | Despertar una sesión detenida adjuntándose o respondiendo desde el directorio en el que se ejecuta reenvía el `ANTHROPIC_BASE_URL` de puerta de enlace de su shell nuevamente, bajo las mismas condiciones que una distribución nueva, por lo que una sesión autenticada a través de un `ANTHROPIC_AUTH_TOKEN` de puerta de enlace se reanuda en la puerta de enlace en lugar de reportar `Not logged in`. Adjuntarse a una sesión detenida que fue enviada al segundo plano desde otra conversación antes de que su primera respuesta terminara se rechaza con `This session has no saved transcript` en lugar de silenciosamente iniciar una conversación en blanco bajo el mismo ID de sesión; abrir la misma fila desde la vista de agentes mostró el rechazo en el pie de página. Terminar el proceso de una sesión `←` o `/background` desde fuera de Claude Code la marca como detenida en lugar de que el supervisor la reinicie, una detención ya registrada en disco se honra a menos que una respuesta que envió aún esté esperando ser entregada, una sesión reiniciada después de un fallo es informada de que fue reiniciada, y una sesión `←` o `/background` reiniciada no reanuda una respuesta interrumpida más antigua que aproximadamente una hora. Una respuesta de sesión-nombrada que responde o rechaza el prompt en lugar de etiquetarlo, como para un prompt que es principalmente un enlace, se descarta y la fila mantiene un nombre tomado del texto del prompt. Eliminar una sesión cuyo git de worktree ya no reconoce tiene éxito, dejando el directorio de worktree en disco y nombrando su ruta, en lugar de que cada intento sea rechazado. Un rechazo de eliminación muestra la razón en la fila de la sesión, incluyendo el error de git subyacente cuando el worktree no pudo ser eliminado, en lugar de que la fila silenciosamente reaparezca. |1145| v2.1.211 | Despertar una sesión detenida adjuntándote o respondiendo desde el directorio en el que se ejecuta vuelve a reenviar el `ANTHROPIC_BASE_URL` de gateway de tu shell, bajo las mismas condiciones que una distribución nueva, por lo que una sesión autenticada a través de un `ANTHROPIC_AUTH_TOKEN` de gateway se reanuda en el gateway en lugar de informar `Not logged in`. Adjuntarse a una sesión detenida que fue enviada al segundo plano desde otra conversación antes de que terminara su primera respuesta se rechaza con `This session has no saved transcript` en lugar de iniciar silenciosamente una conversación en blanco bajo el mismo ID de sesión; abrir la misma fila desde la vista de agentes mostraba el rechazo en el pie de página. Terminar el proceso de una sesión de `←` o `/background` desde fuera de Claude Code la marca como detenida en lugar de que el supervisor la reinicie, una detención ya registrada en disco se respeta a menos que una respuesta que enviaste aún esté esperando ser entregada, a una sesión reiniciada después de un fallo se le informa que fue reiniciada, y una sesión de `←` o `/background` reiniciada no reanuda una respuesta interrumpida de hace más de aproximadamente una hora. Una respuesta de nombrado de sesión que responde o rechaza el prompt en lugar de etiquetarlo, como en el caso de un prompt que es principalmente un enlace, se descarta y la fila mantiene un nombre tomado del texto del prompt. Eliminar una sesión cuyo worktree git ya no reconoce tiene éxito, dejando el directorio del worktree en disco y nombrando su ruta, en lugar de que se rechace cada intento. Una eliminación rechazada muestra la razón en la fila de la sesión, incluido el error de git subyacente cuando no se pudo eliminar el worktree, en lugar de que la fila reaparezca silenciosamente. |

1143| v2.1.210 | `claude attach` espera mientras el servicio de fondo se está iniciando o reconectando en lugar de fallar con un error `job not found` o `still starting`, reporta una sesión que terminó durante el adjunto como salida, y aplica un cambio de tamaño de terminal hecho durante un adjunto lento cuando el adjunto se completa. La sugerencia de conteo de necesidades de entrada `←` del pie de página del prompt aparece en cada proveedor, incluyendo proveedores de terceros que previamente mostraban la forma `← for agents` simple. Enviar al segundo plano una sesión con `←` lleva la lista de tareas de Claude a la sesión de fondo en lugar de descartarla. La fila en la que presionó `←` mantiene un nombre en negrita, sin atenuar después de que la selección se mueve. `claude agents --effort` acepta `ultracode` en lugar de silenciosamente descartarlo. |1146| v2.1.210 | `claude attach` espera mientras el servicio en segundo plano se está iniciando o reconectando en lugar de fallar con un error `job not found` o `still starting`, informa como finalizada una sesión que terminó durante la conexión, y aplica un cambio de tamaño de la terminal hecho durante una conexión lenta cuando esta se completa. El recuento de sesiones que necesitan entrada en la sugerencia `←` del pie de página del prompt aparece con todos los proveedores, incluidos los proveedores de terceros que antes mostraban la forma simple `← for agents`. Enviar al segundo plano una sesión con `←` lleva la lista de tareas de Claude a la sesión en segundo plano en lugar de descartarla. La fila desde la que presionaste `←` mantiene un nombre en negrita y sin atenuar después de que la selección se mueve. `claude agents --effort` acepta `ultracode` en lugar de descartarlo silenciosamente. |

1144| v2.1.208 | Adjuntarse a una sesión cuyo proceso se ha detenido muestra la última pantalla de su transcripción mientras el proceso se inicia, en lugar de solo una nota `Session is starting`. Una respuesta que no se puede entregar porque el servicio de fondo es inaccesible o el envío falla se guarda y se envía como el siguiente prompt de la sesión cuando su proceso se inicia nuevamente; antes de esta versión, una respuesta perdida mientras el servicio de fondo era inaccesible se descartaba. Un proceso cuyo propio binario fue reemplazado por una actualización aún puede iniciar el supervisor, desde el lanzador `claude` instalado o la versión más nueva en disco, en lugar de fallar hasta que Claude Code se reiniciara. Un supervisor que ejecuta una versión anterior nunca reinicia una sesión inactiva iniciada por una versión más nueva en su propio binario más antiguo. Eliminar una sesión elimina su worktree incluso después de que la sesión movió el worktree a una rama diferente, y mantiene el worktree junto con la fila de sesión cuando el worktree tiene commits que no se han enviado a ningún lugar u otra sesión lo reclama, en lugar de destruir los commits u orfandar el worktree. `/install-github-app` y la lista de configuración `/mcp` y sus acciones de autenticación se rechazan en una sesión de fondo con un mensaje que nombra la alternativa; en v2.1.208 solamente, el selector `/model` fue rechazado de la misma manera y un `/model <name>` escrito cambió solo esa sesión en lugar de también guardar su modelo predeterminado. |1147| v2.1.208 | Adjuntarse a una sesión cuyo proceso se ha detenido muestra la última pantalla de su transcripción mientras el proceso se inicia, en lugar de solo una nota `Session is starting`. Una respuesta que no se puede entregar porque el servicio en segundo plano es inaccesible o el envío falla se guarda y se envía como el siguiente prompt de la sesión cuando su proceso se inicia nuevamente; antes de esta versión, una respuesta perdida mientras el servicio en segundo plano era inaccesible se descartaba. Un proceso cuyo propio binario fue reemplazado por una actualización aún puede iniciar el supervisor, desde el lanzador `claude` instalado o la versión más nueva en disco, en lugar de fallar hasta que se reiniciara Claude Code. Un supervisor que ejecuta una versión anterior nunca reinicia una sesión inactiva iniciada por una versión más nueva en su propio binario más antiguo. Eliminar una sesión elimina su worktree incluso después de que la sesión movió el worktree a una rama diferente, y mantiene el worktree junto con la fila de la sesión cuando el worktree tiene commits que no se han enviado a ningún lugar u otra sesión lo reclama, en lugar de destruir los commits o dejar huérfano el worktree. `/install-github-app` y la lista de configuración de `/mcp` y sus acciones de autenticación se rechazan en una sesión en segundo plano con un mensaje que nombra la alternativa; solo en v2.1.208, el selector de `/model` se rechazaba de la misma manera y un `/model <name>` escrito cambiaba solo esa sesión en lugar de guardar también tu modelo predeterminado. |

1145| v2.1.207 | El panel de vista previa se abre con la oración que la fila trunca, como la pregunta exacta para una sesión que lo espera a usted, y muestra cuánto tiempo una sesión bloqueada ha estado esperando como una única línea `waiting 3m` en lugar de prefijar la misma marca de tiempo a la oración de estado y la pregunta. Pegar el mismo texto nuevamente en la entrada de distribución expande el marcador de posición colapsado `[Pasted text #N]` en lugar de agregar uno segundo. Una sesión en segundo plano nombrada al aceptar un plan muestra ese nombre en su fila. Una sesión en segundo plano que se movió a un worktree mantiene su conversación cuando su proceso se reinicia desde la vista de agentes. |1148| v2.1.207 | El panel de vista previa se abre con la oración que la fila trunca, como la pregunta exacta de una sesión que te está esperando, y muestra cuánto tiempo lleva esperando una sesión bloqueada como una única línea `waiting 3m` en lugar de anteponer la misma marca de tiempo a la oración de estado y a la pregunta. Pegar el mismo texto nuevamente en la entrada de distribución expande el marcador de posición contraído `[Pasted text #N]` en lugar de agregar un segundo. Una sesión en segundo plano nombrada al aceptar un plan muestra ese nombre en su fila. Una sesión en segundo plano que se movió a un worktree mantiene su conversación cuando su proceso se reinicia desde la vista de agentes. |

1146| v2.1.206 | Los resúmenes de filas llenan el ancho restante de la fila y se truncan solo en el borde derecho de la terminal en lugar de en 64 columnas. Después de que el supervisor se reinicia en una nueva versión de Claude Code, reinicia las sesiones en segundo plano inactivas restantes en esa versión en el fondo en lugar de algunas por minuto. Eliminar una sesión con `Ctrl+X` o `claude rm` también la borra de la lista de sesiones del supervisor, por lo que la fila ya no reaparece después de un reinicio del supervisor. Una anulación de cuerpo de solicitud `CLAUDE_CODE_EXTRA_BODY` exportada en el shell de distribución llega a las sesiones de fondo en lugar de ser ignorada. |1149| v2.1.206 | Los resúmenes de filas llenan el ancho restante de la fila y se truncan solo en el borde derecho de la terminal en lugar de en 64 columnas. Después de que el supervisor se reinicia en una nueva versión de Claude Code, reinicia en segundo plano las sesiones en segundo plano inactivas restantes en esa versión en lugar de unas pocas por minuto. Eliminar una sesión con `Ctrl+X` o `claude rm` también la borra de la lista de sesiones del supervisor, por lo que la fila ya no reaparece después de un reinicio del supervisor. Una sobrescritura del cuerpo de solicitud `CLAUDE_CODE_EXTRA_BODY` exportada en el shell de distribución llega a las sesiones en segundo plano en lugar de ser ignorada. |

1147| v2.1.205 | La sugerencia `←` del pie de página del prompt en una sesión regular `claude` cuenta los agentes de fondo esperando por usted, como `← 2 agents`. Los resúmenes de filas muestran el informe de una línea propia de la sesión, truncado en 64 columnas, en lugar de una invocación de herramienta sin procesar o un recuento `done/total`; las filas agrupadas por directorio se abren con una palabra de estado coloreada. El panel de vista previa se abre con la oración de estado completa y, para una sesión que espera por usted, su pregunta exacta encima de la entrada de respuesta. Las sesiones que editan, comentan, cierran o marcan una solicitud de extracción como lista con `gh` están vinculadas a ella, no solo las que crean o verifican una solicitud de extracción, un push vincula una solicitud de extracción incluso cuando el nombre de rama local no coincide, y una solicitud de extracción cuya salida del comando de creación excedió el límite en línea también está vinculada. Un turno sin texto legible mantiene el estado anterior de la sesión en lugar de voltearlo de nuevo a `Working`. `claude attach` espera hasta aproximadamente 60 segundos una sesión que se está reiniciando, con una línea de estado que indica por qué, en lugar de fallar. |1150| v2.1.205 | La sugerencia `←` del pie de página del prompt en una sesión normal de `claude` cuenta los agentes en segundo plano que te están esperando, como `← 2 agents`. Los resúmenes de filas muestran el informe de una línea de la propia sesión, truncado en 64 columnas, en lugar de una invocación de herramienta sin procesar o un recuento `done/total`; las filas agrupadas por directorio empiezan con una palabra de estado en color. El panel de vista previa se abre con la oración de estado completa y, para una sesión que te está esperando, su pregunta exacta encima de la entrada de respuesta. Las sesiones que editan, comentan, cierran o marcan como listo un pull request con `gh` quedan vinculadas a él, no solo las que crean o hacen checkout de un pull request; un push vincula un pull request incluso cuando el nombre de la rama local no coincide, y también se vincula un pull request cuando la salida del comando que lo creó superó el límite en línea. Un turno sin texto legible mantiene el estado anterior de la sesión en lugar de volver a cambiarlo a `Working`. `claude attach` espera hasta aproximadamente 60 segundos a una sesión que se está reiniciando, con una línea de estado que indica el motivo, en lugar de fallar. |

1148| v2.1.203 | Una puerta de enlace `ANTHROPIC_BASE_URL` exportada en el shell de distribución llega a las sesiones distribuidas desde él en ese mismo directorio cuando el supervisor comparte ese entorno de puerta de enlace, en lugar de ser descartada mientras la clave API exportada junto a ella se mantenía. El `PATH` del shell de distribución se aplica al worker de cada sesión. Presionar `←` mientras los subagentes se están ejecutando espera a que terminen en lugar de reiniciarlos después de diez segundos. La lista vacía siempre muestra los encabezados de sección con una descripción bajo cada uno. Escribir `@` en la entrada de distribución también enumera los worktrees de git registrados del repositorio de lanzamiento que viven dentro de su árbol de directorios. Un esfuerzo heredado de la configuración `effortLevel` sigue ediciones posteriores a esa configuración en lugar de ser fijado en la distribución. Abrir una sesión detenida cuya conversación ya está abierta en otra sesión en ejecución se rechaza con un mensaje en lugar de fallar la fila. Un comando que no está disponible en la vista de agentes deja el texto escrito en la entrada. Un hook `WorktreeCreate` que falla fuera de un repositorio de git ya no bloquea la sesión de editar archivos. |1151| v2.1.203 | Un `ANTHROPIC_BASE_URL` de gateway exportado en el shell de distribución llega a las sesiones distribuidas desde él en ese mismo directorio cuando el supervisor comparte ese entorno de gateway, en lugar de descartarse mientras se mantenía la clave de API exportada junto a él. El `PATH` del shell de distribución se aplica al worker de cada sesión. Presionar `←` mientras se ejecutan subagentes espera a que terminen en lugar de reiniciarlos después de diez segundos. La lista vacía siempre muestra los encabezados de sección con una descripción bajo cada uno. Escribir `@` en la entrada de distribución también enumera los worktrees de git registrados del repositorio de lanzamiento que se encuentran dentro de su árbol de directorios. Un esfuerzo heredado del ajuste `effortLevel` sigue las ediciones posteriores de ese ajuste en lugar de quedar fijo en el momento de la distribución. Abrir una sesión detenida cuya conversación ya está abierta en otra sesión en ejecución se rechaza con un mensaje en lugar de hacer fallar la fila. Un comando que no está disponible en la vista de agentes deja el texto escrito en la entrada. Un hook `WorktreeCreate` que falla fuera de un repositorio de git ya no impide que la sesión edite archivos. |

1149| v2.1.202 | Un nombre establecido con `/rename` o `Ctrl+R` en una sesión en segundo plano persiste cuando el supervisor detiene y reinicia su proceso, en lugar de revertir al nombre con el que se distribuyó la sesión. |1152| v2.1.202 | Un nombre establecido con `/rename` o `Ctrl+R` en una sesión en segundo plano persiste cuando el supervisor detiene y reinicia su proceso, en lugar de revertir al nombre con el que se distribuyó la sesión. |

1150| v2.1.200 | Una versión anterior de Claude Code que reescribe la lista de sesiones en `roster.json` preserva campos escritos por una versión más nueva, coincidiendo con la garantía existente de `state.json`, por lo que las sesiones iniciadas por la versión más nueva continúan aceptando entrada después de que el supervisor se reinicia. Cuando abre una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. La vista de agentes aplica una bandera `--plugin-dir` colocada después de `agents` a su propio subagente y autocompletado de skills en la entrada de distribución así como sesiones distribuidas. |1153| v2.1.200 | Una versión anterior de Claude Code que reescribe la lista de sesiones en `roster.json` conserva los campos escritos por una versión más nueva, igual que la garantía existente de `state.json`, por lo que las sesiones iniciadas por la versión más nueva siguen aceptando entrada después de que el supervisor se reinicia. Cuando abres una sesión que ha dejado de responder, el supervisor reinicia su proceso y la sesión continúa la respuesta interrumpida desde donde se quedó. La vista de agentes aplica un flag `--plugin-dir` colocado después de `agents` a su propio autocompletado de subagentes y skills en la entrada de distribución, así como a las sesiones distribuidas. |

1151| v2.1.199 | Una sesión en segundo plano cuyo proceso se cierra antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en su estado de fila en lugar de solo la razón de salida desnuda. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |1154| v2.1.199 | Una sesión en segundo plano cuyo proceso sale antes de terminar de iniciarse en un host con poca memoria muestra `possibly low memory — free some up and retry` en el estado de su fila en lugar de solo la razón de salida sin más. Enviar al segundo plano una sesión con `←` o `/background` lleva su `/color` a la nueva fila. |

1152| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree confirma, envía su propia rama aislada, nunca `main` o `master`, y abre una solicitud de extracción en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. La entrega de salida también cubre subagentes en segundo plano, que se reanudan desde su transcripción en el próximo despertar en lugar de ser reportados como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesión de fondo solicita permiso de Red Local de macOS en el primer acceso LAN en lugar de fallar con `connect: no route to host`. |1155| v2.1.198 | La vista de agentes envía una notificación a través de `preferredNotifChannel` cuando una sesión en segundo plano necesita entrada, finaliza o falla, y dispara el hook `Notification` con el tipo `agent_needs_input` o `agent_completed`. `←` y `/exit` dentro de `claude attach <id>` regresan a la vista de agentes en lugar de salir al shell; `Ctrl+Z` regresa al shell. Una sesión en segundo plano que aisló su trabajo en un worktree hace commit, hace push de su propia rama aislada, nunca de `main` ni de `master`, y abre un pull request en borrador cuando finaliza en lugar de preguntar primero. `/login` se ejecuta en la vista de agentes y abre el diálogo de inicio de sesión. El diálogo de salida `Background work is running` ofrece `Move to background and exit`. El traspaso al salir también cubre los subagentes en segundo plano, que se reanudan desde su transcripción en el siguiente despertar en lugar de informarse como fallidos. `claude --bg` combinado con `-p` o `--print` se rechaza con un error. El host de sesiones en segundo plano solicita el permiso de Red Local de macOS en el primer acceso a la LAN en lugar de fallar con `connect: no route to host`. |

1153| v2.1.196 | Un único presionar `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos presiones, con una sugerencia de pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el descargo de responsabilidad de bypass en lugar de ser silenciosamente descartado. Las sesiones interactivas que nunca nombró llevan un nombre predeterminado como `my-app-3f` en listados de sesiones y `claude agents --json`. Los comandos shell en segundo plano y flujos de trabajo dinámicos sobreviven al proceso de la sesión siendo detenido, reiniciado o actualizado, incluso en Windows; establezca `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar la entrega. Una transcripción malinterpretada como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |1156| v2.1.196 | Una sola pulsación de `←` envía al segundo plano una sesión en primer plano; las versiones anteriores requerían dos pulsaciones, con una sugerencia en el pie de página y una confirmación. `--dangerously-skip-permissions` pasado a `claude agents` muestra el aviso de bypass en lugar de descartarse silenciosamente. Las sesiones interactivas que nunca nombraste llevan un nombre predeterminado como `my-app-3f` en los listados de sesiones y en `claude agents --json`. Los comandos de shell en segundo plano y los flujos de trabajo dinámicos sobreviven a que el proceso de la sesión se detenga, se reinicie o se actualice, incluso en Windows; establece `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` para desactivar el traspaso. Una transcripción leída erróneamente como vacía al reiniciar se renombra con un sufijo `.orphaned-` en lugar de eliminarse. |

1154| v2.1.195 | El trabajo en vuelo se traslada cuando envía al segundo plano una sesión en Windows también; establezca `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales cortas. Una versión anterior de Claude Code ya no descarta campos `state.json` más nuevos de sesiones o oculta esas sesiones de `claude agents`. Conectarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |1157| v2.1.195 | El trabajo en curso también se traslada cuando envías una sesión al segundo plano en Windows; establece `CLAUDE_DISABLE_ADOPT=1` para detenerlo en su lugar. El grupo `Completed` llena el espacio vertical restante y el encabezado se compacta en terminales de poca altura. Una versión anterior de Claude Code ya no descarta campos de `state.json` de sesiones más nuevas ni oculta esas sesiones de `claude agents`. Adjuntarse a una sesión detenida cambia inmediatamente en lugar de mostrar una pantalla en blanco durante hasta cinco segundos. Un supervisor que no puede aceptar conexiones sale y libera su bloqueo por sí solo. |

1155| v2.1.191 | `claude --bg` con un nombre `--agent` que no coincide con ninguno de sus subagentes falla el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado. |1158| v2.1.191 | `claude --bg` con un nombre de `--agent` que no coincide con ninguno de tus subagentes hace fallar el lanzamiento: la sesión sale inmediatamente con un error `--agent '<name>' not found` en lugar de ejecutarse con el agente predeterminado. |

1156| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de punto final de puerta de enlace como `ANTHROPIC_BASE_URL` del shell de lanzamiento del supervisor; el supervisor proporciona una instantánea de credencial nueva a workers precalentados, corrigiendo errores espurios de `Could not resolve authentication method`. |1159| v2.1.174 | Las sesiones en segundo plano ya no heredan variables de endpoint de gateway como `ANTHROPIC_BASE_URL` del shell desde el que se lanzó el supervisor; el supervisor proporciona una instantánea de credenciales nueva a los workers precalentados, lo que corrige errores espurios de `Could not resolve authentication method`. |

1157| v2.1.172 | `/model` en la entrada de distribución establece una anulación de modelo de distribución con alcance de sesión. |1160| v2.1.172 | `/model` en la entrada de distribución establece una sobrescritura del modelo de distribución con alcance de sesión. |

1158| v2.1.161 | Los resúmenes de filas muestran un recuento `done/total` para elementos de trabajo paralelos; el panel de vista previa nombra el elemento de trabajo paralelo que más tiempo lleva ejecutándose. |1161| v2.1.161 | Los resúmenes de filas muestran un recuento `done/total` para los elementos de trabajo en paralelo; el panel de vista previa nombra el elemento de trabajo en paralelo que más tiempo lleva ejecutándose. |

1159| v2.1.157 | `claude agents` acepta `--agent`; las sesiones distribuidas honran la configuración `agent`. |1162| v2.1.157 | `claude agents` acepta `--agent`; las sesiones distribuidas respetan el ajuste `agent`. |

1160| v2.1.145 | Dictado de voz compatible en la entrada de respuesta del panel de vista previa y la entrada de distribución. |1163| v2.1.145 | Dictado por voz compatible en la entrada de respuesta del panel de vista previa y en la entrada de distribución. |

1161| v2.1.143 | Se agregó la configuración `worktree.bgIsolation`; `claude agents` acepta `--allow-dangerously-skip-permissions`. |1164| v2.1.143 | Se agregó el ajuste `worktree.bgIsolation`; `claude agents` acepta `--allow-dangerously-skip-permissions`. |

1162| v2.1.142 | `claude agents` acepta `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` y `--strict-mcp-config`. |1165| v2.1.142 | `claude agents` acepta `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config` y `--strict-mcp-config`. |

1163| v2.1.141 | `claude agents` acepta `--cwd` para limitar la lista a un proyecto. |1166| v2.1.141 | `claude agents` acepta `--cwd` para limitar la lista a un proyecto. |

1164| v2.1.139 | La vista de agentes se introdujo como una vista previa de investigación. |1167| v2.1.139 | La vista de agentes se introdujo como una vista previa de investigación. |

Details

147 147 

148* **Haga referencia a archivos con `@`** en lugar de describir dónde vive el código. Claude lee el archivo antes de responder.148* **Haga referencia a archivos con `@`** en lugar de describir dónde vive el código. Claude lee el archivo antes de responder.

149* **Pegue imágenes directamente**. Copie/pegue o arrastre y suelte imágenes en la indicación.149* **Pegue imágenes directamente**. Copie/pegue o arrastre y suelte imágenes en la indicación.

150* **Proporcione URLs** para documentación y referencias de API. Use `/permissions` para permitir dominios de uso frecuente.150* **Proporciona URLs** para documentación y referencias de API. Usa `/permissions` para agregar a la lista de permitidos los dominios de uso frecuente.

151* **Canaliza datos** ejecutando `cat error.log | claude -p "explain this error"` para enviar el contenido de archivos directamente.151* **Canaliza datos** ejecutando `cat error.log | claude -p "explain this error"` para enviar el contenido de archivos directamente.

152* **Deje que Claude obtenga lo que necesita**. Diga a Claude que extraiga contexto por sí mismo usando comandos Bash, herramientas MCP o leyendo archivos.152* **Deje que Claude obtenga lo que necesita**. Diga a Claude que extraiga contexto por sí mismo usando comandos Bash, herramientas MCP o leyendo archivos.

153 153 

channels.md +9 −9

Details

47 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.47 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.

48 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.48 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.

49 49 

50 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos. Verifique el resumen de instalación: si reporta `Run /reload-plugins to activate.`, consulte [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para que el comando de configuración del plugin esté disponible.50 Cuando la instalación solicite un alcance de instalación, elige la opción de alcance de usuario para que el plugin esté disponible en todos tus proyectos. Revisa el resumen de instalación: si reporta `Run /reload-plugins to apply.`, consulta [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para que el comando de configuración del plugin esté disponible.

51 </Step>51 </Step>

52 52 

53 <Step title="Configurar su token">53 <Step title="Configurar tu token">

54 Ejecute el comando de configuración con el token de BotFather:54 Ejecuta el comando de configuración con el token de BotFather:

55 55 

56 ```56 ```

57 /telegram:configure <token>57 /telegram:configure <token>


125 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.125 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.

126 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.126 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.

127 127 

128 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos. Verifique el resumen de instalación: si reporta `Run /reload-plugins to activate.`, consulte [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para que el comando de configuración del plugin esté disponible.128 Cuando la instalación solicite un alcance de instalación, elige la opción de alcance de usuario para que el plugin esté disponible en todos tus proyectos. Revisa el resumen de instalación: si reporta `Run /reload-plugins to apply.`, consulta [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para que el comando de configuración del plugin esté disponible.

129 </Step>129 </Step>

130 130 

131 <Step title="Configurar su token">131 <Step title="Configurar tu token">

132 Ejecute el comando de configuración con el token del bot que copió:132 Ejecuta el comando de configuración con el token del bot que copiaste:

133 133 

134 ```134 ```

135 /discord:configure <token>135 /discord:configure <token>


192 192 

193 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos.193 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos.

194 194 

195 Si el resumen de instalación reporta `Run /reload-plugins to activate.`, no necesita actuar al respecto aquí, porque reiniciar en el siguiente paso recoge el plugin.195 Si el resumen de instalación reporta `Run /reload-plugins to apply.`, no necesitas hacer nada al respecto aquí, porque al reiniciar en el siguiente paso se carga el plugin.

196 </Step>196 </Step>

197 197 

198 <Step title="Reiniciar con canales habilitados">198 <Step title="Reiniciar con canales habilitados">

199 Salga de Claude Code y reinicie con la bandera de canal:199 Sal de Claude Code y reinicia con el flag de canal:

200 200 

201 ```bash theme={null}201 ```bash theme={null}

202 claude --channels plugin:imessage@claude-plugins-official202 claude --channels plugin:imessage@claude-plugins-official


251 251 

252 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos.252 Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos.

253 253 

254 Si el resumen de instalación reporta `Run /reload-plugins to activate.`, no necesita actuar sobre ello aquí, porque reiniciar en el siguiente paso recoge el plugin.254 Si el resumen de instalación reporta `Run /reload-plugins to apply.`, no necesitas hacer nada al respecto aquí, porque al reiniciar en el siguiente paso se carga el plugin.

255 </Step>255 </Step>

256 256 

257 <Step title="Reiniciar con el channel habilitado">257 <Step title="Reiniciar con el channel habilitado">

Details

193claude --dangerously-load-development-channels server:webhook193claude --dangerously-load-development-channels server:webhook

194```194```

195 195 

196Ejecuta la bandera de desarrollo en una sesión interactiva, donde Claude Code puede mostrar la solicitud de confirmación. Si la pasas en modo no interactivo con `-p` o a través del Agent SDK, Claude Code ignora la bandera y el canal no se registra.

197 

196El bypass es por entrada. Combinar esta bandera con `--channels` no extiende el bypass a las entradas `--channels`. Durante la vista previa de investigación, tu canal no está en la lista de aprobación, por lo que permanece en la bandera de desarrollo mientras lo construyes y pruebas.198El bypass es por entrada. Combinar esta bandera con `--channels` no extiende el bypass a las entradas `--channels`. Durante la vista previa de investigación, tu canal no está en la lista de aprobación, por lo que permanece en la bandera de desarrollo mientras lo construyes y pruebas.

197 199 

198<Note>200<Note>

Details

35 Si el campo de entrada de solicitud contiene texto, presionar `Esc` dos veces lo borra en lugar de abrir el menú. El texto borrado se guarda en su historial de entrada, por lo que presione `Arriba` para recuperarlo después de terminar en el menú de rewind.35 Si el campo de entrada de solicitud contiene texto, presionar `Esc` dos veces lo borra en lugar de abrir el menú. El texto borrado se guarda en su historial de entrada, por lo que presione `Arriba` para recuperarlo después de terminar en el menú de rewind.

36</Note>36</Note>

37 37 

38El menú de rewind enumera cada solicitud que envió durante la sesión, excepto [mensajes que se unieron a un turno en ejecución](#messages-sent-mid-turn-not-checkpointed). Seleccione el punto en el que desea actuar y luego elija una acción:38El menú de rewind enumera los prompts que enviaste durante la sesión. Selecciona el punto en el que deseas actuar y luego elige una acción:

39 39 

40* **Restaurar código y conversación**: revierte tanto el código como la conversación a ese punto40* **Restaurar código y conversación**: revierte tanto el código como la conversación a ese punto

41* **Restaurar conversación**: revierte a ese mensaje mientras mantiene el código actual41* **Restaurar conversación**: revierte a ese mensaje mientras mantiene el código actual


114 Los mensajes enviados a mitad de turno no se someten a checkpoint114 Los mensajes enviados a mitad de turno no se someten a checkpoint

115</h3>115</h3>

116 116 

117Cuando un mensaje que [pone en cola mientras Claude trabaja](/docs/es/interactive-mode#queue-messages-while-claude-works) llega a Claude dentro del turno en ejecución, se une a ese turno en lugar de iniciar uno nuevo. El mensaje aparece en la conversación, pero Claude Code no crea un checkpoint para él, y el menú de rewind no lo enumera. Un mensaje en cola que Claude Code envía como parte de un nuevo turno obtiene un checkpoint como de costumbre, incluyendo cuando varios mensajes en cola [comparten ese turno](/docs/es/interactive-mode#when-claude-code-sends-what-you-queued).117Cuando un mensaje que [pones en cola mientras Claude trabaja](/docs/es/interactive-mode#queue-messages-while-claude-works) llega a Claude dentro del turno en ejecución, se une a ese turno en lugar de iniciar uno nuevo. El mensaje aparece en la conversación, pero Claude Code no crea un checkpoint para él. Un mensaje en cola que Claude Code envía como parte de un nuevo turno obtiene un checkpoint como de costumbre, incluyendo cuando varios mensajes en cola [comparten ese turno](/docs/es/interactive-mode#when-claude-code-sends-what-you-queued).

118 118 

119Para eliminar tal mensaje, o deshacer las ediciones que Claude realizó después de que llegara, retroceda al prompt que inició el turno. Eso retrocede todo el turno, incluido el trabajo que Claude realizó antes de que llegara su mensaje.119Para deshacer las ediciones que Claude realizó después de tal mensaje, retrocede al prompt que inició el turno. Eso retrocede todo el turno, incluido el trabajo que Claude realizó antes de que llegara tu mensaje.

120 120 

121<h3 id="symlinked-and-hard-linked-paths-not-restored">121<h3 id="symlinked-and-hard-linked-paths-not-restored">

122 Las rutas con enlaces simbólicos y enlaces duros no se restauran122 Las rutas con enlaces simbólicos y enlaces duros no se restauran

chrome.md +3 −1

Details

45* [Claude Code](/docs/es/quickstart#step-1-install-claude-code)45* [Claude Code](/docs/es/quickstart#step-1-install-claude-code)

46* Un plan directo de Anthropic (Pro, Max, Team o Enterprise)46* Un plan directo de Anthropic (Pro, Max, Team o Enterprise)

47 47 

48La integración de Chrome también requiere iniciar sesión con `/login`. Si te autenticas con una clave API o un token de larga duración de [`claude setup-token`](/docs/es/authentication#generate-a-long-lived-token), Claude Code mantiene la integración de Chrome desactivada, incluso cuando pasas `--chrome`, porque la extensión del navegador no puede autenticarse con esas credenciales. Antes de v2.1.216, estas sesiones podrían habilitar la integración de Chrome, pero cada intento de conectarse a la extensión del navegador fallaba con un error 403.48En las organizaciones Enterprise que tienen HIPAA habilitado, Claude en Chrome está desactivado de forma predeterminada, y un [propietario](/docs/es/server-managed-settings#access-control) puede activarlo en [**Configuración de la organización > Claude en Chrome**](https://claude.ai/admin-settings/browser-extension). Tu Acuerdo de Asociado Comercial (BAA) con Anthropic no cubre los datos enviados a sitios de terceros a través de Claude en Chrome. Consulta la [Guía de implementación](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver una lista de Servicios Elegibles.

49 

50La integración de Chrome también requiere iniciar sesión con `/login`. Si te autenticas con una clave de API o un token de larga duración de [`claude setup-token`](/docs/es/authentication#generate-a-long-lived-token), Claude Code mantiene la integración de Chrome desactivada, incluso cuando pasas `--chrome`, porque la extensión del navegador no puede autenticarse con esas credenciales. Antes de v2.1.216, estas sesiones podían habilitar la integración de Chrome, pero cada intento de conectarse a la extensión del navegador fallaba con un error 403.

49 51 

50<Note>52<Note>

51 La integración de Chrome no está disponible a través de proveedores de terceros como Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Si accedes a Claude exclusivamente a través de un proveedor de terceros, necesitas una cuenta separada de claude.ai para usar esta función.53 La integración de Chrome no está disponible a través de proveedores de terceros como Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Si accedes a Claude exclusivamente a través de un proveedor de terceros, necesitas una cuenta separada de claude.ai para usar esta función.

Details

64Consulta [Conectar desde tu terminal](/docs/es/web-quickstart#connect-from-your-terminal) para el tutorial de `/web-setup`, incluyendo qué almacena `/web-setup` y cómo eliminarlo.64Consulta [Conectar desde tu terminal](/docs/es/web-quickstart#connect-from-your-terminal) para el tutorial de `/web-setup`, incluyendo qué almacena `/web-setup` y cómo eliminarlo.

65 65 

66<Note>66<Note>

67 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada no pueden usar `/web-setup` u otras características de sesión en la nube.67 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada, o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, no pueden usar `/web-setup` u otras características de sesión en la nube.

68</Note>68</Note>

69 69 

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

Details

1582 En cambio, Claude Code elimina estas transcripciones después de `cleanupPeriodDays` en cualquiera de estos casos:1582 En cambio, Claude Code elimina estas transcripciones después de `cleanupPeriodDays` en cualquiera de estos casos:

1583 1583 

1584 * La [configuración administrada](/docs/es/managed-settings) establece `cleanupPeriodDays`1584 * La [configuración administrada](/docs/es/managed-settings) establece `cleanupPeriodDays`

1585 * Tu organización tiene aplicada la configuración HIPAA y Claude Code se conecta directamente a la API de Claude1585 * La [configuración HIPAA se aplica a tus sesiones](/docs/es/hipaa-setup#check-how-developers-sign-in-and-connect)

1586 1586 

1587Claude Code omite el barrido basado en edad en estos casos:1587Claude Code omite el barrido basado en edad en estos casos:

1588 1588 


1619 1619 

1620| Ruta bajo `~/.claude/` | Contenidos |1620| Ruta bajo `~/.claude/` | Contenidos |

1621| - | - |1621| - | - |

1622| `history.jsonl` | Cada prompt que has escrito, con marca de tiempo y ruta del proyecto. Utilizado para recuperación con flecha hacia arriba, búsqueda de historial con `Ctrl+R` y finalización de comandos de shell con `!`. En una organización con la configuración HIPAA aplicada, cada barrido elimina las entradas con más de `cleanupPeriodDays` cuando Claude Code se conecta directamente a la API de Claude. |1622| `history.jsonl` | Cada prompt que has escrito, con marca de tiempo y ruta del proyecto. Utilizado para recuperación con flecha hacia arriba, búsqueda de historial con `Ctrl+R` y finalización de comandos de shell con `!`. Cada barrido elimina las entradas con más de `cleanupPeriodDays` cuando la [configuración HIPAA se aplica a tus sesiones](/docs/es/hipaa-setup#check-how-developers-sign-in-and-connect). |

1623| `stats-cache.json` | Conteos de tokens y costos agregados mostrados por `/usage` |1623| `stats-cache.json` | Conteos de tokens y costos agregados mostrados por `/usage` |

1624| `remote-settings.json` | Copia en caché de [configuración administrada por servidor](/docs/es/server-managed-settings) para su organización, o `{}` cuando su organización no ha configurado ninguna. Solo presente cuando la sesión [las obtiene](/docs/es/server-managed-settings#platform-availability). Claude Code verifica actualizaciones al inicio y cada hora durante una sesión. Claude Code lo elimina cuando cierra sesión. |1624| `remote-settings.json` | Copia en caché de [configuración administrada por servidor](/docs/es/server-managed-settings) para su organización, o `{}` cuando su organización no ha configurado ninguna. Solo presente cuando la sesión [las obtiene](/docs/es/server-managed-settings#platform-availability). Claude Code verifica actualizaciones al inicio y cada hora durante una sesión. Claude Code lo elimina cuando cierra sesión. |

1625| `cache/changelog.md` | Copia en caché del registro de cambios de Claude Code, mostrada por `/release-notes`. Se actualiza en segundo plano. |1625| `cache/changelog.md` | Copia en caché del registro de cambios de Claude Code, mostrada por `/release-notes`. Se actualiza en segundo plano. |

Details

53* Si reporta `Marketplace "claude-plugins-official" not found`, añade el mercado con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintenta la instalación.53* Si reporta `Marketplace "claude-plugins-official" not found`, añade el mercado con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintenta la instalación.

54* Si reporta que no puede [encontrar el plugin en el mercado](/docs/es/plugins/install#install-a-plugin), verifica el nombre del plugin para detectar errores tipográficos.54* Si reporta que no puede [encontrar el plugin en el mercado](/docs/es/plugins/install#install-a-plugin), verifica el nombre del plugin para detectar errores tipográficos.

55 55 

56Verifica el resumen de instalación. Si reporta `Run /reload-plugins to activate.`, consulta [Aplicar cambios de plugins sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para activar el plugin en tu sesión actual.56Verifica el resumen de instalación. Si reporta `Run /reload-plugins to apply.`, consulta [Aplicar cambios de plugins sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para activar el plugin en tu sesión actual.

57 57 

58Una vez que el plugin esté activo, estás listo para [escanear y corregir tu base de código](#scan-and-fix-your-codebase).58Una vez que el plugin esté activo, estás listo para [escanear y corregir tu base de código](#scan-and-fix-your-codebase).

59 59 

Details

28| `claude auth logout` | Cerrar sesión en tu cuenta de Anthropic | `claude auth logout` |28| `claude auth logout` | Cerrar sesión en tu cuenta de Anthropic | `claude auth logout` |

29| `claude auth status` | Mostrar el estado de autenticación como JSON. Usa `--text` para salida legible por humanos. Sale con código 0 si has iniciado sesión, 1 si no. El JSON incluye un campo `configDirectory` que indica el [directorio de configuración](/docs/es/claude-directory) que utiliza la CLI. El campo requiere Claude Code v2.1.268 o posterior. El campo `authMethod` del JSON es uno de `none`, `claude.ai`, `oauth_token`, `api_key`, `api_key_helper` o `third_party` | `claude auth status` |29| `claude auth status` | Mostrar el estado de autenticación como JSON. Usa `--text` para salida legible por humanos. Sale con código 0 si has iniciado sesión, 1 si no. El JSON incluye un campo `configDirectory` que indica el [directorio de configuración](/docs/es/claude-directory) que utiliza la CLI. El campo requiere Claude Code v2.1.268 o posterior. El campo `authMethod` del JSON es uno de `none`, `claude.ai`, `oauth_token`, `api_key`, `api_key_helper` o `third_party` | `claude auth status` |

30| `claude agents` | Abrir la [vista de agentes](/docs/es/agent-view) para monitorear y enviar sesiones en segundo plano paralelas. Usa `--cwd <path>` para mostrar solo las sesiones iniciadas en ese directorio, o `--json` para imprimir las sesiones activas como una matriz JSON para scripts (`--json --all` también incluye las sesiones en segundo plano completadas). Pasa `--permission-mode`, `--model`, `--effort` o `--agent` para establecer [valores predeterminados para las sesiones enviadas](/docs/es/agent-view#permission-mode-model-and-effort). Acepta `--settings`, `--add-dir`, `--plugin-dir` y `--mcp-config` como el comando `claude` de nivel superior. Abrir la vista de agentes requiere una terminal interactiva | `claude agents --json` |30| `claude agents` | Abrir la [vista de agentes](/docs/es/agent-view) para monitorear y enviar sesiones en segundo plano paralelas. Usa `--cwd <path>` para mostrar solo las sesiones iniciadas en ese directorio, o `--json` para imprimir las sesiones activas como una matriz JSON para scripts (`--json --all` también incluye las sesiones en segundo plano completadas). Pasa `--permission-mode`, `--model`, `--effort` o `--agent` para establecer [valores predeterminados para las sesiones enviadas](/docs/es/agent-view#permission-mode-model-and-effort). Acepta `--settings`, `--add-dir`, `--plugin-dir` y `--mcp-config` como el comando `claude` de nivel superior. Abrir la vista de agentes requiere una terminal interactiva | `claude agents --json` |

31| `claude attach <id>` | Adjuntarse a una [sesión en segundo plano](/docs/es/agent-view#manage-sessions-from-the-shell) en esta terminal | `claude attach 7c5dcf5d` |31| `claude attach <id\|name>` | Adjuntarse a una [sesión en segundo plano](/docs/es/agent-view#manage-sessions-from-the-shell) en esta terminal. Pasar parte del nombre de una sesión en ejecución en lugar del ID requiere Claude Code v2.1.290 o posterior | `claude attach 7c5dcf5d` |

32| `claude auto-mode defaults` | Imprimir las reglas integradas del clasificador del [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) como JSON. Usa `claude auto-mode config` para ver tu configuración efectiva con los ajustes aplicados. `--label <prefix>` imprime solo las reglas cuya etiqueta comienza con ese prefijo, sin distinguir mayúsculas y minúsculas. Requiere Claude Code v2.1.208 o posterior | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | Imprimir las reglas integradas del clasificador del [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) como JSON. Usa `claude auto-mode config` para ver tu configuración efectiva con los ajustes aplicados. `--label <prefix>` imprime solo las reglas cuya etiqueta comienza con ese prefijo, sin distinguir mayúsculas y minúsculas. Requiere Claude Code v2.1.208 o posterior | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | Restaurar la configuración predeterminada del [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) eliminando la sección `autoMode` de tu archivo de configuración de usuario. Solicita confirmación antes de escribir; pasa `-y`/`--yes` para omitir la solicitud. Las reglas de la [configuración administrada](/docs/es/server-managed-settings) o del flag `--settings` siguen aplicándose. Requiere Claude Code v2.1.212 o posterior. Consulta [Inspeccionar los valores predeterminados y tu configuración efectiva](/docs/es/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | Restaurar la configuración predeterminada del [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) eliminando la sección `autoMode` de tu archivo de configuración de usuario. Solicita confirmación antes de escribir; pasa `-y`/`--yes` para omitir la solicitud. Las reglas de la [configuración administrada](/docs/es/server-managed-settings) o del flag `--settings` siguen aplicándose. Requiere Claude Code v2.1.212 o posterior. Consulta [Inspeccionar los valores predeterminados y tu configuración efectiva](/docs/es/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |

34| `claude daemon status` | Imprimir el estado del [supervisor](/docs/es/agent-view#the-supervisor-process) de sesiones en segundo plano, su versión, directorio de socket y recuento de trabajadores para diagnósticos. Sale con 1 si el supervisor no se está ejecutando | `claude daemon status` |34| `claude daemon status` | Imprimir el estado del [supervisor](/docs/es/agent-view#the-supervisor-process) de sesiones en segundo plano, su versión, directorio de socket y recuento de trabajadores para diagnósticos. Sale con 1 si el supervisor no se está ejecutando | `claude daemon status` |

35| `claude daemon stop --any` | Detener el [supervisor](/docs/es/agent-view#the-supervisor-process) de sesiones en segundo plano y las sesiones que aloja. Pasa `--keep-workers` para dejar las sesiones en segundo plano en ejecución para que el próximo supervisor se reconecte a ellas. `--any` confirma la detención de un supervisor bajo demanda, que es el predeterminado. Usa esto para recuperarte de un [supervisor que no responde](/docs/es/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |35| `claude daemon stop --any` | Detener el [supervisor](/docs/es/agent-view#the-supervisor-process) de sesiones en segundo plano y las sesiones que aloja. Pasa `--keep-workers` para dejar las sesiones en segundo plano en ejecución para que el próximo supervisor se reconecte a ellas. `--any` confirma la detención de un supervisor bajo demanda, que es el predeterminado. Usa esto para recuperarte de un [supervisor que no responde](/docs/es/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

36| `claude doctor` | Imprimir diagnósticos de solo lectura de instalación y configuración desde la terminal sin iniciar una sesión, incluida la salud de la instalación, los errores de validación de archivos de configuración y la idoneidad para Remote Control. Para la verificación de configuración dentro de la sesión que también puede aplicar correcciones, ejecuta [`/doctor`](/docs/es/commands#all-commands) | `claude doctor` |36| `claude doctor` | Imprimir diagnósticos de solo lectura de instalación y configuración desde la terminal sin iniciar una sesión, incluida la salud de la instalación, los errores de validación de archivos de configuración y la idoneidad para Remote Control. Para la verificación de configuración dentro de la sesión que también puede aplicar correcciones, ejecuta [`/doctor`](/docs/es/commands#all-commands) | `claude doctor` |

37| `claude import [source]` | Iniciar una sesión interactiva que ejecuta [`/import`](/docs/es/commands#all-commands) para traer configuración de otros agentes de codificación a Claude Code. Acepta las mismas opciones `--dry-run` y `--yes` que el comando. No disponible en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ni Claude Platform en AWS. Tampoco está disponible cuando desactivas la [obtención de feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching). Requiere Claude Code v2.1.213 o posterior | `claude import codex --dry-run` |37| `claude import [source]` | Iniciar una sesión interactiva que ejecuta [`/import`](/docs/es/commands#all-commands) para traer configuración de otros agentes de codificación a Claude Code. Acepta las mismas opciones `--dry-run` y `--yes` que el comando. No disponible en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ni Claude Platform en AWS. Tampoco está disponible cuando desactivas la [obtención de feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching). Requiere Claude Code v2.1.213 o posterior | `claude import codex --dry-run` |

38| `claude logs <id>` | Imprimir la salida reciente de una [sesión en segundo plano](/docs/es/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |38| `claude logs <id\|name>` | Imprimir la salida reciente de una [sesión en segundo plano](/docs/es/agent-view#manage-sessions-from-the-shell). Pasar parte del nombre de una sesión en ejecución en lugar del ID requiere Claude Code v2.1.290 o posterior | `claude logs 7c5dcf5d` |

39| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Consulta la [documentación de MCP de Claude Code](/docs/es/mcp). |39| `claude mcp` | Configurar servidores Model Context Protocol (MCP) | Consulta la [documentación de MCP de Claude Code](/docs/es/mcp). |

40| `claude mcp login <name>` | Ejecutar el flujo OAuth de un servidor MCP configurado sin abrir el panel interactivo `/mcp`. Funciona con servidores HTTP, SSE y conectores de claude.ai. Agrega `--no-browser` sobre SSH para imprimir la URL de autorización en lugar de abrir un navegador y luego pega la URL de redirección en el prompt. Consulta [Autenticar desde la línea de comandos](/docs/es/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |40| `claude mcp login <name>` | Ejecutar el flujo OAuth de un servidor MCP configurado sin abrir el panel interactivo `/mcp`. Funciona con servidores HTTP, SSE y conectores de claude.ai. Agrega `--no-browser` sobre SSH para imprimir la URL de autorización en lugar de abrir un navegador y luego pega la URL de redirección en el prompt. Consulta [Autenticar desde la línea de comandos](/docs/es/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

41| `claude mcp logout <name>` | Borrar las credenciales OAuth almacenadas de un servidor MCP | `claude mcp logout sentry` |41| `claude mcp logout <name>` | Borrar las credenciales OAuth almacenadas de un servidor MCP | `claude mcp logout sentry` |


80| `--chrome` | Habilita la [integración del navegador Chrome](/docs/es/chrome) para automatización web y pruebas | `claude --chrome` |80| `--chrome` | Habilita la [integración del navegador Chrome](/docs/es/chrome) para automatización web y pruebas | `claude --chrome` |

81| `--cloud` | Con una descripción de tarea, crea una nueva [sesión en la nube](/docs/es/claude-code-on-the-web). Con un ID de sesión (`session_...` o `cse_...`) o una URL de claude.ai/code, encola un mensaje en esa sesión existente en su lugar, con `-p`. Consulta [enviar un mensaje de seguimiento](/docs/es/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |81| `--cloud` | Con una descripción de tarea, crea una nueva [sesión en la nube](/docs/es/claude-code-on-the-web). Con un ID de sesión (`session_...` o `cse_...`) o una URL de claude.ai/code, encola un mensaje en esa sesión existente en su lugar, con `-p`. Consulta [enviar un mensaje de seguimiento](/docs/es/claude-code-on-the-web#send-follow-ups-from-the-cli). | `claude --cloud "Fix the login bug"` |

82| `--continue`, `-c` | Carga la conversación más reciente en el directorio actual, incluyendo una [sesión en segundo plano que ha terminado](/docs/es/sessions#resume-a-session); abrir sesiones en segundo plano terminadas requiere Claude Code v2.1.257 o posterior. Omite sesiones creadas con `claude -p` o el Agent SDK, y sesiones cuyo primer indicador fue `/loop`. `claude -p --continue` incluye sesiones `-p`, SDK y `/loop`. Incluye sesiones que añadieron este directorio con `/add-dir` | `claude --continue` |82| `--continue`, `-c` | Carga la conversación más reciente en el directorio actual, incluyendo una [sesión en segundo plano que ha terminado](/docs/es/sessions#resume-a-session); abrir sesiones en segundo plano terminadas requiere Claude Code v2.1.257 o posterior. Omite sesiones creadas con `claude -p` o el Agent SDK, y sesiones cuyo primer indicador fue `/loop`. `claude -p --continue` incluye sesiones `-p`, SDK y `/loop`. Incluye sesiones que añadieron este directorio con `/add-dir` | `claude --continue` |

83| `--dangerously-load-development-channels` | Habilita [canales](/docs/es/channels-reference#test-during-the-research-preview) que no están en la lista de permitidos aprobada, para desarrollo local. Acepta entradas `plugin:<name>@<marketplace>` y `server:<name>`. Solicita confirmación | `claude --dangerously-load-development-channels server:webhook` |83| `--dangerously-load-development-channels` | Habilita [canales](/docs/es/channels-reference#test-during-the-research-preview) que no están en la lista de permitidos aprobada, para desarrollo local. Acepta entradas `plugin:<name>@<marketplace>` y `server:<name>`. Solicita confirmación, por lo que tiene efecto en sesiones interactivas. Con `-p`, Claude Code ignora la bandera | `claude --dangerously-load-development-channels server:webhook` |

84| `--dangerously-skip-permissions` | Omite solicitudes de permiso. Equivalente a `--permission-mode bypassPermissions`. Consulta [modos de permisos](/docs/es/permission-modes#skip-all-checks-with-bypasspermissions-mode) para ver qué esto hace y no omite. Para sesiones iniciadas con `--bg`, el modo [persiste cuando el supervisor reinicia la sesión](/docs/es/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Omite solicitudes de permiso. Equivalente a `--permission-mode bypassPermissions`. Consulta [modos de permisos](/docs/es/permission-modes#skip-all-checks-with-bypasspermissions-mode) para ver qué esto hace y no omite. Para sesiones iniciadas con `--bg`, el modo [persiste cuando el supervisor reinicia la sesión](/docs/es/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Habilita el modo de depuración con filtrado de categoría opcional, como `--debug='mcp,startup'` o `--debug='!1p'`. El filtro se vincula solo en la forma `=`; un filtro separado por espacios habilita el modo de depuración sin filtrado | `claude --debug='mcp,startup'` |85| `--debug` | Habilita el modo de depuración con filtrado de categoría opcional, como `--debug='mcp,startup'` o `--debug='!1p'`. El filtro se vincula solo en la forma `=`; un filtro separado por espacios habilita el modo de depuración sin filtrado | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Escribe registros de depuración en una ruta de archivo específica. Habilita implícitamente el modo de depuración. Tiene prioridad sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Escribe registros de depuración en una ruta de archivo específica. Habilita implícitamente el modo de depuración. Tiene prioridad sobre `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |


104| `--input-format` | Especifica el formato de entrada para el modo print (opciones: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |104| `--input-format` | Especifica el formato de entrada para el modo print (opciones: `text`, `stream-json`) | `claude -p --output-format json --input-format stream-json` |

105| `--json-schema` | Obtén salida JSON validada que coincida con un JSON Schema después de que el agente complete su flujo de trabajo (solo modo print). Consulta [salidas estructuradas](/docs/es/agent-sdk/structured-outputs). Claude Code sale con un error en un esquema inválido y acepta la palabra clave `format` como anotación sin validación del lado del cliente | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |105| `--json-schema` | Obtén salida JSON validada que coincida con un JSON Schema después de que el agente complete su flujo de trabajo (solo modo print). Consulta [salidas estructuradas](/docs/es/agent-sdk/structured-outputs). Claude Code sale con un error en un esquema inválido y acepta la palabra clave `format` como anotación sin validación del lado del cliente | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

106| `--maintenance` | Ejecuta [hooks de Setup](/docs/es/hooks#setup) con el matcher `maintenance` antes de la sesión (solo modo print) | `claude -p --maintenance "query"` |106| `--maintenance` | Ejecuta [hooks de Setup](/docs/es/hooks#setup) con el matcher `maintenance` antes de la sesión (solo modo print) | `claude -p --maintenance "query"` |

107| `--max-budget-usd` | Cantidad máxima en dólares a gastar en llamadas de API antes de detener (solo modo print). El gasto de [subagentes](/docs/es/sub-agents) cuenta hacia el límite. Cuando regresas a una conversación con `--continue` o `--resume`, los totales [restaurados de ejecuciones anteriores](/docs/es/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) no cuentan hacia él. Una vez que el gasto alcanza el límite, generar otro subagente falla con `Budget limit reached`, y Claude Code detiene los subagentes en segundo plano que aún se ejecutan; los comportamientos de cumplimiento del límite requieren Claude Code v2.1.217 o posterior | `claude -p --max-budget-usd 5.00 "query"` |107| `--max-budget-usd` | Cantidad máxima en dólares a gastar en llamadas de API antes de detenerse (solo modo print). Claude Code compara el límite con su [estimación de costos del lado del cliente](/docs/es/agent-sdk/cost-tracking#estimates-not-billing), que puede diferir de tu factura. El gasto de [subagentes](/docs/es/sub-agents) cuenta hacia el límite. Cuando regresas a una conversación con `--continue` o `--resume`, los totales [restaurados de ejecuciones anteriores](/docs/es/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) no cuentan hacia él. Una vez que el gasto alcanza el límite, generar otro subagente falla con `Budget limit reached`, y Claude Code detiene los subagentes en segundo plano que aún se ejecutan; los comportamientos de cumplimiento del límite requieren Claude Code v2.1.217 o posterior | `claude -p --max-budget-usd 5.00 "query"` |

108| `--max-turns` | Limita el número de turnos agentivos (solo modo print). Sale con un error cuando se alcanza el límite. Sin límite por defecto. Con `--input-format stream-json`, un mensaje aún en cola cuando el límite termina un turno permanece en cola e inicia un nuevo turno con su propio límite | `claude -p --max-turns 3 "query"` |108| `--max-turns` | Limita el número de turnos agentivos (solo modo print). Sale con un error cuando se alcanza el límite. Sin límite por defecto. Con `--input-format stream-json`, un mensaje aún en cola cuando el límite termina un turno permanece en cola e inicia un nuevo turno con su propio límite | `claude -p --max-turns 3 "query"` |

109| `--mcp-config` | Carga servidores MCP desde archivos JSON o cadenas (separados por espacios). Cuando pasas esta bandera con `-p`, Claude Code espera a que los servidores aún pendientes se conecten antes de ejecutar el primer turno, hasta el tiempo de espera de inicio [`MCP_TIMEOUT`](/docs/es/env-vars), 30 segundos por defecto; un servidor con una [lista de herramientas en caché](/docs/es/mcp#managing-your-servers) omite la espera y se conecta en el primer uso. La espera requiere Claude Code v2.1.221 o posterior | `claude --mcp-config ./mcp.json` |109| `--mcp-config` | Carga servidores MCP desde archivos JSON o cadenas (separados por espacios). Cuando pasas esta bandera con `-p`, Claude Code espera a que los servidores aún pendientes se conecten antes de ejecutar el primer turno, hasta el tiempo de espera de inicio [`MCP_TIMEOUT`](/docs/es/env-vars), 30 segundos por defecto; un servidor con una [lista de herramientas en caché](/docs/es/mcp#managing-your-servers) omite la espera y se conecta en el primer uso. La espera requiere Claude Code v2.1.221 o posterior | `claude --mcp-config ./mcp.json` |

110| `--model` | Establece el modelo para la sesión actual con un [alias de modelo](/docs/es/model-config#model-aliases) como `sonnet`, `opus`, `haiku`, o `fable`, o el nombre completo de un modelo. Anula la configuración [`model`](/docs/es/settings-reference#model) y [`ANTHROPIC_MODEL`](/docs/es/model-config#environment-variables) | `claude --model claude-sonnet-5` |110| `--model` | Establece el modelo para la sesión actual con un [alias de modelo](/docs/es/model-config#model-aliases) como `sonnet`, `opus`, `haiku`, o `fable`, o el nombre completo de un modelo. Anula la configuración [`model`](/docs/es/settings-reference#model) y [`ANTHROPIC_MODEL`](/docs/es/model-config#environment-variables) | `claude --model claude-sonnet-5` |

code-review.md +3 −3

Details

7> Configure revisiones automatizadas de PR que detecten errores lógicos, vulnerabilidades de seguridad y regresiones mediante análisis multiagente de su base de código completa7> Configure revisiones automatizadas de PR que detecten errores lógicos, vulnerabilidades de seguridad y regresiones mediante análisis multiagente de su base de código completa

8 8 

9<Note>9<Note>

10 Code Review está en vista previa de investigación, disponible para suscripciones de [Team y Enterprise](https://claude.ai/admin-settings/claude-code). No está disponible para organizaciones con [Zero Data Retention](/docs/es/zero-data-retention) habilitado. En otros planes, aún puede [revisar un diff localmente](#review-a-diff-locally) con el comando `/code-review`.10 Code Review está en vista previa de investigación, disponible para suscripciones de [Team y Enterprise](https://claude.ai/admin-settings/claude-code). No está disponible para organizaciones con [Zero Data Retention](/docs/es/zero-data-retention) habilitado o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, y no está cubierto por el BAA de Anthropic. En otros planes, aún puedes [revisar un diff localmente](#review-a-diff-locally) con el comando `/code-review`.

11</Note>11</Note>

12 12 

13Code Review analiza sus solicitudes de extracción de GitHub y publica hallazgos como comentarios en línea en las líneas de código donde encontró problemas. Una flota de agentes especializados examina los cambios de código en el contexto de su base de código completa, buscando errores lógicos, vulnerabilidades de seguridad, casos límite rotos y regresiones sutiles.13Code Review analiza sus solicitudes de extracción de GitHub y publica hallazgos como comentarios en línea en las líneas de código donde encontró problemas. Una flota de agentes especializados examina los cambios de código en el contexto de su base de código completa, buscando errores lógicos, vulnerabilidades de seguridad, casos límite rotos y regresiones sutiles.


370* En una sesión de terminal, donde `/code-review` ejecuta la revisión como un [subagente bifurcado](/docs/es/skills#run-skills-in-a-subagent)370* En una sesión de terminal, donde `/code-review` ejecuta la revisión como un [subagente bifurcado](/docs/es/skills#run-skills-in-a-subagent)

371* En una ejecución `-p` con salida de texto o JSON371* En una ejecución `-p` con salida de texto o JSON

372 372 

373En una aplicación host que solicita la lista de hallazgos, como la [aplicación de escritorio](/docs/es/desktop), Claude reporta los hallazgos de la revisión a través de la herramienta [`ReportFindings`](/docs/es/tools-reference). Claude Code renderiza el informe como una lista de hallazgos, y cada entrada muestra la ubicación del archivo, un resumen de una oración y una etiqueta de categoría como `correctness` cuando el hallazgo lleva una. Una solicitud de host se aplica en cada nivel de esfuerzo y requiere Claude Code v2.1.218 o posterior.373En una aplicación host que solicita la lista de hallazgos, como la [aplicación de escritorio](/docs/es/desktop#review-your-code), Claude reporta los hallazgos de la revisión a través de la herramienta [`ReportFindings`](/docs/es/tools-reference). Claude Code renderiza el informe como una lista de hallazgos, y cada entrada muestra la ubicación del archivo, un resumen de una oración y una etiqueta de categoría como `correctness` cuando el hallazgo lleva una. Una solicitud de host se aplica en cada nivel de esfuerzo y requiere Claude Code v2.1.218 o posterior.

374 374 

375Cuando Claude corrige hallazgos reportados más adelante en la sesión, los reporta nuevamente, y Claude Code marca cada hallazgo en la lista de hallazgos actualizada como corregido, omitido o sin cambios necesarios.375Cuando Claude corrige hallazgos reportados más adelante en la sesión, los reporta nuevamente, y Claude Code marca cada hallazgo en la lista de hallazgos actualizada como corregido, omitido o sin cambios necesarios.

376 376 


434Cuando el objetivo es una solicitud de extracción de `github.com`, puede hacer que Claude [publique los hallazgos terminados en el PR](/docs/es/ultrareview#post-findings-to-the-pull-request) como un comentario desde su cuenta de GitHub. Requiere Claude Code v2.1.227 o posterior.434Cuando el objetivo es una solicitud de extracción de `github.com`, puede hacer que Claude [publique los hallazgos terminados en el PR](/docs/es/ultrareview#post-findings-to-the-pull-request) como un comentario desde su cuenta de GitHub. Requiere Claude Code v2.1.227 o posterior.

435 435 

436<Note>436<Note>

437 Ultrareview requiere autenticación con una cuenta de claude.ai y no está disponible en Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry, ni para organizaciones con Zero Data Retention habilitado. Cuando ultrareview no está disponible, `/code-review ultra` ejecuta una revisión local en su sesión en su lugar.437 Ultrareview requiere autenticación con una cuenta de claude.ai y no está disponible en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, ni para organizaciones con Zero Data Retention habilitado o con la [configuración de HIPAA](/docs/es/hipaa-setup) aplicada. Cuando ultrareview no está disponible, `/code-review ultra` ejecuta una revisión local en tu sesión en su lugar.

438</Note>438</Note>

439 439 

440Para ejecutar una revisión en la nube desde un script o un job de CI, usa el [subcomando `claude ultrareview`](/docs/es/ultrareview#run-ultrareview-non-interactively), que espera los hallazgos y los imprime en stdout.440Para ejecutar una revisión en la nube desde un script o un job de CI, usa el [subcomando `claude ultrareview`](/docs/es/ultrareview#run-ultrareview-non-interactively), que espera los hallazgos y los imprime en stdout.

commands.md +2 −2

Details

10 10 

11Escribe `/` para ver los comandos disponibles para ti, o escribe `/` seguido de letras para filtrar. [Cómo el menú de comandos coincide con lo que escribes](#how-the-command-menu-matches-what-you-type) explica el resaltado, los errores tipográficos y los pocos comandos que Claude Code oculta del menú hasta que escribes su nombre completo.11Escribe `/` para ver los comandos disponibles para ti, o escribe `/` seguido de letras para filtrar. [Cómo el menú de comandos coincide con lo que escribes](#how-the-command-menu-matches-what-you-type) explica el resaltado, los errores tipográficos y los pocos comandos que Claude Code oculta del menú hasta que escribes su nombre completo.

12 12 

13Un comando solo se reconoce al inicio de tu mensaje. El texto que sigue al nombre del comando se convierte en sus argumentos. A partir de la v2.1.199, los [skills](/docs/es/skills#pass-arguments-to-skills) son la excepción: una invocación de un skill seguida de más skills, como `/skill-a /skill-b do XYZ`, carga todos los skills nombrados al inicio y pasa el texto restante a cada uno como argumentos. Se pueden encadenar hasta seis skills.13Un comando solo se reconoce al inicio de tu mensaje. El texto que sigue al nombre del comando se convierte en sus argumentos. Los [skills](/docs/es/skills#pass-arguments-to-skills) son la excepción: una invocación de un skill seguida de más skills, como `/skill-a /skill-b do XYZ`, carga los skills nombrados al inicio y pasa el texto restante a cada uno como argumentos. Se pueden encadenar hasta seis skills.

14 14 

15Si envías un comando mientras Claude está respondiendo, Claude Code lo pone en cola y lo ejecuta cuando termina el turno actual. Claude Code ejecuta algunos comandos de inmediato sin interrumpir la respuesta, como `/status`, `/tasks` y `/usage`. En el [renderizado de pantalla completa](/docs/es/fullscreen), Claude Code también abre de inmediato los comandos de diálogo como `/theme` y `/help`. Antes de la v2.1.234, Claude Code ponía en cola esos diálogos hasta que terminaba el turno.15Si envías un comando mientras Claude está respondiendo, Claude Code lo pone en cola y lo ejecuta cuando termina el turno actual. Claude Code ejecuta algunos comandos de inmediato sin interrumpir la respuesta, como `/status`, `/tasks` y `/usage`. En el [renderizado de pantalla completa](/docs/es/fullscreen), Claude Code también abre de inmediato los comandos de diálogo como `/theme` y `/help`. Antes de la v2.1.234, Claude Code ponía en cola esos diálogos hasta que terminaba el turno.

16 16 


140| `/run-skill-generator` | **[Skill](/docs/es/skills#bundled-skills).** Enséñales a `/run` y `/verify` cómo compilar, iniciar y manejar la app de tu proyecto desde un entorno limpio escribiendo un [skill](/docs/es/skills#run-and-verify-your-app) por proyecto |140| `/run-skill-generator` | **[Skill](/docs/es/skills#bundled-skills).** Enséñales a `/run` y `/verify` cómo compilar, iniciar y manejar la app de tu proyecto desde un entorno limpio escribiendo un [skill](/docs/es/skills#run-and-verify-your-app) por proyecto |

141| `/sandbox` | Activa o desactiva el [modo sandbox](/docs/es/sandboxing). Disponible solo en plataformas compatibles |141| `/sandbox` | Activa o desactiva el [modo sandbox](/docs/es/sandboxing). Disponible solo en plataformas compatibles |

142| `/schedule [description]` | Crea, actualiza, enumera o ejecuta [rutinas](/docs/es/routines), que se ejecutan en la nube. Claude te guía por la configuración de forma conversacional. También puedes preguntar por las [ejecuciones recientes de una rutina](/docs/es/routines#manage-routines-from-the-cli). Alias: `/routines` |142| `/schedule [description]` | Crea, actualiza, enumera o ejecuta [rutinas](/docs/es/routines), que se ejecutan en la nube. Claude te guía por la configuración de forma conversacional. También puedes preguntar por las [ejecuciones recientes de una rutina](/docs/es/routines#manage-routines-from-the-cli). Alias: `/routines` |

143| `/scroll-speed` | Ajusta de forma interactiva la [velocidad de desplazamiento](/docs/es/fullscreen#mouse-wheel-scrolling) de la rueda del mouse, con una regla que puedes desplazar mientras el diálogo está abierto para previsualizar el cambio. Disponible solo en [renderizado de pantalla completa](/docs/es/fullscreen) y no en la terminal del IDE de JetBrains |143| `/scroll-speed` | Ajusta de forma interactiva la [velocidad de desplazamiento](/docs/es/fullscreen#mouse-wheel-scrolling) de la rueda del mouse. Disponible solo en [renderizado de pantalla completa](/docs/es/fullscreen) y no en la terminal del IDE de JetBrains |

144| `/security-review` | Analiza los cambios de tu rama actual en busca de vulnerabilidades de seguridad. Revisa el diff entre tu rama y la rama predeterminada de origin, identificando riesgos como inyección, problemas de autenticación y exposición de datos. Necesita un remoto `origin`; si la revisión falla con un error `ambiguous argument`, consulta la [referencia de errores](/docs/es/errors#security-review-fails-without-origin-head) |144| `/security-review` | Analiza los cambios de tu rama actual en busca de vulnerabilidades de seguridad. Revisa el diff entre tu rama y la rama predeterminada de origin, identificando riesgos como inyección, problemas de autenticación y exposición de datos. Necesita un remoto `origin`; si la revisión falla con un error `ambiguous argument`, consulta la [referencia de errores](/docs/es/errors#security-review-fails-without-origin-head) |

145| `/setup-bedrock` | Configura la autenticación, la región y los modelos fijados de [Amazon Bedrock](/docs/es/amazon-bedrock) mediante un asistente interactivo. [Oculto en el menú de comandos](#how-the-command-menu-matches-what-you-type) hasta que se establece `CLAUDE_CODE_USE_BEDROCK=1`; escríbelo completo. Los usuarios que usan Amazon Bedrock por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |145| `/setup-bedrock` | Configura la autenticación, la región y los modelos fijados de [Amazon Bedrock](/docs/es/amazon-bedrock) mediante un asistente interactivo. [Oculto en el menú de comandos](#how-the-command-menu-matches-what-you-type) hasta que se establece `CLAUDE_CODE_USE_BEDROCK=1`; escríbelo completo. Los usuarios que usan Amazon Bedrock por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |

146| `/setup-vertex` | Configura la autenticación, el proyecto, la región y los modelos fijados de [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) mediante un asistente interactivo. [Oculto en el menú de comandos](#how-the-command-menu-matches-what-you-type) hasta que se establece `CLAUDE_CODE_USE_VERTEX=1`; escríbelo completo. Los usuarios que usan Google Cloud's Agent Platform por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |146| `/setup-vertex` | Configura la autenticación, el proyecto, la región y los modelos fijados de [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) mediante un asistente interactivo. [Oculto en el menú de comandos](#how-the-command-menu-matches-what-you-type) hasta que se establece `CLAUDE_CODE_USE_VERTEX=1`; escríbelo completo. Los usuarios que usan Google Cloud's Agent Platform por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |

Details

229 229 

230Claude puede generar pruebas que sigan los patrones y convenciones existentes de su proyecto. Al solicitar pruebas, sea específico sobre qué comportamiento desea verificar. Claude examina sus archivos de prueba existentes para coincidir con el estilo, marcos y patrones de afirmación ya en uso.230Claude puede generar pruebas que sigan los patrones y convenciones existentes de su proyecto. Al solicitar pruebas, sea específico sobre qué comportamiento desea verificar. Claude examina sus archivos de prueba existentes para coincidir con el estilo, marcos y patrones de afirmación ya en uso.

231 231 

232Para una cobertura integral, pida a Claude que identifique casos extremos que podría haber perdido. Claude puede analizar sus rutas de código y sugerir pruebas para condiciones de error, valores límite e entradas inesperadas que son fáciles de pasar por alto.232Para mejorar la cobertura, pide a Claude que identifique casos extremos que podrías haber pasado por alto. Claude puede analizar tus rutas de código y sugerir pruebas para condiciones de error, valores límite y entradas inesperadas que a menudo se pasan por alto.

233 233 

234***234***

235 235 

Details

1604| Memoria automática | Re-inyectada desde el disco |1604| Memoria automática | Re-inyectada desde el disco |

1605| [Instantánea de estado de Git](/docs/es/settings-reference#includegitinstructions) | Claude Code lee una nueva desde su repositorio |1605| [Instantánea de estado de Git](/docs/es/settings-reference#includegitinstructions) | Claude Code lee una nueva desde su repositorio |

1606| El plan que Claude escribió en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-inyectado desde el disco |1606| El plan que Claude escribió en [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode) | Re-inyectado desde el disco |

1607| Reglas con frontmatter `paths:` | Claude Code las recarga cuando Claude lee archivos que coinciden |1607| Reglas con frontmatter `paths:` | Claude Code las recarga [bajo demanda](/docs/es/memory#path-specific-rules) |

1608| CLAUDE.md anidado en subdirectorios | Claude Code lo recarga cuando Claude lee archivos en ese subdirectorio |1608| CLAUDE.md anidado en subdirectorios | Claude Code los recarga [bajo demanda](/docs/es/memory#how-claude-md-files-load) |

1609| Archivos que Claude leyó o editó | Claude Code re-lee hasta cinco, los más recientemente modificados primero |1609| Archivos que Claude leyó o editó | Claude Code re-lee hasta cinco, los más recientemente modificados primero |

1610| Cuerpos de skills invocados | Re-inyectados, limitados a 5,000 tokens por skill y 25,000 tokens en total; los más antiguos se descartan primero |1610| Cuerpos de skills invocados | Re-inyectados, limitados a 5,000 tokens por skill y 25,000 tokens en total; los más antiguos se descartan primero |

1611| [Comandos en segundo plano](/docs/es/interactive-mode#background-bash-commands) y [subagentes](/docs/es/sub-agents#run-subagents-in-foreground-or-background) en segundo plano | Continúan ejecutándose. Claude Code le recuerda a Claude cuáles siguen ejecutándose para que no inicie uno duplicado |1611| [Comandos en segundo plano](/docs/es/interactive-mode#background-bash-commands) y [subagentes](/docs/es/sub-agents#run-subagents-in-foreground-or-background) en segundo plano | Continúan ejecutándose. Claude Code le recuerda a Claude cuáles siguen ejecutándose para que no inicie uno duplicado |

costs.md +2 −2

Details

37 37 

38Estos totales se restablecen cuando `/clear` inicia una nueva sesión, por lo que el costo total de la siguiente sesión comienza en \$0. Antes de v2.1.211, continuaban acumulándose en `/clear` durante la vida útil del proceso de Claude Code.38Estos totales se restablecen cuando `/clear` inicia una nueva sesión, por lo que el costo total de la siguiente sesión comienza en \$0. Antes de v2.1.211, continuaban acumulándose en `/clear` durante la vida útil del proceso de Claude Code.

39 39 

40Para una respuesta de la API de Claude facturada a la [tasa de residencia de datos](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1.1×, Claude Code multiplica el precio de lista de los tokens de esa respuesta por 1.1 en la cifra de costo de sesión. El mismo total aparece en el [campo de costo de la línea de estado](/docs/es/statusline#cost-and-duration-tracking), y la cifra multiplicada también cuenta hacia [`--max-budget-usd`](/docs/es/cli-reference#cli-flags). Antes de v2.1.239, Claude Code no aplicaba el 1.1× a esas respuestas, por lo que la cifra de costo de sesión era menor que la factura.40Para una respuesta de la API de Claude facturada a la [tarifa de residencia de datos](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing) de 1.1×, Claude Code multiplica el precio de lista de los tokens de esa respuesta por 1.1 en la cifra de costo de sesión. El mismo total aparece en el [campo de costo de la línea de estado](/docs/es/statusline#cost-and-duration-tracking), y la cifra multiplicada también cuenta para [`--max-budget-usd`](/docs/es/cli-reference#cli-flags).

41 41 

42<h4 id="prompt-cache-statistics">42<h4 id="prompt-cache-statistics">

43 Estadísticas de caché de indicaciones43 Estadísticas de caché de indicaciones


262 262 

263Use `/usage` para verificar su uso actual de tokens, o [configure su línea de estado](/docs/es/statusline#context-window-usage) para mostrarla continuamente.263Use `/usage` para verificar su uso actual de tokens, o [configure su línea de estado](/docs/es/statusline#context-window-usage) para mostrarla continuamente.

264 264 

265* **Limpie entre tareas**: Use `/clear` para comenzar de nuevo cuando cambie a trabajo no relacionado. El contexto obsoleto desperdicia tokens en cada mensaje posterior. Use `/rename` antes de limpiar para que pueda encontrar fácilmente la sesión más tarde, luego `/resume` para volver a ella.265* **Limpia entre tareas**: Usa `/clear` para comenzar de nuevo cuando cambies a trabajo no relacionado. El contexto obsoleto desperdicia tokens en cada mensaje posterior. Usa `/rename` antes de limpiar para que puedas encontrar la sesión más tarde, luego `/resume` para volver a ella.

266* **Agregue instrucciones de compactación personalizadas**: `/compact Focus on code samples and API usage` le dice a Claude qué preservar durante la summarización.266* **Agregue instrucciones de compactación personalizadas**: `/compact Focus on code samples and API usage` le dice a Claude qué preservar durante la summarización.

267 267 

268También puede personalizar el comportamiento de compactación en su archivo CLAUDE.md en la raíz de su proyecto:268También puede personalizar el comportamiento de compactación en su archivo CLAUDE.md en la raíz de su proyecto:

Details

29| `/debug [issue]` | Habilita el registro de depuración para la sesión e indica a Claude que diagnostique usando la salida del registro y las rutas de configuración |29| `/debug [issue]` | Habilita el registro de depuración para la sesión e indica a Claude que diagnostique usando la salida del registro y las rutas de configuración |

30| `/status` | Fuentes de configuración activas, incluido si la configuración administrada está en vigor |30| `/status` | Fuentes de configuración activas, incluido si la configuración administrada está en vigor |

31 31 

32Si falta un archivo de memoria en el desglose de `/context`, verifica su ubicación contra [cómo se cargan los archivos CLAUDE.md](/docs/es/memory#how-claude-md-files-load). Los archivos `CLAUDE.md` del subdirectorio se cargan bajo demanda después de que Claude usa la herramienta Read, Write o Edit en un archivo de ese directorio, no al inicio de la sesión.32Si falta un archivo de memoria en el desglose de `/context`, verifica su ubicación contra [cómo se cargan los archivos CLAUDE.md](/docs/es/memory#how-claude-md-files-load). Los archivos `CLAUDE.md` de subdirectorios se cargan bajo demanda en lugar de al inicio de la sesión, por lo que no aparecen en ese desglose.

33 33 

34Si `/context` confirma que el archivo se cargó pero Claude aún no sigue una instrucción particular, el problema probablemente sea cómo se escribe la instrucción en lugar de si se cargó. CLAUDE.md funciona bien para el tipo de orientación que daría a un nuevo compañero de equipo, como convenciones de proyecto, comandos de compilación y dónde pertenecen los archivos.34Si `/context` confirma que el archivo se cargó pero Claude aún no sigue una instrucción particular, el problema probablemente sea cómo se escribe la instrucción en lugar de si se cargó. CLAUDE.md funciona bien para el tipo de orientación que daría a un nuevo compañero de equipo, como convenciones de proyecto, comandos de compilación y dónde pertenecen los archivos.

35 35 


116| Un valor `settings.json` parece ignorado | La misma clave se establece en `settings.local.json` | `settings.local.json` anula `settings.json`, y ambos anulan `~/.claude/settings.json`. Consulte [precedencia de configuración](/docs/es/settings#settings-precedence). |116| Un valor `settings.json` parece ignorado | La misma clave se establece en `settings.local.json` | `settings.local.json` anula `settings.json`, y ambos anulan `~/.claude/settings.json`. Consulte [precedencia de configuración](/docs/es/settings#settings-precedence). |

117| Skill no aparece en `/skills` | El archivo de skill está en `.claude/skills/name.md` en lugar de en una carpeta | Use una carpeta con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |117| Skill no aparece en `/skills` | El archivo de skill está en `.claude/skills/name.md` en lugar de en una carpeta | Use una carpeta con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

118| Skill aparece en `/skills` pero Claude nunca lo invoca | Skill tiene `disable-model-invocation: true` en su frontmatter, o su descripción no coincide con cómo formula la solicitud | Verifique la insignia en `/skills`: una etiqueta "user-only" significa que Claude no lo activará por su cuenta. Consulte [invocación de skill](/docs/es/skills). |118| Skill aparece en `/skills` pero Claude nunca lo invoca | Skill tiene `disable-model-invocation: true` en su frontmatter, o su descripción no coincide con cómo formula la solicitud | Verifique la insignia en `/skills`: una etiqueta "user-only" significa que Claude no lo activará por su cuenta. Consulte [invocación de skill](/docs/es/skills). |

119| Las instrucciones de `CLAUDE.md` del subdirectorio parecen ignoradas | Los archivos del subdirectorio se cargan bajo demanda, no al inicio de la sesión | Se cargan después de que Claude usa la herramienta Read, Write o Edit en un archivo de ese directorio, no al iniciar. Antes de v2.1.288, solo la herramienta Read los cargaba. Consulta [cómo se cargan los archivos CLAUDE.md](/docs/es/memory#how-claude-md-files-load). |119| Las instrucciones de `CLAUDE.md` del subdirectorio parecen ignoradas | Los archivos del subdirectorio se cargan bajo demanda, no al inicio de la sesión | Consulta [cuándo se cargan los archivos del subdirectorio](/docs/es/memory#how-claude-md-files-load). Antes de v2.1.288, solo la herramienta Read los cargaba. |

120| El subagente ignora las instrucciones de `CLAUDE.md` | Los agentes Explore y Plan integrados omiten `CLAUDE.md`. Un subagente personalizado lo carga de la misma manera que la conversación principal, a menos que su definición establezca [`omitClaudeMd`](/docs/es/sub-agents#supported-frontmatter-fields) | Para Explore o Plan, restate la instrucción en su indicador delegado. Para un subagente que establece `omitClaudeMd`, elimine el campo. Para cualquier otro subagente personalizado, coloque las instrucciones críticas en el cuerpo del archivo del agente, que se convierte en el indicador del sistema del agente. Consulte [qué se carga al inicio](/docs/es/sub-agents#what-loads-at-startup). |120| El subagente ignora las instrucciones de `CLAUDE.md` | Los agentes Explore y Plan integrados omiten `CLAUDE.md`. Un subagente personalizado lo carga de la misma manera que la conversación principal, a menos que su definición establezca [`omitClaudeMd`](/docs/es/sub-agents#supported-frontmatter-fields) | Para Explore o Plan, restate la instrucción en su indicador delegado. Para un subagente que establece `omitClaudeMd`, elimine el campo. Para cualquier otro subagente personalizado, coloque las instrucciones críticas en el cuerpo del archivo del agente, que se convierte en el indicador del sistema del agente. Consulte [qué se carga al inicio](/docs/es/sub-agents#what-loads-at-startup). |

121| La lógica de limpieza nunca se ejecuta al final de la sesión | No hay hook `SessionEnd` configurado | Agregue un hook `SessionEnd` en `settings.json`. Consulte la [lista de eventos de hook](/docs/es/hooks#hook-events). |121| La lógica de limpieza nunca se ejecuta al final de la sesión | No hay hook `SessionEnd` configurado | Agregue un hook `SessionEnd` en `settings.json`. Consulte la [lista de eventos de hook](/docs/es/hooks#hook-events). |

122| Los servidores MCP en `.mcp.json` nunca se cargan | El archivo está bajo `.claude/`, o sus servidores se encuentran bajo una clave `servers` de nivel superior, como en el `mcp.json` de VS Code, en lugar de `mcpServers` | La configuración de MCP del proyecto va en la raíz del repositorio como `.mcp.json`, no dentro de `.claude/`, con servidores bajo la clave `mcpServers`. Consulte [configuración de MCP](/docs/es/mcp). |122| Los servidores MCP en `.mcp.json` nunca se cargan | El archivo está bajo `.claude/`, o sus servidores se encuentran bajo una clave `servers` de nivel superior, como en el `mcp.json` de VS Code, en lugar de `mcpServers` | La configuración de MCP del proyecto va en la raíz del repositorio como `.mcp.json`, no dentro de `.claude/`, con servidores bajo la clave `mcpServers`. Consulte [configuración de MCP](/docs/es/mcp). |

desktop.md +75 −68

Details

124 124 

125* Interactuar con su aplicación en ejecución directamente en el panel del navegador125* Interactuar con su aplicación en ejecución directamente en el panel del navegador

126* Ver a Claude verificar sus propios cambios automáticamente: toma capturas de pantalla, inspecciona el DOM, hace clic en elementos, completa formularios y corrige problemas que encuentra126* Ver a Claude verificar sus propios cambios automáticamente: toma capturas de pantalla, inspecciona el DOM, hace clic en elementos, completa formularios y corrige problemas que encuentra

127* Iniciar o detener servidores desde el menú desplegable de servidores en la barra de herramientas de la sesión127* Iniciar o detener servidores, o detenerlos todos a la vez, desde el menú **Dev servers** en el encabezado del panel del navegador

128* Persistir cookies y almacenamiento local en reinicios del servidor seleccionando **Persist sessions** en el menú desplegable, para que no tenga que volver a iniciar sesión durante el desarrollo128* Elegir si el navegador conserva las cookies después de salir de la aplicación con **Keep cookies** en el menú **⋮** del panel del navegador, para que no tengas que volver a iniciar sesión durante el desarrollo

129* Editar la configuración del servidor o detener todos los servidores a la vez

130 129 

131Claude crea la configuración inicial del servidor basada en su proyecto. Si su aplicación usa un comando de desarrollo personalizado, edite `.claude/launch.json` para que coincida con su configuración. Consulte [Configurar servidores de vista previa](#configure-preview-servers) para la referencia completa.130Claude crea la configuración inicial del servidor basada en su proyecto. Si su aplicación usa un comando de desarrollo personalizado, edite `.claude/launch.json` para que coincida con su configuración. Consulte [Configurar servidores de vista previa](#configure-preview-servers) para la referencia completa.

132 131 

133Para borrar datos de sesión guardados, o para desactivar el navegador por completo, use los controles deslizantes en Configuración → Claude Code.132Para borrar los datos guardados del navegador, selecciona **Clear browsing data** en el menú **⋮** del panel del navegador. Para desactivar el navegador por completo, desactiva **Browser tools** en **Configuración > Claude Code**.

134 133 

135<h3 id="browse-external-sites">134<h3 id="browse-external-sites">

136 Examinar sitios externos135 Examinar sitios externos

137</h3>136</h3>

138 137 

139El panel del navegador es un navegador con pestañas, por lo que puede abrir documentación, rastreadores de problemas o cualquier otro sitio junto a su aplicación en ejecución. Para abrir el navegador, presione **Cmd+Shift+B** en macOS o **Ctrl+Shift+B** en Windows, o selecciónelo del menú **Views**. Cuando hace clic en un enlace externo en el chat, un selector ofrece **Open in app** para usar el panel del navegador u **Default browser** para usar el suyo propio; **Cmd**-clic en macOS o **Ctrl**-clic en Windows abre un enlace en su navegador del sistema directamente. Puede iniciar sesión en sitios en el panel, incluidos flujos de inicio de sesión emergentes como Google OAuth.138El 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.

139 

140La primera vez que haces clic en un enlace externo en el chat, un diálogo te pregunta si los enlaces se abren en el panel del navegador o en tu navegador predeterminado. Para cambiar tu elección más adelante, usa **Open links in built-in browser** en el menú **⋮** del panel del navegador. **Cmd**-clic en macOS o **Ctrl**-clic en Windows abre un enlace directamente en tu navegador predeterminado.

140 141 

141Claude puede leer e interactuar con páginas externas usando las mismas herramientas que usa para [verificar su aplicación](#preview-your-app), con dos verificaciones de seguridad adicionales:142Claude puede leer e interactuar con páginas externas usando las mismas herramientas que usa para [verificar su aplicación](#preview-your-app), con dos verificaciones de seguridad adicionales:

142 143 


184 Revisar su código185 Revisar su código

185</h3>186</h3>

186 187 

187En la vista de diferencias, haga clic en **Review code** en la barra de herramientas superior derecha para pedirle a Claude que evalúe los cambios antes de confirmar. Claude examina las diferencias actuales y deja comentarios directamente en la vista de diferencias. Puede responder a cualquier comentario o pedirle a Claude que revise.188Para que Claude revise tus cambios antes de hacer commit, escribe `/code-review` en el [cuadro de prompt](#use-the-prompt-box). Los hallazgos llegan a la conversación cuando la revisión se completa.

189 

190En las sesiones locales, [SSH](#ssh-sessions) y [WSL](/docs/es/desktop-wsl), los hallazgos aparecen como una tarjeta **Code review**, agrupados por archivo. Usa la tarjeta para actuar sobre ellos:

188 191 

189La revisión se enfoca en problemas de alta señal: errores de compilación, errores de lógica definitivos, vulnerabilidades de seguridad y errores obvios. No marca estilo, formato, problemas preexistentes o nada que un linter detectaría.192* Haz clic en **Walk through in diff** para abrir la vista de diff y recorrer los hallazgos uno por uno. Un hallazgo en el diff actual aparece en su línea, donde puedes hacer clic en **Fix this one** o descartarlo.

193* Haz clic en **Apply fixes** para pedirle a Claude que corrija los hallazgos que siguen abiertos.

194 

195En cualquier sesión, también puedes pedirle a Claude en el cuadro de prompt que corrija lo que encontró la revisión. Para saber qué busca `/code-review` y qué argumentos acepta, consulta [Revisar un diff localmente](/docs/es/code-review#review-a-diff-locally).

190 196 

191<h3 id="monitor-pull-request-status">197<h3 id="monitor-pull-request-status">

192 Monitorear el estado de la solicitud de extracción198 Monitorear el estado de la solicitud de extracción


194 200 

195Después de abrir una solicitud de extracción, aparece una barra de estado de CI en la sesión. Claude Code usa la CLI de GitHub para sondear resultados de verificación y mostrar fallas.201Después de abrir una solicitud de extracción, aparece una barra de estado de CI en la sesión. Claude Code usa la CLI de GitHub para sondear resultados de verificación y mostrar fallas.

196 202 

197* **Auto-fix**: cuando está habilitado, Claude intenta automáticamente corregir verificaciones de CI fallidas leyendo la salida de falla e iterando.203* **Auto-fix CI & address comments**: cuando está habilitado, Claude intenta automáticamente corregir las verificaciones de CI fallidas leyendo la salida de la falla e iterando. En una sesión local, Claude también atiende los nuevos comentarios de revisión que deja alguien distinto de ti, cuando el autor es el propietario del repositorio, un miembro de la organización, un colaborador o una GitHub App.

198* **Auto-merge**: cuando está habilitado, Claude fusiona el PR una vez que todas las verificaciones pasan. El método de fusión es squash. Habilite auto-merge en su [configuración de repositorio de GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository) primero; sin esto, Claude no puede fusionar el PR.204* **Auto-merge when ready**: cuando está habilitado, Claude fusiona el PR una vez que todas las verificaciones pasan. El método de fusión es squash. Habilita primero auto-merge en la [configuración de tu repositorio de GitHub](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository); sin esto, Claude no puede fusionar el PR.

199 205 

200Use los controles deslizantes **Auto-fix** y **Auto-merge** en la barra de estado de CI para habilitar cualquiera de las opciones. Claude Code también envía una notificación de escritorio cuando CI finaliza. Para archivar la sesión automáticamente una vez que el PR se fusiona o cierra, active [auto-archive](#work-in-parallel-with-sessions) en Configuración → Claude Code.206Para activarlas, haz clic en **CI** en la barra de estado. Para archivar la sesión automáticamente una vez que el PR se fusiona o se cierra, activa [auto-archive](#work-in-parallel-with-sessions) en **Configuración > Claude Code**.

201 207 

202<Note>208<Note>

203 El monitoreo de PR requiere que la [CLI de GitHub (`gh`)](https://cli.github.com/) esté instalada y autenticada en su máquina. Si `gh` no está instalado, Desktop le solicita que lo instale la primera vez que intente crear un PR.209 El monitoreo de PR requiere que la [CLI de GitHub (`gh`)](https://cli.github.com/) esté instalada y autenticada en su máquina. Si `gh` no está instalado, Desktop le solicita que lo instale la primera vez que intente crear un PR.


207 Organizar su espacio de trabajo213 Organizar su espacio de trabajo

208</h2>214</h2>

209 215 

210La pestaña Code está construida alrededor de paneles que puede organizar en cualquier diseño: chat, diff, navegador, terminal, archivo, plan, tareas y subagente, junto con el [iOS Simulator](/docs/es/desktop-ios-simulator) en macOS. Arrastre un panel por su encabezado para reposicionarlo, o arrastre un borde de panel para redimensionarlo. Presione **Cmd+\\** en macOS o **Ctrl+\\** en Windows para cerrar el panel enfocado. Abra paneles adicionales desde el menú **Views** en la barra de herramientas de la sesión.216La pestaña Code está construida alrededor de paneles que puedes organizar en cualquier diseño: chat, diff, navegador, terminal, archivo, plan, tareas y subagente, junto con el [iOS Simulator](/docs/es/desktop-ios-simulator) en macOS. Arrastra un panel por su encabezado para reposicionarlo, o arrastra un borde de panel para redimensionarlo. Presiona **Cmd+\\** en macOS o **Ctrl+\\** en Windows para cerrar el panel enfocado. Haz clic en **Terminal**, **Changes** o **Browser** en la barra de título de la sesión para abrir el panel de terminal, de diff o de navegador. El menú **⋮** junto a ellos abre más paneles, como **Files**, y contiene esos botones cuando la ventana es demasiado estrecha para mostrarlos.

211 217 

212Para trabajar en múltiples pantallas, extraiga un panel como el diff o terminal en su propia ventana, y acóplelo de nuevo cuando haya terminado. Claude continúa trabajando en la ventana principal.218Para trabajar en múltiples pantallas, extraiga un panel como el diff o terminal en su propia ventana, y acóplelo de nuevo cuando haya terminado. Claude continúa trabajando en la ventana principal.

213 219 


219 Ejecutar comandos en la terminal225 Ejecutar comandos en la terminal

220</h3>226</h3>

221 227 

222La terminal integrada le permite ejecutar comandos junto a su sesión sin cambiar a otra aplicación. Ábrala desde el menú **Views** o presione **Ctrl+\`** en macOS o Windows. La terminal se abre en el directorio de trabajo de su sesión y comparte el mismo entorno que Claude, por lo que comandos como `npm test` o `git status` ven los mismos archivos que Claude está editando. Para abrir una segunda pestaña de terminal, haga clic en **+** en el encabezado del panel de terminal o haga clic con el botón derecho en una carpeta en el chat para elegir **Open in terminal**. La terminal está disponible solo en sesiones locales.228La terminal integrada te permite ejecutar comandos junto a tu sesión sin cambiar a otra aplicación. Haz clic en **Terminal** en la barra de título de la sesión o presiona **Ctrl+\`** en macOS o Windows. La terminal se abre en el directorio de trabajo de tu sesión y comparte el mismo entorno que Claude, por lo que comandos como `npm test` o `git status` ven los mismos archivos que Claude está editando. Para abrir una segunda pestaña de terminal, haz clic en **+** en el encabezado del panel de terminal o haz clic con el botón derecho en una carpeta en el chat para elegir **Open in terminal**. La terminal está disponible solo en sesiones locales.

223 229 

224<h3 id="open-and-edit-files">230<h3 id="open-and-edit-files">

225 Abrir y editar archivos231 Abrir y editar archivos


410 Ver tareas en segundo plano416 Ver tareas en segundo plano

411</h3>417</h3>

412 418 

413El panel de tareas muestra el trabajo en segundo plano que se ejecuta dentro de la sesión actual: subagentes, comandos de shell en segundo plano y [flujos de trabajo dinámicos](/docs/es/workflows). Ábrelo desde el menú **Views** o arrástralo a tu diseño.419El panel de tareas muestra el trabajo en segundo plano que se ejecuta dentro de la sesión actual: subagentes, comandos de shell en segundo plano y [flujos de trabajo dinámicos](/docs/es/workflows). Una vez que la sesión tiene trabajo en segundo plano, abre el panel con **Background tasks** en el menú **⋮** de la barra de título.

414 420 

415Haz clic en cualquier entrada para ver su salida en el panel de subagente o detenerla. Para ver qué están haciendo otras sesiones, usa la [barra lateral](#work-in-parallel-with-sessions), o pide a Claude que [las revise por ti](#work-across-sessions).421Haz clic en cualquier entrada para ver su salida en el panel de subagente o detenerla. Para ver qué están haciendo otras sesiones, usa la [barra lateral](#work-in-parallel-with-sessions), o pide a Claude que [las revise por ti](#work-across-sessions).

416 422 


518 524 

519Claude detecta automáticamente su configuración de servidor de desarrollo y almacena la configuración en `.claude/launch.json` en la raíz de la carpeta que seleccionó al iniciar la sesión. Preview usa esta carpeta como su directorio de trabajo, por lo que si seleccionó una carpeta principal, las subcarpetas con sus propios servidores de desarrollo no se detectarán automáticamente. Para trabajar con el servidor de una subcarpeta, inicie una sesión en esa carpeta directamente o agregue una configuración manualmente.525Claude detecta automáticamente su configuración de servidor de desarrollo y almacena la configuración en `.claude/launch.json` en la raíz de la carpeta que seleccionó al iniciar la sesión. Preview usa esta carpeta como su directorio de trabajo, por lo que si seleccionó una carpeta principal, las subcarpetas con sus propios servidores de desarrollo no se detectarán automáticamente. Para trabajar con el servidor de una subcarpeta, inicie una sesión en esa carpeta directamente o agregue una configuración manualmente.

520 526 

521Para personalizar cómo se inicia su servidor, por ejemplo para usar `yarn dev` en lugar de `npm run dev` o para cambiar el puerto, edite el archivo manualmente o haga clic en **Edit configuration** en el menú desplegable del servidor para abrirlo en su editor de código. El archivo admite JSON con comentarios.527Para personalizar cómo se inicia tu servidor, por ejemplo para usar `yarn dev` en lugar de `npm run dev` o para cambiar el puerto, edita `.claude/launch.json`. El archivo admite JSON con comentarios.

522 528 

523```json theme={null}529```json theme={null}

524{530{


542 548 

543Cuando `autoVerify` está habilitado, Claude verifica automáticamente cambios de código después de editar archivos. Toma capturas de pantalla, verifica errores y confirma que los cambios funcionan antes de completar su respuesta.549Cuando `autoVerify` está habilitado, Claude verifica automáticamente cambios de código después de editar archivos. Toma capturas de pantalla, verifica errores y confirma que los cambios funcionan antes de completar su respuesta.

544 550 

545Auto-verify está habilitado de forma predeterminada. Desactívelo por proyecto agregando `"autoVerify": false` a `.claude/launch.json`, o alterne desde el menú desplegable del servidor.551Auto-verify está habilitado de forma predeterminada. Desactívalo por proyecto agregando `"autoVerify": false` a `.claude/launch.json`, o desactiva **Auto-verify changes** en el menú **⋮** del panel Browser.

546 552 

547```json theme={null}553```json theme={null}

548{554{


766 772 

767Las sesiones SSH le permiten ejecutar Claude Code en una máquina remota mientras usa la aplicación de escritorio como su interfaz. Esto es útil para trabajar con bases de código que viven en máquinas virtuales en la nube, contenedores de desarrollo o servidores con hardware o dependencias específicas.773Las sesiones SSH le permiten ejecutar Claude Code en una máquina remota mientras usa la aplicación de escritorio como su interfaz. Esto es útil para trabajar con bases de código que viven en máquinas virtuales en la nube, contenedores de desarrollo o servidores con hardware o dependencias específicas.

768 774 

769Para agregar una conexión SSH, haga clic en el menú desplegable de entorno antes de iniciar una sesión y seleccione **+ Add SSH connection**. El diálogo solicita:775Para agregar una conexión SSH, abre el menú desplegable de entorno en el cuadro de prompt antes de iniciar una sesión, luego selecciona **SSH > Add SSH connection…** y completa los detalles de la conexión:

770 776 

771* **Name**: una etiqueta amigable para esta conexión777* **Name**: una etiqueta amigable para esta conexión

772* **SSH Host**: `user@hostname` o un host definido en `~/.ssh/config`778* **SSH host**: `user@hostname` o un host definido en `~/.ssh/config`

773* **SSH Port**: por defecto es 22 si se deja vacío, o usa el puerto de su configuración SSH779* **SSH port**: por defecto es 22 si se deja vacío, o usa el puerto de tu configuración SSH

774* **Identity File**: ruta a su clave privada, como `~/.ssh/id_rsa`. Déjelo vacío para usar la clave predeterminada o su configuración SSH.780* **SSH key (optional)**: ruta a tu clave privada, como `~/.ssh/id_ed25519`. Déjalo vacío para usar tu configuración SSH o tu agente SSH.

775 781 

776Una vez agregada, la conexión aparece en el menú desplegable de entorno. Selecciónela para iniciar una sesión en esa máquina. Claude se ejecuta en la máquina remota con acceso a sus archivos y herramientas.782Una vez agregada, la conexión aparece en **SSH** en el menú desplegable de entorno. Selecciónala para iniciar una sesión en esa máquina. Claude se ejecuta en la máquina remota con acceso a sus archivos y herramientas.

777 783 

778La máquina remota debe ejecutar Linux o macOS. La aplicación de escritorio instala Claude Code en la máquina remota automáticamente la primera vez que se conecta. Una vez conectado, las sesiones SSH admiten modos de permisos, conectores, plugins y servidores MCP.784La máquina remota debe ejecutar Linux o macOS. La aplicación de escritorio instala Claude Code en la máquina remota automáticamente la primera vez que se conecta. Una vez conectado, las sesiones SSH admiten modos de permisos, conectores, plugins y servidores MCP.

779 785 


823 Configuración empresarial829 Configuración empresarial

824</h2>830</h2>

825 831 

826Las organizaciones en planes Team o Enterprise pueden gestionar el comportamiento de la aplicación de escritorio a través de controles de consola de administración, archivos de configuración administrados y políticas de gestión de dispositivos.832Las organizaciones en planes Team o Enterprise pueden gestionar el comportamiento de la aplicación de escritorio a través de controles de consola de administración, archivos de configuración administrada y políticas de gestión de dispositivos.

827 833 

828<h3 id="admin-console-controls">834<h3 id="admin-console-controls">

829 Controles de consola de administración835 Controles de consola de administración

830</h3>836</h3>

831 837 

832Estas configuraciones se configuran a través de la [consola de configuración de administración](https://claude.ai/admin-settings/claude-code):838Estas configuraciones se establecen a través de la [consola de configuración de administración](https://claude.ai/admin-settings/claude-code):

839 

840* **Desktop**: controla si los usuarios de tu organización pueden acceder a Claude Code en la aplicación de escritorio

841* **Cloud sessions**: habilita o deshabilita las [sesiones en la nube](/docs/es/claude-code-on-the-web) para tu organización

842* **Remote Control**: habilita o deshabilita [Remote Control](/docs/es/remote-control) para tu organización

833 843 

834* **Code in the desktop**: controle si los usuarios en su organización pueden acceder a Claude Code en la aplicación de escritorio844En las organizaciones Enterprise que tienen HIPAA habilitado, el interruptor **Desktop** está desactivado de forma predeterminada y un [Owner](/docs/es/server-managed-settings#access-control) puede activarlo. Aplicar la [configuración de HIPAA](/docs/es/hipaa-setup) lo desactiva, aunque estuviera activado, por lo que un Owner debe activarlo después. **Cloud sessions** y **Remote Control** también están desactivados de forma predeterminada, y un Owner no puede activarlos una vez que la organización tiene aplicada la configuración de HIPAA.

835* **Code in the web**: habilite o deshabilite [sesiones en la nube](/docs/es/claude-code-on-the-web) para su organización

836* **Remote Control**: habilite o deshabilite [Remote Control](/docs/es/remote-control) para su organización

837* **Disable Bypass permissions mode**: evite que los usuarios en su organización habiliten el modo bypass permissions

838 845 

839<Note>846<Note>

840 El formulario de OpenTelemetry para Cowork bajo **Monitoring** en la [configuración de datos y privacidad](https://claude.ai/admin-settings/data-privacy-controls) de la consola de administración se aplica solo a sesiones de Cowork. En una sesión de Cowork en esta máquina, la aplicación de escritorio pasa ese recopilador a Claude Code como variables de entorno `OTEL_*`, por lo que el formulario tiene efecto aunque Claude Code en esa sesión [nunca obtiene configuraciones de consola de administración](#managed-settings).847 El formulario de OpenTelemetry para Cowork bajo **Monitoring** en la [configuración de datos y privacidad](https://claude.ai/admin-settings/data-privacy-controls) de la consola de administración se aplica solo a sesiones de Cowork. En una sesión de Cowork en esta máquina, la aplicación de escritorio pasa ese recopilador a Claude Code como variables de entorno `OTEL_*`, por lo que el formulario tiene efecto aunque Claude Code en esa sesión [nunca obtiene la configuración de la consola de administración](#managed-settings).

841 848 

842 Para exportar telemetría desde sesiones de la pestaña Code, establezca `CLAUDE_CODE_ENABLE_TELEMETRY` y las variables `OTEL_*` en el bloque `env` de su configuración administrada de Claude Code, como se muestra en [configuración de administrador para monitoreo](/docs/es/monitoring-usage#administrator-configuration). Las sesiones locales, en la nube y SSH leen [configuración administrada desde diferentes fuentes](#managed-settings). Para los hosts que una sesión en la nube puede alcanzar, consulte [acceso a la red](/docs/es/cloud-environments#network-access). Para el `service.name` que las sesiones de la pestaña Code reportan, consulte [información de servicio](/docs/es/monitoring-usage#service-information).849 Para exportar telemetría desde sesiones de la pestaña Code, establece `CLAUDE_CODE_ENABLE_TELEMETRY` y las variables `OTEL_*` en el bloque `env` de tu configuración administrada de Claude Code, como se muestra en [configuración de administrador para monitoreo](/docs/es/monitoring-usage#administrator-configuration). Las sesiones locales, en la nube y SSH leen [configuración administrada desde diferentes fuentes](#managed-settings). Para los hosts que una sesión en la nube puede alcanzar, consulta [acceso a la red](/docs/es/cloud-environments#network-access). Para el `service.name` que las sesiones de la pestaña Code reportan, consulta [información de servicio](/docs/es/monitoring-usage#service-information).

843</Note>850</Note>

844 851 

845<h3 id="managed-settings">852<h3 id="managed-settings">

846 Configuración administrada853 Configuración administrada

847</h3>854</h3>

848 855 

849La configuración administrada anula la configuración del proyecto y usuario y se aplica a las sesiones de Claude Code en Desktop. Puede establecer estas claves en el archivo de [configuración administrada](/docs/es/managed-settings) de su organización o enviarlas de forma remota a través de la consola de administración.856La configuración administrada sobrescribe la configuración del proyecto y del usuario y se aplica a las sesiones de Claude Code en Desktop. Puedes establecer estas claves en el archivo de [configuración administrada](/docs/es/managed-settings) de tu organización o enviarlas de forma remota a través de la consola de administración.

850 857 

851| Clave | Descripción |858| Clave | Descripción |

852| - | - |859| - | - |

853| `permissions.disableBypassPermissionsMode` | establezca en `"disable"` para evitar que los usuarios habiliten el modo bypass permissions. |860| `permissions.disableBypassPermissionsMode` | establécelo en `"disable"` para evitar que los usuarios habiliten el modo Bypass permissions. |

854| `disableAutoMode` | establezca en `"disable"` para eliminar el modo [Auto](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) del selector de modo. También aceptado bajo `permissions`. |861| `disableAutoMode` | establécelo en `"disable"` para eliminar el modo [Auto](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) del selector de modo. También se acepta bajo `permissions`. |

855| `autoMode` | personalice lo que el clasificador de modo auto confía y bloquea en toda su organización. Consulte [Configurar el modo auto](/docs/es/auto-mode-config). |862| `autoMode` | personaliza lo que el clasificador del modo automático considera confiable y bloquea en toda tu organización. Consulta [Configurar el modo automático](/docs/es/auto-mode-config). |

856| `browserExternalPageTools` | establezca 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. |863| `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. |

857| `disableMobileSimulatorTools` | establezca en `true` para bloquear las herramientas de Claude para controlar y capturar dispositivos en el [panel del simulador de iOS](/docs/es/desktop-ios-simulator#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. |864| `disableMobileSimulatorTools` | establécelo en `true` para bloquear las herramientas de Claude para controlar y capturar dispositivos en el [panel del simulador de iOS](/docs/es/desktop-ios-simulator#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. |

858| `disableBrowserExternalNavigation` | establezca 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. El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |865| `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. El valor debe ser el booleano JSON `true`; la cadena `"true"` se ignora. |

859| `sshConfigs` | pre-configure [conexiones SSH](#pre-configure-ssh-connections-for-your-team) que aparecen en el menú desplegable de entorno. Los usuarios no pueden editar ni eliminar conexiones administradas. |866| `sshConfigs` | preconfigura [conexiones SSH](#pre-configure-ssh-connections-for-your-team) que aparecen en el menú desplegable de entorno. Los usuarios no pueden editar ni eliminar conexiones administradas. |

860| `sshHostAllowlist` | restrinja [sesiones SSH](#restrict-which-ssh-hosts-users-can-connect-to) a hosts cuyo nombre de host resuelto coincida con uno de estos patrones. Una matriz vacía deshabilita las sesiones SSH. Se lee solo desde configuración administrada. |867| `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. Una matriz vacía deshabilita las sesiones SSH. Se lee solo desde la configuración administrada. |

861| `disableDesktopLocalSessions` | establezca en `true` para desactivar [sesiones de Code que se ejecutan en el dispositivo](#local-sessions-on-managed-devices), dejando disponibles las sesiones SSH a otros hosts y sesiones en la nube. El valor debe ser el booleano JSON `true`. Se lee solo desde configuración administrada. Requiere Claude Desktop v1.37937.0 o posterior. |868| `disableDesktopLocalSessions` | establécelo en `true` para desactivar las [sesiones de Code que se ejecutan en el dispositivo](#local-sessions-on-managed-devices), dejando disponibles las sesiones SSH a otros hosts y las sesiones en la nube. El valor debe ser el booleano JSON `true`. Se lee solo desde la configuración administrada. Requiere Claude Desktop v1.37937.0 o posterior. |

862| `managedMcpServers` | envíe configuraciones de servidor MCP a todos los usuarios. Disponible solo en implementaciones de Desktop de terceros (3P). En cada entrada, establezca un transporte de `"http"`, `"sse"` o `"stdio"`, detalles de conexión y opcionalmente un mapa `toolPolicy` para restringir qué herramientas de ese servidor pueden invocar los usuarios. Entregue esto a través del archivo de configuración administrada, MDM o la política de bloque [`desktop`](/docs/es/claude-apps-gateway-config#claude-desktop-overlay) de una puerta de enlace de aplicaciones Claude, ya que las implementaciones de terceros no reciben configuraciones de consola de administración. Para entregarlo a través de la puerta de enlace, necesita Claude Code v2.1.232 o posterior en el servidor de la puerta de enlace. Este es la clave propia de la aplicación de escritorio; Claude Code lee una [configuración administrada con el mismo nombre](/docs/es/managed-mcp#provide-servers-through-managed-settings) propia, con una forma de entrada diferente. |869| `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`](/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](/docs/es/managed-mcp#provide-servers-through-managed-settings) propio, con una forma de entrada diferente. |

863 870 

864Qué 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`](/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 terminal; consulte [cobertura de superficie](/docs/es/model-config#surface-coverage).871Qué 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`](/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](/docs/es/model-config#surface-coverage).

865 872 

866* **Sesiones locales en esta máquina**: se aplica un archivo de configuración administrada implementado en disco. La configuración administrada enviada de forma remota a través de la consola de administración también llega a estas sesiones en la API de Anthropic cuando la sesión se autentica con un [inicio de sesión o clave elegible](/docs/es/server-managed-settings#platform-availability), siguiendo la misma [precedencia de configuración](/docs/es/settings#settings-precedence) que la CLI de terminal.873* **Sesiones locales en esta máquina**: se aplica un archivo de configuración administrada desplegado en disco. La configuración administrada enviada de forma remota a través de la consola de administración también llega a estas sesiones en la API de Anthropic cuando la sesión se autentica con un [inicio de sesión o clave elegible](/docs/es/server-managed-settings#platform-availability), siguiendo la misma [precedencia de configuración](/docs/es/settings#settings-precedence) que la CLI de la terminal.

867* **[Sesiones en la nube](#cloud-sessions)**: reciben [configuración administrada por servidor](/docs/es/server-managed-settings); los archivos implementados en dispositivos no llegan a ellas, porque se ejecutan en máquinas virtuales administradas por Anthropic. Las sesiones enrutadas a un [entorno autohospedado](/docs/es/self-hosted-environments) también leen el archivo de configuración administrada en la imagen del ejecutor. [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica cuándo se aplica ese archivo.874* **[Sesiones en la nube](#cloud-sessions)**: reciben [configuración administrada por servidor](/docs/es/server-managed-settings); los archivos desplegados en dispositivos no llegan a ellas, porque se ejecutan en máquinas virtuales administradas por Anthropic. Las sesiones enrutadas a un [entorno autohospedado](/docs/es/self-hosted-environments) también leen el archivo de configuración administrada en la imagen del ejecutor. [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica cuándo se aplica ese archivo.

868* **[Sesiones SSH](#ssh-sessions)**: la sesión lee el archivo de configuración administrada desde el host remoto. Desktop mismo lee `sshConfigs`, `sshHostAllowlist` y `disableDesktopLocalSessions` desde la configuración administrada de la máquina local.875* **[Sesiones SSH](#ssh-sessions)**: la sesión lee el archivo de configuración administrada desde el host remoto. Desktop mismo lee `sshConfigs`, `sshHostAllowlist` y `disableDesktopLocalSessions` desde la configuración administrada de la máquina local.

869* **Sesiones [Cowork](https://claude.com/docs/cowork/overview)**: en una sesión de Cowork en esta máquina, Claude Code nunca obtiene configuraciones de consola de administración, incluso cuando el usuario inicia sesión con una cuenta de Team o Enterprise, y lee la política implementada en la máquina a menos que su configuración de Claude Desktop establezca `requireCoworkFullVmSandbox`. Las sesiones remotas de Cowork no reciben ninguna. Consulte [dónde y cuándo se aplica una política](/docs/es/managed-settings#where-and-when-a-policy-applies) para saber qué archivos de dispositivo llegan a Cowork, y [reglas de permisos de MCP](/docs/es/permissions#mcp) para saber cómo se aplican las reglas de `Bash` y `WebFetch` a las herramientas de Cowork.876* **Sesiones de [Cowork](https://claude.com/docs/cowork/overview)**: en una sesión de Cowork en esta máquina, Claude Code nunca obtiene la configuración de la consola de administración, incluso cuando el usuario inicia sesión con una cuenta de Team o Enterprise, y lee la política desplegada en la máquina a menos que tu configuración de Claude Desktop establezca `requireCoworkFullVmSandbox`. Las sesiones remotas de Cowork no reciben ninguna de las dos. Consulta [dónde y cuándo se aplica una política](/docs/es/managed-settings#where-and-when-a-policy-applies) para saber qué archivos de dispositivo llegan a Cowork, y [reglas de permisos de MCP](/docs/es/permissions#mcp) para saber cómo se aplican las reglas de `Bash` y `WebFetch` a las herramientas de Cowork.

870 877 

871En sesiones locales y SSH, la aplicación de escritorio entrega los conectores de claude.ai conectados de cada usuario a Claude Code directamente. Ninguna configuración de MCP o `managed-mcp.json` llega a esos conectores, cualquiera que sea la fuente de configuración o ubicación de archivo que utilice. Para bloquear las herramientas de un conector en estas sesiones, use los [controles de herramientas de conector](/docs/es/mcp#organization-controls-on-connector-tools) de su organización. [Cómo los conectores llegan a Claude Code](/docs/es/mcp#how-connectors-reach-claude-code) muestra qué configuración rige los conectores en cada tipo de sesión.878En sesiones locales y SSH, la aplicación de escritorio entrega directamente a Claude Code los conectores de claude.ai conectados de cada usuario. Ningún ajuste de MCP ni `managed-mcp.json` llega a esos conectores, cualquiera que sea la fuente de configuración o ubicación de archivo que uses. Para bloquear las herramientas de un conector en estas sesiones, usa los [controles de herramientas de conectores](/docs/es/mcp#organization-controls-on-connector-tools) de tu organización. [Cómo los conectores llegan a Claude Code](/docs/es/mcp#how-connectors-reach-claude-code) muestra qué configuración rige los conectores en cada tipo de sesión.

872 879 

873`permissions.disableBypassPermissionsMode` y `disableAutoMode` también funcionan en configuración de usuario y proyecto, pero colocarlos en configuración administrada evita que los usuarios los anulen.880`permissions.disableBypassPermissionsMode` y `disableAutoMode` también funcionan en la configuración de usuario y de proyecto, pero colocarlos en la configuración administrada evita que los usuarios los sobrescriban.

874 881 

875Para las claves de permiso, plugin y entrega que solo una fuente administrada puede establecer, consulte [Claves que solo la configuración administrada puede establecer](/docs/es/managed-settings#managed-only-settings).882Para las claves de permisos, plugins y entrega que solo una fuente administrada puede establecer, consulta [Claves que solo la configuración administrada puede establecer](/docs/es/managed-settings#managed-only-settings).

876 883 

877<h3 id="device-management-policies">884<h3 id="device-management-policies">

878 Políticas de gestión de dispositivos885 Políticas de gestión de dispositivos

879</h3>886</h3>

880 887 

881Los equipos de TI pueden gestionar la aplicación de escritorio a través de MDM en macOS o política de grupo en Windows. Las políticas disponibles incluyen habilitar o deshabilitar la función Claude Code, controlar actualizaciones automáticas y establecer una URL de implementación personalizada.888Los equipos de TI pueden gestionar la aplicación de escritorio a través de MDM en macOS o de directivas de grupo en Windows. Las políticas disponibles incluyen habilitar o deshabilitar la función Claude Code, controlar las actualizaciones automáticas y establecer una URL de despliegue personalizada.

882 889 

883* **macOS**: configure a través del dominio de preferencia `com.anthropic.claudefordesktop` usando herramientas como Jamf o Kandji890* **macOS**: configura a través del dominio de preferencias `com.anthropic.claudefordesktop` usando herramientas como Jamf o Kandji

884* **Windows**: configure a través del registro en `SOFTWARE\Policies\Claude`891* **Windows**: configura a través del registro en `SOFTWARE\Policies\Claude`

885 892 

886<h3 id="network-access-requirements">893<h3 id="network-access-requirements">

887 Requisitos de acceso a la red894 Requisitos de acceso a la red

888</h3>895</h3>

889 896 

890Desktop carga su código de aplicación y contenido de usuario desde hosts de CDN de Anthropic.897Desktop carga su código de aplicación y el contenido de usuario desde hosts de CDN de Anthropic.

891 898 

892```text theme={null}899```text theme={null}

893anthropic.com900anthropic.com


902*.claudemcpcontent.com909*.claudemcpcontent.com

903```910```

904 911 

905El tráfico es HTTPS en el puerto 443 a menos que configure un puerto personalizado para [OTLP](/docs/es/monitoring-usage), una puerta de enlace LLM o un servidor MCP.912El tráfico es HTTPS en el puerto 443 a menos que configures un puerto personalizado para [OTLP](/docs/es/monitoring-usage), un gateway LLM o un servidor MCP.

906 913 

907Para servidores proxy, autoridades de certificados personalizadas, mTLS y los dominios que necesita la CLI independiente, consulte [configuración de red](/docs/es/network-config).914Para servidores proxy, autoridades de certificación personalizadas, mTLS y los dominios que necesita la CLI independiente, consulta [configuración de red](/docs/es/network-config).

908 915 

909Para reducir el número de caracteres comodín de firewall, permita estos hosts de Anthropic en su lugar. Ciertos subdominios se generan dinámicamente y deben permanecer como caracteres comodín.916Para reducir el número de comodines en el firewall, permite estos hosts de Anthropic en su lugar. Ciertos subdominios se generan dinámicamente y deben permanecer como comodines.

910 917 

911```text theme={null}918```text theme={null}

912anthropic.com919anthropic.com


928*.claudemcpcontent.com935*.claudemcpcontent.com

929```936```

930 937 

931Si su organización tiene [restricción de IP](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) habilitada para Claude, enrute `bridge.claudeusercontent.com` a través de la misma salida de proxy que `claude.ai` y `api.anthropic.com`. Si no puede enrutarlo de esa manera, agregue la dirección de salida que su proxy usa para ese host a la lista de permitidos de IP de su organización, pero solo cuando esa dirección esté dedicada a su organización: un rango de salida de proxy compartido también admite a otros clientes del proveedor de proxy.938Si tu organización tiene habilitada la [lista de IP permitidas](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) para Claude, enruta `bridge.claudeusercontent.com` a través de la misma salida de proxy que `claude.ai` y `api.anthropic.com`. Si no puedes enrutarlo de esa manera, agrega la dirección de salida que tu proxy usa para ese host a la lista de IP permitidas de tu organización, pero solo cuando esa dirección esté dedicada a tu organización: un rango de salida de proxy compartido también admite a otros clientes del proveedor del proxy.

932 939 

933Anthropic verifica las conexiones a ese host contra la lista de permitidos de IP de su organización usando la dirección desde la que llegan. Si su proxy envía tráfico para él a través de una dirección que no está en esa lista de permitidos, Claude en Chrome y otras características que se conectan a través del puente dejan de funcionar mientras el resto de la aplicación sigue funcionando.940Anthropic verifica las conexiones a ese host contra la lista de IP permitidas de tu organización usando la dirección desde la que llegan. Si tu proxy envía el tráfico para ese host a través de una dirección que no está en esa lista de permitidos, Claude en Chrome y otras funciones que se conectan a través del puente dejan de funcionar, mientras que el resto de la aplicación sigue funcionando.

934 941 

935Un [artefacto](/docs/es/artifacts) que carga una fuente tipográfica desde [Google Fonts](/docs/es/artifacts#improve-the-visual-design) también solicita `fonts.googleapis.com` y `fonts.gstatic.com`. Ambos hosts son opcionales. Si los bloquea, los artefactos se renderizan en fuentes tipográficas alternativas. Bloquee con un rechazo rápido en lugar de una caída silenciosa para que la solicitud de fuente falle inmediatamente en lugar de retrasar el primer renderizado de la página.942Un [artefacto](/docs/es/artifacts) que carga una fuente tipográfica desde [Google Fonts](/docs/es/artifacts#improve-the-visual-design) también solicita `fonts.googleapis.com` y `fonts.gstatic.com`. Ambos hosts son opcionales. Si los bloqueas, los artefactos se renderizan con fuentes tipográficas de respaldo. Bloquéalos con un rechazo rápido en lugar de un descarte silencioso para que la solicitud de la fuente falle inmediatamente en lugar de retrasar el primer renderizado de la página.

936 943 

937Los artefactos también pueden cargar bibliotecas de JavaScript, como React o un paquete de gráficos, desde `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` y `unpkg.com`, y desde ningún otro host externo. Si bloquea esos hosts, las partes de un artefacto que dependen de una biblioteca no funcionan, y a diferencia de una fuente bloqueada, una biblioteca bloqueada no tiene alternativa. Bloquee con un rechazo rápido aquí también, para que una solicitud de biblioteca bloqueada falle de inmediato en lugar de colgarse hasta que se agote el tiempo de espera.944Los artefactos también pueden cargar bibliotecas de JavaScript, como React o un paquete de gráficos, desde `cdnjs.cloudflare.com`, `cdn.jsdelivr.net`, `cdn.tailwindcss.com`, `code.jquery.com` y `unpkg.com`, y desde ningún otro host externo. Si bloqueas esos hosts, las partes de un artefacto que dependen de una biblioteca no funcionan y, a diferencia de una fuente bloqueada, una biblioteca bloqueada no tiene alternativa. Bloquéalos también aquí con un rechazo rápido, para que una solicitud de biblioteca bloqueada falle de inmediato en lugar de quedarse colgada hasta que se agote el tiempo de espera.

938 945 

939<h3 id="authentication-and-sso">946<h3 id="authentication-and-sso">

940 Autenticación y SSO947 Autenticación y SSO

941</h3>948</h3>

942 949 

943Las organizaciones empresariales pueden requerir SSO para todos los usuarios. Consulte [autenticación](/docs/es/authentication) para obtener detalles a nivel de plan y [Configurar SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para la configuración de SAML; la configuración de OIDC se cubre en la [Guía del administrador empresarial de Claude](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).950Las organizaciones Team y Enterprise pueden exigir SSO para todos los usuarios. Consulta [autenticación](/docs/es/authentication) para obtener detalles a nivel de plan y [Configurar SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso) para la configuración de SAML; la configuración de OIDC se cubre en la [Guía del administrador de Claude Enterprise](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide).

944 951 

945<h3 id="data-handling">952<h3 id="data-handling">

946 Manejo de datos953 Manejo de datos

947</h3>954</h3>

948 955 

949Claude Code procesa su código localmente en sesiones locales, o en sesiones en la nube en infraestructura administrada por Anthropic, a menos que su organización las enrute a un [entorno autohospedado](/docs/es/self-hosted-environments). Las sesiones en la nube, incluyendo en un entorno autohospedado, envían conversaciones y contexto de código a la API de Anthropic para procesamiento; las sesiones locales y SSH las envían a cualquiera que sea el [proveedor de modelo](#feature-comparison) que configure su implementación, la API de Anthropic de forma predeterminada. Consulte [manejo de datos](/docs/es/data-usage) para obtener detalles sobre retención de datos, privacidad y cumplimiento.956Claude Code procesa tu código localmente en las sesiones locales, o en las sesiones en la nube en infraestructura administrada por Anthropic, a menos que tu organización las enrute a un [entorno autohospedado](/docs/es/self-hosted-environments). Las sesiones en la nube, incluso en un entorno autohospedado, envían las conversaciones y el contexto del código a la API de Anthropic para su procesamiento; las sesiones locales y SSH los envían al [proveedor de modelos](#feature-comparison) que configure tu despliegue, que de forma predeterminada es la API de Anthropic. Consulta [manejo de datos](/docs/es/data-usage) para obtener detalles sobre retención de datos, privacidad y cumplimiento.

950 957 

951<h3 id="deployment">958<h3 id="deployment">

952 Implementación959 Despliegue

953</h3>960</h3>

954 961 

955Desktop se puede distribuir a través de herramientas de implementación empresarial:962Desktop se puede distribuir a través de herramientas de despliegue empresarial:

956 963 

957* **macOS**: distribuya a través de MDM como Jamf o Kandji usando el instalador `.dmg`964* **macOS**: distribúyelo a través de MDM como Jamf o Kandji usando el instalador `.dmg`

958* **Windows**: implemente a través del paquete MSIX. Consulte [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para opciones de implementación empresarial incluyendo instalación silenciosa965* **Windows**: despliégalo a través del paquete MSIX. Consulta [Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) para ver opciones de despliegue empresarial, incluida la instalación silenciosa

959 966 

960Para los dominios a permitir en su firewall, consulte [requisitos de acceso a la red](#network-access-requirements) arriba. Para configuración de proxy, autoridades de certificados personalizadas y puertas de enlace LLM, consulte [configuración de red](/docs/es/network-config).967Para los dominios que debes permitir en tu firewall, consulta [requisitos de acceso a la red](#network-access-requirements) más arriba. Para la configuración de proxy, autoridades de certificación personalizadas y gateways LLM, consulta [configuración de red](/docs/es/network-config).

961 968 

962Para la referencia completa de configuración empresarial, consulte la [guía de configuración empresarial](https://support.claude.com/en/articles/12622667-enterprise-configuration).969Para la referencia completa de configuración empresarial, consulta la [guía de configuración empresarial](https://support.claude.com/en/articles/12622667-enterprise-configuration).

963 970 

964<h2 id="coming-from-the-cli">971<h2 id="coming-from-the-cli">

965 ¿Viene de la CLI?972 ¿Viene de la CLI?


1155 "Branch doesn't exist yet" al abrir en CLI1162 "Branch doesn't exist yet" al abrir en CLI

1156</h3>1163</h3>

1157 1164 

1158Las sesiones en la nube pueden crear ramas que no existen en su máquina local. Haga clic en el nombre de la rama en la barra de herramientas de la sesión para copiarlo, luego obténgalo localmente:1165Las sesiones en la nube pueden crear ramas que no existen en tu máquina local. Haz clic en el nombre de la rama en la sesión y selecciona **Copy branch name**, luego obtenla localmente:

1159 1166 

1160```bash theme={null}1167```bash theme={null}

1161git fetch origin <branch-name>1168git fetch origin <branch-name>

Details

77 77 

78Un dispositivo que Claude inicia también aparece en la aplicación Simulator de Apple, o en Device Hub en Xcode 27. Claude puede instalar la aplicación en un dispositivo que ya tengas iniciado.78Un dispositivo que Claude inicia también aparece en la aplicación Simulator de Apple, o en Device Hub en Xcode 27. Claude puede instalar la aplicación en un dispositivo que ya tengas iniciado.

79 79 

80También puedes abrir el panel del simulador tú mismo. Una vez que la sesión tiene un simulador adjunto o ha editado archivos Swift, el menú **Views** en la barra de herramientas de la sesión muestra una entrada **iOS Simulator**. Si el panel aún no muestra un dispositivo, haz clic en **Attach simulator**, o elige un dispositivo específico del menú de dispositivos junto a él; elegir un dispositivo apagado lo inicia. Si faltan Xcode o sus simuladores, el panel muestra los pasos de configuración en su lugar y los marca a medida que los completas.80También puedes abrir el panel del simulador tú mismo. Una vez que la sesión tiene un simulador adjunto o Claude Code detecta trabajo en una aplicación de iOS, aparece un botón **iOS Simulator** en la barra de título de la sesión. Si el panel aún no muestra un dispositivo, haz clic en **Attach simulator**, o elige un dispositivo específico del menú de dispositivos junto a él; elegir un dispositivo apagado lo inicia. Si faltan Xcode o sus simuladores, el panel muestra los pasos de configuración en su lugar y los marca a medida que los completas.

81 81 

82<h2 id="control-the-simulator-yourself">82<h2 id="control-the-simulator-yourself">

83 Controla el simulador tú mismo83 Controla el simulador tú mismo

Details

116 116 

117**Use skills para tareas repetibles.** Escriba `/` o haga clic en **+** → **Slash commands** para examinar [comandos integrados](/docs/es/commands), [skills personalizados](/docs/es/skills) y skills de plugins. Los skills son solicitudes reutilizables que puede invocar siempre que las necesite, como listas de verificación de revisión de código o pasos de implementación.117**Use skills para tareas repetibles.** Escriba `/` o haga clic en **+** → **Slash commands** para examinar [comandos integrados](/docs/es/commands), [skills personalizados](/docs/es/skills) y skills de plugins. Los skills son solicitudes reutilizables que puede invocar siempre que las necesite, como listas de verificación de revisión de código o pasos de implementación.

118 118 

119**Revise los cambios antes de confirmar.** Después de que Claude edite archivos, aparece un indicador `+12 -1`. Haga clic en él para abrir la [vista de diferencias](/docs/es/desktop#review-changes-with-diff-view), revise las modificaciones archivo por archivo y comente en líneas específicas. Claude lee sus comentarios y revisa. Haga clic en **Review code** para que Claude evalúe los diffs en sí mismo y deje sugerencias en línea.119**Revisa los cambios antes de hacer commit.** Después de que Claude edite archivos, aparece un indicador `+12 -1`. Haz clic en él para abrir la [vista de diff](/docs/es/desktop#review-changes-with-diff-view), revisar las modificaciones archivo por archivo y comentar en líneas específicas. Claude lee tus comentarios y hace revisiones. Para que Claude revise los cambios por sí mismo, escribe [`/code-review`](/docs/es/desktop#review-your-code) en el cuadro del prompt.

120 120 

121**Ajuste cuánto control tiene.** Su [modo de permisos](/docs/es/desktop#choose-a-permission-mode) establece cuánto puede hacer Claude sin pedir aprobación:121**Ajuste cuánto control tiene.** Su [modo de permisos](/docs/es/desktop#choose-a-permission-mode) establece cuánto puede hacer Claude sin pedir aprobación:

122 122 

Details

83 83 

84Cuando la aplicación se inicia o su computadora se despierta, Desktop verifica si cada tarea perdió alguna ejecución en los últimos siete días. Si es así, Desktop inicia exactamente una ejecución de recuperación para el tiempo más recientemente perdido y descarta cualquier cosa más antigua. Una tarea diaria que perdió seis días se ejecuta una vez al despertar. Desktop muestra una notificación cuando comienza una ejecución de recuperación.84Cuando la aplicación se inicia o su computadora se despierta, Desktop verifica si cada tarea perdió alguna ejecución en los últimos siete días. Si es así, Desktop inicia exactamente una ejecución de recuperación para el tiempo más recientemente perdido y descarta cualquier cosa más antigua. Una tarea diaria que perdió seis días se ejecuta una vez al despertar. Desktop muestra una notificación cuando comienza una ejecución de recuperación.

85 85 

86Tenga esto en cuenta al escribir prompts. Una tarea programada para las 9am podría ejecutarse a las 11pm si su computadora estuvo dormida todo el día. Si el tiempo es importante, agregue protecciones al prompt mismo, por ejemplo: "Solo revise los commits de hoy. Si es después de las 5pm, omita la revisión y solo publique un resumen de lo que se perdió."86Ten esto en cuenta al escribir prompts. Una tarea programada para las 9am podría ejecutarse a las 11pm si tu computadora estuvo dormida todo el día. Si el tiempo es importante, agrega protecciones al prompt mismo, por ejemplo: "Solo revisa los commits de hoy. Si es después de las 5pm, omite la revisión y publica un resumen de lo que se perdió."

87 87 

88<h2 id="permissions-for-scheduled-tasks">88<h2 id="permissions-for-scheduled-tasks">

89 Permisos para tareas programadas89 Permisos para tareas programadas

env-vars.md +4 −2

Details

195| `BASH_DEFAULT_TIMEOUT_MS` | Tiempo de espera predeterminado para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 120000, o 2 minutos). Un valor predeterminado superior a 30 minutos también se convierte en el [límite de tiempo predeterminado para los comandos en segundo plano](/docs/es/tools-reference#time-limit-for-background-commands) en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior |195| `BASH_DEFAULT_TIMEOUT_MS` | Tiempo de espera predeterminado para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 120000, o 2 minutos). Un valor predeterminado superior a 30 minutos también se convierte en el [límite de tiempo predeterminado para los comandos en segundo plano](/docs/es/tools-reference#time-limit-for-background-commands) en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior |

196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres de la salida de bash que Claude Code vuelve a leer en el resultado de un comando (predeterminado: 30000; máximo: 150000). Si estableces el ajuste [`bashOutputMaxChars`](/docs/es/settings-reference#bashoutputmaxchars), Claude Code ignora esta variable. Consulta [Límites de salida](/docs/es/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Número máximo de caracteres de la salida de bash que Claude Code vuelve a leer en el resultado de un comando (predeterminado: 30000; máximo: 150000). Si estableces el ajuste [`bashOutputMaxChars`](/docs/es/settings-reference#bashoutputmaxchars), Claude Code ignora esta variable. Consulta [Límites de salida](/docs/es/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | Tiempo de espera máximo que el modelo puede establecer para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 600000, o 10 minutos). El límite efectivo es el mayor entre este valor y `BASH_DEFAULT_TIMEOUT_MS`. Un límite efectivo superior a 2 horas también se convierte en el [límite de tiempo máximo para los comandos en segundo plano](/docs/es/tools-reference#time-limit-for-background-commands) en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior |197| `BASH_MAX_TIMEOUT_MS` | Tiempo de espera máximo que el modelo puede establecer para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 600000, o 10 minutos). El límite efectivo es el mayor entre este valor y `BASH_DEFAULT_TIMEOUT_MS`. Un límite efectivo superior a 2 horas también se convierte en el [límite de tiempo máximo para los comandos en segundo plano](/docs/es/tools-reference#time-limit-for-background-commands) en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior |

198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP para el [rastreo beta detallado](/docs/es/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, los registros y las trazas se envían allí en lugar de a los exportadores configurados. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la [configuración de proyecto y local](/docs/es/settings-reference#variables-claude-code-ignores-in-env) |198| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP para el [rastreo beta detallado](/docs/es/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, los registros y las trazas van allí en lugar de a los exportadores configurados. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la [configuración del proyecto y local](/docs/es/settings-reference#variables-claude-code-ignores-in-env) |

199| `CCR_FORCE_BUNDLE` | Establécela en `1` para forzar que [`claude --cloud`](/docs/es/claude-code-on-the-web#send-local-repositories-without-github) empaquete y suba tu repositorio local en lugar de clonarlo desde su remoto |199| `CCR_FORCE_BUNDLE` | Establécela en `1` para forzar que [`claude --cloud`](/docs/es/claude-code-on-the-web#send-local-repositories-without-github) empaquete y suba tu repositorio local en lugar de clonarlo desde su remoto |

200| `CLAUDECODE` | Se establece en `1` en los subprocesos que genera Claude Code (herramientas Bash y PowerShell, sesiones de tmux, comandos de [hooks](/docs/es/hooks), comandos de la [línea de estado](/docs/es/statusline), subprocesos de [servidores MCP](/docs/es/mcp) stdio). Las extensiones de IDE también la establecen en sus terminales integradas. Úsala para detectar cuándo un script se ejecuta dentro de un subproceso generado por Claude Code. Para comprobar si el proceso actual fue generado directamente por una llamada a herramienta o un hook, y no dentro de un servidor MCP stdio que Claude Code inició, usa `CLAUDE_CODE_CHILD_SESSION` en su lugar |200| `CLAUDECODE` | Se establece en `1` en los subprocesos que genera Claude Code (herramientas Bash y PowerShell, sesiones de tmux, comandos de [hooks](/docs/es/hooks), comandos de la [línea de estado](/docs/es/statusline), subprocesos de [servidores MCP](/docs/es/mcp) stdio). Las extensiones de IDE también la establecen en sus terminales integradas. Úsala para detectar cuándo un script se ejecuta dentro de un subproceso generado por Claude Code. Para comprobar si el proceso actual fue generado directamente por una llamada a herramienta o un hook, y no dentro de un servidor MCP stdio que Claude Code inició, usa `CLAUDE_CODE_CHILD_SESSION` en su lugar |

201| `CLAUDE_AFK_COUNTDOWN_MS` | Cuántos milisegundos antes de la continuación automática aparece la cuenta regresiva en pantalla en un cuadro de diálogo de [`AskUserQuestion`](/docs/es/tools-reference) sin responder. Predeterminado `20000` (20 segundos), limitado al tiempo de espera de la continuación automática. No tiene efecto a menos que la continuación automática esté activada; consulta el ajuste [`askUserQuestionTimeout`](/docs/es/settings-reference#askuserquestiontimeout) y `CLAUDE_AFK_TIMEOUT_MS`. Requiere Claude Code v2.1.198 o posterior |201| `CLAUDE_AFK_COUNTDOWN_MS` | Cuántos milisegundos antes de la continuación automática aparece la cuenta regresiva en pantalla en un cuadro de diálogo de [`AskUserQuestion`](/docs/es/tools-reference) sin responder. Predeterminado `20000` (20 segundos), limitado al tiempo de espera de la continuación automática. No tiene efecto a menos que la continuación automática esté activada; consulta el ajuste [`askUserQuestionTimeout`](/docs/es/settings-reference#askuserquestiontimeout) y `CLAUDE_AFK_TIMEOUT_MS`. Requiere Claude Code v2.1.198 o posterior |


287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Establécela en `1` para iniciar los comandos de la [herramienta PowerShell](/docs/es/tools-reference#powershell-tool) en Windows directamente en lugar de a través del lanzador `cmd.exe`. De forma predeterminada, el lanzador permite que un comando de PowerShell [que se ejecuta en segundo plano](/docs/es/tools-reference#background-commands) [se traslade al siguiente proceso de la sesión](/docs/es/agent-view#the-supervisor-process), como cuando [envías la sesión a segundo plano](/docs/es/agent-view#from-inside-a-session). Si estableces la variable, un comando de PowerShell en segundo plano se detiene cuando el proceso de la sesión termina. Los comandos de Bash no se ven afectados. Requiere Claude Code v2.1.269 o posterior |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Establécela en `1` para iniciar los comandos de la [herramienta PowerShell](/docs/es/tools-reference#powershell-tool) en Windows directamente en lugar de a través del lanzador `cmd.exe`. De forma predeterminada, el lanzador permite que un comando de PowerShell [que se ejecuta en segundo plano](/docs/es/tools-reference#background-commands) [se traslade al siguiente proceso de la sesión](/docs/es/agent-view#the-supervisor-process), como cuando [envías la sesión a segundo plano](/docs/es/agent-view#from-inside-a-session). Si estableces la variable, un comando de PowerShell en segundo plano se detiene cuando el proceso de la sesión termina. Los comandos de Bash no se ven afectados. Requiere Claude Code v2.1.269 o posterior |

288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Establécela en `1` para desactivar los [flujos de trabajo](/docs/es/workflows#turn-workflows-off). Equivale al ajuste [`disableWorkflows`](/docs/es/settings-reference#disableworkflows) |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Establécela en `1` para desactivar los [flujos de trabajo](/docs/es/workflows#turn-workflows-off). Equivale al ajuste [`disableWorkflows`](/docs/es/settings-reference#disableworkflows) |

289| `CLAUDE_CODE_EFFORT_LEVEL` | Establece el nivel de esfuerzo para los modelos compatibles. Valores: `low`, `medium`, `high`, `xhigh`, `max` o `auto` para usar el valor predeterminado del modelo. Los niveles disponibles dependen del modelo. Tiene precedencia sobre `--effort`, `/effort` y los ajustes `modelSettings` y `effortLevel`. Un límite de [`maxEffortLevel`](/docs/es/settings-reference#maxeffortlevel) sigue aplicándose. Consulta [Ajustar el nivel de esfuerzo](/docs/es/model-config#adjust-effort-level) |289| `CLAUDE_CODE_EFFORT_LEVEL` | Establece el nivel de esfuerzo para los modelos compatibles. Valores: `low`, `medium`, `high`, `xhigh`, `max` o `auto` para usar el valor predeterminado del modelo. Los niveles disponibles dependen del modelo. Tiene precedencia sobre `--effort`, `/effort` y los ajustes `modelSettings` y `effortLevel`. Un límite de [`maxEffortLevel`](/docs/es/settings-reference#maxeffortlevel) sigue aplicándose. Consulta [Ajustar el nivel de esfuerzo](/docs/es/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Establécela en `1` para agregar al stream de mensajes los mensajes [`session_state_changed`](/docs/es/agent-sdk/typescript#sdksessionstatechangedmessage), que contienen el estado de la sesión. Requiere el [Agent SDK](/docs/es/agent-sdk/overview) o bien `--print`, `--output-format stream-json` y `--verbose` |

290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Se acepta por compatibilidad con versiones anteriores y no tiene ningún efecto. El modo automático está disponible de forma predeterminada en todos los proveedores, incluidos Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y las sesiones con sesión iniciada del [Claude apps gateway](/docs/es/claude-apps-gateway). De la v2.1.158 a la v2.1.206, era necesario establecer esta variable en `1` para que el [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) estuviera disponible en esos proveedores |291| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Se acepta por compatibilidad con versiones anteriores y no tiene ningún efecto. El modo automático está disponible de forma predeterminada en todos los proveedores, incluidos Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y las sesiones con sesión iniciada del [Claude apps gateway](/docs/es/claude-apps-gateway). De la v2.1.158 a la v2.1.206, era necesario establecer esta variable en `1` para que el [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) estuviera disponible en esos proveedores |

291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescribe la disponibilidad del [resumen de sesión](/docs/es/interactive-mode#session-recap). Establécela en `0` para forzar la desactivación de los resúmenes independientemente del interruptor de `/config`. Establécela en `1` para forzar su activación cuando [`awaySummaryEnabled`](/docs/es/settings-reference#awaysummaryenabled) es `false`. Tiene precedencia sobre el ajuste y el interruptor de `/config` |292| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sobrescribe la disponibilidad del [resumen de sesión](/docs/es/interactive-mode#session-recap). Establécela en `0` para forzar la desactivación de los resúmenes independientemente del interruptor de `/config`. Establécela en `1` para forzar su activación cuando [`awaySummaryEnabled`](/docs/es/settings-reference#awaysummaryenabled) es `false`. Tiene precedencia sobre el ajuste y el interruptor de `/config` |

292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Establécela en `1` para actualizar el estado de los plugins entre turnos en el [modo no interactivo](/docs/es/headless) después de que finalice una instalación en segundo plano. Está desactivada de forma predeterminada porque la actualización cambia el prompt del sistema a mitad de la sesión, lo que invalida la [caché de prompts](/docs/es/prompt-caching) para ese turno |293| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Establécela en `1` para actualizar el estado de los plugins entre turnos en el [modo no interactivo](/docs/es/headless) después de que finalice una instalación en segundo plano. Está desactivada de forma predeterminada porque la actualización cambia el prompt del sistema a mitad de la sesión, lo que invalida la [caché de prompts](/docs/es/prompt-caching) para ese turno |


314| `CLAUDE_CODE_GLOB_NO_IGNORE` | Establécela en `false` para que la [herramienta Glob](/docs/es/tools-reference#glob-tool-behavior) respete los patrones de `.gitignore`. De forma predeterminada, Glob devuelve todos los archivos coincidentes, incluidos los ignorados por git. No afecta al autocompletado de archivos con `@`, que tiene su propio [ajuste `respectGitignore`](/docs/es/settings-reference#respectgitignore) |315| `CLAUDE_CODE_GLOB_NO_IGNORE` | Establécela en `false` para que la [herramienta Glob](/docs/es/tools-reference#glob-tool-behavior) respete los patrones de `.gitignore`. De forma predeterminada, Glob devuelve todos los archivos coincidentes, incluidos los ignorados por git. No afecta al autocompletado de archivos con `@`, que tiene su propio [ajuste `respectGitignore`](/docs/es/settings-reference#respectgitignore) |

315| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Tiempo de espera en segundos para el descubrimiento de archivos de la herramienta Glob. El valor predeterminado es de 20 segundos en la mayoría de las plataformas y de 60 segundos en WSL |316| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Tiempo de espera en segundos para el descubrimiento de archivos de la herramienta Glob. El valor predeterminado es de 20 segundos en la mayoría de las plataformas y de 60 segundos en WSL |

316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Cuántos minutos puede el trabajo en segundo plano mantener en espera un objetivo activo antes de que Claude Code [le pida a Claude que lo revise](/docs/es/goal#background-work-defers-evaluation). Predeterminado: `30`. Establécela en `0` para desactivar las revisiones. Indica minutos enteros en dígitos simples, como máximo `10080`, que equivale a una semana. Claude Code trata cualquier otro valor como no establecido y usa el predeterminado. Requiere Claude Code v2.1.234 o posterior |317| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Cuántos minutos puede el trabajo en segundo plano mantener en espera un objetivo activo antes de que Claude Code [le pida a Claude que lo revise](/docs/es/goal#background-work-defers-evaluation). Predeterminado: `30`. Establécela en `0` para desactivar las revisiones. Indica minutos enteros en dígitos simples, como máximo `10080`, que equivale a una semana. Claude Code trata cualquier otro valor como no establecido y usa el predeterminado. Requiere Claude Code v2.1.234 o posterior |

318| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Establécela en `0` para desactivar la compresión gzip de los cuerpos de las solicitudes de la API de Claude, de telemetría y de publicación de [artefactos](/docs/es/artifacts) enviadas a `api.anthropic.com`. De forma predeterminada, Claude Code comprime los cuerpos de solicitud grandes en conexiones directas y omite la compresión cuando envías solicitudes a través de un proxy, configuras un certificado de cliente o estableces `NODE_EXTRA_CA_CERTS`. Usa `0` si un [proxy de inspección TLS](/docs/es/network-config#ca-certificate-store) que Claude Code no puede detectar maneja mal las solicitudes comprimidas |

317| `CLAUDE_CODE_HIDE_CWD` | Establécela en `1` para ocultar el directorio de trabajo en el logotipo de inicio. Es útil al compartir pantalla o en grabaciones donde la ruta expone tu nombre de usuario del sistema operativo |319| `CLAUDE_CODE_HIDE_CWD` | Establécela en `1` para ocultar el directorio de trabajo en el logotipo de inicio. Es útil al compartir pantalla o en grabaciones donde la ruta expone tu nombre de usuario del sistema operativo |

318| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescribe la dirección del host que se usa para conectarse a la extensión del IDE. De forma predeterminada, Claude Code detecta automáticamente la dirección correcta, incluido el enrutamiento de WSL a Windows |320| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sobrescribe la dirección del host que se usa para conectarse a la extensión del IDE. De forma predeterminada, Claude Code detecta automáticamente la dirección correcta, incluido el enrutamiento de WSL a Windows |

319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Establécela en `1` para omitir la instalación automática de las extensiones del IDE. Equivale a establecer [`autoInstallIdeExtension`](/docs/es/settings-reference#autoinstallideextension) en `false` |321| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Establécela en `1` para omitir la instalación automática de las extensiones del IDE. Equivale a establecer [`autoInstallIdeExtension`](/docs/es/settings-reference#autoinstallideextension) en `false` |


460| `DISABLE_UPDATES` | Establécela en `1` para bloquear todas las actualizaciones, incluidos `claude update` y `claude install` manuales. Más estricta que `DISABLE_AUTOUPDATER`. Úsala cuando distribuyas Claude Code a través de tus propios canales y los usuarios no deban actualizarse por su cuenta |462| `DISABLE_UPDATES` | Establécela en `1` para bloquear todas las actualizaciones, incluidos `claude update` y `claude install` manuales. Más estricta que `DISABLE_AUTOUPDATER`. Úsala cuando distribuyas Claude Code a través de tus propios canales y los usuarios no deban actualizarse por su cuenta |

461| `DISABLE_UPGRADE_COMMAND` | Establécela en `1` para ocultar el comando `/upgrade` |463| `DISABLE_UPGRADE_COMMAND` | Establécela en `1` para ocultar el comando `/upgrade` |

462| `DO_NOT_TRACK` | Establécela en `1` para excluirte de la telemetría, con el mismo efecto que `DISABLE_TELEMETRY`, incluso en la [obtención de feature flags](#features-that-need-feature-flag-fetching). Claude Code lee esta variable como un booleano estándar, por lo que `0` mantiene la telemetría activada, y la respeta como la convención entre herramientas reconocida por muchas CLI para desarrolladores |464| `DO_NOT_TRACK` | Establécela en `1` para excluirte de la telemetría, con el mismo efecto que `DISABLE_TELEMETRY`, incluso en la [obtención de feature flags](#features-that-need-feature-flag-fetching). Claude Code lee esta variable como un booleano estándar, por lo que `0` mantiene la telemetría activada, y la respeta como la convención entre herramientas reconocida por muchas CLI para desarrolladores |

463| `ENABLE_BETA_TRACING_DETAILED` | Establécela en `1`, junto con `BETA_TRACING_ENDPOINT`, para activar el [rastreo beta detallado](/docs/es/monitoring-usage#traces-beta), que añade atributos de span con contenido y el span `claude_code.hook`. Las sesiones interactivas de la CLI también requieren que tu organización esté en la lista de permitidos de la beta. Ambas variables se ignoran en la [configuración de proyecto y local](/docs/es/settings-reference#variables-claude-code-ignores-in-env) |465| `ENABLE_BETA_TRACING_DETAILED` | Establécela en `1`, y establece `BETA_TRACING_ENDPOINT` en el endpoint de tu recopilador OTLP/HTTP, para activar el [rastreo beta detallado](/docs/es/monitoring-usage#traces-beta), que agrega atributos de span con contenido y el span `claude_code.hook`. Las sesiones interactivas de la CLI también requieren que tu organización esté en la lista de permitidos de la beta. Ambas variables se ignoran en la [configuración de proyecto y local](/docs/es/settings-reference#variables-claude-code-ignores-in-env) |

464| `ENABLE_CLAUDEAI_MCP_SERVERS` | Establécela en `false` para que Claude Code deje de obtener [servidores MCP de claude.ai](/docs/es/mcp#use-mcp-servers-from-claude-ai). Activada de forma predeterminada para los usuarios con sesión iniciada. Para desactivarla por proyecto o por organización, establece [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) en la configuración |466| `ENABLE_CLAUDEAI_MCP_SERVERS` | Establécela en `false` para que Claude Code deje de obtener [servidores MCP de claude.ai](/docs/es/mcp#use-mcp-servers-from-claude-ai). Activada de forma predeterminada para los usuarios con sesión iniciada. Para desactivarla por proyecto o por organización, establece [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) en la configuración |

465| `ENABLE_PROMPT_CACHING_1H` | Establécela en `1` para solicitar un [TTL de caché de prompts](/docs/es/prompt-caching#cache-lifetime) de 1 hora en lugar de los 5 minutos predeterminados. Pensada para usuarios de clave de API, [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), [Microsoft Foundry](/docs/es/microsoft-foundry) y [Claude Platform on AWS](/docs/es/claude-platform-on-aws). Los usuarios con suscripción dentro del uso incluido reciben automáticamente el TTL de 1 hora en la [conversación principal](/docs/es/prompt-caching#which-ttl-each-request-gets). Los usuarios con suscripción que consumen [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pueden establecerla para conservar el TTL de 1 hora. Las escrituras en caché de 1 hora se facturan a una tarifa más alta. Para elegir el TTL por grupo de solicitudes, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` y `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que tienen precedencia sobre esta variable |467| `ENABLE_PROMPT_CACHING_1H` | Establécela en `1` para solicitar un [TTL de caché de prompts](/docs/es/prompt-caching#cache-lifetime) de 1 hora en lugar de los 5 minutos predeterminados. Pensada para usuarios de clave de API, [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), [Microsoft Foundry](/docs/es/microsoft-foundry) y [Claude Platform on AWS](/docs/es/claude-platform-on-aws). Los usuarios con suscripción dentro del uso incluido reciben automáticamente el TTL de 1 hora en la [conversación principal](/docs/es/prompt-caching#which-ttl-each-request-gets). Los usuarios con suscripción que consumen [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pueden establecerla para conservar el TTL de 1 hora. Las escrituras en caché de 1 hora se facturan a una tarifa más alta. Para elegir el TTL por grupo de solicitudes, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` y `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que tienen precedencia sobre esta variable |

466| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Obsoleta. Usa `ENABLE_PROMPT_CACHING_1H` en su lugar |468| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Obsoleta. Usa `ENABLE_PROMPT_CACHING_1H` en su lugar |

Details

51 51 

52Estas requieren iniciar sesión con una cuenta de claude.ai y no son accesibles con una clave API de la Consola de Anthropic o desde un proveedor de terceros:52Estas requieren iniciar sesión con una cuenta de claude.ai y no son accesibles con una clave API de la Consola de Anthropic o desde un proveedor de terceros:

53 53 

54* [Claude Code en la web](/docs/es/claude-code-on-the-web), Claude Code en dispositivos móviles y [Claude Code en Slack](/docs/es/slack)54* [Sesiones en la nube](/docs/es/claude-code-on-the-web) y Claude Code en dispositivos móviles

55* [Claude Code en Slack](/docs/es/slack): planes Pro y Max

55* [Claude Code Desktop](/docs/es/desktop)56* [Claude Code Desktop](/docs/es/desktop)

56* [Routines](/docs/es/routines) (`/schedule`)57* [Routines](/docs/es/routines) (`/schedule`)

57* [Ultrareview](/docs/es/ultrareview)58* [Ultrareview](/docs/es/ultrareview)


303 304 

304Si se autentica a través de Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o una clave API de la Consola de Anthropic, esta sección no se aplica a usted. Cuando inicia sesión con una cuenta de claude.ai, su plan determina cuál de las características a continuación está disponible.305Si se autentica a través de Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o una clave API de la Consola de Anthropic, esta sección no se aplica a usted. Cuando inicia sesión con una cuenta de claude.ai, su plan determina cuál de las características a continuación está disponible.

305 306 

307En las organizaciones Enterprise que tienen aplicada la [configuración HIPAA](/docs/es/hipaa-setup), algunas características de esta tabla están desactivadas.

308 

306| Característica | Pro | Max | Team | Enterprise |309| Característica | Pro | Max | Team | Enterprise |

307| :- | :- | :- | :- | :- |310| :- | :- | :- | :- | :- |

308| [Cloud sessions](/docs/es/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |311| [Cloud sessions](/docs/es/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

fullscreen.md +8 −7

Details

100 100 

101* **Haga clic en la entrada de solicitud** para posicionar su cursor en cualquier lugar del texto que está escribiendo.101* **Haga clic en la entrada de solicitud** para posicionar su cursor en cualquier lugar del texto que está escribiendo.

102* **Haga clic en una sugerencia en la lista de comandos `/` o archivos `@`** para aceptarla. Pasar el ratón resalta la fila bajo su cursor.102* **Haga clic en una sugerencia en la lista de comandos `/` o archivos `@`** para aceptarla. Pasar el ratón resalta la fila bajo su cursor.

103* **Haga clic en una opción en un menú de selección** para elegirla. Esto cubre solicitudes de permisos, `/model`, `/config` y otros diálogos que muestran una lista de opciones. Pasar el ratón muestra un puntero en la fila bajo su cursor.103* **Haz clic en una opción en un menú de selección** para elegirla. Esto cubre solicitudes de permiso, `/model`, `/config` y otros diálogos que muestran una lista de opciones.

104* **Haga clic en una opción en un menú de selección múltiple** para alternarla, y haga clic en el botón de envío para confirmar sus opciones. Hacer clic en una fila de texto libre, como la fila `Other` en una pregunta de opción múltiple, enfoca su campo de entrada para que pueda escribir una respuesta. Requiere Claude Code v2.1.208 o posterior.104* **Haga clic en una opción en un menú de selección múltiple** para alternarla, y haga clic en el botón de envío para confirmar sus opciones. Hacer clic en una fila de texto libre, como la fila `Other` en una pregunta de opción múltiple, enfoca su campo de entrada para que pueda escribir una respuesta. Requiere Claude Code v2.1.208 o posterior.

105* **Haga clic en un valor de configuración en el panel `/config`** para cambiarlo, y desplácese por la lista de configuración con la rueda del ratón. Requiere Claude Code v2.1.271 o posterior.105* **Haga clic en un valor de configuración en el panel `/config`** para cambiarlo, y desplácese por la lista de configuración con la rueda del ratón. Requiere Claude Code v2.1.271 o posterior.

106* **Desplace un menú de selección o selección múltiple con la rueda del ratón** cuando tenga más opciones de las que muestra a la vez, como la lista `/model` en una ventana de terminal corta. La rueda desplaza la lista mientras el puntero está sobre sus opciones. Requiere Claude Code v2.1.280 o posterior.106* **Desplace un menú de selección o selección múltiple con la rueda del ratón** cuando tenga más opciones de las que muestra a la vez, como la lista `/model` en una ventana de terminal corta. La rueda desplaza la lista mientras el puntero está sobre sus opciones. Requiere Claude Code v2.1.280 o posterior.


110* **Haz clic en un resultado de herramienta contraído** para expandirlo y ver la salida completa. Haz clic de nuevo para contraerlo. La llamada a herramienta y su resultado se expanden juntos. Solo los mensajes que tienen más para mostrar son clicables.110* **Haz clic en un resultado de herramienta contraído** para expandirlo y ver la salida completa. Haz clic de nuevo para contraerlo. La llamada a herramienta y su resultado se expanden juntos. Solo los mensajes que tienen más para mostrar son clicables.

111 * Hacer clic también expande la salida de un comando shell `!`, ya sea un resultado truncado anterior o la fila de progreso en vivo mientras se ejecuta el comando. Requiere Claude Code v2.1.257 o posterior.111 * Hacer clic también expande la salida de un comando shell `!`, ya sea un resultado truncado anterior o la fila de progreso en vivo mientras se ejecuta el comando. Requiere Claude Code v2.1.257 o posterior.

112 * Hacer clic también expande una línea `Message from @<sender>` atenuada cuando el remitente es un [compañero de equipo](/docs/es/agent-teams) u otro agente ejecutándose en tu sesión.112 * Hacer clic también expande una línea `Message from @<sender>` atenuada cuando el remitente es un [compañero de equipo](/docs/es/agent-teams) u otro agente ejecutándose en tu sesión.

113* **Mantenga presionado `Cmd` en macOS, o `Ctrl` en Linux y Windows, y haga clic en una URL o ruta de archivo** para abrirla. Las URLs simples `http://` y `https://` se abren en su navegador, y las rutas de archivo en la salida de herramientas, como las que se imprimen después de un Edit o Write, se abren en su aplicación predeterminada. Un clic simple sin el modificador no abre enlaces, coincidiendo con el comportamiento de terminal nativo.113* **Mantén presionado `Cmd` en macOS, o `Ctrl` en Linux y Windows, y haz clic en una URL o ruta de archivo** para abrirla. Las URLs simples `http://` y `https://` se abren en tu navegador. Cuando Claude Code maneja el clic, las rutas de archivo en la salida de herramientas, como las que se imprimen después de un Edit o Write, se abren en tu administrador de archivos con el archivo seleccionado. Un clic simple sin el modificador no abre enlaces, coincidiendo con el comportamiento nativo de la terminal.

114 * Claude Code renderiza una ruta de red (UNC), como `\\server\share\file.ts`, como texto sin formato sin enlace, porque abrir una ruta de red puede enviar sus credenciales de Windows al host que nombra.114 * En Linux y WSL, hacer clic en una ruta de archivo requiere un administrador de archivos que proporcione la interfaz D-Bus `org.freedesktop.FileManager1`. Sin uno, no se abre nada.

115 * Algunos terminales de macOS reenvían `Cmd`+clic a la aplicación en ejecución en lugar de abrir el enlace ellos mismos, y el protocolo del ratón del terminal no tiene forma de codificar la tecla `Cmd`, por lo que Claude Code recibe un clic simple. En Ghostty, y en Warp en macOS, Claude Code detecta esto y permite que un clic simple en un enlace lo abra, y mantener presionado `Cmd` sigue funcionando.115 * Claude Code renderiza una ruta de red (UNC), como `\\server\share\file.ts`, como texto sin formato sin enlace, porque abrir una ruta de red puede enviar tus credenciales de Windows al host que nombra.

116 * En la terminal integrada de VS Code y terminales similares basados en xterm.js, Claude Code se remite al manejador de enlaces propio de la terminal, que utiliza el mismo gesto.116 * Algunas terminales de macOS reenvían `Cmd`+clic a la aplicación en ejecución en lugar de abrir el enlace ellas mismas, y el protocolo del ratón de la terminal no tiene forma de codificar la tecla `Cmd`, por lo que Claude Code recibe un clic simple. En Ghostty, y en Warp en macOS, Claude Code detecta esto y permite que un clic simple en un enlace lo abra, y mantener presionado `Cmd` sigue funcionando.

117 * En la terminal integrada de VS Code y terminales similares basadas en xterm.js, Claude Code se remite al manejador de enlaces propio de la terminal, que utiliza el mismo gesto.

117* **Haga clic y arrastre** para seleccionar texto en cualquier lugar de la conversación. Doble clic selecciona una palabra, coincidiendo con los límites de palabra de iTerm2 para que una ruta de archivo se seleccione como una unidad. Hacer doble clic en una URL selecciona la URL completa, incluido el esquema. Triple clic selecciona la línea.118* **Haga clic y arrastre** para seleccionar texto en cualquier lugar de la conversación. Doble clic selecciona una palabra, coincidiendo con los límites de palabra de iTerm2 para que una ruta de archivo se seleccione como una unidad. Hacer doble clic en una URL selecciona la URL completa, incluido el esquema. Triple clic selecciona la línea.

118* **Desplácese con la rueda del ratón** para moverse a través de la conversación.119* **Desplácese con la rueda del ratón** para moverse a través de la conversación.

119 120 


130* **Cualquier otra tecla, incluidas las teclas de flecha simples, `Enter` y caracteres escritos**: Claude Code borra la selección.131* **Cualquier otra tecla, incluidas las teclas de flecha simples, `Enter` y caracteres escritos**: Claude Code borra la selección.

131* **Una tecla vinculada a [`selection:clear`](/docs/es/keybindings#scroll-actions)**: Claude Code borra la selección, incluso cuando la tecla es `Esc` u otra tecla que de otro modo la mantendría. La acción no tiene vinculación predeterminada.132* **Una tecla vinculada a [`selection:clear`](/docs/es/keybindings#scroll-actions)**: Claude Code borra la selección, incluso cuando la tecla es `Esc` u otra tecla que de otro modo la mantendría. La acción no tiene vinculación predeterminada.

132 133 

133En [modo de transcripción](#search-and-review-the-conversation), las teclas de navegación y búsqueda enumeradas allí también mantienen la selección.134En [modo de transcripción](#search-and-review-the-conversation), las teclas de navegación enumeradas allí también mantienen la selección.

134 135 

135<h2 id="scroll-the-conversation">136<h2 id="scroll-the-conversation">

136 Desplazarse por la conversación137 Desplazarse por la conversación


187 188 

188Un valor de `3` coincide con el predeterminado en `vim` y aplicaciones similares. La configuración acepta cualquier valor positivo hasta 20, incluidos valores fraccionarios por debajo de 1 como `0.25` para ralentizar el desplazamiento de trackpad y rueda acelerados en terminales que ya amplifican eventos de rueda.189Un valor de `3` coincide con el predeterminado en `vim` y aplicaciones similares. La configuración acepta cualquier valor positivo hasta 20, incluidos valores fraccionarios por debajo de 1 como `0.25` para ralentizar el desplazamiento de trackpad y rueda acelerados en terminales que ya amplifican eventos de rueda.

189 190 

190Para ajustar la velocidad de desplazamiento de forma interactiva, ejecute `/scroll-speed`. El cuadro de diálogo muestra una regla que puede desplazar mientras está abierto para que pueda sentir el cambio inmediatamente. Presione `←` y `→` para ajustar la velocidad, `r` para restablecer el valor predeterminado detectado automáticamente y `Intro` para guardar. El cuadro de diálogo avanza en números enteros hasta 10, y en terminales que admiten control más fino también ofrece pasos de cuarto hasta 0,25.191Para ajustar la velocidad de desplazamiento de forma interactiva, ejecuta `/scroll-speed`. Desplázate mientras el cuadro de diálogo está abierto para sentir el cambio de inmediato. Presiona `←` y `→` para ajustar la velocidad, `r` para restablecer el valor predeterminado detectado automáticamente y `Enter` para guardar. El cuadro de diálogo avanza en números enteros hasta 10, y en terminales que admiten un control más fino también ofrece pasos de un cuarto hasta 0,25.

191 192 

192El comando escribe el mismo valor que establece la variable de entorno `CLAUDE_CODE_SCROLL_SPEED`, persistido en `~/.claude/settings.json`. El máximo del cuadro de diálogo es 10: si establece un valor más alto a través de la variable de entorno, el cuadro de diálogo muestra 10, y guardar desde el cuadro de diálogo persiste 10. El comando no está disponible en la terminal del IDE de JetBrains.193El comando escribe el mismo valor que establece la variable de entorno `CLAUDE_CODE_SCROLL_SPEED`, persistido en `~/.claude/settings.json`. El máximo del cuadro de diálogo es 10: si establece un valor más alto a través de la variable de entorno, el cuadro de diálogo muestra 10, y guardar desde el cuadro de diálogo persiste 10. El comando no está disponible en la terminal del IDE de JetBrains.

193 194 

Details

326 326 

327Otorgue al flujo de trabajo solo los permisos que necesita y revise los cambios de Claude antes de fusionar.327Otorgue al flujo de trabajo solo los permisos que necesita y revise los cambios de Claude antes de fusionar.

328 328 

329Para una guía de seguridad completa que incluya permisos y autenticación, consulte la [documentación de seguridad de Claude Code Action](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md).329Para una guía de seguridad que incluya permisos y autenticación, consulta la [documentación de seguridad de Claude Code Action](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md).

330 330 

331<h3 id="manage-costs">331<h3 id="manage-costs">

332 Gestionar costos332 Gestionar costos

glossary.md +1 −1

Details

499 Verification loop499 Verification loop

500</h3>500</h3>

501 501 

502Cómo una sesión sabe que el trabajo está realmente hecho en lugar de solo ser plausible. Usted le da a Claude una verificación que puede ejecutar, como un conjunto de pruebas, una compilación o una comparación de capturas de pantalla, y Claude itera hasta que la verificación pase en lugar de detenerse después de un intento. Un verification loop es el requisito previo para [`/goal`](/docs/es/goal), ejecuciones desatendidas y [dynamic workflows](/docs/es/workflows): sin uno, la única cosa que decide que el agente ha terminado es el agente mismo.502Cómo una sesión sabe que el trabajo está realmente hecho en lugar de aceptar un resultado que parece plausible. Le das a Claude una verificación que puede ejecutar, como un conjunto de pruebas, una compilación o una comparación de capturas de pantalla, y Claude itera hasta que la verificación pase en lugar de detenerse después de un intento. Un bucle de verificación es el requisito previo para [`/goal`](/docs/es/goal), las ejecuciones desatendidas y los [flujos de trabajo dinámicos](/docs/es/workflows): sin uno, lo único que decide que el agente ha terminado es el propio agente.

503 503 

504Más información: [Give Claude a way to verify its work](/docs/es/best-practices#give-claude-a-way-to-verify-its-work)504Más información: [Give Claude a way to verify its work](/docs/es/best-practices#give-claude-a-way-to-verify-its-work)

505 505 

headless.md +1 −1

Details

206 206 

207Si su consumidor lee la transmisión lentamente, Claude Code espera a que se drene la salida en cola antes de salir, escalando la espera con cuánto aún está en cola, limitado a 30 segundos. Antes de v2.1.214, la espera de salida estaba limitada a aproximadamente dos segundos, lo que podría cortar el final de una respuesta grande.207Si su consumidor lee la transmisión lentamente, Claude Code espera a que se drene la salida en cola antes de salir, escalando la espera con cuánto aún está en cola, limitado a 30 segundos. Antes de v2.1.214, la espera de salida estaba limitada a aproximadamente dos segundos, lo que podría cortar el final de una respuesta grande.

208 208 

209El siguiente ejemplo utiliza [jq](https://jqlang.org/) para filtrar deltas de texto y mostrar solo el texto transmitido. La bandera `-r` genera cadenas sin formato (sin comillas) y `-j` se une sin saltos de línea para que los tokens se transmitan continuamente:209El siguiente ejemplo usa [jq](https://jqlang.org/) para filtrar deltas de texto y mostrar solo el texto en streaming. El flag `-r` genera cadenas sin formato (sin comillas) y `-j` une sin saltos de línea para que los tokens se transmitan en streaming de forma continua:

210 210 

211```bash theme={null}211```bash theme={null}

212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \

hipaa-setup.md +12 −5

Details

15 * Claude Code en la pestaña Code de Claude Desktop15 * Claude Code en la pestaña Code de Claude Desktop

16 * Cowork en Claude Desktop16 * Cowork en Claude Desktop

17 17 

18 Las extensiones de Claude Code para VS Code y JetBrains no forman parte de (local mode). Siguen funcionando con la configuración de HIPAA aplicada, pero tu BAA no las cubre. Consulta la [Implementation Guide](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide) para ver la lista completa de Eligible Services.18 Las extensiones de Claude Code para VS Code y JetBrains no forman parte de (local mode). Siguen funcionando con la configuración de HIPAA aplicada, pero tu BAA no las cubre. Consulta la [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver la lista completa de Eligible Services.

19</Note>19</Note>

20 20 

21Esta página es para el administrador de TI o de seguridad que prepara las computadoras de los desarrolladores. El Primary Owner de tu organización de Claude es quien aplica la configuración. [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731) explica qué incluye tu BAA, cómo se aplica la configuración y cómo programar la fecha en que se aplica.21Esta página es para el administrador de TI o de seguridad que prepara las computadoras de los desarrolladores. El Primary Owner de tu organización de Claude es quien aplica la configuración. [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731) explica qué incluye tu BAA, cómo se aplica la configuración y cómo programar la fecha en que se aplica.


174 174 

175* **Inicios de sesión de Claude Console y credenciales de federación**: `forceLoginOrgUUID` solo revisa los inicios de sesión de claude.ai. [Restringe el inicio de sesión a tu organización](/docs/es/authentication#restrict-login-to-your-organization) enumera qué revisa Claude Code para cada ruta de inicio de sesión y cada credencial.175* **Inicios de sesión de Claude Console y credenciales de federación**: `forceLoginOrgUUID` solo revisa los inicios de sesión de claude.ai. [Restringe el inicio de sesión a tu organización](/docs/es/authentication#restrict-login-to-your-organization) enumera qué revisa Claude Code para cada ruta de inicio de sesión y cada credencial.

176* **Configuración administrada por el servidor**: si tu organización también usa la [configuración administrada por el servidor](/docs/es/server-managed-settings), pide a un Owner que agregue las mismas claves allí. [Cómo combina Claude Code los orígenes administrados](/docs/es/managed-settings#how-claude-code-combines-managed-sources) explica qué origen se aplica.176* **Configuración administrada por el servidor**: si tu organización también usa la [configuración administrada por el servidor](/docs/es/server-managed-settings), pide a un Owner que agregue las mismas claves allí. [Cómo combina Claude Code los orígenes administrados](/docs/es/managed-settings#how-claude-code-combines-managed-sources) explica qué origen se aplica.

177* **Versiones anteriores a v2.1.285**: estas versiones ignoran `allowedProviders`, por lo que aún pueden iniciarse con un proveedor de nube o un gateway. Para que las versiones v2.1.163 a v2.1.284 se nieguen a iniciarse, puedes agregar [`requiredMinimumVersion`](/docs/es/settings-reference#requiredminimumversion) con el valor `"2.1.285"` a la misma configuración administrada que las [claves de ejemplo](#deploy-managed-settings). Las versiones anteriores a v2.1.163 ignoran `requiredMinimumVersion` además de `allowedProviders`, así que [actualiza esas computadoras](#update-claude-code-and-claude-desktop).

177 178 

178Para saber si tu BAA cubre una sesión que se ejecuta sin la configuración de HIPAA, consulta [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731).179Para saber si tu BAA cubre una sesión que se ejecuta sin la configuración de HIPAA, consulta [Use Claude Code (local mode) and Cowork (local mode) on a HIPAA-ready Enterprise plan](https://support.claude.com/en/articles/17318731).

179 180 


234 235 

235Con la configuración de HIPAA aplicada, Claude Code elimina las credenciales que usa para comunicarse con Anthropic, como `ANTHROPIC_API_KEY` y `ANTHROPIC_AUTH_TOKEN`, del entorno de los comandos de shell, hooks y servidores MCP que inicia.236Con la configuración de HIPAA aplicada, Claude Code elimina las credenciales que usa para comunicarse con Anthropic, como `ANTHROPIC_API_KEY` y `ANTHROPIC_AUTH_TOKEN`, del entorno de los comandos de shell, hooks y servidores MCP que inicia.

236 237 

237La configuración de HIPAA no elimina las credenciales de proveedores de nube ni de GitHub, así que un comando que hace push a GitHub o llama a otro servicio sigue funcionando con el acceso de ese desarrollador. Tu BAA con Anthropic no cubre los datos que envía allí. Consulta la [Implementation Guide](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide) para ver la lista completa de Eligible Services.238La configuración de HIPAA no elimina las credenciales de proveedores de nube ni de GitHub, así que un comando que hace push a GitHub o llama a otro servicio sigue funcionando con el acceso de ese desarrollador. Tu BAA con Anthropic no cubre los datos que envía allí. Consulta la [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver la lista completa de Eligible Services.

238 239 

239Para limitar qué comandos y hosts puede usar Claude, consulta las [reglas de permisos](/docs/es/permissions) y el [sandbox](/docs/es/sandboxing).240Para limitar qué comandos y hosts puede usar Claude, consulta las [reglas de permisos](/docs/es/permissions) y el [sandbox](/docs/es/sandboxing).

240 241 


275 Elimina los datos de sesión de inmediato276 Elimina los datos de sesión de inmediato

276</h3>277</h3>

277 278 

278Si tu organización necesita eliminar los datos de sesión de un desarrollador antes de que la limpieza de retención los elimine, puedes eliminar la mayoría con un solo comando. Inicia sesión en la computadora como ese desarrollador y ejecuta este comando en cualquier shell:279Si tu organización necesita eliminar los datos de sesión de un desarrollador antes de que la limpieza de retención los elimine, puedes eliminar la mayoría con un solo comando. Inicia sesión en la computadora como ese desarrollador, abre cualquier shell y ejecuta el comando correspondiente a la versión de Claude Code instalada.

280 

281En Claude Code v2.1.288 o posterior, ejecuta `claude purge`:

279 282 

280```bash theme={null}283```bash theme={null}

281claude purge --all --yes284claude purge --all --yes

282```285```

283 286 

284Antes de la v2.1.288, el comando era `claude project purge`.287De la v2.1.126 a la v2.1.287, ejecuta `claude project purge`, que acepta los mismos flags:

288 

289```bash theme={null}

290claude project purge --all --yes

291```

285 292 

286El comando elimina las transcripciones y la memoria automática de cada proyecto, las entradas de `tasks/`, `debug/` y `file-history/`, `history.jsonl` y las entradas de proyecto de `~/.claude.json`. Sin `--yes`, imprime el plan y pregunta primero.293Cualquiera de los dos comandos elimina las transcripciones y la memoria automática de cada proyecto, las entradas de `tasks/`, `debug/` y `file-history/`, `history.jsonl` y las entradas de proyecto de `~/.claude.json`. Sin `--yes`, imprime el plan y pregunta primero.

287 294 

288La purga deja otras rutas que pueden contener contenido de sesiones, como el texto pegado en `paste-cache/`. [Borra los datos locales](/docs/es/claude-directory#clear-local-data) enumera las rutas que puedes eliminar a mano. Para limpiar una computadora por completo, por ejemplo antes de reasignarla, [bórrala](#offboard-a-developer).295La purga deja otras rutas que pueden contener contenido de sesiones, como el texto pegado en `paste-cache/`. [Borra los datos locales](/docs/es/claude-directory#clear-local-data) enumera las rutas que puedes eliminar a mano. Para limpiar una computadora por completo, por ejemplo antes de reasignarla, [bórrala](#offboard-a-developer).

289 296 

hooks.md +4 −4

Details

772| Campo | Descripción |772| Campo | Descripción |

773| :- | :- |773| :- | :- |

774| `session_id` | Identificador de sesión actual |774| `session_id` | Identificador de sesión actual |

775| `prompt_id` | UUID que identifica el prompt del usuario que se está procesando actualmente. Coincide con el [atributo `prompt.id` en eventos de OpenTelemetry](/docs/es/monitoring-usage#event-correlation-attributes), para que pueda correlacionar la salida del hook con la telemetría de un único prompt. Ausente hasta la primera entrada del usuario. Requiere Claude Code v2.1.196 o posterior |775| `prompt_id` | UUID que identifica el prompt del usuario que se está procesando actualmente. Coincide con el [atributo `prompt.id` en eventos de OpenTelemetry](/docs/es/monitoring-usage#event-correlation-attributes), para que puedas correlacionar la salida del hook con la telemetría de un único prompt. Ausente hasta la primera entrada del usuario |

776| `transcript_path` | Ruta al JSON de conversación. El archivo de transcripción se escribe de forma asincrónica y puede rezagarse con respecto a la conversación en memoria, por lo que es posible que aún no incluya los mensajes más recientes del turno actual cuando se activa un hook. Los hooks que necesitan el texto del asistente final del turno actual deben usar `last_assistant_message` en [Stop](#stop) y [SubagentStop](#subagentstop) en lugar de leer la transcripción |776| `transcript_path` | Ruta al JSON de conversación. El archivo de transcripción se escribe de forma asincrónica y puede rezagarse con respecto a la conversación en memoria, por lo que es posible que aún no incluya los mensajes más recientes del turno actual cuando se activa un hook. Los hooks que necesitan el texto del asistente final del turno actual deben usar `last_assistant_message` en [Stop](#stop) y [SubagentStop](#subagentstop) en lugar de leer la transcripción |

777| `cwd` | Directorio de trabajo actual cuando se invoca el hook |777| `cwd` | Directorio de trabajo actual cuando se invoca el hook |

778| `scratchpad_dir` | Ruta al [directorio de scratchpad de la sesión](/docs/es/claude-directory#session-scratchpad-directory), donde Claude mantiene archivos de trabajo temporales. Ausente cuando la sesión no tiene scratchpad o el directorio temporal no está disponible. Requiere Claude Code v2.1.257 o posterior |778| `scratchpad_dir` | Ruta al [directorio de scratchpad de la sesión](/docs/es/claude-directory#session-scratchpad-directory), donde Claude mantiene archivos de trabajo temporales. Ausente cuando la sesión no tiene scratchpad o el directorio temporal no está disponible. Requiere Claude Code v2.1.257 o posterior |


1359 1359 

1360Los hooks Setup no pueden bloquear; la ejecución continúa con cualquier código de salida. Con cualquier código de salida, Claude Code descarta los [campos de salida JSON](#json-output) de un hook Setup, como `systemMessage`, `continue` y `hookSpecificOutput.additionalContext`. Con `-p`, la stdout, la stderr y el código de salida de un hook Setup aparecen en la salida de la ejecución solo como [eventos `hook_response`](/docs/es/headless#read-session-metadata) cuando inicias con `--output-format stream-json --verbose`.1360Los hooks Setup no pueden bloquear; la ejecución continúa con cualquier código de salida. Con cualquier código de salida, Claude Code descarta los [campos de salida JSON](#json-output) de un hook Setup, como `systemMessage`, `continue` y `hookSpecificOutput.additionalContext`. Con `-p`, la stdout, la stderr y el código de salida de un hook Setup aparecen en la salida de la ejecución solo como [eventos `hook_response`](/docs/es/headless#read-session-metadata) cuando inicias con `--output-format stream-json --verbose`.

1361 1361 

1362Los hooks Setup tienen acceso a `CLAUDE_ENV_FILE`. Las variables escritas en ese archivo persisten en los comandos Bash posteriores de la sesión, igual que en los [hooks SessionStart](#persist-environment-variables). Solo los hooks `type: "command"` se ejecutan en `Setup`. Un hook `type: "mcp_tool"` en `Setup` siempre se omite, como se describe en [Campos de hooks de herramientas MCP](#mcp-tool-hook-fields).1362Los hooks Setup tienen acceso a `CLAUDE_ENV_FILE`. Las variables escritas en ese archivo persisten en los comandos Bash posteriores de la sesión, como en los [hooks SessionStart](#persist-environment-variables). Solo los hooks `type: "command"` se ejecutan en `Setup`. Un hook `type: "mcp_tool"` en `Setup` siempre se omite, como se describe en [Campos de hooks de herramientas MCP](#mcp-tool-hook-fields).

1363 1363 

1364<h3 id="instructionsloaded">1364<h3 id="instructionsloaded">

1365 InstructionsLoaded1365 InstructionsLoaded

1366</h3>1366</h3>

1367 1367 

1368Se dispara cuando un archivo `CLAUDE.md` o `.claude/rules/*.md` se carga en el contexto. Este evento se dispara al inicio de la sesión para los archivos cargados de forma anticipada y de nuevo más tarde cuando los archivos se cargan de forma diferida, por ejemplo cuando Claude accede a un subdirectorio que contiene un `CLAUDE.md` anidado o cuando coinciden reglas condicionales con frontmatter `paths:`. El hook no admite bloqueo ni control de decisiones. Se ejecuta de forma asíncrona con fines de observabilidad.1368Se dispara cuando un archivo `CLAUDE.md` o `.claude/rules/*.md` se carga en el contexto. Este evento se dispara al inicio de la sesión para los archivos cargados de forma anticipada y de nuevo más adelante cuando los archivos se cargan de forma diferida, por ejemplo cuando Claude accede a un subdirectorio que contiene un `CLAUDE.md` anidado o cuando coinciden reglas condicionales con frontmatter `paths:`. El hook no admite bloqueo ni control de decisiones. Se ejecuta de forma asíncrona con fines de observabilidad.

1369 1369 

1370Este evento no se dispara cuando Claude [lee `AGENTS.md` directamente](/docs/es/memory#agents-md) mediante el ajuste **Project instructions**. Sí se dispara cuando un `CLAUDE.md` importa tu `AGENTS.md`, con `load_reason` establecido en `include` como para cualquier otro archivo importado, y cuando `CLAUDE.md` es un enlace simbólico a él, como una carga normal de `CLAUDE.md`.1370Este evento no se dispara cuando Claude [lee `AGENTS.md` directamente](/docs/es/memory#agents-md) mediante el ajuste **Project instructions**. Sí se dispara cuando un `CLAUDE.md` importa tu `AGENTS.md`, con `load_reason` establecido en `include` como para cualquier otro archivo importado, y cuando `CLAUDE.md` es un enlace simbólico a él, como una carga normal de `CLAUDE.md`.

1371 1371 


2140| `addRules` | `rules`, `behavior`, `destination` | Agrega reglas de permisos. `rules` es un array de objetos `{toolName, ruleContent?}`. Omite `ruleContent` para coincidir con toda la herramienta. `behavior` es `"allow"`, `"deny"` o `"ask"` |2140| `addRules` | `rules`, `behavior`, `destination` | Agrega reglas de permisos. `rules` es un array de objetos `{toolName, ruleContent?}`. Omite `ruleContent` para coincidir con toda la herramienta. `behavior` es `"allow"`, `"deny"` o `"ask"` |

2141| `replaceRules` | `rules`, `behavior`, `destination` | Reemplaza todas las reglas del `behavior` indicado en el `destination` con las `rules` proporcionadas |2141| `replaceRules` | `rules`, `behavior`, `destination` | Reemplaza todas las reglas del `behavior` indicado en el `destination` con las `rules` proporcionadas |

2142| `removeRules` | `rules`, `behavior`, `destination` | Elimina las reglas que coinciden del `behavior` indicado |2142| `removeRules` | `rules`, `behavior`, `destination` | Elimina las reglas que coinciden del `behavior` indicado |

2143| `setMode` | `mode`, `destination` | Cambia el modo de permisos. Los modos válidos son `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` y `manual` como alias de `default`. El alias `manual` requiere Claude Code v2.1.200 o posterior |2143| `setMode` | `mode`, `destination` | Cambia el modo de permisos. Los modos válidos son `default`, `auto`, `acceptEdits`, `dontAsk`, `bypassPermissions`, `plan` y `manual` como alias de `default` |

2144| `addDirectories` | `directories`, `destination` | Agrega directorios de trabajo. `directories` es un array de cadenas de rutas |2144| `addDirectories` | `directories`, `destination` | Agrega directorios de trabajo. `directories` es un array de cadenas de rutas |

2145| `removeDirectories` | `directories`, `destination` | Elimina directorios de trabajo |2145| `removeDirectories` | `directories`, `destination` | Elimina directorios de trabajo |

2146 2146 

Details

215| `$` | Final de línea |215| `$` | Final de línea |

216| `^` | Primer carácter no en blanco |216| `^` | Primer carácter no en blanco |

217| `gg` | Principio de entrada |217| `gg` | Principio de entrada |

218| `G` | Final de entrada |218| `G` | Principio de la última línea |

219| `f{char}` | Saltar a la siguiente ocurrencia del carácter |219| `f{char}` | Saltar a la siguiente ocurrencia del carácter |

220| `F{char}` | Saltar a la ocurrencia anterior del carácter |220| `F{char}` | Saltar a la ocurrencia anterior del carácter |

221| `t{char}` | Saltar justo antes de la siguiente ocurrencia del carácter |221| `t{char}` | Saltar justo antes de la siguiente ocurrencia del carácter |


355* Las tareas en segundo plano se limpian automáticamente cuando Claude Code se cierra. En macOS y Linux, cuando detiene una tarea en segundo plano desde [`/tasks`](/docs/es/commands) o Claude Code la detiene al salir, los procesos que se desvincularon del shell de la tarea, como los iniciados bajo `setsid` o `timeout`, también se detienen355* Las tareas en segundo plano se limpian automáticamente cuando Claude Code se cierra. En macOS y Linux, cuando detiene una tarea en segundo plano desde [`/tasks`](/docs/es/commands) o Claude Code la detiene al salir, los procesos que se desvincularon del shell de la tarea, como los iniciados bajo `setsid` o `timeout`, también se detienen

356* Si coloca la sesión en segundo plano en lugar de salir, sus tareas en segundo plano continúan ejecutándose en la sesión en segundo plano. Consulte [colocar una sesión en ejecución en segundo plano](/docs/es/agent-view#from-inside-a-session)356* Si coloca la sesión en segundo plano en lugar de salir, sus tareas en segundo plano continúan ejecutándose en la sesión en segundo plano. Consulte [colocar una sesión en ejecución en segundo plano](/docs/es/agent-view#from-inside-a-session)

357* Las tareas en segundo plano se terminan automáticamente si la salida excede 5GB, con una nota en stderr explicando por qué357* Las tareas en segundo plano se terminan automáticamente si la salida excede 5GB, con una nota en stderr explicando por qué

358* En macOS y Linux, Claude Code detiene sus tareas en segundo plano en ejecución cuando el sistema operativo señala presión de memoria crítica, siempre que la sesión haya estado inactiva durante al menos 30 minutos y no se esté ejecutando ningún turno o subagente. Requiere Claude Code v2.1.193 o posterior358* En macOS y Linux, Claude Code detiene tus tareas en segundo plano en ejecución cuando el sistema operativo señala presión de memoria crítica, siempre que la sesión haya estado inactiva durante al menos 30 minutos y no se esté ejecutando ningún turno o subagente

359 * El [registro de depuración](/docs/es/debug-your-config) indica por qué se detuvieron las tareas, o por qué un evento de presión las dejó en ejecución359 * El [registro de depuración](/docs/es/debug-your-config) indica por qué se detuvieron las tareas, o por qué un evento de presión las dejó en ejecución

360 * Establezca [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/es/env-vars) en `1` para desactivar las detenciones por presión de memoria360 * Establece [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/es/env-vars) en `1` para desactivar las detenciones por presión de memoria

361* Los comandos en segundo plano en una sesión local en la que trabajas desde una terminal, la aplicación de escritorio o la extensión de VS Code no tienen límite de tiempo. En una sesión que se ejecuta sin supervisión, como una ejecución con `-p` o una sesión en la nube, Claude Code detiene un comando en segundo plano al alcanzar su [límite de tiempo](/docs/es/tools-reference#time-limit-for-background-commands)361* Los comandos en segundo plano en una sesión local en la que trabajas desde una terminal, la aplicación de escritorio o la extensión de VS Code no tienen límite de tiempo. En una sesión que se ejecuta sin supervisión, como una ejecución con `-p` o una sesión en la nube, Claude Code detiene un comando en segundo plano al alcanzar su [límite de tiempo](/docs/es/tools-reference#time-limit-for-background-commands)

362* Un comando en segundo plano que un [subagente](/docs/es/sub-agents#run-subagents-in-foreground-or-background) en primer plano inició termina cuando ese subagente finaliza su ejecución, ya sea que se haya completado, fallado o fue interrumpido; consulte [Cuándo se detiene un comando en segundo plano](/docs/es/tools-reference#when-a-background-command-stops) en la referencia de herramientas362* Un comando en segundo plano que un [subagente](/docs/es/sub-agents#run-subagents-in-foreground-or-background) en primer plano inició termina cuando ese subagente finaliza su ejecución, ya sea que se haya completado, fallado o fue interrumpido; consulte [Cuándo se detiene un comando en segundo plano](/docs/es/tools-reference#when-a-background-command-stops) en la referencia de herramientas

363 363 


390* Admite el mismo backgrounding `Ctrl+B` para comandos de larga duración390* Admite el mismo backgrounding `Ctrl+B` para comandos de larga duración

391* No requiere que Claude interprete o apruebe el comando391* No requiere que Claude interprete o apruebe el comando

392* Admite autocompletado basado en historial: escriba un comando parcial y presione `Tab` para completar desde comandos `!` anteriores en el proyecto actual392* Admite autocompletado basado en historial: escriba un comando parcial y presione `Tab` para completar desde comandos `!` anteriores en el proyecto actual

393* Admite autocompletado de ruta de archivo en vivo a partir de v2.1.193 en todas las plataformas: escriba un token que contenga una barra diagonal, como `./src/` o `~/`, para ver una lista desplegable de archivos y directorios coincidentes, luego presione `Tab` para aceptar. Use barras diagonales en Windows también; la lista desplegable se activa con `/`, no con `\`393* Admite autocompletado de ruta de archivo en vivo: escribe un token que contenga una barra diagonal, como `./src/` o `~/`, para ver una lista desplegable de archivos y directorios coincidentes, luego presiona `Tab` para aceptar. Usa barras diagonales en Windows también; la lista desplegable se activa con `/`, no con `\`

394* Salga con `Escape`, `Backspace`, o `Ctrl+U` en un indicador vacío394* Salga con `Escape`, `Backspace`, o `Ctrl+U` en un indicador vacío

395* Pegar texto que comienza con `!` en un indicador vacío entra en modo shell automáticamente, coincidiendo con el comportamiento de `!` escrito395* Pegar texto que comienza con `!` en un indicador vacío entra en modo shell automáticamente, coincidiendo con el comportamiento de `!` escrito

396 396 

397A menos que tu sesión sea una de las enumeradas en [modo sandbox estricto](/docs/es/sandboxing#turn-off-the-retry-with-strict-sandbox-mode), los comandos que escribes en modo shell se ejecutan fuera del [sandbox](/docs/es/sandboxing) incluso cuando has habilitado el sandboxing, porque el sandbox se aplica a los comandos que ejecuta Claude.397A menos que tu sesión sea una de las enumeradas en [modo sandbox estricto](/docs/es/sandboxing#turn-off-the-retry-with-strict-sandbox-mode), los comandos que escribes en modo shell se ejecutan fuera del [sandbox](/docs/es/sandboxing) incluso cuando has habilitado el sandboxing, porque el sandbox se aplica a los comandos que ejecuta Claude.

398 398 

399Claude responde automáticamente a la salida del comando una vez que llega a la transcripción, por lo que puede ejecutar `! npm test` y obtener una explicación de los errores sin un segundo indicador. La respuesta cuesta lo mismo que enviar un indicador normal. Para restaurar el comportamiento anterior donde la salida se agrega al contexto sin una respuesta, establezca [`respondToBashCommands`](/docs/es/settings-reference#respondtobashcommands) en `false` en `settings.json`. Antes de v2.1.186, el modo shell siempre agregaba salida al contexto sin una respuesta.399Claude responde automáticamente a la salida del comando una vez que llega a la transcripción, por lo que puedes ejecutar `! npm test` y obtener una explicación de los errores sin un segundo prompt. La respuesta cuesta lo mismo que enviar un prompt normal. Para, en cambio, agregar la salida al contexto sin una respuesta, establece [`respondToBashCommands`](/docs/es/settings-reference#respondtobashcommands) en `false` en `settings.json`.

400 400 

401<h2 id="queue-messages-while-claude-works">401<h2 id="queue-messages-while-claude-works">

402 Encolar mensajes mientras Claude trabaja402 Encolar mensajes mientras Claude trabaja

keybindings.md +5 −5

Details

159| `confirm:no` | Escape | Rechazar acción |159| `confirm:no` | Escape | Rechazar acción |

160| `confirm:previous` | Arriba | Opción anterior |160| `confirm:previous` | Arriba | Opción anterior |

161| `confirm:next` | Abajo | Siguiente opción |161| `confirm:next` | Abajo | Siguiente opción |

162| `confirm:nextField` | Tab | Siguiente campo |162| `confirm:nextField` | Tab | En el diálogo `/fast`, activar o desactivar el modo rápido |

163| `confirm:previousField` | (sin asignar) | Campo anterior |163| `confirm:previousField` | (sin asignar) | Claude Code no responde a esta acción, y un `keybindings.json` que la nombra sigue siendo válido |

164| `confirm:toggle` | Space | Alternar selección |164| `confirm:toggle` | Space | Alternar selección |

165| `confirm:cycleMode` | Shift+Tab\* | Ciclar modos de permisos. En un aviso de permiso de archivo, cierra un [campo de comentario](/docs/es/permissions#add-a-comment-when-you-answer-a-permission-prompt) abierto; sin campo abierto, selecciona la opción que permite la acción para el resto de la sesión, cuando el aviso ofrece esa opción |165| `confirm:cycleMode` | Shift+Tab\* | En una solicitud de permiso de archivo, cierra un [campo de comentario](/docs/es/permissions#add-a-comment-when-you-answer-a-permission-prompt) abierto; sin campo abierto, selecciona la opción que permite la acción para el resto de la sesión, cuando la solicitud ofrece esa opción |

166 166 

167\*En Windows sin modo VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), el valor predeterminado es Meta+M.167\*En Windows sin modo VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), el valor predeterminado es Meta+M.

168 168 


200 200 

201| Acción | Predeterminado | Descripción |201| Acción | Predeterminado | Descripción |

202| :- | :- | :- |202| :- | :- | :- |

203| `permission:toggleDebug` | (sin asignar) | Alternar información de depuración de permisos. El valor predeterminado anterior de Ctrl+D se eliminó en v2.1.146 porque sombreaba `app:exit` |203| `permission:toggleDebug` | (sin asignar) | Claude Code no responde a esta acción, y un `keybindings.json` que la nombra sigue siendo válido |

204 204 

205<h3 id="transcript-actions">205<h3 id="transcript-actions">

206 Acciones de transcripción206 Acciones de transcripción


239 239 

240| Acción | Predeterminado | Descripción |240| Acción | Predeterminado | Descripción |

241| :- | :- | :- |241| :- | :- | :- |

242| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Poner tarea actual en segundo plano. El acorde Ctrl+X Ctrl+B evita el conflicto de prefijo de tmux |242| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | Poner tarea actual en segundo plano |

243 243 

244<h3 id="theme-actions">244<h3 id="theme-actions">

245 Acciones de tema245 Acciones de tema

Details

68 68 

69| Iniciar desde | Acceso a archivos | CLAUDE.md cargado al inicio | Usar cuando |69| Iniciar desde | Acceso a archivos | CLAUDE.md cargado al inicio | Usar cuando |

70| :- | :- | :- | :- |70| :- | :- | :- | :- |

71| Raíz del repositorio | Cada archivo | Solo raíz; los archivos de subdirectorio se cargan bajo demanda cuando Claude lee allí | Las tareas abarcan múltiples paquetes o subsistemas |71| Raíz del repositorio | Cada archivo | Solo raíz; los archivos de subdirectorio se cargan bajo demanda | Las tareas abarcan múltiples paquetes o subsistemas |

72| Un subdirectorio | Solo ese subárbol, hasta que otorgue más | El de ese directorio más el de cada antecesor | El trabajo se limita a un paquete o subsistema |72| Un subdirectorio | Solo ese subárbol, hasta que otorgue más | El de ese directorio más el de cada antecesor | El trabajo se limita a un paquete o subsistema |

73 73 

74Las configuraciones de proyecto en `.claude/settings.json` no se heredan de directorios padres de la manera que lo hacen los archivos CLAUDE.md. Para saber qué directorio `.claude/settings.json` lee una sesión, consulte [dónde Claude Code busca cada archivo](/docs/es/settings#where-claude-code-looks-for-each-file).74Las configuraciones de proyecto en `.claude/settings.json` no se heredan de directorios padres de la manera que lo hacen los archivos CLAUDE.md. Para saber qué directorio `.claude/settings.json` lee una sesión, consulte [dónde Claude Code busca cada archivo](/docs/es/settings#where-claude-code-looks-for-each-file).


81 81 

82En un codebase grande, un único CLAUDE.md en la raíz del repositorio tiende a crecer para cubrir las convenciones de cada subsistema, costando contexto en instrucciones no relacionadas con la tarea actual, o permanecer demasiado genérico para ser útil. Dividir instrucciones en archivos por directorio significa que Claude carga reglas de todo el repositorio más solo las convenciones para el código en el que está trabajando.82En un codebase grande, un único CLAUDE.md en la raíz del repositorio tiende a crecer para cubrir las convenciones de cada subsistema, costando contexto en instrucciones no relacionadas con la tarea actual, o permanecer demasiado genérico para ser útil. Dividir instrucciones en archivos por directorio significa que Claude carga reglas de todo el repositorio más solo las convenciones para el código en el que está trabajando.

83 83 

84Claude Code carga cada archivo [CLAUDE.md](/docs/es/memory) desde su directorio de trabajo y cada directorio padre al inicio, luego carga el archivo de cada subdirectorio bajo demanda cuando lee archivos allí. Un archivo raíz establece reglas de todo el repositorio y cada subdirectorio agrega las suyas propias.84Claude Code carga cada archivo [CLAUDE.md](/docs/es/memory) desde tu directorio de trabajo y cada directorio padre al inicio, y luego carga el archivo de cada subdirectorio [bajo demanda](/docs/es/memory#how-claude-md-files-load). Un archivo raíz establece las reglas de todo el repositorio y cada subdirectorio agrega las suyas propias.

85 85 

86Una división común es dos niveles:86Una división común es dos niveles:

87 87 


124 124 

125| Enfoque | Ubicación del archivo | Se carga cuando | Usar cuando |125| Enfoque | Ubicación del archivo | Se carga cuando | Usar cuando |

126| :- | :- | :- | :- |126| :- | :- | :- | :- |

127| CLAUDE.md por directorio | Dentro del directorio, junto a su código | Al inicio cuando se inicia desde ese directorio, o bajo demanda cuando Claude lee un archivo allí | Los propietarios del directorio mantienen sus propias convenciones; las instrucciones se versionan con el código |127| `CLAUDE.md` por directorio | Dentro del directorio, junto a su código | Al inicio cuando se inicia desde ese directorio, o bajo demanda | Los propietarios del directorio mantienen sus propias convenciones; las instrucciones se versionan con el código |

128| Regla con alcance de ruta en `.claude/rules/` | `.claude/` central en la raíz del repositorio | Cuando Claude trabaja con un archivo que coincide con el glob `paths:` de la regla | Desea todas las convenciones en un lugar, o la misma regla se aplica a muchas rutas dispersas |128| Regla con alcance de ruta en `.claude/rules/` | `.claude/` central en la raíz del repositorio | Cuando Claude trabaja con un archivo que coincide con el glob `paths:` de la regla | Desea todas las convenciones en un lugar, o la misma regla se aplica a muchas rutas dispersas |

129 129 

130Para una comparación que también cubre skills, consulte [Comparar características similares](/docs/es/features-overview#compare-similar-features).130Para una comparación que también cubre skills, consulte [Comparar características similares](/docs/es/features-overview#compare-similar-features).


133 Excluir archivos CLAUDE.md irrelevantes133 Excluir archivos CLAUDE.md irrelevantes

134</h3>134</h3>

135 135 

136Cuando inicia Claude desde la raíz del repositorio, el CLAUDE.md de cada subdirectorio se carga tan pronto como Claude lee un archivo en ese directorio. La configuración `claudeMdExcludes` omite archivos específicos por ruta o patrón glob para que nunca se carguen.136Cuando inicias Claude desde la raíz del repositorio, el CLAUDE.md de cada subdirectorio puede [cargarse bajo demanda](/docs/es/memory#how-claude-md-files-load) durante la sesión. El ajuste `claudeMdExcludes` omite archivos específicos por ruta o patrón glob para que nunca se carguen.

137 137 

138Úselo para directorios en los que nunca trabaja, como paquetes de otros equipos, código heredado o subárboles vendidos. La lista de exclusión es estática, no un interruptor por tarea. Para enfocarse en un paquete hoy y otro mañana, [inicie Claude desde el directorio de ese paquete](#choose-where-to-start-claude) en lugar de editar exclusiones.138Úselo para directorios en los que nunca trabaja, como paquetes de otros equipos, código heredado o subárboles vendidos. La lista de exclusión es estática, no un interruptor por tarea. Para enfocarse en un paquete hoy y otro mañana, [inicie Claude desde el directorio de ese paquete](#choose-where-to-start-claude) en lugar de editar exclusiones.

139 139 


290 290 

291Esta sección se aplica cuando inicia Claude desde un subdirectorio, o cuando una tarea abarca múltiples checkouts. Si inicia desde la raíz del repositorio en un árbol único grande, Claude ya tiene acceso a cada archivo y puede omitir esto.291Esta sección se aplica cuando inicia Claude desde un subdirectorio, o cuando una tarea abarca múltiples checkouts. Si inicia desde la raíz del repositorio en un árbol único grande, Claude ya tiene acceso a cada archivo y puede omitir esto.

292 292 

293Cuando inicia Claude desde `packages/api/`, puede leer y escribir archivos dentro de ese directorio. Si una tarea requiere cambios entre paquetes, como actualizar un tipo compartido que tanto `api` como `web` importan, necesita otorgar acceso al directorio hermano. El mismo mecanismo otorga acceso a un repositorio verificado por separado.293Cuando inicias Claude desde `packages/api/`, puede leer y escribir archivos dentro de ese directorio. Si una tarea requiere cambios entre paquetes, como actualizar un tipo compartido que importan tanto `api` como `web`, necesitas otorgar acceso al directorio hermano. El mismo mecanismo otorga acceso a un repositorio extraído por separado.

294 294 

295La configuración `additionalDirectories` en `.claude/settings.json` da a Claude acceso a directorios fuera del directorio de trabajo. El ejemplo a continuación otorga acceso a dos paquetes hermanos:295La configuración `additionalDirectories` en `.claude/settings.json` da a Claude acceso a directorios fuera del directorio de trabajo. El ejemplo a continuación otorga acceso a dos paquetes hermanos:

296 296 

mcp.md +2 −2

Details

52 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.52 * `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.

53 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.53 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.

54 54 

55 Si el resumen de instalación reporta `Run /reload-plugins to activate.`, Claude Code ejecuta ese recarga para usted. Si la recarga advierte que su próximo mensaje volvería a leer la conversación, ejecute `/reload-plugins --force`.55 Si el resumen de instalación reporta `Run /reload-plugins to apply.`, Claude Code ejecuta esa recarga por ti. Si la recarga advierte que tu próximo mensaje volvería a leer la conversación, ejecuta `/reload-plugins --force`.

56 </Step>56 </Step>

57 57 

58 <Step title="Ejecutar la skill de construcción">58 <Step title="Ejecutar el skill de creación">

59 ```59 ```

60 /mcp-server-dev:build-mcp-server60 /mcp-server-dev:build-mcp-server

61 ```61 ```

memory.md +33 −30

Details

69| **Instrucciones de proyecto** | `./CLAUDE.md` o `./.claude/CLAUDE.md`. Consulta [AGENTS.md](#agents-md) para saber cuándo `./AGENTS.md` se carga en su lugar o junto con ellos | Instrucciones compartidas por el equipo para el proyecto | Arquitectura del proyecto, estándares de codificación, flujos de trabajo comunes | Miembros del equipo a través del control de versiones |69| **Instrucciones de proyecto** | `./CLAUDE.md` o `./.claude/CLAUDE.md`. Consulta [AGENTS.md](#agents-md) para saber cuándo `./AGENTS.md` se carga en su lugar o junto con ellos | Instrucciones compartidas por el equipo para el proyecto | Arquitectura del proyecto, estándares de codificación, flujos de trabajo comunes | Miembros del equipo a través del control de versiones |

70| **Instrucciones locales** | `./CLAUDE.local.md` | Preferencias personales específicas del proyecto; agrégalo a `.gitignore` | Tus URLs de sandbox, datos de prueba preferidos | Solo tú (proyecto actual) |70| **Instrucciones locales** | `./CLAUDE.local.md` | Preferencias personales específicas del proyecto; agrégalo a `.gitignore` | Tus URLs de sandbox, datos de prueba preferidos | Solo tú (proyecto actual) |

71 71 

72Los archivos CLAUDE.md y CLAUDE.local.md en la jerarquía de directorios por encima del directorio de trabajo se cargan al iniciar. Los archivos en subdirectorios se cargan bajo demanda cuando Claude lee archivos en esos directorios. Consulta [Cómo se cargan los archivos CLAUDE.md](#how-claude-md-files-load) para ver el orden de resolución completo.72Los archivos CLAUDE.md y CLAUDE.local.md en la jerarquía de directorios por encima del directorio de trabajo se cargan al iniciar. Los archivos en subdirectorios se cargan bajo demanda. Consulta [Cómo se cargan los archivos CLAUDE.md](#how-claude-md-files-load) para saber cuándo se cargan y ver el orden de resolución completo.

73 73 

74Para proyectos grandes, puedes dividir las instrucciones en archivos específicos por tema utilizando [reglas de proyecto](#organize-rules-with-claude/rules/). Las reglas te permiten limitar las instrucciones a tipos de archivo o subdirectorios específicos.74Para proyectos grandes, puedes dividir las instrucciones en archivos específicos por tema utilizando [reglas de proyecto](#organize-rules-with-claude/rules/). Las reglas te permiten limitar las instrucciones a tipos de archivo o subdirectorios específicos.

75 75 


161 161 

162Todos los archivos descubiertos se concatenan en contexto en lugar de sobrescribirse entre sí. A lo largo del árbol de directorios, el contenido se ordena desde la raíz del sistema de archivos hasta tu directorio de trabajo. En el ejemplo de `foo/bar/`, `foo/CLAUDE.md` aparece en contexto antes que `foo/bar/CLAUDE.md`, por lo que las instrucciones más cercanas a donde iniciaste Claude se leen al final. Dentro de cada directorio, `CLAUDE.local.md` se añade después de `CLAUDE.md`, por lo que tus notas personales son lo último que Claude lee en ese nivel.162Todos los archivos descubiertos se concatenan en contexto en lugar de sobrescribirse entre sí. A lo largo del árbol de directorios, el contenido se ordena desde la raíz del sistema de archivos hasta tu directorio de trabajo. En el ejemplo de `foo/bar/`, `foo/CLAUDE.md` aparece en contexto antes que `foo/bar/CLAUDE.md`, por lo que las instrucciones más cercanas a donde iniciaste Claude se leen al final. Dentro de cada directorio, `CLAUDE.local.md` se añade después de `CLAUDE.md`, por lo que tus notas personales son lo último que Claude lee en ese nivel.

163 163 

164Claude también descubre archivos `CLAUDE.md` y `CLAUDE.local.md` en subdirectorios bajo tu directorio de trabajo actual. En lugar de cargarse al iniciar, se incluyen cuando Claude lee archivos en esos subdirectorios. Para archivos dentro de un worktree bajo `.claude/worktrees/`, consulta [Aislar subagentes con worktrees](/docs/es/worktrees#isolate-subagents-with-worktrees).164Claude también descubre archivos `CLAUDE.md` y `CLAUDE.local.md` en subdirectorios bajo tu directorio de trabajo actual. En lugar de cargarlos al iniciar, Claude Code los incluye cuando Claude usa la herramienta [Read](/docs/es/tools-reference#read-tool-behavior), [Write](/docs/es/tools-reference#write-tool-behavior) o [Edit](/docs/es/tools-reference#edit-tool-behavior) en un archivo de esos subdirectorios. Si Claude ya usó una de esas herramientas sobre el propio `CLAUDE.md` de un subdirectorio, ese archivo no se carga de esta manera, porque Claude Code lo considera ya presente en la conversación. Para archivos dentro de un worktree bajo `.claude/worktrees/`, consulta [Aislar subagentes con worktrees](/docs/es/worktrees#isolate-subagents-with-worktrees).

165 165 

166Si trabajas en un monorepo grande donde se recogen archivos CLAUDE.md de otros equipos, usa [`claudeMdExcludes`](#exclude-specific-claude-md-files) para omitirlos. Para ver la estructura completa de archivos CLAUDE.md raíz y por directorio y de las reglas, consulta [Monorepos y repositorios grandes](/docs/es/large-codebases).166Si trabajas en un monorepo grande donde se recogen archivos CLAUDE.md de otros equipos, usa [`claudeMdExcludes`](#exclude-specific-claude-md-files) para omitirlos. Para ver la estructura completa de archivos CLAUDE.md raíz y por directorio y de las reglas, consulta [Monorepos y repositorios grandes](/docs/es/large-codebases).

167 167 


429| `claude-md-or-agents-md` | Sus archivos `CLAUDE.md`, o sus archivos `AGENTS.md` cuando no tiene `CLAUDE.md` o `CLAUDE.local.md` en su directorio de trabajo o superior. Este es el valor predeterminado |429| `claude-md-or-agents-md` | Sus archivos `CLAUDE.md`, o sus archivos `AGENTS.md` cuando no tiene `CLAUDE.md` o `CLAUDE.local.md` en su directorio de trabajo o superior. Este es el valor predeterminado |

430| `claude-md-and-agents-md` | Sus archivos `CLAUDE.md` y `AGENTS.md` juntos, los archivos `CLAUDE.md` de cada directorio primero y su `AGENTS.md` después. Claude Code omite un `AGENTS.md` que ya ha cargado, por lo que uno que su `CLAUDE.md` importa o vincula simbólicamente no se lee dos veces |430| `claude-md-and-agents-md` | Sus archivos `CLAUDE.md` y `AGENTS.md` juntos, los archivos `CLAUDE.md` de cada directorio primero y su `AGENTS.md` después. Claude Code omite un `AGENTS.md` que ya ha cargado, por lo que uno que su `CLAUDE.md` importa o vincula simbólicamente no se lee dos veces |

431| `claude-md` | Solo sus archivos `CLAUDE.md` |431| `claude-md` | Solo sus archivos `CLAUDE.md` |

432| `managed-only` | Solo el `CLAUDE.md` administrado de su organización y [auto memory](#auto-memory) al iniciar. Sus archivos `CLAUDE.md` de proyecto, local y usuario, sus archivos `.claude/rules/`, y cada `AGENTS.md` se dejan fuera. El `CLAUDE.md` de un subdirectorio y los archivos `.claude/rules/`, y las [reglas con alcance de ruta](#path-specific-rules), aún se cargan cuando Claude lee un archivo allí |432| `managed-only` | Solo el `CLAUDE.md` administrado de tu organización y la [memoria automática](#auto-memory) al iniciar. Tus archivos `CLAUDE.md` de proyecto, local y usuario, tus archivos `.claude/rules/`, y cada `AGENTS.md` se dejan fuera. El `CLAUDE.md` de un subdirectorio y sus archivos `.claude/rules/`, y las [reglas con alcance de ruta](#path-specific-rules), aún se cargan bajo demanda |

433 433 

434También puede establecer el valor en un archivo de configuración en lugar de `/config`. Agréguelo bajo el ID del plugin `agents-md` integrado en [`pluginConfigs`](/docs/es/settings-reference#pluginconfigs), en `~/.claude/settings.json`, un archivo `--settings` o [configuración administrada](/docs/es/managed-settings). Claude Code lo ignora en archivos de configuración de proyecto y local. Este ejemplo hace que Claude lea ambos archivos:434También puedes establecer el valor en un archivo de configuración en lugar de `/config`. Agrégalo en [`pluginConfigs`](/docs/es/settings-reference#pluginconfigs) bajo `cc-plugin-agents-md@builtin`, el ID del plugin integrado que lee `AGENTS.md`. Claude Code lee la entrada desde `~/.claude/settings.json`, un archivo `--settings` o la [configuración administrada](/docs/es/managed-settings), y la ignora en los archivos de configuración de proyecto y local. Este ejemplo hace que Claude lea ambos archivos:

435 435 

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

437{437{

438 "pluginConfigs": {438 "pluginConfigs": {

439 "agents-md@builtin": {439 "cc-plugin-agents-md@builtin": {

440 "options": { "instructionFiles": "claude-md-and-agents-md" }440 "options": { "instructionFiles": "claude-md-and-agents-md" }

441 }441 }

442 }442 }

443}443}

444```444```

445 445 

446Antes de v2.1.285, el ID del plugin era `agents-md@builtin`, y Claude Code ignoraba una entrada bajo `cc-plugin-agents-md@builtin`. Si versiones anteriores también leen tu archivo de configuración, usa `agents-md@builtin` allí. Claude Code v2.1.285 y posteriores leen una entrada bajo cualquiera de los dos ID.

447 

446Su cambio se aplica desde el siguiente mensaje que envíe y en cada nueva sesión.448Su cambio se aplica desde el siguiente mensaje que envíe y en cada nueva sesión.

447 449 

448<h3 id="when-agents-md-support-is-unavailable">450<h3 id="when-agents-md-support-is-unavailable">


452En estas sesiones Claude lee solo archivos `CLAUDE.md`, y **Project instructions** no aparece en el panel de configuración `/config`:454En estas sesiones Claude lee solo archivos `CLAUDE.md`, y **Project instructions** no aparece en el panel de configuración `/config`:

453 455 

454* Está en una versión de Claude Code anterior a v2.1.277456* Está en una versión de Claude Code anterior a v2.1.277

455* Usted deshabilitó el plugin `agents-md` integrado en `/plugin`457* Usaste `/plugin` para deshabilitar el plugin integrado que lee `AGENTS.md`

456* En algunos casos, es su [primera sesión después de actualizar](/docs/es/env-vars#first-session-after-an-install-or-upgrade) desde v2.1.276 o anterior. Claude lee `AGENTS.md` desde su siguiente sesión458* En algunos casos, es su [primera sesión después de actualizar](/docs/es/env-vars#first-session-after-an-install-or-upgrade) desde v2.1.276 o anterior. Claude lee `AGENTS.md` desde su siguiente sesión

457 459 

458Antes de v2.1.281, algunas sesiones, como las en Amazon Bedrock o con telemetría deshabilitada, leían solo archivos `CLAUDE.md`. En esas versiones, actualice Claude Code. Para darle a Claude su `AGENTS.md` en cualquiera de estas sesiones, [impórtelo desde un `CLAUDE.md`](#share-one-file-with-other-coding-tools).460Antes de v2.1.281, algunas sesiones, como las en Amazon Bedrock o con telemetría deshabilitada, leían solo archivos `CLAUDE.md`. En esas versiones, actualice Claude Code. Para darle a Claude su `AGENTS.md` en cualquiera de estas sesiones, [impórtelo desde un `CLAUDE.md`](#share-one-file-with-other-coding-tools).


623 Ver y editar con `/memory`625 Ver y editar con `/memory`

624</h2>626</h2>

625 627 

626El comando `/memory` enumera sus archivos CLAUDE.md, CLAUDE.local.md y otros archivos de memoria en los ámbitos de usuario y proyecto, incluidas las entradas CLAUDE.md de usuario y proyecto para archivos que aún no existen. También le permite alternar auto memory activado o desactivado y proporciona una opción para abrir la carpeta de auto memory. Seleccione cualquier archivo para abrirlo en su editor; seleccionar uno que aún no existe lo crea primero. Para verificar qué archivos `CLAUDE.md` y archivos de reglas se cargaron en la sesión actual, ejecute `/context`.628El comando `/memory` enumera tus archivos CLAUDE.md, CLAUDE.local.md y otras ubicaciones de archivos de memoria en los alcances de usuario y proyecto, incluidas las entradas CLAUDE.md de usuario y proyecto para archivos que aún no existen. También te permite activar o desactivar la memoria automática y ofrece una opción para abrir la carpeta de memoria automática. Selecciona cualquier archivo para abrirlo en tu editor; si seleccionas uno que aún no existe, primero se crea. Para verificar qué archivos `CLAUDE.md` y archivos de reglas se cargaron al iniciar, ejecuta `/context`.

627 629 

628Los editores GUI como VS Code abren el archivo en una ventana separada, y puede seguir usando la sesión mientras está abierto. Antes de v2.1.216, `/memory` esperaba a que cerrara el archivo antes de responder. Los editores de terminal como Vim toman el control del terminal hasta que salga.630Los editores GUI como VS Code abren el archivo en una ventana separada, y puede seguir usando la sesión mientras está abierto. Antes de v2.1.216, `/memory` esperaba a que cerrara el archivo antes de responder. Los editores de terminal como Vim toman el control del terminal hasta que salga.

629 631 


633 Solucionar problemas de memoria635 Solucionar problemas de memoria

634</h2>636</h2>

635 637 

636Estos son los problemas más comunes con CLAUDE.md y auto memory, junto con pasos para depurarlos.638Estos son los problemas más comunes con CLAUDE.md y la memoria automática, junto con pasos para depurarlos.

637 639 

638<h3 id="claude-isn’t-following-my-claude-md">640<h3 id="claude-isn’t-following-my-claude-md">

639 Claude no está siguiendo mi CLAUDE.md641 Claude no está siguiendo mi CLAUDE.md


643 645 

644Para depurar:646Para depurar:

645 647 

646* Ejecute `/context` y verifique la lista bajo **Memory files** para verificar que sus archivos CLAUDE.md y CLAUDE.local.md se cargaron. Si un archivo `CLAUDE.md` no aparece allí, Claude no puede verlo. Use `/memory` para abrir y editar los archivos.648* Ejecuta `/context` y revisa la lista bajo **Memory files** para verificar los archivos CLAUDE.md y CLAUDE.local.md que deberían cargarse al iniciar. Si falta uno allí, Claude no puede verlo. Usa `/memory` para abrir y editar los archivos.

647* Verifique que el CLAUDE.md relevante esté en una ubicación que se cargue para su sesión (consulte [Elija dónde colocar los archivos CLAUDE.md](#choose-where-to-put-claude-md-files)).649* Un `CLAUDE.md` en un subdirectorio de tu directorio de trabajo no aparece bajo **Memory files**, porque se carga bajo demanda en lugar de al iniciar. Cuando se carga, aparece en la terminal una línea `Loaded` con su ruta. Para probar uno nuevo, créalo desde tu shell en lugar de pedirle a Claude que lo escriba, y luego pídele a Claude que lea un archivo en ese subdirectorio.

648* Haga instrucciones más específicas. "Usar indentación de 2 espacios" funciona mejor que "formatear código bien".650* Verifica que el CLAUDE.md relevante esté en una ubicación que se cargue para tu sesión (consulta [Elige dónde colocar los archivos CLAUDE.md](#choose-where-to-put-claude-md-files)).

649* Busque instrucciones conflictivas en archivos CLAUDE.md. Si dos archivos dan orientación diferente para el mismo comportamiento, Claude puede elegir uno arbitrariamente.651* Haz instrucciones más específicas. "Usar indentación de 2 espacios" funciona mejor que "formatear código bien".

650* Verifique si su instrucción compite con la orientación que Claude Code añade por su cuenta. Si su CLAUDE.md establece reglas de commit o pull request, desactive las integradas con [`includeGitInstructions`](/docs/es/settings-reference#includegitinstructions) y establezca el texto de atribución con [`attribution`](/docs/es/settings-reference#attribution).652* Busca instrucciones conflictivas en archivos CLAUDE.md. Si dos archivos dan orientación diferente para el mismo comportamiento, Claude puede elegir uno arbitrariamente.

653* Verifica si tu instrucción compite con la orientación que Claude Code añade por su cuenta. Si tu CLAUDE.md establece reglas de commit o pull request, desactiva las integradas con [`includeGitInstructions`](/docs/es/settings-reference#includegitinstructions) y establece el texto de atribución con [`attribution`](/docs/es/settings-reference#attribution).

651 654 

652Si la instrucción es algo que debe ejecutarse en un punto específico, como antes de cada commit o después de cada edición de archivo, escríbala como un [hook](/docs/es/hooks-guide) en su lugar. Los hooks se ejecutan como comandos de shell en eventos de ciclo de vida fijos y se aplican independientemente de lo que Claude decida hacer.655Si la instrucción es algo que debe ejecutarse en un punto específico, como antes de cada commit o después de cada edición de archivo, escríbela como un [hook](/docs/es/hooks-guide) en su lugar. Los hooks se ejecutan como comandos de shell en eventos de ciclo de vida fijos y se aplican independientemente de lo que Claude decida hacer.

653 656 

654Para instrucciones que desea a nivel de prompt del sistema, use [`--append-system-prompt`](/docs/es/cli-reference#system-prompt-flags). Esto debe pasarse en el lanzamiento, por lo que es más adecuado para scripts y automatización que para uso interactivo. Para saber cómo se comporta cuando reanuda una conversación, consulte [System prompt flags in resumed conversations](/docs/es/cli-reference#system-prompt-flags-in-resumed-conversations).657Para instrucciones que quieres a nivel de prompt del sistema, usa [`--append-system-prompt`](/docs/es/cli-reference#system-prompt-flags). Lo pasas al iniciar, por lo que es más adecuado para scripts y automatización que para uso interactivo. Para saber cómo se comporta cuando reanudas una conversación, consulta [System prompt flags in resumed conversations](/docs/es/cli-reference#system-prompt-flags-in-resumed-conversations).

655 658 

656<Tip>659<Tip>

657 Use el hook [`InstructionsLoaded`](/docs/es/hooks#instructionsloaded) para registrar exactamente qué archivos de instrucciones se cargan, cuándo se cargan y por qué. Esto es útil para depurar reglas específicas de ruta o archivos cargados perezosamente en subdirectorios.660 Usa el [hook `InstructionsLoaded`](/docs/es/hooks#instructionsloaded) para registrar qué archivos `CLAUDE.md` y de reglas se cargan, cuándo se cargan y por qué. Esto es útil para depurar reglas específicas de ruta o archivos cargados perezosamente en subdirectorios.

658</Tip>661</Tip>

659 662 

660<h3 id="my-agents-md-isn’t-loading">663<h3 id="my-agents-md-isn’t-loading">

661 Mi AGENTS.md no se está cargando664 Mi AGENTS.md no se está cargando

662</h3>665</h3>

663 666 

664Si su repositorio tiene un `AGENTS.md` y Claude no parece saber qué dice, la causa habitual es un `CLAUDE.md` en algún lugar de la ruta del proyecto. Por defecto, Claude lee `AGENTS.md` solo cuando no tiene `CLAUDE.md` o `CLAUDE.local.md` en su directorio de trabajo o por encima de él. Verifique estos en orden:667Si tu repositorio tiene un `AGENTS.md` y Claude no parece saber qué dice, la causa habitual es un `CLAUDE.md` en algún lugar de la ruta del proyecto. Por defecto, Claude lee `AGENTS.md` solo cuando no tienes `CLAUDE.md` o `CLAUDE.local.md` en tu directorio de trabajo o por encima de él. Verifica estos en orden:

665 668 

6661. Busque un `CLAUDE.md`, `.claude/CLAUDE.md`, o `CLAUDE.local.md` en su directorio de trabajo o en cualquier directorio por encima de él, excepto su `~/.claude/CLAUDE.md`. Si encuentra uno, Claude lo lee en lugar de `AGENTS.md` a menos que establezca **Project instructions** en `claude-md-and-agents-md`.6691. Busca un `CLAUDE.md`, `.claude/CLAUDE.md`, o `CLAUDE.local.md` en tu directorio de trabajo o en cualquier directorio por encima de él, excepto tu `~/.claude/CLAUDE.md`. Si encuentras uno, Claude lo lee en lugar de `AGENTS.md` a menos que establezcas **Project instructions** en `claude-md-and-agents-md`.

6672. Ejecute `claude --version` y confirme v2.1.277 o posterior. Antes de v2.1.281, algunas sesiones, como las en Amazon Bedrock o con telemetría deshabilitada, [no podían cargar `AGENTS.md`](#when-agents-md-support-is-unavailable) tampoco, por lo que en esas versiones actualice a v2.1.281 o posterior.6702. Ejecuta `claude --version` y confirma v2.1.277 o posterior. Antes de v2.1.281, algunas sesiones, como las de Amazon Bedrock o con telemetría deshabilitada, [no podían cargar `AGENTS.md`](#when-agents-md-support-is-unavailable) tampoco, por lo que en esas versiones actualiza a v2.1.281 o posterior.

6683. Escriba `/config` en su sesión para abrir el panel de configuración y confirme que **Project instructions** no está establecido en `claude-md` o `managed-only`. Si no ve la configuración allí en absoluto, su sesión es una que [no puede cargar `AGENTS.md`](#when-agents-md-support-is-unavailable).6713. Escribe `/config` en tu sesión para abrir el panel de configuración y confirma que **Project instructions** no está establecido en `claude-md` o `managed-only`. Si no ves el ajuste allí en absoluto, tu sesión es una que [no puede cargar `AGENTS.md`](#when-agents-md-support-is-unavailable).

669 672 

670Para verificar si Claude leyó su `AGENTS.md`, ejecute `/memory` y busque su ruta en la lista.673Para verificar si Claude leyó tu `AGENTS.md`, ejecuta `/memory` y busca su ruta en la lista.

671 674 

672Antes de v2.1.280, `/memory` y `/context` no listaban un `AGENTS.md` que Claude leyera directamente. En esas versiones, pregúntele a Claude qué dicen sus instrucciones de proyecto en su lugar.675Antes de v2.1.280, `/memory` y `/context` no listaban un `AGENTS.md` que Claude leyera directamente. En esas versiones, pregúntale a Claude qué dicen sus instrucciones de proyecto en su lugar.

673 676 

674Si desea mantener el `CLAUDE.md` que encontró, o su sesión no puede cargar `AGENTS.md`, [agregue un `CLAUDE.md` junto a su `AGENTS.md` que lo importe](#share-one-file-with-other-coding-tools).677Si quieres mantener el `CLAUDE.md` que encontraste, o tu sesión no puede cargar `AGENTS.md`, [agrega un `CLAUDE.md` junto a tu `AGENTS.md` que lo importe](#share-one-file-with-other-coding-tools).

675 678 

676<h3 id="i-don’t-know-what-auto-memory-saved">679<h3 id="i-don’t-know-what-auto-memory-saved">

677 No sé qué guardó auto memory680 No sé qué guardó la memoria automática

678</h3>681</h3>

679 682 

680Ejecute `/memory` y seleccione la carpeta de auto memory para examinar lo que Claude ha guardado. Todo es markdown plano que puede leer, editar o eliminar.683Ejecuta `/memory` y selecciona la carpeta de memoria automática para examinar lo que Claude ha guardado. Todo es markdown plano que puedes leer, editar o eliminar.

681 684 

682<h3 id="my-claude-md-is-too-large">685<h3 id="my-claude-md-is-too-large">

683 Mi CLAUDE.md es demasiado grande686 Mi CLAUDE.md es demasiado grande

684</h3>687</h3>

685 688 

686Los archivos de más de 200 líneas consumen más contexto y pueden reducir la adherencia. Claude Code omite un archivo de más de 4 MiB. Use [reglas con alcance de ruta](#path-specific-rules) para cargar instrucciones solo cuando Claude trabaja con archivos coincidentes, o recorte contenido que no sea necesario en cada sesión. Dividir en [importaciones `@path`](#import-additional-files) ayuda a la organización pero no reduce el contexto, ya que los archivos importados se cargan al iniciar.689Los archivos de más de 200 líneas consumen más contexto y pueden reducir la adherencia. Claude Code omite un archivo de más de 4 MiB. Usa [reglas con alcance de ruta](#path-specific-rules) para cargar instrucciones solo cuando Claude trabaja con archivos coincidentes, o recorta contenido que no sea necesario en cada sesión. Dividir en [importaciones `@path`](#import-additional-files) ayuda a la organización pero no reduce el contexto, ya que los archivos importados se cargan al iniciar.

687 690 

688Si uno de sus archivos de instrucciones supera la longitud recomendada, verá una advertencia al iniciar y cuando ejecute `/status`. También verá una advertencia cuando archivos que están cada uno dentro de esa longitud se suman más allá de un límite combinado al inicio de la sesión. Cada CLAUDE.md, archivo de reglas e importación `@path` cuenta como un archivo separado.691Si uno de tus archivos de instrucciones supera la longitud recomendada, verás una advertencia al iniciar y cuando ejecutes `/status`. También verás una advertencia cuando archivos que están cada uno dentro de esa longitud se suman más allá de un límite combinado al inicio de la sesión. Cada CLAUDE.md, archivo de reglas e importación `@path` cuenta como un archivo separado.

689 692 

690La revisión [`/doctor`](/docs/es/commands#all-commands) propone recortes para un CLAUDE.md registrado: elimina contenido que Claude puede derivar de la base de código, como diseños de directorios, listas de dependencias y descripción general de la arquitectura, y mantiene trampas, justificación y convenciones que difieren de los valores predeterminados de las herramientas. La verificación de recorte requiere Claude Code v2.1.206 o posterior.693La revisión [`/doctor`](/docs/es/commands#all-commands) propone recortes para un CLAUDE.md registrado: elimina contenido que Claude puede derivar de la base de código, como diseños de directorios, listas de dependencias y descripción general de la arquitectura, y mantiene trampas, justificación y convenciones que difieren de los valores predeterminados de las herramientas. La verificación de recorte requiere Claude Code v2.1.206 o posterior.

691 694 


693 Las instrucciones parecen perdidas después de `/compact`696 Las instrucciones parecen perdidas después de `/compact`

694</h3>697</h3>

695 698 

696CLAUDE.md de raíz de proyecto sobrevive a la compactación: después de `/compact`, Claude vuelve a leer desde el disco e lo reinyecta en la sesión. Los archivos CLAUDE.md anidados en subdirectorios y reglas con [frontmatter `paths:`](#path-specific-rules) se recargan cuando Claude lee archivos a los que se aplican.699El CLAUDE.md de la raíz del proyecto sobrevive a la compactación: después de `/compact`, Claude lo vuelve a leer desde el disco y lo reinyecta en la sesión. Los archivos CLAUDE.md anidados en subdirectorios y las reglas con [frontmatter `paths:`](#path-specific-rules) se vuelven a cargar bajo demanda.

697 700 

698Si una instrucción desapareció después de la compactación, se dio solo en la conversación, vive en un CLAUDE.md anidado que aún no se ha recargado, o es una regla con alcance de ruta que no ha coincidido con un archivo desde entonces. Agregue instrucciones solo de conversación a CLAUDE.md para que persistan. Consulte [Qué sobrevive a la compactación](/docs/es/context-window#what-survives-compaction) para el desglose completo.701Si una instrucción desapareció después de la compactación, se dio solo en la conversación, vive en un CLAUDE.md anidado que aún no se ha recargado, o es una regla con alcance de ruta que no ha coincidido con un archivo desde entonces. Agrega las instrucciones solo de conversación a CLAUDE.md para que persistan. Consulta [Qué sobrevive a la compactación](/docs/es/context-window#what-survives-compaction) para el desglose completo.

699 702 

700Consulte [Escriba instrucciones efectivas](#write-effective-instructions) para obtener orientación sobre tamaño, estructura y especificidad.703Consulta [Escribe instrucciones efectivas](#write-effective-instructions) para obtener orientación sobre tamaño, estructura y especificidad.

701 704 

702<h2 id="related-resources">705<h2 id="related-resources">

703 Recursos relacionados706 Recursos relacionados

Details

128| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportación en milisegundos (predeterminado: 60000) | `5000`, `60000` |128| `OTEL_METRIC_EXPORT_INTERVAL` | Intervalo de exportación en milisegundos (predeterminado: 60000) | `5000`, `60000` |

129| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportación de registros en milisegundos (predeterminado: 5000) | `1000`, `10000` |129| `OTEL_LOGS_EXPORT_INTERVAL` | Intervalo de exportación de registros en milisegundos (predeterminado: 5000) | `1000`, `10000` |

130| `OTEL_LOG_USER_PROMPTS` | Habilitar el registro del contenido del mensaje del usuario (predeterminado: deshabilitado) | `1` para habilitar |130| `OTEL_LOG_USER_PROMPTS` | Habilitar el registro del contenido del mensaje del usuario (predeterminado: deshabilitado) | `1` para habilitar |

131| `OTEL_LOG_ASSISTANT_RESPONSES` | Habilitar el registro del texto de respuesta del asistente en eventos `assistant_response` (predeterminado: deshabilitado). Cuando no está establecido, recurre al valor de `OTEL_LOG_USER_PROMPTS`. Requiere Claude Code v2.1.193 o posterior | `1` para habilitar, `0` para mantener redactado |131| `OTEL_LOG_ASSISTANT_RESPONSES` | Habilitar el registro del texto de respuesta del asistente en eventos `assistant_response` (predeterminado: deshabilitado). Cuando no está establecido, recurre al valor de `OTEL_LOG_USER_PROMPTS` | `1` para habilitar, `0` para mantener redactado |

132| `OTEL_LOG_TOOL_DETAILS` | Habilitar el registro de parámetros de herramientas y argumentos de entrada en eventos de herramientas y atributos de tramo: comandos Bash, nombres de servidores MCP y herramientas, nombres de skills, nombres de flujos de trabajo creados por el usuario y entrada de herramientas. También habilita nombres de comandos personalizados, de plugins y MCP en eventos `user_prompt`, y nombres reales de agentes, skills, plugins y servidores y herramientas MCP en los [contadores de costo y tokens](#cost-counter) (predeterminado: deshabilitado). Para los servidores integrados de Claude Desktop, en sesiones que Claude Desktop posee, `mcp_server_name`/`mcp_tool_name` se emiten en `tool_decision`/`tool_result` incluso con la bandera desactivada. La excepción requiere Claude Code v2.1.214 o posterior | `1` para habilitar |132| `OTEL_LOG_TOOL_DETAILS` | Habilitar el registro de parámetros de herramientas y argumentos de entrada en eventos de herramientas y atributos de tramo: comandos Bash, nombres de servidores MCP y herramientas, nombres de skills, nombres de flujos de trabajo creados por el usuario y entrada de herramientas. También habilita nombres de comandos personalizados, de plugins y MCP en eventos `user_prompt`, y nombres reales de agentes, skills, plugins y servidores y herramientas MCP en los [contadores de costo y tokens](#cost-counter) (predeterminado: deshabilitado). Para los servidores integrados de Claude Desktop, en sesiones que Claude Desktop posee, `mcp_server_name`/`mcp_tool_name` se emiten en `tool_decision`/`tool_result` incluso con la bandera desactivada. La excepción requiere Claude Code v2.1.214 o posterior | `1` para habilitar |

133| `OTEL_LOG_TOOL_CONTENT` | Habilitar el registro del contenido de la herramienta en el [evento de tramo `tool.output`](#tool-output-span-event) (predeterminado: deshabilitado). Los atributos de tramo llevan contenido de herramientas bajo [sus propias compuertas](#new-context-gates). Requiere [tracing](#traces-beta). El contenido se trunca en el límite de contenido (60 KB de forma predeterminada) | `1` para habilitar |133| `OTEL_LOG_TOOL_CONTENT` | Habilitar el registro del contenido de la herramienta en el [evento de tramo `tool.output`](#tool-output-span-event) (predeterminado: deshabilitado). Los atributos de tramo llevan contenido de herramientas bajo [sus propias compuertas](#new-context-gates). Requiere [tracing](#traces-beta). El contenido se trunca en el límite de contenido (60 KB de forma predeterminada) | `1` para habilitar |

134| `OTEL_LOG_MANAGED_SETTINGS` | Agregar la configuración administrada redactada y un resumen SHA-256 de la configuración antes de la redacción a eventos [managed settings resolved](#managed-settings-resolved-event) (predeterminado: deshabilitado). Un valor en la configuración del proyecto o local no lo activa. Requiere Claude Code v2.1.274 o posterior | `1` para habilitar |134| `OTEL_LOG_MANAGED_SETTINGS` | Agregar la configuración administrada redactada y un resumen SHA-256 de la configuración antes de la redacción a eventos [managed settings resolved](#managed-settings-resolved-event) (predeterminado: deshabilitado). Un valor en la configuración del proyecto o local no lo activa. Requiere Claude Code v2.1.274 o posterior | `1` para habilitar |


819 Evento de respuesta del asistente819 Evento de respuesta del asistente

820</h4>820</h4>

821 821 

822Se registra después de cada solicitud de API que devuelve contenido de texto del modelo. Solo se incluyen los bloques de texto de la respuesta; los bloques de pensamiento y los bloques de uso de herramientas se excluyen. Requiere Claude Code v2.1.193 o posterior.822Se registra después de cada solicitud de API que devuelve contenido de texto del modelo. Solo se incluyen los bloques de texto de la respuesta; se excluyen los bloques de pensamiento y los de uso de herramientas.

823 823 

824**Nombre del evento**: `claude_code.assistant_response`824**Nombre del evento**: `claude_code.assistant_response`

825 825 


1157* `plugin_id_hash`: hash determinista del nombre del plugin y mercado, enviado solo a su exportador configurado. Le permite contar los plugins de terceros distintos cargados en su flota sin registrar sus nombres. Para [plugins sincronizados desde claude.ai](/docs/es/plugins/loading#synced-plugins), Claude Code hash el nombre del plugin con el nombre del mercado que claude.ai reporta para el plugin, o con `synced` de lo contrario. Antes de v2.1.246, Claude Code no usaba el nombre del mercado que claude.ai reporta en el hash1157* `plugin_id_hash`: hash determinista del nombre del plugin y mercado, enviado solo a su exportador configurado. Le permite contar los plugins de terceros distintos cargados en su flota sin registrar sus nombres. Para [plugins sincronizados desde claude.ai](/docs/es/plugins/loading#synced-plugins), Claude Code hash el nombre del plugin con el nombre del mercado que claude.ai reporta para el plugin, o con `synced` de lo contrario. Antes de v2.1.246, Claude Code no usaba el nombre del mercado que claude.ai reporta en el hash

1158* `has_hooks`: si el plugin contribuye hooks1158* `has_hooks`: si el plugin contribuye hooks

1159* `has_mcp`: si el plugin contribuye servidores MCP1159* `has_mcp`: si el plugin contribuye servidores MCP

1160* `host_owned_mcp`: `true` cuando el host del SDK gestiona las conexiones MCP de este plugin y Claude Code omitió leer la configuración del servidor MCP del plugin, `false` de lo contrario. Requiere Claude Code v2.1.172 o posterior1160* `host_owned_mcp`: `true` cuando el host del SDK administra las conexiones MCP de este plugin y Claude Code omitió leer la configuración del servidor MCP del plugin; `false` en otros casos

1161* `skill_path_count`: número de directorios de habilidades que declara el plugin1161* `skill_path_count`: número de directorios de habilidades que declara el plugin

1162* `command_path_count`: número de directorios de comandos que declara el plugin1162* `command_path_count`: número de directorios de comandos que declara el plugin

1163* `agent_path_count`: número de directorios de agentes que declara el plugin1163* `agent_path_count`: número de directorios de agentes que declara el plugin


1336* `pre_tokens`: Conteo de tokens aproximado antes de la compactación1336* `pre_tokens`: Conteo de tokens aproximado antes de la compactación

1337* `post_tokens`: Conteo de tokens aproximado después de la compactación1337* `post_tokens`: Conteo de tokens aproximado después de la compactación

1338* `error`: Mensaje de error cuando la compactación falló1338* `error`: Mensaje de error cuando la compactación falló

1339* `precompute_reuse`: Solo se establece cuando `trigger` es `"manual"`. La compactación automática puede preparar un resumen en el fondo antes de que la ventana de contexto se llene, y este atributo registra si `/compact` reutilizó ese resumen preparado. `"hit"` significa que fue reutilizado; `"miss_custom_instructions"`, `"miss_hook"`, y `"miss_not_ready"` dan la razón por la que se calculó un resumen fresco en su lugar. Requiere Claude Code v2.1.153 o posterior1339* `precompute_reuse`: Solo se define cuando `trigger` es `"manual"`. La compactación automática puede preparar un resumen en segundo plano antes de que se llene la ventana de contexto, y este atributo registra si `/compact` reutilizó ese resumen preparado. `"hit"` significa que se reutilizó; `"miss_custom_instructions"`, `"miss_hook"` y `"miss_not_ready"` indican el motivo por el que, en su lugar, se calculó un resumen nuevo

1340 1340 

1341<h4 id="subagent-completed-event">1341<h4 id="subagent-completed-event">

1342 Evento de subagente completado1342 Evento de subagente completado


1518* Consumo inusual de tokens1518* Consumo inusual de tokens

1519* Alto volumen de sesiones de usuarios específicos1519* Alto volumen de sesiones de usuarios específicos

1520 1520 

1521Todas las métricas pueden segmentarse por los [atributos estándar](#standard-attributes). El atributo `model` está disponible en `claude_code.token.usage`, `claude_code.cost.usage`, y a partir de v2.1.172, `claude_code.lines_of_code.count`.1521Todas las métricas pueden segmentarse por los [atributos estándar](#standard-attributes). El atributo `model` está disponible en `claude_code.token.usage`, `claude_code.cost.usage` y `claude_code.lines_of_code.count`.

1522 1522 

1523Los desgloses por modelo de confirmaciones solo pueden aproximarse uniéndose contra las métricas de token o costo en `session.id`, ya que una sesión puede abarcar múltiples modelos. Filtre el lado de token o costo a filas donde `query_source` es `"main"` para que las solicitudes auxiliares y de subagente no atribuyan los compromisos de la sesión a un modelo que no los realizó.1523Los desgloses por modelo de confirmaciones solo pueden aproximarse uniéndose contra las métricas de token o costo en `session.id`, ya que una sesión puede abarcar múltiples modelos. Filtre el lado de token o costo a filas donde `query_source` es `"main"` para que las solicitudes auxiliares y de subagente no atribuyan los compromisos de la sesión a un modelo que no los realizó.

1524 1524 

Details

69 Almacén de certificados CA69 Almacén de certificados CA

70</h2>70</h2>

71 71 

72De forma predeterminada, Claude Code confía tanto en sus certificados CA de Mozilla incluidos como en el almacén de certificados de su sistema operativo. La lectura del almacén del sistema operativo requiere un tiempo de ejecución con `tls.getCACertificates`: el instalador nativo siempre lo tiene, y las instalaciones de npm necesitan Node 22.15 o posterior. En versiones anteriores de Node, solo se aplican el conjunto incluido y `NODE_EXTRA_CA_CERTS`. Los proxies de inspección TLS empresariales funcionan sin configuración adicional cuando su certificado raíz se instala en el almacén de confianza del sistema operativo y el tiempo de ejecución puede leerlo.72De forma predeterminada, Claude Code confía tanto en sus certificados CA de Mozilla incluidos como en el almacén de certificados de tu sistema operativo. La lectura del almacén del sistema operativo requiere un tiempo de ejecución con `tls.getCACertificates`: el instalador nativo siempre lo tiene, y las instalaciones de npm necesitan Node 22.15 o posterior. En versiones anteriores de Node, solo se aplican el conjunto incluido y `NODE_EXTRA_CA_CERTS`. Los proxies de inspección TLS empresariales funcionan sin configuración adicional cuando su certificado raíz se instala en el almacén de confianza del sistema operativo y el tiempo de ejecución puede leerlo. Si un proxy de este tipo maneja incorrectamente los cuerpos de solicitud comprimidos con gzip, establece [`CLAUDE_CODE_GZIP_REQUEST_BODIES=0`](/docs/es/env-vars) para desactivar la compresión en las solicitudes a la Claude API, de telemetría y de publicación de artefactos.

73 73 

74`CLAUDE_CODE_CERT_STORE` acepta una lista separada por comas de fuentes. Los valores reconocidos son `bundled` para el conjunto de CA de Mozilla incluido con Claude Code y `system` para el almacén de certificados del sistema operativo. El valor predeterminado es `bundled,system`.74`CLAUDE_CODE_CERT_STORE` acepta una lista separada por comas de fuentes. Los valores reconocidos son `bundled` para el conjunto de CA de Mozilla incluido con Claude Code y `system` para el almacén de certificados del sistema operativo. El valor predeterminado es `bundled,system`.

75 75 

Details

25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Lecturas y herramientas preaprobadas; cualquier cosa que generaría un aviso se deniega | CI bloqueado y scripts |25| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | Lecturas y herramientas preaprobadas; cualquier cosa que generaría un aviso se deniega | CI bloqueado y scripts |

26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Todo | Solo contenedores aislados y máquinas virtuales |26| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | Todo | Solo contenedores aislados y máquinas virtuales |

27 27 

28El modo que revisa cada acción se llama **Manual** en la CLI, en `claude --help`, en las extensiones de VS Code y JetBrains, y en la aplicación de escritorio. Su valor de configuración es `default`, que es lo que usan los hooks e integraciones de SDK. La CLI acepta `manual` como un alias dondequiera que escriba el valor, por ejemplo `claude --permission-mode manual` o `"defaultMode": "manual"`. La etiqueta Manual y el alias `manual` requieren Claude Code v2.1.200 o posterior. La etiqueta de la aplicación de escritorio no depende de su versión de CLI.28El modo que revisa cada acción se llama **Manual** en la CLI, en `claude --help`, en las extensiones de VS Code y JetBrains, y en la aplicación de escritorio. Su valor de configuración es `default`, que es lo que usan los hooks e integraciones de SDK. La CLI acepta `manual` como un alias dondequiera que escribas el valor, por ejemplo `claude --permission-mode manual` o `"defaultMode": "manual"`.

29 29 

30Las escrituras en [rutas protegidas](#protected-paths) nunca se aprueban automáticamente excepto en modo `bypassPermissions` y en sesiones de modo plan donde los permisos de omisión están disponibles, lo que significa sesiones de terminal interactivas iniciadas de una manera que [pone `bypassPermissions` en el ciclo de modo](#switch-permission-modes).30Las escrituras en [rutas protegidas](#protected-paths) nunca se aprueban automáticamente excepto en modo `bypassPermissions` y en sesiones de modo plan donde los permisos de omisión están disponibles, lo que significa sesiones de terminal interactivas iniciadas de una manera que [pone `bypassPermissions` en el ciclo de modo](#switch-permission-modes).

31 31 


359 Lo que el clasificador bloquea de forma predeterminada359 Lo que el clasificador bloquea de forma predeterminada

360</h3>360</h3>

361 361 

362El clasificador confía en tu directorio de trabajo y en los remotos que estaban configurados para él cuando comenzó la sesión. Un remoto agregado o reapuntado durante la sesión con `git remote add` o `git remote set-url` no es de confianza, y todo lo demás se trata como externo hasta que [configures infraestructura de confianza](/docs/es/auto-mode-config). Antes de v2.1.200, los remotos agregados a mitad de sesión también eran de confianza.362El clasificador confía en tu directorio de trabajo y en los remotos que estaban configurados para él cuando comenzó la sesión. Un remoto agregado o reapuntado durante la sesión con `git remote add` o `git remote set-url` no es de confianza, y todo lo demás se trata como externo hasta que [configures infraestructura de confianza](/docs/es/auto-mode-config).

363 363 

364**Bloqueado de forma predeterminada**:364**Bloqueado de forma predeterminada**:

365 365 


392* Lanzar un bucle de agente autónomo que se ejecuta sin aprobación humana ni sandbox, como uno iniciado con `--dangerously-skip-permissions` o `--no-sandbox`. Esto incluye ejecutar un agente de terceros o un arnés de evaluación con el aislamiento y la aprobación por acción deshabilitados, como un ejecutor iniciado con `--yes-always`392* Lanzar un bucle de agente autónomo que se ejecuta sin aprobación humana ni sandbox, como uno iniciado con `--dangerously-skip-permissions` o `--no-sandbox`. Esto incluye ejecutar un agente de terceros o un arnés de evaluación con el aislamiento y la aprobación por acción deshabilitados, como un ejecutor iniciado con `--yes-always`

393* Acciones del navegador de [Claude in Chrome](/docs/es/chrome) que podrían enviar contenido de la página, cookies o credenciales fuera del origen393* Acciones del navegador de [Claude in Chrome](/docs/es/chrome) que podrían enviar contenido de la página, cookies o credenciales fuera del origen

394* Eliminar archivos en `/tmp`, `$TMPDIR` u otro directorio compartido temporal o de caché mediante comodín, glob o filtro de antigüedad, en lugar de mediante una ruta nombrada específica394* Eliminar archivos en `/tmp`, `$TMPDIR` u otro directorio compartido temporal o de caché mediante comodín, glob o filtro de antigüedad, en lugar de mediante una ruta nombrada específica

395* Incluir detalles sensibles en contenido enviado, cargado, publicado o escrito para otras personas o sistemas compartidos, cuando tu propio mensaje no autorizó esos detalles para ese destinatario. Los cuerpos de PR e issues, los mensajes de commit y los comentarios cuentan como este tipo de contenido saliente cuando el repositorio está fuera del límite de confianza o es público, incluidos los repositorios públicos de tu propia organización; las rutas de archivo internas, los nombres en clave, los datos vigentes de respuestas de API, como correos electrónicos o identificadores de cuenta, y los identificadores de infraestructura cuentan como detalles sensibles. La delimitación para PR, issues y mensajes de commit requiere Claude Code v2.1.200 o posterior. Los datos personales vigentes de una respuesta de API en el cuerpo de un PR o issue, como una dirección de correo electrónico, un identificador de cuenta u organización o una métrica de uso, requieren que nombres esos detalles y el destinatario, independientemente de la visibilidad del repositorio o del límite de confianza. Esa verificación requiere Claude Code v2.1.203 o posterior395* Incluir detalles sensibles en contenido enviado, cargado, publicado o escrito para otras personas o sistemas compartidos, cuando tu propio mensaje no autorizó esos detalles para ese destinatario. Los cuerpos de PR e issues, los mensajes de commit y los comentarios cuentan como este tipo de contenido saliente cuando el repositorio está fuera del límite de confianza o es público, incluidos los repositorios públicos de tu propia organización; las rutas de archivo internas, los nombres en clave, los datos vigentes de respuestas de API, como correos electrónicos o identificadores de cuenta, y los identificadores de infraestructura cuentan como detalles sensibles. Los datos personales vigentes de una respuesta de API en el cuerpo de un PR o issue, como una dirección de correo electrónico, un identificador de cuenta u organización o una métrica de uso, requieren que nombres esos detalles y el destinatario, independientemente de la visibilidad del repositorio o del límite de confianza. Esa verificación requiere Claude Code v2.1.203 o posterior

396* Enviar pulsaciones de teclas al propio panel de tmux de Claude Code para controlar su propia interfaz, lo que el clasificador trata como si Claude cambiara sus propios permisos o su supervisión396* Enviar pulsaciones de teclas al propio panel de tmux de Claude Code para controlar su propia interfaz, lo que el clasificador trata como si Claude cambiara sus propios permisos o su supervisión

397 

398Varias de estas categorías dependen de entradas del [entorno](/docs/es/auto-mode-config#define-trusted-infrastructure), como los destinos remotos sensibles y los alcances de IaC protegidos, que puedes restringir a nombres concretos.

399 

400Claude Code v2.1.200 y posterior también bloquean lo siguiente de forma predeterminada:

401 

402* Comentar, eliminar o forzar el éxito de una prueba o aserción que protege un comportamiento de seguridad, como autenticación, control de acceso, validación de entradas o sandboxing397* Comentar, eliminar o forzar el éxito de una prueba o aserción que protege un comportamiento de seguridad, como autenticación, control de acceso, validación de entradas o sandboxing

403* Eliminar o desmantelar un recurso con estado que Claude no creó en la sesión, cuando no se aplica ninguna regla de eliminación más específica y no nombraste ese recurso398* Eliminar o desmantelar un recurso con estado que Claude no creó en la sesión, cuando no se aplica ninguna regla de eliminación más específica y no nombraste ese recurso

404* Reapuntar una URL base de API, un endpoint de proxy, un receptor de webhooks o un mirror de registro a un host de terceros que no corresponde a la tarea, incluso en archivos de ejemplo como `.env.example`399* Reapuntar una URL base de API, un endpoint de proxy, un receptor de webhooks o un mirror de registro a un host de terceros que no corresponde a la tarea, incluso en archivos de ejemplo como `.env.example`


406* Hacer push de secretos o de datos personales o confiados a un repositorio que se sabe que es público, o hacer push allí de material confidencial que no forma parte del trabajo propio de ese repositorio. El tema propio de un repositorio de dotfiles es la única excepción para los datos personales o confiados, y el contenido de un repositorio privado que llega a cualquier superficie pública se bloquea de la misma manera; ambos refinamientos requieren Claude Code v2.1.203 o posterior. Antes de v2.1.203, los datos personales se agrupaban con el material confidencial y se bloqueaban solo cuando no formaban parte del trabajo propio de ese repositorio. Cuando no se ha establecido la visibilidad de un repositorio, el clasificador no bloquea solo por eso; en su lugar, juzga el contenido según las demás reglas401* Hacer push de secretos o de datos personales o confiados a un repositorio que se sabe que es público, o hacer push allí de material confidencial que no forma parte del trabajo propio de ese repositorio. El tema propio de un repositorio de dotfiles es la única excepción para los datos personales o confiados, y el contenido de un repositorio privado que llega a cualquier superficie pública se bloquea de la misma manera; ambos refinamientos requieren Claude Code v2.1.203 o posterior. Antes de v2.1.203, los datos personales se agrupaban con el material confidencial y se bloqueaban solo cuando no formaban parte del trabajo propio de ese repositorio. Cuando no se ha establecido la visibilidad de un repositorio, el clasificador no bloquea solo por eso; en su lugar, juzga el contenido según las demás reglas

407* Abrir un pull request contra un repositorio u organización diferente, hacer un fork con `gh repo fork` o hacer push a un repositorio de terceros, a menos que hayas nombrado ese destino externo402* Abrir un pull request contra un repositorio u organización diferente, hacer un fork con `gh repo fork` o hacer push a un repositorio de terceros, a menos que hayas nombrado ese destino externo

408 403 

404Varias de estas categorías dependen de entradas del [entorno](/docs/es/auto-mode-config#define-trusted-infrastructure), como los destinos remotos sensibles y los alcances de IaC protegidos, que puedes restringir a nombres concretos.

405 

409Claude Code v2.1.203 y posterior también bloquean lo siguiente de forma predeterminada:406Claude Code v2.1.203 y posterior también bloquean lo siguiente de forma predeterminada:

410 407 

411* Contenido de un almacén local sensible, o de un archivo cuyo nombre, ruta o tipo lo marca como sensible, que entre en un commit, un push, el texto de un PR o issue, un gist o paste, o la publicación de un paquete, a menos que hayas nombrado tanto el origen como el destino. Cuentan las transcripciones de sesión y los registros de conversación, las carpetas ocultas de credenciales y configuración, como claves SSH, credenciales de la nube, perfiles de navegador e historial del shell, y las exportaciones de datos de usuarios, y que el repositorio sea privado no lo exime408* Contenido de un almacén local sensible, o de un archivo cuyo nombre, ruta o tipo lo marca como sensible, que entre en un commit, un push, el texto de un PR o issue, un gist o paste, o la publicación de un paquete, a menos que hayas nombrado tanto el origen como el destino. Cuentan las transcripciones de sesión y los registros de conversación, las carpetas ocultas de credenciales y configuración, como claves SSH, credenciales de la nube, perfiles de navegador e historial del shell, y las exportaciones de datos de usuarios, y que el repositorio sea privado no lo exime


676* `.devcontainer`673* `.devcontainer`

677* `.yarn`674* `.yarn`

678* `.mvn`675* `.mvn`

679* `.claude`, excepto por `.claude/worktrees` donde Claude almacena sus propios git worktrees, y excepto por los archivos markdown en el directorio de [memoria automática](/docs/es/memory#storage-location) propio de Claude en una sesión iniciada sin `--restricted`676* `.claude`, con algunas excepciones, como:

677 * Los propios git worktrees de Claude en `.claude/worktrees/`

678 * Los propios archivos de plan de la sesión actual en `~/.claude/plans/`, o en el [`plansDirectory`](/docs/es/settings-reference#plansdirectory) que configures

679 * El directorio temporal propio de una [sesión en segundo plano](/docs/es/agent-view#where-state-is-stored) en `~/.claude/jobs/<id>/tmp/`

680 * Los archivos markdown en el directorio de [memoria automática](/docs/es/memory#storage-location) del proyecto, como `~/.claude/projects/<project>/memory/`, en una sesión iniciada sin `--restricted`

681 * Los archivos markdown en un directorio de [memoria de subagente](/docs/es/sub-agents#enable-persistent-memory), como `.claude/agent-memory/`, en una sesión iniciada sin `--restricted`

680* Un directorio que cargó con [`--plugin-dir`](/docs/es/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarga y ejecuta el código de un mod desde él cuando un archivo cambia682* Un directorio que cargó con [`--plugin-dir`](/docs/es/plugins/mods/create#change-a-mod-with-claude), porque Claude Code recarga y ejecuta el código de un mod desde él cuando un archivo cambia

681 683 

682Archivos protegidos:684Archivos protegidos:

permissions.md +2 −2

Details

87 87 

88| Modo | Descripción |88| Modo | Descripción |

89| :- | :- |89| :- | :- |

90| `default` | Solicita permiso en el primer uso de cada herramienta. Etiquetado como Manual en la CLI, en las extensiones de VS Code y JetBrains, y en la aplicación de escritorio, y Claude Code acepta `manual` como un alias. La etiqueta y el alias requieren Claude Code v2.1.200 o posterior. La etiqueta de la aplicación de escritorio no depende de su versión de CLI |90| `default` | Solicita permiso en el primer uso de cada herramienta. Etiquetado como Manual en la CLI, en las extensiones de VS Code y JetBrains, y en la aplicación de escritorio, y Claude Code acepta `manual` como un alias |

91| `acceptEdits` | Acepta automáticamente ediciones de archivos y comandos comunes del sistema de archivos como `mkdir`, `touch`, `mv` y `cp` para rutas en el directorio de trabajo o `additionalDirectories` |91| `acceptEdits` | Acepta automáticamente ediciones de archivos y comandos comunes del sistema de archivos como `mkdir`, `touch`, `mv` y `cp` para rutas en el directorio de trabajo o `additionalDirectories` |

92| `plan` | Claude lee archivos y ejecuta comandos de shell de solo lectura para explorar pero no edita sus archivos de origen; con [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) disponible, los comandos aprobados por clasificador también se ejecutan. Etiquetado como Plan en la CLI y en la extensión de VS Code |92| `plan` | Claude lee archivos y ejecuta comandos de shell de solo lectura para explorar pero no edita sus archivos de origen; con [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) disponible, los comandos aprobados por clasificador también se ejecutan. Etiquetado como Plan en la CLI y en la extensión de VS Code |

93| `auto` | Se ejecuta sin avisos rutinarios; antes de que se ejecuten acciones como comandos de shell y solicitudes de red, un [clasificador](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) en segundo plano verifica que se alineen con su solicitud |93| `auto` | Se ejecuta sin avisos rutinarios; antes de que se ejecuten acciones como comandos de shell y solicitudes de red, un [clasificador](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) en segundo plano verifica que se alineen con su solicitud |


773 La excepción del directorio de configuración omite solo el paso de confianza. `~/.claude/settings.local.json` sigue siendo [alcance local](/docs/es/settings#compare-the-scope-of-each-settings-file), por lo que Claude Code lo lee solo en sesiones que inicia en su directorio de inicio mismo, no en cada proyecto. Para aplicar reglas de permiso en todos sus proyectos, agréguelas a su configuración de usuario en su lugar: `~/.claude/settings.json`, o `$CLAUDE_CONFIG_DIR/settings.json` cuando `CLAUDE_CONFIG_DIR` está establecido.773 La excepción del directorio de configuración omite solo el paso de confianza. `~/.claude/settings.local.json` sigue siendo [alcance local](/docs/es/settings#compare-the-scope-of-each-settings-file), por lo que Claude Code lo lee solo en sesiones que inicia en su directorio de inicio mismo, no en cada proyecto. Para aplicar reglas de permiso en todos sus proyectos, agréguelas a su configuración de usuario en su lugar: `~/.claude/settings.json`, o `$CLAUDE_CONFIG_DIR/settings.json` cuando `CLAUDE_CONFIG_DIR` está establecido.

774</Note>774</Note>

775 775 

776En las versiones 2.1.196 a 2.1.199, Claude Code mantenía las reglas del archivo en su directorio de configuración personal y fuera de repositorios de git también, e imprimía la advertencia [`this workspace has not been trusted`](/docs/es/errors#workspace-has-not-been-trusted) allí. Antes de v2.1.207, Claude Code aplicaba las reglas de un archivo sin rastrear antes de que aceptara el diálogo.776Antes de v2.1.207, Claude Code aplicaba las reglas de un archivo sin rastrear antes de que aceptaras el diálogo.

777 777 

778<h3 id="what-runs-before-you-trust-a-folder">778<h3 id="what-runs-before-you-trust-a-folder">

779 Lo que se ejecuta antes de confiar en una carpeta779 Lo que se ejecuta antes de confiar en una carpeta

platforms.md +3 −3

Details

39| [GitHub Actions](/docs/es/github-actions) | Ejecuta Claude en su canalización de CI | Revisiones automáticas de PR, clasificación de problemas, mantenimiento programado |39| [GitHub Actions](/docs/es/github-actions) | Ejecuta Claude en su canalización de CI | Revisiones automáticas de PR, clasificación de problemas, mantenimiento programado |

40| [GitLab CI/CD](/docs/es/gitlab-ci-cd) | Lo mismo que GitHub Actions para GitLab | Automatización impulsada por CI en GitLab |40| [GitLab CI/CD](/docs/es/gitlab-ci-cd) | Lo mismo que GitHub Actions para GitLab | Automatización impulsada por CI en GitLab |

41| [Code Review](/docs/es/code-review) | Revisa automáticamente cada PR | Detectar errores antes de la revisión humana |41| [Code Review](/docs/es/code-review) | Revisa automáticamente cada PR | Detectar errores antes de la revisión humana |

42| [Slack](/docs/es/slack) | Responde a menciones de `@Claude` en sus canales | Convertir informes de errores en solicitudes de extracción desde el chat del equipo |42| [Slack](/docs/es/slack) | Responde a menciones de `@Claude` en tus canales, con tu propia cuenta | Convertir informes de errores en pull requests desde el chat del equipo en los planes Pro y Max |

43| [Claude Tag](https://claude.com/docs/claude-tag) | Ejecuta `@Claude` como la identidad compartida de su organización con acceso configurado por el administrador | Acceso compartido del equipo en planes Team y Enterprise, en lugar de sesiones de Slack por usuario |43| [Claude Tag](https://claude.com/docs/claude-tag) | Ejecuta `@Claude` como la identidad compartida de su organización con acceso configurado por el administrador | Acceso compartido del equipo en planes Team y Enterprise, en lugar de sesiones de Slack por usuario |

44 44 

45Para integraciones no listadas aquí, [servidores MCP](/docs/es/mcp) y [conectores](/docs/es/desktop#connect-external-tools) le permiten conectar casi cualquier cosa: Linear, Notion, Google Drive o sus propias API internas.45Para integraciones no listadas aquí, [servidores MCP](/docs/es/mcp) y [conectores](/docs/es/desktop#connect-external-tools) le permiten conectar casi cualquier cosa: Linear, Notion, Google Drive o sus propias API internas.


55| [Dispatch](/docs/es/desktop#sessions-from-dispatch) | Envíe un mensaje con una tarea desde la aplicación móvil de Claude | Su máquina (Desktop) | [Empareje la aplicación móvil con Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabajo mientras está fuera, configuración mínima |55| [Dispatch](/docs/es/desktop#sessions-from-dispatch) | Envíe un mensaje con una tarea desde la aplicación móvil de Claude | Su máquina (Desktop) | [Empareje la aplicación móvil con Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabajo mientras está fuera, configuración mínima |

56| [Remote Control](/docs/es/remote-control) | Controle una sesión en ejecución desde [claude.ai/code](https://claude.ai/code) o la aplicación móvil de Claude | Su máquina (CLI, Desktop o VS Code) | Ejecute [`claude remote-control` o `/remote-control`](/docs/es/remote-control#start-a-remote-control-session) | Dirigir el trabajo en progreso desde otro dispositivo |56| [Remote Control](/docs/es/remote-control) | Controle una sesión en ejecución desde [claude.ai/code](https://claude.ai/code) o la aplicación móvil de Claude | Su máquina (CLI, Desktop o VS Code) | Ejecute [`claude remote-control` o `/remote-control`](/docs/es/remote-control#start-a-remote-control-session) | Dirigir el trabajo en progreso desde otro dispositivo |

57| [Channels](/docs/es/channels) | Envíe eventos desde una aplicación de chat como Telegram o Discord, o su propio servidor | Su máquina (CLI) | [Instale un plugin de canal](/docs/es/channels#quickstart) o [cree el suyo propio](/docs/es/channels-reference) | Reaccionar a eventos externos como fallos de CI o mensajes de chat |57| [Channels](/docs/es/channels) | Envíe eventos desde una aplicación de chat como Telegram o Discord, o su propio servidor | Su máquina (CLI) | [Instale un plugin de canal](/docs/es/channels#quickstart) o [cree el suyo propio](/docs/es/channels-reference) | Reaccionar a eventos externos como fallos de CI o mensajes de chat |

58| [Slack](/docs/es/slack) | Mencione `@Claude` en un canal de equipo | Nube de Anthropic | [Instale la aplicación de Slack](/docs/es/slack#setting-up-claude-code-in-slack) con [Claude Code en la web](/docs/es/claude-code-on-the-web) habilitado | PRs y revisiones desde el chat del equipo |58| [Slack](/docs/es/slack) | Menciona `@Claude` en un canal de equipo | Nube de Anthropic | [Instala la aplicación de Slack](/docs/es/slack#setting-up-claude-code-in-slack) con [Claude Code en la web](/docs/es/claude-code-on-the-web) habilitado, en planes Pro y Max | PRs y revisiones desde el chat del equipo |

59| [Entornos autohospedados](/docs/es/self-hosted-environments) | Inicie una [sesión en la nube](/docs/es/claude-code-on-the-web) y seleccione el entorno de su organización | La infraestructura de su organización | [Implemente ejecutores](/docs/es/self-hosted-environments-quickstart), en planes Team y Enterprise | Sesiones en la nube que deben ejecutarse dentro de su red |59| [Entornos autohospedados](/docs/es/self-hosted-environments) | Inicie una [sesión en la nube](/docs/es/claude-code-on-the-web) y seleccione el entorno de su organización | La infraestructura de su organización | [Implemente ejecutores](/docs/es/self-hosted-environments-quickstart), en planes Team y Enterprise | Sesiones en la nube que deben ejecutarse dentro de su red |

60| [Tareas programadas](/docs/es/scheduled-tasks) | Establezca una programación | [CLI](/docs/es/scheduled-tasks), [Desktop](/docs/es/desktop-scheduled-tasks), o [nube](/docs/es/routines) | Seleccione una frecuencia | Automatización recurrente como revisiones diarias |60| [Tareas programadas](/docs/es/scheduled-tasks) | Establezca una programación | [CLI](/docs/es/scheduled-tasks), [Desktop](/docs/es/desktop-scheduled-tasks), o [nube](/docs/es/routines) | Seleccione una frecuencia | Automatización recurrente como revisiones diarias |

61 61 


86* [GitHub Actions](/docs/es/github-actions): ejecute Claude en su canalización de CI86* [GitHub Actions](/docs/es/github-actions): ejecute Claude en su canalización de CI

87* [GitLab CI/CD](/docs/es/gitlab-ci-cd): lo mismo para GitLab87* [GitLab CI/CD](/docs/es/gitlab-ci-cd): lo mismo para GitLab

88* [Code Review](/docs/es/code-review): revisión automática en cada solicitud de extracción88* [Code Review](/docs/es/code-review): revisión automática en cada solicitud de extracción

89* [Slack](/docs/es/slack): envíe tareas desde el chat del equipo, obtenga PR de vuelta89* [Slack](/docs/es/slack): envía tareas desde el chat del equipo y recibe PR de vuelta, en los planes Pro y Max

90* [Claude Tag](https://claude.com/docs/claude-tag): ejecute `@Claude` como la identidad compartida de su organización en planes Team y Enterprise90* [Claude Tag](https://claude.com/docs/claude-tag): ejecute `@Claude` como la identidad compartida de su organización en planes Team y Enterprise

91 91 

92<h3 id="remote-access">92<h3 id="remote-access">

Details

72 La última oración del resumen le dice si el plugin es utilizable en esta sesión aún:72 La última oración del resumen le dice si el plugin es utilizable en esta sesión aún:

73 73 

74 * **Active now**: `Plugin is now active.` No se necesita recarga.74 * **Active now**: `Plugin is now active.` No se necesita recarga.

75 * **Active, but a server needs setup**: `Plugin is now active.` va seguido de `Its bundled MCP server needs configuration before it can start`. El [servidor MCP empaquetado](/docs/es/plugins/components#include-a-packaged-mcpb-server) del plugin no puede iniciarse hasta que establezca sus opciones. Seleccione el plugin en la pestaña **Installed** en `/plugin` y elija **Configure** para establecer las opciones del servidor.75 * **Active, but a server needs setup**: `Plugin is now active.` va seguido de `Its bundled MCP server needs configuration before it can start`. El [servidor MCP empaquetado](/docs/es/plugins/components#include-a-packaged-mcpb-server) del plugin no puede iniciarse hasta que establezcas sus opciones. Selecciona el plugin en la pestaña **Installed** de `/plugin` y elige **Configure** para establecer las opciones del servidor.

76 * **Reload needed**: `Run /reload-plugins to activate.` El panel se cierra y Claude Code ejecuta esa recarga por usted. Si la recarga [invalidaría el prompt cache](/docs/es/prompt-caching#enabling-or-disabling-a-plugin), advierte y deja el plugin pendiente en su lugar. Ejecute `/reload-plugins --force` para activarlo de todas formas, lo que cuesta una solicitud sin caché.76 * **Reload needed**: `Run /reload-plugins to apply.` El panel se cierra y Claude Code ejecuta esa recarga por ti. Si la recarga [invalidara la caché de prompts](/docs/es/prompt-caching#enabling-or-disabling-a-plugin), muestra una advertencia y deja el plugin pendiente en su lugar. Ejecuta `/reload-plugins --force` para activarlo de todas formas, lo que cuesta una solicitud sin caché.

77 * **Load failed**: `The plugin couldn't be loaded`. Abra la pestaña **Errors** en `/plugin` para la razón, luego consulte [After install: plugin not working](/docs/es/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed**: `The plugin couldn't be loaded`. Abre la pestaña **Errors** de `/plugin` para ver el motivo y luego consulta [Después de instalar: el plugin no funciona](/docs/es/plugins/troubleshooting#plugin-installed-but-not-working).

78 </Step>78 </Step>

79 79 

80 <Step title="Confirme que el plugin funciona">80 <Step title="Confirma que el plugin funciona">

81 Escriba `/` y busque los skills del plugin bajo su nombre, en la forma `/<plugin>:<skill>`. Para `commit-commands`, aparece `/commit-commands:commit`. Otros dos lugares también enumeran el plugin:81 Escribe `/` y busca los skills del plugin bajo su nombre, con la forma `/<plugin>:<skill>`. Para `commit-commands`, aparece `/commit-commands:commit`. Otros dos lugares también enumeran el plugin:

82 82 

83 * Abra la pestaña **Installed** en `/plugin`, que enumera el plugin con su alcance.83 * Abra la pestaña **Installed** en `/plugin`, que enumera el plugin con su alcance.

84 * En su shell, ejecute `claude plugin list`, que imprime la misma lista con líneas `Version`, `Scope` y `Status`.84 * En su shell, ejecute `claude plugin list`, que imprime la misma lista con líneas `Version`, `Scope` y `Status`.

Details

8 8 

9Un [mod](/docs/es/plugins/mods/overview) es un plugin que ejecuta código dentro de Claude Code con los permisos del usuario que lo instaló. Los mods no están en un sandbox. A través de la [configuración administrada](/docs/es/managed-settings), decides si los mods se ejecutan en las máquinas de tus usuarios, cuáles y en qué orden. También puedes instalar un mod propio que observe o rechace lo que hacen otros mods.9Un [mod](/docs/es/plugins/mods/overview) es un plugin que ejecuta código dentro de Claude Code con los permisos del usuario que lo instaló. Los mods no están en un sandbox. A través de la [configuración administrada](/docs/es/managed-settings), decides si los mods se ejecutan en las máquinas de tus usuarios, cuáles y en qué orden. También puedes instalar un mod propio que observe o rechace lo que hacen otros mods.

10 10 

11Esta página es para la persona que implementa la configuración administrada de Claude Code, ya sea como archivo, mediante MDM o desde la consola de administración de claude.ai. Los mods están activados de forma predeterminada en Claude Code v2.1.287 y versiones posteriores. Empieza por la sección que corresponda a lo que viniste a hacer:11Esta página es para la persona que implementa la configuración administrada de Claude Code, ya sea como archivo, mediante MDM o desde la consola de administración de claude.ai. Los mods están activados de forma predeterminada en Claude Code v2.1.286 y versiones posteriores. Empieza por la sección que corresponda a lo que viniste a hacer:

12 12 

13* **Mantener fuera los mods propios de los usuarios, con o sin mods tuyos**: [Evita que se carguen los mods instalados por los usuarios](#stop-user-installed-mods-from-loading)13* **Mantener fuera los mods propios de los usuarios, con o sin mods tuyos**: [Evita que se carguen los mods instalados por los usuarios](#stop-user-installed-mods-from-loading)

14* **Ver lo que obtienen tus usuarios si no cambias nada**: [Conoce lo que sucede de forma predeterminada](#know-what-happens-by-default)14* **Ver lo que obtienen tus usuarios si no cambias nada**: [Conoce lo que sucede de forma predeterminada](#know-what-happens-by-default)

Details

14Si aún no has decidido si un mod es la herramienta adecuada, lee primero la [comparación en la descripción general](/docs/es/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers).14Si aún no has decidido si un mod es la herramienta adecuada, lee primero la [comparación en la descripción general](/docs/es/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers).

15 15 

16<Note>16<Note>

17 Los mods requieren Claude Code v2.1.287 o posterior. En tu shell, ejecuta `claude --version` para comprobarlo. Para ver si los mods pueden cargarse en tu caso, consulta [Comprobar si los mods pueden cargarse](/docs/es/plugins/mods/troubleshoot#check-whether-mods-can-load).17 Usa Claude Code v2.1.287 o posterior. En tu shell, ejecuta `claude --version` para comprobarlo. Para ver si los mods pueden cargarse en tu caso, consulta [Comprobar si los mods pueden cargarse](/docs/es/plugins/mods/troubleshoot#check-whether-mods-can-load).

18</Note>18</Note>

19 19 

20<h2 id="ask-claude-for-a-mod">20<h2 id="ask-claude-for-a-mod">

Details

110 Activar o desactivar los mods110 Activar o desactivar los mods

111</h2>111</h2>

112 112 

113Los mods requieren Claude Code v2.1.287 o posterior, y están activados de forma predeterminada. En tu shell, ejecuta `claude --version` para comprobarlo y actualiza Claude Code si tu versión es anterior.113Los mods están activados de forma predeterminada. En la terminal, usa Claude Code v2.1.287 o posterior. La app de escritorio incluye su propia copia de Claude Code, y los mods funcionan ahí a partir de v2.1.286. Comprueba la versión en el lugar donde usas los mods:

114 

115* **Terminal**: en tu shell, ejecuta `claude --version`. Si tu versión es anterior, [actualiza Claude Code](/docs/es/setup#update-claude-code).

116* **App de escritorio**: en una sesión local en la pestaña Code, escribe `/status` y lee la fila **Claude Code**, que muestra una versión como `2.1.286`. Si tu versión es anterior, actualiza la app de escritorio.

114 117 

115Para desactivar los mods, elige cuántos detener y durante cuánto tiempo. Para volver a activarlos, deshaz el mismo cambio:118Para desactivar los mods, elige cuántos detener y durante cuánto tiempo. Para volver a activarlos, deshaz el mismo cambio:

116 119 

Details

40 40 

41No aparece nada de lo que agrega el mod: ningún comando, ningún dibujo y ningún cambio de comportamiento.41No aparece nada de lo que agrega el mod: ningún comando, ningún dibujo y ningún cambio de comportamiento.

42 42 

43<h3 id="your-version-is-older-than-2-1-287">43<h3 id="your-version-is-too-old">

44 Tu versión es anterior a 2.1.28744 Tu versión es demasiado antigua

45</h3>45</h3>

46 46 

47`claude --version` muestra una versión anterior a 2.1.287. Tu versión es anterior a que los mods estuvieran activados de forma predeterminada.47Consulta [qué versión usar y cómo comprobar la tuya](/docs/es/plugins/mods/overview#turn-mods-on-or-off).

48 

49[Actualiza Claude Code](/docs/es/setup#update-claude-code).

50 48 

51<h3 id="the-mods-active-line-doesn’t-name-the-mod">49<h3 id="the-mods-active-line-doesn’t-name-the-mod">

52 La línea `mods active` no nombra el mod50 La línea `mods active` no nombra el mod

Details

695* **Un plugin que alguien más publicó**: abra **Installed** en `/plugin` y abra el panel de detalles del plugin, que enumera lo que contiene el plugin. Un plugin que no enumera skills allí no tiene ninguno para ofrecer cuando escribe `/`695* **Un plugin que alguien más publicó**: abra **Installed** en `/plugin` y abra el panel de detalles del plugin, que enumera lo que contiene el plugin. Un plugin que no enumera skills allí no tiene ninguno para ofrecer cuando escribe `/`

696 696 

697<h3 id="run-reload-plugins-to-activate">697<h3 id="run-reload-plugins-to-activate">

698 `Run /reload-plugins to activate.`698 `Run /reload-plugins to apply.`

699</h3>699</h3>

700 700 

701El resumen de instalación en `/plugin` terminó con `Run /reload-plugins to activate.` en lugar de `Plugin is now active.`701El resumen de instalación en `/plugin` terminó con `Run /reload-plugins to apply.` en lugar de `Plugin is now active.` Al mismo tiempo, puede aparecer un aviso `Plugins changed. Run /reload-plugins to activate.` encima del prompt.

702 702 

703Claude Code no activó el plugin durante la instalación, ya sea porque activarlo [invalidaría la caché de prompt](/docs/es/prompt-caching#enabling-or-disabling-a-plugin) o porque el intento de activación falló.703Claude Code no activó el plugin durante la instalación, ya sea porque activarlo [invalidaría la caché de prompt](/docs/es/prompt-caching#enabling-or-disabling-a-plugin) o porque el intento de activación falló.

704 704 

Details

258 258 

259Sus archivos CLAUDE.md a nivel de raíz del proyecto y a nivel de usuario se leen una vez al inicio de la sesión y se mantienen en memoria. Editarlos durante la sesión no invalida la caché, pero la edición tampoco se aplica. Claude continúa trabajando con la versión que se cargó al inicio de la sesión. El nuevo contenido se carga en el próximo `/clear`, `/compact` o reinicio.259Sus archivos CLAUDE.md a nivel de raíz del proyecto y a nivel de usuario se leen una vez al inicio de la sesión y se mantienen en memoria. Editarlos durante la sesión no invalida la caché, pero la edición tampoco se aplica. Claude continúa trabajando con la versión que se cargó al inicio de la sesión. El nuevo contenido se carga en el próximo `/clear`, `/compact` o reinicio.

260 260 

261[Los archivos CLAUDE.md anidados en subdirectorios](/docs/es/memory) y [las reglas con frontmatter `paths:`](/docs/es/memory#path-specific-rules) se cargan más tarde, cuando Claude lee por primera vez un archivo coincidente. Editar uno antes de que se cargue sí tiene efecto. Después de que se carga, el contenido es parte del historial de conversación, por lo que una edición durante la sesión no lo cambia retroactivamente.261[Los archivos CLAUDE.md anidados en subdirectorios](/docs/es/memory) y [las reglas con frontmatter `paths:`](/docs/es/memory#path-specific-rules) se cargan más tarde, bajo demanda. Editar uno tú mismo antes de que se cargue sí tiene efecto. Después de que se carga, el contenido es parte del historial de conversación, por lo que una edición durante la sesión no lo cambia retroactivamente.

262 262 

263<h3 id="changing-permission-mode">263<h3 id="changing-permission-mode">

264 Cambiar modo de permisos264 Cambiar modo de permisos

prompt-library.md +11 −11

Details

1181 title: "Convertir una reunión en tickets",1181 title: "Convertir una reunión en tickets",

1182 teaches: "Sáltate el paso de transcripción. Claude extrae las tareas pendientes de la entrada no estructurada y las escribe directamente en tu gestor mediante [MCP](/docs/es/mcp), así revisas los tickets, no la transcripción.",1182 teaches: "Sáltate el paso de transcripción. Claude extrae las tareas pendientes de la entrada no estructurada y las escribe directamente en tu gestor mediante [MCP](/docs/es/mcp), así revisas los tickets, no la transcripción.",

1183 next: "Guarda esto como un skill `/tickets`",1183 next: "Guarda esto como un skill `/tickets`",

1184 prompt: "lee {input} y redacta las tareas pendientes, luego crea un ticket de {tracker} para cada una con criterios de aceptación",1184 prompt: "lee {input} y redacta las tareas pendientes, luego crea un ticket en {tracker} para cada una con criterios de aceptación",

1185 slots: {1185 slots: {

1186 input: "@meeting-notes.md",1186 input: "@meeting-notes.md",

1187 tracker: "Linear"1187 tracker: "nuestro gestor de incidencias"

1188 }1188 }

1189 },1189 },

1190 "map-edge-cases-before": {1190 "map-edge-cases-before": {


1212 next: "Pide a Claude que escriba en `CLAUDE.md` el patrón que siguió para que las sesiones futuras lo respeten sin la referencia",1212 next: "Pide a Claude que escriba en `CLAUDE.md` el patrón que siguió para que las sesiones futuras lo respeten sin la referencia",

1213 prompt: "mira cómo está implementado {example} para entender el patrón y luego crea {new} de la misma manera",1213 prompt: "mira cómo está implementado {example} para entender el patrón y luego crea {new} de la misma manera",

1214 slots: {1214 slots: {

1215 example: "el handler de webhooks de GitHub",1215 example: "el handler de webhooks existente",

1216 new: "un handler de webhooks de Stripe"1216 new: "un handler de webhooks de pagos"

1217 }1217 }

1218 },1218 },

1219 "add-a-small-well": {1219 "add-a-small-well": {


1419 "open-a-pull-request": {1419 "open-a-pull-request": {

1420 title: "Abrir un pull request desde un ticket",1420 title: "Abrir un pull request desde un ticket",

1421 teaches: "Evita cambiar de contexto entre el gestor de tickets, el editor y GitHub. Un solo prompt lee la especificación, hace el cambio y abre el PR.",1421 teaches: "Evita cambiar de contexto entre el gestor de tickets, el editor y GitHub. Un solo prompt lee la especificación, hace el cambio y abre el PR.",

1422 prompt: "encuentra el ticket de {tracker} sobre {topic} y abre un PR que lo implemente",1422 prompt: "encuentra el ticket sobre {topic} en {tracker} y abre un PR que lo implemente",

1423 slots: {1423 slots: {

1424 tracker: "Linear",1424 tracker: "nuestro gestor de incidencias",

1425 topic: "el tiempo de espera del inicio de sesión"1425 topic: "el tiempo de espera del inicio de sesión"

1426 }1426 }

1427 },1427 },


1470 "investigate-a-production-incident": {1470 "investigate-a-production-incident": {

1471 title: "Investigar un incidente de producción",1471 title: "Investigar un incidente de producción",

1472 teaches: "Enumera las fuentes de evidencia que hay que correlacionar, no los pasos a seguir. Claude lee los registros, el historial de git y la configuración en conjunto para acotar la causa.",1472 teaches: "Enumera las fuentes de evidencia que hay que correlacionar, no los pasos a seguir. Claude lee los registros, el historial de git y la configuración en conjunto para acotar la causa.",

1473 next: "Conecta Sentry o tu almacén de registros mediante MCP",1473 next: "Conecta tu rastreador de errores o tu almacén de registros mediante MCP",

1474 prompt: "{symptom}. revisa los registros, los despliegues recientes y los cambios de configuración, y luego dime la causa más probable",1474 prompt: "{symptom}. revisa los registros, los despliegues recientes y los cambios de configuración, y luego dime la causa más probable",

1475 slots: {1475 slots: {

1476 symptom: "el endpoint de checkout empezó a devolver errores 500 hace una hora"1476 symptom: "el endpoint de checkout empezó a devolver errores 500 hace una hora"


1491 teaches: "Las consolas en la nube te muestran el problema, pero no los comandos para corregirlo. Claude lee la captura de pantalla y traduce el panel a los comandos de kubectl, gcloud o aws que debes ejecutar.",1491 teaches: "Las consolas en la nube te muestran el problema, pero no los comandos para corregirlo. Claude lee la captura de pantalla y traduce el panel a los comandos de kubectl, gcloud o aws que debes ejecutar.",

1492 prompt: "esta es una captura de pantalla de {console}. explícame paso a paso por qué {resource} está fallando y dame los comandos exactos para corregirlo",1492 prompt: "esta es una captura de pantalla de {console}. explícame paso a paso por qué {resource} está fallando y dame los comandos exactos para corregirlo",

1493 slots: {1493 slots: {

1494 console: "el panel de Kubernetes de GCP",1494 console: "nuestro panel de Kubernetes",

1495 resource: "este pod"1495 resource: "este pod"

1496 }1496 }

1497 },1497 },


1538 "connect-a-tool-with": {1538 "connect-a-tool-with": {

1539 title: "Conectar una herramienta con MCP",1539 title: "Conectar una herramienta con MCP",

1540 teaches: "Conecta la fuente una vez en lugar de pegar datos en cada sesión. Tras configurar [MCP](/docs/es/mcp), Claude lee directamente de la herramienta cuando le preguntas por ella.",1540 teaches: "Conecta la fuente una vez en lugar de pegar datos en cada sesión. Tras configurar [MCP](/docs/es/mcp), Claude lee directamente de la herramienta cuando le preguntas por ella.",

1541 prompt: "configura el servidor MCP de {server} para que puedas leer mis {data} directamente",1541 prompt: "conecta {server} mediante MCP para que puedas leer sus {data} directamente",

1542 slots: {1542 slots: {

1543 server: "Sentry",1543 server: "nuestro rastreador de errores",

1544 data: "informes de errores"1544 data: "stack traces"

1545 }1545 }

1546 },1546 },

1547 "capture-what-to-remember": {1547 "capture-what-to-remember": {

quickstart.md +8 −8

Details

33 <Tab title="Instalación nativa (recomendado)">33 <Tab title="Instalación nativa (recomendado)">

34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**

35 35 

36 ```bash theme={null}36 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash

38 ```38 ```

39 39 

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

41 41 

42 ```powershell theme={null}42 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} 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}48 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} 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 </Tab>63 </Tab>

64 64 

65 <Tab title="Homebrew">65 <Tab title="Homebrew">

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

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

68 ```68 ```

69 69 


75 </Tab>75 </Tab>

76 76 

77 <Tab title="WinGet">77 <Tab title="WinGet">

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

79 winget install Anthropic.ClaudeCode79 winget install Anthropic.ClaudeCode

80 ```80 ```

81 81 


139 Paso 4: Haga su primera pregunta139 Paso 4: Haga su primera pregunta

140</h2>140</h2>

141 141 

142Comencemos por entender su base de código. Intente uno de estos comandos:142Comienza por entender tu base de código. Prueba uno de estos comandos:

143 143 

144```text wrap theme={null}144```text wrap theme={null}

145¿qué hace este proyecto?145¿qué hace este proyecto?


181 Paso 5: Realice su primer cambio de código181 Paso 5: Realice su primer cambio de código

182</h2>182</h2>

183 183 

184Ahora hagamos que Claude Code haga algo de codificación real. Intente una tarea simple:184Ahora haz que Claude Code escriba código real. Prueba una tarea simple:

185 185 

186```text wrap theme={null}186```text wrap theme={null}

187agrega una función hello world al archivo principal187agrega una función hello world al archivo principal


382* **En Claude Code**: Escriba `/help` o pregunte "¿cómo..."382* **En Claude Code**: Escriba `/help` o pregunte "¿cómo..."

383* **Documentación**: ¡Está aquí! Explore otras guías383* **Documentación**: ¡Está aquí! Explore otras guías

384* **Cursos**: Tome [Claude Code 101](https://academy.claude.com/courses/claude-code-101) y otros cursos gratuitos a su propio ritmo en [Claude Academy](https://academy.claude.com/)384* **Cursos**: Tome [Claude Code 101](https://academy.claude.com/courses/claude-code-101) y otros cursos gratuitos a su propio ritmo en [Claude Academy](https://academy.claude.com/)

385* **Comunidad**: Únase a nuestro [Discord](https://www.anthropic.com/discord) para consejos y soporte385* **Comunidad**: Únete al [servidor de Discord](https://www.anthropic.com/discord) para obtener consejos y soporte

remote-control.md +31 −31

Details

236 236 

237Mientras Remote Control está conectado, la transcripción de la sesión, incluidos sus mensajes, las respuestas de Claude y la actividad de herramientas, se almacena en los servidores de Anthropic. La transcripción almacenada mantiene la conversación sincronizada en todos sus dispositivos y permite que la sesión se reconecte después de una caída de red. La ejecución y el acceso al sistema de archivos permanecen en su máquina, y las transcripciones almacenadas se retienen bajo la política de [Uso de datos](/docs/es/data-usage).237Mientras Remote Control está conectado, la transcripción de la sesión, incluidos sus mensajes, las respuestas de Claude y la actividad de herramientas, se almacena en los servidores de Anthropic. La transcripción almacenada mantiene la conversación sincronizada en todos sus dispositivos y permite que la sesión se reconecte después de una caída de red. La ejecución y el acceso al sistema de archivos permanecen en su máquina, y las transcripciones almacenadas se retienen bajo la política de [Uso de datos](/docs/es/data-usage).

238 238 

239Para desactivar Remote Control completamente, utilice la configuración [`disableRemoteControl`](/docs/es/settings-reference#disableremotecontrol). Las organizaciones con requisitos de cumplimiento como Retención Cero de Datos no pueden habilitar Remote Control.239Para desactivar Remote Control completamente, usa el ajuste [`disableRemoteControl`](/docs/es/settings-reference#disableremotecontrol). Las organizaciones con [Retención Cero de Datos](/docs/es/zero-data-retention) habilitada, o con la [configuración de HIPAA](/docs/es/hipaa-setup) aplicada, no pueden habilitar Remote Control.

240 240 

241<h2 id="trusted-devices">241<h2 id="trusted-devices">

242 Dispositivos de confianza242 Dispositivos de confianza


316| [Dispatch](/docs/es/desktop#sessions-from-dispatch) | Envíe un mensaje con una tarea desde la aplicación móvil de Claude | Su máquina (Desktop) | [Empareje la aplicación móvil con Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabajo mientras está fuera, configuración mínima |316| [Dispatch](/docs/es/desktop#sessions-from-dispatch) | Envíe un mensaje con una tarea desde la aplicación móvil de Claude | Su máquina (Desktop) | [Empareje la aplicación móvil con Desktop](https://support.claude.com/en/articles/13947068) | Delegar trabajo mientras está fuera, configuración mínima |

317| [Remote Control](/docs/es/remote-control) | Controle una sesión en ejecución desde [claude.ai/code](https://claude.ai/code) o la aplicación móvil de Claude | Su máquina (CLI, Desktop o VS Code) | Ejecute [`claude remote-control` o `/remote-control`](/docs/es/remote-control#start-a-remote-control-session) | Dirigir el trabajo en progreso desde otro dispositivo |317| [Remote Control](/docs/es/remote-control) | Controle una sesión en ejecución desde [claude.ai/code](https://claude.ai/code) o la aplicación móvil de Claude | Su máquina (CLI, Desktop o VS Code) | Ejecute [`claude remote-control` o `/remote-control`](/docs/es/remote-control#start-a-remote-control-session) | Dirigir el trabajo en progreso desde otro dispositivo |

318| [Channels](/docs/es/channels) | Envíe eventos desde una aplicación de chat como Telegram o Discord, o su propio servidor | Su máquina (CLI) | [Instale un plugin de canal](/docs/es/channels#quickstart) o [cree el suyo propio](/docs/es/channels-reference) | Reaccionar a eventos externos como fallos de CI o mensajes de chat |318| [Channels](/docs/es/channels) | Envíe eventos desde una aplicación de chat como Telegram o Discord, o su propio servidor | Su máquina (CLI) | [Instale un plugin de canal](/docs/es/channels#quickstart) o [cree el suyo propio](/docs/es/channels-reference) | Reaccionar a eventos externos como fallos de CI o mensajes de chat |

319| [Slack](/docs/es/slack) | Mencione `@Claude` en un canal de equipo | Nube de Anthropic | [Instale la aplicación de Slack](/docs/es/slack#setting-up-claude-code-in-slack) con [Claude Code en la web](/docs/es/claude-code-on-the-web) habilitado | PRs y revisiones desde el chat del equipo |319| [Slack](/docs/es/slack) | Menciona `@Claude` en un canal de equipo | Nube de Anthropic | [Instala la aplicación de Slack](/docs/es/slack#setting-up-claude-code-in-slack) con [Claude Code en la web](/docs/es/claude-code-on-the-web) habilitado, en planes Pro y Max | PRs y revisiones desde el chat del equipo |

320| [Entornos autohospedados](/docs/es/self-hosted-environments) | Inicie una [sesión en la nube](/docs/es/claude-code-on-the-web) y seleccione el entorno de su organización | La infraestructura de su organización | [Implemente ejecutores](/docs/es/self-hosted-environments-quickstart), en planes Team y Enterprise | Sesiones en la nube que deben ejecutarse dentro de su red |320| [Entornos autohospedados](/docs/es/self-hosted-environments) | Inicie una [sesión en la nube](/docs/es/claude-code-on-the-web) y seleccione el entorno de su organización | La infraestructura de su organización | [Implemente ejecutores](/docs/es/self-hosted-environments-quickstart), en planes Team y Enterprise | Sesiones en la nube que deben ejecutarse dentro de su red |

321| [Tareas programadas](/docs/es/scheduled-tasks) | Establezca una programación | [CLI](/docs/es/scheduled-tasks), [Desktop](/docs/es/desktop-scheduled-tasks), o [nube](/docs/es/routines) | Seleccione una frecuencia | Automatización recurrente como revisiones diarias |321| [Tareas programadas](/docs/es/scheduled-tasks) | Establezca una programación | [CLI](/docs/es/scheduled-tasks), [Desktop](/docs/es/desktop-scheduled-tasks), o [nube](/docs/es/routines) | Seleccione una frecuencia | Automatización recurrente como revisiones diarias |

322 322 


387</h2>387</h2>

388 388 

389<h3 id="remote-control-requires-a-claude-ai-subscription">389<h3 id="remote-control-requires-a-claude-ai-subscription">

390 "Remote Control requiere una suscripción a claude.ai"390 "Remote Control requires a claude.ai subscription"

391</h3>391</h3>

392 392 

393No has iniciado sesión con una cuenta de claude.ai, o una credencial diferente tiene precedencia sobre tu inicio de sesión. El mensaje toma una de estas formas:393No has iniciado sesión con una cuenta de claude.ai, o una credencial diferente tiene precedencia sobre tu inicio de sesión. El mensaje toma una de estas formas:

394 394 

395* Sesión cerrada, desde `/remote-control` o `--remote-control`: `Remote Control requiere una suscripción a claude.ai.` o `/remote-control requiere una suscripción a claude.ai.`395* Sesión cerrada, desde `/remote-control` o `--remote-control`: `Remote Control requires a claude.ai subscription.` o `/remote-control requires a claude.ai subscription.`

396* Sesión cerrada, desde `claude remote-control`: `Debes iniciar sesión para usar Remote Control. Remote Control solo está disponible con suscripciones a claude.ai.`396* Sesión cerrada, desde `claude remote-control`: `You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.`

397* Sesión iniciada, pero se está utilizando una clave de API o token: `Remote Control requiere autenticación de suscripción a claude.ai.` seguido de la credencial en uso, como `ANTHROPIC_API_KEY está configurada, por lo que esta sesión está utilizando autenticación de clave de API`. Un ajuste `apiKeyHelper` y `ANTHROPIC_AUTH_TOKEN` se nombran de la misma manera.397* Sesión iniciada, pero se está utilizando una clave de API o token: `Remote Control requires claude.ai subscription auth.` seguido de la credencial en uso, como `ANTHROPIC_API_KEY is set, so this session is using API-key auth`. Un ajuste `apiKeyHelper` y `ANTHROPIC_AUTH_TOKEN` se nombran de la misma manera.

398 398 

399Ejecuta `claude auth login` y elige la opción de claude.ai. Si el mensaje menciona `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, elimínalo dondequiera que esté configurado: tu entorno de shell o el bloque `env` de un [archivo de configuración](/docs/es/settings-reference#env). Si menciona `apiKeyHelper`, elimina ese ajuste.399Ejecuta `claude auth login` y elige la opción de claude.ai. Si el mensaje menciona `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, elimínalo dondequiera que esté configurado: tu entorno de shell o el bloque `env` de un [archivo de configuración](/docs/es/settings-reference#env). Si menciona `apiKeyHelper`, elimina ese ajuste.

400 400 

401<h3 id="remote-control-requires-a-full-scope-login-token">401<h3 id="remote-control-requires-a-full-scope-login-token">

402 "Remote Control requiere un token de inicio de sesión de alcance completo"402 "Remote Control requires a full-scope login token"

403</h3>403</h3>

404 404 

405Estás autenticado con un token de larga duración de `claude setup-token` o la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Estos tokens solo pueden hacer solicitudes de modelo, por lo que no pueden establecer sesiones de Remote Control. Ejecuta `claude auth login` para autenticarte con un token de sesión de alcance completo en su lugar.405Estás autenticado con un token de larga duración de `claude setup-token` o la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Estos tokens solo pueden hacer solicitudes de modelo, por lo que no pueden establecer sesiones de Remote Control. Ejecuta `claude auth login` para autenticarte con un token de sesión de alcance completo en su lugar.

406 406 

407<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">407<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">

408 "No se puede determinar tu organización para la elegibilidad de Remote Control"408 "Unable to determine your organization for Remote Control eligibility"

409</h3>409</h3>

410 410 

411Tu información de cuenta en caché está obsoleta o incompleta. Ejecuta `claude auth login` para actualizarla.411Tu información de cuenta en caché está obsoleta o incompleta. Ejecuta `claude auth login` para actualizarla.

412 412 

413<h3 id="remote-control-isn’t-enabled-for-this-account">413<h3 id="remote-control-isn’t-enabled-for-this-account">

414 "Remote Control no está habilitado para esta cuenta"414 "Remote Control isn't enabled for this account"

415</h3>415</h3>

416 416 

417Claude Code verificó la disponibilidad de Remote Control para la cuenta con la que has iniciado sesión y la verificación resultó desactivada. La causa habitual son los derechos en caché que están desactualizados después de un cambio de plan. Ejecuta `claude auth logout` y luego `claude auth login` para actualizarlos, y actualiza Claude Code si estás en una versión antigua.417Claude Code verificó la disponibilidad de Remote Control para la cuenta con la que has iniciado sesión y la verificación resultó desactivada. La causa habitual son los derechos en caché que están desactualizados después de un cambio de plan. Ejecuta `claude auth logout` y luego `claude auth login` para actualizarlos, y actualiza Claude Code si estás en una versión antigua.

418 418 

419Ejecuta `claude doctor` para ver qué verificación de elegibilidad individual falló. Los conflictos de variables de entorno, las verificaciones inaccesibles y el ajuste de Remote Control de tu organización producen cada uno su propio mensaje, por lo que este error se refiere a la verificación a nivel de cuenta en sí.419Ejecuta `claude doctor` para ver qué verificación de elegibilidad individual falló. Los conflictos de variables de entorno, las verificaciones inaccesibles y el ajuste de Remote Control de tu organización producen cada uno su propio mensaje, por lo que este error se refiere a la verificación a nivel de cuenta en sí.

420 420 

421Antes de v2.1.239, este mensaje decía "Remote Control aún no está habilitado para tu cuenta".421Antes de v2.1.239, este mensaje decía "Remote Control is not yet enabled for your account".

422 422 

423<h3 id="couldn’t-verify-remote-control-eligibility">423<h3 id="couldn’t-verify-remote-control-eligibility">

424 "No se pudo verificar la elegibilidad de Remote Control"424 "Couldn't verify Remote Control eligibility"

425</h3>425</h3>

426 426 

427Claude Code no pudo alcanzar el servicio de indicadores de características para verificar si Remote Control está habilitado para tu cuenta, típicamente porque estás sin conexión o un proxy está bloqueando la solicitud. Reinténtalo una vez que tengas acceso a la red, o ejecuta `claude doctor` para obtener detalles. El mensaje relacionado "No se pudo verificar la política de Remote Control de tu organización" significa que Claude Code encontró un error al leer esa política, y tiene la misma solución.427Claude Code no pudo alcanzar el servicio de indicadores de características para verificar si Remote Control está habilitado para tu cuenta, típicamente porque estás sin conexión o un proxy está bloqueando la solicitud. Reinténtalo una vez que tengas acceso a la red, o ejecuta `claude doctor` para obtener detalles. El mensaje relacionado "Couldn't verify your organization's Remote Control policy" significa que Claude Code encontró un error al leer esa política, y tiene la misma solución.

428 428 

429<h3 id="remote-control-requires-feature-flag-evaluation">429<h3 id="remote-control-requires-feature-flag-evaluation">

430 "Remote Control requiere evaluación de indicadores de características"430 "Remote Control requires feature-flag evaluation"

431</h3>431</h3>

432 432 

433Una [variable de entorno](/docs/es/env-vars#features-that-need-feature-flag-fetching) que desactiva la evaluación de indicadores de características está configurada, y el mensaje completo menciona la variable que Claude Code encontró. En versiones anteriores a 2.1.154, la misma configuración produce "Remote Control aún no está habilitado para tu cuenta" en su lugar. Lo que debes hacer depende de la variable que menciona el mensaje:433Una [variable de entorno](/docs/es/env-vars#features-that-need-feature-flag-fetching) que desactiva la evaluación de indicadores de características está configurada, y el mensaje completo menciona la variable que Claude Code encontró. En versiones anteriores a 2.1.154, la misma configuración produce "Remote Control is not yet enabled for your account" en su lugar. Lo que debes hacer depende de la variable que menciona el mensaje:

434 434 

435* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK`**: desactiva la variable dondequiera que esté configurada, en tu entorno de shell o en el bloque `env` de un [archivo `settings.json`](/docs/es/settings-reference#all-settings).435* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` o `DISABLE_GROWTHBOOK`**: desactiva la variable dondequiera que esté configurada, en tu entorno de shell o en el bloque `env` de un [archivo `settings.json`](/docs/es/settings-reference#all-settings).

436* **`DISABLE_TELEMETRY` o `DO_NOT_TRACK`**: en un plan Pro, Max, Team o Enterprise con `DISABLE_GROWTHBOOK` desactivado, estas variables dejan Remote Control disponible a menos que tu organización requiera [Dispositivos de confianza](#trusted-devices). Si tu organización los requiere, desactiva la variable dondequiera que esté configurada para usar Remote Control. De v2.1.154 a v2.1.282, cualquiera de las variables produjo este mensaje, por lo que actualiza Claude Code a v2.1.283 o posterior.436* **`DISABLE_TELEMETRY` o `DO_NOT_TRACK`**: en un plan Pro, Max, Team o Enterprise con `DISABLE_GROWTHBOOK` desactivado, estas variables dejan Remote Control disponible a menos que tu organización requiera [Dispositivos de confianza](#trusted-devices). Si tu organización los requiere, desactiva la variable dondequiera que esté configurada para usar Remote Control. De v2.1.154 a v2.1.282, cualquiera de las variables produjo este mensaje, por lo que actualiza Claude Code a v2.1.283 o posterior.

437 437 

438<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">438<h3 id="remote-control-is-only-available-when-using-claude-via-api-anthropic-com">

439 "Remote Control solo está disponible cuando se usa Claude a través de api.anthropic.com"439 "Remote Control is only available when using Claude via api.anthropic.com"

440</h3>440</h3>

441 441 

442La sesión no está hablando directamente con la API de Anthropic, que es lo que Remote Control requiere. Esto sucede en Amazon Bedrock, en Agent Platform de Google Cloud y en Microsoft Foundry. También sucede cuando [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) apunta a un host diferente de `api.anthropic.com`, como un [gateway de LLM](/docs/es/llm-gateway) o proxy, incluso si inicias sesión con claude.ai. Consulta la [referencia de errores](/docs/es/errors#remote-control-requires-the-anthropic-api) para obtener la lista completa de causas.442La sesión no está hablando directamente con la API de Anthropic, que es lo que Remote Control requiere. Esto sucede en Amazon Bedrock, en Agent Platform de Google Cloud y en Microsoft Foundry. También sucede cuando [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) apunta a un host diferente de `api.anthropic.com`, como un [gateway de LLM](/docs/es/llm-gateway) o proxy, incluso si inicias sesión con claude.ai. Consulta la [referencia de errores](/docs/es/errors#remote-control-requires-the-anthropic-api) para obtener la lista completa de causas.


444El mensaje menciona lo que enrutó la sesión lejos de la API de Anthropic, como `CLAUDE_CODE_USE_BEDROCK` o un `ANTHROPIC_BASE_URL` personalizado. Si tienes un inicio de sesión de claude.ai elegible, desactiva la variable mencionada, elimínala de la clave `env` en la [configuración](/docs/es/settings) si la configuraste allí, y reinicia la sesión.444El mensaje menciona lo que enrutó la sesión lejos de la API de Anthropic, como `CLAUDE_CODE_USE_BEDROCK` o un `ANTHROPIC_BASE_URL` personalizado. Si tienes un inicio de sesión de claude.ai elegible, desactiva la variable mencionada, elimínala de la clave `env` en la [configuración](/docs/es/settings) si la configuraste allí, y reinicia la sesión.

445 445 

446<h3 id="remote-control-is-disabled-by-your-organizations-policy">446<h3 id="remote-control-is-disabled-by-your-organizations-policy">

447 "Remote Control está deshabilitado por la política de tu organización"447 "Remote Control is disabled by your organization's policy"

448</h3>448</h3>

449 449 

450Una política bloquea Remote Control. Verifica estas causas en orden:450Una política bloquea Remote Control. Verifica estas causas en orden:

451 451 

452* **El error menciona `disableRemoteControl`**: tu administrador de TI ha deshabilitado Remote Control en este dispositivo a través de la [configuración administrada](/docs/es/managed-settings), independientemente del conmutador de toda la organización y de cómo hayas iniciado sesión.452* **El error menciona `disableRemoteControl`**: tu administrador de TI ha deshabilitado Remote Control en este dispositivo a través de la [configuración administrada](/docs/es/managed-settings), independientemente del conmutador de toda la organización y de cómo hayas iniciado sesión.

453* **Tu plan de claude.ai es Pro o Max**: Claude Code aún tiene la sesión iniciada bajo una organización de Team o Enterprise de un inicio de sesión anterior, por lo que verifica la política de Remote Control de esa organización. Ejecuta `/status` para ver qué plan y organización utiliza tu inicio de sesión. Ejecuta `claude auth logout` y luego `claude auth login` para iniciar sesión nuevamente bajo tu plan actual.453* **Tu plan de claude.ai es Pro o Max**: Claude Code aún tiene la sesión iniciada bajo una organización de Team o Enterprise de un inicio de sesión anterior, por lo que verifica la política de Remote Control de esa organización. Ejecuta `/status` para ver qué plan y organización utiliza tu inicio de sesión. Ejecuta `claude auth logout` y luego `claude auth login` para iniciar sesión nuevamente bajo tu plan actual.

454* **El mensaje no dice que contactes al administrador de tu organización**: tu organización tiene una configuración HIPAA que es incompatible con Remote Control, y `/status` enumera `HIPAA` en su fila `Organization configuration`. En este estado, el conmutador de Remote Control del panel de administración está atenuado, por lo que un propietario no puede cambiarlo allí. Ponte en contacto con el soporte de Anthropic para discutir opciones. Antes de v2.1.267, este caso mostraba "Remote Control isn't available for your organization due to its compliance policy" en su lugar.454* **El mensaje no dice que contactes al administrador de tu organización**: tu organización tiene aplicada la [configuración HIPAA](/docs/es/hipaa-setup), que desactiva Remote Control. Para confirmarlo, ejecuta `/status` y busca `HIPAA` en la línea `Organization configuration`. Un propietario ve el conmutador **Remote Control** atenuado en la [configuración de administración](https://claude.ai/admin-settings/claude-code) y no puede activarlo. Si tienes preguntas sobre la configuración, consulta a un propietario, quien puede ponerse en contacto con el equipo de cuenta de Anthropic de tu organización. Antes de v2.1.267, este caso mostraba "Remote Control isn't available for your organization due to its compliance policy" en su lugar.

455* **De lo contrario, un propietario no lo ha habilitado para tu organización**: Remote Control está desactivado de forma predeterminada en planes de Team y Enterprise. Un propietario puede habilitarlo en [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) activando el conmutador **Remote Control**. Este conmutador es un ajuste de organización del lado del servidor.455* **De lo contrario, un propietario no lo ha habilitado para tu organización**: Remote Control está desactivado de forma predeterminada en planes de Team y Enterprise. Un propietario puede habilitarlo en [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) activando el conmutador **Remote Control**. Este conmutador es un ajuste de organización del lado del servidor.

456 456 

457Antes de v2.1.281, este mensaje también aparecía cuando Claude Code no había cargado la política de tu organización en esta máquina, por ejemplo después de iniciar sin conexión. Las versiones posteriores informan ese estado como [`No se pudo verificar la política de tu organización para remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) en su lugar.457Antes de v2.1.281, este mensaje también aparecía cuando Claude Code no había cargado la política de tu organización en esta máquina, por ejemplo después de iniciar sin conexión. Las versiones posteriores informan ese estado como [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) en su lugar.

458 458 

459<h3 id="remote-control-was-turned-off-by-your-organizations-policy">459<h3 id="remote-control-was-turned-off-by-your-organizations-policy">

460 "Remote Control fue desactivado por la política de tu organización"460 "Remote Control was turned off by your organization's policy"

461</h3>461</h3>

462 462 

463La política de tu organización dejó de permitir Remote Control mientras una sesión estaba conectada, por lo que Claude Code la desconectó. Lo que sucede con la sesión depende de cómo iniciaste Remote Control:463La política de tu organización dejó de permitir Remote Control mientras una sesión estaba conectada, por lo que Claude Code la desconectó. Lo que sucede con la sesión depende de cómo iniciaste Remote Control:


467 467 

468Todavía puedes encontrar una sesión archivada [filtrando por sesiones archivadas](/docs/es/claude-code-on-the-web#archive-sessions).468Todavía puedes encontrar una sesión archivada [filtrando por sesiones archivadas](/docs/es/claude-code-on-the-web#archive-sessions).

469 469 

470Remote Control no se reconecta por sí solo. Para volver a activarlo después de que tu organización lo permita de nuevo, ejecuta `/remote-control` en la sesión o `claude remote-control` en tu shell. Cualquiera de los dos comandos falla con [`Remote Control está deshabilitado por la política de tu organización`](#remote-control-is-disabled-by-your-organizations-policy) hasta que Claude Code en esta máquina haya obtenido la política modificada. Una sesión abierta la obtiene aproximadamente una vez por hora. Para averiguar qué está bloqueando Remote Control, compara el texto completo que imprime el comando con esa entrada.470Remote Control no se reconecta por sí solo. Para volver a activarlo después de que tu organización lo permita de nuevo, ejecuta `/remote-control` en la sesión o `claude remote-control` en tu shell. Cualquiera de los dos comandos falla con [`Remote Control is disabled by your organization's policy`](#remote-control-is-disabled-by-your-organizations-policy) hasta que Claude Code en esta máquina haya obtenido la política modificada. Una sesión abierta la obtiene aproximadamente una vez por hora. Para averiguar qué está bloqueando Remote Control, compara el texto completo que imprime el comando con esa entrada.

471 471 

472<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">472<h3 id="couldnt-verify-your-organizations-policy-for-remote-control">

473 "No se pudo verificar la política de tu organización para remote control"473 "Couldn't verify your organization's policy for remote control"

474</h3>474</h3>

475 475 

476Claude Code no pudo obtener la política de tu organización y no tiene una copia guardada en esta máquina para usar en su lugar, por lo que mantiene Remote Control desactivado hasta que pueda confirmar que tu organización lo permite. Esto generalmente sucede cuando inicias Claude Code sin conexión o antes de que se conecte una VPN, o cuando un proxy interfiere con la solicitud. En una conexión lenta también puede aparecer mientras la primera solicitud aún está en curso.476Claude Code no pudo obtener la política de tu organización y no tiene una copia guardada en esta máquina para usar en su lugar, por lo que mantiene Remote Control desactivado hasta que pueda confirmar que tu organización lo permite. Esto generalmente sucede cuando inicias Claude Code sin conexión o antes de que se conecte una VPN, o cuando un proxy interfiere con la solicitud. En una conexión lenta también puede aparecer mientras la primera solicitud aún está en curso.

477 477 

478El mensaje toma una de estas formas:478El mensaje toma una de estas formas:

479 479 

480* Desde `/remote-control`, `claude remote-control`, o `claude --remote-control`: `No se pudo verificar la política de tu organización para remote control. Verifica tu conexión de red e intenta de nuevo.`480* Desde `/remote-control`, `claude remote-control`, o `claude --remote-control`: `Couldn't verify your organization's policy for remote control. Check your network connection and try again.`

481* Desde [conexión automática](#enable-remote-control-for-all-sessions) cuando se inicia una sesión: `no se pudo verificar la política de tu organización — verifica tu conexión de red e intenta de nuevo`, con el prefijo `Remote Control falló` en la notificación y `Remote Control desconectado` en la conversación. La sesión luego deja Remote Control desactivado.481* Desde [conexión automática](#enable-remote-control-for-all-sessions) cuando se inicia una sesión: `couldn't verify your organization's policy — check your network connection and try again`, con el prefijo `Remote Control failed` en la notificación y `Remote Control disconnected` en la conversación. La sesión luego deja Remote Control desactivado.

482 482 

483Restaura tu conexión de red, luego ejecuta `/remote-control` o ejecuta el comando nuevamente. Cada intento verifica la política nuevamente, por lo que no necesitas reiniciar Claude Code. Si el mensaje sigue apareciendo, ejecuta `claude doctor` y lee su línea `Organization policy`, que dice por qué la política no se cargó.483Restaura tu conexión de red, luego ejecuta `/remote-control` o ejecuta el comando nuevamente. Cada intento verifica la política nuevamente, por lo que no necesitas reiniciar Claude Code. Si el mensaje sigue apareciendo, ejecuta `claude doctor` y lee su línea `Organization policy`, que dice por qué la política no se cargó.

484 484 

485Antes de v2.1.281, este estado mostraba `Remote Control está deshabilitado por la política de tu organización` en su lugar.485Antes de v2.1.281, este estado mostraba `Remote Control is disabled by your organization's policy` en su lugar.

486 486 

487<h3 id="remote-credentials-fetch-failed">487<h3 id="remote-credentials-fetch-failed">

488 "Error al obtener credenciales remotas"488 "Remote credentials fetch failed"

489</h3>489</h3>

490 490 

491Claude Code no pudo obtener una credencial de corta duración de la API de Anthropic para establecer la conexión. Vuelve a ejecutar con `--verbose` para ver el error completo:491Claude Code no pudo obtener una credencial de corta duración de la API de Anthropic para establecer la conexión. Vuelve a ejecutar con `--verbose` para ver el error completo:


501* Error en la creación de sesión: si también ves `Session creation failed — see debug log`, el error ocurrió anteriormente en la configuración. Verifica que tu suscripción esté activa.501* Error en la creación de sesión: si también ves `Session creation failed — see debug log`, el error ocurrió anteriormente en la configuración. Verifica que tu suscripción esté activa.

502 502 

503<h3 id="couldnt-reconnect-to-your-remote-control-session">503<h3 id="couldnt-reconnect-to-your-remote-control-session">

504 "No se pudo reconectar a tu sesión de Remote Control"504 "Couldn't reconnect to your Remote Control session"

505</h3>505</h3>

506 506 

507Cuando reanudas una conversación con `claude --resume` o `claude --continue`, Claude Code se reconecta a la sesión de Remote Control registrada en esa conversación. Este mensaje significa que la reconexión falló por una razón que puede ser temporal, como una interrupción de red o un error del servidor, por lo que Claude Code no puede confirmar si la sesión remota aún existe.507Cuando reanudas una conversación con `claude --resume` o `claude --continue`, Claude Code se reconecta a la sesión de Remote Control registrada en esa conversación. Este mensaje significa que la reconexión falló por una razón que puede ser temporal, como una interrupción de red o un error del servidor, por lo que Claude Code no puede confirmar si la sesión remota aún existe.


509Ejecuta `/remote-control` para reintentar la conexión, o inicia una nueva sesión con `claude --remote-control` para crear una nueva sesión de Remote Control. Tu sesión local sigue ejecutándose sin Remote Control mientras tanto.509Ejecuta `/remote-control` para reintentar la conexión, o inicia una nueva sesión con `claude --remote-control` para crear una nueva sesión de Remote Control. Tu sesión local sigue ejecutándose sin Remote Control mientras tanto.

510 510 

511<h3 id="previous-session-is-unavailable">511<h3 id="previous-session-is-unavailable">

512 "La sesión anterior no está disponible — ejecuta /remote-control para iniciar una nueva"512 "Previous session is unavailable — run /remote-control to start a new one"

513</h3>513</h3>

514 514 

515Claude Code no pudo recuperar la sesión anterior de Remote Control y se detuvo en lugar de iniciar una nueva por su cuenta. Puedes ver este mensaje después de reanudar una conversación con `claude --resume` o `claude --continue`, o después de que Claude Code [se reconecte por su cuenta después de una desconexión](/docs/es/errors#remote-control-couldnt-refresh-your-login).515Claude Code no pudo recuperar la sesión anterior de Remote Control y se detuvo en lugar de iniciar una nueva por su cuenta. Puedes ver este mensaje después de reanudar una conversación con `claude --resume` o `claude --continue`, o después de que Claude Code [se reconecte por su cuenta después de una desconexión](/docs/es/errors#remote-control-couldnt-refresh-your-login).

516 516 

517Ejecuta `/remote-control` para iniciar una nueva sesión de Remote Control bajo el inicio de sesión actual; tu sesión local sigue ejecutándose sin Remote Control mientras tanto. El mensaje relacionado `Remote Control no pudo verificar la cuenta con la que has iniciado sesión — ejecuta /remote-control para reconectar` tiene la misma solución. Si ejecutas `/remote-control` después de `La sesión anterior no está disponible` sin reiniciar Claude Code primero, Claude Code deja los mensajes anteriores de la conversación fuera de la nueva sesión.517Ejecuta `/remote-control` para iniciar una nueva sesión de Remote Control bajo el inicio de sesión actual; tu sesión local sigue ejecutándose sin Remote Control mientras tanto. El mensaje relacionado `Remote Control could not verify the signed-in account — run /remote-control to reconnect` tiene la misma solución. Si ejecutas `/remote-control` después de `Previous session is unavailable` sin reiniciar Claude Code primero, Claude Code deja los mensajes anteriores de la conversación fuera de la nueva sesión.

518 518 

519<h3 id="remote-control-got-an-unexpected-server-response">519<h3 id="remote-control-got-an-unexpected-server-response">

520 "Remote Control recibió una respuesta inesperada del servidor"520 "Remote Control got an unexpected server response"

521</h3>521</h3>

522 522 

523El servidor de Remote Control aceptó una solicitud pero respondió de una forma que esta versión de Claude Code no pudo leer, mientras creaba la sesión remota u obtenía sus credenciales. Reintentar en la misma versión falla de la misma manera. Ejecuta `claude update`, luego ejecuta `/remote-control` para reconectar.523El servidor de Remote Control aceptó una solicitud pero respondió de una forma que esta versión de Claude Code no pudo leer, mientras creaba la sesión remota u obtenía sus credenciales. Reintentar en la misma versión falla de la misma manera. Ejecuta `claude update`, luego ejecuta `/remote-control` para reconectar.

524 524 

525<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">525<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

526 "Tu organización requiere Dispositivos de confianza para Remote Control, pero este dispositivo no está inscrito"526 "Your organization requires Trusted Devices for Remote Control, but this device is not enrolled"

527</h3>527</h3>

528 528 

529Tu organización tiene [Dispositivos de confianza](#trusted-devices) habilitados y esta máquina aún no se ha inscrito. Ejecuta `/login` en Claude Code. La inscripción ocurre como parte del inicio de sesión, y no hay un comando de inscripción separado.529Tu organización tiene [Dispositivos de confianza](#trusted-devices) habilitados y esta máquina aún no se ha inscrito. Ejecuta `/login` en Claude Code. La inscripción ocurre como parte del inicio de sesión, y no hay un comando de inscripción separado.

530 530 

531<h3 id="session-expired-for-trusted-device-check">531<h3 id="session-expired-for-trusted-device-check">

532 "sesión expirada para verificación de dispositivo de confianza"532 "session expired for trusted-device check"

533</h3>533</h3>

534 534 

535Tu inicio de sesión tiene más de 18 horas. Ejecuta `/login` en Claude Code, o confirma con Face ID, Touch ID, Windows Hello o una llave de acceso (passkey) cuando claude.ai o la aplicación móvil te lo soliciten. Consulta [Dispositivos de confianza](#trusted-devices).535Tu inicio de sesión tiene más de 18 horas. Ejecuta `/login` en Claude Code, o confirma con Face ID, Touch ID, Windows Hello o una llave de acceso (passkey) cuando claude.ai o la aplicación móvil te lo soliciten. Consulta [Dispositivos de confianza](#trusted-devices).

sandboxing.md +1 −1

Details

1109</h2>1109</h2>

1110 1110 

1111* [Entornos sandbox](/docs/es/sandbox-environments): comparar el sandbox integrado con contenedores de desarrollo, contenedores y máquinas virtuales1111* [Entornos sandbox](/docs/es/sandbox-environments): comparar el sandbox integrado con contenedores de desarrollo, contenedores y máquinas virtuales

1112* [Seguridad](/docs/es/security): características de seguridad integral y mejores prácticas1112* [Seguridad](/docs/es/security): características de seguridad y buenas prácticas

1113* [Permisos](/docs/es/permissions): configuración de permisos y control de acceso1113* [Permisos](/docs/es/permissions): configuración de permisos y control de acceso

1114* [Toda la configuración](/docs/es/settings-reference): cada clave de configuración1114* [Toda la configuración](/docs/es/settings-reference): cada clave de configuración

1115* [Referencia de CLI](/docs/es/cli-reference): opciones de línea de comandos1115* [Referencia de CLI](/docs/es/cli-reference): opciones de línea de comandos

Details

44* `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.44* `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.

45* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.45* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.

46 46 

47Verifique el resumen de instalación. Si reporta `Run /reload-plugins to activate.`, consulte [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para activar el plugin en su sesión actual.47Verifica el resumen de instalación. Si reporta `Run /reload-plugins to apply.`, consulta [Aplicar cambios de plugin sin reiniciar](/docs/es/plugins/cli-reference#reload-plugins) para activar el plugin en tu sesión actual.

48 48 

49<h3 id="enable-for-your-team-in-local-sessions">49<h3 id="enable-for-your-team-in-local-sessions">

50 Habilitar en sesiones locales para su equipo50 Habilitar en sesiones locales para su equipo

Details

45Verifique esto antes de planificar un despliegue:45Verifique esto antes de planificar un despliegue:

46 46 

47* **Planes**: versión beta pública para organizaciones Team y Enterprise. Los entornos autohospedados están deshabilitados de forma predeterminada; un [Propietario](/docs/es/cloud-environments#organization-shared-environments) activa **Permitir entornos autohospedados** en la [página de administrador de **Entornos en la nube**](https://claude.ai/admin-settings/cloud-environments), que requiere que [sesiones en la nube](/docs/es/claude-code-on-the-web) estén habilitadas para la organización.47* **Planes**: versión beta pública para organizaciones Team y Enterprise. Los entornos autohospedados están deshabilitados de forma predeterminada; un [Propietario](/docs/es/cloud-environments#organization-shared-environments) activa **Permitir entornos autohospedados** en la [página de administrador de **Entornos en la nube**](https://claude.ai/admin-settings/cloud-environments), que requiere que [sesiones en la nube](/docs/es/claude-code-on-the-web) estén habilitadas para la organización.

48* **Retención cero de datos**: no disponible para organizaciones con [Retención cero de datos](/docs/es/zero-data-retention) habilitada.48* **Retención cero de datos y HIPAA**: no disponible para organizaciones con [Retención cero de datos](/docs/es/zero-data-retention) habilitada o con la [configuración de HIPAA](/docs/es/hipaa-setup) aplicada.

49* **Inferencia de modelos**: las sesiones utilizan la API de Anthropic, a menos que configures un runner para [enviar solicitudes del modelo a Amazon Bedrock o a Agent Platform de Google Cloud](/docs/es/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform). El contenido de las sesiones se envía a Anthropic en ambos casos. En un runner configurado de esta manera, la [configuración administrada por el servidor](/docs/es/server-managed-settings) y las políticas de la organización de claude.ai no llegan a las sesiones.49* **Inferencia de modelos**: las sesiones utilizan la API de Anthropic, a menos que configures un runner para [enviar solicitudes del modelo a Amazon Bedrock o a Agent Platform de Google Cloud](/docs/es/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform). El contenido de las sesiones se envía a Anthropic en ambos casos. En un runner configurado de esta manera, la [configuración administrada por el servidor](/docs/es/server-managed-settings) y las políticas de la organización de claude.ai no llegan a las sesiones.

50* **Superficies**: sesiones iniciadas desde [claude.ai/code](https://claude.ai/code), las aplicaciones móviles y de escritorio, [rutinas programadas](/docs/es/routines), y la terminal, con [`claude --cloud`](/docs/es/claude-code-on-the-web#from-terminal-to-cloud) o un [envío `--environment`](/docs/es/self-hosted-environments-testing#run-the-test-loop), pueden ejecutarse en entornos autohospedados. Las sesiones de [Claude Tag](https://claude.com/docs/claude-tag/overview) también pueden ejecutarse en ellas, pero Claude aún no puede usar [Paquetes de acceso](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) en esas sesiones. Las sesiones de [Claude Security](/docs/es/claude-security) y [Code Review](/docs/es/code-review) aún no se enrutan a ellas. El soporte para esas dos superficies sigue por separado.50* **Superficies**: sesiones iniciadas desde [claude.ai/code](https://claude.ai/code), las aplicaciones móviles y de escritorio, [rutinas programadas](/docs/es/routines), y la terminal, con [`claude --cloud`](/docs/es/claude-code-on-the-web#from-terminal-to-cloud) o un [envío `--environment`](/docs/es/self-hosted-environments-testing#run-the-test-loop), pueden ejecutarse en entornos autohospedados. Las sesiones de [Claude Tag](https://claude.com/docs/claude-tag/overview) también pueden ejecutarse en ellas, pero Claude aún no puede usar [Paquetes de acceso](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle) en esas sesiones. Las sesiones de [Claude Security](/docs/es/claude-security) y [Code Review](/docs/es/code-review) aún no se enrutan a ellas. El soporte para esas dos superficies sigue por separado.

51* **Repositorios**: las sesiones clonan repositorios desde GitHub; consulte [Opciones de autenticación de GitHub](/docs/es/claude-code-on-the-web#github-authentication-options). Para un host de GitHub Enterprise Server, consulte sus [requisitos de red](/docs/es/github-enterprise-server#network-requirements).51* **Repositorios**: las sesiones clonan repositorios desde GitHub; consulte [Opciones de autenticación de GitHub](/docs/es/claude-code-on-the-web#github-authentication-options). Para un host de GitHub Enterprise Server, consulte sus [requisitos de red](/docs/es/github-enterprise-server#network-requirements).

Details

156 156 

157Sin una identidad, `git commit` falla con `Please tell me who you are` y las sesiones no pueden progresar. Puede usar su propia identidad de bot en su lugar; el runner no anula estos valores.157Sin una identidad, `git commit` falla con `Please tell me who you are` y las sesiones no pueden progresar. Puede usar su propia identidad de bot en su lugar; el runner no anula estos valores.

158 158 

159No hornee credenciales de push de larga duración o ampliamente alcanzadas en una imagen de runner compartida: una credencial en la imagen está disponible para cada sesión que ejecuta la imagen, quienquiera que la haya iniciado. En su lugar, genere un token de corta duración y alcance mínimo por sesión desde su [script de envoltura](/docs/es/self-hosted-environments-configuration#wrapper-scripts), usando la identidad del creador de la sesión decodificada del JWT de la sesión. Emparéjelo con un contenedor efímero por sesión, que requiere `--capacity 1`, para que ninguna credencial sobreviva a la sesión que la generó; consulte la [sección de endurecimiento](#harden-your-deployment).159No incluyas credenciales de push de larga duración o de alcance amplio en una imagen de runner compartida: una credencial en la imagen está disponible para cada sesión que ejecuta la imagen, sin importar quién la haya iniciado. En su lugar, genera un token de corta duración y alcance mínimo por sesión desde tu [script de envoltura](/docs/es/self-hosted-environments-configuration#wrapper-scripts), usando la identidad del creador de la sesión decodificada del JWT de la sesión. Combínalo con un contenedor efímero por sesión, que requiere `--capacity 1`, para que ninguna credencial sobreviva a la sesión que la generó; consulta la [sección de endurecimiento](#harden-your-deployment).

160 160 

161Si debe configurar credenciales de push a nivel de imagen, por ejemplo para una clave de implementación de solo lectura, limítelas lo más posible que su host de git permita:161Si debe configurar credenciales de push a nivel de imagen, por ejemplo para una clave de implementación de solo lectura, limítelas lo más posible que su host de git permita:

162 162 

settings.md +1 −1

Details

400 Archivos de configuración y a quién afectan400 Archivos de configuración y a quién afectan

401</h2>401</h2>

402 402 

403Claude Code lee configuraciones de cuatro archivos, y una organización también puede entregar configuraciones administradas desde la consola de claude.ai. Cada fuente tiene un ámbito: el conjunto de personas y proyectos a los que se aplica una configuración guardada en ella, ya sea solo usted, todos en un proyecto o todos en su organización.403Claude Code lee la configuración de cuatro archivos, y una organización también puede entregar configuración administrada desde la consola de claude.ai. Cada fuente tiene un alcance: el conjunto de personas y proyectos a los que se aplica un ajuste guardado en ella, ya seas solo tú, todos en un proyecto o todos en tu organización.

404 404 

405| Ámbito | Archivo | A quién afecta | Úselo para |405| Ámbito | Archivo | A quién afecta | Úselo para |

406| :- | :- | :- | :- |406| :- | :- | :- | :- |

Details

1765 * `"auto"`: Claude Code se ejecuta sin solicitudes habituales; antes de que se ejecuten acciones como comandos de shell y solicitudes de red, un clasificador en segundo plano verifica que se alineen con tu solicitud1765 * `"auto"`: Claude Code se ejecuta sin solicitudes habituales; antes de que se ejecuten acciones como comandos de shell y solicitudes de red, un clasificador en segundo plano verifica que se alineen con tu solicitud

1766 * `"dontAsk"`: Claude Code deniega automáticamente cada llamada que de otro modo pediría confirmación; las lecturas, otras acciones que no necesitan aprobación y las herramientas preaprobadas se siguen ejecutando1766 * `"dontAsk"`: Claude Code deniega automáticamente cada llamada que de otro modo pediría confirmación; las lecturas, otras acciones que no necesitan aprobación y las herramientas preaprobadas se siguen ejecutando

1767 * `"bypassPermissions"`: Claude Code ejecuta todo sin preguntar1767 * `"bypassPermissions"`: Claude Code ejecuta todo sin preguntar

1768 * `"manual"`: un alias de `"default"`, en Claude Code v2.1.200 o posterior1768 * `"manual"`: un alias de `"default"`

1769* **Default**: sin establecer1769* **Default**: sin establecer

1770* **Per-session overrides**: `--permission-mode`, y su equivalente `--dangerously-skip-permissions` para `bypassPermissions`, tienen precedencia sobre esta clave para una sesión1770* **Per-session overrides**: `--permission-mode`, y su equivalente `--dangerously-skip-permissions` para `bypassPermissions`, tienen precedencia sobre esta clave para una sesión

1771 1771 


1777}1777}

1778```1778```

1779 1779 

1780Las reglas de permisos se superponen a todos los modos: las reglas `deny` bloquean en todos los modos, incluido `bypassPermissions`. Consulta [Modos de permisos](/docs/es/permission-modes). `manual` nombra el modo de permisos etiquetado como Manual en la CLI y en la extensión de VS Code; el alias requiere Claude Code v2.1.200 o posterior. 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](/docs/es/permission-modes#switch-permission-modes).1780Las reglas de permisos se superponen a todos los modos: las reglas `deny` bloquean en todos los modos, incluido `bypassPermissions`. Consulta [Modos de permisos](/docs/es/permission-modes). 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](/docs/es/permission-modes#switch-permission-modes).

1781 1781 

1782<h3 id="permissions-disablebypasspermissionsmode">1782<h3 id="permissions-disablebypasspermissionsmode">

1783 `permissions.disableBypassPermissionsMode`1783 `permissions.disableBypassPermissionsMode`


3232 `askUserQuestionTimeout`3232 `askUserQuestionTimeout`

3233</h3>3233</h3>

3234 3234 

3235Permite que un diálogo [`AskUserQuestion`](/docs/es/tools-reference) sin respuesta continúe automáticamente después de un período de tiempo inactivo, enviando cualquier opción que ya hayas seleccionado. Establécelo cuando te alejes y quieras que Claude continúe sin ti. Con el valor predeterminado, las preguntas esperan hasta que las respondas. Para saber cuándo el temporizador se pausa o nunca comienza, consulta [Tiempo de espera de continuación automática de preguntas](/docs/es/tools-reference#question-auto-continue-timeout). Requiere Claude Code v2.1.200 o posterior.3235Permite que un diálogo [`AskUserQuestion`](/docs/es/tools-reference) sin respuesta continúe automáticamente después de un período de tiempo inactivo, enviando cualquier opción que ya hayas seleccionado. Establécelo cuando te alejes y quieras que Claude continúe sin ti. Con el valor predeterminado, las preguntas esperan hasta que las respondas. Para saber cuándo el temporizador se pausa o nunca comienza, consulta [Tiempo de espera de continuación automática de preguntas](/docs/es/tools-reference#question-auto-continue-timeout).

3236 3236 

3237* **Scope**: [`User or managed`](#scopes)3237* **Scope**: [`User or managed`](#scopes)

3238* **Type**: string, uno de `"60s"`, `"5m"`, `"10m"`, o `"never"`3238* **Type**: string, uno de `"60s"`, `"5m"`, `"10m"`, o `"never"`


3245}3245}

3246```3246```

3247 3247 

3248Aparece en `/config` como **Question auto-continue timeout**, que escribe esta clave en la configuración del usuario; Claude Code oculta la fila mientras la configuración administrada o la bandera `--settings` establezcan la clave. Requiere Claude Code v2.1.200 o posterior.3248Aparece en `/config` como **Question auto-continue timeout**, que escribe esta clave en la configuración del usuario; Claude Code oculta la fila mientras la configuración administrada o la bandera `--settings` establezcan la clave.

3249 3249 

3250<h3 id="autocontinueatusagelimit">3250<h3 id="autocontinueatusagelimit">

3251 `autoContinueAtUsageLimit`3251 `autoContinueAtUsageLimit`


5165}5165}

5166```5166```

5167 5167 

5168Los plugins integrados almacenan sus opciones bajo la misma clave con un sufijo `@builtin`. Por ejemplo, la configuración [**Instrucciones de proyecto**](/docs/es/memory#choose-which-instruction-files-load) que controla si Claude Code lee archivos `AGENTS.md` es `pluginConfigs["agents-md@builtin"].options.instructionFiles`.5168Los plugins integrados almacenan sus opciones en la misma clave con el sufijo `@builtin`. Por ejemplo, el ajuste [**Project instructions**](/docs/es/memory#choose-which-instruction-files-load) que controla si Claude Code lee los archivos `AGENTS.md` es `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`. Antes de v2.1.285, el ID del plugin era `agents-md@builtin`. Las versiones posteriores leen una entrada con cualquiera de los dos ID.

5169 5169 

5170Claude Code ignora entradas de proyecto y local porque sustituye estos valores en configuraciones de hook, MCP y LSP de plugin, y un repositorio clonado no debe poder suministrarlos. Antes de v2.1.207, la configuración de proyecto y local también se leía.5170Claude Code ignora entradas de proyecto y local porque sustituye estos valores en configuraciones de hook, MCP y LSP de plugin, y un repositorio clonado no debe poder suministrarlos. Antes de v2.1.207, la configuración de proyecto y local también se leía.

5171 5171 

skills.md +3 −3

Details

40 Ejecute y verifique su aplicación40 Ejecute y verifique su aplicación

41</h3>41</h3>

42 42 

43Tres skills incluidas funcionan juntas para lanzar su aplicación y confirmar cambios contra la aplicación en ejecución en lugar de solo pruebas:43Tres skills incluidos funcionan juntos para lanzar tu aplicación y confirmar los cambios contra la aplicación en ejecución en lugar de solo con pruebas:

44 44 

45| Skill | Propósito |45| Skill | Propósito |

46| :- | :- |46| :- | :- |


52 52 

53`/run-skill-generator` registra la receta en su lugar. Consigue que su aplicación se ejecute desde un entorno limpio, captura lo que funcionó (los comandos de instalación, las variables de entorno, el script de lanzamiento) y lo confirma como una skill por proyecto en `.claude/skills/run-<name>/`. Después de eso, `/run`, `/verify` y cualquier otro agente en el repositorio siguen la receta registrada en lugar de redescubrirla. Ejecute `/run-skill-generator` una vez por proyecto, y nuevamente si el proceso de compilación o lanzamiento cambia.53`/run-skill-generator` registra la receta en su lugar. Consigue que su aplicación se ejecute desde un entorno limpio, captura lo que funcionó (los comandos de instalación, las variables de entorno, el script de lanzamiento) y lo confirma como una skill por proyecto en `.claude/skills/run-<name>/`. Después de eso, `/run`, `/verify` y cualquier otro agente en el repositorio siguen la receta registrada en lugar de redescubrirla. Ejecute `/run-skill-generator` una vez por proyecto, y nuevamente si el proceso de compilación o lanzamiento cambia.

54 54 

55`/verify` también puede registrar su propia receta. Cuando tiene que compilar e impulsar su aplicación sin una receta registrada, escribe lo que funcionó en `.claude/skills/verify/SKILL.md` en la raíz del repositorio, o en el directorio del paquete tocado en un monorepo, para que las ejecuciones posteriores y otros agentes sigan los mismos pasos. En la raíz del repositorio, la skill registrada reemplaza la `/verify` incluida. Esto requiere Claude Code v2.1.200 o posterior.55`/verify` también puede registrar su propia receta. Cuando tiene que compilar y manejar tu aplicación sin una receta registrada, escribe lo que funcionó en `.claude/skills/verify/SKILL.md` en la raíz del repositorio, o en el directorio del paquete modificado en un monorepo, para que las ejecuciones posteriores y otros agentes sigan los mismos pasos. En la raíz del repositorio, el skill registrado reemplaza al `/verify` incluido.

56 56 

57Claude edita el archivo registrado solo cuando dirigió una ejecución incorrectamente, como un comando que falló o un paso faltante, para que pueda confirmar el archivo sin diffs por sesión. Antes de v2.1.205, la skill incluida le indicaba a Claude que incorporara cualquier cosa que una ejecución aprendiera, lo que causaba conflictos de fusión frecuentes.57Claude edita el archivo registrado solo cuando dirigió una ejecución incorrectamente, como un comando que falló o un paso faltante, para que pueda confirmar el archivo sin diffs por sesión. Antes de v2.1.205, la skill incluida le indicaba a Claude que incorporara cualquier cosa que una ejecución aprendiera, lo que causaba conflictos de fusión frecuentes.

58 58 


996* `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.996* `Marketplace "claude-plugins-official" not found`: agregue el marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.

997* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.997* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.

998 998 

999Si el resumen de instalación reporta `Run /reload-plugins to activate.`, Claude Code entonces ejecuta esa recarga para usted. Si la recarga advierte que su próximo mensaje volvería a leer la conversación, ejecute `/reload-plugins --force` para que las skills del plugin estén disponibles en la sesión actual. Luego pida a Claude que evalúe una skill existente, por ejemplo `evaluate my summarize-changes skill with skill-creator`. El plugin lo guía a través de la escritura de casos de prueba y ejecuta el bucle:999Si el resumen de instalación reporta `Run /reload-plugins to apply.`, Claude Code ejecuta esa recarga por ti. Si la recarga advierte que tu próximo mensaje volvería a leer la conversación, ejecuta `/reload-plugins --force` para que los skills del plugin estén disponibles en la sesión actual. Luego pide a Claude que evalúe un skill existente, por ejemplo `evaluate my summarize-changes skill with skill-creator`. El plugin te guía a través de la escritura de casos de prueba y ejecuta el bucle:

1000 1000 

1001* **Casos de prueba**: almacena prompts, archivos de entrada y comportamiento esperado en `evals/evals.json` dentro del directorio de la skill1001* **Casos de prueba**: almacena prompts, archivos de entrada y comportamiento esperado en `evals/evals.json` dentro del directorio de la skill

1002* **Ejecuciones aisladas**: genera una [subagente](/docs/es/sub-agents) por caso de prueba para que cada ejecución comience con un contexto limpio, y registra el recuento de tokens y la duración1002* **Ejecuciones aisladas**: genera una [subagente](/docs/es/sub-agents) por caso de prueba para que cada ejecución comience con un contexto limpio, y registra el recuento de tokens y la duración

slack.md +35 −15

Details

4 4 

5# Claude Code en Slack5# Claude Code en Slack

6 6 

7> Delega tareas de codificación directamente desde tu espacio de trabajo de Slack. Anthropic está retirando esta versión anterior para espacios de trabajo de Team y Enterprise en favor de Claude Tag; permanece como la ruta de configuración en planes Pro y Max.7> Delega tareas de codificación desde Slack. Esta versión anterior responde a menciones en canales solo de cuentas Pro y Max en espacios de trabajo no conectados a Claude Tag.

8 8 

9<Warning>9<Warning>

10 Esta página documenta la versión anterior de Claude Code en Slack, que ejecuta cada sesión bajo la cuenta de un usuario individual.10 Esta página documenta la versión anterior de Claude Code en Slack, que ejecuta cada sesión bajo la cuenta de un usuario individual. Responde a las @menciones en canales solo de cuentas Pro y Max, y solo en un espacio de trabajo de Slack que ninguna organización haya conectado a [Claude Tag](https://claude.com/product/tag). Claude Tag ejecuta @Claude como la identidad compartida de tu organización con acceso configurado por el administrador.

11 11 

12 * **Planes Team y Enterprise:** Anthropic está retirando esta versión en favor de [Claude Tag](https://claude.com/product/tag), que ejecuta @Claude como la identidad compartida de tu organización con acceso configurado por el administrador. Tu aplicación de Slack existente y tu identificador @Claude se mantienen, y tu equipo de cuenta de Anthropic puede informarte la fecha de transición. [Configura Claude Tag](https://claude.com/docs/claude-tag/overview) para un nuevo espacio de trabajo; para mover uno que ya usa esta versión, consulta [Migrar desde el Claude anterior en Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).12 * **Planes Pro y Max:** Claude Tag no está disponible en planes individuales, por lo que esta página permanece como la ruta de configuración en un espacio de trabajo que no esté conectado a Claude Tag.

13 * **Planes Pro y Max:** Claude Tag no está disponible en planes individuales, por lo que esta página permanece como la ruta de configuración.13 * **Planes Team y Enterprise:** tu aplicación de Slack existente y tu identificador @Claude se mantienen. [Configura Claude Tag](https://claude.com/docs/claude-tag/overview) para un nuevo espacio de trabajo; para mover uno que ya usa esta versión, consulta [Migrar desde el Claude anterior en Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

14 * **Un aviso en lugar de una respuesta:** busca el [aviso de configuración](#this-workspace-isnt-set-up-for-claude-tag-yet) o el [aviso de retiro](#the-legacy-claude-in-slack-bot-is-retired) con el que respondió @Claude.

14</Warning>15</Warning>

15 16 

16Claude Code en Slack trae el poder de Claude Code directamente a tu espacio de trabajo de Slack. Cuando mencionas `@Claude` con una tarea de codificación, Claude detecta automáticamente la intención y crea una sesión de Claude Code en la web, permitiéndote delegar trabajo de desarrollo sin salir de tus conversaciones de equipo.17Claude Code en Slack trae el poder de Claude Code directamente a tu espacio de trabajo de Slack. Cuando mencionas `@Claude` con una tarea de codificación, Claude detecta automáticamente la intención y crea una sesión en la nube de Claude Code, permitiéndote delegar trabajo de desarrollo sin salir de tus conversaciones de equipo.

17 18 

18Esta integración se basa en la aplicación Claude para Slack existente pero agrega enrutamiento inteligente a Claude Code en la web para solicitudes relacionadas con codificación. Cada sesión se ejecuta bajo tu propia cuenta de Claude, utilizando tus repositorios conectados y tus límites de plan.19Esta integración se basa en la aplicación Claude para Slack existente pero agrega enrutamiento inteligente a sesiones en la nube de Claude Code para solicitudes relacionadas con codificación. Cada sesión se ejecuta bajo tu propia cuenta de Claude, utilizando tus repositorios conectados y tus límites de plan.

19 20 

20<h2 id="use-cases">21<h2 id="use-cases">

21 Casos de uso22 Casos de uso


30 Requisitos previos31 Requisitos previos

31</h2>32</h2>

32 33 

33Antes de usar Claude Code en Slack, asegúrese de tener lo siguiente:34Antes de usar Claude Code en Slack, asegúrate de tener lo siguiente:

34 35 

35| Requisito | Detalles |36| Requisito | Detalles |

36| :- | :- |37| :- | :- |

37| Plan de Claude | Pro, Max, Team o Enterprise con acceso a Claude Code (asientos premium o asientos Chat + Claude Code) |38| Plan de Claude | Pro o Max |

38| Sesiones en la nube | Las [sesiones en la nube](/docs/es/claude-code-on-the-web) están habilitadas para su cuenta |39| Espacio de trabajo de Slack | No conectado a [Claude Tag](https://claude.com/docs/claude-tag/overview) por ninguna organización. Si @Claude responde con el [aviso de retiro](#the-legacy-claude-in-slack-bot-is-retired), el espacio de trabajo está conectado |

40| Sesiones en la nube | Las [sesiones en la nube](/docs/es/claude-code-on-the-web) están habilitadas para tu cuenta |

39| Cuenta de GitHub | Conectada en [claude.ai/code](https://claude.ai/code) con al menos un repositorio autenticado |41| Cuenta de GitHub | Conectada en [claude.ai/code](https://claude.ai/code) con al menos un repositorio autenticado |

40| Autenticación de Slack | Su cuenta de Slack vinculada a su cuenta de Claude a través de la aplicación Claude |42| Autenticación de Slack | Tu cuenta de Slack vinculada a tu cuenta de Claude a través de la aplicación Claude |

41 43 

42<h2 id="setting-up-claude-code-in-slack">44<h2 id="setting-up-claude-code-in-slack">

43 Configuración de Claude Code en Slack45 Configuración de Claude Code en Slack


213 Solución de problemas215 Solución de problemas

214</h2>216</h2>

215 217 

218<h3 id="this-workspace-isnt-set-up-for-claude-tag-yet">

219 "This workspace isn't set up for Claude Tag yet"

220</h3>

221 

222@Claude responde en el hilo con este aviso en lugar de una respuesta cuando se cumplen ambas condiciones:

223 

224* Ninguna organización ha conectado tu espacio de trabajo de Slack a [Claude Tag](https://claude.com/docs/claude-tag/overview).

225* La cuenta de Claude que vinculaste en Slack no tiene un plan Pro o Max.

226 

227Claude Tag está disponible en los planes Team y Enterprise. Para conectar el espacio de trabajo, comienza con el comando `@Claude connect` que menciona el aviso y luego sigue [Configurar Claude Tag](https://claude.com/docs/claude-tag/overview).

228 

229<h3 id="the-legacy-claude-in-slack-bot-is-retired">

230 "The legacy Claude in Slack bot is retired"

231</h3>

232 

233El aviso comienza con `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.` Tu espacio de trabajo de Slack está conectado a una organización de Claude, y la versión anterior sigue seleccionada para el canal, el espacio de trabajo o el valor predeterminado de la organización en la configuración de Claude Tag de esa organización. El aviso no depende de tu propio plan, por lo que las cuentas Pro y Max también lo reciben.

234 

235Si eres Propietario de esa organización, abre la [configuración de administrador de Claude](https://claude.ai/admin-settings/claude-tag) y activa Claude Tag para el canal. Para corregir todos los canales que heredan el ajuste, cámbialo en el espacio de trabajo o en el valor predeterminado de la organización. Para la migración completa, consulta [Migrar desde la versión anterior de Claude in Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier). Si no eres Propietario, envía esta entrada a uno.

236 

216<h3 id="claude-code-is-not-enabled-for-your-account">237<h3 id="claude-code-is-not-enabled-for-your-account">

217 "Claude Code no está habilitado para tu cuenta"238 "Claude Code is not enabled for your account"

218</h3>239</h3>

219 240 

220Este error significa que tu cuenta de Claude aún no tiene un entorno en la nube. Inicia sesión en [claude.ai/code](https://claude.ai/code) una vez con la misma cuenta que conectaste a Slack y completa la [incorporación web](/docs/es/web-quickstart#connect-github), que crea tu entorno en la nube predeterminado o te pide que lo crees. El error se resuelve en tu próxima mención. Cada usuario debe hacer esto individualmente.241Este error significa que tu cuenta de Claude aún no tiene un entorno en la nube. Inicia sesión en [claude.ai/code](https://claude.ai/code) una vez con la misma cuenta que conectaste a Slack y completa la [incorporación web](/docs/es/web-quickstart#connect-github), que crea tu entorno en la nube predeterminado o te pide que lo crees. El error se resuelve en tu próxima mención. Cada usuario debe hacer esto individualmente.


224</h3>245</h3>

225 246 

2261. Verifica que tu cuenta de Claude esté conectada en la App Home de Claude2471. Verifica que tu cuenta de Claude esté conectada en la App Home de Claude

2272. Comprueba que tengas acceso a Claude Code en la web habilitado2482. Comprueba que las sesiones en la nube estén habilitadas para tu cuenta

2283. Asegúrate de tener al menos un repositorio de GitHub conectado a Claude Code2493. Asegúrate de tener al menos un repositorio de GitHub conectado a Claude Code

229 250 

230<h3 id="sessions-from-a-claude-tag-channel-fail-to-start">251<h3 id="sessions-from-a-claude-tag-channel-fail-to-start">


263 284 

2641. Desconecta y reconecta tu cuenta de Claude en la App Home2851. Desconecta y reconecta tu cuenta de Claude en la App Home

2652. Asegúrate de estar conectado a la cuenta de Claude correcta en tu navegador2862. Asegúrate de estar conectado a la cuenta de Claude correcta en tu navegador

2663. Comprueba que tu plan de Claude incluya acceso a Claude Code

267 287 

268<h2 id="current-limitations">288<h2 id="current-limitations">

269 Limitaciones actuales289 Limitaciones actuales

270</h2>290</h2>

271 291 

272* **Solo GitHub**: Los repositorios deben estar en GitHub.292* **Solo GitHub**: Los repositorios deben estar en GitHub.

273* **Un PR a la vez**: Cada sesión puede crear una solicitud de extracción.293* **Un PR a la vez**: Cada sesión puede crear un pull request.

274* **Se requiere acceso a sesiones en la nube**: Los usuarios necesitan acceso a [sesiones en la nube](/docs/es/claude-code-on-the-web); sin él, Claude responde con respuestas de chat estándar.294* **Se requiere acceso a sesiones en la nube**: Los usuarios necesitan acceso a [sesiones en la nube](/docs/es/claude-code-on-the-web).

275 295 

276<h2 id="related-resources">296<h2 id="related-resources">

277 Recursos relacionados297 Recursos relacionados

statusline.md +1 −1

Details

211| `prompt_cache` | Las estadísticas de [prompt cache](/docs/es/prompt-caching) de la sesión para la conversación principal: relación de aciertos, fallos, y si el caché está caliente. Consulta [campos de prompt cache](#prompt-cache-fields) para cada campo. Ausente hasta la primera respuesta de API de la conversación principal. Requiere Claude Code v2.1.251 o posterior |211| `prompt_cache` | Las estadísticas de [prompt cache](/docs/es/prompt-caching) de la sesión para la conversación principal: relación de aciertos, fallos, y si el caché está caliente. Consulta [campos de prompt cache](#prompt-cache-fields) para cada campo. Ausente hasta la primera respuesta de API de la conversación principal. Requiere Claude Code v2.1.251 o posterior |

212| `session_id` | Identificador único de sesión |212| `session_id` | Identificador único de sesión |

213| `session_name` | Nombre de sesión. Utiliza el nombre personalizado establecido con la bandera `--name` o `/rename` cuando existe uno, de lo contrario el título de sesión generado por IA. El [nombre para mostrar predeterminado](/docs/es/sessions#name-your-sessions), como `my-app-3f`, no completa este campo. Ausente cuando la sesión no tiene ni un nombre personalizado ni un título generado por IA |213| `session_name` | Nombre de sesión. Utiliza el nombre personalizado establecido con la bandera `--name` o `/rename` cuando existe uno, de lo contrario el título de sesión generado por IA. El [nombre para mostrar predeterminado](/docs/es/sessions#name-your-sessions), como `my-app-3f`, no completa este campo. Ausente cuando la sesión no tiene ni un nombre personalizado ni un título generado por IA |

214| `prompt_id` | UUID que identifica el prompt del usuario que se está procesando actualmente. Coincide con el atributo [`prompt.id` en eventos de OpenTelemetry](/docs/es/monitoring-usage#event-correlation-attributes). Ausente hasta la primera entrada del usuario. Requiere Claude Code v2.1.196 o posterior |214| `prompt_id` | UUID que identifica el prompt del usuario que se está procesando actualmente. Coincide con el atributo [`prompt.id` en eventos de OpenTelemetry](/docs/es/monitoring-usage#event-correlation-attributes). Ausente hasta la primera entrada del usuario |

215| `transcript_path` | Ruta al archivo de transcripción de conversación |215| `transcript_path` | Ruta al archivo de transcripción de conversación |

216| `version` | Versión de Claude Code |216| `version` | Versión de Claude Code |

217| `output_style.name` | Nombre del estilo de salida actual |217| `output_style.name` | Nombre del estilo de salida actual |

sub-agents.md +2 −2

Details

315| `tools` | No | [Herramientas](#available-tools) que el subagente puede usar, como una cadena separada por comas como `Read, Grep, Bash` o una lista YAML. Hereda todas las herramientas disponibles para subagentes si se omite. Si ninguna entrada en la lista se resuelve a una herramienta, el subagente generalmente [falla al lanzarse](/docs/es/errors#agent-would-be-spawned-with-zero-tools) con un error nombrando las entradas. Para precargar Skills en el contexto, use el campo `skills` en lugar de listar `Skill` aquí |315| `tools` | No | [Herramientas](#available-tools) que el subagente puede usar, como una cadena separada por comas como `Read, Grep, Bash` o una lista YAML. Hereda todas las herramientas disponibles para subagentes si se omite. Si ninguna entrada en la lista se resuelve a una herramienta, el subagente generalmente [falla al lanzarse](/docs/es/errors#agent-would-be-spawned-with-zero-tools) con un error nombrando las entradas. Para precargar Skills en el contexto, use el campo `skills` en lugar de listar `Skill` aquí |

316| `disallowedTools` | No | Herramientas a denegar, eliminadas de la lista heredada o especificada. Mismo formato que `tools`. Una entrada con un especificador, como `Bash(git push *)`, aún [elimina la herramienta completa](#available-tools) |316| `disallowedTools` | No | Herramientas a denegar, eliminadas de la lista heredada o especificada. Mismo formato que `tools`. Una entrada con un especificador, como `Bash(git push *)`, aún [elimina la herramienta completa](#available-tools) |

317| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, un ID de modelo completo como `claude-opus-5-5`, o `inherit`. Cuando lo omite, Claude Code elige el modelo en el [orden de modelo de subagente](#choose-a-model) |317| `model` | No | [Modelo](#choose-a-model) a usar: `sonnet`, `opus`, `haiku`, `fable`, un ID de modelo completo como `claude-opus-5-5`, o `inherit`. Cuando lo omite, Claude Code elige el modelo en el [orden de modelo de subagente](#choose-a-model) |

318| `permissionMode` | No | [Modo de permiso](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, o `manual` como alias para `default`. El alias `manual` requiere Claude Code v2.1.200 o posterior. Se ignora para [subagentes de plugin](#choose-the-subagent-scope) |318| `permissionMode` | No | [Modo de permisos](#permission-modes): `default`, `acceptEdits`, `auto`, `dontAsk`, `bypassPermissions`, `plan`, o `manual` como alias de `default`. Se ignora para [subagentes de plugin](#choose-the-subagent-scope) |

319| `maxTurns` | No | Número máximo de turnos de agente antes de que el subagente se detenga. Cuando el subagente alcanza el límite, Claude Code devuelve su salida marcada como parcial, y Claude puede [reanudarlo](#resume-subagents) para continuar. La marca parcial requiere Claude Code v2.1.246 o posterior |319| `maxTurns` | No | Número máximo de turnos de agente antes de que el subagente se detenga. Cuando el subagente alcanza el límite, Claude Code devuelve su salida marcada como parcial, y Claude puede [reanudarlo](#resume-subagents) para continuar. La marca parcial requiere Claude Code v2.1.246 o posterior |

320| `skills` | No | [Skills](/docs/es/skills) a precargar en el contexto del subagente al inicio. El contenido completo de la skill se inyecta, no solo la descripción. Los subagentes aún pueden invocar skills de proyecto, usuario y plugin no listadas a través de la herramienta Skill |320| `skills` | No | [Skills](/docs/es/skills) a precargar en el contexto del subagente al inicio. El contenido completo de la skill se inyecta, no solo la descripción. Los subagentes aún pueden invocar skills de proyecto, usuario y plugin no listadas a través de la herramienta Skill |

321| `mcpServers` | No | [Servidores MCP](/docs/es/mcp) disponibles para este subagente. Cada entrada es un nombre de servidor que hace referencia a un servidor ya configurado (por ejemplo, `"slack"`) o una definición en línea con el nombre del servidor como clave y una [configuración completa del servidor MCP](/docs/es/mcp#installing-mcp-servers) como valor. Se ignora para [subagentes de plugin](#choose-the-subagent-scope) |321| `mcpServers` | No | [Servidores MCP](/docs/es/mcp) disponibles para este subagente. Cada entrada es un nombre de servidor que hace referencia a un servidor ya configurado (por ejemplo, `"slack"`) o una definición en línea con el nombre del servidor como clave y una [configuración completa del servidor MCP](/docs/es/mcp#installing-mcp-servers) como valor. Se ignora para [subagentes de plugin](#choose-the-subagent-scope) |


988 988 

989Un subagente cuya ejecución termina en un error de API, como un límite de uso o un error de servidor repetido, reporta esa falla de vuelta a Claude. Lo que Claude recibe depende de dónde se ejecutó el subagente:989Un subagente cuya ejecución termina en un error de API, como un límite de uso o un error de servidor repetido, reporta esa falla de vuelta a Claude. Lo que Claude recibe depende de dónde se ejecutó el subagente:

990 990 

991* **Primer plano**: si un rate limit, sobrecarga o error de servidor corta un subagente que ya produjo salida de texto, la herramienta Agent devuelve esa salida parcial con una nota de que el subagente fue cortado y no completó su tarea. Un subagente que no produjo nada, o cuya única salida fueron llamadas a herramientas, falla con [`Agent terminated early due to an API error`](/docs/es/errors#agent-terminated-early-due-to-an-api-error), seguido del detalle del error. En v2.1.199, un rate limit, sobrecarga o error de servidor que cortó la forma de solo llamadas a herramientas devolvió en su lugar un resultado parcial vacío que contenía solo la nota de corte.991* **Primer plano**: si un rate limit, sobrecarga o error de servidor corta un subagente que ya produjo salida de texto, la herramienta Agent devuelve esa salida parcial con una nota de que el subagente fue cortado y no completó su tarea. Un subagente que no produjo nada, o cuya única salida fueron llamadas a herramientas, falla con [`Agent terminated early due to an API error`](/docs/es/errors#agent-terminated-early-due-to-an-api-error), seguido del detalle del error.

992* **Segundo plano**: el subagente se marca como fallido, y el mensaje que Claude recibe cuando termina nombra el error de API e incluye la última salida del subagente, por lo que el trabajo parcial no se pierde.992* **Segundo plano**: el subagente se marca como fallido, y el mensaje que Claude recibe cuando termina nombra el error de API e incluye la última salida del subagente, por lo que el trabajo parcial no se pierde.

993 993 

994Cuando configuras una [cadena de modelos de respaldo](/docs/es/model-config#fallback-model-chains) y un subagente encuentra una falla que la cadena cubre, como que su modelo no esté disponible, Claude Code cambia el subagente al primer modelo en la cadena que acepta la solicitud. El subagente continúa trabajando en lugar de terminar en el error.994Cuando configuras una [cadena de modelos de respaldo](/docs/es/model-config#fallback-model-chains) y un subagente encuentra una falla que la cadena cubre, como que su modelo no esté disponible, Claude Code cambia el subagente al primer modelo en la cadena que acepta la solicitud. El subagente continúa trabajando en lugar de terminar en el error.

Details

227 Invertir en documentación y memoria227 Invertir en documentación y memoria

228</h3>228</h3>

229 229 

230Le recomendamos encarecidamente que invierta en documentación para que Claude Code comprenda su base de código. Las organizaciones pueden implementar archivos CLAUDE.md en múltiples niveles. Consulte [dónde pueden vivir los archivos CLAUDE.md](/docs/es/memory#choose-where-to-put-claude-md-files) y [cómo implementar un CLAUDE.md en toda la organización](/docs/es/memory#deploy-organization-wide-claude-md).230Invierte en documentación para que Claude Code comprenda tu base de código. Las organizaciones pueden desplegar archivos CLAUDE.md en múltiples niveles. Consulta [dónde pueden vivir los archivos CLAUDE.md](/docs/es/memory#choose-where-to-put-claude-md-files) y [cómo desplegar un CLAUDE.md en toda la organización](/docs/es/memory#deploy-organization-wide-claude-md).

231 231 

232<h3 id="simplify-deployment">232<h3 id="simplify-deployment">

233 Simplificar la implementación233 Simplificar la implementación

234</h3>234</h3>

235 235 

236Si tiene un entorno de desarrollo personalizado, encontramos que crear una forma de "un clic" para instalar Claude Code es clave para aumentar la adopción en toda una organización.236Si tienes un entorno de desarrollo personalizado, crear una forma de "un clic" para instalar Claude Code es clave para aumentar la adopción en toda una organización.

237 237 

238<h3 id="start-with-guided-usage">238<h3 id="start-with-guided-usage">

239 Comenzar con uso guiado239 Comenzar con uso guiado


259 Usar MCP para integraciones259 Usar MCP para integraciones

260</h3>260</h3>

261 261 

262MCP es una excelente manera de dar a Claude Code más información, como conectarse a sistemas de gestión de tickets o registros de errores. Recomendamos que un equipo central configure servidores MCP y verifique una configuración `.mcp.json` en la base de código para que todos los usuarios se beneficien. [Obtenga más información](/docs/es/mcp).262MCP es una excelente manera de dar a Claude Code más información, como conectarse a sistemas de gestión de tickets o registros de errores. Haz que un equipo central configure servidores MCP y agregue una configuración `.mcp.json` a la base de código para que todos los usuarios se beneficien. [Más información](/docs/es/mcp).

263 263 

264<h2 id="next-steps">264<h2 id="next-steps">

265 Próximos pasos265 Próximos pasos

Details

43| `Read` | Lee el contenido de archivos. Consulta [Comportamiento de la herramienta Read](#read-tool-behavior) | No |43| `Read` | Lee el contenido de archivos. Consulta [Comportamiento de la herramienta Read](#read-tool-behavior) | No |

44| `ReadMcpResourceTool` | Lee un recurso MCP específico por URI | No |44| `ReadMcpResourceTool` | Lee un recurso MCP específico por URI | No |

45| `RemoteTrigger` | Crea, actualiza, ejecuta y lista [Routines](/docs/es/routines) en claude.ai. Respalda el comando `/schedule`. La [referencia de entrada de `RemoteTrigger`](/docs/es/agent-sdk/typescript#remotetrigger) documenta cada acción y las políticas de organización que eliminan la herramienta. Las Routines viven en claude.ai y requieren un plan Pro, Max, Team o Enterprise, por lo que esta herramienta no es accesible desde Amazon Bedrock, Claude Platform en AWS, Agent Platform de Google Cloud, o Microsoft Foundry | No |45| `RemoteTrigger` | Crea, actualiza, ejecuta y lista [Routines](/docs/es/routines) en claude.ai. Respalda el comando `/schedule`. La [referencia de entrada de `RemoteTrigger`](/docs/es/agent-sdk/typescript#remotetrigger) documenta cada acción y las políticas de organización que eliminan la herramienta. Las Routines viven en claude.ai y requieren un plan Pro, Max, Team o Enterprise, por lo que esta herramienta no es accesible desde Amazon Bedrock, Claude Platform en AWS, Agent Platform de Google Cloud, o Microsoft Foundry | No |

46| `ReportFindings` | Reporta hallazgos de revisión de código como una lista estructurada, con un archivo, resumen y escenario de fallo por hallazgo, para que Claude Code pueda renderizarlos en lugar de imprimirlos como texto. Claude lo llama cuando las instrucciones activas de revisión de código le indican que lo haga. Requiere Claude Code v2.1.196 o posterior. A partir de v2.1.199, un hallazgo también puede llevar un slug `category` opcional, como `correctness` o `test-coverage`, mostrado junto a la ubicación del archivo en la lista renderizada | No |46| `ReportFindings` | Reporta hallazgos de revisión de código como una lista estructurada, con un archivo, resumen y escenario de fallo por hallazgo, para que Claude Code pueda renderizarlos en lugar de imprimirlos como texto. Claude lo llama cuando las instrucciones activas de revisión de código le indican que lo haga. Un hallazgo también puede llevar un slug `category` opcional, como `correctness` o `test-coverage`, mostrado junto a la ubicación del archivo en la lista renderizada | No |

47| `ScheduleWakeup` | Reprograma la siguiente iteración de un [`/loop` autónomo](/docs/es/scheduled-tasks#let-claude-choose-the-interval). Claude lo llama al final de cada iteración para elegir cuándo se ejecuta la siguiente, entre uno y sesenta minutos; no lo llamas directamente. Para terminar el bucle en su lugar, Claude lo llama con `stop: true`, que cancela el wakeup pendiente. El campo `stop` requiere Claude Code v2.1.202 o posterior. El wakeup pendiente aparece en `session_crons` en [Entrada de Stop hook](/docs/es/hooks#stop-input) | No |47| `ScheduleWakeup` | Reprograma la siguiente iteración de un [`/loop` autónomo](/docs/es/scheduled-tasks#let-claude-choose-the-interval). Claude lo llama al final de cada iteración para elegir cuándo se ejecuta la siguiente, entre uno y sesenta minutos; no lo llamas directamente. Para terminar el bucle en su lugar, Claude lo llama con `stop: true`, que cancela el wakeup pendiente. El campo `stop` requiere Claude Code v2.1.202 o posterior. El wakeup pendiente aparece en `session_crons` en [Entrada de Stop hook](/docs/es/hooks#stop-input) | No |

48| `SendFeedback` | Redacta un informe de retroalimentación sobre Claude Code, cubriendo un problema del producto o el comportamiento de Claude en la sesión, y lo pone en cola en tu máquina para que lo revises. Claude Code no envía nada hasta que elijas enviar el borrador. Consulta [Comportamiento de la herramienta SendFeedback](#sendfeedback-tool-behavior). Requiere Claude Code v2.1.238 o posterior | No |48| `SendFeedback` | Redacta un informe de retroalimentación sobre Claude Code, cubriendo un problema del producto o el comportamiento de Claude en la sesión, y lo pone en cola en tu máquina para que lo revises. Claude Code no envía nada hasta que elijas enviar el borrador. Consulta [Comportamiento de la herramienta SendFeedback](#sendfeedback-tool-behavior). Requiere Claude Code v2.1.238 o posterior | No |

49| `SendMessage` | Envía un mensaje a otro agente: un compañero de [equipo de agentes](/docs/es/agent-teams), un [subagente que reanuda](/docs/es/sub-agents#resume-subagents) por ID o nombre de agente, o una de tus otras sesiones de Claude Code, en esta máquina o más allá. La mensajería de otras sesiones requiere Claude Code v2.1.224 o posterior. [Mensajería entre sesiones](/docs/es/cross-session-messaging) cubre qué sesiones puede alcanzar Claude, [cómo se ve un mensaje cuando llega](/docs/es/cross-session-messaging#what-a-message-looks-like), y [cómo Claude recibe un aviso cuando otra sesión se queda inactiva](/docs/es/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude puede incluir una entrada `summary` opcional, típicamente de 5-10 palabras, que Claude Code muestra como una vista previa de una línea. Cuando Claude la omite en un [mensaje de texto plano](/docs/es/cross-session-messaging#limitations), Claude Code usa la primera línea del mensaje como resumen. Claude Code trunca un resumen más largo que 200 caracteres con puntos suspensivos | No |49| `SendMessage` | Envía un mensaje a otro agente: un compañero de [equipo de agentes](/docs/es/agent-teams), un [subagente que reanuda](/docs/es/sub-agents#resume-subagents) por ID o nombre de agente, o una de tus otras sesiones de Claude Code, en esta máquina o más allá. La mensajería de otras sesiones requiere Claude Code v2.1.224 o posterior. [Mensajería entre sesiones](/docs/es/cross-session-messaging) cubre qué sesiones puede alcanzar Claude, [cómo se ve un mensaje cuando llega](/docs/es/cross-session-messaging#what-a-message-looks-like), y [cómo Claude recibe un aviso cuando otra sesión se queda inactiva](/docs/es/cross-session-messaging#get-a-notice-when-another-session-goes-idle). Claude puede incluir una entrada `summary` opcional, típicamente de 5-10 palabras, que Claude Code muestra como una vista previa de una línea. Cuando Claude la omite en un [mensaje de texto plano](/docs/es/cross-session-messaging#limitations), Claude Code usa la primera línea del mensaje como resumen. Claude Code trunca un resumen más largo que 200 caracteres con puntos suspensivos | No |

50| `SendUserFile` | Envía archivos de la sesión a ti con un título opcional, para que un informe generado, diagrama, captura de pantalla o artefacto construido llegue a tu dispositivo en lugar de solo ser mencionado en la transcripción. A partir de v2.1.196, la entrada `display` opcional controla la presentación: `render` abre el archivo en línea en el cliente, `attach` muestra solo una tarjeta de descarga, y cuando no está establecida el cliente decide por tipo de archivo. Disponible cuando un cliente [Remote Control](/docs/es/remote-control) está conectado o en una [sesión en la nube](/docs/es/claude-code-on-the-web). La entrega se ejecuta a través de infraestructura alojada por Anthropic, por lo que la herramienta no está disponible en Amazon Bedrock, Agent Platform de Google Cloud, o Microsoft Foundry | No |50| `SendUserFile` | Envía archivos de la sesión a ti con un título opcional, para que un informe generado, diagrama, captura de pantalla o artefacto construido llegue a tu dispositivo en lugar de solo ser mencionado en la transcripción. La entrada `display` opcional controla la presentación: `render` abre el archivo en línea en el cliente, `attach` muestra solo una tarjeta de descarga, y cuando no está establecida el cliente decide por tipo de archivo. Disponible cuando un cliente [Remote Control](/docs/es/remote-control) está conectado o en una [sesión en la nube](/docs/es/claude-code-on-the-web). La entrega se ejecuta a través de infraestructura alojada por Anthropic, por lo que la herramienta no está disponible en Amazon Bedrock, Agent Platform de Google Cloud, o Microsoft Foundry | No |

51| `ShareOnboardingGuide` | Carga `ONBOARDING.md` y devuelve un enlace de uso compartido que los compañeros de equipo pueden abrir en Claude Code. Llamado desde `/team-onboarding` después de que se escribe la guía. Disponible para suscriptores de claude.ai en los planes Pro, Max, Team y Enterprise | Sí |51| `ShareOnboardingGuide` | Carga `ONBOARDING.md` y devuelve un enlace de uso compartido que los compañeros de equipo pueden abrir en Claude Code. Llamado desde `/team-onboarding` después de que se escribe la guía. Disponible para suscriptores de claude.ai en los planes Pro, Max, Team y Enterprise | Sí |

52| `Skill` | Ejecuta una [skill](/docs/es/skills#control-who-invokes-a-skill) dentro de la conversación principal | Sí |52| `Skill` | Ejecuta una [skill](/docs/es/skills#control-who-invokes-a-skill) dentro de la conversación principal | Sí |

53| `SubagentHandback` | Entrega el informe final de un subagente a cualquier conversación que reciba el resultado de ese subagente. Proporcionado solo en [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode), a subagentes que la herramienta Agent ejecuta localmente que no sean [bifurcaciones](/docs/es/sub-agents#fork-the-current-conversation), y disponible en la CLI de terminal, extensiones de IDE, sesiones en la nube y el Agent SDK; el clasificador revisa el informe antes de que se entregue. Requiere Claude Code v2.1.271 o posterior | No |53| `SubagentHandback` | Entrega el informe final de un subagente a cualquier conversación que reciba el resultado de ese subagente. Proporcionado solo en [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode), a subagentes que la herramienta Agent ejecuta localmente que no sean [bifurcaciones](/docs/es/sub-agents#fork-the-current-conversation), y disponible en la CLI de terminal, extensiones de IDE, sesiones en la nube y el Agent SDK; el clasificador revisa el informe antes de que se entregue. Requiere Claude Code v2.1.271 o posterior | No |


55| `TaskGet` | Recupera detalles completos para una tarea específica. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |55| `TaskGet` | Recupera detalles completos para una tarea específica. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |

56| `TaskList` | Lista todas las tareas con su estado actual. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |56| `TaskList` | Lista todas las tareas con su estado actual. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |

57| `TaskOutput` | Recupera la salida de una tarea en segundo plano. Deprecado a favor de `Read` en la ruta del archivo de salida de la tarea. Cuando ninguna tarea coincide con el ID, el error lista los agentes en segundo plano en ejecución por ID y descripción. Antes de v2.1.203, el error solo nombraba el ID faltante | No |57| `TaskOutput` | Recupera la salida de una tarea en segundo plano. Deprecado a favor de `Read` en la ruta del archivo de salida de la tarea. Cuando ninguna tarea coincide con el ID, el error lista los agentes en segundo plano en ejecución por ID y descripción. Antes de v2.1.203, el error solo nombraba el ID faltante | No |

58| `TaskStop` | Detiene una tarea en segundo plano en ejecución por ID. También acepta un compañero de [equipo de agentes](/docs/es/agent-teams) o un agente en segundo plano nombrado por ID o nombre de agente. Antes de v2.1.198, solo aceptaba un ID de tarea en segundo plano. Cuando ninguna tarea coincide con el ID, el error lista los agentes en segundo plano en ejecución por ID y descripción, incluidos los agentes que otro agente generó. Antes de v2.1.203, el error listaba compañeros de equipo en ejecución y agentes nombrados pero no agentes en segundo plano que otro agente generó, por lo que no podían ser identificados o detenidos desde la conversación principal | No |58| `TaskStop` | Detiene una tarea en segundo plano en ejecución por ID. También acepta un compañero de [equipo de agentes](/docs/es/agent-teams) o un agente en segundo plano nombrado por ID o nombre de agente. Cuando ninguna tarea coincide con el ID, el error lista los agentes en segundo plano en ejecución por ID y descripción, incluidos los agentes que otro agente generó. Antes de v2.1.203, el error listaba compañeros de equipo en ejecución y agentes nombrados pero no agentes en segundo plano que otro agente generó, por lo que no podían ser identificados o detenidos desde la conversación principal | No |

59| `TaskUpdate` | Actualiza el estado de la tarea, dependencias, detalles, o elimina tareas. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |59| `TaskUpdate` | Actualiza el estado de la tarea, dependencias, detalles, o elimina tareas. Proporcionado de forma predeterminada solo en los modelos enumerados en [Disponibilidad de la herramienta Task](#task-tool-availability), y en otros modelos cuando optas por participar | No |

60| `TodoWrite` | Gestiona la lista de verificación de tareas de la sesión. Deshabilitado de forma predeterminada a favor de `TaskCreate`, `TaskGet`, `TaskList` y `TaskUpdate`. Establece `CLAUDE_CODE_ENABLE_TASKS=0` para habilitarlo nuevamente en [sesiones que tienen las herramientas de seguimiento de tareas](#task-tool-availability) | No |60| `TodoWrite` | Gestiona la lista de verificación de tareas de la sesión. Deshabilitado de forma predeterminada a favor de `TaskCreate`, `TaskGet`, `TaskList` y `TaskUpdate`. Establece `CLAUDE_CODE_ENABLE_TASKS=0` para habilitarlo nuevamente en [sesiones que tienen las herramientas de seguimiento de tareas](#task-tool-availability) | No |

61| `ToolSearch` | Busca y carga herramientas diferidas cuando [búsqueda de herramientas](/docs/es/mcp#scale-with-mcp-tool-search) está habilitada | No |61| `ToolSearch` | Busca y carga herramientas diferidas cuando [búsqueda de herramientas](/docs/es/mcp#scale-with-mcp-tool-search) está habilitada | No |


122Dónde ve los solicitudes de permiso de un subagente depende de si se ejecuta en primer plano o en segundo plano. Claude Code ejecuta subagentes en segundo plano de forma predeterminada, aparte de los [casos que se ejecutan en primer plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background).122Dónde ve los solicitudes de permiso de un subagente depende de si se ejecuta en primer plano o en segundo plano. Claude Code ejecuta subagentes en segundo plano de forma predeterminada, aparte de los [casos que se ejecutan en primer plano](/docs/es/sub-agents#run-subagents-in-foreground-or-background).

123 123 

124* **Subagentes en primer plano** muestran los mismos solicitudes de permiso que vería en la conversación principal, en el momento en que ocurre cada llamada a herramienta.124* **Subagentes en primer plano** muestran los mismos solicitudes de permiso que vería en la conversación principal, en el momento en que ocurre cada llamada a herramienta.

125* **Subagentes en segundo plano** muestran solicitudes de permiso en su sesión principal a partir de v2.1.186. El solicitud nombra qué subagente está pidiendo, y presionar Esc deniega esa llamada a herramienta sin detener el subagente. Antes de v2.1.186, los subagentes en segundo plano denegaban automáticamente cualquier llamada a herramienta que de otro modo solicitaría y continuaban sin esa herramienta.125* **Subagentes en segundo plano** muestran solicitudes de permiso en tu sesión principal. La solicitud nombra qué subagente está pidiendo, y presionar Esc deniega esa llamada a herramienta sin detener el subagente.

126 126 

127Para [limitar lo que un subagente puede alcanzar](/docs/es/sub-agents#control-subagent-capabilities) en primer lugar, reduzca su campo `tools`, por ejemplo dejando Bash fuera de la lista, o establezca reglas de denegación en su configuración.127Para [limitar lo que un subagente puede alcanzar](/docs/es/sub-agents#control-subagent-capabilities) en primer lugar, reduzca su campo `tools`, por ejemplo dejando Bash fuera de la lista, o establezca reglas de denegación en su configuración.

128 128 


512 512 

513El mismo comportamiento de reinicio del directorio de trabajo de la sesión principal descrito en la sección de la herramienta Bash se aplica a los comandos de PowerShell, incluida la variable de entorno `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.513El mismo comportamiento de reinicio del directorio de trabajo de la sesión principal descrito en la sección de la herramienta Bash se aplica a los comandos de PowerShell, incluida la variable de entorno `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`.

514 514 

515A partir de v2.1.196, el código de salida 1 de `grep`, `rg`, `egrep`, `fgrep`, `findstr` y `git grep` significa que no hay coincidencias. El código de salida 1 de `git diff` significa que existen diferencias. Ninguno de estos resultados se reporta a Claude como un error de comando. Para `robocopy`, los códigos de salida de 0 a 7 son resultados informativos, como archivos copiados o archivos adicionales detectados. Los códigos de salida de 8 o superior cuentan como errores.515El código de salida 1 de `grep`, `rg`, `egrep`, `fgrep`, `findstr` y `git grep` significa que no hay coincidencias. El código de salida 1 de `git diff` significa que existen diferencias. Ninguno de estos resultados se reporta a Claude como un error de comando. Para `robocopy`, los códigos de salida de 0 a 7 son resultados informativos, como archivos copiados o archivos adicionales detectados. Los códigos de salida de 8 o superior cuentan como errores.

516 516 

517<h3 id="windows-encoding-and-exit-codes">517<h3 id="windows-encoding-and-exit-codes">

518 Codificación de Windows y códigos de salida518 Codificación de Windows y códigos de salida


551 551 

552Read maneja varios tipos de archivo más allá del texto sin formato:552Read maneja varios tipos de archivo más allá del texto sin formato:

553 553 

554* **Imágenes**: PNG, JPG y otros formatos de imagen se devuelven como contenido visual que Claude puede ver, no como bytes sin procesar. Claude Code redimensiona y recomprime imágenes grandes para que se ajusten a los límites de tamaño de imagen del modelo antes de enviarlas, por lo que Claude puede ver una versión reducida de una captura de pantalla grande. A partir de v2.1.196, una imagen que sigue siendo más grande que 500KB después de ese redimensionamiento se recodifica como JPEG con calidad reducida con sus dimensiones de píxeles sin cambios. Si Claude pierde detalles a nivel de píxel fino en una imagen grande, pídale que primero recorte la región de interés, por ejemplo con ImageMagick a través de Bash.554* **Imágenes**: PNG, JPG y otros formatos de imagen se devuelven como contenido visual que Claude puede ver, no como bytes sin procesar. Claude Code redimensiona y recomprime imágenes grandes para que se ajusten a los límites de tamaño de imagen del modelo antes de enviarlas, por lo que Claude puede ver una versión reducida de una captura de pantalla grande. Una imagen que sigue siendo más grande que 500KB después de ese redimensionamiento se recodifica como JPEG con calidad reducida con sus dimensiones de píxeles sin cambios. Si Claude pierde detalles a nivel de píxel fino en una imagen grande, pídele que primero recorte la región de interés, por ejemplo con ImageMagick a través de Bash.

555* **PDFs**: Claude lee archivos `.pdf` cortos completos. Para PDFs más largos que 10 páginas, lee en rangos con un parámetro `pages`, como `"1-5"`, hasta 20 páginas a la vez. Las lecturas de rango de páginas renderizan páginas con `pdftoppm` de poppler-utils, así que instálelo con `brew install poppler` en macOS o `apt-get install poppler-utils` en Debian y Ubuntu. En Windows y otras plataformas, instale una compilación de poppler que ponga `pdftoppm` en su `PATH`. Sin él, una lectura de rango de páginas falla con `pdftoppm is not installed`.555* **PDFs**: Claude lee archivos `.pdf` cortos completos. Para PDFs más largos que 10 páginas, lee en rangos con un parámetro `pages`, como `"1-5"`, hasta 20 páginas a la vez. Las lecturas de rango de páginas renderizan páginas con `pdftoppm` de poppler-utils, así que instálelo con `brew install poppler` en macOS o `apt-get install poppler-utils` en Debian y Ubuntu. En Windows y otras plataformas, instale una compilación de poppler que ponga `pdftoppm` en su `PATH`. Sin él, una lectura de rango de páginas falla con `pdftoppm is not installed`.

556* **Cuadernos Jupyter**: Los archivos `.ipynb` devuelven todas las celdas con sus salidas, incluido código, markdown y visualizaciones. Claude Code se niega a leer un archivo de cuaderno de más de 100 MB; el error le indica a Claude cómo leer una porción del cuaderno en su lugar, como un segmento de celdas, con un comando de shell.556* **Cuadernos Jupyter**: Los archivos `.ipynb` devuelven todas las celdas con sus salidas, incluido código, markdown y visualizaciones. Claude Code se niega a leer un archivo de cuaderno de más de 100 MB; el error le indica a Claude cómo leer una porción del cuaderno en su lugar, como un segmento de celdas, con un comando de shell.

557 557 


603 603 

604Claude Code mantiene su directorio de trabajo en el borrador local para poder encontrar la transcripción, y no envía el directorio.604Claude Code mantiene su directorio de trabajo en el borrador local para poder encontrar la transcripción, y no envía el directorio.

605 605 

606En [organizaciones con retención de datos cero](/docs/es/zero-data-retention#features-disabled-under-zdr), Claude Code deja la herramienta fuera, como lo hace para `/feedback`. Si una sesión en tal organización aún ofrece la herramienta, los borradores permanecen en su máquina, y el envío falla con `Feedback collection is not available for organizations with custom data retention policies.`606En [organizaciones con retención de datos cero](/docs/es/zero-data-retention#features-disabled-under-zdr), y en organizaciones con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, Claude Code deja la herramienta fuera, como lo hace para `/feedback`. Si una sesión en una organización con retención de datos cero aún ofrece la herramienta, los borradores permanecen en tu máquina, y el envío falla con `Feedback collection is not available for organizations with custom data retention policies.`

607 607 

608<h3 id="discard-or-keep-a-draft">608<h3 id="discard-or-keep-a-draft">

609 Descartar o mantener un borrador609 Descartar o mantener un borrador


627* Sesiones en la nube como [Claude Code en la web](/docs/es/claude-code-on-the-web), que no pueden escribir en la cola en su máquina627* Sesiones en la nube como [Claude Code en la web](/docs/es/claude-code-on-the-web), que no pueden escribir en la cola en su máquina

628* Sesiones en [Amazon Bedrock](/docs/es/amazon-bedrock), [Claude Platform en AWS](/docs/es/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), o [Microsoft Foundry](/docs/es/microsoft-foundry)628* Sesiones en [Amazon Bedrock](/docs/es/amazon-bedrock), [Claude Platform en AWS](/docs/es/claude-platform-on-aws), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai), o [Microsoft Foundry](/docs/es/microsoft-foundry)

629* Sesiones donde establece [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/es/env-vars) o [`DISABLE_FEEDBACK_COMMAND=1`](/docs/es/env-vars), establece `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` en cualquier valor no vacío, o desactivó la [obtención de indicadores de características](/docs/es/env-vars#features-that-need-feature-flag-fetching)629* Sesiones donde establece [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/es/env-vars) o [`DISABLE_FEEDBACK_COMMAND=1`](/docs/es/env-vars), establece `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` en cualquier valor no vacío, o desactivó la [obtención de indicadores de características](/docs/es/env-vars#features-that-need-feature-flag-fetching)

630* Organizaciones que han desactivado comentarios de productos, y [organizaciones con retención de datos cero](/docs/es/zero-data-retention#features-disabled-under-zdr)630* Organizaciones que han desactivado los comentarios de productos, [organizaciones con retención de datos cero](/docs/es/zero-data-retention#features-disabled-under-zdr) y organizaciones con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada

631 631 

632<h2 id="task-tool-availability">632<h2 id="task-tool-availability">

633 Disponibilidad de la herramienta Task633 Disponibilidad de la herramienta Task

ultrareview.md +1 −1

Details

18* **Cobertura más amplia**: una flota más grande de agentes revisores explora el cambio en paralelo, lo que expone problemas que una revisión local podría perder18* **Cobertura más amplia**: una flota más grande de agentes revisores explora el cambio en paralelo, lo que expone problemas que una revisión local podría perder

19* **Sin uso de recursos locales**: la revisión se ejecuta completamente en un sandbox en la nube, por lo que su terminal permanece libre para otro trabajo mientras se ejecuta19* **Sin uso de recursos locales**: la revisión se ejecuta completamente en un sandbox en la nube, por lo que su terminal permanece libre para otro trabajo mientras se ejecuta

20 20 

21Ultrareview requiere autenticación con una cuenta de claude.ai porque se ejecuta como una sesión en la nube en la infraestructura de Anthropic. Si ha iniciado sesión solo con una clave API, ejecute `/login` y autentica con claude.ai primero. Ultrareview no está disponible cuando se usa Claude Code con Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, y no está disponible para organizaciones que han habilitado Zero Data Retention. Cuando ultrareview no está disponible, `/code-review ultra` ejecuta una revisión local en su sesión en su lugar.21Ultrareview requiere autenticación con una cuenta de claude.ai porque se ejecuta como una sesión en la nube en la infraestructura de Anthropic. Si iniciaste sesión solo con una clave de API, ejecuta `/login` y autentícate primero con claude.ai. Ultrareview no está disponible cuando se usa Claude Code con Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, y no está disponible para organizaciones que han habilitado Zero Data Retention o que tienen aplicada la [configuración HIPAA](/docs/es/hipaa-setup). Cuando ultrareview no está disponible, `/code-review ultra` ejecuta en su lugar una revisión local en tu sesión.

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 Ejecuta ultrareview desde la CLI24 Ejecuta ultrareview desde la CLI

Details

8 8 

9Hable sus indicaciones en lugar de escribirlas en la CLI de Claude Code. Su voz se transcribe en vivo en la entrada de indicaciones, por lo que puede mezclar voz y escritura en el mismo mensaje. Habilite el dictado con `/voice`, luego mantenga presionada una tecla mientras habla o toque una vez para comenzar y nuevamente para enviar.9Hable sus indicaciones en lugar de escribirlas en la CLI de Claude Code. Su voz se transcribe en vivo en la entrada de indicaciones, por lo que puede mezclar voz y escritura en el mismo mensaje. Habilite el dictado con `/voice`, luego mantenga presionada una tecla mientras habla o toque una vez para comenzar y nuevamente para enviar.

10 10 

11El dictado también funciona en [vista de agente](/docs/es/agent-view#peek-and-reply). Mantenga presionada o toque su tecla de micrófono mientras la entrada de envío o una respuesta del panel de vista previa esté enfocada para dictar a una sesión en segundo plano.11En el [modo de mantener presionado](#hold-to-record), el dictado también funciona en la [vista de agente](/docs/es/agent-view#peek-and-reply). Mantén presionada tu tecla de pulsar para hablar mientras la entrada de envío o una respuesta del panel de vista previa esté enfocada para dictar a una sesión en segundo plano.

12 12 

13<h2 id="requirements">13<h2 id="requirements">

14 Requisitos14 Requisitos

Details

103Si ya conectaste GitHub en el navegador, `/web-setup` te advierte que continuar reemplaza esa conexión para tus sesiones en la nube.103Si ya conectaste GitHub en el navegador, `/web-setup` te advierte que continuar reemplaza esa conexión para tus sesiones en la nube.

104 104 

105<Note>105<Note>

106 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada no pueden usar `/web-setup` u otras características de sesión en la nube. Si la CLI de GitHub no está instalada o no está autenticada, Claude Code abre el flujo de incorporación del navegador en su lugar.106 Las organizaciones con [Retención de datos cero](/docs/es/zero-data-retention) habilitada, o con la [configuración HIPAA](/docs/es/hipaa-setup) aplicada, no pueden usar `/web-setup` u otras características de sesión en la nube. Si la CLI de GitHub no está instalada o no está autenticada, Claude Code abre el flujo de incorporación del navegador en su lugar.

107</Note>107</Note>

108 108 

109<Steps>109<Steps>


264El comando también está oculto en otros dos casos:264El comando también está oculto en otros dos casos:

265 265 

266* Un administrador ha deshabilitado sesiones en la nube para su organización. En este caso, enviar `/web-setup` devuelve [`Cloud sessions are disabled by your organization's policy`](/docs/es/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Antes de v2.1.268, este caso también devolvía `Unknown command: /web-setup`.266* Un administrador ha deshabilitado sesiones en la nube para su organización. En este caso, enviar `/web-setup` devuelve [`Cloud sessions are disabled by your organization's policy`](/docs/es/errors#cloud-sessions-are-disabled-by-your-organizations-policy). Antes de v2.1.268, este caso también devolvía `Unknown command: /web-setup`.

267* Su organización Enterprise tiene [Zero Data Retention](/docs/es/zero-data-retention) habilitado, lo que hace que las sesiones en la nube no estén disponibles.267* Tu organización Enterprise tiene [Zero Data Retention](/docs/es/zero-data-retention) habilitado, o tiene aplicada la [configuración HIPAA](/docs/es/hipaa-setup). Cualquiera de las dos hace que las sesiones en la nube no estén disponibles.

268 268 

269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">

270 "No se pudo crear un entorno en la nube" o "No hay entorno en la nube disponible" al usar `--cloud`270 "No se pudo crear un entorno en la nube" o "No hay entorno en la nube disponible" al usar `--cloud`

workflows.md +6 −6

Details

49 </Step>49 </Step>

50 50 

51 <Step title="Permitir flujos de trabajo">51 <Step title="Permitir flujos de trabajo">

52 Claude Code pregunta si permitir el flujo de trabajo. Seleccione **Sí** para continuar. El mensaje exacto depende de su modo de permisos. Consulte [Aprobar el plan antes de que se ejecute](#approve-the-plan-before-it-runs) para las opciones por modo.52 Claude Code pregunta si permitir el flujo de trabajo. Selecciona **Sí** para continuar. La solicitud exacta depende de tu modo de permisos. Consulta [Aprobar el plan antes de que se ejecute](#approve-the-plan-before-it-runs) para ver las opciones por modo.

53 </Step>53 </Step>

54 54 

55 <Step title="Ver el progreso">55 <Step title="Ver el progreso">

56 La ejecución comienza en segundo plano. Ejecute `/workflows`, use las teclas de flecha para seleccionar la ejecución y presione Intro para abrir su vista de progreso:56 La ejecución comienza en segundo plano. Ejecuta `/workflows` para abrir su vista de progreso:

57 57 

58 ```text wrap theme={null}58 ```text wrap theme={null}

59 /workflows59 /workflows

60 ```60 ```

61 61 

62 La vista muestra cada fase con su recuento de agentes, total de tokens y tiempo transcurrido. Profundice en cualquier fase para ver sus agentes y lo que cada uno encontró. Consulte [Ver la ejecución](#watch-the-run) para el conjunto completo de controles.62 Si `/workflows` muestra en cambio una lista de ejecuciones, selecciona la ejecución que acabas de iniciar y presiona Intro. La vista muestra cada fase con su recuento de agentes. Profundiza en cualquier fase para ver sus agentes y lo que cada uno encontró. Consulta [Ver la ejecución](#watch-the-run) para el conjunto completo de controles.

63 63 

64 También puede ver desde el panel de tareas debajo del cuadro de entrada: aparece un resumen de progreso de una línea mientras se ejecuta. Presione la flecha hacia abajo para enfocarlo y luego Intro para expandirlo.64 También puede ver desde el panel de tareas debajo del cuadro de entrada: aparece un resumen de progreso de una línea mientras se ejecuta. Presione la flecha hacia abajo para enfocarlo y luego Intro para expandirlo.

65 </Step>65 </Step>


91 Ver la ejecución91 Ver la ejecución

92</h3>92</h3>

93 93 

94Los flujos de trabajo se ejecutan en segundo plano, por lo que la sesión permanece receptiva mientras los agentes trabajan. Ejecute `/workflows` en cualquier momento para enumerar los flujos de trabajo en ejecución y completados, luego seleccione uno para abrir su vista de progreso. Para detener un flujo de trabajo en ejecución sin abrirlo, selecciónelo en la lista y presione `x`.94Los flujos de trabajo se ejecutan en segundo plano, por lo que la sesión permanece receptiva mientras los agentes trabajan. Ejecuta `/workflows` en cualquier momento para enumerar los flujos de trabajo en ejecución y completados, y luego selecciona uno para abrir su vista de progreso. Cuando la sesión tiene una sola ejecución, `/workflows` omite la lista y abre esa ejecución. Para detener un flujo de trabajo en ejecución desde la lista sin abrirlo, selecciónalo y presiona `x`.

95 95 

96La vista de progreso muestra cada fase con sus recuentos de agentes, totales de tokens y tiempo transcurrido. El pie de página enumera la tecla para cada acción:96La vista de progreso muestra cada fase con sus recuentos de agentes. El pie de página enumera la tecla para cada acción:

97 97 

98| Tecla | Acción |98| Tecla | Acción |

99| :- | :- |99| :- | :- |


192* **View raw script**: lee el script antes de decidir192* **View raw script**: lee el script antes de decidir

193* **No**: cancelar193* **No**: cancelar

194 194 

195`Ctrl+G` abre el script en su editor. `Tab` le permite ajustar el prompt antes de que comience la ejecución.195`Ctrl+G` abre el script en tu editor. Con **Yes, run it** o **No** seleccionado, presiona `Tab` para [agregar un comentario](/docs/es/permissions#add-a-comment-when-you-answer-a-permission-prompt) a tu respuesta.

196 196 

197Si ve este prompt depende de su [modo de permiso](/docs/es/permission-modes):197Si ve este prompt depende de su [modo de permiso](/docs/es/permission-modes):

198 198 

Details

4 4 

5# Retención cero de datos5# Retención cero de datos

6 6 

7> Obtenga información sobre la Retención Cero de Datos (ZDR) para Claude Code, disponible para cuentas calificadas en Claude for Enterprise, incluido el alcance, las características deshabilitadas y cómo solicitar la habilitación.7> Obtén información sobre la Retención Cero de Datos (ZDR) para Claude Code, disponible para cuentas calificadas en Claude for Enterprise, incluido el alcance, las características deshabilitadas y cómo solicitar la habilitación.

8 8 

9La Retención Cero de Datos (ZDR) para Claude Code está disponible para cuentas calificadas en Claude for Enterprise. Cuando ZDR está habilitado, los prompts y las respuestas del modelo generadas durante las sesiones de Claude Code se procesan en tiempo real y no se almacenan por Anthropic después de que se devuelve la respuesta, excepto cuando es necesario para cumplir con la ley o combatir el uso indebido.9La Retención Cero de Datos (ZDR) para Claude Code está disponible para cuentas calificadas en Claude for Enterprise. Cuando ZDR está habilitado, los prompts y las respuestas del modelo generadas durante las sesiones de Claude Code se procesan en tiempo real y no se almacenan por Anthropic después de que se devuelve la respuesta, excepto cuando es necesario para cumplir con la ley o combatir el uso indebido.

10 10 

11<Note>11<Note>

12 ZDR no está incluido en el plan estándar de Claude for Enterprise y no se puede habilitar desde la configuración de administrador. Está disponible para cuentas calificadas y requiere habilitación separada por Anthropic. Si su organización requiere ZDR, [póngase en contacto con ventas](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request) o con su equipo de cuenta de Anthropic para confirmar la elegibilidad.12 ZDR no está incluido en el plan estándar de Claude for Enterprise y no se puede habilitar desde tu configuración de administrador. Está disponible para cuentas calificadas y requiere habilitación separada por Anthropic. Si tu organización requiere ZDR, [ponte en contacto con ventas](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request) o con tu equipo de cuenta de Anthropic para confirmar la elegibilidad.

13</Note>13</Note>

14 14 

15Las organizaciones de Claude for Enterprise que han habilitado HIPAA pueden incluir la CLI de Claude Code y la pestaña Code en Claude Desktop bajo su Acuerdo de Asociado Comercial (BAA) sin ZDR una vez que la configuración de HIPAA se aplica a Claude Code (modo local) y Cowork (modo local). Consulta [Configurar Claude Code (modo local) para una organización preparada para HIPAA](/docs/es/hipaa-setup). Las organizaciones sin la configuración de HIPAA siguen necesitando ZDR para la cobertura del BAA de Claude Code. Consulta la [Guía de implementación](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver una lista de Servicios elegibles.

16 

15ZDR en Claude for Enterprise proporciona a los clientes empresariales la capacidad de usar Claude Code con retención cero de datos y acceso a capacidades administrativas:17ZDR en Claude for Enterprise proporciona a los clientes empresariales la capacidad de usar Claude Code con retención cero de datos y acceso a capacidades administrativas:

16 18 

17* Controles de costos por usuario19* Controles de costos por usuario


19* [Configuración administrada por servidor](/docs/es/server-managed-settings)21* [Configuración administrada por servidor](/docs/es/server-managed-settings)

20* Registros de auditoría22* Registros de auditoría

21 23 

22ZDR para Claude Code en Claude for Enterprise se aplica solo a la plataforma directa de Anthropic. Para implementaciones de Claude en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, consulte las políticas de retención de datos de esas plataformas.24ZDR para Claude Code en Claude for Enterprise se aplica solo a la plataforma directa de Anthropic. Para despliegues de Claude en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, consulta las políticas de retención de datos de esas plataformas.

23 25 

24<h2 id="zdr-scope">26<h2 id="zdr-scope">

25 Alcance de ZDR27 Alcance de ZDR