Documentation — Spybara

agent-sdk/hooks.md +21 −17

Details

9Los hooks son funciones de devolución de llamada que ejecutan su código en respuesta a eventos del agente, como una herramienta siendo llamada, una sesión iniciándose, o la ejecución deteniéndose. Con hooks, puede:9Los hooks son funciones de devolución de llamada que ejecutan su código en respuesta a eventos del agente, como una herramienta siendo llamada, una sesión iniciándose, o la ejecución deteniéndose. Con hooks, puede:

10 10

11* **Bloquear operaciones peligrosas** antes de que se ejecuten, como comandos de shell destructivos o acceso a archivos no autorizado11* **Bloquear operaciones peligrosas** antes de que se ejecuten, como comandos de shell destructivos o acceso a archivos no autorizado

~~12* **Registrar y auditar** cada llamada de herramienta para cumplimiento, depuración o análisis~~12* **Registrar y auditar** las llamadas a herramientas para cumplimiento, depuración o análisis

13* **Transformar entradas y salidas** para sanitizar datos, inyectar credenciales o redirigir rutas de archivos13* **Transformar entradas y salidas** para sanitizar datos, inyectar credenciales o redirigir rutas de archivos

14* **Requerir aprobación humana** para acciones sensibles como escrituras en bases de datos o llamadas a API14* **Requerir aprobación humana** para acciones sensibles como escrituras en bases de datos o llamadas a API

15* **Rastrear el ciclo de vida de la sesión** para gestionar estado, limpiar recursos o enviar notificaciones15* **Rastrear el ciclo de vida de la sesión** para gestionar estado, limpiar recursos o enviar notificaciones

40 </Step>40 </Step>

41</Steps>41</Steps>

42 42

43El siguiente ejemplo reúne estos pasos. Registra un hook `PreToolUse` (paso 1) con un matcher `"Write|Edit"` (paso 3) para que la devolución de llamada solo se dispare para herramientas de escritura de archivos. Cuando se activa, la devolución de llamada recibe la entrada de la herramienta (paso 4), verifica si la ruta del archivo apunta a un archivo `.env`, y devuelve `permissionDecision: "deny"` para bloquear la operación (paso 5):43Este ejemplo registra un hook `PreToolUse` (paso 1) con un matcher `"Write|Edit"` (paso 3) para que la devolución de llamada se dispare para las herramientas Write y Edit. Cuando se activa, la devolución de llamada recibe la entrada de la herramienta (paso 4), verifica si la ruta del archivo apunta a un archivo `.env`, y devuelve `permissionDecision: "deny"` para bloquear la operación (paso 5):

44 44

45<CodeGroup>45<CodeGroup>

46 ```python Python theme={null}46 ```python Python theme={null}

61 file_name = file_path.split("/")[-1]61 file_name = file_path.split("/")[-1]

62 62

63 # Block the operation if targeting a .env file63 # Block the operation if targeting a .env file

~~64 if file_name == ".env":~~64 if file_name.lower() == ".env":

