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

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

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:

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(

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>

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>

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 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.

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 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.

244 244 

245Use `↑` y `↓` para ver sesiones adyacentes sin cerrar el panel, o `→` para adjuntarse.245Use `↑` y `↓` para ver sesiones adyacentes sin cerrar el panel, o `→` para adjuntarse.

246 246 

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">

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.

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">

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. |

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 

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` |

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.

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.

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

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). |

823 Configuración empresarial823 Configuración empresarial

824</h2>824</h2>

825 825 

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.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 administrada y políticas de gestión de dispositivos.

827 827 

828<h3 id="admin-console-controls">828<h3 id="admin-console-controls">

829 Controles de consola de administración829 Controles de consola de administración

830</h3>830</h3>

831 831 

832Estas configuraciones se configuran a través de la [consola de configuración de administración](https://claude.ai/admin-settings/claude-code):832Estas configuraciones se establecen a través de la [consola de configuración de administración](https://claude.ai/admin-settings/claude-code):

833 833 

834* **Code in the desktop**: controle si los usuarios en su organización pueden acceder a Claude Code en la aplicación de escritorio834* **Desktop**: controla si los usuarios de tu organización pueden acceder a Claude Code en la aplicación de escritorio

835* **Code in the web**: habilite o deshabilite [sesiones en la nube](/docs/es/claude-code-on-the-web) para su organización835* **Cloud sessions**: habilita o deshabilita las [sesiones en la nube](/docs/es/claude-code-on-the-web) para tu organización

836* **Remote Control**: habilite o deshabilite [Remote Control](/docs/es/remote-control) para su organización836* **Remote Control**: habilita o deshabilita [Remote Control](/docs/es/remote-control) para tu organización

837* **Disable Bypass permissions mode**: evite que los usuarios en su organización habiliten el modo bypass permissions837 

838En 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.

838 839 

839<Note>840<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).841 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 842 

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).843 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>844</Note>

844 845 

845<h3 id="managed-settings">846<h3 id="managed-settings">

846 Configuración administrada847 Configuración administrada

847</h3>848</h3>

848 849 

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.850La 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 851 

851| Clave | Descripción |852| Clave | Descripción |

852| - | - |853| - | - |

853| `permissions.disableBypassPermissionsMode` | establezca en `"disable"` para evitar que los usuarios habiliten el modo bypass permissions. |854| `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`. |855| `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). |856| `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. |857| `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. |858| `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. |859| `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. |860| `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. |861| `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. |862| `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. |863| `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 864 

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).865Qué 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 866 

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.867* **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.868* **[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.869* **[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.870* **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 871 

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.872En 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 873 

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.874`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 875 

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).876Para 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 877 

877<h3 id="device-management-policies">878<h3 id="device-management-policies">

878 Políticas de gestión de dispositivos879 Políticas de gestión de dispositivos

879</h3>880</h3>

880 881 

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.882Los 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 883 

883* **macOS**: configure a través del dominio de preferencia `com.anthropic.claudefordesktop` usando herramientas como Jamf o Kandji884* **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`885* **Windows**: configura a través del registro en `SOFTWARE\Policies\Claude`

885 886 

886<h3 id="network-access-requirements">887<h3 id="network-access-requirements">

887 Requisitos de acceso a la red888 Requisitos de acceso a la red

888</h3>889</h3>

889 890 

890Desktop carga su código de aplicación y contenido de usuario desde hosts de CDN de Anthropic.891Desktop carga su código de aplicación y el contenido de usuario desde hosts de CDN de Anthropic.

891 892 

892```text theme={null}893```text theme={null}

893anthropic.com894anthropic.com

902*.claudemcpcontent.com903*.claudemcpcontent.com

903```904```

904 905 

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.906El 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 907 

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).908Para 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 909 

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.910Para 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 911 

911```text theme={null}912```text theme={null}

912anthropic.com913anthropic.com

928*.claudemcpcontent.com929*.claudemcpcontent.com

929```930```

930 931 

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.932Si 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 933 

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.934Anthropic 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 935 

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.936Un [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 937 

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.938Los 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 939 

939<h3 id="authentication-and-sso">940<h3 id="authentication-and-sso">

940 Autenticación y SSO941 Autenticación y SSO

941</h3>942</h3>

942 943 

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).944Las 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 945 

945<h3 id="data-handling">946<h3 id="data-handling">

946 Manejo de datos947 Manejo de datos

947</h3>948</h3>

948 949 

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.950Claude 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 951 

951<h3 id="deployment">952<h3 id="deployment">

952 Implementación953 Despliegue

953</h3>954</h3>

954 955 

955Desktop se puede distribuir a través de herramientas de implementación empresarial:956Desktop se puede distribuir a través de herramientas de despliegue empresarial:

956 957 

957* **macOS**: distribuya a través de MDM como Jamf o Kandji usando el instalador `.dmg`958* **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 silenciosa959* **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 960 

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).961Para 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 962 

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).963Para 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 964 

964<h2 id="coming-from-the-cli">965<h2 id="coming-from-the-cli">

965 ¿Viene de la CLI?966 ¿Viene de la CLI?

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 |

303 303 

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.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.

305 305 

306En las organizaciones Enterprise que tienen aplicada la [configuración HIPAA](/docs/es/hipaa-setup), algunas características de esta tabla están desactivadas.

307 