65 return {65 return {

66 "hookSpecificOutput": {66 "hookSpecificOutput": {

67 "hookEventName": input_data["hook_event_name"],67 "hookEventName": input_data["hook_event_name"],

108 const fileName = filePath?.split("/").pop();108 const fileName = filePath?.split("/").pop();

109 109

110 // Block the operation if targeting a .env file110 // Block the operation if targeting a .env file

111 if (fileName === ".env") {111 if (fileName?.toLowerCase() === ".env") {

112 return {112 return {

113 hookSpecificOutput: {113 hookSpecificOutput: {

114 hookEventName: preInput.hook_event_name,114 hookEventName: preInput.hook_event_name,

140 ```140 ```

141</CodeGroup>141</CodeGroup>

142 142

143Cuando ejecutas cualquiera de los scripts, Claude intenta crear el archivo `.env` y el hook niega la llamada a herramienta.143El hook niega una llamada a Write o Edit cuyo `file_path` termina en `/.env`, sin importar mayúsculas o minúsculas. En Windows, `file_path` usa barras invertidas, como `C:\project\.env`, y este hook permite una llamada a Write o Edit sobre `C:\project\.env`.

144

145<Warning>

146 El matcher `Write|Edit` limita este hook a las herramientas Write y Edit. Si Claude escribe `.env` con un comando de Bash, el hook no se ejecuta. Para bloquear escrituras de Bash en un archivo donde [se ejecuta el sandbox](/docs/es/sandboxing), consulta la configuración del sandbox para [Python](/docs/es/agent-sdk/python#sandbox-configuration) o [TypeScript](/docs/es/agent-sdk/typescript#sandbox-configuration).

147</Warning>

144 148

145<h2 id="available-hooks">149<h2 id="available-hooks">

146 Hooks disponibles150 Hooks disponibles

152| - | - | - | - | - |156| - | - | - | - | - |

153| `PreToolUse` | Sí | Sí | Solicitud de llamada de herramienta (puede bloquear o modificar) | Bloquear comandos de shell peligrosos |157| `PreToolUse` | Sí | Sí | Solicitud de llamada de herramienta (puede bloquear o modificar) | Bloquear comandos de shell peligrosos |

154| `PostToolUse` | Sí | Sí | Resultado de ejecución de herramienta | Registrar todos los cambios de archivo en pista de auditoría |158| `PostToolUse` | Sí | Sí | Resultado de ejecución de herramienta | Registrar los cambios de archivo en una pista de auditoría |

155| `PostToolUseFailure` | Sí | Sí | Fallo de ejecución de herramienta | Manejar o registrar errores de herramienta |159| `PostToolUseFailure` | Sí | Sí | Fallo de ejecución de herramienta | Manejar o registrar errores de herramienta |

156| `PostToolBatch` | No | Sí | Un lote completo de llamadas de herramienta se resuelve, una vez por lote antes de la siguiente llamada del modelo | Inyectar convenciones una vez para todo el lote |160| `PostToolBatch` | No | Sí | Un lote completo de llamadas de herramienta se resuelve, una vez por lote antes de la siguiente llamada del modelo | Inyectar convenciones una vez para todo el lote |

157| [`UserPromptSubmit`](/docs/es/hooks#userpromptsubmit) | Sí | Sí | Se envía un prompt, incluido un turno que Claude Code inicia por sí mismo | Inyectar contexto adicional en los prompts |161| [`UserPromptSubmit`](/docs/es/hooks#userpromptsubmit) | Sí | Sí | Se envía un prompt, incluido un turno que Claude Code inicia por sí mismo | Inyectar contexto adicional en los prompts |

236| `timeout` | `number` | `undefined` | Tiempo de espera en segundos. Cuando se omite, Claude Code aplica el [tiempo de espera predeterminado del evento](#hook-timeout). Tus devoluciones de llamada del SDK siguen los valores predeterminados del hook `command` |240| `timeout` | `number` | `undefined` | Tiempo de espera en segundos. Cuando se omite, Claude Code aplica el [tiempo de espera predeterminado del evento](#hook-timeout). Tus devoluciones de llamada del SDK siguen los valores predeterminados del hook `command` |

237 241

238Usa el patrón `matcher` para dirigirte a herramientas específicas siempre que sea posible. Un matcher con `'Bash'` solo se ejecuta para comandos Bash, mientras que omitir el patrón ejecuta tus devoluciones de llamada para cada ocurrencia del evento. Omítelo a propósito para registrar cada llamada a herramienta que realiza tu sesión.242Usa el patrón `matcher` para dirigirte a herramientas específicas siempre que sea posible. Un matcher con `'Bash'` solo se ejecuta para comandos Bash, mientras que omitir el patrón ejecuta tus devoluciones de llamada para cada ocurrencia del evento.

239 243

240<h3 id="callback-functions">244<h3 id="callback-functions">

241 Funciones de devolución de llamada245 Funciones de devolución de llamada

268Devuelve `{}` para permitir la operación sin cambios. Los hooks de devolución de llamada del SDK usan el mismo formato de salida JSON que [hooks de comandos de shell de Claude Code](/docs/es/hooks#json-output), que documenta cada campo y opción específica del evento. Para las definiciones de tipo del SDK, consulta las referencias del SDK de [TypeScript](/docs/es/agent-sdk/typescript#synchookjsonoutput) y [Python](/docs/es/agent-sdk/python#synchookjsonoutput).272Devuelve `{}` para permitir la operación sin cambios. Los hooks de devolución de llamada del SDK usan el mismo formato de salida JSON que [hooks de comandos de shell de Claude Code](/docs/es/hooks#json-output), que documenta cada campo y opción específica del evento. Para las definiciones de tipo del SDK, consulta las referencias del SDK de [TypeScript](/docs/es/agent-sdk/typescript#synchookjsonoutput) y [Python](/docs/es/agent-sdk/python#synchookjsonoutput).

269 273

270<Note>274<Note>

271 Cuando se aplican múltiples hooks o reglas de permisos, `deny` tiene prioridad sobre `defer`, que tiene prioridad sobre `ask`, que tiene prioridad sobre `allow`. Si algún hook devuelve `deny`, la operación se bloquea independientemente de otros hooks.275 Cuando varios hooks `PreToolUse` devuelven [decisiones](/docs/es/hooks#pretooluse-decision-control) diferentes, `deny` tiene prioridad sobre `defer`, que tiene prioridad sobre `ask`, que tiene prioridad sobre `allow`.

272</Note>276</Note>

273 277

274<h4 id="asynchronous-output">278<h4 id="asynchronous-output">

313 Modificar entrada de herramienta317 Modificar entrada de herramienta

314</h3>318</h3>

315 319

316Este ejemplo intercepta llamadas de herramienta Write y reescribe el argumento `file_path` para anteponer `/sandbox`, redirigiendo todas las escrituras de archivo a un directorio aislado. La devolución de llamada devuelve `updatedInput` con la ruta modificada y `permissionDecision: 'allow'` para aprobar automáticamente la operación reescrita:320Este ejemplo intercepta llamadas a la herramienta Write y reescribe el argumento `file_path` para anteponer `/sandbox`. La devolución de llamada devuelve `updatedInput` con la ruta modificada y `permissionDecision: 'allow'` para aprobar automáticamente la operación reescrita:

317 321

318<CodeGroup>322<CodeGroup>

319 ```python Python theme={null}323 ```python Python theme={null}

370 Agregar contexto y bloquear una herramienta374 Agregar contexto y bloquear una herramienta

371</h3>375</h3>

372 376

373Este ejemplo bloquea escrituras en el directorio `/etc` y explica por qué tanto al modelo como al usuario:377Este ejemplo deniega las llamadas a herramientas cuyo `file_path` comienza con `/etc` y explica por qué tanto al modelo como al usuario:

374 378

375* `permissionDecision: 'deny'` detiene la llamada de herramienta.379* `permissionDecision: 'deny'` detiene la llamada de herramienta.

376* `permissionDecisionReason` le dice al modelo por qué, para que evite reintentar.380* `permissionDecisionReason` le dice al modelo por qué.

377* `systemMessage` muestra al usuario qué sucedió.381* `systemMessage` muestra al usuario qué sucedió.

378 382

379<CodeGroup>383<CodeGroup>

468 Registrar múltiples hooks472 Registrar múltiples hooks

469</h3>473</h3>

470 474

471Cuando se dispara un evento, todos los hooks coincidentes se ejecutan en paralelo. Para decisiones de permiso, el resultado más restrictivo se aplica: un único `deny` bloquea la llamada de herramienta independientemente de lo que devuelvan los otros hooks. Debido a que el orden de finalización es no determinista, escriba cada hook para actuar de forma independiente en lugar de depender de que otro hook se haya ejecutado primero.475Cuando se dispara un evento, los hooks correspondientes se ejecutan en paralelo. Para las decisiones de permisos, se aplica el resultado más restrictivo. Un `deny` de un hook bloquea la llamada a herramienta. Debido a que el orden de finalización es no determinista, escribe cada hook para que actúe de forma independiente en lugar de depender de que otro hook se haya ejecutado primero.

472 476

473El ejemplo a continuación registra tres verificaciones independientes para cada llamada de herramienta. Los nombres de hook en él, como `audit_logger` en Python o `auditLogger` en TypeScript, representan devoluciones de llamada que usted define:477El ejemplo a continuación registra tres verificaciones independientes, cada una con un [matcher omitido](/docs/es/hooks#matcher-patterns). Los nombres de hook en él, como `audit_logger` en Python o `auditLogger` en TypeScript, representan devoluciones de llamada que tú defines:

474 478

475<CodeGroup>479<CodeGroup>

476 ```python Python theme={null}480 ```python Python theme={null}

504 508

505Use matchers de múltiples herramientas para compartir una devolución de llamada entre herramientas relacionadas. Este ejemplo registra tres matchers con diferentes alcances, y cada hook que nombra representa una devolución de llamada que usted define:509Use matchers de múltiples herramientas para compartir una devolución de llamada entre herramientas relacionadas. Este ejemplo registra tres matchers con diferentes alcances, y cada hook que nombra representa una devolución de llamada que usted define:

506 510

507* Una lista exacta separada por tuberías (`Write|Edit|NotebookEdit`) dispara `file_security_hook` solo para herramientas de modificación de archivos.511* Una lista exacta separada por barras verticales (`Write|Edit|NotebookEdit`) dispara `file_security_hook` para las herramientas Write, Edit y NotebookEdit.

508* Una expresión regular (`^mcp__`) dispara `mcp_audit_hook` para cualquier herramienta MCP cuyo nombre comience con `mcp__`.512* Una expresión regular (`^mcp__`) dispara `mcp_audit_hook` para cualquier herramienta MCP cuyo nombre comience con `mcp__`.

509* Un matcher omitido dispara `global_logger` para cada llamada de herramienta independientemente del nombre.513* Un matcher omitido dispara `global_logger` sin filtrar por nombre de herramienta.

510 514

511<CodeGroup>515<CodeGroup>

512 ```python Python theme={null}516 ```python Python theme={null}

832 836

833Cuando una devolución de llamada excede su tiempo de espera, Claude Code la cancela y descarta su salida, y la sesión continúa en lugar de colgarse. Lo que sucede a continuación depende del evento:837Cuando una devolución de llamada excede su tiempo de espera, Claude Code la cancela y descarta su salida, y la sesión continúa en lugar de colgarse. Lo que sucede a continuación depende del evento:

834 838

835* `PreToolUse`: Claude Code no ejecuta la llamada a herramienta, Claude recibe un resultado de herramienta indicando que el hook no respondió antes de su tiempo de espera, y el turno continúa. Si otro hook `PreToolUse` devolvió una denegación explícita, Claude recibe esa denegación en lugar del error de tiempo de espera. Antes de v2.1.210, Claude Code reportaba el tiempo de espera a Claude como un rechazo del usuario, lo que hacía que las sesiones desatendidas se detuvieran y esperaran entrada.839* `PreToolUse`: Claude Code bloquea la llamada a herramienta. En su lugar, Claude recibe un resultado de herramienta indicando que el hook no respondió antes de su tiempo de espera, y el turno continúa. Antes de v2.1.210, Claude Code reportaba el tiempo de espera a Claude como un rechazo del usuario, lo que hacía que las sesiones desatendidas se detuvieran y esperaran entrada.

836* `PostToolUse` y `PostToolUseFailure`: Claude Code mantiene el resultado de la herramienta y el turno continúa.840* `PostToolUse` y `PostToolUseFailure`: Claude Code mantiene el resultado de la herramienta y el turno continúa.

837* `UserPromptSubmit` y [`UserPromptExpansion`](/docs/es/hooks#userpromptexpansion): Claude Code bloquea el prompt con un mensaje que nombra el hook y el tiempo de espera, y la sesión continúa. Debido a que una devolución de llamada en estos eventos puede actuar como una puerta de política, Claude Code nunca permite que un prompt cuyo tiempo de espera se agotó pase sin ser revisado. Antes de v2.1.208, Claude Code terminaba la consulta con `error_during_execution` cuando se agotaba el tiempo de espera de una devolución de llamada en estos eventos.841* `UserPromptSubmit` y [`UserPromptExpansion`](/docs/es/hooks#userpromptexpansion): Claude Code bloquea el prompt con un mensaje que nombra el hook y el tiempo de espera, y la sesión continúa. Antes de v2.1.208, Claude Code terminaba la consulta con `error_during_execution` cuando se agotaba el tiempo de espera de una devolución de llamada en estos eventos.

838* `Stop` y `SubagentStop`: la devolución de llamada con tiempo de espera agotado cuenta como no devolver ninguna decisión. El agente o subagente se detiene como si esa devolución de llamada lo hubiera permitido, y una decisión de tus otros hooks en el evento aún se aplica. Antes de Claude Code v2.1.273, una devolución de llamada `Stop` o `SubagentStop` con tiempo de espera agotado contaba como una ejecución de hook fallida, y Claude Code descartaba las decisiones de tus otros hooks en el evento.842* `Stop` y `SubagentStop`: la devolución de llamada con tiempo de espera agotado cuenta como no devolver ninguna decisión. El agente o subagente se detiene como si esa devolución de llamada lo hubiera permitido, y una decisión de tus otros hooks en el evento aún se aplica. Antes de Claude Code v2.1.273, una devolución de llamada `Stop` o `SubagentStop` con tiempo de espera agotado contaba como una ejecución de hook fallida, y Claude Code descartaba las decisiones de tus otros hooks en el evento.

839* `SessionStart`: la devolución de llamada con tiempo de espera agotado cuenta como no devolver ninguna salida, y la sesión continúa con la salida de tus otros hooks `SessionStart`.843* `SessionStart`: la devolución de llamada con tiempo de espera agotado cuenta como no devolver ninguna salida, y la sesión continúa con la salida de tus otros hooks `SessionStart`.

840* `PreModelSwitch`: Claude Code bloquea el cambio de modelo. Un hook que no responde no ha aprobado el cambio.844* `PreModelSwitch`: Claude Code bloquea el cambio de modelo. Un hook que no responde no ha aprobado el cambio.

agent-sdk/python.md +3 −1

Details

3881<Note>3881<Note>

3882 El sandbox depende de la compatibilidad de la plataforma y, en Linux, de herramientas como `bubblewrap` y `socat`. De forma predeterminada, cuando `enabled` es `True` pero el sandbox no puede iniciarse, los comandos se ejecutan sin sandbox con una advertencia en stderr. Este comportamiento predeterminado difiere del SDK de TypeScript, donde `failIfUnavailable` tiene un valor predeterminado de `true`.3882 El sandbox depende de la compatibilidad de la plataforma y, en Linux, de herramientas como `bubblewrap` y `socat`. De forma predeterminada, cuando `enabled` es `True` pero el sandbox no puede iniciarse, los comandos se ejecutan sin sandbox con una advertencia en stderr. Este comportamiento predeterminado difiere del SDK de TypeScript, donde `failIfUnavailable` tiene un valor predeterminado de `true`.

3883 3883

3884 Establezca `"failIfUnavailable": True` en su configuración de sandbox para detener en su lugar. La clave aún no está declarada en `SandboxSettings`, pero el SDK la reenvía a Claude Code, que la respeta. `query()` luego reporta un `ResultMessage` con `subtype="error_during_execution"` y la razón en `errors`. Debido a que se trata de una llamada única a `query()`, el SDK lanza después de ceder ese resultado de error, así que envuelva el bucle en un bloque try para continuar pasado él. Consulte [Manejar el resultado](/docs/es/agent-sdk/agent-loop#handle-the-result) para el contrato de error.3884 Establece `"failIfUnavailable": True` en tu configuración de sandbox para detener en su lugar. El SDK reenvía `failIfUnavailable` a Claude Code junto con los campos declarados de `SandboxSettings`. `query()` luego reporta un `ResultMessage` con `subtype="error_during_execution"` y la razón en `errors`. Debido a que se trata de una llamada única a `query()`, el SDK lanza después de ceder ese resultado de error, así que envuelve el bucle en un bloque try para continuar pasado él. Consulta [Manejar el resultado](/docs/es/agent-sdk/agent-loop#handle-the-result) para el contrato de error.

3885</Note>3885</Note>

3886 3886

3887Para evitar que los comandos en sandbox escriban en un archivo, agrega su ruta absoluta en [`denyWrite`](/docs/es/settings-reference#sandbox-filesystem-denywrite) en tu configuración de sandbox, como `"filesystem": {"denyWrite": ["/home/user/project/.env"]}`. El SDK reenvía `filesystem` a Claude Code junto con los campos declarados de `SandboxSettings`. Una vez que el sandbox se inicia, bloquea las escrituras en cada ruta listada. Si agregas `.env` o `./.env`, los comandos en sandbox pueden escribir en el archivo `.env` del directorio de trabajo de la sesión.

3888

3887<h4 id="example-usage">3889<h4 id="example-usage">

3888 Ejemplo de uso3890 Ejemplo de uso

3889</h4>3891</h4>

agent-sdk/skills.md +1 −1

Details

557La [guía de skills de Claude Code](/docs/es/skills) cubre la autoría en profundidad. Su orientación se aplica a sesiones del SDK. Comience con estas secciones:557La [guía de skills de Claude Code](/docs/es/skills) cubre la autoría en profundidad. Su orientación se aplica a sesiones del SDK. Comience con estas secciones:

558 558

559* [Referencia de frontmatter](/docs/es/skills#frontmatter-reference): cada campo soportado559* [Referencia de frontmatter](/docs/es/skills#frontmatter-reference): cada campo soportado

560* [Pase argumentos a skills](/docs/es/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0`, `$1` y apilamiento de skills. La [tabla de sustitución completa](/docs/es/skills#available-string-substitutions) añade argumentos nombrados y las variables `${CLAUDE_*}`560* [Pasa argumentos a skills](/docs/es/skills#pass-arguments-to-skills): `$ARGUMENTS`, `$0` y `$1`. La [tabla de sustitución completa](/docs/es/skills#available-string-substitutions) añade argumentos nombrados y las variables `${CLAUDE_*}`

561* [Inyecte contexto dinámico](/docs/es/skills#inject-dynamic-context): líneas `` !`command` `` que se ejecutan antes de que Claude vea el contenido de la skill561* [Inyecte contexto dinámico](/docs/es/skills#inject-dynamic-context): líneas `` !`command` `` que se ejecutan antes de que Claude vea el contenido de la skill

562* [Elija dónde cargan las skills](/docs/es/skills#where-skills-live): cada ubicación de skill, espacios de nombres de plugins y qué skill se ejecuta cuando dos comparten un nombre562* [Elija dónde cargan las skills](/docs/es/skills#where-skills-live): cada ubicación de skill, espacios de nombres de plugins y qué skill se ejecuta cuando dos comparten un nombre

563 563

agent-sdk/typescript.md +4 −4

Details

6368| :- | :- | :- | :- |6368| :- | :- | :- | :- |

6370| `denyWrite` | `string[]` | `[]` | Patrones de ruta de archivo para negar acceso de escritura a |6370| `denyWrite` | `string[]` | `[]` | Patrones de ruta de archivo a los que se niega el acceso de escritura. Para bloquear las escrituras en sandbox a un archivo en el directorio de trabajo de la sesión, indica su ruta absoluta. Si indicas `.env` o `./.env`, los comandos en sandbox pueden escribir en el archivo `.env` del directorio de trabajo de la sesión |

6372 6372

6373<h3 id="permissions-fallback-for-unsandboxed-commands">6373<h3 id="permissions-fallback-for-unsandboxed-commands">

6388 options: {6388 options: {

6389 sandbox: {6389 sandbox: {

6390 enabled: true,6390 enabled: true,

6391 allowUnsandboxedCommands: true // El modelo puede solicitar ejecución sin sandbox6391 allowUnsandboxedCommands: true // Model can request unsandboxed execution

6392 },6392 },

6393 permissionMode: "default",6393 permissionMode: "default",

6394 canUseTool: async (tool, input) => {6394 canUseTool: async (tool, input) => {

6395 // Verifique si el modelo está solicitando omitir el sandbox6395 // Check if the model is requesting to bypass the sandbox

6396 if (tool === "Bash" && input.dangerouslyDisableSandbox) {6396 if (tool === "Bash" && input.dangerouslyDisableSandbox) {

6397 // El modelo está solicitando ejecutar este comando fuera del sandbox6397 // The model is requesting to run this command outside the sandbox

6398 console.log(`Unsandboxed command requested: ${input.command}`);6398 console.log(`Unsandboxed command requested: ${input.command}`);

6399 6399

6400 if (isCommandAuthorized(input.command)) {6400 if (isCommandAuthorized(input.command)) {

agent-teams.md +4 −4

Details

232 232

233El líder envía una solicitud de apagado. El compañero de equipo puede aprobar, saliendo gracefully, o rechazar con una explicación.233El líder envía una solicitud de apagado. El compañero de equipo puede aprobar, saliendo gracefully, o rechazar con una explicación.

234 234

235Los directorios compartidos del equipo se limpian automáticamente cuando finaliza la sesión, por lo que no hay un paso de limpieza separado. Vea [Arquitectura](#architecture) para saber qué directorios se eliminan y cuáles persisten para sesiones reanudadas.235Los directorios compartidos del equipo se limpian automáticamente cuando finaliza la sesión, por lo que no hay un paso de limpieza separado. Consulta [Arquitectura](#architecture) para saber qué directorios se eliminan y cuáles permanecen en el disco.

236 236

237<h3 id="enforce-quality-gates-with-hooks">237<h3 id="enforce-quality-gates-with-hooks">

238 Aplicar puertas de calidad con hooks238 Aplicar puertas de calidad con hooks

279 279

280Los equipos y las tareas se almacenan localmente bajo un nombre derivado de la sesión. El nombre es `session-` seguido de los primeros ocho caracteres del ID de sesión:280Los equipos y las tareas se almacenan localmente bajo un nombre derivado de la sesión. El nombre es `session-` seguido de los primeros ocho caracteres del ID de sesión:

281 281

282* **Configuración del equipo**: `~/.claude/teams/{team-name}/config.json`282* **Configuración del equipo**: `~/.claude/teams/{team-name}/config.json`. Claude Code elimina el directorio de configuración del equipo cuando finaliza la sesión.

283* **Lista de tareas**: `~/.claude/tasks/{team-name}/`283* **Lista de tareas**: `~/.claude/tasks/{team-name}/`. Este directorio permanece en el disco después de que finaliza la sesión. Para cambiar [cuánto tiempo lo conserva Claude Code](/docs/es/claude-directory#cleaned-up-automatically), establece [`cleanupPeriodDays`](/docs/es/settings-reference#cleanupperioddays).

284 284

285Claude Code genera ambos automáticamente al inicio de la sesión y los actualiza a medida que los compañeros de equipo se unen, se quedan inactivos o se van. El directorio de configuración del equipo se elimina cuando finaliza la sesión. El directorio de lista de tareas persiste localmente y nunca se carga, por lo que las sesiones reanudadas mantienen sus tareas. La retención se rige por el mismo [`cleanupPeriodDays`](/docs/es/settings-reference#cleanupperioddays) que ya controla para transcripciones de sesión, siguiendo las [reglas de barrido de retención](/docs/es/claude-directory#cleaned-up-automatically).285Claude Code genera ambos automáticamente al inicio de la sesión y los actualiza a medida que los compañeros de equipo se unen, se quedan inactivos o se van.

286 286

287La configuración del equipo contiene estado de tiempo de ejecución como IDs de sesión e IDs de panel tmux, por lo que no la edite manualmente ni la cree previamente: sus cambios se sobrescriben en la siguiente actualización de estado.287La configuración del equipo contiene estado de tiempo de ejecución como IDs de sesión e IDs de panel tmux, por lo que no la edite manualmente ni la cree previamente: sus cambios se sobrescriben en la siguiente actualización de estado.

288 288

agent-view.md +1 −1

Details

325 325

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

327 327

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

329 329

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

331 331

auto-mode-classifier-billing.md +3 −1

Details

12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.12We're changing auto mode to no longer charge for classifier requests in Claude Code. However, this session isn't eligible.

13```13```

14 14

15En el símbolo del sistema, Claude Code retiene la primera acción que verificaría de esa manera hasta que responda. Nada está roto: el modo automático sigue funcionando, y sus solicitudes de clasificador se facturan como lo eran antes. La causa más común es una puerta de enlace LLM o proxy entre Claude Code y la API, y cuando Claude Code puede identificar una, el aviso la nombra. Presione **Intro** para continuar, o consulte [Hacer que la sesión sea elegible](#make-the-session-eligible) para evitar que aparezca en nuevas sesiones.15En el prompt, Claude Code retiene la primera acción que comprobaría de esa manera hasta que respondas. El modo automático sigue funcionando, y sus solicitudes de clasificador se facturan como antes.

17La causa más común es un gateway LLM o proxy entre Claude Code y la API, y cuando Claude Code puede identificarlo, el aviso lo nombra. Presiona **Intro** para continuar, o consulta [Hacer que la sesión sea elegible](#make-the-session-eligible) para evitar que aparezca en nuevas sesiones.

16 18

17<h2 id="respond-to-the-notice">19<h2 id="respond-to-the-notice">

18 Responder al aviso20 Responder al aviso

channels.md +8 −8

Details

44 44

45 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:45 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

46 46

~~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`: agrega el marketplace con `/plugin marketplace add anthropics/claude-plugins-official` y luego reintenta 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 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

49 49

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

122 122

123 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:123 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

124 124

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`: agrega el marketplace con `/plugin marketplace add anthropics/claude-plugins-official` y luego reintenta 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 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

127 127

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

187 187

188 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:188 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

189 189

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

191 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.191 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

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

246 246

247 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:247 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

248 248

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

250 * El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.250 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin not found in marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

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

claude-directory.md +1 −1

Details

290 note: commandsNote,290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; command files still work'],

294 docsLink: '/en/skills',294 docsLink: '/en/skills',

295 children: [{295 children: [{

296 id: 'cmd-example',296 id: 'cmd-example',

claude-security.md +3 −3

Details

48 48

49El comando abre los detalles del plugin, donde eliges un [alcance de instalación](/docs/es/plugins/install#install-a-plugin) para iniciar la instalación.49El comando abre los detalles del plugin, donde eliges un [alcance de instalación](/docs/es/plugins/install#install-a-plugin) para iniciar la instalación.

50 50

~~51Si la instalación falla, la solución depende del mensaje que reporte Claude Code:~~51Si la instalación falla, busca el mensaje que reporta Claude Code:

52 52

~~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* `Marketplace "claude-plugins-official" not found`: añade el marketplace con `/plugin marketplace add anthropics/claude-plugins-official` y 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* `Plugin "claude-security" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

55 55

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

code-review-local.md +1 −1

Details

118Después del nivel de esfuerzo y los flags, Claude Code lee el resto de la línea como el objetivo de la revisión. El argumento `ultra` cambia esa interpretación:118Después del nivel de esfuerzo y los flags, Claude Code lee el resto de la línea como el objetivo de la revisión. El argumento `ultra` cambia esa interpretación:

119 119

120* **Con `ultra`**: Claude Code lee una sola palabra como una rama base o un número de PR. Un texto más largo que no nombra una rama ni un PR se convierte en [una nota adjunta a la revisión](/docs/es/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa tu rama actual, y Claude relaciona los hallazgos con tu nota.120* **Con `ultra`**: Claude Code lee una sola palabra como una rama base o un número de PR. Un texto más largo que no nombra una rama ni un PR se convierte en [una nota adjunta a la revisión](/docs/es/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` revisa tu rama actual, y Claude relaciona los hallazgos con tu nota.

121* **Sin `ultra`**: todo lo que queda es el objetivo de la revisión, incluso cuando empieza con el nombre de otro comando. `/code-review /fix-issue 123` revisa con `/fix-issue 123` como texto del objetivo en lugar de cargar `/fix-issue` como un segundo [skill apilado](/docs/es/skills#pass-arguments-to-skills). Antes de la v2.1.218, un comando apilado después de `/code-review` se expandía como su propio skill.121* **Sin `ultra`**: todo lo que queda es el objetivo de la revisión, incluso cuando empieza con el nombre de otro comando. `/code-review /fix-issue 123` revisa con `/fix-issue 123` como texto del objetivo en lugar de cargar `/fix-issue` como un segundo [skill apilado](/docs/es/skills#stack-several-skills-in-one-message). Antes de la v2.1.218, un comando apilado después de `/code-review` se expandía como su propio skill.

122 122

123<h2 id="run-in-the-foreground">123<h2 id="run-in-the-foreground">

124 Ejecutar en primer plano124 Ejecutar en primer plano

commands.md +1 −1

Details

10 10

11Escribe `/` para ver los comandos disponibles para ti, o escribe `/` seguido de letras para filtrar. [Cómo el menú de comandos coincide con lo que escribes](#how-the-command-menu-matches-what-you-type) explica el resaltado, los errores tipográficos y los pocos comandos que Claude Code oculta del menú hasta que escribes su nombre completo.11Escribe `/` para ver los comandos disponibles para ti, o escribe `/` seguido de letras para filtrar. [Cómo el menú de comandos coincide con lo que escribes](#how-the-command-menu-matches-what-you-type) explica el resaltado, los errores tipográficos y los pocos comandos que Claude Code oculta del menú hasta que escribes su nombre completo.

12 12

13Un comando solo se reconoce al inicio de tu mensaje. El texto que sigue al nombre del comando se convierte en sus argumentos. Los [skills](/docs/es/skills#pass-arguments-to-skills) son la excepción: una invocación de un skill seguida de más skills, como `/skill-a /skill-b do XYZ`, carga los skills nombrados al inicio y pasa el texto restante a cada uno como argumentos. Se pueden encadenar hasta seis skills.13Un comando solo se reconoce al inicio de tu mensaje. El texto que sigue al nombre del comando se convierte en sus argumentos. En el prompt de la terminal, puedes iniciar un mensaje con varios [skills](/docs/es/skills#stack-several-skills-in-one-message): escribir `/skill-a /skill-b do XYZ` carga ambos skills y pasa el texto restante a cada uno como argumentos. Se pueden encadenar hasta seis skills.

14 14

15Si envías un comando mientras Claude está respondiendo, Claude Code lo pone en cola y lo ejecuta cuando termina el turno actual. Claude Code ejecuta algunos comandos de inmediato sin interrumpir la respuesta, como `/status`, `/tasks` y `/usage`. En el [renderizado de pantalla completa](/docs/es/fullscreen), Claude Code también abre de inmediato los comandos de diálogo como `/theme` y `/help`. Antes de la v2.1.234, Claude Code ponía en cola esos diálogos hasta que terminaba el turno.15Si envías un comando mientras Claude está respondiendo, Claude Code lo pone en cola y lo ejecuta cuando termina el turno actual. Claude Code ejecuta algunos comandos de inmediato sin interrumpir la respuesta, como `/status`, `/tasks` y `/usage`. En el [renderizado de pantalla completa](/docs/es/fullscreen), Claude Code también abre de inmediato los comandos de diálogo como `/theme` y `/help`. Antes de la v2.1.234, Claude Code ponía en cola esos diálogos hasta que terminaba el turno.

16 16

desktop.md +10 −9

Details

1137</Warning>1137</Warning>

1138 1138

1139* **Después de una suspensión o una pérdida de red**: recuperas la tarea en ejecución si el proceso [sigue ejecutándose](#limits-while-desktop-is-disconnected) y Desktop puede iniciar sesión sin pedirte nada. Si no puede, [envía un mensaje](#reconnect-after-sleep-or-a-network-loss).1139* **Después de una suspensión o una pérdida de red**: recuperas la tarea en ejecución si el proceso [sigue ejecutándose](#limits-while-desktop-is-disconnected) y Desktop puede iniciar sesión sin pedirte nada. Si no puede, [envía un mensaje](#reconnect-after-sleep-or-a-network-loss).

1140* **Después de cerrar Desktop, con Desktop en macOS o Linux y una cuenta de Claude**: recuperas la tarea en ejecución si Desktop puede [volver a unirse al proceso](#reopen-a-session-after-you-quit-desktop). Si no puede, la tarea se detiene. Si sigue detenida, envía un mensaje.1140* **Después de salir**: la tarea sigue ejecutándose, pero la pierdes cuando la sesión vuelve a abrirse, a menos que Desktop pueda volver a unirse a su proceso. Revisa [cuándo puede Desktop volver a unirse](#reopen-a-session-after-you-quit-desktop) antes de salir. Si perdiste la tarea, envía un mensaje para continuar.

1141* **Después de cerrar Desktop, con Desktop en Windows o un [proveedor externo](/docs/es/third-party-integrations)**: pierdes la tarea en ejecución, porque Desktop termina el proceso cuando se abre la sesión. Envía un mensaje para continuar.

1142 1141

1143Cuando vuelvas y la tarea no haya terminado, busca un aviso de que Desktop no puede volver a conectarse, un error de autenticación o una solicitud en espera:1142Cuando vuelvas y la tarea no haya terminado, busca un aviso de que Desktop no puede volver a conectarse, un error de autenticación o una solicitud en espera:

1144 1143

1154</h5>1153</h5>

1155 1154

1156* **Actualiza primero**: actualiza Desktop antes de iniciar una tarea larga. En macOS y Windows, Desktop puede reiniciarse por sí solo para instalar una actualización que haya descargado. Ese reinicio espera mientras Claude trabaja en una tarea SSH. En macOS con una cuenta de Claude, de forma predeterminada el reinicio puede realizarse de todos modos una vez que la actualización haya esperado 72 horas.1155* **Actualiza primero**: actualiza Desktop antes de iniciar una tarea larga. En macOS y Windows, Desktop puede reiniciarse por sí solo para instalar una actualización que haya descargado. Ese reinicio espera mientras Claude trabaja en una tarea SSH. En macOS con una cuenta de Claude, de forma predeterminada el reinicio puede realizarse de todos modos una vez que la actualización haya esperado 72 horas.

1157* **No cierres Desktop**: si Desktop se ejecuta en Windows o usa un proveedor externo, déjalo abierto mientras se ejecuta la tarea larga. Después de cerrarlo, [termina la tarea en ejecución](#reopen-a-session-after-you-quit-desktop) cuando se abre la sesión. Dejarlo abierto no protege una solicitud que [te está esperando](#handle-requests-that-arrive-while-you-are-away).1156* **No salgas en Windows, ni antes de v2.42304.0 con un proveedor externo**: si sales en esos casos, pierdes la tarea en ejecución, así que deja Desktop abierto durante la tarea. En cualquier otro caso, consulta [qué recuperas](#reopen-a-session-after-you-quit-desktop) antes de salir.

1158* **Reduce las solicitudes**: elige un modo de permisos, reglas o hooks que [hagan que la tarea te espere con menos frecuencia](#handle-requests-that-arrive-while-you-are-away)1157* **Reduce las solicitudes**: elige un modo de permisos, reglas o hooks que [hagan que la tarea te espere con menos frecuencia](#handle-requests-that-arrive-while-you-are-away)

1159* **Revisa el host de salto**: si tu host de salto pide un inicio de sesión, por ejemplo una notificación push a un teléfono, cambia a un inicio de sesión que funcione sin pedirte nada. De lo contrario, Desktop puede enviar otra notificación push cada vez que intenta volver a conectarse.1158* **Revisa el host de salto**: si tu host de salto pide un inicio de sesión, por ejemplo una notificación push a un teléfono, cambia a un inicio de sesión que funcione sin pedirte nada. De lo contrario, Desktop puede enviar otra notificación push cada vez que intenta volver a conectarse.

1160* **Prueba la máquina remota**: inicia una tarea corta, cierra Desktop mientras la tarea sigue en ejecución y vuelve a abrir la sesión bastante después de cuando la tarea debería haber terminado. Si la tarea no terminó y la sesión no muestra ningún error de autenticación, revisa la máquina remota en busca de [lo que puede terminar una tarea](#limits-while-desktop-is-disconnected).1159* **Prueba la máquina remota**: inicia una tarea corta, cierra Desktop mientras la tarea sigue en ejecución y vuelve a abrir la sesión bastante después de cuando la tarea debería haber terminado. Si la tarea no terminó y la sesión no muestra ningún error de autenticación, revisa la máquina remota en busca de [lo que puede terminar una tarea](#limits-while-desktop-is-disconnected).

1206 1205

1207Si Claude necesita tu aprobación o te hace una pregunta mientras Desktop está desconectado, Claude espera en la máquina remota. La espera no tiene un límite de tiempo propio. Cuando Desktop vuelve a unirse al proceso, te muestra la solicitud. Si Desktop inicia un proceso nuevo en su lugar, pierdes la solicitud.1206Si Claude necesita tu aprobación o te hace una pregunta mientras Desktop está desconectado, Claude espera en la máquina remota. La espera no tiene un límite de tiempo propio. Cuando Desktop vuelve a unirse al proceso, te muestra la solicitud. Si Desktop inicia un proceso nuevo en su lugar, pierdes la solicitud.

1208 1207

1209Mientras una tarea te espera, Desktop puede reiniciarse por sí solo, por ejemplo para instalar una actualización. Si Desktop se ejecuta en Windows o usa un proveedor externo, pierdes la solicitud después de ese reinicio.1208Si una solicitud que te esperaba ya no está cuando regresas, una causa es que Desktop se reinició por sí solo, por ejemplo para instalar una actualización. Conservas una solicitud tras un reinicio solo si Desktop puede volver a unirse al proceso, así que revisa [cuándo puede Desktop volver a unirse](#reopen-a-session-after-you-quit-desktop) antes de dejar una tarea en ejecución.

1210 1209

1211Si pierdes una solicitud, envía un mensaje para continuar.1210Si pierdes una solicitud, envía un mensaje para continuar.

1212 1211

1238 - **Host de salto, las notificaciones push siguen llegando**: donde Desktop no puede saber que nadie responde, como con Desktop en Windows, sigue intentándolo mientras tenga un proceso al que volver a unirse, se siga ejecutando ese proceso o no. Puedes recibir otra notificación push con cada intento. Para terminar los intentos, cierra Desktop, lo que [puede costarte la tarea en ejecución](#reopen-a-session-after-you-quit-desktop).1237 - **Host de salto, las notificaciones push siguen llegando**: donde Desktop no puede saber que nadie responde, como con Desktop en Windows, sigue intentándolo mientras tenga un proceso al que volver a unirse, se siga ejecutando ese proceso o no. Puedes recibir otra notificación push con cada intento. Para terminar los intentos, cierra Desktop, lo que [puede costarte la tarea en ejecución](#reopen-a-session-after-you-quit-desktop).

1239 - **Interrupción larga**: Desktop reduce el ritmo a aproximadamente un intento cada cinco minutos. Para volver a conectarte antes, reintenta en la sesión o envía un mensaje, que Desktop entrega una vez que está conectado.1238 - **Interrupción larga**: Desktop reduce el ritmo a aproximadamente un intento cada cinco minutos. Para volver a conectarte antes, reintenta en la sesión o envía un mensaje, que Desktop entrega una vez que está conectado.

1240 - **Salida faltante**: mientras Desktop está desconectado, el programa auxiliar guarda la salida más reciente de Claude Code de cada sesión en un búfer de 16 MiB y descarta la salida más antigua. Después de que Desktop vuelve a conectarse, la sesión puede mostrar `Loading recent output from <host>…`. Si Desktop no puede cargar toda la salida, ves la fila `Some output produced while you were disconnected may be missing here.` La fila no significa que la tarea se haya detenido.1239 - **Salida faltante**: mientras Desktop está desconectado, el programa auxiliar guarda la salida más reciente de Claude Code de cada sesión en un búfer de 16 MiB y descarta la salida más antigua. Después de que Desktop vuelve a conectarse, la sesión puede mostrar `Loading recent output from <host>…`. Si Desktop no puede cargar toda la salida, ves la fila `Some output produced while you were disconnected may be missing here.` La fila no significa que la tarea se haya detenido.

1241 - **Proceso inexistente**: si el proceso ya no existe cuando Desktop vuelve a conectarse, Desktop puede iniciar uno nuevo a partir del historial guardado de la conversación y decirle a Claude que continúe la tarea. Desktop no continúa la tarea por sí solo si el proceso sigue terminando, o si Desktop usa un proveedor externo. Envía un mensaje para continuar.1240 - **Proceso desaparecido**: el proceso terminó mientras Desktop estaba desconectado, como cuando la máquina remota se reinicia. Desktop puede entonces iniciar uno nuevo a partir del historial guardado de la conversación y decirle a Claude que continúe la tarea. Si la tarea sigue detenida, envía un mensaje. Con un proveedor externo, actualiza a Claude Desktop v2.42304.0 o posterior, porque las versiones anteriores nunca continúan la tarea por sí solas.

1242</Accordion>1241</Accordion>

1243 1242

1244<a id="reopen-a-session-after-you-quit-desktop" />1243<a id="reopen-a-session-after-you-quit-desktop" />

1247 Volver a abrir una sesión después de cerrar Desktop1246 Volver a abrir una sesión después de cerrar Desktop

1248</h5>1247</h5>

1249 1248

1250Después de cerrar Desktop, la tarea sigue ejecutándose en la máquina remota hasta que termina, te necesita o alcanza uno de los [límites](#limits-while-desktop-is-disconnected).1249Después de salir de Desktop, la tarea sigue ejecutándose en la máquina remota, pero se detiene cuando la sesión vuelve a abrirse, a menos que Desktop pueda volver a unirse a su proceso. Mientras Desktop está cerrado, la tarea se ejecuta hasta que termina, te necesita o alcanza uno de los [límites](#limits-while-desktop-is-disconnected).

1251 1250

1252* **Desktop en macOS o Linux, con una cuenta de Claude**: inicia Desktop y abre la sesión. Recuperas la tarea en ejecución cuando Desktop puede volver a unirse al proceso. No siempre puede volver a unirse, por ejemplo después de algunas actualizaciones de Desktop o después de que tu organización cambie su configuración administrada.1251* **Desktop en Windows**: no recuperas la tarea en ejecución, porque Desktop nunca vuelve a unirse después de salir. Inicia Desktop de nuevo solo cuando esperes que la tarea haya terminado, porque la sesión puede abrirse cuando Desktop se inicia.

1253* **En macOS o Linux, cuando Desktop no puede volver a unirse**: Desktop termina el proceso e inicia uno nuevo a partir del historial guardado de la conversación. Tu tarea en ejecución se detiene, y pierdes cualquier aprobación o pregunta que te estuviera esperando. Después de una actualización, Desktop puede entonces decirle a Claude que continúe. Si la tarea sigue detenida, envía un mensaje.1252* **Proveedor externo, tarea de una versión anterior**: si iniciaste la tarea en una versión de Desktop anterior a v2.42304.0, tampoco la recuperas en macOS ni en Linux. Inicia Desktop de nuevo solo cuando esperes que la tarea haya terminado.

1254* **Desktop en Windows, o con un proveedor externo en cualquier plataforma**: vuelve a iniciar Desktop solo cuando esperes que la tarea haya terminado. No recuperas la tarea en ejecución, porque Desktop nunca vuelve a unirse después de cerrarse. Termina el proceso cuando se abre la sesión, lo que puede ocurrir al iniciarse Desktop. Envía un mensaje para continuar.1253* **Cualquier otra tarea, con Desktop en macOS o Linux**: inicia Desktop y abre la sesión, y la tarea continúa si Desktop vuelve a unirse. No siempre puede volver a unirse, por ejemplo después de algunas actualizaciones de Desktop, así que [actualiza antes de una tarea larga](#prepare-a-long-task).

1254

1255Cuando Desktop no puede volver a unirse, también pierdes cualquier aprobación o pregunta que te estuviera esperando. Si la tarea no continúa por sí sola, envía un mensaje y Claude continúa a partir del historial guardado de la conversación.

1255 1256

1256Para despliegues con terceros, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).1257Para despliegues con terceros, consulta [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).

1257 1258

features-overview.md +1 −1

Details

186 | - | - | - |186 | - | - | - |

188 | **Desencadenado por** | [Eventos del ciclo de vida](/docs/es/hooks#hook-events) como `PostToolUse` o `SessionStart` | Usted escribiendo `/<name>`, o Claude haciendo coincidir la descripción con su tarea |188 | **Desencadenado por** | [Eventos del ciclo de vida](/docs/es/hooks#hook-events) como `PostToolUse` o `SessionStart` | Usted escribiendo `/<name>`, o Claude haciendo coincidir la descripción con su tarea |

191 | **Mejor para** | Linting después de ediciones, bloquear comandos inseguros, logging, notificaciones | Flujos de trabajo que necesitan razonamiento, material de referencia, tareas de varios pasos |191 | **Mejor para** | Linting después de ediciones, bloquear comandos inseguros, logging, notificaciones | Flujos de trabajo que necesitan razonamiento, material de referencia, tareas de varios pasos |

192 192

hooks.md +1 −1

Details

1832 1832

1833Usa el [control de decisiones de PreToolUse](#pretooluse-decision-control) para permitir, denegar, preguntar o diferir la llamada a herramienta.1833Usa el [control de decisiones de PreToolUse](#pretooluse-decision-control) para permitir, denegar, preguntar o diferir la llamada a herramienta.

1834 1834

1835Un [hook de callback del Agent SDK](/docs/es/agent-sdk/hooks) en `PreToolUse` que supera su tiempo de espera bloquea la llamada a herramienta, y Claude recibe un resultado de error que nombra el tiempo de espera. Una denegación explícita devuelta por otro hook sigue teniendo precedencia.1835Un [hook de callback del Agent SDK](/docs/es/agent-sdk/hooks) en `PreToolUse` que supera su tiempo de espera bloquea la llamada a herramienta, y Claude recibe un resultado de error que nombra el tiempo de espera.

1836 1836

1837<h4 id="pretooluse-input">1837<h4 id="pretooluse-input">

1838 Entrada de PreToolUse1838 Entrada de PreToolUse

large-codebases.md +1 −1

Details

213Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:213Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

214 214

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

216* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.216* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin not found in marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

217 217

218Para habilitar un plugin para todos en el repositorio en lugar de instalarlo usted mismo, agréguelo a la configuración de proyecto [`enabledPlugins`](/docs/es/settings-reference#plugin-settings).218Para habilitar un plugin para todos en el repositorio en lugar de instalarlo usted mismo, agréguelo a la configuración de proyecto [`enabledPlugins`](/docs/es/settings-reference#plugin-settings).

219 219

mcp.md +2 −2

Details

49 49

50 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:50 Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

51 51

~~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`: agrega el marketplace con `/plugin marketplace add anthropics/claude-plugins-official` y luego reintenta 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 * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

54 54

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

monitoring-usage.md +1 −1

Details

772**Atributos**:772**Atributos**:

773 773

774* Todos los [atributos estándar](#standard-attributes)774* Todos los [atributos estándar](#standard-attributes)

775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). El tipo `"input"` excluye los tokens leídos de la caché de prompts o escritos en ella, que se cuentan en `"cacheRead"` y `"cacheCreation"`775* `type`: (`"input"`, `"output"`, `"cacheRead"`, `"cacheCreation"`). El tipo `"input"` excluye los tokens leídos de la caché de prompts o escritos en ella, que se cuentan en `"cacheRead"` y `"cacheCreation"`. El tipo `"cacheCreation"` cuenta juntas las escrituras en caché con las [duraciones de caché](/docs/es/prompt-caching#cache-lifetime) de cinco minutos y de una hora.

776* `model`: Identificador de modelo (por ejemplo, "claude-sonnet-5")776* `model`: Identificador de modelo (por ejemplo, "claude-sonnet-5")

777* `query_source`: Categoría del subsistema que emitió la solicitud. Uno de `"main"`, `"subagent"`, o `"auxiliary"`777* `query_source`: Categoría del subsistema que emitió la solicitud. Uno de `"main"`, `"subagent"`, o `"auxiliary"`

778* `speed`: `"fast"` cuando la solicitud utilizó modo rápido. Ausente de lo contrario778* `speed`: `"fast"` cuando la solicitud utilizó modo rápido. Ausente de lo contrario

permissions.md +0 −2

Details

749Estas comprobaciones aún se aplican:749Estas comprobaciones aún se aplican:

750 750

751* Las reglas ask con alcance de contenido como `Bash(git push *)` aún fuerzan un aviso751* Las reglas ask con alcance de contenido como `Bash(git push *)` aún fuerzan un aviso

752* Las reglas de negación explícitas aún se aplican

753* Los comandos `rm` o `rmdir` que apunten a una [ruta crítica](/docs/es/permission-modes#critical-paths) aún pasan por el flujo de permisos regular

754* Otros comandos en el sandbox también pueden pasar por el flujo de permisos regular, como se describe en [modo Auto-allow](/docs/es/sandboxing#auto-allow-mode)752* Otros comandos en el sandbox también pueden pasar por el flujo de permisos regular, como se describe en [modo Auto-allow](/docs/es/sandboxing#auto-allow-mode)

755 753

756Los comandos que no se ejecutarán en sandbox, como comandos excluidos, respetan la regla ask `Bash` simple como es habitual. Consulte [modos de sandbox](/docs/es/sandboxing#sandbox-modes) para cambiar este comportamiento.754Los comandos que no se ejecutarán en sandbox, como comandos excluidos, respetan la regla ask `Bash` simple como es habitual. Consulte [modos de sandbox](/docs/es/sandboxing#sandbox-modes) para cambiar este comportamiento.

plugins/mods/admin.md +1 −1

Details

78 78

79Los mods no reemplazan los controles que ya tienes:79Los mods no reemplazan los controles que ya tienes:

80 80

81* **Los hooks de configuración siguen funcionando.** Los hooks de comando, HTTP, prompt y agente en los archivos de configuración y en el `hooks/hooks.json` de los plugins se ejecutan como antes, junto con los mods. Nada de ellos está obsoleto.81* **Los hooks de configuración siguen funcionando.** Los hooks de comando, HTTP, prompt y agente en los archivos de configuración y en el `hooks/hooks.json` de los plugins se ejecutan como antes, junto con los mods.

82* **Las reglas de denegación tienen precedencia donde se carga la protección.** El mod de un usuario no puede aprobar una llamada que rechaza una regla `deny`, a menos que configures [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).82* **Las reglas de denegación tienen precedencia donde se carga la protección.** El mod de un usuario no puede aprobar una llamada que rechaza una regla `deny`, a menos que configures [`allowModsToOverrideDenyRules`](#set-options-on-the-built-in-guard).

83* **Los hooks administrados se ejecutan primero.** Un hook `PreToolUse` en la configuración administrada se ejecuta antes de que cualquier mod vea la llamada a herramienta, y su bloqueo es definitivo. Si luego un mod reescribe la llamada, tus hooks administrados se ejecutan de nuevo sobre la llamada reescrita, por lo que un bloqueo sigue aplicándose. Los hooks `PreToolUse` de otros archivos de configuración y de plugins se ejecutan después del último mod, así que un mod que devuelve su propio resultado en lugar de ejecutar la herramienta impide que esos se ejecuten. Consulta [El orden en que se ejecutan los mods](/docs/es/plugins/mods/events#the-order-mods-run-in).83* **Los hooks administrados se ejecutan primero.** Un hook `PreToolUse` en la configuración administrada se ejecuta antes de que cualquier mod vea la llamada a herramienta, y su bloqueo es definitivo. Si luego un mod reescribe la llamada, tus hooks administrados se ejecutan de nuevo sobre la llamada reescrita, por lo que un bloqueo sigue aplicándose. Los hooks `PreToolUse` de otros archivos de configuración y de plugins se ejecutan después del último mod, así que un mod que devuelve su propio resultado en lugar de ejecutar la herramienta impide que esos se ejecuten. Consulta [El orden en que se ejecutan los mods](/docs/es/plugins/mods/events#the-order-mods-run-in).

84* **La política de red cubre `$.http.fetch`.**84* **La política de red cubre `$.http.fetch`.**

plugins/mods/gallery.md +1 −1

Details

114 `Text`114 `Text`

115</h3>115</h3>

116 116

117`Text` dibuja una cadena con los estilos que le indiques. Este ejemplo muestra una línea por cada estilo:117`Text` dibuja una cadena con los estilos que le indiques. Este ejemplo muestra texto sin formato y ocho estilos, uno en cada línea:

118 118

119```javascript theme={null}119```javascript theme={null}

120Box({120Box({

plugins/mods/interface.md +2 −2

Details

455 455

457| :- | :- | :- |457| :- | :- | :- |

458| `Box` | Un contenedor flex. Acepta props de diseño como `flexDirection`, `columnGap`, `padding`, [`borderStyle`](/docs/es/plugins/mods/reference#box-border-styles) y `width`. | En todas partes |458| `Box` | Un contenedor flex que acepta props de diseño como `flexDirection`, [`borderStyle`](/docs/es/plugins/mods/reference#box-border-styles) y `width`. Las props de espaciado como `columnGap` y `padding` aceptan un número o un [nombre de paso](/docs/es/plugins/mods/reference#box-spacing-steps) de `'xs'` a `'xl'`. | En todas partes |

459| `Text` | Texto con estilo. Acepta `color`, `bold`, `dimColor`, `italic` y `wrap`. Un `color` es una clave del tema o un color como `'red'`. Un `wrap` es `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` o `'truncate-end'`. | En todas partes |459| `Text` | Texto con estilo. Acepta `color`, `bold`, `dimColor`, `italic`, `wrap` y otras como [`weight`](/docs/es/plugins/mods/reference#text-typography). Un `color` es una clave del tema o un color como `'red'`. Un `wrap` es `'wrap'`, `'truncate'`, `'truncate-start'`, `'truncate-middle'` o `'truncate-end'`. | En todas partes |

461| `Link`, `Code`, `Markdown` | Un enlace con `href` y una `label` opcional, un bloque de código y texto con el mismo formato que las respuestas de Claude. `Markdown` recibe su contenido en una prop `text`, no en `children`, y necesita una `key` cuando pasas `onLinkPress`. | En todas partes |461| `Link`, `Code`, `Markdown` | Un enlace con `href` y una `label` opcional, un bloque de código y texto con el mismo formato que las respuestas de Claude. `Markdown` recibe su contenido en una prop `text`, no en `children`, y necesita una `key` cuando pasas `onLinkPress`. | En todas partes |

plugins/mods/reference.md +44 −2

Details

293 293

295| :- | :- | :-: | :-: | :-: |295| :- | :- | :-: | :-: | :-: |

296| [`Box`](/docs/es/plugins/mods/interface#build-a-tree-from-elements) | `key`, diseño flex, `gap`, `padding`, `margin`, `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |296| [`Box`](/docs/es/plugins/mods/interface#build-a-tree-from-elements) | `key`, diseño flex, [`gap`, `padding`, `margin`](#box-spacing-steps), `width`, `height`, [`borderStyle`](#box-border-styles), `backgroundColor`, `position`, `hover` | ✓ | ✓ | ✓ |

297| [`Text`](/docs/es/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ | ✓ |297| [`Text`](/docs/es/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, [`bold`](#text-bold), `italic`, `underline`, `dimColor`, `inverse`, `wrap`, [`size`, `weight`, `mono`, `tabular`](#text-typography) | ✓ | ✓ | ✓ |

298| [`Button`](/docs/es/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |298| [`Button`](/docs/es/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ | ✓ |

299| [`Link`](/docs/es/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. Consulta [Límites](#limits). | ✓ | ✓ | ✓ |299| [`Link`](/docs/es/plugins/mods/interface#link-in-the-desktop-app) | `href`, `label`. Consulta [Límites](#limits). | ✓ | ✓ | ✓ |

300| [`Code`](/docs/es/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |300| [`Code`](/docs/es/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ | ✓ |

311La extensión de VS Code ignora algunas props de los elementos y dibuja el elemento como si las hubieras omitido:311La extensión de VS Code ignora algunas props de los elementos y dibuja el elemento como si las hubieras omitido:

312 312

313* **`Box`**: `position` y `hover`313* **`Box`**: `position` y `hover`

314* **`Text`**: `size`, `mono` y `tabular`

314* **`Button`**: `hotkey`, `plain`, `autoFocus` y `action`, así que allí el usuario presiona un botón con un clic, o con Enter una vez que tiene el foco315* **`Button`**: `hotkey`, `plain`, `autoFocus` y `action`, así que allí el usuario presiona un botón con un clic, o con Enter una vez que tiene el foco

315* **`Code`**: `language`, `path`, `startLine`, `format` y `wrap`, así que el código se dibuja sin colores ni números de línea, y un bloque `format: 'diff'` muestra el texto sin procesar del diff316* **`Code`**: `language`, `path`, `startLine`, `format` y `wrap`, así que el código se dibuja sin colores ni números de línea, y un bloque `format: 'diff'` muestra el texto sin procesar del diff

316* **`Input` y `Select`**: `autoFocus`317* **`Input` y `Select`**: `autoFocus`

336 337

337Un `Box` cuyo `borderStyle` nombra cualquier otra cosa, como `'rounded'`, se dibuja sin borde.338Un `Box` cuyo `borderStyle` nombra cualquier otra cosa, como `'rounded'`, se dibuja sin borde.

338 339

340<h3 id="box-spacing-steps">

341 Pasos de espaciado de `Box`

342</h3>

343

344Las props de espaciado de `Box` son `gap`, `columnGap`, `rowGap`, `padding`, `margin` y las formas de un solo lado y de un solo eje de `padding` y `margin`, como `paddingX` y `marginTop`. Cada una acepta un número de celdas de la terminal, como `gap: 1`, o un nombre de paso, como `gap: 'md'`. En la terminal y en la extensión de VS Code, cada paso equivale a esta cantidad de celdas:

345

346| Paso | Celdas en horizontal | Celdas en vertical |

347| :- | :- | :- |

348| `'xs'` | 1 | 0 |

349| `'sm'` | 1 | 0 |

350| `'md'` | 2 | 1 |

351| `'lg'` | 3 | 1 |

352| `'xl'` | 4 | 2 |

353

354Si estableces `gap`, `padding` o `margin` en un paso, el paso se aplica en horizontal y en vertical a la vez. Por ejemplo, en la terminal y en la extensión de VS Code, `padding: 'md'` equivale a dos celdas a cada lado y una fila arriba y abajo.

355

356Los nombres de paso requieren Claude Code v2.1.299 o posterior. En una versión anterior, Claude Code [dibuja su propia versión del sitio](/docs/es/plugins/mods/interface#build-a-tree-from-elements) en lugar de un árbol que usa un nombre de paso.

357

358<h3 id="text-typography">

359 Props tipográficas de `Text`

360</h3>

361

362Establece `size`, `weight`, `mono` o `tabular` en un `Text` para pedirle a la aplicación que dibuja tu árbol un tamaño de texto, un grosor, una tipografía monoespaciada o dígitos de ancho uniforme. Antes de depender de una prop, comprueba qué hacen con ella la terminal y la extensión de VS Code. Si una aplicación ignora una prop que estableciste, tu árbol se sigue dibujando allí, con el texto como si hubieras omitido esa prop.

363

365| :- | :- | :- | :- |

369| `tabular` | `true` para pedir dígitos de ancho uniforme, de modo que un número que se actualiza en su lugar o una columna de números se mantenga alineada | Se ignora: los dígitos de la terminal ya ocupan una celda de ancho | Se ignora |

370

371Estas cuatro props requieren Claude Code v2.1.299 o posterior. En una versión anterior, Claude Code [dibuja su propia versión del sitio](/docs/es/plugins/mods/interface#build-a-tree-from-elements) en lugar de un árbol que establece `size`, `weight`, `mono` o `tabular`.

372

373<h4 id="text-bold">

374 Reemplaza `bold` por `weight`

375</h4>

376

377`bold` en un `Text` está obsoleto en favor de `weight` y sigue funcionando. Para reemplazarlo en un `Text` sin `weight`, cambia `bold: true` por `weight: 'semibold'` para obtener el mismo resultado en Claude Code v2.1.299 o posterior.

378

379En una versión anterior a v2.1.299, un árbol que establece `weight` no se dibuja, y Claude Code [dibuja su propia versión del sitio](/docs/es/plugins/mods/interface#build-a-tree-from-elements) en su lugar. Si estableces tanto `bold` como `weight` en un `Text`, `bold` no tiene efecto.

380

339<h2 id="limits">381<h2 id="limits">

340 Límites382 Límites

341</h2>383</h2>

plugins/mods/troubleshoot.md +13 −0

Details

235 235

236El mod se cargó, y su panel, banda, toast o controles no se comportan como esperas.236El mod se cargó, y su panel, banda, toast o controles no se comportan como esperas.

237 237

238<h3 id="another-mods-band-shows-and-yours-doesnt">

239 Se muestra la banda de otro mod y no la tuya

240</h3>

241

242Hay una sola banda encima del prompt, y todos los mods la comparten. Un mod que se ejecuta [antes que el tuyo](/docs/es/plugins/mods/events#the-order-mods-run-in) reemplaza tu banda cuando devuelve un árbol que no incluye el resultado de `next(e)`. Para mostrar ambas bandas, cambia el hook de ese mod, o pídele a su autor que lo haga:

243

244* **Conservar las bandas posteriores**: coloca el resultado de `await next(e)` entre los hijos de un `Box` en su árbol, como en la pestaña Banda encima del prompt de [Elegir dónde dibujar](/docs/es/plugins/mods/interface#pick-where-to-draw)

245* **Mantener el árbol válido**: no le des a ese `Box`, ni a ningún `Box` que lo rodee, una prop `width`, `height`, `minWidth`, `minHeight`, `position`, `top`, `left`, `right`, `bottom`, `display` u `overflow`

246

247Para encontrar ese mod, [escribe un registro de depuración](#read-the-debug-log) y busca en él `answered ui.render without next()`. Una línea como `other-mod (user) answered ui.render without next()` nombra un mod que devolvió su árbol sin llamar a `next(e)`. No nombra el [punto de renderizado](/docs/es/plugins/mods/reference#render-sites), así que también puede aparecer un mod que solo dibuja un panel. Un mod que llama a `next(e)` y descarta el resultado no genera ninguna línea, así que revisa también los hooks que se ejecutan antes del tuyo.

248

249Después del cambio, no ves nada en la banda si alguno de los mods devuelve un árbol que no pasa la validación. Para leer el motivo, busca una línea `ui.render (AbovePrompt) refused:` en la transcripción de una sesión con `--plugin-dir`, o busca `does not validate` en el registro de depuración. Con varios mods en la banda, ninguna de las dos líneas nombra un mod, así que revisa el árbol de cada mod.

250

238<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">251<h3 id="a-pane-or-band-is-empty-or-shows-claude-code’s-usual-content">

239 Un panel o una banda está vacío o muestra el contenido habitual de Claude Code252 Un panel o una banda está vacío o muestra el contenido habitual de Claude Code

240</h3>253</h3>

sandboxing.md +2 −2

Details

199 199

200Incluso en el modo auto-allow, sigue aplicándose lo siguiente:200Incluso en el modo auto-allow, sigue aplicándose lo siguiente:

201 201

202* Las [reglas de denegación](/docs/es/permissions) explícitas siempre se respetan202* Un comando con una [forma que coincide con una regla de denegación de `Bash`](/docs/es/permissions#bash-rule-limits) sigue bloqueado

203* Los comandos `rm` o `rmdir` que apuntan a una [ruta crítica](/docs/es/permission-modes#critical-paths) siguen pasando por el flujo de permisos habitual203* Los comandos `rm` o `rmdir` que se reconocen como dirigidos a una [ruta crítica](/docs/es/permission-modes#which-paths-are-critical) siguen pasando por el flujo de permisos habitual

204* Las [reglas de consulta](/docs/es/permissions) limitadas por contenido, como `Bash(git push *)`, siguen forzando una solicitud de permiso incluso para los comandos del sandbox204* Las [reglas de consulta](/docs/es/permissions) limitadas por contenido, como `Bash(git push *)`, siguen forzando una solicitud de permiso incluso para los comandos del sandbox

205* Una regla de consulta `Bash` sin más, o la forma equivalente `Bash(*)`, se omite para los comandos que se ejecutan en el sandbox; sigue aplicándose a los comandos que se ejecutan fuera del sandbox. En el [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode), la regla no se omite: también pide confirmación para los comandos del sandbox, incluidos los de solo lectura205* Una regla de consulta `Bash` sin más, o la forma equivalente `Bash(*)`, se omite para los comandos que se ejecutan en el sandbox; sigue aplicándose a los comandos que se ejecutan fuera del sandbox. En el [modo plan](/docs/es/permission-modes#analyze-before-you-edit-with-plan-mode), la regla no se omite: también pide confirmación para los comandos del sandbox, incluidos los de solo lectura

206* Los comandos de la [herramienta Monitor](/docs/es/tools-reference#monitor-tool) no se aprueban automáticamente, aunque siguen ejecutándose en el sandbox. Para omitir la solicitud de permiso, agrega una [regla de permiso](/docs/es/permissions#bash) que coincida con el comando, como `Bash(npm run *)`206* Los comandos de la [herramienta Monitor](/docs/es/tools-reference#monitor-tool) no se aprueban automáticamente, aunque siguen ejecutándose en el sandbox. Para omitir la solicitud de permiso, agrega una [regla de permiso](/docs/es/permissions#bash) que coincida con el comando, como `Bash(npm run *)`

security.md +1 −1

Details

114 Seguridad del IDE114 Seguridad del IDE

115</h2>115</h2>

116 116

117Consulte [Seguridad y privacidad de VS Code](/docs/es/vs-code#security-and-privacy) para obtener más información sobre cómo ejecutar Claude Code en un IDE.117Consulta [El servidor MCP integrado del IDE](/docs/es/vs-code#the-built-in-ide-mcp-server) para obtener más información sobre cómo ejecutar Claude Code en un IDE.

118 118

119<h2 id="cloud-execution-security">119<h2 id="cloud-execution-security">

120 Seguridad de ejecución en la nube120 Seguridad de ejecución en la nube

security-guidance.md +1 −1

Details

42Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:42Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

43 43

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

~~45* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.~~45* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

46 46

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

48 48

skills.md +9 −5

Details

718 718

719Si invocas un skill con argumentos pero ningún marcador de posición en el contenido del skill recibe uno, Claude Code añade `ARGUMENTS: <your input>` al final del contenido del skill para que Claude aún vea lo que escribiste. Un marcador de posición es `$ARGUMENTS`, una forma indexada como `$1`, o un argumento nombrado. Un marcador de posición indexado sin argumento en su posición permanece como texto literal y no cuenta como recibiendo uno. Un marcador de posición nombrado cuenta incluso cuando su posición no tiene argumento, porque se expande a una cadena vacía.719Si invocas un skill con argumentos pero ningún marcador de posición en el contenido del skill recibe uno, Claude Code añade `ARGUMENTS: <your input>` al final del contenido del skill para que Claude aún vea lo que escribiste. Un marcador de posición es `$ARGUMENTS`, una forma indexada como `$1`, o un argumento nombrado. Un marcador de posición indexado sin argumento en su posición permanece como texto literal y no cuenta como recibiendo uno. Un marcador de posición nombrado cuenta incluso cuando su posición no tiene argumento, porque se expande a una cadena vacía.

720 720

721También puedes apilar varios skills al inicio de un mensaje. Escribir `/write-tests /fix-issue 123` carga ambos skills y pasa el texto final `123` como `$ARGUMENTS` a cada uno de ellos.

~~722~~

723Claude Code expande el primer skill más hasta cinco más apilados después de él. La expansión se detiene en el primer token que no es un skill invocable por el usuario en línea, por lo que un skill que se ejecuta como un [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/es/code-review-local), o uno cuyos argumentos pueden en sí mismos comenzar con un comando de barra, como `/loop`, también termina la ejecución allí. Ese token y todo lo que viene después se convierte en el texto de argumento para cada skill expandido. `/code-review` se ejecuta como un subagente bifurcado desde v2.1.218; en versiones anteriores se ejecutaba en línea y se apilaba.

~~724~~

725Para acceder a argumentos individuales por posición, usa `$ARGUMENTS[N]` o la forma más corta `$N`:721Para acceder a argumentos individuales por posición, usa `$ARGUMENTS[N]` o la forma más corta `$N`:

726 722

727```yaml theme={null}723```yaml theme={null}

746Preserve all existing behavior and tests.742Preserve all existing behavior and tests.

747```743```

748 744

745<h4 id="stack-several-skills-in-one-message">

746 Apilar varios skills en un mensaje

747</h4>

748

749Cuando escribes en el prompt de Claude Code en tu terminal, puedes apilar varios skills al inicio de un mensaje. A través del Agent SDK o `claude -p`, Claude Code carga solo el primer skill, con el resto de la línea como sus argumentos. En el prompt de la terminal, escribir `/write-tests /fix-issue 123` carga ambos skills y pasa el texto final `123` como `$ARGUMENTS` a cada uno de ellos.

750

751Claude Code expande el primer skill más hasta cinco más apilados después de él. La expansión se detiene en el primer token que no es un skill invocable por el usuario en línea. Si apilas un skill que se ejecuta como un [subagente bifurcado](#run-skills-in-a-subagent), como [`/code-review`](/docs/es/code-review-local), o uno cuyos argumentos pueden comenzar con otro comando, como `/loop`, la expansión termina allí. Ese token y todo lo que viene después se convierten en el texto de argumento para cada skill expandido.

752

749<h2 id="advanced-patterns">753<h2 id="advanced-patterns">

750 Patrones avanzados754 Patrones avanzados

751</h2>755</h2>

1044Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:1048Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:

1045 1049

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

1047* El plugin [no se encuentra en el marketplace](/docs/es/plugins/install#install-a-plugin): verifique el nombre del plugin.1051* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con `/plugin marketplace update claude-plugins-official` y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta [Plugin no encontrado en el marketplace](/docs/es/plugins/troubleshooting#plugin-not-found-in-marketplace).

1048 1052

1049Si el resumen de instalación reporta `Run /reload-plugins to apply.`, Claude Code ejecuta esa recarga por ti. Si la recarga advierte que tu próximo mensaje volvería a leer la conversación, ejecuta `/reload-plugins --force` para que los skills del plugin estén disponibles en la sesión actual. Luego pide a Claude que evalúe un skill existente, por ejemplo `evaluate my summarize-changes skill with skill-creator`. El plugin te guía a través de la escritura de casos de prueba y ejecuta el bucle:1053Si el resumen de instalación reporta `Run /reload-plugins to apply.`, Claude Code ejecuta esa recarga por ti. Si la recarga advierte que tu próximo mensaje volvería a leer la conversación, ejecuta `/reload-plugins --force` para que los skills del plugin estén disponibles en la sesión actual. Luego pide a Claude que evalúe un skill existente, por ejemplo `evaluate my summarize-changes skill with skill-creator`. El plugin te guía a través de la escritura de casos de prueba y ejecuta el bucle:

1050 1054

terminal-config.md +2 −1

Details

281 Modo de pantalla completa281 Modo de pantalla completa

282 </h4>282 </h4>

283 283

284 Claude Code pinta `userMessageBackground`, `bashMessageBackgroundColor` y `memoryBackgroundColor` en los renderizadores predeterminado y de pantalla completa. Utiliza `userMessageBackgroundHover` y `selectionBg` solo en [modo de representación de pantalla completa](/docs/es/fullscreen).284 Claude Code utiliza `userMessageBackgroundHover`, `selectionBg` y `composerSidebarBackground` solo en [modo de representación de pantalla completa](/docs/es/fullscreen). Pinta `userMessageBackground`, `bashMessageBackgroundColor` y `memoryBackgroundColor` en los renderizadores predeterminado y de pantalla completa.

285 285

286 | Token | Controla |286 | Token | Controla |

287 | :- | :- |287 | :- | :- |

293 | `composerSidebarBackground` | Fondo del panel junto a la conversación, como el [panel de diff](/docs/es/fullscreen#watch-your-changes-in-the-diff-panel) o el [panel de un mod](/docs/es/plugins/mods/interface) |

293 294

294 <h4 id="usage-meter-and-speaker-labels">295 <h4 id="usage-meter-and-speaker-labels">

295 Medidor de uso y etiquetas de altavoz296 Medidor de uso y etiquetas de altavoz

vs-code.md +484 −421

Details

8 8

9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Editor de VS Code con el panel de extensión Claude Code abierto en el lado derecho, mostrando una conversación con Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />9<img src="https://mintcdn.com/claude-code/-YhHHmtSxwr7W8gy/images/vs-code-extension-interface.jpg?fit=max&auto=format&n=-YhHHmtSxwr7W8gy&q=85&s=300652d5678c63905e6b0ea9e50835f8" alt="Editor de VS Code con el panel de extensión Claude Code abierto en el lado derecho, mostrando una conversación con Claude" width="2500" height="1155" data-path="images/vs-code-extension-interface.jpg" />

10 10

~~11La extensión de VS Code proporciona una interfaz gráfica nativa para Claude Code, integrada directamente en su IDE. Esta es la forma recomendada de usar Claude Code en VS Code.~~11La extensión de VS Code proporciona una interfaz gráfica nativa para Claude Code, integrada directamente en tu IDE. Esta es la forma recomendada de usar Claude Code en VS Code.

12 12

13Con la extensión, puede revisar y editar los planes de Claude antes de aceptarlos, aceptar automáticamente ediciones a medida que se realizan, mencionar archivos con rangos de líneas específicas de su selección, acceder al historial de conversaciones y abrir múltiples conversaciones en pestañas o ventanas separadas.13Con la extensión, puedes:

15* Revisar y editar los planes de Claude antes de aceptarlos

16* Aceptar automáticamente las ediciones a medida que se realizan

17* Mencionar con @ archivos con rangos de líneas específicos de tu selección

18* Acceder al historial de conversaciones

19* Abrir múltiples conversaciones en pestañas o ventanas separadas

14 20

15<h2 id="prerequisites">21<h2 id="prerequisites">

16 Requisitos previos22 Requisitos previos

29 Instalar la extensión35 Instalar la extensión

30</h2>36</h2>

31 37

~~32Haz clic en el enlace de tu IDE para instalar directamente:~~38Haz clic en el enlace de tu IDE para instalarla directamente:

33 39

34* [Instalar para VS Code](vscode:extension/anthropic.claude-code)40* [Instalar para VS Code](vscode:extension/anthropic.claude-code)

35* [Instalar para Cursor](cursor:extension/anthropic.claude-code)41* [Instalar para Cursor](cursor:extension/anthropic.claude-code)

36 42

~~37O en VS Code, presiona `Cmd+Shift+X` (Mac) o `Ctrl+Shift+X` (Windows/Linux) para abrir la vista Extensiones, busca "Claude Code" y haz clic en **Instalar**.~~43O bien, en VS Code, presiona `Cmd+Shift+X` (Mac) o `Ctrl+Shift+X` (Windows/Linux) para abrir la vista de Extensiones, busca "Claude Code" y haz clic en **Install**.

38 44

39El número de versión de la extensión es la versión de Claude Code que incluye. Por ejemplo, una función que requiere Claude Code v2.1.286 o posterior necesita la versión 2.1.286 o posterior de la extensión, que se muestra en la vista Extensiones.45El número de versión de la extensión es la versión de Claude Code que incluye. Por ejemplo, una función que requiere Claude Code v2.1.286 o posterior necesita la versión 2.1.286 o posterior de la extensión, que se muestra en la vista de Extensiones.

40 46

41La extensión también se instala en otros forks de VS Code como Devin Desktop o Kiro. Busca "Claude Code" en la vista Extensiones del editor, o instala desde el [registro Open VSX](https://open-vsx.org/extension/Anthropic/claude-code). Si tu editor no puede instalar la extensión, [instala la CLI](/docs/es/quickstart) y ejecuta `claude` en su terminal integrada en su lugar. La CLI funciona en cualquier terminal.47Claude Code también se ejecuta en otros editores y contenedores:

42 48

~~43Para ejecutar Claude Code dentro de un contenedor de desarrollo, consulta [Contenedores de desarrollo](/docs/es/devcontainer).~~49* **Otros forks de VS Code**: la extensión también se instala en forks como Devin Desktop o Kiro. Busca "Claude Code" en la vista de Extensiones del editor, o instálala desde el [registro de Open VSX](https://open-vsx.org/extension/Anthropic/claude-code).

50* **Editores que no pueden instalar la extensión**: [instala la CLI](/docs/es/quickstart) y ejecuta `claude` en la terminal integrada del editor. La CLI funciona en cualquier terminal.

51* **Dev containers**: para ejecutar Claude Code dentro de un dev container, consulta [Contenedores de desarrollo](/docs/es/devcontainer).

44 52

~~45<Note>Si la extensión no aparece después de la instalación, reinicia VS Code o ejecuta "Developer: Reload Window" desde la Paleta de comandos.</Note>~~53<Note>Si la extensión no aparece después de la instalación, reinicia VS Code o ejecuta "Developer: Reload Window" desde la paleta de comandos.</Note>

46 54

47<h2 id="get-started">55<h2 id="get-started">

~~48 Comenzar~~56 Primeros pasos

49</h2>57</h2>

50 58

~~51Una vez instalado, puede comenzar a usar Claude Code a través de la interfaz de VS Code:~~59Una vez instalado, puedes empezar a usar Claude Code a través de la interfaz de VS Code:

52 60

53<Steps>61<Steps>

~~54 <Step title="Abrir el panel de Claude Code">~~62 <Step title="Abre el panel de Claude Code">

55 En todo VS Code, el icono Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Icono Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />63 En todo VS Code, el ícono Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Ícono Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

56 64

57 La forma más rápida de abrir Claude es hacer clic en el icono Spark en la **Barra de herramientas del editor** (esquina superior derecha del editor). El icono solo aparece cuando tiene un archivo abierto.65 La forma más rápida de abrir Claude es hacer clic en el ícono Spark en la **Editor Toolbar** (esquina superior derecha del editor). El ícono solo aparece cuando tienes un archivo abierto.

58 66

59 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="VS Code editor mostrando el icono Spark en la Barra de herramientas del editor" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />67 <img src="https://mintcdn.com/claude-code/mfM-EyoZGnQv8JTc/images/vs-code-editor-icon.png?fit=max&auto=format&n=mfM-EyoZGnQv8JTc&q=85&s=eb4540325d94664c51776dbbfec4cf02" alt="Editor de VS Code mostrando el ícono Spark en la Editor Toolbar" width="2796" height="734" data-path="images/vs-code-editor-icon.png" />

60 68

61 Otras formas de abrir Claude Code:69 Otras formas de abrir Claude Code:

62 70

63 * **Barra de actividades**: haga clic en el icono Spark en la barra lateral izquierda para abrir la lista de sesiones. Haga clic en cualquier sesión para abrirla en su [ubicación preferida](#extension-settings), o inicie una nueva. Este icono siempre es visible en la Barra de actividades.71 * **Activity Bar**: haz clic en el ícono Spark en la barra lateral izquierda para abrir la lista de sesiones. Haz clic en cualquier sesión para abrirla en tu [ubicación preferida](#extension-settings), o inicia una nueva. Este ícono siempre está visible en la Activity Bar.

~~64 * **Paleta de comandos**: `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux), escriba "Claude Code" y seleccione una opción como "Open in New Tab"~~72 * **Command Palette**: `Cmd+Shift+P` (Mac) o `Ctrl+Shift+P` (Windows/Linux), escribe "Claude Code" y selecciona una opción como "Open in New Tab"

~~65 * **Barra de estado**: haga clic en **✻ Claude Code** en la esquina inferior derecha de la ventana. Esto funciona incluso cuando no hay ningún archivo abierto.~~73 * **Status Bar**: haz clic en **✻ Claude Code** en la esquina inferior derecha de la ventana. Esto funciona incluso cuando no hay ningún archivo abierto.

66 74

~~67 Puede arrastrar el panel de Claude para reposicionarlo en cualquier lugar de VS Code. Consulte [Personalizar su flujo de trabajo](#customize-your-workflow) para obtener más detalles.~~75 Puedes arrastrar el panel de Claude para reubicarlo en cualquier lugar de VS Code. Consulta [Personaliza tu flujo de trabajo](#customize-your-workflow) para más detalles.

68 </Step>76 </Step>

69 77

~~70 <Step title="Iniciar sesión">~~78 <Step title="Inicia sesión">

~~71 La primera vez que abre el panel, aparece una pantalla de inicio de sesión. Haga clic en **Sign in** y complete la autorización en su navegador.~~79 La primera vez que abres el panel, aparece una pantalla de inicio de sesión. Haz clic en **Sign in** y completa la autorización en tu navegador.

72 80

73 Si ve **Not logged in · Please run /login** más tarde, la extensión reabre la pantalla de inicio de sesión automáticamente. Si no aparece, recargue la ventana desde la Paleta de comandos con **Developer: Reload Window**.81 Si más adelante ves **Not logged in · Please run /login**, la extensión vuelve a abrir la pantalla de inicio de sesión automáticamente. Si no aparece, recarga la ventana desde la Command Palette con **Developer: Reload Window**.

74 82

75 Si tiene `ANTHROPIC_API_KEY` establecido en su shell pero aún ve el mensaje de inicio de sesión, es posible que VS Code no haya heredado su entorno de shell. Inicie VS Code desde una terminal con `code .` para que herede sus variables de entorno, o inicie sesión con su cuenta de Claude en su lugar.83 Si tienes `ANTHROPIC_API_KEY` configurada en tu shell pero aún ves la solicitud de inicio de sesión, es posible que VS Code no haya heredado el entorno de tu shell. Inicia VS Code desde una terminal con `code .` para que herede tus variables de entorno, o inicia sesión con tu cuenta de Claude en su lugar.

76 84

77 Después de iniciar sesión, aparece una lista de verificación **Learn Claude Code**. Trabaje en cada elemento haciendo clic en **Show me**, o descártelo con la X. Para reabrirlo más tarde, desmarque **Hide Onboarding** en la configuración de VS Code en Extensions → Claude Code.85 Después de iniciar sesión, aparece una lista de verificación **Learn Claude Code**. Completa cada elemento haciendo clic en **Show me**, o ciérrala con la X. Para volver a abrirla más tarde, desmarca **Hide Onboarding** en la configuración de VS Code en **Extensions > Claude Code**.

78 </Step>86 </Step>

79 87

~~80 <Step title="Enviar un mensaje">~~88 <Step title="Envía un prompt">

~~81 Pida a Claude que le ayude con su código o archivos, ya sea explicando cómo funciona algo, depurando un problema o realizando cambios.~~89 Pídele a Claude que te ayude con tu código o tus archivos, ya sea explicando cómo funciona algo, depurando un problema o haciendo cambios.

82 90

83 <Tip>Claude ve automáticamente el texto seleccionado. Presione `Option+K` (Mac) / `Alt+K` (Windows/Linux) para insertar también una referencia @-mention (como `@file.ts#5-10`) en su mensaje.</Tip>91 <Tip>Claude ve automáticamente el texto que seleccionas. Presiona `Option+K` (Mac) / `Alt+K` (Windows/Linux) para además insertar una referencia de @-mención (como `@file.ts#5-10`) en tu prompt.</Tip>

84 92

~~85 Aquí hay un ejemplo de cómo hacer una pregunta sobre una línea particular en un archivo:~~93 Este es un ejemplo de cómo preguntar sobre una línea específica de un archivo:

86 94

87 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="VS Code editor con las líneas 2-3 seleccionadas en un archivo Python, y el panel de Claude Code mostrando una pregunta sobre esas líneas con una referencia @-mention" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />95 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-send-prompt.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=ede3ed8d8d5f940e01c5de636d009cfd" alt="Editor de VS Code con las líneas 2-3 seleccionadas en un archivo de Python, y el panel de Claude Code mostrando una pregunta sobre esas líneas con una referencia de @-mención" width="3288" height="1876" data-path="images/vs-code-send-prompt.png" />

88 </Step>96 </Step>

89 97

~~90 <Step title="Revisar cambios">~~98 <Step title="Revisa los cambios">

~~91 Lo que ve depende del [modo de permiso](/docs/es/permission-modes#which-mode-a-session-starts-in) que se muestra en la parte inferior del cuadro de mensaje:~~99 <span id="security-considerations" />

100

101 <span id="security-and-privacy" />

102

103 Revisa el [modo de permisos](/docs/es/permission-modes#which-mode-a-session-starts-in) que se muestra en la parte inferior del cuadro del prompt:

92 104

~~93 * En modo Auto o Edit automatically, Claude edita la mayoría de los archivos en su espacio de trabajo sin preguntar.~~105 * En el modo Auto o Edit automatically, Claude edita [la mayoría de los archivos](/docs/es/permission-modes#protected-paths) de tu espacio de trabajo sin preguntar.

94 * En modo Manual, cuando Claude quiere editar un archivo, muestra una comparación lado a lado del original y los cambios propuestos, luego solicita permiso. Puede aceptar, rechazar o decirle a Claude qué hacer en su lugar. Si edita el contenido propuesto directamente en la vista de diferencias antes de aceptar, Claude es informado de que lo modificó para que no asuma que el archivo coincide con su propuesta original.106 * En el modo Manual, cuando Claude quiere editar un archivo, muestra una comparación lado a lado del original y de los cambios propuestos, y luego pide permiso. Puedes aceptar, rechazar o decirle a Claude qué hacer en su lugar. Si editas el contenido propuesto directamente en la vista de diff antes de aceptar, se le informa a Claude que lo modificaste para que no asuma que el archivo coincide con su propuesta original.

95 107

96 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando una diferencia de los cambios propuestos por Claude con un mensaje de permiso preguntando si realizar la edición" width="3292" height="1876" data-path="images/vs-code-edits.png" />108 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code mostrando un diff de los cambios propuestos por Claude con una solicitud de permiso que pregunta si se debe realizar la edición" width="3292" height="1876" data-path="images/vs-code-edits.png" />

97 109

98 Para revisar una edición propuesta un cambio a la vez, use los botones **Accept this change** y **Reject this change** bajo cada cambio en la diferencia. Rechazar un cambio lo revierte en el contenido propuesto; aceptarlo lo marca como revisado. Aceptar o rechazar el archivo completo aún finaliza la revisión. Una diferencia con más de 100 cambios se abre sin los botones por cambio, así que revísela como un archivo completo. La revisión por cambio requiere Claude Code v2.1.275 o posterior.110 Para revisar una edición propuesta cambio por cambio, usa los botones **Accept this change** y **Reject this change** debajo de cada cambio en el diff. Rechazar un cambio lo revierte en el contenido propuesto; aceptarlo lo marca como revisado. La revisión por cambio requiere Claude Code v2.1.275 o posterior.

99 111

100 Las mismas acciones están disponibles en el cursor desde el menú contextual del editor y desde la Paleta de comandos como **Claude Code: Accept Change at Cursor** y **Claude Code: Reject Change at Cursor**.112 Aceptar o rechazar el archivo completo sigue finalizando la revisión. Un diff con más de 100 cambios se abre sin los botones por cambio, así que revísalo como un archivo completo.

113

114 Las mismas acciones están disponibles en la posición del cursor desde el menú contextual del editor y desde la Command Palette como **Claude Code: Accept Change at Cursor** y **Claude Code: Reject Change at Cursor**.

101 </Step>115 </Step>

102</Steps>116</Steps>

103 117

104Para más ideas sobre lo que puede hacer con Claude Code, consulte [Flujos de trabajo comunes](/docs/es/common-workflows).118Para más ideas sobre lo que puedes hacer con Claude Code, consulta [Flujos de trabajo comunes](/docs/es/common-workflows).

105 119

106<Tip>120<Tip>

107 Ejecute "Claude Code: Open Walkthrough" desde la Paleta de comandos para un tour guiado de los conceptos básicos.121 Ejecuta "Claude Code: Open Walkthrough" desde la Command Palette para un recorrido guiado por lo básico.

108</Tip>122</Tip>

109 123

110<h2 id="use-the-prompt-box">124<h2 id="use-the-prompt-box">

113 127

114El cuadro de prompt admite varias funciones:128El cuadro de prompt admite varias funciones:

115 129

116* **Modos de permisos**: haz clic en el indicador de modo en la parte inferior del cuadro de prompt para cambiar de modo de permisos. Con Claude Code v2.1.283 o posterior, Auto es el modo de permisos inicial integrado; en versiones anteriores, solo en los planes Pro, Max y Team. Consulta [cómo elige la extensión el modo de permisos inicial](/docs/es/permission-modes#switch-permission-modes) para saber qué lo cambia y conocer todos los modos de permisos que ofrece el indicador.130* **Modos de permisos**: haz clic en el indicador de modo en la parte inferior del cuadro de prompt para cambiar de modo de permisos. Con Claude Code v2.1.283 o posterior, Auto es el modo de permisos inicial integrado; en versiones anteriores, solo lo es en los planes Pro, Max y Team. Consulta [cómo elige la extensión el modo de permisos inicial](/docs/es/permission-modes#switch-permission-modes) para saber qué lo cambia y conocer todos los modos de permisos que ofrece el indicador.

117 * **Auto**: un clasificador revisa la mayoría de las acciones en lugar de preguntarte. Consulta [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) para saber qué revisa y qué bloquea.131 * **Auto**: un clasificador revisa la mayoría de las acciones en lugar de preguntarte. Consulta [modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode) para saber qué revisa y qué bloquea.

118 * **Manual**: Claude pide permiso antes de editar archivos y de ejecutar la mayoría de los comandos de shell.132 * **Manual**: Claude pide permiso antes de editar archivos y de ejecutar la mayoría de los comandos de shell.

119 * **Plan**: Claude describe lo que hará y espera tu aprobación antes de hacer cambios. VS Code abre automáticamente el plan como un documento Markdown completo donde puedes agregar comentarios en línea para dar retroalimentación antes de que Claude comience.133 * **Plan**: Claude describe lo que hará y espera tu aprobación antes de hacer cambios. VS Code abre automáticamente el plan como un documento Markdown completo donde puedes agregar comentarios en línea para dar retroalimentación antes de que Claude comience.

120 134

121 También puedes escribir `/plan` en el cuadro de prompt. Requiere Claude Code v2.1.280 o posterior.135 También puedes escribir `/plan` en el cuadro de prompt. Requiere Claude Code v2.1.280 o posterior.

122 136

123 * `/plan`: cambia al modo plan. Si ya estás en modo plan, muestra el plan actual.137 * `/plan`: cambia a modo plan. Si ya estás en modo plan, muestra el plan actual.

124 * `/plan` con una tarea, como `/plan fix the auth bug`: cambia al modo plan y comienza a planificar esa tarea.138 * `/plan` con una tarea, como `/plan fix the auth bug`: cambia a modo plan y comienza a planificar esa tarea.

125 * `/plan open`: cuando ya estás en modo plan, abre el archivo del plan en el editor.139 * `/plan open`: cuando ya estás en modo plan, abre el archivo del plan en el editor.

126 * **Editar automáticamente**: Claude hace ediciones sin preguntar.140 * **Edit automatically**: Claude hace ediciones sin preguntar.

127* **Modelo**: selecciona **Switch model…** en el menú de comandos para cambiar el modelo a mitad de la sesión. También puedes hacer clic en el nombre del modelo en la parte inferior del cuadro de prompt para abrir el mismo selector. Con Claude Code v2.1.284 o posterior, escribir `/model` por sí solo en el cuadro de prompt también abre el selector.141* **Modelo**: selecciona **Switch model…** en el menú de comandos para cambiar el modelo a mitad de la sesión. También puedes hacer clic en el nombre del modelo en la parte inferior del cuadro de prompt para abrir el mismo selector. Con Claude Code v2.1.284 o posterior, escribir `/model` solo en el cuadro de prompt también abre el selector.

128 142

129 Cuando el modelo actual admite [niveles de esfuerzo](/docs/es/model-config#adjust-effort-level), el selector también muestra una fila **Effort** y el botón del nombre del modelo muestra el nivel seleccionado. Cuando eliges un nivel distinto de `max`, Claude Code lo guarda como tu predeterminado para el modelo actual, en [`modelSettings`](/docs/es/settings-reference#modelsettings) de tu configuración de usuario; `max` se aplica solo a la sesión actual. El botón del nombre del modelo y la fila **Effort** requieren Claude Code v2.1.257 o posterior.143 Cuando el modelo actual admite [niveles de esfuerzo](/docs/es/model-config#adjust-effort-level), el selector también muestra una fila **Effort** y el botón con el nombre del modelo muestra el nivel seleccionado. Cuando eliges un nivel distinto de `max`, Claude Code lo guarda como tu valor predeterminado para el modelo actual, en [`modelSettings`](/docs/es/settings-reference#modelsettings) dentro de tu configuración de usuario; `max` se aplica solo a la sesión actual. El botón con el nombre del modelo y la fila **Effort** requieren Claude Code v2.1.257 o posterior.

130 144

131 Cuando los [flujos de trabajo dinámicos](/docs/es/workflows) están habilitados y el modelo actual los admite, aparece un interruptor **Ultracode** debajo de la fila **Effort**. Actívalo para que Claude planifique un [flujo de trabajo](/docs/es/workflows#let-claude-decide-with-ultracode) para cada tarea sustancial de esta sesión, con el nivel de esfuerzo seleccionado. Mientras está activado, el botón del nombre del modelo muestra `· Ultracode` después del nivel. El interruptor requiere Claude Code v2.1.284 o posterior.145 Cuando los [flujos de trabajo dinámicos](/docs/es/workflows) están habilitados y el modelo actual los admite, aparece un interruptor **Ultracode** debajo de la fila **Effort**. Actívalo para que Claude planifique un [flujo de trabajo](/docs/es/workflows#let-claude-decide-with-ultracode) para cada tarea sustancial de esta sesión, con el nivel de esfuerzo seleccionado. Mientras está activado, el botón con el nombre del modelo muestra `· Ultracode` después del nivel. El interruptor requiere Claude Code v2.1.284 o posterior.

132* **Menú de comandos**: haz clic en `/` o escribe `/` para abrir el menú de comandos. Las opciones incluyen adjuntar archivos, cambiar de modelo y activar o desactivar el pensamiento extendido.146* **Menú de comandos**: haz clic en `/` o escribe `/` para abrir el menú de comandos. Las opciones incluyen adjuntar archivos, cambiar de modelo y activar o desactivar el pensamiento extendido.

133 147

134 La sección Customize incluye entradas como servidores MCP, comandos, estilos de salida, hooks, memoria, instrucciones, permisos y plugins. Los elementos con un ícono de terminal se abren en la terminal integrada.148 La sección Customize incluye entradas como servidores MCP, comandos, estilos de salida, hooks, memoria, instrucciones, permisos y plugins. Los elementos con un icono de terminal se abren en la terminal integrada.

135 149

136 * Para explorar comandos como `/usage` o [`/remote-control`](/docs/es/remote-control), selecciona **Slash commands** en la sección Customize. Un cuadro de diálogo los enumera con un cuadro de filtro. Elige uno para ejecutarlo. Escribir `/` en el cuadro de prompt sigue sugiriendo comandos en línea. Requiere Claude Code v2.1.257 o posterior.150 * Para explorar comandos como `/usage` o [`/remote-control`](/docs/es/remote-control), selecciona **Slash commands** en la sección Customize. Un cuadro de diálogo los enumera con un cuadro de filtro. Elige uno para ejecutarlo. Escribir `/` en el cuadro de prompt sigue sugiriendo comandos en línea. Requiere Claude Code v2.1.257 o posterior.

137 151

140 154

141 Para crear un estilo personalizado, selecciona **Build a custom style** en el menú **Output styles**. Claude Code escribe el [archivo de estilo](/docs/es/output-styles#create-a-custom-output-style) por ti a nivel de proyecto o de usuario. Requiere Claude Code v2.1.261 o posterior.155 Para crear un estilo personalizado, selecciona **Build a custom style** en el menú **Output styles**. Claude Code escribe el [archivo de estilo](/docs/es/output-styles#create-a-custom-output-style) por ti a nivel de proyecto o de usuario. Requiere Claude Code v2.1.261 o posterior.

142 * Selecciona **Hooks** en la sección Customize para ver los [hooks](/docs/es/hooks) cargados en la sesión, agrupados por evento. Puedes agregar, editar o eliminar hooks guardados en tus archivos de configuración de usuario, de proyecto y local. Los hooks de otras fuentes, como la configuración administrada o los plugins, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.156 * Selecciona **Hooks** en la sección Customize para ver los [hooks](/docs/es/hooks) cargados en la sesión, agrupados por evento. Puedes agregar, editar o eliminar hooks guardados en tus archivos de configuración de usuario, de proyecto y local. Los hooks de otras fuentes, como la configuración administrada o los plugins, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.

143 * Selecciona **Permissions** en la sección Customize para ver las [reglas de permisos](/docs/es/permissions) de la sesión, agrupadas en Allow, Ask y Deny. Puedes agregar reglas a tu configuración de usuario, de proyecto o local y eliminar las reglas guardadas allí. Las reglas de otras fuentes, como la configuración administrada o las aprobaciones hechas solo para esta sesión, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.157 * Selecciona **Permissions** en la sección Customize para ver las [reglas de permisos](/docs/es/permissions) de la sesión, agrupadas en Allow, Ask y Deny. Puedes agregar reglas a tu configuración de usuario, de proyecto o local, y eliminar las reglas guardadas allí. Las reglas de otras fuentes, como la configuración administrada o las aprobaciones hechas solo para esta sesión, son de solo lectura. Requiere Claude Code v2.1.269 o posterior.

144 * Selecciona **Memory** en la sección Customize para activar o desactivar la [memoria automática](/docs/es/memory#auto-memory). Mientras está activada, también puedes explorar las memorias que Claude ha guardado y mostrar en tu administrador de archivos las carpetas que las almacenan. Requiere Claude Code v2.1.274 o posterior.158 * Selecciona **Memory** en la sección Customize para activar o desactivar la [memoria automática](/docs/es/memory#auto-memory). Mientras está activada, también puedes explorar las memorias que Claude ha guardado y mostrar en tu administrador de archivos las carpetas que las almacenan. Requiere Claude Code v2.1.274 o posterior.

145 159

146 Haz clic en una memoria guardada para leerla en el cuadro de diálogo, donde puedes editar el texto, eliminar la memoria o abrir su archivo en el editor. Ver, editar y eliminar una memoria en el cuadro de diálogo requiere Claude Code v2.1.275 o posterior.160 Haz clic en una memoria guardada para leerla en el cuadro de diálogo, donde puedes editar el texto, eliminar la memoria o abrir su archivo en el editor. Ver, editar y eliminar una memoria en el cuadro de diálogo requiere Claude Code v2.1.275 o posterior.

147 * Selecciona **Instructions** en la sección Customize para editar los [archivos CLAUDE.md](/docs/es/memory#claude-md-files) que lee Claude. Elige un archivo para abrirlo en el editor. Si el archivo aún no existe, Claude Code lo crea primero. Requiere Claude Code v2.1.274 o posterior.161 * Selecciona **Instructions** en la sección Customize para editar los [archivos CLAUDE.md](/docs/es/memory#claude-md-files) que Claude lee. Elige un archivo para abrirlo en el editor. Si el archivo aún no existe, Claude Code lo crea primero. Requiere Claude Code v2.1.274 o posterior.

148 * Selecciona **Status** en la sección Customize, o escribe `/status`, para consultar la versión de Claude Code, la cuenta, el modelo y los detalles de los servidores MCP de la sesión. Requiere Claude Code v2.1.280 o posterior.162 * Selecciona **Status** en la sección Customize, o escribe `/status`, para consultar la versión de Claude Code, la cuenta, el modelo y los detalles de los servidores MCP de la sesión. Requiere Claude Code v2.1.280 o posterior.

149 * Selecciona **Sandbox** en la sección Customize, o escribe `/sandbox`, para ver si los comandos de Bash de Claude se ejecutan [en el sandbox](/docs/es/sandboxing). Allí puedes cambiar el modo del sandbox y agregar [comandos excluidos](/docs/es/settings-reference#sandbox-excludedcommands). Requiere Claude Code v2.1.280 o posterior.163 * Selecciona **Sandbox** en la sección Customize, o escribe `/sandbox`, para ver si los comandos Bash de Claude se ejecutan [en el sandbox](/docs/es/sandboxing). Allí puedes cambiar el modo del sandbox y agregar [comandos excluidos](/docs/es/settings-reference#sandbox-excludedcommands). Requiere Claude Code v2.1.280 o posterior.

150 * Selecciona **Claude in Chrome** en la sección Customize, o escribe `/chrome`, para comprobar y administrar la conexión de [Claude in Chrome](/docs/es/chrome). Ambas opciones requieren iniciar sesión con una cuenta de claude.ai. Requiere Claude Code v2.1.280 o posterior.164 * Selecciona **Claude in Chrome** en la sección Customize, o escribe `/chrome`, para comprobar y administrar la conexión de [Claude in Chrome](/docs/es/chrome). Ambas opciones requieren iniciar sesión con una cuenta de claude.ai. Requiere Claude Code v2.1.280 o posterior.

151 * Selecciona **Export conversation** en la sección Context, o escribe `/export`, para copiar la conversación como texto sin formato o guardarla en un archivo. Agrega un nombre de archivo, como `/export notes.txt`, para omitir el cuadro de diálogo y elegir dónde guardar el archivo. Requiere Claude Code v2.1.280 o posterior.165 * Selecciona **Export conversation** en la sección Context, o escribe `/export`, para copiar la conversación como texto sin formato o guardarla en un archivo. Agrega un nombre de archivo, como `/export notes.txt`, para omitir el cuadro de diálogo y elegir dónde guardar el archivo. Requiere Claude Code v2.1.280 o posterior.

152 * La sección Settings incluye **Enable Remote Control for all sessions**, que establece [`remoteControlAtStartup`](/docs/es/settings-reference#remotecontrolatstartup) para controlar si [las nuevas sesiones interactivas se conectan automáticamente a Remote Control](/docs/es/remote-control#enable-remote-control-for-all-sessions). Requiere Claude Code v2.1.203 o posterior.166 * La sección Settings incluye **Enable Remote Control for all sessions**, que establece [`remoteControlAtStartup`](/docs/es/settings-reference#remotecontrolatstartup) para controlar si [las nuevas sesiones interactivas se conectan automáticamente a Remote Control](/docs/es/remote-control#enable-remote-control-for-all-sessions). Requiere Claude Code v2.1.203 o posterior.

153 167

154 Cuando activas o desactivas el interruptor en una ventana de VS Code, el cambio se aplica a las sesiones ya abiertas en esa ventana de VS Code, no solo a las sesiones que inicies después. Si lo desactivas, las sesiones abiertas se desconectan. Con Claude Code v2.1.261 o posterior, el cambio también llega a las sesiones abiertas en tus otras ventanas de VS Code.168 Cuando activas o desactivas el interruptor en una ventana de VS Code, el cambio no se limita a las sesiones que inicies después. También se aplica a las sesiones que ya están abiertas en esa ventana de VS Code. Si lo desactivas, las sesiones abiertas se desconectan. Con Claude Code v2.1.261 o posterior, el cambio también llega a las sesiones abiertas en tus otras ventanas de VS Code.

155 * La sección Settings también incluye **Focus view**, que oculta las llamadas a herramientas, los resultados de herramientas y el pensamiento detrás de filas expandibles, y deja visibles tus prompts y las respuestas de Claude. Actívala o desactívala allí, con `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), o desde la paleta de comandos con **Claude Code: Toggle Focus view**. El cambio se aplica a todas las sesiones abiertas y se conserva entre sesiones. Requiere Claude Code v2.1.221 o posterior.169 * La sección Settings también incluye **Focus view**, que oculta las llamadas a herramientas, los resultados de herramientas y el pensamiento detrás de filas expandibles, dejando visibles tus prompts y las respuestas de Claude. Actívala o desactívala allí, con `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux), o desde la paleta de comandos con **Claude Code: Toggle Focus view**. El cambio se aplica a todas las sesiones abiertas y se mantiene entre sesiones. Requiere Claude Code v2.1.221 o posterior.

170

171 La lista de tareas más reciente de Claude sigue visible, al igual que el texto sobre el que pregunta una pregunta pendiente de Claude; esto requiere Claude Code v2.1.225 o posterior. Mientras Claude ejecuta [subagentes](/docs/es/sub-agents), aparecen filas de progreso en vivo con su actividad más reciente debajo del grupo de llamadas a herramientas que los inició. Esto requiere Claude Code v2.1.269 o posterior.

172 * Para cerrar sesión en tu cuenta de Anthropic, selecciona **Sign out** en la sección Settings, o escribe `/logout`. Con un [proveedor externo](#use-third-party-providers), el menú no ofrece ninguna de las dos opciones. Requiere Claude Code v2.1.277 o posterior.

173 * Para reportar un error, haz clic en **Report a problem** en la parte inferior del menú, o escribe `/bug` o `/feedback` con una descripción opcional que completa previamente el reporte. Cuando envías el reporte y has iniciado sesión en Anthropic con una conexión de primera parte, Claude Code lo envía a Anthropic. Requiere Claude Code v2.1.229 o posterior.

156 174

157 La lista de tareas pendientes más reciente de Claude sigue visible, al igual que el texto sobre el que pregunta una pregunta pendiente de Claude; esto requiere Claude Code v2.1.225 o posterior. Mientras Claude ejecuta [subagentes](/docs/es/sub-agents), aparecen filas de progreso en vivo con su actividad más reciente debajo del grupo de llamadas a herramientas que los inició. Esto requiere Claude Code v2.1.269 o posterior.175 Con un proveedor externo, o sin credenciales de Anthropic, no se envía nada. El cuadro de diálogo lo indica antes de que escribas. Al enviarlo, el reporte se guarda como un [archivo local en `~/.claude/feedback-bundles/`](/docs/es/data-usage#telemetry-services) con los patrones conocidos de claves de API y tokens ocultos. Guardar el reporte en tu computadora requiere Claude Code v2.1.284 o posterior.

158 * Para cerrar sesión en tu cuenta de Anthropic, selecciona **Sign out** en la sección Settings o escribe `/logout`. Con un [proveedor externo](#use-third-party-providers), el menú no ofrece ninguna de las dos opciones. Requiere Claude Code v2.1.277 o posterior.

159 * Para informar un error, haz clic en **Report a problem** en la parte inferior del menú, o escribe `/bug` o `/feedback` con una descripción opcional que rellena previamente el informe. Cuando envías el informe y has iniciado sesión en Anthropic con una conexión propia de Anthropic, Claude Code lo envía a Anthropic. Requiere Claude Code v2.1.229 o posterior.

160 176

161 Con un proveedor externo, o sin credenciales de Anthropic, no se envía nada. El cuadro de diálogo lo indica antes de que escribas. Al enviarlo, el informe se guarda como un [archivo local en `~/.claude/feedback-bundles/`](/docs/es/data-usage#telemetry-services) con los patrones conocidos de claves de API y tokens censurados. Envía ese archivo a tu representante de cuenta de Anthropic o adjúntalo a una solicitud de soporte. La confirmación indica el nombre del archivo e incluye un botón **Show folder**. Guardar el informe en tu computadora requiere Claude Code v2.1.284 o posterior.177 Una vez guardado el reporte, la confirmación indica el nombre del archivo e incluye un botón **Show folder**. Envía ese archivo a tu representante de cuenta de Anthropic o adjúntalo a una solicitud de soporte.

162 178

163 Si la política de tu organización desactiva los comentarios sobre el producto, **Report a problem** no aparece en el menú, y `/bug` y `/feedback` muestran el aviso `Feedback is turned off by your organization's policy or this environment's settings.` en lugar de abrir el informe. Con Claude Code v2.1.284 o posterior, si estableces la variable de entorno `DISABLE_FEEDBACK_COMMAND` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, los comentarios también se desactivan y al abrir el informe se muestra ese aviso.179 Si la política de tu organización desactiva los comentarios sobre el producto, **Report a problem** no aparece en el menú, y `/bug` y `/feedback` muestran el aviso `Feedback is turned off by your organization's policy or this environment's settings.` en lugar de abrir el reporte. Con Claude Code v2.1.284 o posterior, si estableces la variable de entorno `DISABLE_FEEDBACK_COMMAND` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, los comentarios también se desactivan y al abrir el reporte se muestra ese aviso.

164* **Preguntas al margen**: escribe `/btw` seguido de una pregunta para preguntar sobre tu sesión [sin agregarla a la conversación](/docs/es/interactive-mode#side-questions-with-%2Fbtw). La respuesta se abre en un panel junto al chat, donde puedes hacer preguntas de seguimiento. El hilo se conserva al recargar la ventana. Claude Code conserva los 20 intercambios más recientes y hace caducar los hilos almacenados según el calendario de [`cleanupPeriodDays`](/docs/es/settings-reference#cleanupperioddays), siempre que Claude Code pueda [determinar de forma segura el período de retención](/docs/es/claude-directory#cleaned-up-automatically). Para borrar un hilo, haz clic en el ícono de papelera del panel. Requiere Claude Code v2.1.227 o posterior.180* **Preguntas paralelas**: escribe `/btw` seguido de una pregunta para preguntar sobre tu sesión [sin agregarla a la conversación](/docs/es/interactive-mode#side-questions-with-%2Fbtw). La respuesta se abre en un panel junto al chat, donde puedes hacer preguntas de seguimiento. Requiere Claude Code v2.1.227 o posterior.

181

182 El hilo se mantiene al recargar la ventana. Claude Code conserva los 20 intercambios más recientes y hace expirar los hilos almacenados según el calendario de [`cleanupPeriodDays`](/docs/es/settings-reference#cleanupperioddays), siempre que Claude Code pueda [determinar de forma segura el período de retención](/docs/es/claude-directory#cleaned-up-automatically). Para borrar un hilo, haz clic en el icono de papelera del panel.

165* **Copiar una respuesta**: pasa el cursor sobre una respuesta y haz clic en **Copy response** para copiarla al portapapeles, o escribe `/copy` para copiar la respuesta más reciente. `/copy 2` copia la penúltima. Requiere Claude Code v2.1.277 o posterior.183* **Copiar una respuesta**: pasa el cursor sobre una respuesta y haz clic en **Copy response** para copiarla al portapapeles, o escribe `/copy` para copiar la respuesta más reciente. `/copy 2` copia la penúltima. Requiere Claude Code v2.1.277 o posterior.

166* **Marcadores**: pasa el cursor sobre una respuesta y haz clic en **Bookmark response** para guardarla, o haz clic en **Remove bookmark** en una respuesta guardada para quitarla.184* **Marcadores**: pasa el cursor sobre una respuesta y haz clic en **Bookmark response** para guardarla, o haz clic en **Remove bookmark** en una respuesta guardada para quitarla.

167 185

168 Para revisar las respuestas guardadas, abre el panel Bookmarks: haz clic en el ícono de marcador en la parte superior del panel de Claude Code, selecciona **Bookmarks** en la sección Context del menú de comandos o escribe `/bookmarks`. Requiere Claude Code v2.1.286 o posterior.186 Para revisar las respuestas guardadas, abre el panel Bookmarks. Puedes hacer clic en el icono de marcador en la parte superior del panel de Claude Code, seleccionar **Bookmarks** en la sección Context del menú de comandos, o escribir `/bookmarks`. Requiere Claude Code v2.1.286 o posterior.

169* **Archivos que Claude te envía**: cuando la sesión está conectada a [Remote Control](/docs/es/remote-control#start-a-remote-control-session) y Claude te envía archivos con la [herramienta `SendUserFile`](/docs/es/tools-reference), la conversación muestra una fila como **Sent report.md, chart.png**. Haz clic en el nombre de un archivo para abrirlo en el editor.187* **Archivos que Claude te envía**: cuando la sesión está conectada a [Remote Control](/docs/es/remote-control#start-a-remote-control-session) y Claude te envía archivos con la [herramienta `SendUserFile`](/docs/es/tools-reference), la conversación muestra una fila como **Sent report.md, chart.png**. Haz clic en el nombre de un archivo para abrirlo en el editor.

170* **Indicador de contexto**: el cuadro de prompt muestra cuánto de la ventana de contexto de Claude estás usando. Claude compacta automáticamente cuando es necesario, o puedes ejecutar `/compact` manualmente.188* **Indicador de contexto**: el cuadro de prompt muestra cuánto de la ventana de contexto de Claude estás usando. Claude compacta automáticamente cuando es necesario, o puedes ejecutar `/compact` manualmente.

171* **Reloj de la caché de prompts**: un ícono de reloj junto al indicador de contexto estima cuánto tiempo le queda a la [caché de prompts](/docs/es/prompt-caching) de la conversación antes de caducar. Hace una cuenta regresiva desde la [vida útil](/docs/es/prompt-caching#cache-lifetime) de cinco minutos o de una hora de la caché, y cada respuesta que usa la caché reinicia la cuenta regresiva. Aparte de la compactación, las [acciones que invalidan la caché](/docs/es/prompt-caching#actions-that-invalidate-the-cache) no reinician el reloj, así que puede seguir mostrando minutos restantes después de que cambies de modelo.189* **Reloj de la caché de prompts**: un icono de reloj junto al indicador de contexto estima cuánto tiempo le queda a la [caché de prompts](/docs/es/prompt-caching) de la conversación antes de expirar. Hace una cuenta regresiva desde la [duración](/docs/es/prompt-caching#cache-lifetime) de cinco minutos o una hora de la caché, y cada respuesta que usa la caché reinicia la cuenta regresiva. Aparte de la compactación, las [acciones que invalidan la caché](/docs/es/prompt-caching#actions-that-invalidate-the-cache) no reinician el reloj, por lo que aún puede mostrar minutos restantes después de cambiar de modelo.

172 * Hasta que se agota la cuenta regresiva, el ícono muestra los minutos restantes, como **12m**.190 * Hasta que termina la cuenta regresiva, el icono muestra los minutos restantes, como **12m**.

173 * Cuando se agota la cuenta regresiva, los minutos desaparecen y el ícono se vuelve rojo, o del color de error de tu tema, hasta la siguiente respuesta. Es probable que la caché haya caducado, así que espera una respuesta más lenta y costosa a tu siguiente mensaje mientras la caché se reconstruye. Si la vida útil de cinco minutos se sigue agotando entre tus mensajes, consulta [Elegir el TTL tú mismo](/docs/es/prompt-caching#choose-the-ttl-yourself).191 * Cuando termina la cuenta regresiva, los minutos desaparecen y el icono se vuelve rojo, o del color de error de tu tema, hasta la siguiente respuesta. Es probable que la caché haya expirado, así que espera una respuesta más lenta y costosa a tu siguiente mensaje mientras la caché se reconstruye. Si la duración de cinco minutos se agota constantemente entre tus mensajes, consulta [Elegir el TTL tú mismo](/docs/es/prompt-caching#choose-the-ttl-yourself).

174 * Justo después de que la conversación se [compacta](/docs/es/prompt-caching#compacting-the-conversation), el ícono también se vuelve rojo sin minutos hasta la siguiente respuesta, porque la caché aún no cubre la conversación compactada.192 * Justo después de que la conversación se [compacta](/docs/es/prompt-caching#compacting-the-conversation), el icono también se vuelve rojo sin minutos hasta la siguiente respuesta, porque la caché aún no cubre la conversación compactada.

175* **Mapa de agentes**: cuando la conversación incluye [subagentes](/docs/es/sub-agents), aparece un recuento de agentes como **2 agents** en la parte inferior del cuadro de prompt. Su punto indica si algún subagente está trabajando o esperando tu permiso.193* **Mapa de agentes**: cuando la conversación incluye [subagentes](/docs/es/sub-agents), aparece un recuento de agentes como **2 agents** en la parte inferior del cuadro de prompt. Su punto indica si algún subagente está trabajando o esperando tu permiso.

176 194

177 Haz clic en el recuento de agentes para abrir el mapa de agentes, que dibuja los subagentes de la conversación como un árbol bajo el agente principal, cada uno con su estado, tiempo transcurrido y recuento de tokens. Haz clic en un subagente para ver su prompt y sus llamadas a herramientas, abrir su transcripción de solo lectura o detenerlo mientras se ejecuta. Requiere Claude Code v2.1.269 o posterior.195 Haz clic en el recuento de agentes para abrir el mapa de agentes, que dibuja los subagentes de la conversación como un árbol debajo del agente principal, cada uno con su estado, tiempo transcurrido y recuento de tokens. Haz clic en un subagente para ver su prompt y sus llamadas a herramientas, abrir su transcripción de solo lectura o detenerlo mientras se ejecuta. Requiere Claude Code v2.1.269 o posterior.

178 196

179 El mapa también enumera las demás [tareas en segundo plano](/docs/es/tools-reference#background-commands) de la sesión, como los comandos de shell en segundo plano y los [monitores](/docs/es/tools-reference#monitor-tool), debajo de los agentes. Haz clic en una fila para abrir la tarjeta de la tarea y detenerla allí.197 El mapa también enumera las demás [tareas en segundo plano](/docs/es/tools-reference#background-commands) de la sesión, como los comandos de shell en segundo plano y los [monitores](/docs/es/tools-reference#monitor-tool), debajo de los agentes. Haz clic en una fila para abrir la tarjeta de la tarea y detenerla allí.

180 198

181 Para abrir el mapa cuando no se muestra ningún recuento de agentes, como cuando Claude ha iniciado un shell en segundo plano pero ningún subagente, escribe `/tasks` en el cuadro de prompt. Las tareas en segundo plano en el mapa y el comando `/tasks` escrito requieren Claude Code v2.1.277 o posterior.199 Para abrir el mapa cuando no se muestra ningún recuento de agentes, por ejemplo cuando Claude ha iniciado un shell en segundo plano pero ningún subagente, escribe `/tasks` en el cuadro de prompt. Las tareas en segundo plano en el mapa y el comando `/tasks` escrito requieren Claude Code v2.1.277 o posterior.

182 200

183 Con Claude Code v2.1.286 o posterior, cuando haces clic en **Stop** o presionas `Esc`, el turno actual termina. Los agentes en segundo plano siguen ejecutándose hasta que terminan o los detienes desde el mapa.201 Con Claude Code v2.1.286 o posterior, cuando haces clic en **Stop** o presionas `Esc`, el turno actual termina. Los agentes en segundo plano siguen ejecutándose hasta que terminan o los detienes desde el mapa.

184* **Pensamiento extendido**: permite que Claude dedique más tiempo a razonar problemas complejos. Actívalo desde el menú de comandos (`/`). El razonamiento de Claude aparece en la conversación como bloques contraídos: haz clic en un bloque para leerlo, o presiona `Ctrl+O` para expandir o contraer todos los bloques de pensamiento de la sesión. Consulta [Pensamiento extendido](/docs/es/model-config#extended-thinking) para más detalles.202* **Pensamiento extendido**: permite que Claude dedique más tiempo a razonar sobre problemas complejos. Actívalo desde el menú de comandos (`/`). El razonamiento de Claude aparece en la conversación como bloques contraídos: haz clic en un bloque para leerlo, o presiona `Ctrl+O` para expandir o contraer todos los bloques de pensamiento de la sesión. Consulta [Pensamiento extendido](/docs/es/model-config#extended-thinking) para más detalles.

185* **Entrada de varias líneas**: presiona `Shift+Enter` para agregar una nueva línea sin enviar. Esto también funciona en la entrada de texto libre "Other" de los cuadros de diálogo de preguntas.203* **Entrada de varias líneas**: presiona `Shift+Enter` para agregar una nueva línea sin enviar. Esto también funciona en la entrada de texto libre "Other" de los cuadros de diálogo de preguntas.

186 204

187<h3 id="reference-files-and-folders">205<h3 id="reference-files-and-folders">

195What's in @src/components/ (include a trailing slash for folders)213What's in @src/components/ (include a trailing slash for folders)

196```214```

197 215

198Para PDF grandes, puedes pedirle a Claude que lea páginas específicas en lugar del archivo completo: una sola página, un rango como las páginas 1-10 o un rango abierto como de la página 3 en adelante. Leer páginas específicas requiere [poppler-utils](/docs/es/tools-reference#read-tool-behavior) en la máquina donde se ejecuta Claude Code.216Para PDF grandes, puedes pedirle a Claude que lea páginas específicas en lugar del archivo completo. Pide una sola página, un rango como las páginas 1-10, o un rango abierto como desde la página 3 en adelante. Leer páginas específicas requiere [poppler-utils](/docs/es/tools-reference#read-tool-behavior) en la máquina donde se ejecuta Claude Code.

217

218Cuando seleccionas texto en el editor, Claude puede ver automáticamente el código resaltado. El pie del cuadro de prompt muestra cuántas líneas están seleccionadas. Presiona `Option+K` (Mac) / `Alt+K` (Windows/Linux) para insertar una mención con @ con la ruta del archivo y los números de línea, por ejemplo `@app.ts#5-10`. Haz clic en la **X** del indicador de selección para quitarla y que Claude no reciba la selección. El indicador vuelve a aparecer cuando seleccionas otro texto.

219

220La extensión no envía el texto seleccionado de algunos archivos:

199 221

200Cuando seleccionas texto en el editor, Claude puede ver automáticamente el código resaltado. El pie del cuadro de prompt muestra cuántas líneas están seleccionadas. Presiona `Option+K` (Mac) / `Alt+K` (Windows/Linux) para insertar una mención con @ con la ruta del archivo y los números de línea (por ejemplo, `@app.ts#5-10`). Haz clic en la **X** del indicador de selección para quitarla y que Claude no reciba la selección. El indicador vuelve a aparecer cuando seleccionas otro texto.222* Cuando el archivo está dentro de tu espacio de trabajo y coincide con tus ajustes `files.exclude` o `search.exclude`, Claude recibe como máximo la ruta del archivo y no el texto que seleccionaste.

223* Lo mismo se aplica a un archivo que git ignora, siempre que el ajuste `search.useIgnoreFiles` de VS Code y el [ajuste `respectGitIgnore`](#extension-settings) de la extensión estén ambos activados, que es el valor predeterminado.

201 224

202La extensión no envía a Claude el texto seleccionado de algunos archivos. Cuando el archivo está dentro de tu espacio de trabajo y coincide con tus ajustes `files.exclude` o `search.exclude`, Claude recibe como máximo la ruta del archivo y no el texto que seleccionaste. Lo mismo se aplica a un archivo que git ignora, siempre que el ajuste `search.useIgnoreFiles` de VS Code y el [ajuste `respectGitIgnore`](#extension-settings) de la extensión estén ambos activados, que es lo predeterminado. Este filtro solo cubre el panel de chat: cuando Claude Code se ejecuta en la terminal integrada, la CLI envía el texto seleccionado sea cual sea el archivo, así que agrega una [regla de denegación de `Read`](#the-built-in-ide-mcp-server) para evitar que Claude vea allí el contenido de un archivo.225Este filtro cubre solo el panel de chat. Cuando Claude Code se ejecuta en la terminal integrada, la CLI envía el texto seleccionado sin importar el archivo. Para evitar que Claude vea el contenido de un archivo allí, agrega una [regla de denegación de `Read`](#the-built-in-ide-mcp-server).

203 226

204Claude también ve qué archivo tienes abierto en el editor, incluso cuando no hay nada seleccionado, y el cuadro de prompt muestra su nombre. Para agregar solo el texto seleccionado, desactiva el [ajuste Attach Open File](vscode://settings/claudeCode.attachOpenFile). El ajuste requiere Claude Code v2.1.271 o posterior.227Claude también ve qué archivo tienes abierto en el editor, incluso cuando no hay nada seleccionado, y el cuadro de prompt muestra su nombre. Para agregar solo el texto seleccionado, desactiva el [ajuste Attach Open File](vscode://settings/claudeCode.attachOpenFile). El ajuste requiere Claude Code v2.1.271 o posterior.

205 228

206También puedes adjuntar imágenes y archivos a tu mensaje:229También puedes adjuntar imágenes y archivos a tu mensaje:

207 230

208* Para adjuntar una imagen, pégala desde el portapapeles en el cuadro de prompt.231* Para adjuntar una imagen, pégala desde el portapapeles en el cuadro de prompt.

209* Para adjuntar archivos, mantén presionada la tecla `Shift` mientras los arrastras al cuadro de prompt.232* Para adjuntar archivos, mantén presionada `Shift` mientras los arrastras al cuadro de prompt.

210* Para quitar un adjunto del contexto, haz clic en la X que aparece sobre él.233* Para quitar un adjunto del contexto, haz clic en su X.

234

235<h3 id="include-terminal-output-in-prompts">

236 Incluir la salida de la terminal en los prompts

237</h3>

238

239Haz referencia a la salida de la terminal en tus prompts usando `@terminal:name`, donde `name` es el título de la terminal. Esto permite que Claude vea la salida de comandos, mensajes de error o registros sin copiar y pegar.

211 240

212<h3 id="paste-text">241<h3 id="paste-text">

213 Pegar texto242 Pegar texto

217 246

218Claude Code también elimina los [caracteres Unicode invisibles](/docs/es/interactive-mode#invisible-characters-in-prompts) del texto que pegas en el cuadro de prompt y de cualquier otra cosa que envíes:247Claude Code también elimina los [caracteres Unicode invisibles](/docs/es/interactive-mode#invisible-characters-in-prompts) del texto que pegas en el cuadro de prompt y de cualquier otra cosa que envíes:

219 248

220* Si aparece un aviso como `Removed 3 invisible characters from the pasted text` al pegar, el texto se insertó sin esos caracteres.249* Si al pegar aparece un aviso como `Removed 3 invisible characters from the pasted text`, el texto se insertó sin esos caracteres.

221* Si aparece un aviso sobre caracteres eliminados al enviar, no se envió nada. El texto limpio vuelve al cuadro de prompt. Envía de nuevo para enviar el texto tal como se muestra.250* Si al enviar aparece un aviso sobre caracteres eliminados, no se envió nada. El texto limpio vuelve al cuadro de prompt. Envía de nuevo para enviar el texto tal como se muestra.

222 251

223<h3 id="latex-math-in-responses">252<h3 id="latex-math-in-responses">

224 Matemáticas LaTeX en las respuestas253 Matemáticas en LaTeX en las respuestas

225</h3>254</h3>

226 255

227El panel de chat muestra las matemáticas LaTeX de las respuestas de Claude como fórmulas renderizadas. La representación de matemáticas requiere Claude Code v2.1.301 o posterior. En el [modo terminal](#switch-to-terminal-mode), las matemáticas no se renderizan. El panel renderiza tanto las matemáticas en bloque como las matemáticas en línea:256El panel de chat muestra las matemáticas en LaTeX de las respuestas de Claude como fórmulas tipografiadas. El renderizado de matemáticas requiere Claude Code v2.1.301 o posterior. En el [modo terminal](#switch-to-terminal-mode), las matemáticas no se tipografían. El panel tipografía tanto las matemáticas en bloque como las matemáticas en línea:

228 257

229* **Matemáticas en bloque**: un bloque `$$ … $$` o `\[ … \]` en una o varias líneas propias, y un bloque de código delimitado con `math` como lenguaje258* **Matemáticas en bloque**: un bloque `$$ … $$` o `\[ … \]` en una o varias líneas propias, y un bloque de código delimitado con `math` como lenguaje

230* **Matemáticas en línea**: `$…$` o `$…$` que se abre y se cierra en la misma línea, como `$E = mc^2$` o `$a^2 + b^2 = c^2$`259* **Matemáticas en línea**: `$…$` o `$…$` que se abre y se cierra en la misma línea, como `$E = mc^2$` o `$a^2 + b^2 = c^2$`

231 260

232El panel intenta distinguir las matemáticas de otros usos de los mismos caracteres, por lo que texto como `$HOME`, un precio como `$5` o `sed 's/$foo$/\1/'` no se renderiza. Tampoco el texto dentro de un fragmento de código en línea ni dentro de cualquier bloque de código distinto de un bloque `math` delimitado. Si una fórmula se muestra tal como está escrita cuando esperabas verla renderizada, consulta [Una fórmula se muestra como LaTeX sin procesar](#a-formula-shows-as-raw-latex).261El panel intenta distinguir las matemáticas de otros usos de los mismos caracteres, por lo que texto como `$HOME`, un precio como `$5` o `sed 's/$foo$/\1/'` no se tipografía. Tampoco el texto dentro de un fragmento de código ni dentro de cualquier bloque de código que no sea un bloque `math` delimitado. Si una fórmula se muestra tal como está escrita cuando esperabas verla tipografiada, consulta [Una fórmula se muestra como LaTeX sin procesar](#a-formula-shows-as-raw-latex).

233 262

234Cuando seleccionas y copias texto que incluye una fórmula renderizada, obtienes el código fuente TeX de la fórmula entre delimitadores `$…$` o `$$…$$` en lugar de los símbolos dibujados. [**Copy response**](#use-the-prompt-box) y `/copy` te dan la respuesta tal como la escribió Claude, incluido el código fuente TeX.263Cuando seleccionas y copias texto que incluye una fórmula tipografiada, obtienes el código fuente TeX de la fórmula entre delimitadores `$…$` o `$$…$$` en lugar de los símbolos dibujados. [**Copy response**](#use-the-prompt-box) y `/copy` te dan la respuesta tal como Claude la escribió, incluido el código fuente TeX.

235 264

236<h3 id="resume-past-conversations">265<h3 id="resume-past-conversations">

237 Reanudar conversaciones anteriores266 Reanudar conversaciones anteriores

239 268

240Haz clic en el botón **Session history** en la parte superior del panel de Claude Code para acceder a tu historial de conversaciones. Puedes buscar por palabra clave o explorar por fecha.269Haz clic en el botón **Session history** en la parte superior del panel de Claude Code para acceder a tu historial de conversaciones. Puedes buscar por palabra clave o explorar por fecha.

241 270

242Haz clic en cualquier conversación para reanudarla con el historial completo de mensajes. Si la conversación ya está abierta en otra pestaña de la ventana actual, al hacer clic se cambia a esa pestaña. Si los mensajes aparecen en blanco al principio, consulta [por qué están en blanco y cuándo aparecen](#a-resumed-conversation-is-blank-at-first). Para más información sobre cómo reanudar sesiones, consulta [Administrar sesiones](/docs/es/sessions).271Haz clic en cualquier conversación para reanudarla con el historial completo de mensajes. Si la conversación ya está abierta en otra pestaña de la ventana actual, al hacer clic se cambia a esa pestaña. Si los mensajes aparecen en blanco al principio, consulta [por qué están en blanco y cuándo aparecen](#a-resumed-conversation-is-blank-at-first). Para obtener más información sobre cómo reanudar sesiones, consulta [Administrar sesiones](/docs/es/sessions).

272

273* **Títulos de sesión**: las sesiones nuevas reciben títulos generados por IA a partir de tu primer mensaje.

274* **Renombrar y archivar**: pasa el cursor sobre una sesión para mostrar estas acciones. Renómbrala para darle un título descriptivo, o archívala para moverla al grupo **Archived sessions** al final de la lista.

243 275

244* **Títulos de sesión**: las sesiones nuevas reciben títulos generados por IA según tu primer mensaje.276Si la conversación está abierta en otro proceso de Claude Code, como `claude` en una terminal u otra ventana de VS Code, aparece este aviso en lugar del cuadro de prompt:

245* **Renombrar y archivar**: pasa el cursor sobre una sesión para mostrar estas acciones. Renómbrala para darle un título descriptivo o archívala para moverla al grupo **Archived sessions** en la parte inferior de la lista.

246 277

247Si la conversación está abierta en otro proceso de Claude Code, como `claude` en una terminal u otra ventana de VS Code, aparece un aviso en lugar del cuadro de prompt: `This conversation is still open somewhere else. Using it in two places at once can mix up its messages.` Para continuar aquí, cierra la conversación en el otro lugar y luego haz clic en **Open here anyway**. Si haces clic sin cerrarla, la conversación queda abierta en ambos lugares. Con [`claudeProcessWrapper`](#extension-settings) establecido, la extensión omite esta comprobación y abre la conversación directamente.278```text theme={null}

279This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

280```

248 281

249De forma predeterminada, una sesión sin actividad durante 14 días se mueve automáticamente a **Archived sessions**, a menos que esté abierta, sin leer o en un [grupo](#organize-sessions-into-groups). El archivado automático requiere Claude Code v2.1.265 o posterior. Para cambiar el período o desactivarlo, abre el [ajuste Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) y selecciona un número de días o **Never**.282Para continuar aquí, cierra la conversación en el otro lugar y luego haz clic en **Open here anyway**. Si haces clic sin cerrarla, la conversación queda abierta en ambos lugares. Con [`claudeProcessWrapper`](#extension-settings) configurado, la extensión omite esta comprobación y abre la conversación directamente.

250 283

251Para restaurar una sesión archivada, expande **Archived sessions** y haz clic en **Unarchive session**. Para restaurar todas las sesiones archivadas a la vez, pasa el cursor sobre el encabezado **Archived sessions** en la lista de sesiones de la barra de actividades y haz clic en su ícono de desarchivar, lo que requiere Claude Code v2.1.277 o posterior. Antes de v2.1.257, la acción era **Delete session**, que ocultaba una sesión sin forma de restaurarla. Las sesiones que eliminaste entonces aparecen en **Archived sessions** después de actualizar.284De forma predeterminada, una sesión sin actividad durante 14 días pasa automáticamente a **Archived sessions**, a menos que esté abierta, sin leer o en un [grupo](#organize-sessions-into-groups). El archivado automático requiere Claude Code v2.1.265 o posterior. Para cambiar el período o desactivarlo, abre el [ajuste Archive Inactive Sessions](vscode://settings/claudeCode.archiveInactiveSessions) y selecciona un número de días o **Never**.

285

286Para restaurar sesiones archivadas:

287

288* **Una sesión**: expande **Archived sessions** y haz clic en **Unarchive session**.

289* **Todas las sesiones archivadas a la vez**: pasa el cursor sobre el encabezado **Archived sessions** en la lista de sesiones de la barra de actividad y haz clic en su icono de desarchivar. Requiere Claude Code v2.1.277 o posterior.

290

291Antes de v2.1.257, la acción era **Delete session**, que ocultaba una sesión sin forma de restaurarla. Las sesiones que eliminaste entonces aparecen en **Archived sessions** después de actualizar.

252 292

253Cuando la conversación que reanudas terminó en modo plan, Claude Code restaura el modo plan. Requiere Claude Code v2.1.246 o posterior. Claude Code no lo restaura en estos casos:293Cuando la conversación que reanudas terminó en modo plan, Claude Code restaura el modo plan. Requiere Claude Code v2.1.246 o posterior. Claude Code no lo restaura en estos casos:

254 294

255* La extensión [elige el modo de permisos inicial](/docs/es/permission-modes#switch-permission-modes) a partir de `claudeCode.initialPermissionMode` o de una elección que se conserva de una conversación anterior295* La extensión [elige el modo de permisos inicial](/docs/es/permission-modes#switch-permission-modes) a partir de `claudeCode.initialPermissionMode` o de una selección que se mantiene de una conversación anterior

256* Tienes configurado `claudeCode.claudeProcessWrapper`296* Tienes configurado `claudeCode.claudeProcessWrapper`

257* Una [regla de denegación](/docs/es/permissions#manage-permissions) elimina la herramienta [`ExitPlanMode`](/docs/es/tools-reference)297* Una [regla de denegación](/docs/es/permissions#manage-permissions) elimina la herramienta [`ExitPlanMode`](/docs/es/tools-reference)

258 298

259<h3 id="resume-cloud-sessions-from-claude-ai">299<h3 id="resume-cloud-sessions-from-claude-ai">

260 Reanudar sesiones en la nube desde Claude.ai300 Reanudar sesiones en la nube desde claude.ai

261</h3>301</h3>

262 302

263Si ejecutas [sesiones en la nube](/docs/es/claude-code-on-the-web), puedes reanudarlas directamente en VS Code. Esto requiere iniciar sesión con **Claude.ai Subscription**, no con Anthropic Console.303Si ejecutas [sesiones en la nube](/docs/es/claude-code-on-the-web), puedes reanudarlas directamente en VS Code. Esto requiere iniciar sesión con **Claude.ai Subscription**, no con Anthropic Console.

264 304

265<Steps>305<Steps>

266 <Step title="Abrir el historial de sesiones">306 <Step title="Abre el historial de sesiones">

267 Haz clic en el botón **Session history** en la parte superior del panel de Claude Code.307 Haz clic en el botón **Session history** en la parte superior del panel de Claude Code.

268 </Step>308 </Step>

269 309

270 <Step title="Seleccionar la pestaña Web">310 <Step title="Selecciona la pestaña Web">

271 El cuadro de diálogo muestra dos pestañas: Local y Web. Haz clic en **Web** para ver las sesiones de claude.ai.311 El cuadro de diálogo muestra dos pestañas: Local y Web. Haz clic en **Web** para ver las sesiones de claude.ai.

272 </Step>312 </Step>

273 313

274 <Step title="Seleccionar una sesión para reanudar">314 <Step title="Selecciona una sesión para reanudarla">

275 Explora o busca entre las sesiones. Haz clic en una para continuar la conversación localmente.315 Explora o busca entre las sesiones. Haz clic en una para continuar la conversación localmente.

276 </Step>316 </Step>

277</Steps>317</Steps>

282 Cuando reanudas una sesión en la nube, la extensión descarga una copia del historial de la conversación; los cambios no se sincronizan de vuelta con claude.ai.322 Cuando reanudas una sesión en la nube, la extensión descarga una copia del historial de la conversación; los cambios no se sincronizan de vuelta con claude.ai.

283</Note>323</Note>

284 324

285La pestaña Web también enumera tus sesiones de [Remote Control](/docs/es/remote-control). Si haces clic en una que se ejecutó en la carpeta que tienes abierta, la extensión abre esa conversación local en lugar de descargar una copia, y enfoca la pestaña que ya la muestra si existe. Si la extensión no puede descartar que otro proceso de Claude tenga la conversación abierta, obtienes una copia descargada.325La pestaña Web también enumera tus sesiones de [Remote Control](/docs/es/remote-control). Si haces clic en una que se ejecutó en la carpeta que tienes abierta, la extensión abre esa conversación local en lugar de descargar una copia. La extensión enfoca la pestaña que ya la muestra, si existe. Si la extensión no puede descartar que otro proceso de Claude tenga la conversación abierta, obtienes una copia descargada.

286 326

287Si alguna parte de una conversación no se descarga, aparece un error y no se guarda ninguna copia. Selecciona la sesión de nuevo para reintentar. Si seleccionas una sesión que todavía no tiene conversación para descargar, un error te indica dónde continuarla.327Si alguna parte de una conversación no se descarga, aparece un error y no se guarda ninguna copia. Selecciona la sesión de nuevo para reintentar. Si seleccionas una sesión que aún no tiene conversación para descargar, un error te indica dónde continuarla.

288 328

289<h3 id="check-account-and-usage">329<h3 id="check-account-and-usage">

290 Consultar la cuenta y el uso330 Consultar la cuenta y el uso

291</h3>331</h3>

292 332

293Ejecuta `/usage` para abrir el cuadro de diálogo Account & usage. Muestra la cuenta con la que iniciaste sesión, y el uso que informa varía según el tipo de inicio de sesión:333Ejecuta `/usage` para abrir el cuadro de diálogo Account & usage, que muestra la cuenta con la que iniciaste sesión y tu uso. Las cifras de uso dependen de cómo iniciaste sesión:

294 334

295* **Plan de claude.ai**: barras de uso para los límites de tu plan, como la sesión actual y la semana. Cada barra muestra cuánto falta para que se restablezca su límite.335* **Plan de claude.ai**: barras de uso para los límites de tu plan, como la sesión actual y la semana. Cada barra muestra cuánto falta para que se restablezca su límite.

296 336

297 El cuadro de diálogo también desglosa qué contribuye a los límites de tu plan. Señala los comportamientos que representan el 10 % o más del uso reciente, como los fallos de caché, el contexto largo y las sesiones con muchos subagentes o muy paralelas, cada uno con un consejo para reducirlo. Las tablas de atribución muestran cuánto uso provino de cada skill, subagente, plugin y servidor MCP.337 El cuadro de diálogo también desglosa qué contribuye a los límites de tu plan. Señala los comportamientos que representan el 10 % o más del uso reciente, como los fallos de caché, el contexto largo y las sesiones con muchos subagentes o muy paralelas. Cada comportamiento señalado incluye un consejo para reducirlo. Las tablas de atribución muestran cuánto uso provino de cada skill, subagente, plugin y servidor MCP.

338

339 Usa el selector Day y Week para alternar entre las últimas 24 horas y los últimos 7 días. Las cifras son aproximadas y se calculan a partir de las sesiones locales en esta máquina, por lo que no se incluye el uso desde otros dispositivos ni desde claude.ai.

340* **Otros inicios de sesión**: cuando los límites del plan no se aplican a tu inicio de sesión, como con un [proveedor externo](#use-third-party-providers) o con una clave de API, la sección Usage muestra en su lugar el costo y el uso de tokens de la propia sesión. El `/usage` de la CLI muestra los mismos totales en su [bloque Session](/docs/es/costs#track-your-costs). La lista de sesiones de la barra de actividad también muestra los totales de la sesión activa bajo su encabezado **Account & usage**. Requiere Claude Code v2.1.277 o posterior.

298 341

299 Usa el selector Day y Week para alternar entre las últimas 24 horas y los últimos 7 días. Las cifras son aproximadas y se calculan a partir de las sesiones locales de esta máquina, por lo que no se incluye el uso de otros dispositivos ni de claude.ai.342Para obtener más información sobre cómo hacer seguimiento del uso y reducirlo, consulta [Hacer seguimiento de tus costos](/docs/es/costs#track-your-costs).

300* **Otros inicios de sesión**: cuando los límites del plan no se aplican a tu inicio de sesión, como con un [proveedor externo](#use-third-party-providers) o con una clave de API, la sección Usage muestra en su lugar el costo y el uso de tokens de la propia sesión. El `/usage` de la CLI muestra los mismos totales en su [bloque Session](/docs/es/costs#track-your-costs). La lista de sesiones de la barra de actividades también muestra los totales de la sesión activa debajo de su encabezado **Account & usage**. Requiere Claude Code v2.1.277 o posterior.

301 343

302Para más información sobre cómo hacer seguimiento del uso y reducirlo, consulta [Hacer seguimiento de tus costos](/docs/es/costs#track-your-costs).344<h3 id="rewind-with-checkpoints">

345 Retroceder con checkpoints

346</h3>

347

348La extensión de VS Code admite checkpoints, que registran las ediciones de archivos de Claude y te permiten retroceder a un estado anterior. Pasa el cursor sobre cualquier mensaje para mostrar el botón de retroceso y luego elige entre tres opciones:

349

350* **Fork conversation from here**: inicia una nueva rama de la conversación a partir de este mensaje y conserva intactos todos los cambios de código

351* **Rewind code to here**: revierte los cambios de archivos hasta este punto de la conversación y conserva el historial completo de la conversación

352* **Fork conversation and rewind code**: inicia una nueva rama de la conversación y revierte los cambios de archivos hasta este punto

353

354Para conocer todos los detalles sobre cómo funcionan los checkpoints y sus limitaciones, consulta [Checkpointing](/docs/es/checkpointing).

303 355

304<h2 id="customize-your-workflow">356<h2 id="customize-your-workflow">

305 Personaliza tu flujo de trabajo357 Personaliza tu flujo de trabajo

306</h2>358</h2>

307 359

308Puedes reposicionar el panel de Claude, ejecutar múltiples conversaciones, agrupar o filtrar la lista de sesiones, o cambiar al modo terminal.360Puedes reubicar el panel de Claude, ejecutar varias conversaciones, agrupar o filtrar la lista de sesiones, o cambiar al modo terminal.

309 361

310<h3 id="choose-where-claude-lives">362<h3 id="choose-where-claude-lives">

311 Elige dónde vive Claude363 Elige dónde vive Claude

312</h3>364</h3>

313 365

314Puedes arrastrar el panel de Claude para reposicionarlo en cualquier lugar de VS Code. Agarra la pestaña o la barra de título del panel y arrástralo a:366Puedes arrastrar el panel de Claude para reubicarlo en cualquier lugar de VS Code. Toma la pestaña o la barra de título del panel y arrástrala a:

315 367

316* **Barra lateral secundaria**: el lado derecho de la ventana. Mantiene Claude visible mientras codificas.368* **Barra lateral secundaria**: el lado derecho de la ventana. Mantiene a Claude visible mientras programas.

317* **Barra lateral principal**: la barra lateral izquierda con iconos para Explorador, Búsqueda, etc.369* **Barra lateral principal**: la barra lateral izquierda con íconos para Explorer, Search, etc.

318* **Área del editor**: abre Claude como una pestaña junto a tus archivos. Útil para tareas secundarias.370* **Área del editor**: abre Claude como una pestaña junto a tus archivos. Útil para tareas secundarias.

319 371

320Cuando Claude abre una pestaña en un nuevo grupo de editor, la extensión bloquea ese grupo, por lo que los archivos que abres mientras la pestaña de Claude está enfocada van a otro grupo en lugar de junto a ella.372Cuando Claude abre una pestaña en un nuevo grupo de editores, la extensión bloquea ese grupo. Los archivos que abras mientras la pestaña de Claude tiene el foco se abren entonces en otro grupo en lugar de junto a ella.

321 373

322Para evitar que la extensión bloquee grupos, desactiva la [configuración Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Los grupos que ya están bloqueados permanecen bloqueados hasta que los desbloquees. La configuración requiere Claude Code v2.1.274 o posterior.374Para evitar que la extensión bloquee grupos, desactiva el [ajuste Lock Editor Groups](vscode://settings/claudeCode.lockEditorGroups). Los grupos que ya están bloqueados permanecen bloqueados hasta que los desbloquees. El ajuste requiere Claude Code v2.1.274 o posterior.

323 375

324<Tip>376<Tip>

325 Usa la barra lateral para tu sesión principal de Claude y abre pestañas adicionales para tareas secundarias. Claude recuerda tu ubicación preferida. El icono de la lista de sesiones de la barra de actividades es independiente del panel de Claude: la lista de sesiones siempre es visible en la barra de actividades, mientras que el icono del panel de Claude solo aparece allí cuando el panel está acoplado a la barra lateral izquierda.377 Usa la barra lateral para tu sesión principal de Claude y abre pestañas adicionales para tareas secundarias. Claude recuerda tu ubicación preferida. El ícono de la lista de sesiones en la Activity Bar es independiente del panel de Claude. La lista de sesiones siempre está visible en la Activity Bar, mientras que el ícono del panel de Claude solo aparece allí cuando el panel está acoplado a la barra lateral izquierda.

326</Tip>378</Tip>

327 379

328<h3 id="continue-conversations-after-a-reload">380<h3 id="continue-conversations-after-a-reload">

329 Continúa conversaciones después de una recarga381 Continúa conversaciones después de recargar

330</h3>382</h3>

331 383

332Después de ejecutar **Developer: Reload Window** o reiniciar VS Code, si una conversación vuelve con su historial depende de dónde estuviera abierta:384Después de ejecutar **Developer: Reload Window** o reiniciar VS Code, revisa dónde estaba abierta la conversación:

333 385

334* **Pestaña del editor**: la conversación vuelve con su pestaña.386* **Pestaña del editor**: la conversación vuelve con su pestaña.

335* **Barra lateral**: la conversación vuelve si enviaste un mensaje o Claude respondió en ella en los últimos 10 minutos. Si no vuelve, reanuda la conversación desde [Historial de sesiones](#resume-past-conversations).387* **Barra lateral**: la conversación vuelve si enviaste un mensaje o Claude respondió en ella en los últimos 10 minutos. Si no vuelve, reanuda la conversación desde el [historial de sesiones](#resume-past-conversations).

336 388

337Si otro proceso de Claude Code todavía tiene la conversación abierta, se te pregunta antes de que se abra aquí, con el mismo aviso **Open here anyway** que cuando la [reanudas desde el historial de sesiones](#resume-past-conversations). Si los mensajes aparecen en blanco al principio, consulta [por qué están en blanco y cuándo aparecen](#a-resumed-conversation-is-blank-at-first).389Si otro proceso de Claude Code todavía tiene la conversación abierta, se te pregunta antes de que se abra aquí, con el mismo aviso **Open here anyway** que cuando la [reanudas desde el historial de sesiones](#resume-past-conversations). Si los mensajes aparecen en blanco al principio, consulta [por qué están en blanco y cuándo aparecen](#a-resumed-conversation-is-blank-at-first).

338 390

339Si la recarga interrumpió a Claude a mitad de un paso, Claude continúa ese paso cuando la conversación vuelve, y un aviso en el chat marca la continuación. Requiere Claude Code v2.1.274 o posterior. Si el paso fue interrumpido hace más de una hora o la sesión está abierta en otro lugar, la conversación vuelve inactiva en su lugar.391<h4 id="interrupted-steps-after-a-reload">

392 Pasos interrumpidos después de recargar

393</h4>

394

395Si la recarga interrumpió a Claude a mitad de un paso, Claude continúa ese paso cuando la conversación vuelve, y un aviso en el chat marca la continuación. Requiere Claude Code v2.1.274 o posterior. Si el paso se interrumpió hace más de una hora o la sesión está abierta en otro lugar, la conversación vuelve inactiva.

396

397<h4 id="turn-off-continuation-after-a-reload">

398 Desactiva la continuación después de recargar

399</h4>

400

401Para evitar que Claude continúe un paso interrumpido después de recargar, abre el [ajuste Continue After Reload](vscode://settings/claudeCode.continueAfterReload) y desmárcalo.

340 402

341Para desactivar la continuación, abre la [configuración Continue After Reload](vscode://settings/claudeCode.continueAfterReload) y desmárcala. Establecer [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/es/env-vars#variables) o cualquier otra variable `CLAUDE_CODE_RESUME_` en el entorno de VS Code o en el [ajuste `environmentVariables`](#extension-settings) no tiene efecto en el panel, porque la extensión elimina esas variables antes de iniciar las sesiones del panel.403Si defines [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/es/env-vars#variables) o cualquier otra variable `CLAUDE_CODE_RESUME_` en el entorno de VS Code o en el [ajuste `environmentVariables`](#extension-settings), no tiene efecto en el panel. Esto se debe a que la extensión elimina esas variables antes de iniciar las sesiones del panel.

342 404

343<h4 id="a-conversation-was-not-reopened">405<h4 id="a-conversation-was-not-reopened">

344 No se reabrió una conversación406 Una conversación no se volvió a abrir

345</h4>407</h4>

346 408

347Después de una recarga, un chat nuevo con un aviso como este encima de su cuadro de prompt significa que el panel dejó tu conversación cerrada porque las dos últimas aperturas de la conversación no terminaron:409Después de recargar, un chat nuevo con un aviso como este sobre su cuadro de prompt significa que el panel dejó tu conversación cerrada porque las dos últimas aperturas de la conversación no terminaron:

348 410

349```text theme={null}411```text theme={null}

350“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.412“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

351```413```

352 414

353Una apertura no termina cuando el panel falla o deja de responder mientras carga la conversación, o cuando recargas o cierras la ventana dentro de unos tres segundos después de que se abre. No se pierde nada: la conversación no cambia y permanece en [Historial de sesiones](#resume-past-conversations).415Una apertura no termina cuando el panel falla o deja de responder mientras carga la conversación, o cuando recargas o cierras la ventana unos tres segundos después de que se abra. La conversación no cambia y permanece en el [historial de sesiones](#resume-past-conversations).

354 416

355* **Para abrirla de todos modos**: haz clic en **Open it anyway** o elige la conversación desde el Historial de sesiones. Si se abre y el panel sigue funcionando, vuelve después de las recargas posteriores como de costumbre. Si el panel deja de responder de nuevo, recarga la ventana para volver a un chat nuevo con el aviso.417* **Para abrirla de todos modos**: haz clic en **Open it anyway** o elige la conversación desde el historial de sesiones. Si se abre y el panel sigue funcionando, vuelve después de recargas posteriores como de costumbre. Si el panel deja de responder otra vez, recarga la ventana para volver a un chat nuevo con el aviso.

356* **Para dejarla cerrada**: sigue trabajando en el chat nuevo. El aviso desaparece en cuanto envías un prompt.418* **Para dejarla cerrada**: sigue trabajando en el chat nuevo. El aviso desaparece cuando envías un prompt.

357 419

358<h3 id="run-multiple-conversations">420<h3 id="run-multiple-conversations">

359 Ejecuta múltiples conversaciones421 Ejecuta varias conversaciones

360</h3>422</h3>

361 423

362Usa **Open in New Tab** u **Open in New Window** desde la Paleta de comandos para iniciar conversaciones adicionales. Cada conversación mantiene su propio historial y contexto, permitiéndote trabajar en diferentes tareas en paralelo.424Usa **Open in New Tab** u **Open in New Window** desde la Command Palette para iniciar conversaciones adicionales. Cada conversación mantiene su propio historial y contexto, lo que te permite trabajar en diferentes tareas en paralelo.

363 425

364Cuando usas pestañas, un pequeño punto de color en el icono de chispa indica el estado: azul significa que hay una solicitud de permiso pendiente, naranja significa que Claude terminó mientras la pestaña estaba oculta.426Cuando usas pestañas, un pequeño punto de color en el ícono de chispa indica el estado: azul significa que hay una solicitud de permiso pendiente, naranja significa que Claude terminó mientras la pestaña estaba oculta.

365 427

366<h3 id="organize-sessions-into-groups">428<h3 id="organize-sessions-into-groups">

367 Organiza sesiones en grupos429 Organiza sesiones en grupos

368</h3>430</h3>

369 431

370En la lista de sesiones de la barra de actividades, puedes recopilar sesiones relacionadas en grupos nombrados y contraíbles. Requiere Claude Code v2.1.229 o posterior.432En la lista de sesiones de la Activity Bar, puedes reunir sesiones relacionadas en grupos con nombre y contraíbles. Requiere Claude Code v2.1.229 o posterior.

371 433

372* **Agrupa o desagrupa una sesión**: haz clic derecho en una sesión para crear un grupo a partir de ella, moverla a un grupo existente, o quitarla de su grupo. Cada sesión pertenece a un grupo a la vez, por lo que moverla a otro grupo la quita del primero.434* **Agrupar o desagrupar una sesión**: haz clic derecho en una sesión para crear un grupo a partir de ella, moverla a un grupo existente o quitarla de su grupo. Cada sesión pertenece a un solo grupo a la vez, así que moverla a otro grupo la quita del primero.

373* **Mueve varias sesiones a la vez**: `Cmd`-haz clic (Mac) / `Ctrl`-haz clic (Windows/Linux) en cada sesión, o `Shift`-haz clic para seleccionar un rango, luego haz clic derecho en la selección.435* **Mover varias sesiones a la vez**: haz `Cmd`-clic (Mac) / `Ctrl`-clic (Windows/Linux) en cada sesión, o `Shift`-clic para seleccionar un rango, y luego haz clic derecho en la selección.

374* **Agrupa una sesión desde su pestaña**: ejecuta **Claude Code: Add Session Tab to Group** desde la Paleta de comandos, luego elige o crea un grupo. Requiere Claude Code v2.1.257 o posterior.436* **Agrupar una sesión desde su pestaña**: ejecuta **Claude Code: Add Session Tab to Group** desde la Command Palette y luego elige o crea un grupo. Requiere Claude Code v2.1.257 o posterior.

375* **Renombra o elimina un grupo**: haz clic derecho en un encabezado de grupo. Eliminar un grupo solo quita el grupo, y sus sesiones vuelven a la lista sin agrupar.437* **Renombrar o eliminar un grupo**: haz clic derecho en el encabezado de un grupo. Eliminar un grupo solo quita el grupo, y sus sesiones vuelven a la lista sin agrupar.

376 438

377La extensión guarda grupos por carpeta de espacio de trabajo, por lo que sobreviven a recargas de ventana y aparecen en cada ventana donde abres la misma carpeta. Cuando buscas en la lista, la extensión muestra coincidencias en una lista plana única en todos los grupos.439La extensión guarda los grupos por carpeta del espacio de trabajo, por lo que sobreviven a las recargas de ventana y aparecen en cada ventana donde abras la misma carpeta. Cuando buscas en la lista, la extensión muestra las coincidencias en una sola lista plana de todos los grupos.

378 440

379<h3 id="filter-the-sessions-list">441<h3 id="filter-the-sessions-list">

380 Filtra la lista de sesiones442 Filtra la lista de sesiones

381</h3>443</h3>

382 444

383Para reducir una lista larga de sesiones en la barra de actividades, usa los dos controles de filtro en la parte superior de la lista. Requiere Claude Code v2.1.271 o posterior. Las sesiones archivadas no aparecen mientras alguno de los filtros esté activado.445Para acotar una lista de sesiones larga en la Activity Bar, usa los dos controles de filtro de la parte superior de la lista. Requiere Claude Code v2.1.271 o posterior. Las sesiones archivadas no aparecen mientras cualquiera de los filtros esté activado.

384 446

385* **Active**: activa este interruptor para mostrar solo sesiones que necesitan tu entrada, están funcionando, o no han sido leídas, más la sesión en la pestaña de Claude que enfocaste por última vez.447* **Active**: activa este interruptor para mostrar solo las sesiones que necesitan tu intervención, están trabajando o no se han leído, además de la sesión de la pestaña de Claude que enfocaste por última vez.

386* **Filter by status**: haz clic en el icono de embudo, luego marca **Needs input**, **Working**, o **Completed** para mostrar sesiones en cualquiera de esos estados. Marca **Open** o **Closed** para reducir según si una sesión está abierta. Una sesión se cuenta como abierta cuando tiene una pestaña en esta ventana o se está ejecutando en otro proceso de Claude Code en esta máquina, como en una terminal.448* **Filtrar por estado**: haz clic en el ícono de embudo y luego marca **Needs input**, **Working** o **Completed** para mostrar las sesiones en cualquiera de esos estados. Marca **Open** o **Closed** para acotar según si una sesión está abierta. Una sesión cuenta como abierta cuando tiene una pestaña en esta ventana o se está ejecutando en otro proceso de Claude Code en esta máquina, como en una terminal.

387 449

388Cuando **Active** está activado y marcas un estado, **Open**, o **Closed**, la lista también muestra cada sesión que coincide con tus marcas. Los filtros que estableces persisten en recargas de ventana.450Cuando **Active** está activado y marcas un estado, **Open** o **Closed**, la lista también muestra todas las sesiones que coinciden con lo que marcaste. Los filtros que configures persisten entre recargas de ventana.

389 451

390<h3 id="switch-to-terminal-mode">452<h3 id="switch-to-terminal-mode">

391 Cambia al modo terminal453 Cambia al modo terminal

392</h3>454</h3>

393 455

394De forma predeterminada, la extensión abre un panel de chat gráfico. Si prefieres la interfaz de estilo CLI, abre la [configuración Use Terminal](vscode://settings/claudeCode.useTerminal) y marca la casilla.456De forma predeterminada, la extensión abre un panel de chat gráfico. Si prefieres la interfaz estilo CLI, abre el [ajuste Use Terminal](vscode://settings/claudeCode.useTerminal) y marca la casilla.

395 457

396También puedes abrir la configuración de VS Code (`Cmd+,` en Mac o `Ctrl+,` en Windows/Linux), ve a Extensions → Claude Code, y marca **Use Terminal**.458También puedes presionar `Cmd+,` en Mac o `Ctrl+,` en Windows/Linux para abrir la configuración de VS Code, ir a **Extensions > Claude Code** y marcar **Use Terminal**.

397 459

398<h2 id="manage-plugins">460<h2 id="manage-plugins">

399 Gestionar plugins461 Administrar plugins

400</h2>462</h2>

401 463

402La extensión de VS Code incluye una interfaz gráfica para instalar y gestionar [plugins](/docs/es/plugins/overview). Escriba `/plugins` en el cuadro de solicitud para abrir la interfaz **Gestionar plugins**.464La extensión de VS Code incluye una interfaz gráfica para instalar y administrar [plugins](/docs/es/plugins/overview). Escribe `/plugins` en el cuadro del prompt para abrir la interfaz **Manage plugins**.

403 465

404<h3 id="install-plugins">466<h3 id="install-plugins">

405 Instalar plugins467 Instalar plugins

409 471

410En la pestaña Plugins:472En la pestaña Plugins:

411 473

412* Los **plugins instalados** aparecen en la parte superior con interruptores de alternancia para habilitarlos o deshabilitarlos.474* Los **plugins instalados** aparecen en la parte superior con interruptores para activarlos o desactivarlos.

413 * Si desactivas un plugin que el archivo `.claude/settings.json` compartido de tu proyecto activa, la extensión pregunta primero: **Disable for me** lo desactiva solo para ti, mientras que **Disable for everyone** cambia el archivo compartido.475 * Si desactivas un plugin que el `.claude/settings.json` compartido de tu proyecto activa, la extensión te pregunta primero: **Disable for me** lo desactiva solo para ti, mientras que **Disable for everyone** cambia el archivo compartido.

414 * Un plugin que no se pudo cargar muestra un motivo breve en su fila. Haz clic en el motivo para ver qué puedes hacer al respecto, incluido copiar el mensaje de error completo para buscarlo en [Solución de problemas de plugins](/docs/es/plugins/troubleshooting).476 * Un plugin que no se pudo cargar muestra un motivo breve en su fila. Haz clic en el motivo para ver qué puedes hacer al respecto, incluido copiar el mensaje de error completo para buscarlo en [Solución de problemas de plugins](/docs/es/plugins/troubleshooting).

415* Los **plugins disponibles** de sus marketplaces configurados aparecen a continuación477* Los **plugins disponibles** de tus marketplaces configurados aparecen debajo

416* Busque para filtrar plugins por nombre o descripción478* Busca para filtrar plugins por nombre o descripción

417* Haga clic en **Instalar** en cualquier plugin disponible479* Haz clic en **Install** en cualquier plugin disponible

418 480

419Cuando instale un plugin, elija el alcance de la instalación:481Cuando instalas un plugin, elige el alcance de la instalación:

420 482

421* **Instalar para usted**: disponible en todos sus proyectos (alcance de usuario)483* **Install for you**: disponible en todos tus proyectos (alcance de usuario)

422* **Instalar para este proyecto**: compartido con colaboradores del proyecto (alcance de proyecto)484* **Install for this project**: compartido con los colaboradores del proyecto (alcance de proyecto)

423* **Instalar localmente**: solo para usted, solo en este repositorio (alcance local)485* **Install locally**: solo para ti, solo en este repositorio (alcance local)

424 486

425Una vez que la instalación finaliza, un formulario solicita cualquiera de las [opciones de configuración](/docs/es/plugins/components#user-configuration) del plugin que aún no estén configuradas. Para revisar o cambiar las opciones más tarde, haga clic en el icono de engranaje en la fila del plugin.487Una vez que termina la instalación, un formulario te pide cualquiera de las [opciones de configuración](/docs/es/plugins/components#user-configuration) del plugin que aún no estén establecidas. Para revisar o cambiar las opciones más adelante, haz clic en el icono de engranaje en la fila del plugin.

426 488

427Los campos de texto sensibles están enmascarados, y un secreto que guardó anteriormente muestra **(sin cambios)**. Deje el campo en blanco para mantener el valor guardado.489Los campos de texto confidenciales están enmascarados, y un secreto que guardaste antes muestra **(unchanged)**. Deja el campo en blanco para conservar el valor guardado. Después de guardar los cambios, las sesiones abiertas recargan sus plugins y el diálogo muestra **Restart Claude to apply plugin changes**.

~~428~~

429Después de guardar los cambios, las sesiones abiertas recargan sus plugins y el diálogo muestra **Restart Claude to apply plugin changes**.

430 490

431<h3 id="uninstall-plugins">491<h3 id="uninstall-plugins">

432 Desinstalar plugins492 Desinstalar plugins

433</h3>493</h3>

434 494

435Cada fila instalada nombra el [alcance](/docs/es/plugins/install#choose-an-install-scope) en el que está instalada. Para desinstalar esa instalación, haga clic en el icono de papelera de la fila. Un icono de papelera atenuado marca una fila que no puede desinstalar desde este espacio de trabajo, como un plugin que su organización gestiona o uno instalado para otro proyecto.495Cada fila instalada indica el [alcance](/docs/es/plugins/install#choose-an-install-scope) en el que está instalado. Para desinstalar esa instalación, haz clic en el icono de papelera de la fila. Un icono de papelera atenuado marca una fila que no puedes desinstalar desde este espacio de trabajo, como un plugin que administra tu organización o uno instalado para otro proyecto.

436 496

437La extensión pregunta primero en dos casos:497La extensión pregunta primero en dos casos:

438 498

439* **Un plugin que el archivo `.claude/settings.json` compartido de su proyecto activa**: elija **Disable for me**, que mantiene el plugin instalado para sus colaboradores, o **Uninstall for everyone**, que elimina la instalación del proyecto con [`--keep-data`](/docs/es/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), por lo que el directorio de datos guardados del plugin permanece. Si ya desactivó el plugin para usted mismo, el icono de papelera elimina su propia instalación sin la pregunta.499* **Un plugin que el `.claude/settings.json` compartido de tu proyecto activa**: elige **Disable for me**, que mantiene el plugin instalado para tus colaboradores, o **Uninstall for everyone**, que elimina la instalación del proyecto con [`--keep-data`](/docs/es/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), de modo que el directorio de datos guardados del plugin se conserva. Si ya desactivaste el plugin para ti, el icono de papelera elimina tu propia instalación sin hacer la pregunta.

440* **De lo contrario, la última instalación de un plugin con datos guardados**: elija si desea mantener o eliminar los datos; **Keep** es el predeterminado500* **En otro caso, la última instalación de un plugin con datos guardados**: elige si conservar o eliminar los datos; **Keep** es la opción predeterminada

441 501

442<h3 id="share-a-plugin-install-link">502<h3 id="share-a-plugin-install-link">

443 Compartir un enlace de instalación de plugin503 Compartir un enlace de instalación de un plugin

444</h3>504</h3>

445 505

446Para enviar a alguien directamente a la instalación de un plugin específico, proporciónele la URL `install-plugin` de la extensión. Al abrirla, se inicia o enfoca VS Code, abre el panel Claude Code y abre el diálogo **Gestionar plugins** en la opción de alcance de ese plugin. Nada se instala hasta que la persona elige un alcance. Si el marketplace del plugin aún no está configurado en su Claude Code, el diálogo primero le pide que lo agregue.506Para enviar a alguien directamente a instalar un plugin específico, dale la URL `install-plugin` de la extensión. Al abrirla se inicia o enfoca VS Code, se abre el panel de Claude Code y se abre el diálogo **Manage plugins** en la elección de alcance de ese plugin. No se instala nada hasta que la persona elige un alcance. Si el marketplace del plugin aún no está configurado en su Claude Code, el diálogo primero le pide que lo agregue.

447 507

448```text theme={null}508```text theme={null}

449vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official509vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

450```510```

451 511

452La URL toma dos parámetros de consulta:512La URL acepta dos parámetros de consulta:

453 513

454| Parámetro | Descripción |514| Parámetro | Descripción |

455| - | - |515| - | - |

457| `marketplace` | La [fuente](/docs/es/plugins/install#add-a-marketplace) del marketplace: un `owner/repo` de GitHub, una URL `https://`, o una dirección de git SSH como `git@github.com:owner/repo.git`. Por defecto es `anthropics/claude-plugins-official` cuando se omite. |517| `marketplace` | La [fuente](/docs/es/plugins/install#add-a-marketplace) del marketplace: un `owner/repo` de GitHub, una URL `https://` o una dirección SSH de git como `git@github.com:owner/repo.git`. Usa `anthropics/claude-plugins-official` de forma predeterminada cuando se omite. |

458 518

459La extensión verifica ambos valores antes de abrir cualquier cosa:519La extensión verifica ambos valores antes de abrir cualquier cosa:

460 520

461* **Nombre del plugin**: como máximo 100 caracteres, comenzando con una letra o un dígito ASCII y, por lo demás, usando solo letras y dígitos ASCII, `.`, `_` y `-`.521* **Nombre del plugin**: como máximo 100 caracteres, que comience con una letra o un dígito ASCII y que, por lo demás, use solo letras ASCII, dígitos, `.`, `_` y `-`.

462* **Fuente del marketplace**: solo las formas que enumera el parámetro `marketplace`, por lo que no se admite una ruta local, una dirección `http://` ni el nombre del marketplace, como `claude-plugins-official`. Una URL `https://` no puede contener un nombre de usuario, una contraseña ni una cadena de consulta.522* **Fuente del marketplace**: solo las formas que lista el parámetro `marketplace`, así que no una ruta local, una dirección `http://` ni el nombre del marketplace, como `claude-plugins-official`. Una URL `https://` no puede contener un nombre de usuario, una contraseña ni una cadena de consulta.

463* **Ref de Git**: para fijar el marketplace a una rama o etiqueta, agrega la ref a la fuente después de `%23`, la forma codificada de `#`, como en `marketplace=owner/repo%23v1.0`. Un enlace con un `#` sin codificar falla. Los marketplaces de la organización `anthropics` de GitHub no se pueden fijar en un enlace.523* **Ref de Git**: para fijar el marketplace a una rama o etiqueta, agrega la ref a la fuente después de `%23`, la forma codificada de `#`, como en `marketplace=owner/repo%23v1.0`. Un enlace con un `#` sin codificar falla. Los marketplaces de la organización `anthropics` de GitHub no se pueden fijar en un enlace.

464 524

465Quien abra un enlace que infrinja estas reglas verá un error que comienza con `Invalid plugin installation URL`. El panel Claude Code y el diálogo no se abren, y nada se instala. Si el nombre o el marketplace de tu plugin no pueden ir en un enlace, indica a las personas que agreguen el marketplace en la pestaña **Marketplaces** y luego instalen el plugin desde la pestaña **Plugins**.525Quien abre un enlace que incumple estas reglas ve un error que comienza con `Invalid plugin installation URL`. El panel de Claude Code y el diálogo no se abren, y no se instala nada. Si el nombre de tu plugin o tu marketplace no pueden ir en un enlace, indícales a las personas que agreguen el marketplace en la pestaña **Marketplaces** y luego instalen el plugin desde la pestaña **Plugins**.

466 526

467Estos casos terminan en un mensaje en el diálogo en lugar de la opción de alcance:527Estos casos terminan en un mensaje en el diálogo en lugar de la elección de alcance:

468 528

469* **El marketplace no enumera un plugin con ese nombre**: el diálogo informa que el plugin no fue encontrado. Verifique el valor de `plugin` contra el listado del marketplace.529* **El marketplace no lista ningún plugin con ese nombre**: el diálogo informa que no se encontró el plugin. Compara el valor de `plugin` con la lista del marketplace.

470* **El plugin ya está instalado**: el diálogo lo indica, y nada cambia.530* **El plugin ya está instalado**: el diálogo lo indica y no cambia nada.

471* **Ya se agregó otro marketplace con el mismo nombre**: el diálogo indica que el marketplace del enlace no se agregó, y nada se instala.531* **Ya se agregó un marketplace diferente con el mismo nombre**: el diálogo indica que no se agregó el marketplace del enlace, y no se instala nada.

472 532

473Los README de GitHub, problemas y algunos otros hosts de Markdown eliminan enlaces cuyo esquema no es `http` o `https`, por lo que un enlace `vscode://` allí se representa como texto sin formato. Coloque la URL en un bloque de código en esos hosts, como [El enlace se representa como texto sin formato en lugar de ser clickeable](/docs/es/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) describe para enlaces `claude-cli://`.533Los README de GitHub, los issues y algunos otros hosts de Markdown eliminan los enlaces cuyo esquema no es `http` ni `https`, por lo que un enlace `vscode://` allí se muestra como texto sin formato. Coloca la URL en un bloque de código en esos hosts, como se describe en [El enlace se muestra como texto sin formato en lugar de ser clicable](/docs/es/deep-links#the-link-renders-as-plain-text-instead-of-being-clickable) para los enlaces `claude-cli://`.

474 534

475<h3 id="manage-marketplaces">535<h3 id="manage-marketplaces">

476 Gestionar marketplaces536 Administrar marketplaces

477</h3>537</h3>

478 538

479Cambie a la pestaña **Marketplaces** para agregar o eliminar fuentes de plugins:539Cambia a la pestaña **Marketplaces** para agregar o eliminar fuentes de plugins:

480 540

481* Ingrese un repositorio de GitHub, URL o ruta local para agregar un nuevo marketplace541* Ingresa un repositorio de GitHub, una URL o una ruta local para agregar un nuevo marketplace

482* Haga clic en el icono de actualización para actualizar la lista de plugins de un marketplace542* Haz clic en el icono de actualizar para actualizar la lista de plugins de un marketplace

483* Haga clic en el icono de papelera para eliminar un marketplace. Eliminarlo [desinstala cada plugin que instaló desde él](/docs/es/plugins/install#manage-marketplaces), por lo que una confirmación nombra esos plugins primero543* Haz clic en el icono de papelera para eliminar un marketplace. Eliminarlo [desinstala todos los plugins que instalaste desde él](/docs/es/plugins/install#manage-marketplaces), por lo que primero aparece una confirmación que nombra esos plugins

484 544

485Los cambios de plugins que realiza en el diálogo se aplican inmediatamente a las sesiones de Claude Code abiertas en esa ventana de VS Code.545Los cambios de plugins que haces en el diálogo se aplican de inmediato a las sesiones de Claude Code abiertas en esa ventana de VS Code.

486 546

487Si la sesión desde la que abrió el diálogo no puede recargar sus plugins, el diálogo le ofrece intentar de nuevo o reiniciar Claude en esa sesión.547Si la sesión desde la que abriste el diálogo no puede recargar sus plugins, el diálogo ofrece volver a intentarlo o reiniciar Claude en esa sesión.

488 548

489<Note>549<Note>

490 La gestión de plugins en VS Code utiliza los mismos comandos CLI bajo el capó. Los plugins y marketplaces que configure en la extensión también están disponibles en la CLI, y viceversa.550 La extensión administra los plugins ejecutando los mismos comandos que la CLI. Los plugins y marketplaces que configuras en la extensión también están disponibles en la CLI, y viceversa.

491</Note>551</Note>

492 552

493Para obtener más información sobre el sistema de plugins, consulte [Plugins](/docs/es/plugins/overview) y [Plugin marketplaces](/docs/es/plugins/overview).553Para obtener más información sobre el sistema de plugins, consulta [Plugins](/docs/es/plugins/overview) y [Marketplaces de plugins](/docs/es/plugins/overview).

494 554

495<h3 id="plugins-that-draw-in-the-panel">555<h3 id="plugins-that-draw-in-the-panel">

496 Plugins que dibujan en el panel556 Plugins que dibujan en el panel

498 558

499Un plugin que contiene un [mod](/docs/es/plugins/mods/overview) puede dibujar en el panel de chat. Dibujar requiere la versión 2.1.299 o posterior de la extensión y una sesión que [obtenga feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching). De un plugin así puedes ver:559Un plugin que contiene un [mod](/docs/es/plugins/mods/overview) puede dibujar en el panel de chat. Dibujar requiere la versión 2.1.299 o posterior de la extensión y una sesión que [obtenga feature flags](/docs/es/env-vars#features-that-need-feature-flag-fetching). De un plugin así puedes ver:

500 560

501* Un panel junto a la conversación o encima del cuadro de prompt561* Un panel junto a la conversación o encima del cuadro del prompt

502* Una notificación emergente o una línea de estado encima del cuadro de prompt562* Una notificación emergente o una línea de estado encima del cuadro del prompt

503* Un mensaje o una llamada a herramienta dibujados a la manera propia del plugin563* Un mensaje o una llamada a herramienta dibujados a la manera propia del plugin

504 564

505Cuando un plugin que instalaste agrega o cambia algo en el panel, una etiqueta lo nombra, con frases como estas:565Cuando un plugin que instalaste agrega o cambia algo en el panel, una etiqueta lo nombra, con frases como estas:

506 566

507* **From the token-chart plugin**: el plugin dibujó o imprimió esto, o esta tarjeta es el plugin preguntándote algo567* **From the token-chart plugin**: el plugin dibujó o imprimió esto, o esta tarjeta es el plugin preguntándote algo

508* **Edited by the token-chart plugin**: el plugin cambió algo que Claude Code dibuja, como una llamada a herramienta568* **Edited by the token-chart plugin**: el plugin cambió algo que dibuja Claude Code, como una llamada a herramienta

509* **Prompt from the token-chart plugin**: el plugin envió este mensaje en tu nombre569* **Prompt from the token-chart plugin**: el plugin envió este mensaje en tu nombre

510 570

511Para impedir que un plugin dibuje, desactiva el plugin en el [diálogo de plugins](#install-plugins).571Para evitar que un plugin dibuje, desactiva el plugin en el [diálogo de plugins](#install-plugins).

512 572

513<h2 id="automate-browser-tasks-with-chrome">573<h2 id="automate-browser-tasks-with-chrome">

514 Automatizar tareas del navegador con Chrome574 Automatiza tareas del navegador con Chrome

515</h2>575</h2>

516 576

517Conecta Claude a tu navegador Chrome para probar aplicaciones web, depurar con registros de consola y automatizar flujos de trabajo del navegador sin salir de VS Code. Esto requiere la [extensión Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versión 1.0.36 o superior.577Conecta Claude a tu navegador Chrome para probar aplicaciones web, depurar con registros de la consola y automatizar flujos de trabajo del navegador sin salir de VS Code. Esto requiere la [extensión Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versión 1.0.36 o posterior.

518 578

519Escribe `@browser` en el cuadro de prompt seguido de lo que quieres que Claude haga:579Escribe `@browser` en el cuadro del prompt seguido de lo que quieres que haga Claude:

520 580

521```text wrap theme={null}581```text wrap theme={null}

522@browser go to localhost:3000 and check the console for errors582@browser go to localhost:3000 and check the console for errors

524 584

525También puedes abrir el menú de archivos adjuntos para seleccionar herramientas específicas del navegador, como abrir una nueva pestaña o leer el contenido de la página.585También puedes abrir el menú de archivos adjuntos para seleccionar herramientas específicas del navegador, como abrir una nueva pestaña o leer el contenido de la página.

526 586

527Claude abre nuevas pestañas para tareas del navegador y comparte el estado de inicio de sesión de tu navegador, por lo que puede acceder a cualquier sitio en el que ya hayas iniciado sesión.587Claude abre nuevas pestañas para las tareas del navegador y comparte el estado de inicio de sesión de tu navegador, por lo que puede acceder a cualquier sitio en el que ya hayas iniciado sesión.

588

589Para obtener más información sobre cómo trabajar con el navegador, consulta:

528 590

529Para que cada sesión se conecte a tu navegador al iniciarse, sin escribir `@browser`, consulta [Habilitar Chrome de forma predeterminada](/docs/es/chrome#enable-chrome-by-default). Para saber qué ocurre cuando Claude Code te pide confirmación antes de una acción del navegador, consulta [Solicitudes de permiso en sesiones de VS Code](/docs/es/chrome#permission-prompts-in-vs-code-sessions).591* [Habilitar Chrome de forma predeterminada](/docs/es/chrome#enable-chrome-by-default): haz que cada sesión se conecte a tu navegador al iniciarse, sin escribir `@browser`

592* [Solicitudes de permiso en sesiones de VS Code](/docs/es/chrome#permission-prompts-in-vs-code-sessions): cuándo Claude Code te pregunta antes de una acción del navegador

593* [Usar Claude Code con Chrome](/docs/es/chrome): instrucciones de configuración, la lista completa de capacidades y solución de problemas

530 594

531Para obtener instrucciones de configuración, la lista completa de capacidades y solución de problemas, consulta [Usar Claude Code con Chrome](/docs/es/chrome).595<h2 id="work-with-git">

596 Trabajar con git

597</h2>

598

599Claude Code se integra con git para ayudar con flujos de trabajo de control de versiones directamente en VS Code. Pida a Claude que confirme cambios, cree solicitudes de extracción o trabaje en diferentes ramas. Para iniciar Claude en un árbol de trabajo aislado con sus propios archivos y rama, consulte [Ejecutar sesiones paralelas con worktrees](/docs/es/worktrees).

600

601<h3 id="create-commits-and-pull-requests">

602 Crear confirmaciones y solicitudes de extracción

603</h3>

604

605Claude puede preparar cambios, escribir mensajes de confirmación y crear solicitudes de extracción basadas en su trabajo:

606

607```text wrap theme={null}

608commit my changes with a descriptive message

609create a pr for this feature

610summarize the changes I've made to the auth module

611```

612

613Al crear solicitudes de extracción, Claude genera descripciones basadas en los cambios de código reales y puede agregar contexto sobre decisiones de prueba o implementación.

614

615<h2 id="run-work-in-the-background">

616 Ejecutar trabajo en segundo plano

617</h2>

618

619Envía un comando o subagente de larga duración al segundo plano y luego consulta su estado desde el cuadro de prompt.

620

621<h3 id="move-a-running-command-or-subagent-to-the-background">

622 Mover un comando o subagente en ejecución al segundo plano

623</h3>

624

625Cuando un comando o un [subagente](/docs/es/sub-agents) hace que Claude espere más de lo que quieres, haz clic en **Run in background** debajo de su llamada a herramienta en la conversación. Requiere Claude Code v2.1.287 o posterior.

626

627* **Momento**: la acción aparece una vez que un comando lleva unos dos segundos en ejecución, o tan pronto como se inicia un subagente.

628* **Después de hacer clic**: Claude deja de esperar y continúa el turno. El comando o subagente sigue ejecutándose como una [tarea en segundo plano](/docs/es/tools-reference#background-commands) que notifica a Claude cuando termina.

629

630Para consultar el estado de la tarea o detenerla mientras tanto, escribe `/tasks` en el cuadro de prompt para abrir el [mapa de agentes](#use-the-prompt-box). Un subagente conserva su lugar en el árbol de agentes allí, y un comando aparece debajo de los agentes con su [salida más reciente en su tarjeta](#monitor-background-processes).

631

632<h3 id="monitor-background-processes">

633 Supervisar procesos en segundo plano

634</h3>

635

636Escribe `/tasks` en el cuadro de prompt para abrir el [mapa de agentes](#use-the-prompt-box), que enumera las tareas en segundo plano de la sesión, como un servidor de desarrollo que Claude dejó en ejecución como un comando de shell en segundo plano. Haz clic en una tarea para abrir su tarjeta, donde puedes detenerla. Requiere Claude Code v2.1.277 o posterior.

637

638Para un comando de shell en segundo plano, o un [monitor](/docs/es/tools-reference#monitor-tool) que ejecuta un comando, la tarjeta también muestra la salida más reciente del comando y la actualiza mientras el comando se ejecuta.

532 639

533<h2 id="vs-code-commands-and-shortcuts">640<h2 id="vs-code-commands-and-shortcuts">

534 Comandos y atajos de teclado de VS Code641 Comandos y atajos de VS Code

535</h2>642</h2>

536 643

537Abra la Paleta de Comandos (`Cmd+Shift+P` en Mac o `Ctrl+Shift+P` en Windows/Linux) y escriba "Claude Code" para ver todos los comandos disponibles de VS Code para la extensión Claude Code.644Para abrir la Paleta de comandos, presiona `Cmd+Shift+P` en Mac o `Ctrl+Shift+P` en Windows/Linux. Escribe "Claude Code" allí para ver todos los comandos de VS Code disponibles para la extensión de Claude Code.

538 645

539Algunos atajos de teclado dependen de qué panel esté "enfocado" (recibiendo entrada de teclado). Cuando su cursor está en un archivo de código, el editor está enfocado. Cuando su cursor está en el cuadro de solicitud de Claude, Claude está enfocado. Use `Cmd+Esc` / `Ctrl+Esc` para alternar entre ellos.646Algunos atajos dependen de qué panel tiene el "foco" (recibe la entrada del teclado). Cuando tu cursor está en un archivo de código, el editor tiene el foco. Cuando tu cursor está en el cuadro de prompt de Claude, Claude tiene el foco. Usa `Cmd+Esc` / `Ctrl+Esc` para alternar entre ellos.

540 647

541<Note>648<Note>

542 Estos son comandos de VS Code para controlar la extensión. No todos los comandos integrados de Claude Code están disponibles en la extensión. Consulte [Extensión de VS Code frente a CLI de Claude Code](#vs-code-extension-vs-claude-code-cli) para obtener más detalles.649 Estos son comandos de VS Code para controlar la extensión. No todos los comandos integrados de Claude Code están disponibles en la extensión. Consulta [Extensión de VS Code vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli) para más detalles.

543</Note>650</Note>

544 651

546| - | - | - |653| - | - | - |

548| Focus last message | - | Mover el enfoque del teclado al mensaje más reciente en la conversación, o a un aviso de permiso pendiente, para que pueda leer desde allí con el teclado o un lector de pantalla. No disponible en [modo terminal](#switch-to-terminal-mode). Requiere Claude Code v2.1.268 o posterior |655| Focus last message | - | Mueve el foco del teclado al mensaje más reciente de la conversación, o a una solicitud de permiso en espera, para que puedas leer desde allí con el teclado o un lector de pantalla. No disponible en el [modo terminal](#switch-to-terminal-mode). Requiere Claude Code v2.1.268 o posterior |

549| Open in Side Bar | - | Abrir Claude en la barra lateral |656| Open in Side Bar | - | Abre Claude en la barra lateral |

550| Open in Terminal | - | Abrir Claude en modo terminal |657| Open in Terminal | - | Abre Claude en modo terminal |

552| Open in New Window | - | Abrir una nueva conversación en una ventana separada |659| Open in New Window | - | Abre una nueva conversación en una ventana separada |

553| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Iniciar una nueva conversación. Requiere que Claude esté enfocado y `enableNewConversationShortcut` establecido en `true` |660| New Conversation | `Cmd+N` (Mac) / `Ctrl+N` (Windows/Linux) | Inicia una nueva conversación. Requiere que Claude tenga el foco y que `enableNewConversationShortcut` esté establecido en `true` |

554| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Reabrir la pestaña de sesión de Claude cerrada más recientemente. Se remite a la reapertura normal de editor cerrado de VS Code cuando la última pestaña cerrada no era una sesión de Claude. Deshabilitar con `enableReopenClosedSessionShortcut` |661| Reopen Closed Session | `Cmd+Shift+T` (Mac) / `Ctrl+Shift+T` (Windows/Linux) | Vuelve a abrir la pestaña de sesión de Claude cerrada más recientemente. Recurre a la acción normal de VS Code de reabrir el editor cerrado cuando la última pestaña cerrada no era una sesión de Claude. Desactívalo con `enableReopenClosedSessionShortcut` |

555| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Insertar una referencia al archivo actual y la selección (requiere que el editor esté enfocado) |662| Insert @-Mention Reference | `Option+K` (Mac) / `Alt+K` (Windows/Linux) | Inserta una referencia al archivo y la selección actuales (requiere que el editor tenga el foco) |

556| Accept Change at Cursor | - | Aceptar el cambio en el cursor mientras [revisa una edición propuesta](#get-started) un cambio a la vez. Requiere Claude Code v2.1.275 o posterior |663| Accept Change at Cursor | - | Acepta el cambio en el cursor mientras [revisas una edición propuesta](#get-started) un cambio a la vez. Requiere Claude Code v2.1.275 o posterior |

557| Reject Change at Cursor | - | Revertir el cambio en el cursor mientras revisa una edición propuesta un cambio a la vez. Requiere Claude Code v2.1.275 o posterior |664| Reject Change at Cursor | - | Revierte el cambio en el cursor mientras revisas una edición propuesta un cambio a la vez. Requiere Claude Code v2.1.275 o posterior |

558| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Ocultar o mostrar la actividad de herramientas en la conversación. Funciona mientras un panel de Claude o la barra lateral sea visible. Requiere Claude Code v2.1.221 o posterior |665| Toggle Focus view | `Ctrl+Option+F` (Mac) / `Ctrl+Alt+F` (Windows/Linux) | Oculta o muestra la actividad de las herramientas en la conversación. Funciona mientras un panel o una barra lateral de Claude está visible. Requiere Claude Code v2.1.221 o posterior |

559| Rename Session Tab | - | Cambiar el nombre de la sesión en la pestaña activa de Claude. Requiere Claude Code v2.1.257 o posterior |666| Rename Session Tab | - | Cambia el nombre de la sesión en la pestaña activa de Claude. Requiere Claude Code v2.1.257 o posterior |

560| Add Session Tab to Group | - | Agregar la sesión en la pestaña activa de Claude a un [grupo de sesiones](#organize-sessions-into-groups) que elija o cree. Requiere Claude Code v2.1.257 o posterior |667| Add Session Tab to Group | - | Agrega la sesión de la pestaña activa de Claude a un [grupo de sesiones](#organize-sessions-into-groups) que elijas o crees. Requiere Claude Code v2.1.257 o posterior |

561| Mark Session as Unread | - | Marcar la sesión en la pestaña activa de Claude como no leída en la lista de sesiones. Requiere Claude Code v2.1.257 o posterior |668| Mark Session as Unread | - | Marca la sesión de la pestaña activa de Claude como no leída en la lista de sesiones. Requiere Claude Code v2.1.257 o posterior |

562| Show Logs | - | Ver registros de depuración de la extensión |669| Show Logs | - | Muestra los registros de depuración de la extensión |

563| Logout | - | Cerrar sesión en su cuenta de Anthropic |670| Logout | - | Cierra sesión en tu cuenta de Anthropic |

564 671

565<h3 id="launch-a-vs-code-tab-from-other-tools">672<h3 id="launch-a-vs-code-tab-from-other-tools">

566 Iniciar una pestaña de VS Code desde otras herramientas673 Abrir una pestaña de VS Code desde otras herramientas

567</h3>674</h3>

568 675

569La extensión registra un controlador de URI en `vscode://anthropic.claude-code/open`. Úselo para abrir una nueva pestaña de Claude Code desde sus propias herramientas: un alias de shell, un marcador de navegador o cualquier script que pueda abrir una URL. Si VS Code no se está ejecutando, abrir la URL lo inicia primero. Si VS Code ya se está ejecutando, la URL se abre en la ventana que actualmente tiene el enfoque.676La extensión registra un controlador de URI en `vscode://anthropic.claude-code/open`. Úsalo para abrir una nueva pestaña de Claude Code desde tus propias herramientas: un alias del shell, un bookmarklet del navegador o cualquier script que pueda abrir una URL. Si VS Code aún no se está ejecutando, abrir la URL lo inicia primero. Si VS Code ya se está ejecutando, la URL se abre en la ventana que tenga el foco en ese momento.

570 677

571Invoque el controlador con el abridor de URL de su sistema operativo.678Invoca el controlador con el programa para abrir URL de tu sistema operativo.

572 679

573<Tabs>680<Tabs>

574 <Tab title="macOS">681 <Tab title="macOS">

582 xdg-open "vscode://anthropic.claude-code/open"689 xdg-open "vscode://anthropic.claude-code/open"

583 ```690 ```

584 691

585 El comando `xdg-open` viene del paquete `xdg-utils`. Si el shell informa que no se encuentra, consulte [xdg-open is not found on Linux](/docs/es/deep-links#xdg-open-is-not-found-on-linux).692 El comando `xdg-open` proviene del paquete `xdg-utils`. Si el shell informa que no se encuentra, consulta [xdg-open no se encuentra en Linux](/docs/es/deep-links#xdg-open-is-not-found-on-linux).

586 </Tab>693 </Tab>

587 694

588 <Tab title="Windows">695 <Tab title="Windows">

592 Start-Process "vscode://anthropic.claude-code/open"699 Start-Process "vscode://anthropic.claude-code/open"

593 ```700 ```

594 701

595 En `cmd.exe`, `start` trata su primer argumento entrecomillado como un título de ventana, así que pase un título vacío antes de la URL:702 En `cmd.exe`, `start` trata su primer argumento entre comillas como el título de la ventana, así que pasa un título vacío antes de la URL:

596 703

597 ```cmd theme={null}704 ```cmd theme={null}

598 start "" "vscode://anthropic.claude-code/open"705 start "" "vscode://anthropic.claude-code/open"

604 711

605| Parámetro | Descripción |712| Parámetro | Descripción |

606| - | - |713| - | - |

607| `prompt` | Texto para rellenar previamente en el cuadro de solicitud. Debe estar codificado en URL. La solicitud se rellena previamente pero no se envía automáticamente. |714| `prompt` | Texto para rellenar previamente en el cuadro de prompt. Debe estar codificado como URL. El prompt se rellena previamente, pero no se envía automáticamente. |

608| `session` | Un ID de sesión para reanudar en lugar de iniciar una nueva conversación. La sesión debe pertenecer al espacio de trabajo actualmente abierto en VS Code. Si la sesión no se encuentra, se inicia una conversación nueva. Si la sesión ya está abierta en una pestaña, esa pestaña se enfoca. Para capturar un ID de sesión mediante programación, consulte [Continue conversations](/docs/es/headless#continue-conversations). |715| `session` | Un ID de sesión para reanudar en lugar de iniciar una nueva conversación. La sesión debe pertenecer al espacio de trabajo abierto actualmente en VS Code. Si no se encuentra la sesión, se inicia una conversación nueva en su lugar. Si la sesión ya está abierta en una pestaña, esa pestaña recibe el foco. Para capturar un ID de sesión de forma programática, consulta [Continuar conversaciones](/docs/es/headless#continue-conversations). |

609 716

610Por ejemplo, para abrir una pestaña rellenada previamente con "review my changes":717Por ejemplo, para abrir una pestaña con "review my changes" rellenado previamente:

611 718

612```text theme={null}719```text theme={null}

613vscode://anthropic.claude-code/open?prompt=review%20my%20changes720vscode://anthropic.claude-code/open?prompt=review%20my%20changes

614```721```

615 722

616La extensión también maneja `vscode://anthropic.claude-code/install-plugin`, que [abre el diálogo de plugins en un plugin](#share-a-plugin-install-link). Para iniciar una sesión de terminal en lugar de una pestaña de VS Code, use el controlador `claude-cli://` de la CLI. Consulte [Launch sessions from links](/docs/es/deep-links).723La extensión también gestiona `vscode://anthropic.claude-code/install-plugin`, que [abre el diálogo de plugins en un plugin específico](#share-a-plugin-install-link). Para iniciar una sesión en la terminal en lugar de una pestaña de VS Code, usa el controlador `claude-cli://` de la CLI. Consulta [Iniciar sesiones desde enlaces](/docs/es/deep-links).

617 724

618<h2 id="configure-settings">725<h2 id="configure-settings">

619 Configurar ajustes726 Configurar los ajustes

620</h2>727</h2>

621 728

622La extensión tiene dos tipos de ajustes:729Configuras la extensión en dos lugares: los ajustes de la extensión en VS Code y el archivo de configuración de Claude Code:

623 730

624* **Ajustes de extensión** en VS Code: controlan el comportamiento de la extensión dentro de VS Code. Abra con `Cmd+,` (Mac) o `Ctrl+,` (Windows/Linux), luego vaya a Extensiones → Claude Code. También puede escribir `/` y seleccionar **General config…** para abrir los ajustes.731* **Ajustes de la extensión** en VS Code: controlan el comportamiento de la extensión dentro de VS Code. Ábrelos con `Cmd+,` (Mac) o `Ctrl+,` (Windows/Linux) y luego ve a **Extensions > Claude Code**. También puedes escribir `/` y seleccionar **General config…** para abrir la configuración.

625* **Ajustes de Claude Code** en `~/.claude/settings.json`: compartidos entre la extensión y CLI. Úselo para comandos permitidos, variables de entorno, hooks y servidores MCP. Con Claude Code v2.1.283 o posterior, también es una entrada al modo de permisos en el que comienzan las conversaciones, y en versiones anteriores solo en planes Pro, Max y Team. [Switch permission modes](/docs/es/permission-modes#switch-permission-modes) enumera el orden. Consulte [Settings](/docs/es/settings) para obtener detalles.732* **Configuración de Claude Code** en `~/.claude/settings.json`: compartida entre la extensión y la CLI. Úsala para comandos permitidos, variables de entorno, hooks y servidores MCP. Con Claude Code v2.1.283 o posterior, también es uno de los factores que determinan el modo de permisos con el que empiezan las conversaciones; en versiones anteriores, solo en los planes Pro, Max y Team. [Cambiar modos de permisos](/docs/es/permission-modes#switch-permission-modes) indica el orden. Consulta [Configuración](/docs/es/settings) para más detalles.

626 733

627<Tip>734<Tip>

628 Agregue `"$schema": "https://json.schemastore.org/claude-code-settings.json"` a su `settings.json` para obtener autocompletado y validación en línea para todos los ajustes disponibles directamente en VS Code.735 Agrega `"$schema": "https://json.schemastore.org/claude-code-settings.json"` a tu `settings.json` para obtener autocompletado y validación en línea de todos los ajustes disponibles directamente en VS Code.

629</Tip>736</Tip>

630 737

631<h3 id="extension-settings">738<h3 id="extension-settings">

632 Ajustes de extensión739 Ajustes de la extensión

633</h3>740</h3>

634 741

635VS Code lee `initialPermissionMode` de sus ajustes de usuario e ignora los valores del espacio de trabajo. Antes de v2.1.225, VS Code establecía por defecto el ajuste en `default` y aplicaba los valores del espacio de trabajo.742VS Code lee `initialPermissionMode` de tu configuración de usuario e ignora los valores del espacio de trabajo. Antes de v2.1.225, VS Code establecía `default` como valor predeterminado del ajuste y aplicaba los valores del espacio de trabajo.

636 743

638| - | - | - |745| - | - | - |

640| `initialPermissionMode` | - | Controla los mensajes de aprobación para nuevas conversaciones: `default`, `plan`, `acceptEdits` o `bypassPermissions`. `manual` es un alias para `default` y selecciona el modo etiquetado como **Manual** en el indicador de modo. Cuando lo deja sin establecer, la extensión elige el modo de permisos inicial como se describe en [Switch permission modes](/docs/es/permission-modes#switch-permission-modes). |747| `initialPermissionMode` | - | Controla las solicitudes de aprobación para conversaciones nuevas: `default`, `plan`, `acceptEdits` o `bypassPermissions`. `manual` es un alias de `default` y selecciona el modo etiquetado como **Manual** en el indicador de modo. Si no lo estableces, la extensión elige el modo de permisos inicial como se describe en [Cambiar modos de permisos](/docs/es/permission-modes#switch-permission-modes). |

642| `lockEditorGroups` | `true` | [Bloquear los grupos de editor que Claude inicia para sus pestañas](#choose-where-claude-lives), de modo que los archivos que abre mientras una pestaña de Claude está enfocada vayan a otro grupo. Cuando está desactivado, la extensión nunca bloquea un grupo de editor. Requiere Claude Code v2.1.274 o posterior |749| `lockEditorGroups` | `true` | [Bloquea los grupos de editores que Claude inicia para sus pestañas](#choose-where-claude-lives), de modo que los archivos que abras mientras una pestaña de Claude tiene el foco vayan a otro grupo. Cuando está desactivado, la extensión nunca bloquea un grupo de editores. Requiere Claude Code v2.1.274 o posterior |

644| `attachOpenFile` | `true` | Agregue el archivo que está abierto en el editor a sus mensajes y muéstrelo en el cuadro de mensaje. Cuando está desactivado, solo se agrega el texto seleccionado. Requiere Claude Code v2.1.271 o posterior |751| `attachOpenFile` | `true` | Agrega a tus mensajes el archivo abierto en el editor y lo muestra en el cuadro del prompt. Cuando está desactivado, solo se agrega el texto seleccionado. Requiere Claude Code v2.1.271 o posterior |

646| `scrollToBottomOnSend` | `true` | Desplazarse a la conversación hacia el final cuando envía un mensaje. Cuando está desactivado, la conversación permanece donde la dejó. Requiere Claude Code v2.1.275 o posterior |753| `scrollToBottomOnSend` | `true` | Desplaza la conversación hasta el final cuando envías un mensaje. Cuando está desactivado, la conversación se queda donde la dejaste. Requiere Claude Code v2.1.275 o posterior |

647| `showMessageTimestamps` | `true` | Mostrar cuándo se envió cada mensaje. Una línea con la fecha marca dónde cambia el día. Requiere Claude Code v2.1.284 o posterior. Antes de v2.1.290, el valor predeterminado era `false` |754| `showMessageTimestamps` | `true` | Muestra cuándo se envió cada mensaje. Una línea de fecha marca dónde cambia el día. Requiere Claude Code v2.1.284 o posterior. Antes de v2.1.290, el valor predeterminado era `false` |

648| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Establecer los verbos que el indicador de actividad de la conversación va alternando mientras se ejecuta un turno, con los mismos campos `mode` y `verbs` que [`spinnerVerbs`](/docs/es/settings-reference#spinnerverbs) de la CLI. |755| `spinnerVerbs` | `{"mode": "append", "verbs": []}` | Establece los verbos que el indicador de carga de la conversación va rotando mientras se ejecuta un turno, con los mismos campos `mode` y `verbs` que el ajuste [`spinnerVerbs`](/docs/es/settings-reference#spinnerverbs) de la CLI. |

650| `enableReopenClosedSessionShortcut` | `true` | Usar Cmd/Ctrl+Shift+T para reabrir la pestaña de sesión de Claude cerrada más recientemente. Cuando la última pestaña cerrada no era una sesión de Claude, el atajo ejecuta el comando normal de reapertura de editor cerrado de VS Code en su lugar. |757| `enableReopenClosedSessionShortcut` | `true` | Usa Cmd/Ctrl+Shift+T para reabrir la pestaña de sesión de Claude cerrada más recientemente. Cuando la última pestaña cerrada no era una sesión de Claude, el atajo ejecuta en su lugar el comando normal de VS Code para reabrir el editor cerrado. |

651| `archiveInactiveSessions` | `14` | [Archivar una sesión automáticamente](#resume-past-conversations) después de estos muchos días sin actividad: `1`, `2`, `7` o `14`. Establezca `0` para desactivarlo. Requiere Claude Code v2.1.265 o posterior |758| `archiveInactiveSessions` | `14` | [Archiva una sesión automáticamente](#resume-past-conversations) tras esta cantidad de días sin actividad: `1`, `2`, `7` o `14`. Establece `0` para desactivarlo. Requiere Claude Code v2.1.265 o posterior |

652| `continueAfterReload` | `true` | Después de recargar la ventana, Claude [continúa el paso que fue interrumpido](#continue-conversations-after-a-reload) en la sesión restaurada. Requiere Claude Code v2.1.274 o posterior |759| `continueAfterReload` | `true` | Después de recargar la ventana, Claude [continúa el paso que se interrumpió](#continue-conversations-after-a-reload) en la sesión restaurada. Requiere Claude Code v2.1.274 o posterior |

654| `focusView` | `false` | Ocultar llamadas de herramientas, resultados de herramientas y pensamiento detrás de filas expandibles, dejando sus mensajes y las respuestas de Claude. La lista de tareas más reciente de Claude permanece visible; esto requiere Claude Code v2.1.225 o posterior. También puede alternar la vista de enfoque desde el menú de comandos. Requiere Claude Code v2.1.221 o posterior |761| `focusView` | `false` | Oculta las llamadas a herramientas, los resultados de herramientas y el pensamiento detrás de filas expandibles, dejando visibles tus prompts y las respuestas de Claude. La lista de tareas más reciente de Claude permanece visible; esto requiere Claude Code v2.1.225 o posterior. También puedes activar o desactivar la vista Focus desde el menú de comandos. Requiere Claude Code v2.1.221 o posterior |

657| `environmentVariables` | `[]` | Establecer variables de entorno para el proceso de Claude. Para una configuración compartida, usa en su lugar la configuración de Claude Code. Una entrada [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars) solo se aplica cuando su valor es una ruta absoluta; la extensión no expande `~` e ignora un valor relativo. |764| `environmentVariables` | `[]` | Establece variables de entorno para el proceso de Claude. Para configuración compartida, usa en su lugar la configuración de Claude Code. Una entrada [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars) solo se aplica cuando su valor es una ruta absoluta; la extensión no expande `~` e ignora un valor relativo. |

660| `claudeProcessWrapper` | - | Ejecutable utilizado para iniciar el proceso de Claude. La ruta del binario incluido se pasa como argumento cuando está presente. Establece esto en un binario `claude` instalado por separado si la compilación de la extensión no incluye uno para tu plataforma. |767| `claudeProcessWrapper` | - | Ejecutable usado para iniciar el proceso de Claude. La ruta del binario incluido se pasa como argumento cuando existe. Establécelo en un binario `claude` instalado por separado si la compilación de la extensión no incluye uno para tu plataforma. |

768

769<h2 id="use-third-party-providers">

770 Usar proveedores externos

771</h2>

772

773De forma predeterminada, Claude Code se conecta directamente a la API de Anthropic. Si tu organización usa Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry para acceder a Claude, configura la extensión para que use tu proveedor:

774

775<Steps>

776 <Step title="Desactivar la solicitud de inicio de sesión">

777 Abre el [ajuste Disable Login Prompt](vscode://settings/claudeCode.disableLoginPrompt) y marca la casilla.

778

779 También puedes presionar `Cmd+,` en Mac o `Ctrl+,` en Windows/Linux para abrir la configuración de VS Code, buscar "Claude Code login" y marcar **Disable Login Prompt**.

780 </Step>

781

782 <Step title="Configurar tu proveedor">

783 Sigue la guía de configuración de tu proveedor:

784

785 * [Claude Code en Amazon Bedrock](/docs/es/amazon-bedrock)

786 * [Claude Code en Agent Platform de Google Cloud](/docs/es/google-vertex-ai)

787 * [Claude Code en Microsoft Foundry](/docs/es/microsoft-foundry)

788

789 Estas guías explican cómo configurar tu proveedor en `~/.claude/settings.json`, lo que garantiza que tu configuración se comparta entre la extensión de VS Code y la CLI.

790 </Step>

791</Steps>

792

793Con un proveedor externo, la extensión no ofrece funciones que requieren una cuenta de claude.ai, como las barras de uso del plan, el [dictado por voz](/docs/es/voice-dictation) y la pestaña Web para [sesiones en la nube](#resume-cloud-sessions-from-claude-ai). Para saber qué muestra el cuadro de diálogo Account & usage con estos inicios de sesión, consulta [Consultar la cuenta y el uso](#check-account-and-usage).

794

795Un inicio de sesión de claude.ai que haya quedado de un `/login` anterior permanece sin usar: la extensión no lo envía con ninguna solicitud.

661 796

662<h2 id="use-a-screen-reader">797<h2 id="use-a-screen-reader">

663 Usar un lector de pantalla798 Usar un lector de pantalla

664</h2>799</h2>

665 800

666El panel de chat de la extensión funciona con lectores de pantalla. No necesita activar nada: la extensión anuncia la actividad de la conversación para cada usuario, sin cambios visuales. Esto es independiente del [modo de lector de pantalla](/docs/es/accessibility) de la CLI, que adapta la interfaz del terminal.801El panel de chat de la extensión funciona con lectores de pantalla. No necesitas activar nada: la extensión anuncia la actividad de la conversación para todos los usuarios, sin ningún cambio visual. Esto es independiente del [modo de lector de pantalla](/docs/es/accessibility) opcional de la CLI, que adapta la interfaz de la terminal.

667 802

668La compatibilidad con lectores de pantalla en el panel de chat requiere Claude Code v2.1.236 o posterior.803La compatibilidad con lectores de pantalla en el panel de chat requiere Claude Code v2.1.236 o posterior.

669 804

670Durante una conversación, la extensión anuncia:805Durante una conversación, la extensión anuncia:

671 806

672* **Respuestas de Claude**: la extensión anuncia cada respuesta una sola vez, cuando está completa, y permanece en silencio mientras el texto se transmite. Su lector de pantalla lee los bloques de código como un resumen de recuento de líneas, lee los enlaces por su etiqueta y lee las tablas celda por celda; la respuesta completa permanece legible en la transcripción.807* **Las respuestas de Claude**: la extensión anuncia cada respuesta una sola vez, cuando está completa, y permanece en silencio mientras el texto se transmite. Tu lector de pantalla lee los bloques de código como un resumen con el número de líneas, lee los enlaces por su etiqueta y lee las tablas celda por celda; la respuesta completa sigue disponible para leer en la transcripción.

673* **Solicitudes de permiso y preguntas**: la extensión anuncia una solicitud cuando aparece su solicitud de permiso, nombrando la herramienta que Claude desea utilizar. Anuncia de la misma manera cuando Claude le hace una pregunta y cuando Claude termina un plan y espera su revisión.808* **Solicitudes de permiso y preguntas**: la extensión anuncia una solicitud cuando aparece su solicitud de permiso, indicando la herramienta que Claude quiere usar. Anuncia de la misma manera cuando Claude te hace una pregunta y cuando Claude termina un plan y espera tu revisión.

674* **Cambios de estado**: la extensión anuncia cuando Claude comienza a trabajar, cuando Claude está listo para su entrada y cuando Claude Code comienza a compactar la conversación.809* **Cambios de estado**: la extensión anuncia cuando Claude empieza a trabajar, cuando Claude está listo para tu entrada y cuando Claude Code empieza a compactar la conversación.

675* **Mensajes en cola**: cuando envías un mensaje mientras Claude está trabajando, la extensión anuncia "Message queued." para ese mensaje.810* **Mensajes en cola**: cuando envías un mensaje mientras Claude está trabajando, la extensión anuncia "Message queued." para ese mensaje.

676* **Errores y solicitudes de modelo**: la extensión anuncia errores en la conversación y anuncia cuando aparece la [solicitud de consentimiento de créditos de uso](/docs/es/model-config#fable-and-usage-credits) o la [solicitud de solicitud marcada](/docs/es/model-config#ask-before-switching).811* **Errores y solicitudes del modelo**: la extensión anuncia los errores en la conversación y anuncia cuando aparece la [solicitud de consentimiento de créditos de uso](/docs/es/model-config#fable-and-usage-credits) o la [solicitud de una solicitud marcada](/docs/es/model-config#ask-before-switching).

677 812

678Mientras Claude trabaja, su lector de pantalla lee una etiqueta de texto en lugar de la animación del indicador de progreso.813Mientras Claude trabaja, tu lector de pantalla lee una etiqueta de texto en lugar de la animación del indicador de progreso.

679 814

680Cuando reabre una sesión o cambia a otra, la extensión no anuncia nada: el historial restaurado, las solicitudes de permiso pendientes y el estado en progreso permanecen en silencio hasta que suceda algo nuevo.815Cuando vuelves a abrir una sesión o cambias a otra, la extensión no anuncia nada: el historial restaurado, las solicitudes de permiso pendientes y el estado en curso permanecen en silencio hasta que ocurre algo nuevo.

681 816

682<h3 id="use-the-chat-panel-from-the-keyboard">817<h3 id="use-the-chat-panel-from-the-keyboard">

683 Usar el panel de chat desde el teclado818 Usar el panel de chat desde el teclado

684</h3>819</h3>

685 820

686Cada turno en la transcripción comienza con un encabezado visualmente oculto etiquetado con la solicitud que inició el turno, para que pueda saltar entre turnos con la navegación de encabezados de su lector de pantalla.821Cada turno en la transcripción comienza con un encabezado visualmente oculto etiquetado con el prompt que inició el turno. Usa la navegación por encabezados de tu lector de pantalla para saltar entre turnos.

687 822

688Dentro de un turno, su lector de pantalla anuncia de quién es el mensaje en el que se encuentra mientras se mueve a través de él:823Dentro de un turno, tu lector de pantalla anuncia de quién es el mensaje en el que estás a medida que te desplazas por él:

689 824

690* **Sus mensajes**: "Usted"825* **Tus mensajes**: "You"

691* **Mensajes de Claude**: "Claude"826* **Los mensajes de Claude**: "Claude"

692* **Pasos de herramientas**: "Claude" más el nombre de la herramienta, como "Claude, Bash"827* **Pasos de herramientas**: "Claude" más el nombre de la herramienta, como "Claude, Bash"

693* **Bloques de pensamiento**: "Claude, pensando"828* **Bloques de pensamiento**: "Claude, thinking"

829

830Como la extensión expone la transcripción como una región etiquetada, también puedes mover el foco a la propia transcripción con `Tab` y leerla a tu propio ritmo. Para mover el foco al mensaje más reciente o a una solicitud de permiso en espera, ejecuta **Claude Code: Focus last message** desde la [paleta de comandos](#vs-code-commands-and-shortcuts).

694 831

695Debido a que la extensión expone la transcripción como una región etiquetada, también puede mover el foco a la transcripción misma con `Tab` y leerla a su propio ritmo. Para mover el foco al mensaje más reciente o a una solicitud de permiso en espera, ejecute **Claude Code: Focus last message** desde la [Paleta de comandos](#vs-code-commands-and-shortcuts).832Cuando una opción de una solicitud de permiso guarda una regla de permisos o un acceso a un directorio, su etiqueta termina indicando dónde se guarda la aprobación, como "all projects" o "this session". Para cambiar el destino:

696 833

697Cuando una opción en una solicitud de permiso guarda una regla de permiso o acceso a directorio, su etiqueta termina nombrando dónde se guarda la aprobación, como "todos los proyectos" o "esta sesión". Con esa opción enfocada, presione la tecla de flecha `Izquierda` o `Derecha` para cambiar el destino, y la extensión anuncia cada destino cuando llega a él. También puede hacer clic en el destino en la etiqueta. Las teclas de flecha requieren Claude Code v2.1.268 o posterior.834* Con esa opción enfocada, presiona la tecla de flecha `Left` o `Right`. La extensión anuncia cada destino a medida que te desplazas a él. Las teclas de flecha requieren Claude Code v2.1.268 o posterior.

835* Haz clic en el destino en la etiqueta.

698 836

699<h2 id="vs-code-extension-vs-claude-code-cli">837<h2 id="vs-code-extension-vs-claude-code-cli">

700 Extensión de VS Code vs. Claude Code CLI838 Extensión de VS Code vs. CLI de Claude Code

701</h2>839</h2>

702 840

703Claude Code está disponible tanto como una extensión de VS Code (panel gráfico) como una CLI (interfaz de línea de comandos en la terminal). Algunas características solo están disponibles en la CLI. Si necesita una característica solo de CLI, ejecute `claude` en la terminal integrada de VS Code. Esto requiere la [instalación independiente de CLI](/docs/es/setup): la extensión no agrega `claude` a su PATH. Consulte [Ejecutar CLI en VS Code](#run-cli-in-vs-code).841Claude Code está disponible tanto como extensión de VS Code (panel gráfico) como CLI (interfaz de línea de comandos en la terminal). Algunas funciones solo están disponibles en la CLI. Si necesitas una función exclusiva de la CLI, ejecuta `claude` en la terminal integrada de VS Code. Esto requiere la [instalación independiente de la CLI](/docs/es/setup): la extensión no agrega `claude` a tu PATH. Consulta [Ejecutar la CLI en VS Code](#run-cli-in-vs-code).

704 842

705| Característica | CLI | Extensión de VS Code |843| Función | CLI | Extensión de VS Code |

706| - | - | - |844| - | - | - |

708| Configuración del servidor MCP | Sí | Sí ([agregue y administre servidores](#connect-to-external-tools-with-mcp) con `/mcp` en el panel de chat) |846| Configuración de servidores MCP | Sí | Sí: [agrega y administra servidores](#connect-to-external-tools-with-mcp) con `/mcp` en el panel de chat |

709| Checkpoints | Sí | Sí |847| Checkpoints | Sí | Sí |

710| Atajo bash `!` | Sí | No |848| Atajo de Bash `!` | Sí | No |

711| Finalización de pestañas | Sí | No |849| Autocompletado con Tab | Sí | No |

~~712~~

713<h3 id="rewind-with-checkpoints">

714 Rewind con checkpoints

715</h3>

~~716~~

717La extensión de VS Code admite checkpoints, que rastrean las ediciones de archivos de Claude y le permiten revertir a un estado anterior. Pase el cursor sobre cualquier mensaje para revelar el botón de rewind, luego elija entre tres opciones:

~~718~~

719* **Fork conversation from here**: inicie una nueva rama de conversación desde este mensaje mientras mantiene todos los cambios de código intactos

720* **Rewind code to here**: revierta los cambios de archivo a este punto en la conversación mientras mantiene el historial de conversación completo

721* **Fork conversation and rewind code**: inicie una nueva rama de conversación y revierta los cambios de archivo a este punto

~~722~~

723Para obtener detalles completos sobre cómo funcionan los checkpoints y sus limitaciones, consulte [Checkpointing](/docs/es/checkpointing).

724 850

725<h3 id="run-cli-in-vs-code">851<h3 id="run-cli-in-vs-code">

726 Ejecutar CLI en VS Code852 Ejecutar la CLI en VS Code

727</h3>853</h3>

728 854

729Para usar la CLI mientras permanece en VS Code, abra la terminal integrada (`` Ctrl+` `` en Windows/Linux o `` Cmd+` `` en Mac) y ejecute `claude`. La CLI se integra automáticamente con su IDE para características como visualización de diferencias y uso compartido de diagnósticos.855Para usar la CLI sin salir de VS Code, presiona `` Ctrl+` `` en Windows/Linux o `` Cmd+` `` en Mac para abrir la terminal integrada y luego ejecuta `claude`. La CLI se integra automáticamente con tu IDE para funciones como la visualización de diffs y el uso compartido de diagnósticos. Si usas una terminal externa, ejecuta `/ide` dentro de Claude Code para conectarla a VS Code.

~~730~~

731Instalar la extensión no coloca `claude` en su PATH de shell. La extensión incluye una copia privada de la CLI para su panel de chat, pero escribir `claude` en una terminal requiere la [instalación independiente de CLI](/docs/es/setup). Ejecute la instalación una vez y los comandos en esta página, incluidos `claude mcp add` y `claude --resume`, funcionan en cualquier terminal. Si `claude` aún no se encuentra después de instalar, [verifique su PATH](/docs/es/troubleshoot-install#verify-your-path).

732 856

733Si utiliza una terminal externa, ejecute `/ide` dentro de Claude Code para conectarla a VS Code.857Instalar la extensión no agrega `claude` al PATH de tu shell. La extensión incluye una copia privada de la CLI para su panel de chat, pero escribir `claude` en una terminal requiere la [instalación independiente de la CLI](/docs/es/setup). Ejecuta la instalación una vez y los comandos de esta página, incluidos `claude mcp add` y `claude --resume`, funcionarán en cualquier terminal. Si `claude` sigue sin encontrarse después de la instalación, [verifica tu PATH](/docs/es/troubleshoot-install#verify-your-path).

734 858

735<h3 id="switch-between-extension-and-cli">859<h3 id="switch-between-extension-and-cli">

736 Cambiar entre extensión y CLI860 Cambiar entre la extensión y la CLI

737</h3>

~~738~~

739La extensión y la CLI comparten el mismo historial de conversación. Para continuar una conversación de extensión en la CLI, ejecute `claude --resume` en la terminal. Esto abre un selector interactivo donde puede buscar y seleccionar su conversación.

~~740~~

741<h3 id="include-terminal-output-in-prompts">

742 Incluir salida de terminal en indicaciones

743</h3>861</h3>

744 862

745Haga referencia a la salida de terminal en sus indicaciones usando `@terminal:name` donde `name` es el título de la terminal. Esto permite que Claude vea la salida de comandos, mensajes de error o registros sin copiar y pegar.863La extensión y la CLI comparten el mismo historial de conversaciones. Para continuar en la CLI una conversación de la extensión, ejecuta `claude --resume` en la terminal. Esto abre un selector interactivo donde puedes buscar y seleccionar tu conversación.

746 864

747<h3 id="move-a-running-command-or-subagent-to-the-background">865<h2 id="connect-to-external-tools-with-mcp">

748 Mover un comando o subagente en ejecución a segundo plano866 Conectar con herramientas externas mediante MCP

749</h3>867</h2>

~~750~~

751Cuando Claude está esperando un comando o un [subagente](/docs/es/sub-agents) que tarda más de lo que quieres, haz clic en **Run in background** debajo de su llamada a herramienta en la conversación. La acción aparece cuando un comando lleva unos dos segundos en ejecución, o en cuanto se inicia un subagente. Claude deja de esperar y continúa el turno, mientras el comando o subagente sigue ejecutándose como una [tarea en segundo plano](/docs/es/tools-reference#background-commands) que notifica a Claude cuando termina. Requiere Claude Code v2.1.287 o posterior.

~~752~~

753Para revisar la tarea o detenerla mientras tanto, escribe `/tasks` en el cuadro de prompt para abrir el [mapa de agentes](#use-the-prompt-box). Allí, un subagente conserva su lugar en el árbol de agentes, y un comando aparece debajo de los agentes con su [salida más reciente en su tarjeta](#monitor-background-processes).

~~754~~

755<h3 id="monitor-background-processes">

756 Monitorear procesos en segundo plano

757</h3>

~~758~~

759Escribe `/tasks` en el cuadro de prompt para abrir el [mapa de agentes](#use-the-prompt-box), que enumera las tareas en segundo plano de la sesión, como un servidor de desarrollo que Claude dejó ejecutándose como un comando de shell en segundo plano. Haz clic en una tarea para abrir su tarjeta, donde puedes detenerla. Requiere Claude Code v2.1.277 o posterior.

760 868

761Para un comando de shell en segundo plano, o un [monitor](/docs/es/tools-reference#monitor-tool) que ejecuta un comando, la tarjeta también muestra la salida más reciente del comando y la actualiza mientras el comando se ejecuta.869Los servidores MCP (Model Context Protocol) le dan a Claude acceso a herramientas externas, bases de datos y API.

762 870

763<h3 id="connect-to-external-tools-with-mcp">871Para administrar servidores MCP sin salir de VS Code, escribe `/mcp` en el panel de chat. Desde el cuadro de diálogo que se abre, puedes:

764 Conectar a herramientas externas con MCP

765</h3>

766 872

767MCP (Model Context Protocol) los servidores dan a Claude acceso a herramientas externas, bases de datos y API.873* Agregar servidores

874* Eliminar servidores guardados en el [alcance](/docs/es/mcp#mcp-installation-scopes) local, de usuario o de proyecto

875* Habilitar o deshabilitar servidores

876* Volver a conectarte a un servidor

877* Administrar la autenticación OAuth

768 878

769Para administrar servidores MCP sin salir de VS Code, escriba `/mcp` en el panel de chat. En el diálogo que se abre, puede agregar servidores, eliminar servidores guardados en el [ámbito](/docs/es/mcp#mcp-installation-scopes) local, de usuario o de proyecto, habilitar o deshabilitar servidores, reconectarse a un servidor y administrar la autenticación OAuth. Agregar y eliminar servidores en el diálogo requiere Claude Code v2.1.261 o posterior.879Agregar y eliminar servidores en el cuadro de diálogo requiere Claude Code v2.1.261 o posterior.

770 880

771También puede ejecutar `claude mcp add` en la terminal integrada de VS Code (`` Ctrl+` `` o `` Cmd+` ``). El diálogo y el comando de terminal guardan en la misma configuración de MCP, y los cambios de cualquiera de los dos tienen efecto en las conversaciones que inicia después. El ejemplo a continuación agrega el servidor MCP remoto de GitHub, que se autentica con un [token de acceso personal](https://github.com/settings/personal-access-tokens) pasado como encabezado:881También puedes ejecutar `claude mcp add` en la terminal integrada de VS Code (`` Ctrl+` `` o `` Cmd+` ``). El cuadro de diálogo y el comando de la terminal guardan en la misma configuración de MCP, y los cambios realizados desde cualquiera de los dos surten efecto en las conversaciones que inicies después. El siguiente ejemplo agrega el servidor MCP remoto de GitHub, que se autentica con un [token de acceso personal](https://github.com/settings/personal-access-tokens) que se pasa como encabezado:

772 882

773```bash theme={null}883```bash theme={null}

774claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \884claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \

775 --header "Authorization: Bearer YOUR_GITHUB_PAT"885 --header "Authorization: Bearer YOUR_GITHUB_PAT"

776```886```

777 887

778Reemplace `YOUR_GITHUB_PAT` con su token de acceso personal. El comando `claude mcp add` guarda la configuración sin validar credenciales, por lo que se acepta un valor de marcador de posición aquí pero el servidor no se conecta más tarde. Para verificar la conexión, inicie una nueva conversación, escriba `/mcp` y compruebe que el servidor muestre **Connected**. Un servidor con credenciales incorrectas muestra **Failed**.888Reemplaza `YOUR_GITHUB_PAT` con tu token de acceso personal. El comando `claude mcp add` guarda la configuración sin validar las credenciales, por lo que aquí se acepta un valor de marcador de posición, pero el servidor no logrará conectarse más adelante. Para verificar la conexión, inicia una nueva conversación, escribe `/mcp` y comprueba que el servidor muestre **Connected**. Un servidor con credenciales incorrectas muestra **Failed**.

~~779~~

780Una vez configurado, pida a Claude que use las herramientas (por ejemplo, "Review PR #456").

~~781~~

782Para encontrar servidores para conectar, consulte [Encontrar y construir servidores MCP](/docs/es/mcp#find-and-build-mcp-servers).

~~783~~

784<h2 id="work-with-git">

785 Trabajar con git

786</h2>

~~787~~

788Claude Code se integra con git para ayudar con flujos de trabajo de control de versiones directamente en VS Code. Pida a Claude que confirme cambios, cree solicitudes de extracción o trabaje en diferentes ramas. Para iniciar Claude en un árbol de trabajo aislado con sus propios archivos y rama, consulte [Ejecutar sesiones paralelas con worktrees](/docs/es/worktrees).

~~789~~

790<h3 id="create-commits-and-pull-requests">

791 Crear confirmaciones y solicitudes de extracción

792</h3>

~~793~~

794Claude puede preparar cambios, escribir mensajes de confirmación y crear solicitudes de extracción basadas en su trabajo:

~~795~~

796```text wrap theme={null}

797commit my changes with a descriptive message

798create a pr for this feature

799summarize the changes I've made to the auth module

800```

~~801~~

802Al crear solicitudes de extracción, Claude genera descripciones basadas en los cambios de código reales y puede agregar contexto sobre decisiones de prueba o implementación.

803 889

804<h2 id="use-third-party-providers">890Una vez configurado, pídele a Claude que use las herramientas (por ejemplo, "Revisa el PR #456").

805 Usar proveedores de terceros

806</h2>

807 891

808De forma predeterminada, Claude Code se conecta directamente a la API de Anthropic. Si su organización utiliza Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry para acceder a Claude, configure la extensión para usar su proveedor en su lugar:892<Note>Para encontrar servidores a los que conectarte, consulta [Encontrar y crear servidores MCP](/docs/es/mcp#find-and-build-mcp-servers).</Note>

~~809~~

810<Steps>

811 <Step title="Desactivar el aviso de inicio de sesión">

812 Abra la [configuración Desactivar aviso de inicio de sesión](vscode://settings/claudeCode.disableLoginPrompt) y marque la casilla.

813 893

814 También puede abrir la configuración de VS Code (`Cmd+,` en Mac o `Ctrl+,` en Windows/Linux), buscar "Claude Code login" y marcar **Desactivar aviso de inicio de sesión**.894<h2 id="the-built-in-ide-mcp-server">

815 </Step>895 El servidor MCP integrado del IDE

~~816~~

817 <Step title="Configurar su proveedor">

818 Siga la guía de configuración de su proveedor:

~~819~~

820 * [Claude Code en Amazon Bedrock](/docs/es/amazon-bedrock)

821 * [Claude Code en Google Cloud's Agent Platform](/docs/es/google-vertex-ai)

822 * [Claude Code en Microsoft Foundry](/docs/es/microsoft-foundry)

~~823~~

824 Estas guías cubren la configuración de su proveedor en `~/.claude/settings.json`, lo que garantiza que su configuración se comparta entre la extensión de VS Code y la CLI.

825 </Step>

826</Steps>

~~827~~

828En un proveedor de terceros, la extensión no ofrece características que requieren una cuenta de claude.ai, como barras de uso del plan, [dictado de voz](/docs/es/voice-dictation) y la pestaña Web para [sesiones en la nube](#resume-cloud-sessions-from-claude-ai). Para ver qué muestra el diálogo Cuenta y uso en estos inicios de sesión, consulte [Verificar cuenta y uso](#check-account-and-usage).

~~829~~

830Un inicio de sesión de claude.ai que queda de un `/login` anterior permanece sin usar: la extensión no lo envía con ninguna solicitud.

~~831~~

832<h2 id="security-and-privacy">

833 Seguridad y privacidad

834</h2>896</h2>

835 897

836Tu código permanece privado. Claude Code procesa tu código para proporcionar asistencia, pero no lo utiliza para entrenar modelos. Para obtener detalles sobre el manejo de datos y cómo optar por no participar en el registro, consulta [Datos y privacidad](/docs/es/data-usage).898Cuando la extensión está activa, ejecuta un servidor MCP local al que la CLI se conecta automáticamente. A través de este servidor, la CLI:

~~837~~

838Con los permisos de auto-edición habilitados, Claude Code puede modificar archivos de configuración de VS Code (como `settings.json` o `tasks.json`) que VS Code puede ejecutar automáticamente. Para reducir el riesgo al trabajar con código no confiable:

839 899

840* Habilita el [Modo restringido de VS Code](https://code.visualstudio.com/docs/editor/workspace-trust#_restricted-mode) para espacios de trabajo no confiables900* Abre diffs en el visor de diffs nativo de VS Code

841* Utiliza el modo Manual en lugar de Editar automáticamente o Auto para ediciones901* Lee tu selección actual para las `@`-menciones

842* Revisa los cambios cuidadosamente antes de aceptarlos902* Le pide a VS Code que ejecute celdas cuando trabajas en un notebook de Jupyter

~~843~~

844<h3 id="the-built-in-ide-mcp-server">

845 El servidor MCP IDE integrado

846</h3>

847 903

848Cuando la extensión está activa, ejecuta un servidor MCP local al que la CLI se conecta automáticamente. Así es como la CLI abre diffs en el visor de diffs nativo de VS Code, lee tu selección actual para menciones `@` y, cuando estás trabajando en un cuaderno Jupyter, le pide a VS Code que ejecute celdas.904El servidor se llama `ide` y está oculto en `/mcp` porque no hay nada que configurar. Sin embargo, si tu organización usa un hook `PreToolUse` para agregar herramientas MCP a la lista de permitidos, necesitarás saber que existe.

849 905

850El servidor se llama `ide` y está oculto en `/mcp` porque no hay nada que configurar. Sin embargo, si tu organización utiliza un hook `PreToolUse` para crear una lista de herramientas MCP permitidas, deberás saber que existe.906**Contexto de la selección y del archivo abierto.** Mientras está conectada, la CLI incluye tu selección actual del editor y la ruta del archivo activo como contexto en cada prompt que envías. La transcripción muestra una línea `⧉ Selected N lines from <file>` cuando esto ocurre. Estos casos modifican ese contexto:

851 907

852**Contexto de selección y archivo abierto.** Mientras está conectada, la CLI incluye tu selección actual del editor y la ruta del archivo activo como contexto en cada prompt que envías. La transcripción muestra una línea `⧉ Selected N lines from <file>` cuando esto sucede.908* **Mensajes en cola**: si [pones un mensaje en cola mientras Claude trabaja](/docs/es/interactive-mode#queue-messages-while-claude-works), conserva la selección que tenías cuando presionaste `Enter`, independientemente de lo que selecciones después.

909* **Archivos sensibles**: para excluir un archivo sensible como `.env`, agrega una [regla de denegación `Read`](/docs/es/permissions#read-and-edit) para su ruta. Una regla de denegación que coincida impide que tanto el texto seleccionado como el aviso de archivo abierto de ese archivo lleguen a Claude.

910* **Attach Open File desactivado**: si desactivas el [ajuste Attach Open File](#extension-settings), la CLI recibe la ruta del archivo activo solo mientras tienes texto seleccionado en él.

853 911

854Si [pones en cola un mensaje mientras Claude trabaja](/docs/es/interactive-mode#queue-messages-while-claude-works), mantiene la selección que tenías cuando presionaste `Enter`, sin importar lo que selecciones después.912**Transporte y autenticación.** El servidor se vincula a `127.0.0.1` en un puerto aleatorio en el rango 10000–65535, y el puerto no se puede configurar. El transporte y el token de autenticación funcionan de la siguiente manera:

855 913

856Para excluir un archivo sensible como `.env`, agrega una [regla de denegación `Read`](/docs/es/permissions#read-and-edit) para su ruta. Una regla de denegación coincidente evita que tanto el texto seleccionado como el aviso de archivo abierto para ese archivo lleguen a Claude.914* **Transporte**: `ws://` sin cifrar. Como el socket es solo de loopback, cualquier proceso que pudiera capturar el tráfico también puede leer el token del archivo de bloqueo, por lo que TLS no añadiría protección.

915* **Token de autenticación**: cada activación de la extensión genera un nuevo token de autenticación aleatorio y lo escribe en un archivo de bloqueo en `~/.claude/ide/<port>.lock`. La CLI debe presentar el token como el encabezado `X-Claude-Code-Ide-Authorization` para conectarse.

916* **Permisos del archivo de bloqueo**: el archivo de bloqueo tiene permisos `0600` en un directorio `0700`, por lo que solo el usuario que ejecuta VS Code puede leerlo. Si `CLAUDE_CONFIG_DIR` está definido, el archivo de bloqueo se escribe en `$CLAUDE_CONFIG_DIR/ide/` en su lugar.

857 917

858Si desactivas el [ajuste Attach Open File](#extension-settings), la CLI recibe la ruta del archivo activo solo mientras tengas texto seleccionado en él.918**Herramientas expuestas al modelo.** El servidor aloja una docena de herramientas, pero solo dos son visibles para el modelo. El resto son RPC internas que la CLI usa para su propia interfaz, como abrir diffs, leer selecciones y guardar archivos. Se filtran antes de que la lista de herramientas llegue a Claude.

859 919

860**Transporte y autenticación.** El servidor se vincula a `127.0.0.1` en un puerto aleatorio en el rango 10000–65535, y el puerto no es configurable. El transporte es `ws://` sin cifrar; como el socket es solo de bucle invertido, cualquier proceso que pueda capturar el tráfico también puede leer el token del archivo de bloqueo, por lo que TLS no agregaría protección. Cada activación de extensión genera un token de autenticación aleatorio nuevo, lo escribe en un archivo de bloqueo en `~/.claude/ide/<port>.lock`, y la CLI debe presentarlo como el encabezado `X-Claude-Code-Ide-Authorization` para conectarse. El archivo de bloqueo tiene permisos `0600` en un directorio `0700`, por lo que solo el usuario que ejecuta VS Code puede leerlo. Si se establece `CLAUDE_CONFIG_DIR`, el archivo de bloqueo se escribe en `$CLAUDE_CONFIG_DIR/ide/` en su lugar.920| Nombre de la herramienta (como la ven los hooks) | Qué hace | De solo lectura |

~~861~~

862**Herramientas expuestas al modelo.** El servidor aloja una docena de herramientas, pero solo dos son visibles para el modelo. El resto son RPC internas que la CLI utiliza para su propia interfaz de usuario, como abrir diffs, leer selecciones y guardar archivos. Se filtran antes de que la lista de herramientas llegue a Claude.

~~863~~

864| Nombre de la herramienta (como se ve en los hooks) | Qué hace | De solo lectura |

865| - | - | - |921| - | - | - |

866| `mcp__ide__getDiagnostics` | Devuelve diagnósticos del servidor de lenguaje: los errores y advertencias en el panel Problemas de VS Code. Opcionalmente limitado a un archivo. | Sí |922| `mcp__ide__getDiagnostics` | Devuelve diagnósticos del servidor de lenguaje: los errores y advertencias del panel Problems de VS Code. Opcionalmente limitado a un archivo. | Sí |

867| `mcp__ide__executeCode` | Ejecuta código Python en el kernel del cuaderno Jupyter activo. Consulta el flujo de confirmación a continuación. | No |923| `mcp__ide__executeCode` | Ejecuta código Python en el kernel del notebook de Jupyter activo. Consulta el flujo de confirmación a continuación. | No |

868 924

869**Diagnósticos en el panel de chat.** En el panel de chat, con Claude Code v2.1.285 o posterior, Claude lee el panel Problemas de VS Code a través de un servidor integrado independiente llamado `claude-vscode`. Claude puede pedirle los errores y advertencias actuales de un archivo, o de todos los archivos para los que VS Code tiene diagnósticos.925**Diagnósticos en el panel de chat.** En el panel de chat, con Claude Code v2.1.285 o posterior, Claude lee el panel Problems de VS Code a través de un servidor integrado independiente llamado `claude-vscode`. Claude puede pedirle los errores y advertencias actuales de un archivo, o de todos los archivos para los que VS Code tiene diagnósticos.

870 926

871Los hooks y las reglas de permisos ven la herramienta de diagnósticos del panel de chat como `mcp__claude-vscode__getDiagnostics`. Para cubrir los diagnósticos tanto en la CLI como en el panel de chat, nombra tanto `mcp__ide__getDiagnostics` como `mcp__claude-vscode__getDiagnostics` en tu hook o regla.927Los hooks y las reglas de permisos ven la herramienta de diagnósticos del panel de chat como `mcp__claude-vscode__getDiagnostics`. Para cubrir los diagnósticos tanto en la CLI como en el panel de chat, nombra tanto `mcp__ide__getDiagnostics` como `mcp__claude-vscode__getDiagnostics` en tu hook o regla.

872 928

885 941

886Una regla de denegación `Read` no cubre ninguna de las dos herramientas, así que bloquéalas por nombre con una [regla de denegación](/docs/es/permissions#mcp) como hace el ejemplo.942Una regla de denegación `Read` no cubre ninguna de las dos herramientas, así que bloquéalas por nombre con una [regla de denegación](/docs/es/permissions#mcp) como hace el ejemplo.

887 943

888**La ejecución de Jupyter siempre pregunta primero.** `mcp__ide__executeCode` no puede ejecutar nada silenciosamente. En cada llamada, el código se inserta como una nueva celda al final del cuaderno activo, VS Code la desplaza a la vista, y una Quick Pick nativa te pide que elijas **Execute** o **Cancel**. Cancelar, o descartar el selector con `Esc`, devuelve un error a Claude y nada se ejecuta. La herramienta también se niega rotundamente cuando no hay un cuaderno activo, cuando la extensión Jupyter (`ms-toolsai.jupyter`) no está instalada, o cuando el kernel no es Python.944**La ejecución en Jupyter siempre pregunta primero.** `mcp__ide__executeCode` no puede ejecutar nada de forma silenciosa. Cada llamada pasa por estos pasos:

945

9461. El código se inserta como una nueva celda al final del notebook activo.

9472. VS Code desplaza la vista hasta la celda.

9483. Un Quick Pick nativo te pide que elijas **Execute** o **Cancel**.

949

950Cancelar, o descartar el selector con `Esc`, devuelve un error a Claude y no se ejecuta nada. La herramienta también se niega directamente cuando no hay un notebook activo, cuando la extensión de Jupyter (`ms-toolsai.jupyter`) no está instalada o cuando el kernel no es de Python.

889 951

890<Note>952<Note>

891 La confirmación de Quick Pick es independiente de los hooks `PreToolUse`. Una entrada de lista de permitidos para `mcp__ide__executeCode` permite que Claude *proponga* ejecutar una celda; la Quick Pick dentro de VS Code es lo que permite que *realmente* se ejecute.953 La confirmación del Quick Pick es independiente de los hooks `PreToolUse`. Una entrada en la lista de permitidos para `mcp__ide__executeCode` permite que Claude *proponga* ejecutar una celda; el Quick Pick dentro de VS Code es lo que le permite *realmente* ejecutarla.

892</Note>954</Note>

893 955

894<a id="troubleshooting" />956<a id="troubleshooting" />

895 957

896<h2 id="fix-common-issues">958<h2 id="fix-common-issues">

897 Solucionar problemas comunes959 Soluciona problemas comunes

898</h2>960</h2>

899 961

900Los errores de inicio de sesión, de red y de inicio tienen sus propias entradas en las páginas de solución de problemas de instalación y de referencia de errores. Busca lo que ves en la tabla y luego sigue el enlace.962Los errores de inicio de sesión, de red y de arranque tienen sus propias entradas en las páginas de solución de problemas de instalación y de referencia de errores. Busca lo que ves en la tabla y luego sigue el enlace.

901 963

902| Lo que ves | Adónde ir |964| Lo que ves | Adónde ir |

903| - | - |965| - | - |

904| `API Error: 403 Request not allowed` después de iniciar sesión | [403 Forbidden después de iniciar sesión](/docs/es/troubleshoot-install#403-forbidden-after-login) |966| `API Error: 403 Request not allowed` después de iniciar sesión | [403 Forbidden después de iniciar sesión](/docs/es/troubleshoot-install#403-forbidden-after-login) |

905| Se te pide iniciar sesión de nuevo después de haber iniciado sesión | [No has iniciado sesión o el token expiró](/docs/es/troubleshoot-install#not-logged-in-or-token-expired) |967| Se te pide que inicies sesión de nuevo después de haberlo hecho | [No has iniciado sesión o el token expiró](/docs/es/troubleshoot-install#not-logged-in-or-token-expired) |

906| Las credenciales del proveedor de nube funcionan en tu terminal pero no en la extensión | [Las credenciales de Bedrock, Agent Platform o Foundry no se cargan](/docs/es/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |968| Las credenciales del proveedor de nube funcionan en tu terminal pero no en la extensión | [Las credenciales de Bedrock, Agent Platform o Foundry no se cargan](/docs/es/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) |

907| `SSL certificate verification failed` o `Self-signed certificate detected` | [Errores de certificado SSL](/docs/es/errors#ssl-certificate-errors) |969| `SSL certificate verification failed` o `Self-signed certificate detected` | [Errores de certificado SSL](/docs/es/errors#ssl-certificate-errors) |

908| `Claude Code process exited with code 1`, u otro código | [Claude Code process exited with code N](/docs/es/errors#claude-code-process-exited-with-code-n) |970| `Claude Code process exited with code 1`, u otro código | [Claude Code process exited with code N](/docs/es/errors#claude-code-process-exited-with-code-n) |

914 La extensión no se instala976 La extensión no se instala

915</h3>977</h3>

916 978

917* Asegúrese de tener una versión compatible de VS Code (1.94.0 o posterior)979* Asegúrate de tener una versión compatible de VS Code (1.94.0 o posterior)

918* Verifique que VS Code tenga permiso para instalar extensiones980* Verifica que VS Code tenga permiso para instalar extensiones

919* Intente instalar directamente desde [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)981* Intenta instalarla directamente desde el [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

920 982

921<h3 id="spark-icon-not-visible">983<h3 id="spark-icon-not-visible">

922 El icono Spark no es visible984 El ícono Spark no es visible

923</h3>985</h3>

924 986

925El icono Spark aparece en la **Barra de herramientas del editor** (esquina superior derecha del editor) cuando tiene un archivo abierto. Si no lo ve:987El ícono Spark aparece en la **Editor Toolbar** (parte superior derecha del editor) cuando tienes un archivo abierto. Si no lo ves:

926 988

9271. **Abra un archivo**: El icono requiere que un archivo esté abierto. Solo tener una carpeta abierta no es suficiente.9891. **Abre un archivo**: el ícono requiere que haya un archivo abierto. Tener solo una carpeta abierta no es suficiente.

9282. **Verifique la versión de VS Code**: Requiere 1.94.0 o superior (Ayuda → Acerca de)9902. **Verifica la versión de VS Code**: se requiere 1.94.0 o posterior. Revísala en **Help > About**

9293. **Reinicie VS Code**: Ejecute "Developer: Reload Window" desde la Paleta de comandos9913. **Reinicia VS Code**: ejecuta "Developer: Reload Window" desde la Command Palette

9304. **Desactive extensiones conflictivas**: Desactive temporalmente otras extensiones de IA (Cline, Continue, etc.)9924. **Desactiva las extensiones en conflicto**: desactiva temporalmente otras extensiones de IA (Cline, Continue, etc.)

9315. **Verifique la confianza del espacio de trabajo**: La extensión no funciona en Modo restringido9935. **Verifica la confianza del espacio de trabajo**: la extensión no funciona en el modo restringido (Restricted Mode)

932 994

933Alternativamente, haga clic en **✻ Claude Code** en la **Barra de estado** en la esquina inferior derecha de la ventana. Esto funciona incluso sin un archivo abierto. También puede usar la **Paleta de comandos** (`Cmd+Shift+P` / `Ctrl+Shift+P`) y escribir "Claude Code".995Como alternativa, haz clic en **✻ Claude Code** en la **Status Bar**, en la esquina inferior derecha de la ventana. Esto funciona incluso sin un archivo abierto. También puedes usar la **Command Palette** (`Cmd+Shift+P` / `Ctrl+Shift+P`) y escribir "Claude Code".

934 996

935<h3 id="cmd-esc-does-nothing-on-macos">997<h3 id="cmd-esc-does-nothing-on-macos">

936 Cmd+Esc no hace nada en macOS998 Cmd+Esc no hace nada en macOS

937</h3>999</h3>

938 1000

939En macOS Tahoe y posterior, el atajo del sistema Game Overlay está vinculado a `Cmd+Esc` de forma predeterminada e intercepta la pulsación de tecla antes de que llegue a VS Code. Para liberar el atajo:1001En macOS Tahoe y versiones posteriores, el atajo de teclado del sistema Game Overlay está asignado a `Cmd+Esc` de forma predeterminada e intercepta la pulsación antes de que llegue a VS Code. Para liberar el atajo:

940 1002

9411. Abra Configuración del sistema10031. Abre System Settings

9422. Vaya a Teclado, luego Atajos de teclado, luego Controladores de juegos10042. Ve a Keyboard, luego a Keyboard Shortcuts y luego a Game Controllers

9433. Desmarque la casilla Game Overlay10053. Desmarca la casilla Game Overlay

944 1006

945Alternativamente, revinculle la extensión a una tecla diferente: abra el editor de [Atajos de teclado](https://code.visualstudio.com/docs/configure/keybindings) de VS Code (`Cmd+K Cmd+S`), busque `Claude Code: Focus input`, y asigne un nuevo atajo.1007Como alternativa, asigna la extensión a otra tecla: abre el [editor de atajos de teclado](https://code.visualstudio.com/docs/configure/keybindings) de VS Code (`Cmd+K Cmd+S`), busca `Claude Code: Focus input` y asigna un nuevo atajo de teclado.

946 1008

947<h3 id="a-resumed-conversation-is-blank-at-first">1009<h3 id="a-resumed-conversation-is-blank-at-first">

948 Una conversación reanudada aparece en blanco al principio1010 Una conversación reanudada aparece en blanco al principio

949</h3>1011</h3>

950 1012

951Cuando [reanudas una conversación anterior](#resume-past-conversations) o una [vuelve después de una recarga](#continue-conversations-after-a-reload), sus mensajes pueden permanecer en blanco mientras se inicia el proceso de Claude Code de la conversación. Después de aproximadamente un segundo, aparece `Waiting for your plugins…` en el espacio vacío.1013Cuando [reanudas una conversación anterior](#resume-past-conversations) o una [vuelve a abrirse después de una recarga](#continue-conversations-after-a-reload), sus mensajes pueden permanecer en blanco mientras se inicia el proceso de Claude Code de la conversación. Después de aproximadamente un segundo, aparece `Waiting for your plugins…` en el espacio vacío.

952 1014

953No necesitas hacer nada. Los mensajes aparecen una vez que el proceso se ha iniciado y ha confirmado que ningún plugin necesita revisarlos primero, o después de 20 segundos si el inicio tarda más.1015No necesitas hacer nada. Los mensajes aparecen una vez que el proceso se ha iniciado y ha confirmado que ningún plugin necesita revisarlos primero, o después de 20 segundos si el inicio tarda más.

954 1016

956 El panel deja de responder cada vez que una recarga vuelve a abrir una conversación1018 El panel deja de responder cada vez que una recarga vuelve a abrir una conversación

957</h3>1019</h3>

958 1020

959Si todo el panel falla, se congela o solo muestra `Something went wrong` cada vez que recargas y tu conversación vuelve, actualiza la extensión a la v2.1.301 o posterior. Luego recarga la ventana o reinicia VS Code de nuevo. Después de que la conversación no termine de abrirse dos veces seguidas, obtienes un chat nuevo en su lugar, con un aviso de que [no se volvió a abrir](#a-conversation-was-not-reopened).1021Si todo el panel se bloquea, se congela o muestra solo `Something went wrong` cada vez que recargas y tu conversación vuelve a abrirse, actualiza la extensión a la v2.1.301 o posterior. Luego vuelve a recargar la ventana o a reiniciar VS Code. Después de que la conversación no termine de abrirse dos veces seguidas, obtienes un chat nuevo en su lugar, con un aviso de que [no se volvió a abrir](#a-conversation-was-not-reopened).

960 1022

961<h3 id="a-formula-shows-as-raw-latex">1023<h3 id="a-formula-shows-as-raw-latex">

962 Una fórmula se muestra como LaTeX sin procesar1024 Una fórmula se muestra como LaTeX sin procesar

963</h3>1025</h3>

964 1026

965Si nada de las matemáticas en las respuestas de Claude se compone tipográficamente, verifica la versión de la extensión en la vista Extensiones, porque la [representación de matemáticas](#latex-math-in-responses) requiere la versión 2.1.301 o posterior. Si usas el [modo terminal](#switch-to-terminal-mode), que no compone matemáticas sin importar la versión, desmarca el [ajuste Use Terminal](vscode://settings/claudeCode.useTerminal) para que Claude Code se abra en el panel de chat.1027Si ninguna de las expresiones matemáticas de las respuestas de Claude se muestra con formato tipográfico, verifica la versión de la extensión en la vista Extensions, porque [la representación de matemáticas](#latex-math-in-responses) requiere la versión 2.1.301 o posterior. Si usas el [modo terminal](#switch-to-terminal-mode), que no da formato tipográfico a las matemáticas sea cual sea la versión, desmarca el [ajuste Use Terminal](vscode://settings/claudeCode.useTerminal) para que Claude Code se abra en el panel de chat.

966 1028

967Si una fórmula se muestra tal como está escrita mientras que otras cercanas sí se componen, revisa si se debe a alguna de estas causas:1029Si una fórmula se muestra tal como está escrita mientras que otras cercanas sí tienen formato tipográfico, revisa si se debe a alguna de estas causas:

968 1030

969* **Se lee como algo distinto de matemáticas**: el texto `$…$` que se lee como una palabra se queda tal como está escrito, como `$O(n log n)$`. El texto `$…$` que empieza con un dígito, como `$30$` o `$1/N$`, también se queda tal como está escrito, a menos que un carácter como `=`, `+` o `^` lo marque como matemáticas. En su lugar, pídele a Claude un bloque `$$` en sus propias líneas, que el panel compone sin esta comprobación.1031* **Se interpreta como algo distinto de matemáticas**: el texto `$…$` que se lee como una palabra se mantiene tal como está escrito, por ejemplo `$O(n log n)$`. El texto `$…$` que empieza con un dígito, como `$30$` o `$1/N$`, también se mantiene tal como está escrito, a menos que un carácter como `=`, `+` o `^` lo marque como matemáticas. Pídele a Claude un bloque `$$` en sus propias líneas, que el panel formatea sin esta comprobación.

970* **Tiene espacios de relleno, es largo o está dividido en varias líneas**: `$ x^2 $` con espacios dentro de los signos de dólar, el contenido `$…$` de más de 60 caracteres y `$…$` o `$…$` divididos en dos líneas no se componen. En su lugar, pídele a Claude un bloque `$$` en sus propias líneas, que no tiene ninguno de estos límites.1032* **Tiene espacios de relleno, es largo o está dividido en varias líneas**: `$ x^2 $` con espacios dentro de los signos de dólar, el contenido `$…$` de más de 60 caracteres y `$…$` o `$…$` divididos en dos líneas no reciben formato tipográfico. Pídele a Claude un bloque `$$` en sus propias líneas, que no tiene ninguno de estos límites.

971* **El TeX no se puede componer**: una fórmula con un error de sintaxis, una definición de macro como `\newcommand` o `\def`, o un `%` sin escapar se muestra tal como está escrita. Pídele a Claude que la reescriba con el error corregido, sin la macro o con `\%` para el signo de porcentaje.1033* **El TeX no se puede formatear**: una fórmula con un error de sintaxis, una definición de macro como `\newcommand` o `\def`, o un `%` sin escapar se muestra tal como está escrita. Pídele a Claude que la reescriba con el error corregido, sin la macro o con `\%` para el signo de porcentaje.

972* **Es demasiado grande**: una fórmula de más de 8,192 caracteres, o una que se dibujaría mucho más grande que su código fuente, se muestra tal como está escrita. Pídele a Claude que la divida en fórmulas más pequeñas o que la escriba de forma más compacta.1034* **Es demasiado grande**: una fórmula de más de 8,192 caracteres, o una que se dibujaría mucho más grande que su código fuente, se muestra tal como está escrita. Pídele a Claude que la divida en fórmulas más pequeñas o que la escriba de forma más compacta.

973* **Sigue a una gran cantidad de matemáticas**: dentro de un bloque de texto de una respuesta, el panel compone las fórmulas en orden hasta un límite. Una fórmula posterior que superaría el límite se muestra tal como está escrita. Pídele a Claude que vuelva a enviar por separado la fórmula que necesitas.1035* **Viene después de una gran cantidad de matemáticas**: dentro de un mismo bloque de texto de una respuesta, el panel formatea las fórmulas en orden hasta un límite. Una fórmula posterior que superaría el límite se muestra tal como está escrita. Pídele a Claude que vuelva a enviar la fórmula que necesitas por sí sola.

974 1036

975<h3 id="claude-code-never-responds">1037<h3 id="claude-code-never-responds">

976 Claude Code nunca responde1038 Claude Code nunca responde

977</h3>1039</h3>

978 1040

979Si Claude Code no responde a sus indicaciones:1041Si Claude Code no responde a tus prompts:

980 1042

9811. **Verifique su conexión a Internet**: Asegúrese de tener una conexión a Internet estable10431. **Verifica tu conexión a internet**: asegúrate de tener una conexión a internet estable

9822. **Inicie una nueva conversación**: Intente iniciar una conversación nueva para ver si el problema persiste10442. **Inicia una nueva conversación**: intenta iniciar una conversación nueva para ver si el problema persiste

9833. **Pruebe la CLI**: Ejecute `claude` desde la terminal para ver si obtiene mensajes de error más detallados10453. **Prueba la CLI**: ejecuta `claude` desde la terminal para ver si obtienes mensajes de error más detallados

984 1046

985Si los problemas persisten, [presente un problema en GitHub](https://github.com/anthropics/claude-code/issues) con detalles sobre el error.1047Si los problemas persisten, [crea un issue en GitHub](https://github.com/anthropics/claude-code/issues) con detalles sobre el error.

986 1048

987<h2 id="uninstall-the-extension">1049<h2 id="uninstall-the-extension">

988 Desinstalar la extensión1050 Desinstalar la extensión

989</h2>1051</h2>

990 1052

991Para desinstalar la extensión Claude Code:1053Para desinstalar la extensión de Claude Code:

992 1054

9931. Abra la vista Extensiones (`Cmd+Shift+X` en Mac o `Ctrl+Shift+X` en Windows/Linux)10551. Presiona `Cmd+Shift+X` en Mac o `Ctrl+Shift+X` en Windows/Linux para abrir la vista de Extensiones

9942. Busque "Claude Code"10562. Busca "Claude Code"

9953. Haga clic en **Desinstalar**10573. Haz clic en **Uninstall**

996 1058

997Si ejecuta `claude` en una terminal integrada de VS Code, Claude Code reinstala la extensión automáticamente. Para mantenerla desinstalada, desactive **Auto-install IDE extension** en `/config`, o establezca [`autoInstallIdeExtension`](/docs/es/settings-reference#autoinstallideextension) en `false`. También puede establecer la variable de entorno [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/es/env-vars) en `1`.1059Si ejecutas `claude` en una terminal integrada de VS Code, Claude Code reinstala la extensión automáticamente. Para mantenerla desinstalada, desactiva **Auto-install IDE extension** en `/config`, o establece [`autoInstallIdeExtension`](/docs/es/settings-reference#autoinstallideextension) en `false`. También puedes establecer la variable de entorno [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/docs/es/env-vars) en `1`.

998 1060

999Para eliminar también los datos de la extensión y restablecer toda la configuración, elimine el directorio de almacenamiento de la extensión para su plataforma.1061Para eliminar también los datos de la extensión y restablecer toda la configuración, elimina el directorio de almacenamiento de la extensión correspondiente a tu plataforma.

1000 1062

1001En macOS:1063En macOS:

1002 1064

1016Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"1078Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

1017```1079```

1018 1080

1019Para obtener ayuda adicional, consulte la [guía de solución de problemas](/docs/es/troubleshooting).1081Para obtener ayuda adicional, consulta la [guía de solución de problemas](/docs/es/troubleshooting).

1020 1082

1021<h2 id="next-steps">1083<h2 id="next-steps">

1022 Próximos pasos1084 Próximos pasos

1025Ahora que tienes Claude Code configurado en VS Code:1087Ahora que tienes Claude Code configurado en VS Code:

1026 1088

1027* [Explora flujos de trabajo comunes](/docs/es/common-workflows) para aprovechar al máximo Claude Code1089* [Explora flujos de trabajo comunes](/docs/es/common-workflows) para aprovechar al máximo Claude Code

1028* [Configura MCP servers](/docs/es/mcp) para extender las capacidades de Claude con herramientas externas. Agrega y administra servidores con `/mcp` en el panel de chat.1090* [Configura servidores MCP](/docs/es/mcp) para ampliar las capacidades de Claude con herramientas externas. Agrégalos y adminístralos con `/mcp` en el panel de chat.

1029* [Configura la configuración de Claude Code](/docs/es/settings) para personalizar comandos permitidos, hooks y más. Esta configuración se comparte entre la extensión y la CLI.1091* [Configura los ajustes de Claude Code](/docs/es/settings) para personalizar los comandos permitidos, los hooks y más. Esta configuración se comparte entre la extensión y la CLI.

1092* [Revisa las medidas de seguridad](/docs/es/security) y el [uso de datos](/docs/es/data-usage) de Claude Code

zero-data-retention.md +1 −0

Details

68| Característica | Razón |68| Característica | Razón |

69| - | - |69| - | - |

70| [Cloud sessions](/docs/es/claude-code-on-the-web), incluidas las iniciadas desde la [aplicación Desktop](/docs/es/desktop#cloud-sessions) | Requiere almacenamiento del lado del servidor de datos de sesión, incluido el historial de conversaciones con prompts y completaciones. |70| [Cloud sessions](/docs/es/claude-code-on-the-web), incluidas las iniciadas desde la [aplicación Desktop](/docs/es/desktop#cloud-sessions) | Requiere almacenamiento del lado del servidor de datos de sesión, incluido el historial de conversaciones con prompts y completaciones. |

71| [Chat y Cowork unificados](https://support.claude.com/en/articles/17444462-set-up-and-manage-the-new-unified-claude-experience-for-your-enterprise-organization) | Requiere sesiones en la nube. |

71| [Claude Tag](https://claude.com/docs/claude-tag) | Retiene la memoria del canal y las transcripciones de sesión. |72| [Claude Tag](https://claude.com/docs/claude-tag) | Retiene la memoria del canal y las transcripciones de sesión. |

72| [Artefactos](/docs/es/artifacts) | Requiere almacenar contenido de página publicado en infraestructura operada por Anthropic. |73| [Artefactos](/docs/es/artifacts) | Requiere almacenar contenido de página publicado en infraestructura operada por Anthropic. |

73| Envío de comentarios (`/feedback`, `/bug`, `/share`) | Enviar comentarios envía datos de conversación a Anthropic. |74| Envío de comentarios (`/feedback`, `/bug`, `/share`) | Enviar comentarios envía datos de conversación a Anthropic. |

Documentation 2026-10-15 23:58 UTC to 2026-10-16 22:59 UTC