306| Característica | Pro | Max | Team | Enterprise |308| Característica | Pro | Max | Team | Enterprise |

307| :- | :- | :- | :- | :- |309| :- | :- | :- | :- | :- |

308| [Cloud sessions](/docs/es/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |310| [Cloud sessions](/docs/es/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

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 

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 

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 |

46 Cumplimiento de atención médica (BAA)46 Cumplimiento de atención médica (BAA)

47</h3>47</h3>

48 48 

49Si un cliente ha ejecutado un Acuerdo de Asociado de Negocios (BAA) con Anthropic y tiene [Retención de datos cero (ZDR)](/docs/es/zero-data-retention) habilitada para la organización relevante, ese BAA se extiende al tráfico de API del cliente a través de Claude Code.49Si un cliente ha ejecutado un Acuerdo de Asociado de Negocios (BAA) con Anthropic, ese BAA se extiende a Claude Code en dos configuraciones, según lo que esté disponible para tu organización:

50 

51* **Configuración HIPAA**: la CLI de Claude Code o la pestaña Code en Claude Desktop, usadas con una cuenta de Claude for Enterprise. La organización debe tener HIPAA habilitado y la configuración HIPAA aplicada 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).

52* **Retención de datos cero**: Claude Code con [Retención de datos cero (ZDR)](/docs/es/zero-data-retention) habilitada para la organización relevante. ZDR no está disponible para todas las organizaciones.

53 

54Bajo la configuración HIPAA, las sesiones en la nube, Remote Control, Claude Code en la aplicación móvil de Claude y Claude Code enrutado a través de un proveedor de nube de terceros o un gateway no están cubiertos. Revisa la [Guía de implementación](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver la lista completa de Servicios elegibles.

50 55 

51<h2 id="usage-policy">56<h2 id="usage-policy">

52 Política de uso57 Política de uso

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 ```

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 cargarse al iniciar, se incluyen cuando Claude lee archivos en esos subdirectorios. Un `CLAUDE.md` de subdirectorio que Claude ya leyó, escribió o editó con la herramienta Read, Write o Edit no se carga de esta manera, porque su contenido ya está 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 

623 Ver y editar con `/memory`623 Ver y editar con `/memory`

624</h2>624</h2>

625 625 

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`.626El 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 627 

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.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.

629 629 

633 Solucionar problemas de memoria633 Solucionar problemas de memoria

634</h2>634</h2>

635 635 

636Estos son los problemas más comunes con CLAUDE.md y auto memory, junto con pasos para depurarlos.636Estos son los problemas más comunes con CLAUDE.md y la memoria automática, junto con pasos para depurarlos.

637 637 

638<h3 id="claude-isn’t-following-my-claude-md">638<h3 id="claude-isn’t-following-my-claude-md">

639 Claude no está siguiendo mi CLAUDE.md639 Claude no está siguiendo mi CLAUDE.md

643 643 

644Para depurar:644Para depurar:

645 645 

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.646* 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)).647* 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".648* 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.649* 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).650* Busca instrucciones conflictivas en archivos CLAUDE.md. Si dos archivos dan orientación diferente para el mismo comportamiento, Claude puede elegir uno arbitrariamente.

651* 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 652 

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.653Si 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 654 

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).655Para 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 656 

656<Tip>657<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.658 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>659</Tip>

659 660 

660<h3 id="my-agents-md-isn’t-loading">661<h3 id="my-agents-md-isn’t-loading">

661 Mi AGENTS.md no se está cargando662 Mi AGENTS.md no se está cargando

662</h3>663</h3>

663 664 

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:665Si 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 666 

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`.6671. 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.6682. 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).6693. 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 670 

670Para verificar si Claude leyó su `AGENTS.md`, ejecute `/memory` y busque su ruta en la lista.671Para verificar si Claude leyó tu `AGENTS.md`, ejecuta `/memory` y busca su ruta en la lista.

671 672 

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.673Antes 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 674 

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).675Si 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 676 

676<h3 id="i-don’t-know-what-auto-memory-saved">677<h3 id="i-don’t-know-what-auto-memory-saved">

677 No sé qué guardó auto memory678 No sé qué guardó la memoria automática

678</h3>679</h3>

679 680 

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.681Ejecuta `/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 682 

682<h3 id="my-claude-md-is-too-large">683<h3 id="my-claude-md-is-too-large">

683 Mi CLAUDE.md es demasiado grande684 Mi CLAUDE.md es demasiado grande

684</h3>685</h3>

685 686 

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.687Los 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 688 

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.689Si 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 690 

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.691La 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 692 

693 Las instrucciones parecen perdidas después de `/compact`694 Las instrucciones parecen perdidas después de `/compact`

694</h3>695</h3>

695 696 

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.697El 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 recargan cuando Claude lee archivos a los que se aplican.

697 698 

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.699Si 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 700 

700Consulte [Escriba instrucciones efectivas](#write-effective-instructions) para obtener orientación sobre tamaño, estructura y especificidad.701Consulta [Escribe instrucciones efectivas](#write-effective-instructions) para obtener orientación sobre tamaño, estructura y especificidad.

701 702 

702<h2 id="related-resources">703<h2 id="related-resources">

703 Recursos relacionados704 Recursos relacionados

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

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

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`.

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)

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">

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 

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

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 

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, cuando Claude lee por primera vez un archivo coincidente. 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

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": {

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

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