Documentation — Spybara

agent-sdk/agent-loop.md +7 −7

Details

111El SDK incluye las mismas herramientas que potencian Claude Code:111El SDK incluye las mismas herramientas que potencian Claude Code:

112 112

114| :------------------------- | :----------------------------------------------- | :------------------------------------------------------------------------------------- |114| :------------------------- | :-------------------------------------------------------------- | :------------------------------------------------------------------------------------- |

118| **Web** | `WebSearch`, `WebFetch` | Buscar en la web, obtener y analizar páginas |118| **Web** | `WebSearch`, `WebFetch` | Buscar en la web, obtener y analizar páginas |

121 121

122Más allá de las herramientas integradas, puede:122Más allá de las herramientas integradas, puede:

123 123

197 197

198## La ventana de contexto198## La ventana de contexto

199 199

200La ventana de contexto es la cantidad total de información disponible para Claude durante una sesión. No se reinicia entre turnos dentro de una sesión. Todo se acumula: el prompt del sistema, definiciones de herramientas, historial de conversación, entradas de herramientas y salidas de herramientas. El contenido que permanece igual en todos los turnos (prompt del sistema, definiciones de herramientas, CLAUDE.md) se [almacena automáticamente en caché de prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), lo que reduce el costo y la latencia para prefijos repetidos.200La ventana de contexto es la cantidad total de información disponible para Claude durante una sesión. No se reinicia entre turnos dentro de una sesión. Todo se acumula: el prompt del sistema, definiciones de herramientas, historial de conversación, entradas de herramientas y salidas de herramientas. El contenido que permanece igual en todos los turnos (prompt del sistema, definiciones de herramientas, CLAUDE.md) se [almacena automáticamente en caché de prompt](https://platform.claude.com/docs/es/build-with-claude/prompt-caching), lo que reduce el costo y la latencia para prefijos repetidos.

201 201

202### Qué consume contexto202### Qué consume contexto

203 203

204Aquí está cómo cada componente afecta el contexto en el SDK:204Aquí está cómo cada componente afecta el contexto en el SDK:

205 205

207| :------------------------------- | :----------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |207| :------------------------------- | :----------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

210| **Definiciones de herramientas** | Cada solicitud | Cada herramienta agrega su esquema; use [búsqueda de herramientas MCP](/es/agent-sdk/mcp#mcp-tool-search) para cargar herramientas bajo demanda en lugar de todas a la vez |210| **Definiciones de herramientas** | Cada solicitud; esquemas MCP diferidos por defecto | Los esquemas de herramientas integradas se cargan en cada solicitud. [Búsqueda de herramientas](/es/agent-sdk/mcp#mcp-tool-search) difiere esquemas de herramientas MCP por defecto, retrocediendo a carga anticipada en Vertex AI o una `ANTHROPIC_BASE_URL` que no sea de primera parte. Vea [Configurar búsqueda de herramientas](/es/agent-sdk/tool-search#configure-tool-search) para la matriz completa |

213 213

244Algunas estrategias para agentes de larga duración:244Algunas estrategias para agentes de larga duración:

245 245

246* **Use subagentes para subtareas.** Cada subagente comienza con una conversación nueva (sin historial de mensajes anterior, aunque carga su propio prompt del sistema y contexto a nivel de proyecto como CLAUDE.md). No ve los turnos del padre, y solo su respuesta final regresa al padre como resultado de herramienta. El contexto del agente principal crece por ese resumen, no por la transcripción completa de subtarea. Vea [Qué heredan los subagentes](/es/agent-sdk/subagents#what-subagents-inherit) para detalles.246* **Use subagentes para subtareas.** Cada subagente comienza con una conversación nueva (sin historial de mensajes anterior, aunque carga su propio prompt del sistema y contexto a nivel de proyecto como CLAUDE.md). No ve los turnos del padre, y solo su respuesta final regresa al padre como resultado de herramienta. El contexto del agente principal crece por ese resumen, no por la transcripción completa de subtarea. Vea [Qué heredan los subagentes](/es/agent-sdk/subagents#what-subagents-inherit) para detalles.

247* **Sea selectivo con herramientas.** Cada definición de herramienta toma espacio de contexto. Use el campo `tools` en [`AgentDefinition`](/es/agent-sdk/subagents#agentdefinition-configuration) para limitar subagentes al conjunto mínimo que necesitan, y use [búsqueda de herramientas MCP](/es/agent-sdk/mcp#mcp-tool-search) para cargar herramientas bajo demanda en lugar de precargarlas todas.247* **Sea selectivo con herramientas.** Cada definición de herramienta toma espacio de contexto. Use el campo `tools` en [`AgentDefinition`](/es/agent-sdk/subagents#agentdefinition-configuration) para limitar subagentes al conjunto mínimo que necesitan.

248* **Observe costos de servidor MCP.** Cada servidor MCP agrega todos sus esquemas de herramientas a cada solicitud. Algunos servidores con muchas herramientas pueden consumir contexto significativo antes de que el agente haga ningún trabajo. La herramienta `ToolSearch` puede ayudar cargando herramientas bajo demanda en lugar de precargarlas todas. Vea [búsqueda de herramientas MCP](/es/agent-sdk/mcp#mcp-tool-search) para configuración.248* **Observe costos de servidor MCP.** [Búsqueda de herramientas MCP](/es/agent-sdk/mcp#mcp-tool-search) difiere esquemas de herramientas MCP por defecto y los carga bajo demanda. Cuando la búsqueda de herramientas está desactivada, en Vertex AI, o detrás de una `ANTHROPIC_BASE_URL` que no sea de primera parte, cada servidor MCP agrega todos sus esquemas de herramientas a cada solicitud, así que algunos servidores con muchas herramientas pueden consumir contexto significativo antes de que el agente haga ningún trabajo.

249* **Use esfuerzo más bajo para tareas rutinarias.** Establezca [esfuerzo](#effort-level) a `"low"` para agentes que solo necesitan leer archivos o listar directorios. Esto reduce el uso de tokens y el costo.249* **Use esfuerzo más bajo para tareas rutinarias.** Establezca [esfuerzo](#effort-level) a `"low"` para agentes que solo necesitan leer archivos o listar directorios. Esto reduce el uso de tokens y el costo.

250 250

251Para un desglose detallado de costos de contexto por característica, vea [Entender costos de contexto](/es/features-overview#understand-context-costs).251Para un desglose detallado de costos de contexto por característica, vea [Entender costos de contexto](/es/features-overview#understand-context-costs).

agent-sdk/python.md +36 −15

Details

19### Comparación rápida19### Comparación rápida

20 20

~~22| :------------------------------ | :----------------------------- | :------------------------------------------ |~~22| :------------------------------ | :------------------------------------------------- | :------------------------------------------ |

32 32

~~33### Cuándo usar `query()` (nueva sesión cada vez)~~33### Cuándo usar `query()` (tareas puntuales)

34 34

35**Mejor para:**35**Mejor para:**

36 36

53 53

54### `query()`54### `query()`

55 55

56Crea una nueva sesión para cada interacción con Claude Code. Devuelve un iterador asincrónico que produce mensajes a medida que llegan. Cada llamada a `query()` comienza de nuevo sin memoria de interacciones anteriores.56Crea una nueva sesión para cada interacción con Claude Code de forma predeterminada. Devuelve un iterador asincrónico que produce mensajes a medida que llegan. Cada llamada a `query()` comienza de nuevo sin memoria de interacciones anteriores a menos que pase `continue_conversation=True` o `resume` en [`ClaudeAgentOptions`](#claudeagentoptions). Consulte [Sessions](/es/agent-sdk/sessions).

57 57

58```python theme={null}58```python theme={null}

59async def query(59async def query(

790 plugins: list[SdkPluginConfig] = field(default_factory=list)790 plugins: list[SdkPluginConfig] = field(default_factory=list)

791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead

792 thinking: ThinkingConfig | None = None792 thinking: ThinkingConfig | None = None

793 effort: Literal["low", "medium", "high", "xhigh", "max"] | None = None793 effort: EffortLevel | None = None

794 enable_file_checkpointing: bool = False794 enable_file_checkpointing: bool = False

795 session_store: SessionStore | None = None795 session_store: SessionStore | None = None

796 session_store_flush: SessionStoreFlushMode = "batched"796 session_store_flush: SessionStoreFlushMode = "batched"

837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponibles para la sesión. Pase `"all"` para habilitar cada skill descubierto, o una lista de nombres de skills. Cuando se establece, el SDK habilita la herramienta Skill automáticamente sin listarla en `allowed_tools`. Ver [Skills](/es/agent-sdk/skills) |837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponibles para la sesión. Pase `"all"` para habilitar cada skill descubierto, o una lista de nombres de skills. Cuando se establece, el SDK habilita la herramienta Skill automáticamente sin listarla en `allowed_tools`. Ver [Skills](/es/agent-sdk/skills) |

841| `session_store` | [`SessionStore`](/es/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Reflejar transcripciones de sesión a un backend externo para que cualquier host pueda reanudarlas. Ver [Persist sessions to external storage](/es/agent-sdk/session-storage) |841| `session_store` | [`SessionStore`](/es/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Reflejar transcripciones de sesión a un backend externo para que cualquier host pueda reanudarlas. Ver [Persist sessions to external storage](/es/agent-sdk/session-storage) |

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Cuándo vaciar entradas de transcripción reflejadas a `session_store`. `"batched"` vacía una vez por turno o cuando el búfer se llena; `"eager"` activa un vaciado de fondo después de cada fotograma. Se ignora cuando `session_store` es `None` |842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Cuándo vaciar entradas de transcripción reflejadas a `session_store`. `"batched"` vacía una vez por turno o cuando el búfer se llena; `"eager"` activa un vaciado de fondo después de cada fotograma. Se ignora cuando `session_store` es `None` |

843 843

1039 initialPrompt: str | None = None1039 initialPrompt: str | None = None

1040 maxTurns: int | None = None1040 maxTurns: int | None = None

1041 background: bool | None = None1041 background: bool | None = None

1042 effort: Literal["low", "medium", "high", "xhigh", "max"] | int | None = None1042 effort: EffortLevel | int | None = None

1043 permissionMode: PermissionMode | None = None1043 permissionMode: PermissionMode | None = None

1044```1044```

1045 1045

1050| `tools` | No | Matriz de nombres de herramientas permitidas. Si se omite, hereda todas las herramientas |1050| `tools` | No | Matriz de nombres de herramientas permitidas. Si se omite, hereda todas las herramientas |

1051| `disallowedTools` | No | Matriz de nombres de herramientas a eliminar del conjunto de herramientas del agente |1051| `disallowedTools` | No | Matriz de nombres de herramientas a eliminar del conjunto de herramientas del agente |

1052| `model` | No | Anulación de modelo para este agente. Acepta un alias como `"sonnet"`, `"opus"`, `"haiku"`, o `"inherit"`, o un ID de modelo completo. Si se omite, usa el modelo principal |1052| `model` | No | Anulación de modelo para este agente. Acepta un alias como `"sonnet"`, `"opus"`, `"haiku"`, o `"inherit"`, o un ID de modelo completo. Si se omite, usa el modelo principal |

1053| `skills` | No | Lista de nombres de skills disponibles para este agente |1053| `skills` | No | Lista de nombres de skills para precargar en el contexto del agente al inicio. Los skills no listados siguen siendo invocables a través de la herramienta Skill |

1054| `memory` | No | Fuente de memoria para este agente: `"user"`, `"project"`, o `"local"` |1054| `memory` | No | Fuente de memoria para este agente: `"user"`, `"project"`, o `"local"` |

1055| `mcpServers` | No | Servidores MCP disponibles para este agente. Cada entrada es un nombre de servidor o un dict `{name: config}` en línea |1055| `mcpServers` | No | Servidores MCP disponibles para este agente. Cada entrada es un nombre de servidor o un dict `{name: config}` en línea |

1056| `initialPrompt` | No | Auto-enviado como el primer turno de usuario cuando este agente se ejecuta como el agente del hilo principal |1056| `initialPrompt` | No | Auto-enviado como el primer turno de usuario cuando este agente se ejecuta como el agente del hilo principal |

1057| `maxTurns` | No | Número máximo de turnos agentes antes de que el agente se detenga |1057| `maxTurns` | No | Número máximo de turnos agentes antes de que el agente se detenga |

1058| `background` | No | Ejecutar este agente como una tarea de fondo no bloqueante cuando se invoca |1058| `background` | No | Ejecutar este agente como una tarea de fondo no bloqueante cuando se invoca |

1059| `effort` | No | Nivel de esfuerzo de razonamiento para este agente. Acepta un nivel nombrado o un entero |1059| `effort` | No | Nivel de esfuerzo de razonamiento para este agente. Acepta un nivel nombrado o un entero. Ver [`EffortLevel`](#effortlevel) |

1060| `permissionMode` | No | Modo de permiso para la ejecución de herramientas dentro de este agente. Ver [`PermissionMode`](#permissionmode) |1060| `permissionMode` | No | Modo de permiso para la ejecución de herramientas dentro de este agente. Ver [`PermissionMode`](#permissionmode) |

1061 1061

1062<Note>1062<Note>

1077]1077]

1078```1078```

1079 1079

1080### `EffortLevel`

1081

1082Niveles de esfuerzo para guiar la profundidad del pensamiento.

1083

1084```python theme={null}

1085EffortLevel = Literal[

1086 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking

1088 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)

1090 "max", # Maximum effort

1091]

1092```

1093

1080### `CanUseTool`1094### `CanUseTool`

1081 1095

1082Alias de tipo para funciones de devolución de llamada de permiso de herramienta.1096Alias de tipo para funciones de devolución de llamada de permiso de herramienta.

1224Controla el comportamiento de pensamiento extendido. Una unión de tres configuraciones:1238Controla el comportamiento de pensamiento extendido. Una unión de tres configuraciones:

1225 1239

1226```python theme={null}1240```python theme={null}

1241ThinkingDisplay = Literal["summarized", "omitted"]

1242

1243

1227class ThinkingConfigAdaptive(TypedDict):1244class ThinkingConfigAdaptive(TypedDict):

1228 type: Literal["adaptive"]1245 type: Literal["adaptive"]

1246 display: NotRequired[ThinkingDisplay]

1229 1247

1230 1248

1231class ThinkingConfigEnabled(TypedDict):1249class ThinkingConfigEnabled(TypedDict):

1232 type: Literal["enabled"]1250 type: Literal["enabled"]

1233 budget_tokens: int1251 budget_tokens: int

1252 display: NotRequired[ThinkingDisplay]

1234 1253

1235 1254

1236class ThinkingConfigDisabled(TypedDict):1255class ThinkingConfigDisabled(TypedDict):

1241```1260```

1242 1261

1244| :--------- | :---------------------- | :----------------------------------------------------------- |1263| :--------- | :--------------------------------- | :----------------------------------------------------------- |

1248 1267

1268El campo opcional `display` controla si el texto de pensamiento se devuelve `"summarized"` u `"omitted"`. En Claude Opus 4.7 y posteriores, el valor predeterminado de la API es `"omitted"`, por lo que establezca `"summarized"` para recibir contenido de pensamiento en salidas [`ThinkingBlock`](#thinkingblock).

1269

1249Porque estas son clases `TypedDict`, son dicts simples en tiempo de ejecución. Construya cualquiera como literales de dict o llame a la clase como un constructor; ambos producen un `dict`. Acceda a campos con `config["budget_tokens"]`, no `config.budget_tokens`:1270Porque estas son clases `TypedDict`, son dicts simples en tiempo de ejecución. Construya cualquiera como literales de dict o llame a la clase como un constructor; ambos producen un `dict`. Acceda a campos con `config["budget_tokens"]`, no `config.budget_tokens`:

1250 1271

1251```python theme={null}1272```python theme={null}

2177 hookEventName: Literal["PostToolUse"]2198 hookEventName: Literal["PostToolUse"]

2178 additionalContext: NotRequired[str]2199 additionalContext: NotRequired[str]

2179 updatedToolOutput: NotRequired[Any]2200 updatedToolOutput: NotRequired[Any]

2180 updatedMCPToolOutput: NotRequired[Any]2201 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools

2181 2202

2182 2203

2183class PostToolUseFailureHookSpecificOutput(TypedDict):2204class PostToolUseFailureHookSpecificOutput(TypedDict):

2646**Nombre de herramienta:** `TodoWrite`2667**Nombre de herramienta:** `TodoWrite`

2647 2668

2648<Note>2669<Note>

2649 `TodoWrite` está deprecado y será eliminado en una versión futura. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, y `TaskList` en su lugar. Establezca `CLAUDE_CODE_ENABLE_TASKS=1` para optar por participar. Ver [Migrar a herramientas Task](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para cómo monitorear cambios de código.2670 A partir de Claude Code v2.1.142, `TodoWrite` está deshabilitado de forma predeterminada. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, y `TaskList` en su lugar. Ver [Migrar a herramientas Task](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para actualizar su código de monitoreo, o establezca `CLAUDE_CODE_ENABLE_TASKS=0` para revertir a `TodoWrite`.

2650</Note>2671</Note>

2651 2672

2652**Entrada:**2673**Entrada:**

agent-sdk/sessions.md +3 −3

Details

46 46

47### Python: `ClaudeSDKClient`47### Python: `ClaudeSDKClient`

48 48

49[`ClaudeSDKClient`](/es/agent-sdk/python#claudesdkclient) maneja IDs de sesión internamente. Cada llamada a `client.query()` continúa automáticamente la misma sesión. Llame a [`client.receive_response()`](/es/agent-sdk/python#claudesdkclient) para iterar sobre los mensajes de la consulta actual. El cliente debe usarse como un gestor de contexto asincrónico.49[`ClaudeSDKClient`](/es/agent-sdk/python#claudesdkclient) maneja IDs de sesión internamente. Cada llamada a `client.query()` continúa automáticamente la misma sesión. Llame a [`client.receive_response()`](/es/agent-sdk/python#claudesdkclient) para iterar sobre los mensajes de la consulta actual. El cliente se usa típicamente como un gestor de contexto asincrónico.

50 50

51Este ejemplo ejecuta dos consultas contra el mismo `client`. La primera le pide al agente que analice un módulo; la segunda le pide que refactorice ese módulo. Debido a que ambas llamadas van a través de la misma instancia de cliente, la segunda consulta tiene contexto completo de la primera sin ningún `resume` explícito o ID de sesión:51Este ejemplo ejecuta dos consultas contra el mismo `client`. La primera le pide al agente que analice un módulo; la segunda le pide que refactorice ese módulo. Debido a que ambas llamadas van a través de la misma instancia de cliente, la segunda consulta tiene contexto completo de la primera sin ningún `resume` explícito o ID de sesión:

52 52

100 100

101### TypeScript: `continue: true`101### TypeScript: `continue: true`

102 102

103El SDK de TypeScript estable (la función `query()` utilizada en toda esta documentación, a veces llamada V1) no tiene un objeto cliente que mantenga sesión como el `ClaudeSDKClient` de Python. En su lugar, pase `continue: true` en cada llamada `query()` posterior y el SDK retoma la sesión más reciente en el directorio actual. No se requiere seguimiento de ID.103El SDK de TypeScript no tiene un objeto cliente que mantenga sesión como el `ClaudeSDKClient` de Python. En su lugar, pase `continue: true` en cada llamada `query()` posterior y el SDK retoma la sesión más reciente en el directorio actual. No se requiere seguimiento de ID.

104 104

105Este ejemplo hace dos llamadas `query()` separadas. La primera crea una sesión nueva; la segunda establece `continue: true`, que le dice al SDK que encuentre y reanude la sesión más reciente en disco. El agente tiene contexto completo de la primera llamada:105Este ejemplo hace dos llamadas `query()` separadas. La primera crea una sesión nueva; la segunda establece `continue: true`, que le dice al SDK que encuentre y reanude la sesión más reciente en disco. El agente tiene contexto completo de la primera llamada:

106 106

132```132```

133 133

134<Note>134<Note>

135 La [API de sesión V2](/es/agent-sdk/typescript-v2-preview) experimental, que proporcionaba `createSession()` con un patrón `send` / `stream`, está deprecada. Use la función V1 `query()` y las opciones de sesión descritas en esta página en su lugar.135 La [API de sesión V2](/es/agent-sdk/typescript-v2-preview) experimental, que proporcionaba `createSession()` con un patrón `send` / `stream`, fue eliminada en TypeScript Agent SDK 0.3.142. Use la función `query()` y las opciones de sesión descritas en esta página en su lugar.

136</Note>136</Note>

137 137

138## Usar opciones de sesión con `query()`138## Usar opciones de sesión con `query()`

agent-sdk/todo-tracking.md +69 −4

Details

8 8

9El seguimiento de tareas proporciona una forma estructurada de gestionar tareas y mostrar el progreso a los usuarios. El SDK del Agente Claude incluye funcionalidad de tareas integrada que ayuda a organizar flujos de trabajo complejos y mantener a los usuarios informados sobre la progresión de las tareas.9El seguimiento de tareas proporciona una forma estructurada de gestionar tareas y mostrar el progreso a los usuarios. El SDK del Agente Claude incluye funcionalidad de tareas integrada que ayuda a organizar flujos de trabajo complejos y mantener a los usuarios informados sobre la progresión de las tareas.

10 10

11<Note>

12 A partir del TypeScript Agent SDK 0.3.142 y Claude Code v2.1.142, las sesiones utilizan las herramientas Task estructuradas `TaskCreate`, `TaskUpdate`, `TaskGet` y `TaskList` en lugar de `TodoWrite`. Consulte [Migrar a herramientas Task](#migrate-to-task-tools) para ver cómo cambia el código de monitoreo. Los ejemplos en esta página establecen `CLAUDE_CODE_ENABLE_TASKS=0` para seguir mostrando `TodoWrite` para sesiones que aún no han migrado.

13</Note>

11### Ciclo de Vida de las Tareas15### Ciclo de Vida de las Tareas

12 16

13Las tareas siguen un ciclo de vida predecible:17Las tareas siguen un ciclo de vida predecible:

36 40

37 for await (const message of query({41 for await (const message of query({

38 prompt: "Optimize my React app performance and track progress with todos",42 prompt: "Optimize my React app performance and track progress with todos",

~~39 options: { maxTurns: 15 }~~43 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

44 // Task tools instead and these tool_use blocks never appear.

45 options: { maxTurns: 15, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

40 })) {46 })) {

41 // Todo updates are reflected in the message stream47 // Todo updates are reflected in the message stream

42 if (message.type === "assistant") {48 if (message.type === "assistant") {

61 67

62 async for message in query(68 async for message in query(

63 prompt="Optimize my React app performance and track progress with todos",69 prompt="Optimize my React app performance and track progress with todos",

~~64 options=ClaudeAgentOptions(max_turns=15),~~70 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

71 # Task tools instead and these tool_use blocks never appear.

72 options=ClaudeAgentOptions(max_turns=15, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

65 ):73 ):

66 # Todo updates are reflected in the message stream74 # Todo updates are reflected in the message stream

67 if isinstance(message, AssistantMessage):75 if isinstance(message, AssistantMessage):

112 async trackQuery(prompt: string) {120 async trackQuery(prompt: string) {

113 for await (const message of query({121 for await (const message of query({

114 prompt,122 prompt,

115 options: { maxTurns: 20 }123 // Re-enable TodoWrite, which this tracker watches for.

124 options: { maxTurns: 20, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

116 })) {125 })) {

117 if (message.type === "assistant") {126 if (message.type === "assistant") {

118 for (const block of message.message.content) {127 for (const block of message.message.content) {

167 print(f"{i + 1}. {icon} {text}")176 print(f"{i + 1}. {icon} {text}")

168 177

169 async def track_query(self, prompt: str):178 async def track_query(self, prompt: str):

170 async for message in query(prompt=prompt, options=ClaudeAgentOptions(max_turns=20)):179 async for message in query(

180 prompt=prompt,

181 # Re-enable TodoWrite, which this tracker watches for.

182 options=ClaudeAgentOptions(max_turns=20, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

183 ):

171 if isinstance(message, AssistantMessage):184 if isinstance(message, AssistantMessage):

172 for block in message.content:185 for block in message.content:

173 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":186 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":

181 ```194 ```

182</CodeGroup>195</CodeGroup>

183 196

197## Migrar a herramientas Task

198

199Las herramientas Task dividen la única llamada `TodoWrite` en `TaskCreate` para cada elemento nuevo y `TaskUpdate` para cada cambio de estado, con `TaskList` y `TaskGet` disponibles para que el modelo lea la lista actual. Su código de monitoreo aún inspecciona bloques `tool_use` en la secuencia del asistente, pero mantiene un mapa codificado por ID de tarea en lugar de reemplazar la lista completa en cada llamada. {/* min-version: 2.1.142 */}Las herramientas Task son las predeterminadas a partir del TypeScript Agent SDK 0.3.142 y Claude Code v2.1.142, por lo que no se necesita cambio en `options.env`.

200

201| Con `TodoWrite` | Con herramientas Task |

202| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| Una llamada de herramienta reescribe el array `todos` completo | `TaskCreate` añade un elemento, `TaskUpdate` parcha un elemento por `taskId` |

204| Coincide con `block.name === "TodoWrite"` | Coincide con `block.name === "TaskCreate"` o `"TaskUpdate"` |

205| Forma del elemento: `{ content, status, activeForm }` | Entrada de `TaskCreate`: `{ subject, description, activeForm?, metadata? }`. Entrada de `TaskUpdate`: `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` es `"pending"`, `"in_progress"` o `"completed"`; establezca `status: "deleted"` para eliminar |

206| Renderice `block.input.todos` directamente | Acumule elementos entre llamadas, o lea una instantánea de un resultado de herramienta `TaskList` |

207

208El ID de tarea asignado no está en la entrada de `TaskCreate`. Vuelve en el bloque `tool_result` coincidente como `{ task: { id, subject } }`, así que capturelo del bloque de resultado para codificar su mapa. El siguiente ejemplo muestra el cambio mínimo al bucle [Monitoreo de Cambios en Tareas](#monitoring-todo-changes). Para renderizar una lista completa, observe un resultado de herramienta `TaskList` en la secuencia o acumule resultados de `TaskCreate` e entradas de `TaskUpdate` en un mapa:

209

210<CodeGroup>

211 ```typescript TypeScript theme={null}

212 import { query } from "@anthropic-ai/claude-agent-sdk";

213

214 for await (const message of query({

215 prompt: "Optimize my React app performance",

216 })) {

217 if (message.type !== "assistant") continue;

218 for (const block of message.message.content) {

219 if (block.type !== "tool_use") continue;

220 if (block.name === "TaskCreate") {

221 const input = block.input as { subject: string };

222 console.log(`+ ${input.subject}`);

223 } else if (block.name === "TaskUpdate") {

224 const input = block.input as { taskId: string; status?: string };

225 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);

226 }

227 }

228 }

229 ```

230

231 ```python Python theme={null}

232 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock

233

234 async for message in query(

235 prompt="Optimize my React app performance",

236 ):

237 if not isinstance(message, AssistantMessage):

238 continue

239 for block in message.content:

240 if not isinstance(block, ToolUseBlock):

241 continue

242 if block.name == "TaskCreate":

243 print(f"+ {block.input['subject']}")

244 elif block.name == "TaskUpdate" and block.input.get("status"):

245 print(f" {block.input['taskId']} -> {block.input['status']}")

246 ```

247</CodeGroup>

248

184## Documentación Relacionada249## Documentación Relacionada

185 250

186* [Referencia del SDK de TypeScript](/es/agent-sdk/typescript)251* [Referencia del SDK de TypeScript](/es/agent-sdk/typescript)

agent-sdk/typescript.md +11 −7

Details

414| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibles para la sesión. Pase `'all'` para habilitar cada skill descubierto, o una lista de nombres de skills. Cuando se establece, el SDK habilita la herramienta Skill automáticamente sin enumerarla en `allowedTools`. Vea [Skills](/es/agent-sdk/skills) |414| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibles para la sesión. Pase `'all'` para habilitar cada skill descubierto, o una lista de nombres de skills. Cuando se establece, el SDK habilita la herramienta Skill automáticamente sin enumerarla en `allowedTools`. Vea [Skills](/es/agent-sdk/skills) |

415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Función personalizada para generar el proceso de Claude Code. Use para ejecutar Claude Code en máquinas virtuales, contenedores o entornos remotos |415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Función personalizada para generar el proceso de Claude Code. Use para ejecutar Claude Code en máquinas virtuales, contenedores o entornos remotos |

418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (mensaje mínimo) | Configuración de mensaje del sistema. Pase una cadena para un mensaje personalizado, o `{ type: 'preset', preset: 'claude_code' }` para usar el mensaje del sistema de Claude Code. Cuando use la forma de objeto preestablecido, agregue `append` para extenderlo con instrucciones adicionales, y establezca `excludeDynamicSections: true` para mover el contexto por sesión al primer mensaje de usuario para [mejor reutilización de caché de mensaje en máquinas](/es/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (mensaje mínimo) | Configuración de mensaje del sistema. Pase una cadena para un mensaje personalizado, o `{ type: 'preset', preset: 'claude_code' }` para usar el mensaje del sistema de Claude Code. Cuando use la forma de objeto preestablecido, agregue `append` para extenderlo con instrucciones adicionales, y establezca `excludeDynamicSections: true` para mover el contexto por sesión al primer mensaje de usuario para [mejor reutilización de caché de mensaje en máquinas](/es/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` para modelos compatibles | Controla el comportamiento de pensamiento/razonamiento de Claude. Vea [`ThinkingConfig`](#thinkingconfig) para opciones |419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` para modelos compatibles | Controla el comportamiento de pensamiento/razonamiento de Claude. Vea [`ThinkingConfig`](#thinkingconfig) para opciones |

1847Crea y gestiona una lista de tareas estructurada para rastrear el progreso.1847Crea y gestiona una lista de tareas estructurada para rastrear el progreso.

1848 1848

1849<Note>1849<Note>

1850 `TodoWrite` está deprecado y se eliminará en una versión futura. Use `TaskCreate`, `TaskGet`, `TaskUpdate` y `TaskList` en su lugar. Establezca `CLAUDE_CODE_ENABLE_TASKS=1` para optar por participar. Vea [Migrar a herramientas Task](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para cómo monitorear cambios de código.1850 A partir de TypeScript Agent SDK 0.3.142, `TodoWrite` está deshabilitado de forma predeterminada. Use `TaskCreate`, `TaskGet`, `TaskUpdate` y `TaskList` en su lugar. Vea [Migrar a herramientas Task](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para actualizar su código de monitoreo, o establezca `CLAUDE_CODE_ENABLE_TASKS=0` para revertir a `TodoWrite`.

1851</Note>1851</Note>

1852 1852

1853### TaskCreate1853### TaskCreate

2344Devuelve las listas de tareas anteriores y actualizadas.2344Devuelve las listas de tareas anteriores y actualizadas.

2345 2345

2346<Note>2346<Note>

2347 `TodoWrite` está deprecado y se eliminará en una versión futura. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, y `TaskList` en su lugar. Establezca `CLAUDE_CODE_ENABLE_TASKS=1` para optar por participar. Consulte [Migrar a herramientas de tareas](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para ver cómo monitorear cambios de código.2347 A partir de TypeScript Agent SDK 0.3.142, `TodoWrite` está deshabilitado de forma predeterminada. Use `TaskCreate`, `TaskGet`, `TaskUpdate`, y `TaskList` en su lugar. Consulte [Migrar a herramientas de tareas](/es/agent-sdk/todo-tracking#migrate-to-task-tools) para actualizar su código de monitoreo, o establezca `CLAUDE_CODE_ENABLE_TASKS=0` para revertir a `TodoWrite`.

2348</Note>2348</Note>

2349 2349

2350### TaskCreate2350### TaskCreate

2739Controla el comportamiento de pensamiento/razonamiento de Claude. Tiene precedencia sobre el `maxThinkingTokens` deprecado.2739Controla el comportamiento de pensamiento/razonamiento de Claude. Tiene precedencia sobre el `maxThinkingTokens` deprecado.

2740 2740

2741```typescript theme={null}2741```typescript theme={null}

2742type ThinkingDisplay = "summarized" | "omitted";

2743

2742type ThinkingConfig =2744type ThinkingConfig =

2743 | { type: "adaptive" } // El modelo determina cuándo y cuánto razonar (Opus 4.6+)2745 | { type: "adaptive"; display?: ThinkingDisplay } // El modelo determina cuándo y cuánto razonar (Opus 4.6+)

2744 | { type: "enabled"; budgetTokens?: number } // Presupuesto de token de pensamiento fijo2746 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Presupuesto de token de pensamiento fijo

2745 | { type: "disabled" }; // Sin pensamiento extendido2747 | { type: "disabled" }; // Sin pensamiento extendido

2746```2748```

2747 2749

2750El campo `display` opcional controla si el texto de pensamiento se devuelve `"summarized"` u `"omitted"`. En Claude Opus 4.7 y posterior, el valor predeterminado de la API es `"omitted"`, así que establezca `"summarized"` para recibir contenido de pensamiento en bloques `thinking`.

2751

2748### `SpawnedProcess`2752### `SpawnedProcess`

2749 2753

2750Interfaz para generación de proceso personalizado (usada con la opción `spawnClaudeCodeProcess`). `ChildProcess` ya satisface esta interfaz.2754Interfaz para generación de proceso personalizado (usada con la opción `spawnClaudeCodeProcess`). `ChildProcess` ya satisface esta interfaz.

3158```3162```

3159 3163

3161| :------------------------ | :--------- | :------------- | :------------------------------------------------------------------------------------------------------------- |3165| :------------------------ | :--------- | :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3164| `allowManagedDomainsOnly` | `boolean` | `false` | Restrinja el acceso de red solo a los dominios en `allowedDomains` |3168| `allowManagedDomainsOnly` | `boolean` | `false` | Solo configuración administrada. Cuando se establece en [configuración administrada](/es/permissions#managed-settings), solo se respetan las entradas `allowedDomains` de la configuración administrada y se ignoran las entradas de la configuración de usuario, proyecto o local. No tiene efecto cuando se establece a través de opciones de SDK |

agent-sdk/typescript-v2-preview.md +7 −5

Details

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

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

4 4

~~5# API de sesión de TypeScript SDK V2 (obsoleta)~~5# API de sesión de TypeScript SDK V2 (eliminada)

6 6

~~7> Referencia para la API de sesión obsoleta V2 del SDK del Agente TypeScript, con patrones de envío/transmisión basados en sesiones para conversaciones de múltiples turnos.~~7> Referencia para la API de sesión eliminada V2 del SDK del Agente TypeScript, con patrones de envío/transmisión basados en sesiones para conversaciones de múltiples turnos.

8 8

9<Warning>9<Warning>

10 Las funciones de la API de sesión V2 `unstable_v2_createSession`, `unstable_v2_resumeSession` y `unstable_v2_prompt` están obsoletas y se eliminarán en una versión futura. Use la [API V1 `query()`](/es/agent-sdk/typescript) en su lugar.10 La API de sesión V2 ya no es compatible. TypeScript Agent SDK 0.3.142 elimina `unstable_v2_createSession`, `unstable_v2_resumeSession`, `unstable_v2_prompt` y los tipos `SDKSession` y `SDKSessionOptions`.

12 Para migrar, use la [API `query()`](/es/agent-sdk/typescript) y las [opciones de sesión](/es/agent-sdk/sessions) que acepta. Pase un `AsyncIterable<SDKUserMessage>` para conversaciones de múltiples turnos, u `options.resume` para continuar una sesión guardada. Esta página se mantiene como referencia si mantiene código en Agent SDK 0.2.x o anterior.

11</Warning>13</Warning>

12 14

13V2 fue una API de sesión experimental que eliminó la necesidad de generadores asincronos y coordinación de rendimiento. En lugar de gestionar el estado del generador entre turnos, cada turno era un ciclo `send()`/`stream()` separado. La superficie de la API se redujo a tres conceptos:15V2 fue una API de sesión experimental que eliminó la necesidad de generadores asincronos y coordinación de rendimiento. En lugar de gestionar el estado del generador entre turnos, cada turno era un ciclo `send()`/`stream()` separado. La superficie de la API se redujo a tres conceptos:

18 20

19## Instalación21## Instalación

20 22

~~21La interfaz V2 se incluye en el paquete SDK existente:~~23Agent SDK 0.2.x es la última versión que incluye la interfaz V2. La versión del paquete saltó de 0.2.x directamente a 0.3.142, por lo que la versión de eliminación anterior y el pin de instalación a continuación describen el mismo límite. Para instalar la última versión compatible con V2, fije la versión principal y secundaria:

22 24

23```bash theme={null}25```bash theme={null}

~~24npm install @anthropic-ai/claude-agent-sdk~~26npm install @anthropic-ai/claude-agent-sdk@0.2

25```27```

26 28

27<Note>29<Note>

agent-view.md +72 −21

Details

72 72

73Ejecute `claude agents` para abrir la vista de agentes. Toma el control de la terminal completa y enumera cada sesión agrupada por estado, con sesiones fijadas y las que lo necesitan en la parte superior. Cada fila muestra el nombre de la sesión, la actividad actual y cuánto tiempo hace que cambió por última vez.73Ejecute `claude agents` para abrir la vista de agentes. Toma el control de la terminal completa y enumera cada sesión agrupada por estado, con sesiones fijadas y las que lo necesitan en la parte superior. Cada fila muestra el nombre de la sesión, la actividad actual y cuánto tiempo hace que cambió por última vez.

74 74

75La lista cubre cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Las sesiones interactivas que tiene abiertas en otras terminales no aparecen hasta que las [envíe al segundo plano](#from-inside-a-session). Los [subagentes](/es/sub-agents) y [compañeros de equipo](/es/agent-teams) que una sesión genera no se enumeran como filas separadas.75De forma predeterminada, la lista muestra cada sesión en segundo plano que ha iniciado, en todos sus proyectos. Una sesión que trabaja en un repositorio y otra en un worktree diferente aparecen aquí, independientemente de qué directorio abrió la vista de agentes. Para limitar la lista a un proyecto, pase `--cwd` (requiere Claude Code v2.1.141 o posterior):

76 76

77Para limitar la vista a un proyecto, inicie con `claude agents --cwd <path>`. Solo aparecen las sesiones iniciadas en ese directorio, incluidas las que se ejecutan en un [worktree](/es/worktrees) distribuido desde él.77```bash theme={null}

78claude agents --cwd ~/projects/my-app

79```

81Esto muestra solo las sesiones iniciadas en ese directorio. Una sesión que se ha [movido a un worktree](#how-file-edits-are-isolated) bajo `~/projects/my-app/.claude/worktrees/` sigue contando como perteneciente a `~/projects/my-app`.

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

78 84

79```text theme={null}85```text theme={null}

80Pinned86Pinned

117| `∙` | El proceso ha salido. Aún puede echar un vistazo, responder o conectarse, y Claude reinicia desde donde se quedó |123| `∙` | El proceso ha salido. Aún puede echar un vistazo, responder o conectarse, y Claude reinicia desde donde se quedó |

118| `✢` | Una sesión [`/loop`](/es/scheduled-tasks) durmiendo entre iteraciones. La fila muestra su recuento de ejecución y una cuenta regresiva |124| `✢` | Una sesión [`/loop`](/es/scheduled-tasks) durmiendo entre iteraciones. La fila muestra su recuento de ejecución y una cuenta regresiva |

119 125

126El `●` que puede aparecer en el borde derecho de una fila es el indicador de [estado de la solicitud de extracción](#pull-request-status), no parte del icono de estado. Un número antes de él es el recuento de solicitudes de extracción que la sesión ha abierto.

127

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

121 129

122El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Si su máquina se duerme o se apaga, las sesiones en ejecución se detienen; reinícielas con `claude respawn --all`.130El estado de la sesión persiste en el disco a través de actualizaciones automáticas y reinicios del supervisor. Las sesiones también se conservan cuando su máquina se duerme. Sus procesos se reanudan al despertar y el supervisor se reconecta a ellos en lugar de tratar la brecha de tiempo como inactividad. El apagado aún detiene las sesiones en ejecución; consulte [Las sesiones se muestran como fallidas después del apagado](#sessions-show-as-failed-after-shutdown) para saber cómo recuperarlas.

123 131

124### Resúmenes de filas132### Resúmenes de filas

125 133

158 166

159Desconectarse nunca detiene una sesión en segundo plano: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` y `/exit` la dejan ejecutándose. Para terminar una sesión desde dentro de ella, ejecute `/stop`.167Desconectarse nunca detiene una sesión en segundo plano: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` y `/exit` la dejan ejecutándose. Para terminar una sesión desde dentro de ella, ejecute `/stop`.

160 168

161Después de haber distribuido o enviado una sesión al segundo plano, presionar `←` en un mensaje vacío funciona desde cualquier sesión de Claude Code, no solo desde las que se conectó desde la vista de agentes. Envía la sesión actual al segundo plano y abre la vista de agentes con esa sesión preseleccionada, por lo que puede cambiar de sesión sin salir de la terminal. Puede desactivar este atajo en `/config`.169Después de haber distribuido o enviado una sesión al segundo plano, presionar `←` en un mensaje vacío funciona desde cualquier sesión de Claude Code, no solo desde las que se conectó desde la vista de agentes. Envía la sesión actual al segundo plano y abre la vista de agentes con esa fila seleccionada, por lo que puede cambiar de sesión sin salir de la terminal. La fila se crea incluso desde una sesión nueva sin historial de conversación, por lo que `→` vuelve a ella. Cuando esa fila es la única, la vista de agentes muestra una sugerencia de incorporación debajo de ella. Puede desactivar este atajo en `/config` (la configuración `leftArrowOpensAgents`).

162 170

163### Organizar la lista171### Organizar la lista

164 172

173 181

174Para eliminar una sesión de la lista, presione `Ctrl+X` para detenerla y `Ctrl+X` nuevamente dentro de dos segundos para eliminarla. Presionar `Ctrl+X` en un encabezado de grupo elimina cada sesión en ese grupo después de la confirmación.182Para eliminar una sesión de la lista, presione `Ctrl+X` para detenerla y `Ctrl+X` nuevamente dentro de dos segundos para eliminarla. Presionar `Ctrl+X` en un encabezado de grupo elimina cada sesión en ese grupo después de la confirmación.

175 183

176Eliminar elimina la sesión de la vista de agentes y limpia su [worktree](#how-file-edits-are-isolated), incluidos los cambios sin confirmar en ella, por lo que envíe o confirme el trabajo que desea conservar antes de eliminar. La transcripción de la conversación permanece en el disco y sigue siendo accesible a través de `claude --resume`.184Eliminar elimina la sesión de la vista de agentes y elimina su transcripción de conversación. Si Claude [creó un worktree](#how-file-edits-are-isolated) para la sesión, eliminar elimina ese worktree también, incluidos los cambios sin confirmar en él, por lo que envíe o confirme el trabajo que desea conservar primero. Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar.

177 185

178Las sesiones completadas más antiguas se pliegan en una fila `… N more` para mantener la lista corta. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles.186Las sesiones completadas más antiguas se pliegan en una fila `… N more` para mantener la lista corta. Los fallos y las sesiones con una solicitud de extracción abierta siempre permanecen visibles.

179 187

200| `→` | Conectarse a la sesión seleccionada |208| `→` | Conectarse a la sesión seleccionada |

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

209| `Esc` | Cerrar el panel de vista previa, limpiar la entrada o salir |217| `Esc` | Cerrar el panel de vista previa, limpiar la entrada o salir |

251 259

252Enviar al segundo plano desde una sesión interactiva inicia un proceso nuevo que se reanuda desde la conversación guardada, por lo que ejecutar subagentes, [monitores](/es/tools-reference#monitor-tool) y comandos en segundo plano no se transfieren a él. Claude le pide que confirme antes de enviar al segundo plano cuando alguno está en ejecución. Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desconexiones y reconexiones posteriores.260Enviar al segundo plano desde una sesión interactiva inicia un proceso nuevo que se reanuda desde la conversación guardada, por lo que ejecutar subagentes, [monitores](/es/tools-reference#monitor-tool) y comandos en segundo plano no se transfieren a él. Claude le pide que confirme antes de enviar al segundo plano cuando alguno está en ejecución. Una vez en segundo plano, la sesión puede iniciar nuevos subagentes, monitores y comandos en segundo plano, y esos continúan ejecutándose en desconexiones y reconexiones posteriores.

253 261

262Las banderas de configuración del lanzamiento original se transfieren a la sesión enviada al segundo plano, por lo que sus servidores MCP, configuración y modelo de respaldo permanecen en vigor:

263

264* `--mcp-config` y `--strict-mcp-config`

265* `--settings`

266* `--add-dir`

267* `--plugin-dir`

268* `--fallback-model`

269* `--allow-dangerously-skip-permissions`

270

271Transferir `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` accesible en la sesión enviada al segundo plano, pero no otorga nada nuevo. El modo aún requiere la misma aceptación interactiva única descrita en [Modo de permiso, modelo y esfuerzo](#permission-mode-model-and-effort) antes de que cualquier sesión pueda usarlo.

272

254### Desde su shell273### Desde su shell

255 274

256Pase `--bg` para iniciar una sesión que vaya directamente al segundo plano:275Pase `--bg` para iniciar una sesión que vaya directamente al segundo plano:

283 302

284### Cómo se aíslan las ediciones de archivos303### Cómo se aíslan las ediciones de archivos

285 304

286Cada sesión en segundo plano, ya sea iniciada desde la vista de agentes, `/bg` o `claude --bg`, comienza en su directorio de trabajo. Antes de editar archivos, Claude mueve la sesión a un [git worktree](/es/worktrees) aislado bajo `.claude/worktrees/`, de modo que las sesiones paralelas pueden leer el mismo checkout pero cada una escribe en la suya propia. Claude omite esto cuando la sesión ya está bajo `.claude/worktrees/`, cuando el directorio de trabajo no es un repositorio git, o para escrituras fuera del directorio de trabajo.305Cada sesión en segundo plano, ya sea iniciada desde la vista de agentes, `/bg` o `claude --bg`, comienza en su directorio de trabajo. Antes de editar archivos, Claude mueve la sesión a un [git worktree](/es/worktrees) aislado bajo `.claude/worktrees/`, de modo que las sesiones paralelas pueden leer el mismo checkout pero cada una escribe en la suya propia.

306

307Claude omite el worktree cuando:

308

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

310* El directorio de trabajo no es un repositorio git

311* La escritura está fuera del directorio de trabajo

312

313Para desactivar el aislamiento de worktree para un repositorio donde los git worktrees no son prácticos, establezca [`worktree.bgIsolation`](/es/settings#worktree-settings) en `"none"`. Las sesiones en segundo plano editarán su copia de trabajo directamente sin moverse a un worktree primero. Agregue la configuración al archivo `.claude/settings.json` del proyecto:

314

315```json theme={null}

316{

317 "worktree": {

318 "bgIsolation": "none"

319 }

320}

321```

322

323<Note>

324 La configuración `worktree.bgIsolation` requiere Claude Code v2.1.143 o posterior.

325</Note>

287 326

288Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no están aisladas entre sí, por lo que evite distribuir sesiones paralelas que editen los mismos archivos.327Fuera de un repositorio git, las sesiones escriben en el directorio de trabajo directamente y no están aisladas entre sí, por lo que evite distribuir sesiones paralelas que editen los mismos archivos.

289 328

290El worktree se elimina cuando elimina la sesión, por lo que fusione o envíe los cambios que desee mantener antes de eliminar. Para encontrar la ruta del worktree de una sesión, eche un vistazo a la sesión o conéctese y verifique su directorio de trabajo.329Eliminar una sesión en la vista de agentes (`Ctrl+X` dos veces) elimina un worktree que Claude creó para ella, incluidos los cambios sin confirmar, por lo que fusione o envíe los cambios que desee mantener primero. Eliminar desde el shell con [`claude rm`](#manage-sessions-from-the-shell) mantiene un worktree que tiene cambios sin confirmar e imprime su ruta para que pueda limpiarlo usted mismo. Un worktree que creó usted mismo e inició la sesión dentro se deja en su lugar de cualquier forma.

330

331Para encontrar la ruta del worktree de una sesión, eche un vistazo a la sesión o conéctese y verifique su directorio de trabajo.

291 332

292Para hacer que un subagente siempre se ejecute en su propio worktree independientemente de cómo se inició, establezca [`isolation: worktree`](/es/sub-agents#supported-frontmatter-fields) en su frontmatter.333Para hacer que un subagente siempre se ejecute en su propio worktree independientemente de cómo se inició, establezca [`isolation: worktree`](/es/sub-agents#supported-frontmatter-fields) en su frontmatter.

293 334

307 348

308El [modo de permiso](/es/permissions) depende de cómo inició la sesión. Enviar al segundo plano una sesión existente con `/bg` o `←` mantiene el modo de permiso actual, por lo que una sesión que cambió a `acceptEdits` o `auto` permanece en ese modo después de desconectarse. Distribuir desde la entrada de la vista de agentes o ejecutar `claude --bg` desde su shell utiliza el `defaultMode` de la configuración de ese directorio, o el `permissionMode` del [frontmatter del subagente distribuido](/es/sub-agents#supported-frontmatter-fields).349El [modo de permiso](/es/permissions) depende de cómo inició la sesión. Enviar al segundo plano una sesión existente con `/bg` o `←` mantiene el modo de permiso actual, por lo que una sesión que cambió a `acceptEdits` o `auto` permanece en ese modo después de desconectarse. Distribuir desde la entrada de la vista de agentes o ejecutar `claude --bg` desde su shell utiliza el `defaultMode` de la configuración de ese directorio, o el `permissionMode` del [frontmatter del subagente distribuido](/es/sub-agents#supported-frontmatter-fields).

309 350

351El modo de permiso con el que inicia una sesión en segundo plano persiste cuando el supervisor posteriormente [detiene y reinicia](#the-supervisor-process) el proceso de la sesión. Una sesión que lanzó con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` permanece en `bypassPermissions` después de ese reinicio en lugar de volver al `defaultMode` del directorio.

352

310Para establecer valores predeterminados para cada sesión que distribuya desde la vista de agentes, pase cualquiera de `--permission-mode`, `--model` o `--effort` al abrirla:353Para establecer valores predeterminados para cada sesión que distribuya desde la vista de agentes, pase cualquiera de `--permission-mode`, `--model` o `--effort` al abrirla:

311 354

312```bash theme={null}355```bash theme={null}

313claude agents --permission-mode plan --model opus --effort high356claude agents --permission-mode plan --model opus --effort high

314```357```

315 358

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

360

316<Note>361<Note>

317 Pasar `--permission-mode`, `--model` o `--effort` a `claude agents` requiere Claude Code v2.1.142 o posterior. Las versiones anteriores rechazan estas banderas con un error de opción desconocida.362 Pasar `--permission-mode`, `--model`, `--effort` o `--dangerously-skip-permissions` a `claude agents` requiere Claude Code v2.1.142 o posterior. {/* min-version: 2.1.143 */}`--allow-dangerously-skip-permissions` en `claude agents` requiere v2.1.143 o posterior. Las versiones anteriores rechazan estas banderas con un error de opción desconocida.

318</Note>363</Note>

319 364

320Los valores predeterminados activos aparecen en el pie de página debajo de la entrada de distribución.365Los valores predeterminados activos aparecen en el pie de página debajo de la entrada de distribución.

325 370

326### Configuración, plugins y servidores MCP371### Configuración, plugins y servidores MCP

327 372

328La vista de agentes acepta las mismas banderas de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. Cada bandera se aplica a la vista de agentes en sí y se pasa a cada sesión que distribuya desde ella, por lo que un plugin o servidor MCP que cargue de esta manera está disponible en esas sesiones también.373La vista de agentes acepta las mismas banderas de configuración que `claude` para cargar configuración, plugins, servidores MCP y directorios adicionales. Estas banderas requieren Claude Code v2.1.142 o posterior. Cada bandera se aplica a la vista de agentes en sí y se pasa a cada sesión que distribuya desde ella, por lo que un plugin o servidor MCP que cargue de esta manera está disponible en esas sesiones también.

329 374

330| Bandera | Efecto |375| Bandera | Efecto |

331| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |376| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |

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

349 394

350| Comando | Propósito |395| Comando | Propósito |

351| :--------------------- | :---------------------------------------------------------------------------------- |396| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

358| `claude rm <id>` | Eliminar una sesión de la lista. Limpia su worktree si no hay cambios sin confirmar |404| `claude rm <id>` | Eliminar una sesión y su transcripción. Elimina un worktree que Claude creó para la sesión si no tiene cambios sin confirmar; de lo contrario imprime la ruta del worktree para que pueda limpiarla. Deja un worktree que creó usted mismo en su lugar |

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

359 406

360## Cómo se alojan las sesiones en segundo plano407## Cómo se alojan las sesiones en segundo plano

361 408

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

385 432

433Para inspeccionar este estado sin leer los archivos directamente, ejecute `claude daemon status`. Informa si el supervisor es accesible, su ID de proceso y versión, el directorio de socket y cuántas sesiones en segundo plano están activas. `/doctor` incluye un resumen de la misma verificación. En Windows, `claude daemon status` expone el error de archivo subyacente cuando el archivo de clave de tubería del daemon está bloqueado o no es legible en lugar de informar una falla de conexión genérica.

434

386### Desactivar la vista de agentes435### Desactivar la vista de agentes

387 436

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

397 446

398### La vista de agentes se abre sin sesiones447### La vista de agentes se abre sin sesiones

399 448

400La vista de agentes está vacía hasta que distribuya su primera sesión. Escriba un mensaje en la entrada en la parte inferior y presione `Enter`.449Antes de distribuir su primera sesión, la vista de agentes muestra una breve sugerencia de incorporación con mensajes de ejemplo en lugar de la lista de sesiones. Escriba un mensaje en la entrada en la parte inferior y presione `Enter` para distribuir su primera sesión.

401 450

402### No se pueden abrir agentes porque hay tareas en segundo plano en ejecución451### No se pueden abrir agentes porque hay tareas en segundo plano en ejecución

403 452

407 456

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

409 458

410### Las sesiones se muestran como detenidas después de despertar su máquina459### Las sesiones se muestran como detenidas después del apagado

460

461Apagar o reiniciar su máquina detiene las sesiones en segundo plano en ejecución, por lo que se muestran como detenidas cuando abre la vista de agentes la próxima vez. Conéctese, eche un vistazo o responda a cualquiera de ellas y la sesión se reiniciará desde donde se quedó.

411 462

412Las sesiones en segundo plano no sobreviven al sueño o apagado, por lo que las sesiones que se estaban ejecutando se muestran como detenidas después de despertar. Conéctese, eche un vistazo o responda a cualquiera de ellas y la sesión se reiniciará desde donde se quedó. Para reiniciarlas todas a la vez, ejecute `claude respawn --all`.463El sueño solo no causa esto. Las sesiones se conservan durante el sueño y el supervisor se reconecta a ellas al despertar.

413 464

414### Una sesión es lenta para responder después de conectarse465### Una sesión es lenta para responder después de conectarse

415 466

417 468

418### `.claude/worktrees/` se está llenando469### `.claude/worktrees/` se está llenando

419 470

420Los worktrees se eliminan cuando elimina la sesión que los creó. Si una sesión terminó sin limpiar, enumere las entradas sobrantes con `git worktree list` en el directorio del proyecto y elimine cada una con `git worktree remove <path>`. Vea [Limpiar worktrees](/es/worktrees#clean-up-worktrees).471Eliminar una sesión en la vista de agentes elimina el worktree que Claude creó para ella. `claude rm` mantiene un worktree que tiene cambios sin confirmar e imprime su ruta. Enumere las entradas sobrantes con `git worktree list` en el directorio del proyecto y elimine cada una con `git worktree remove <path>`. Vea [Limpiar worktrees](/es/worktrees#clean-up-worktrees).

421 472

422## Limitaciones473## Limitaciones

423 474

424La vista de agentes está en vista previa de investigación con las siguientes limitaciones:475La vista de agentes está en vista previa de investigación con las siguientes limitaciones:

425 476

426* **Se aplican límites de velocidad**: las sesiones en segundo plano consumen el uso de su suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota aproximadamente diez veces más rápido que ejecutar uno.477* **Se aplican límites de velocidad**: las sesiones en segundo plano consumen el uso de su suscripción igual que las sesiones interactivas, por lo que ejecutar diez agentes en paralelo usa cuota aproximadamente diez veces más rápido que ejecutar uno.

427* **Las sesiones son locales**: las sesiones en segundo plano se ejecutan en su máquina y se detienen si entra en modo de suspensión o se apaga.478* **Las sesiones son locales**: las sesiones en segundo plano se ejecutan en su máquina. Se conservan durante el modo de suspensión pero se detienen si la máquina se apaga.

428* **Los worktrees se eliminan con la sesión**: fusione o envíe cambios antes de eliminar una sesión que editó archivos en su propio worktree.479* **Los worktrees creados por Claude se eliminan con la sesión en la vista de agentes**: fusione o envíe cambios antes de eliminar una sesión que editó archivos en su propio worktree. `claude rm` mantiene un worktree que tiene cambios sin confirmar; un worktree que usted creó se deja en su lugar.

429 480

430## Recursos relacionados481## Recursos relacionados

431 482

cli-reference.md +4 −3

Details

24| `claude auth login` | Inicie sesión en su cuenta de Anthropic. Use `--email` para rellenar previamente su dirección de correo electrónico, `--sso` para forzar la autenticación SSO y `--console` para iniciar sesión con Anthropic Console para facturación de uso de API en lugar de una suscripción a Claude | `claude auth login --console` |24| `claude auth login` | Inicie sesión en su cuenta de Anthropic. Use `--email` para rellenar previamente su dirección de correo electrónico, `--sso` para forzar la autenticación SSO y `--console` para iniciar sesión con Anthropic Console para facturación de uso de API en lugar de una suscripción a Claude | `claude auth login --console` |

26| `claude auth status` | Mostrar estado de autenticación como JSON. Use `--text` para salida legible por humanos. Sale con código 0 si ha iniciado sesión, 1 si no | `claude auth status` |26| `claude auth status` | Mostrar estado de autenticación como JSON. Use `--text` para salida legible por humanos. Sale con código 0 si ha iniciado sesión, 1 si no | `claude auth status` |

27| `claude agents` | Abrir [vista de agentes](/es/agent-view) para monitorear y enviar sesiones de fondo paralelas. Use `--cwd <path>` para mostrar solo sesiones iniciadas en ese directorio | `claude agents` |27| `claude agents` | Abrir [vista de agentes](/es/agent-view) para monitorear y enviar sesiones de fondo paralelas. Use `--cwd <path>` para mostrar solo sesiones iniciadas en ese directorio. Pase `--settings`, `--add-dir`, `--plugin-dir` y `--mcp-config` como el comando `claude` de nivel superior. Requiere una terminal interactiva | `claude agents --cwd ~/projects/my-app` |

29| `claude auto-mode defaults` | Imprimir las reglas del clasificador de [auto mode](/es/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver su configuración efectiva con la configuración aplicada | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | Imprimir las reglas del clasificador de [auto mode](/es/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `claude auto-mode config` para ver su configuración efectiva con la configuración aplicada | `claude auto-mode defaults > rules.json` |

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

32| `claude plugin` | Administrar Claude Code [plugins](/es/plugins). Alias: `claude plugins`. Consulte [referencia de plugins](/es/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |33| `claude plugin` | Administrar Claude Code [plugins](/es/plugins). Alias: `claude plugins`. Consulte [referencia de plugins](/es/plugins-reference#cli-commands-reference) para subcomandos | `claude plugin install code-review@claude-plugins-official` |

33| `claude project purge [path]` | Eliminar todo el estado local de Claude Code para un proyecto: transcripciones, listas de tareas, registros de depuración, historial de edición de archivos, líneas de historial de indicaciones y la entrada del proyecto en `~/.claude.json`. Omita `[path]` para elegir de una lista interactiva. Banderas: `--dry-run` para vista previa, `-y`/`--yes` para omitir confirmación, `-i`/`--interactive` para confirmar cada elemento, `--all` para cada proyecto. Consulte [Borrar datos locales](/es/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |34| `claude project purge [path]` | Eliminar todo el estado local de Claude Code para un proyecto: transcripciones, listas de tareas, registros de depuración, historial de edición de archivos, líneas de historial de indicaciones y la entrada del proyecto en `~/.claude.json`. Omita `[path]` para elegir de una lista interactiva. Banderas: `--dry-run` para vista previa, `-y`/`--yes` para omitir confirmación, `-i`/`--interactive` para confirmar cada elemento, `--all` para cada proyecto. Consulte [Borrar datos locales](/es/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

34| `claude remote-control` | Iniciar un servidor de [Remote Control](/es/remote-control) para controlar Claude Code desde Claude.ai o la aplicación Claude. Se ejecuta en modo servidor (sin sesión interactiva local). Consulte [Banderas de modo servidor](/es/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |35| `claude remote-control` | Iniciar un servidor de [Remote Control](/es/remote-control) para controlar Claude Code desde Claude.ai o la aplicación Claude. Se ejecuta en modo servidor (sin sesión interactiva local). Consulte [Banderas de modo servidor](/es/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | Reiniciar una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell) detenida con su conversación intacta. Use `--all` para reiniciar cada sesión detenida | `claude respawn 7c5dcf5d` |36| `claude respawn <id>` | Reiniciar una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell), en ejecución o detenida, con su conversación intacta. Use `--all` para reiniciar cada sesión en ejecución, por ejemplo, para recoger un binario de Claude Code actualizado | `claude respawn 7c5dcf5d` |

37| `claude setup-token` | Generar un token OAuth de larga duración para CI y scripts. Imprime el token en la terminal sin guardarlo. Requiere una suscripción a Claude. Consulte [Generar un token de larga duración](/es/authentication#generate-a-long-lived-token) | `claude setup-token` |38| `claude setup-token` | Generar un token OAuth de larga duración para CI y scripts. Imprime el token en la terminal sin guardarlo. Requiere una suscripción a Claude. Consulte [Generar un token de larga duración](/es/authentication#generate-a-long-lived-token) | `claude setup-token` |

68| `--effort` | Establecer el [nivel de esfuerzo](/es/model-config#adjust-effort-level) para la sesión actual. Opciones: `low`, `medium`, `high`, `xhigh`, `max`; los niveles disponibles dependen del modelo. Anula la configuración [`effortLevel`](/es/settings#available-settings) para esta sesión y no persiste | `claude --effort high` |69| `--effort` | Establecer el [nivel de esfuerzo](/es/model-config#adjust-effort-level) para la sesión actual. Opciones: `low`, `medium`, `high`, `xhigh`, `max`; los niveles disponibles dependen del modelo. Anula la configuración [`effortLevel`](/es/settings#available-settings) para esta sesión y no persiste | `claude --effort high` |

69| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Eliminado en v2.1.111. Auto mode ahora está en el ciclo `Shift+Tab` de forma predeterminada; use `--permission-mode auto` para comenzar en él | `claude --permission-mode auto` |70| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Eliminado en v2.1.111. Auto mode ahora está en el ciclo `Shift+Tab` de forma predeterminada; use `--permission-mode auto` para comenzar en él | `claude --permission-mode auto` |

70| `--exclude-dynamic-system-prompt-sections` | Mover secciones por máquina del indicador del sistema (directorio de trabajo, información del entorno, rutas de memoria, estado de git) al primer mensaje del usuario. Mejora la reutilización de caché de indicación en diferentes usuarios y máquinas que ejecutan la misma tarea. Solo se aplica con el indicador del sistema predeterminado; se ignora cuando se establece `--system-prompt` o `--system-prompt-file`. Use con `-p` para cargas de trabajo con script y múltiples usuarios | `claude -p --exclude-dynamic-system-prompt-sections "query"` |71| `--exclude-dynamic-system-prompt-sections` | Mover secciones por máquina del indicador del sistema (directorio de trabajo, información del entorno, rutas de memoria, estado de git) al primer mensaje del usuario. Mejora la reutilización de caché de indicación en diferentes usuarios y máquinas que ejecutan la misma tarea. Solo se aplica con el indicador del sistema predeterminado; se ignora cuando se establece `--system-prompt` o `--system-prompt-file`. Use con `-p` para cargas de trabajo con script y múltiples usuarios | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

71| `--fallback-model` | Habilitar fallback automático al modelo especificado cuando el modelo predeterminado está sobrecargado (solo modo impresión) | `claude -p --fallback-model sonnet "query"` |72| `--fallback-model` | Habilitar fallback automático al modelo especificado cuando el modelo predeterminado está sobrecargado. Tiene efecto en modo impresión (`-p`) y en [sesiones de fondo](/es/agent-view), que se ejecutan de forma no interactiva; se ignora en una sesión interactiva | `claude -p --fallback-model sonnet "query"` |

72| `--fork-session` | Al reanudar, crear un nuevo ID de sesión en lugar de reutilizar el original (usar con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |73| `--fork-session` | Al reanudar, crear un nuevo ID de sesión en lugar de reutilizar el original (usar con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |

73| `--from-pr` | Reanudar sesiones vinculadas a una solicitud de extracción específica. Acepta un número de PR, una URL de PR de GitHub o GitHub Enterprise, una URL de solicitud de fusión de GitLab o una URL de solicitud de extracción de Bitbucket. Las sesiones se vinculan automáticamente cuando Claude crea la solicitud de extracción | `claude --from-pr 123` |74| `--from-pr` | Reanudar sesiones vinculadas a una solicitud de extracción específica. Acepta un número de PR, una URL de PR de GitHub o GitHub Enterprise, una URL de solicitud de fusión de GitLab o una URL de solicitud de extracción de Bitbucket. Las sesiones se vinculan automáticamente cuando Claude crea la solicitud de extracción | `claude --from-pr 123` |

74| `--ide` | Conectarse automáticamente al IDE al iniciar si exactamente un IDE válido está disponible | `claude --ide` |75| `--ide` | Conectarse automáticamente al IDE al iniciar si exactamente un IDE válido está disponible | `claude --ide` |

code-review.md +2 −2

Details

29 29

30Una vez que un administrador [habilita Code Review](#set-up-code-review) para su organización, las revisiones se activan cuando se abre un PR, en cada push, o cuando se solicita manualmente, según el comportamiento configurado del repositorio. Comentar `@claude review` [inicia revisiones en un PR](#manually-trigger-reviews) en cualquier modo.30Una vez que un administrador [habilita Code Review](#set-up-code-review) para su organización, las revisiones se activan cuando se abre un PR, en cada push, o cuando se solicita manualmente, según el comportamiento configurado del repositorio. Comentar `@claude review` [inicia revisiones en un PR](#manually-trigger-reviews) en cualquier modo.

31 31

32Cuando se ejecuta una revisión, múltiples agentes analizan el diff y el código circundante en paralelo en la infraestructura de Anthropic. Cada agente busca una clase diferente de problema, luego un paso de verificación verifica los candidatos contra el comportamiento real del código para filtrar falsos positivos. Los resultados se desduplican, se clasifican por severidad y se publican como comentarios en línea en las líneas específicas donde se encontraron problemas, con un resumen en el cuerpo de la revisión. Si no se encuentran problemas, Claude publica un breve comentario de confirmación en el PR.32Cuando se ejecuta una revisión, múltiples agentes analizan el diff y el código circundante en paralelo en la infraestructura de Anthropic. Cada agente busca una clase diferente de problema, luego un paso de verificación verifica los candidatos contra el comportamiento real del código para filtrar falsos positivos. Los resultados se desduplican, se clasifican por severidad y se publican como comentarios en línea en las líneas específicas donde se encontraron problemas, con un resumen en el cuerpo de la revisión. Si no se encuentran problemas, Code Review actualiza la ejecución de verificación de GitHub para mostrar que no se detectaron problemas. Claude también puede publicar un breve comentario de confirmación en el PR.

33 33

34Las revisiones se escalan en costo con el tamaño y la complejidad del PR, completándose en un promedio de 20 minutos. Los administradores pueden monitorear la actividad de revisión y el gasto a través del [panel de análisis](#view-usage).34Las revisiones se escalan en costo con el tamaño y la complejidad del PR, completándose en un promedio de 20 minutos. Los administradores pueden monitorear la actividad de revisión y el gasto a través del [panel de análisis](#view-usage).

35 35

230 230

231## Precios231## Precios

232 232

233Code Review se factura según el uso de tokens. Cada revisión promedia \$15-25 en costo, escalando con el tamaño del PR, la complejidad de la base de código y cuántos problemas requieren verificación. El uso de Code Review se factura por separado a través de [extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) y no cuenta contra el uso incluido de su plan.233Code Review se factura según el uso de tokens. Cada revisión promedia \$15-25 en costo, escalando con el tamaño del PR, la complejidad de la base de código y cuántos problemas requieren verificación. El uso de Code Review se factura por separado a través de [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) y no cuenta contra el uso incluido de su plan.

234 234

235El disparador de revisión que elija afecta el costo total:235El disparador de revisión que elija afecta el costo total:

236 236

commands.md +3 −3

Details

63| `/effort [level\|auto]` | Establecer el [nivel de esfuerzo](/es/model-config#adjust-effort-level) del modelo. Acepta `low`, `medium`, `high`, `xhigh` o `max`; los niveles disponibles dependen del modelo y `max` es solo para sesión. `auto` se restablece al valor predeterminado del modelo. Sin un argumento, abre un control deslizante interactivo; use las flechas izquierda y derecha para elegir un nivel y `Enter` para aplicar. Entra en vigor inmediatamente sin esperar a que se complete la respuesta actual |63| `/effort [level\|auto]` | Establecer el [nivel de esfuerzo](/es/model-config#adjust-effort-level) del modelo. Acepta `low`, `medium`, `high`, `xhigh` o `max`; los niveles disponibles dependen del modelo y `max` es solo para sesión. `auto` se restablece al valor predeterminado del modelo. Sin un argumento, abre un control deslizante interactivo; use las flechas izquierda y derecha para elegir un nivel y `Enter` para aplicar. Entra en vigor inmediatamente sin esperar a que se complete la respuesta actual |

64| `/exit` | Salir de la CLI. En una [sesión de fondo](/es/agent-view#attach-to-a-session) conectada, esto desconecta y la sesión continúa ejecutándose. Alias: `/quit` |64| `/exit` | Salir de la CLI. En una [sesión de fondo](/es/agent-view#attach-to-a-session) conectada, esto desconecta y la sesión continúa ejecutándose. Alias: `/quit` |

65| `/export [filename]` | Exportar la conversación actual como texto sin formato. Con un nombre de archivo, escribe directamente en ese archivo. Sin uno, abre un diálogo para copiar al portapapeles o guardar en un archivo |65| `/export [filename]` | Exportar la conversación actual como texto sin formato. Con un nombre de archivo, escribe directamente en ese archivo. Sin uno, abre un diálogo para copiar al portapapeles o guardar en un archivo |

66| `/extra-usage` | Configurar uso extra para continuar trabajando cuando se alcanzan los límites de velocidad |

67| `/fast [on\|off]` | Alternar [fast mode](/es/fast-mode) activado o desactivado |66| `/fast [on\|off]` | Alternar [fast mode](/es/fast-mode) activado o desactivado |

69| `/fewer-permission-prompts` | **[Skill](/es/skills#bundled-skills).** Escanear sus transcripciones para llamadas comunes de herramientas Bash y MCP de solo lectura, luego agregar una lista de permitidos priorizada al proyecto `.claude/settings.json` para reducir solicitudes de permiso |68| `/fewer-permission-prompts` | **[Skill](/es/skills#bundled-skills).** Escanear sus transcripciones para llamadas comunes de herramientas Bash y MCP de solo lectura, luego agregar una lista de permitidos priorizada al proyecto `.claude/settings.json` para reducir solicitudes de permiso |

104| `/rewind` | Rebobinar la conversación y/o código a un punto anterior, o resumir desde un mensaje seleccionado. Consulte [checkpointing](/es/checkpointing). Alias: `/checkpoint`, `/undo` |103| `/rewind` | Rebobinar la conversación y/o código a un punto anterior, o resumir desde un mensaje seleccionado. Consulte [checkpointing](/es/checkpointing). Alias: `/checkpoint`, `/undo` |

106| `/schedule [description]` | Crear, actualizar, listar o ejecutar [routines](/es/routines), que se ejecutan en infraestructura en la nube administrada por Anthropic. Claude lo guía a través de la configuración de manera conversacional. Alias: `/routines` |105| `/schedule [description]` | Crear, actualizar, listar o ejecutar [routines](/es/routines), que se ejecutan en infraestructura en la nube administrada por Anthropic. Claude lo guía a través de la configuración de manera conversacional. Alias: `/routines` |

107| `/scroll-speed` | Ajustar la [velocidad de desplazamiento](/es/fullscreen#mouse-wheel-scrolling) del rueda del ratón de forma interactiva, con una regla que puede desplazar mientras el diálogo está abierto para obtener una vista previa del cambio. Disponible solo en [renderizado de pantalla completa](/es/fullscreen) y no en el terminal del IDE JetBrains |106| `/scroll-speed` | Ajustar la [velocidad de desplazamiento](/es/fullscreen#mouse-wheel-scrolling) de la rueda del ratón de forma interactiva, con una regla que puede desplazar mientras el diálogo está abierto para obtener una vista previa del cambio. Disponible solo en [renderizado de pantalla completa](/es/fullscreen) y no en el terminal del IDE JetBrains |

108| `/security-review` | Analizar cambios pendientes en la rama actual para detectar vulnerabilidades de seguridad. Revisa el diff de git e identifica riesgos como inyección, problemas de autenticación y exposición de datos |107| `/security-review` | Analizar cambios pendientes en la rama actual para detectar vulnerabilidades de seguridad. Revisa el diff de git e identifica riesgos como inyección, problemas de autenticación y exposición de datos |

109| `/setup-bedrock` | Configurar autenticación de [Amazon Bedrock](/es/amazon-bedrock), región y fijaciones de modelo a través de un asistente interactivo. Solo visible cuando se establece `CLAUDE_CODE_USE_BEDROCK=1`. Los usuarios de Bedrock por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |108| `/setup-bedrock` | Configurar autenticación de [Amazon Bedrock](/es/amazon-bedrock), región y fijaciones de modelo a través de un asistente interactivo. Solo visible cuando se establece `CLAUDE_CODE_USE_BEDROCK=1`. Los usuarios de Bedrock por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |

110| `/setup-vertex` | Configurar autenticación de [Google Vertex AI](/es/google-vertex-ai), proyecto, región y fijaciones de modelo a través de un asistente interactivo. Solo visible cuando se establece `CLAUDE_CODE_USE_VERTEX=1`. Los usuarios de Vertex AI por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |109| `/setup-vertex` | Configurar autenticación de [Google Vertex AI](/es/google-vertex-ai), proyecto, región y fijaciones de modelo a través de un asistente interactivo. Solo visible cuando se establece `CLAUDE_CODE_USE_VERTEX=1`. Los usuarios de Vertex AI por primera vez también pueden acceder a este asistente desde la pantalla de inicio de sesión |

122| `/theme` | Cambiar el tema de color. Incluye una opción `auto` que sigue el modo oscuro o claro de su terminal, variantes claras y oscuras, temas accesibles para daltónicos (daltónicos), temas ANSI que utilizan la paleta de colores de su terminal, y cualquier [tema personalizado](/es/terminal-config#create-a-custom-theme) de `~/.claude/themes/` o plugins. Seleccione **New custom theme…** para crear uno |121| `/theme` | Cambiar el tema de color. Incluye una opción `auto` que sigue el modo oscuro o claro de su terminal, variantes claras y oscuras, temas accesibles para daltónicos (daltónicos), temas ANSI que utilizan la paleta de colores de su terminal, y cualquier [tema personalizado](/es/terminal-config#create-a-custom-theme) de `~/.claude/themes/` o plugins. Seleccione **New custom theme…** para crear uno |

123| `/tui [default\|fullscreen]` | Establecer el renderizador de interfaz de usuario de terminal y reiniciar en él con su conversación intacta. `fullscreen` habilita el [renderizador de pantalla alternativa sin parpadeo](/es/fullscreen). Sin un argumento, imprime el renderizador activo |122| `/tui [default\|fullscreen]` | Establecer el renderizador de interfaz de usuario de terminal y reiniciar en él con su conversación intacta. `fullscreen` habilita el [renderizador de pantalla alternativa sin parpadeo](/es/fullscreen). Sin un argumento, imprime el renderizador activo |

124| `/ultraplan <prompt>` | Redactar un plan en una sesión de [ultraplan](/es/ultraplan), revisarlo en su navegador, luego ejecutarlo de forma remota o enviarlo de vuelta a su terminal |123| `/ultraplan <prompt>` | Redactar un plan en una sesión de [ultraplan](/es/ultraplan), revisarlo en su navegador, luego ejecutarlo de forma remota o enviarlo de vuelta a su terminal |

125| `/ultrareview [PR]` | Ejecutar una revisión de código profunda y multiagente en una sandbox en la nube con [ultrareview](/es/ultrareview). Incluye 3 ejecuciones gratuitas en Pro y Max, luego requiere [extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |124| `/ultrareview [PR]` | Ejecutar una revisión de código profunda y multiagente en una sandbox en la nube con [ultrareview](/es/ultrareview). Incluye 3 ejecuciones gratuitas en Pro y Max, luego requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

127| `/usage` | Mostrar costo de sesión, límites de uso del plan y estadísticas de actividad. Consulte la [guía de seguimiento de costos](/es/costs#using-the-%2Fusage-command) para detalles específicos de la suscripción. `/cost` y `/stats` son alias |126| `/usage` | Mostrar costo de sesión, límites de uso del plan y estadísticas de actividad. Consulte la [guía de seguimiento de costos](/es/costs#using-the-%2Fusage-command) para detalles específicos de la suscripción. `/cost` y `/stats` son alias |

127| `/usage-credits` | Configurar créditos de uso para continuar trabajando cuando se alcanzan los límites. Anteriormente `/extra-usage` |

128| `/vim` | {/* max-version: 2.1.91 */}Eliminado en v2.1.92. Para alternar entre modos de edición Vim y Normal, use `/config` → Editor mode |128| `/vim` | {/* max-version: 2.1.91 */}Eliminado en v2.1.92. Para alternar entre modos de edición Vim y Normal, use `/config` → Editor mode |

129| `/voice [hold\|tap\|off]` | Alternar [voice dictation](/es/voice-dictation), o habilitarlo en un modo específico. Requiere una cuenta Claude.ai |129| `/voice [hold\|tap\|off]` | Alternar [voice dictation](/es/voice-dictation), o habilitarlo en un modo específico. Requiere una cuenta Claude.ai |

130| `/web-setup` | Conectar su cuenta de GitHub a [Claude Code en la web](/es/web-quickstart#connect-from-your-terminal) usando sus credenciales locales de `gh` CLI. `/schedule` solicita esto automáticamente si GitHub no está conectado |130| `/web-setup` | Conectar su cuenta de GitHub a [Claude Code en la web](/es/web-quickstart#connect-from-your-terminal) usando sus credenciales locales de `gh` CLI. `/schedule` solicita esto automáticamente si GitHub no está conectado |

debug-your-config.md +3 −3

Details

87La mayoría de las sorpresas de configuración se remontan a un pequeño conjunto de reglas de ubicación y sintaxis. Verifique estos antes de asumir un error:87La mayoría de las sorpresas de configuración se remontan a un pequeño conjunto de reglas de ubicación y sintaxis. Verifique estos antes de asumir un error:

88 88

90| :------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |90| :------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

92| Hook nunca se dispara | El valor `matcher` está en minúsculas, por ejemplo `"bash"` | La coincidencia distingue mayúsculas de minúsculas. Los nombres de herramientas están capitalizados: `Bash`, `Edit`, `Write`, `Read`. |92| Hook nunca se dispara | El valor `matcher` está en minúsculas, por ejemplo `"bash"` | La coincidencia distingue mayúsculas de minúsculas. Los nombres de herramientas están capitalizados: `Bash`, `Edit`, `Write`, `Read`. |

93| Hook nunca se dispara | Los hooks están en un archivo `.claude/hooks.json` independiente | No hay archivo de hooks independiente. Defina hooks bajo la clave `"hooks"` en `settings.json`. Consulte [configuración de hook](/es/hooks). |93| Hook nunca se dispara | Los hooks están definidos en un archivo independiente en lugar de en `settings.json` | No hay archivo de hooks independiente para la configuración del proyecto o del usuario. Defina hooks bajo la clave `"hooks"` en `settings.json`. Solo los [plugins](/es/plugins-reference#hooks) cargan un archivo `hooks/hooks.json` separado. Consulte [configuración de hook](/es/hooks). |

94| Los permisos, hooks o env establecidos globalmente se ignoran | La configuración se agregó a `~/.claude.json` | `~/.claude.json` contiene el estado de la aplicación y los cambios de interfaz de usuario. `permissions`, `hooks` y `env` pertenecen a `~/.claude/settings.json`. Estos son dos archivos diferentes. |94| Los permisos, hooks o env establecidos globalmente se ignoran | La configuración se agregó a `~/.claude.json` | `~/.claude.json` contiene el estado de la aplicación y los cambios de interfaz de usuario. `permissions`, `hooks` y `env` pertenecen a `~/.claude/settings.json`. Estos son dos archivos diferentes. |

95| Un valor `settings.json` parece ignorado | La misma clave se establece en `settings.local.json` | `settings.local.json` anula `settings.json`, y ambos anulan `~/.claude/settings.json`. Consulte [precedencia de configuración](/es/settings#how-scopes-interact). |95| Un valor `settings.json` parece ignorado | La misma clave se establece en `settings.local.json` | `settings.local.json` anula `settings.json`, y ambos anulan `~/.claude/settings.json`. Consulte [precedencia de configuración](/es/settings#how-scopes-interact). |

96| Skill no aparece en `/skills` | El archivo de skill está en `.claude/skills/name.md` en lugar de en una carpeta | Use una carpeta con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |96| Skill no aparece en `/skills` | El archivo de skill está en `.claude/skills/name.md` en lugar de en una carpeta | Use una carpeta con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

97| Skill aparece en `/skills` pero Claude nunca lo invoca | Skill tiene `disable-model-invocation: true` en su frontmatter, o su descripción no coincide con cómo formula la solicitud | Verifique la insignia en `/skills`: una etiqueta "user-only" significa que Claude no lo activará por su cuenta. Consulte [invocación de skill](/es/skills). |97| Skill aparece en `/skills` pero Claude nunca lo invoca | Skill tiene `disable-model-invocation: true` en su frontmatter, o su descripción no coincide con cómo formula la solicitud | Verifique la insignia en `/skills`: una etiqueta "user-only" significa que Claude no lo activará por su cuenta. Consulte [invocación de skill](/es/skills). |

98| Las instrucciones de `CLAUDE.md` del subdirectorio parecen ignoradas | Los archivos del subdirectorio se cargan bajo demanda, no al inicio de la sesión | Se cargan cuando Claude lee un archivo en ese directorio con la herramienta Read, no al lanzar y no al escribir o crear archivos allí. Consulte [cómo se cargan los archivos CLAUDE.md](/es/memory#how-claude-md-files-load). |98| Las instrucciones de `CLAUDE.md` del subdirectorio parecen ignoradas | Los archivos del subdirectorio se cargan bajo demanda, no al inicio de la sesión | Se cargan cuando Claude lee un archivo en ese directorio con la herramienta Read, no al lanzar y no al escribir o crear archivos allí. Consulte [cómo se cargan los archivos CLAUDE.md](/es/memory#how-claude-md-files-load). |

99| El subagente ignora las instrucciones de `CLAUDE.md` | Los subagentes no siempre heredan la memoria del proyecto | Coloque las reglas críticas en el cuerpo del archivo del agente, que se convierte en el indicador del sistema del subagente. Consulte [configuración de subagente](/es/sub-agents). |99| El subagente ignora las instrucciones de `CLAUDE.md` | Los agentes Explore y Plan integrados omiten `CLAUDE.md`. Los subagentes personalizados lo cargan de la misma manera que la conversación principal | Para Explore o Plan, restate la instrucción en su indicador delegado. Para un subagente personalizado, coloque las instrucciones críticas en el cuerpo del archivo del agente, que se convierte en el indicador del sistema del subagente. Consulte [qué se carga al inicio](/es/sub-agents#what-loads-at-startup). |

100| La lógica de limpieza nunca se ejecuta al final de la sesión | No hay hook `SessionEnd` configurado | Agregue un hook `SessionEnd` en `settings.json`. Consulte la [lista de eventos de hook](/es/hooks#hook-events). |100| La lógica de limpieza nunca se ejecuta al final de la sesión | No hay hook `SessionEnd` configurado | Agregue un hook `SessionEnd` en `settings.json`. Consulte la [lista de eventos de hook](/es/hooks#hook-events). |

101| Los servidores MCP en `.mcp.json` nunca se cargan | El archivo está bajo `.claude/` o usa el formato de configuración de Claude Desktop | La configuración de MCP del proyecto va en la raíz del repositorio como `.mcp.json`, no dentro de `.claude/`. Consulte [configuración de MCP](/es/mcp). |101| Los servidores MCP en `.mcp.json` nunca se cargan | El archivo está bajo `.claude/` o usa el formato de configuración de Claude Desktop | La configuración de MCP del proyecto va en la raíz del repositorio como `.mcp.json`, no dentro de `.claude/`. Consulte [configuración de MCP](/es/mcp). |

102| Los servidores MCP agregados bajo `mcpServers` en `settings.json` nunca aparecen | `settings.json` no lee una clave `mcpServers` | Defina servidores de proyecto en `.mcp.json` en la raíz del repositorio, o ejecute `claude mcp add --scope user` para servidores con ámbito de usuario. Consulte [configuración de MCP](/es/mcp). |102| Los servidores MCP agregados bajo `mcpServers` en `settings.json` nunca aparecen | `settings.json` no lee una clave `mcpServers` | Defina servidores de proyecto en `.mcp.json` en la raíz del repositorio, o ejecute `claude mcp add --scope user` para servidores con ámbito de usuario. Consulte [configuración de MCP](/es/mcp). |

desktop.md +2 −1

Details

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

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

4 4

~~5# Usar Claude Code Desktop~~5# Aplicación de escritorio

6 6

7> Aproveche al máximo Claude Code Desktop: sesiones paralelas con aislamiento de Git, diseño de panel de arrastrar y soltar, terminal integrada y editor de archivos, chats laterales, uso de computadora, envíe sesiones desde su teléfono, revisión visual de diferencias, vistas previas de aplicaciones, monitoreo de PR, conectores y configuración empresarial.7> Aproveche al máximo Claude Code Desktop: sesiones paralelas con aislamiento de Git, diseño de panel de arrastrar y soltar, terminal integrada y editor de archivos, chats laterales, uso de computadora, envíe sesiones desde su teléfono, revisión visual de diferencias, vistas previas de aplicaciones, monitoreo de PR, conectores y configuración empresarial.

8 8

707* **Linux**: la aplicación de escritorio está disponible solo en macOS y Windows. En Linux, use la [CLI](/es/quickstart).707* **Linux**: la aplicación de escritorio está disponible solo en macOS y Windows. En Linux, use la [CLI](/es/quickstart).

708* **Sugerencias de código en línea**: Desktop no proporciona sugerencias de estilo autocompletado. Funciona a través de solicitudes conversacionales y cambios de código explícitos.708* **Sugerencias de código en línea**: Desktop no proporciona sugerencias de estilo autocompletado. Funciona a través de solicitudes conversacionales y cambios de código explícitos.

709* **Equipos de agentes**: la orquestación de múltiples agentes está disponible a través de la [CLI](/es/agent-teams) y [Agent SDK](/es/headless), no en Desktop.709* **Equipos de agentes**: la orquestación de múltiples agentes está disponible a través de la [CLI](/es/agent-teams) y [Agent SDK](/es/headless), no en Desktop.

710* **Comandos de diálogo de terminal**: comandos integrados que abren un panel interactivo en la terminal, como `/permissions`, `/config`, `/agents` y `/doctor`, no están disponibles en la pestaña Code y responden con `isn't available in this environment`. Edite [archivos de configuración](/es/settings) directamente para gestionar reglas de permisos y configuración, o ejecute el comando desde la CLI independiente.

710 711

711## Solución de problemas712## Solución de problemas

712 713

discover-plugins.md +3 −1

Details

138 </Step>138 </Step>

139 139

140 <Step title="Instalar un plugin">140 <Step title="Instalar un plugin">

141 Seleccione un plugin para ver sus detalles, luego elija un alcance de instalación:141 Seleccione un plugin para ver sus detalles. {/* min-version: 2.1.143 */}En Claude Code v2.1.143 y posteriores, el panel de detalles incluye una estimación de **Context cost** para que pueda ver cuántos tokens el plugin agregará a su [ventana de contexto](/es/features-overview#understand-context-costs) en cada turno antes de instalarlo.

142

143 Elija un alcance de instalación:

142 144

143 * **User scope**: instale para usted en todos los proyectos145 * **User scope**: instale para usted en todos los proyectos

144 * **Project scope**: instale para todos los colaboradores en este repositorio146 * **Project scope**: instale para todos los colaboradores en este repositorio

env-vars.md +13 −10

Details

100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Establezca en `1` para enrutar la encuesta de calidad de sesión "¿Cómo está funcionando Claude?" a su propio [recopilador de OpenTelemetry](/es/monitoring-usage) cuando el tráfico no esencial vinculado a Anthropic está bloqueado. Las calificaciones de encuesta se emiten solo como eventos OTEL a su recopilador configurado. No se envían datos de encuesta a Anthropic en este modo. Se aplica cuando se establece `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, y no tiene efecto de otra manera. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` y la política de comentarios del producto de la organización tienen precedencia |100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Establezca en `1` para enrutar la encuesta de calidad de sesión "¿Cómo está funcionando Claude?" a su propio [recopilador de OpenTelemetry](/es/monitoring-usage) cuando el tráfico no esencial vinculado a Anthropic está bloqueado. Las calificaciones de encuesta se emiten solo como eventos OTEL a su recopilador configurado. No se envían datos de encuesta a Anthropic en este modo. Se aplica cuando se establece `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, y no tiene efecto de otra manera. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` y la política de comentarios del producto de la organización tienen precedencia |

101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla si las entradas de llamadas de herramientas se transmiten desde la API mientras Claude las genera. Con esto desactivado, una entrada de herramienta grande como una escritura de archivo larga llega solo después de que Claude termina de generarla, lo que puede parecer que se está colgando. Habilitado de forma predeterminada en la API de Anthropic. En Bedrock y Vertex, habilitado por modelo donde el contenedor implementado lo admite. Establezca en `0` para optar por no participar. Establezca en `1` para forzar la habilitación cuando se enruta a través de un proxy a través de `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Desactivado de forma predeterminada en Foundry y conexiones de [puerta de enlace](/es/llm-gateway) |101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controla si las entradas de llamadas de herramientas se transmiten desde la API mientras Claude las genera. Con esto desactivado, una entrada de herramienta grande como una escritura de archivo larga llega solo después de que Claude termina de generarla, lo que puede parecer que se está colgando. Habilitado de forma predeterminada en la API de Anthropic. En Bedrock y Vertex, habilitado por modelo donde el contenedor implementado lo admite. Establezca en `0` para optar por no participar. Establezca en `1` para forzar la habilitación cuando se enruta a través de un proxy a través de `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Desactivado de forma predeterminada en Foundry y conexiones de [puerta de enlace](/es/llm-gateway) |

102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Establezca en `1` para rellenar el selector `/model` desde el endpoint `/v1/models` de su puerta de enlace cuando `ANTHROPIC_BASE_URL` apunta a una puerta de enlace compatible con Anthropic como LiteLLM, Kong o un proxy interno. Desactivado de forma predeterminada porque las puertas de enlace respaldadas por una clave de API compartida de otra manera mostrarían a cada usuario cada modelo que la clave puede acceder. Los modelos descubiertos aún se filtran por la lista de permitidos [`availableModels`](/es/settings#available-settings) |102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Establezca en `1` para rellenar el selector `/model` desde el endpoint `/v1/models` de su puerta de enlace cuando `ANTHROPIC_BASE_URL` apunta a una puerta de enlace compatible con Anthropic como LiteLLM, Kong o un proxy interno. Desactivado de forma predeterminada porque las puertas de enlace respaldadas por una clave de API compartida de otra manera mostrarían a cada usuario cada modelo que la clave puede acceder. Los modelos descubiertos aún se filtran por la lista de permitidos [`availableModels`](/es/settings#available-settings) |

103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Establezca en `1` para ejecutar [modo rápido](/es/fast-mode) en Claude Opus 4.7 en lugar de Opus 4.6. Con la variable establecida, `/fast` cambia a Opus 4.7; sin ella, `/fast` continúa usando Opus 4.6 |103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Eliminado en v2.1.142. [Modo rápido](/es/fast-mode) utiliza Opus 4.7 de forma predeterminada. Establezca `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` para mantener Opus 4.6 en su lugar |

104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Establezca en `false` para deshabilitar sugerencias de indicador (el toggle "Prompt suggestions" en `/config`). Estas son las predicciones atenuadas que aparecen en su entrada de indicador después de que Claude responda. Consulte [Sugerencias de indicador](/es/interactive-mode#prompt-suggestions) |104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Establezca en `false` para deshabilitar sugerencias de indicador (el toggle "Prompt suggestions" en `/config`). Estas son las predicciones atenuadas que aparecen en su entrada de indicador después de que Claude responda. Consulte [Sugerencias de indicador](/es/interactive-mode#prompt-suggestions) |

105| `CLAUDE_CODE_ENABLE_TASKS` | Establezca en `1` para habilitar el sistema de seguimiento de tareas en modo no interactivo (la bandera `-p`). Las tareas están activadas de forma predeterminada en modo interactivo. Consulte [Lista de tareas](/es/interactive-mode#task-list) |105| `CLAUDE_CODE_ENABLE_TASKS` | Controla si las sesiones utilizan las herramientas Task estructuradas (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) o la herramienta legacy `TodoWrite`. {/* min-version: 2.1.142 */}A partir de Claude Code v2.1.142, las herramientas Task son el valor predeterminado en todos los modos. Establezca en `0` para revertir a `TodoWrite`. Consulte [Lista de tareas](/es/interactive-mode#task-list) y [Migrar a herramientas Task](/es/agent-sdk/todo-tracking#migrate-to-task-tools) |

106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Establezca en `1` para habilitar la recopilación de datos de OpenTelemetry para métricas y registro. Requerido antes de configurar exportadores de OTel. Consulte [Monitoreo](/es/monitoring-usage) |106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Establezca en `1` para habilitar la recopilación de datos de OpenTelemetry para métricas y registro. Requerido antes de configurar exportadores de OTel. Consulte [Monitoreo](/es/monitoring-usage) |

107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tiempo en milisegundos a esperar después de que el bucle de consulta se vuelva inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que utilizan modo SDK |107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tiempo en milisegundos a esperar después de que el bucle de consulta se vuelva inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que utilizan modo SDK |

108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Establezca en `1` para habilitar [equipos de agentes](/es/agent-teams). Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada |108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Establezca en `1` para habilitar [equipos de agentes](/es/agent-teams). Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada |

130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de actualización de OAuth para autenticación de Claude.ai. Cuando se establece, `claude auth login` intercambia este token directamente en lugar de abrir un navegador. Requiere `CLAUDE_CODE_OAUTH_SCOPES`. Útil para aprovisionar autenticación en entornos automatizados |130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token de actualización de OAuth para autenticación de Claude.ai. Cuando se establece, `claude auth login` intercambia este token directamente en lugar de abrir un navegador. Requiere `CLAUDE_CODE_OAUTH_SCOPES`. Útil para aprovisionar autenticación en entornos automatizados |

131| `CLAUDE_CODE_OAUTH_SCOPES` | Alcances de OAuth separados por espacios con los que se emitió el token de actualización, como `"user:profile user:inference user:sessions:claude_code"`. Requerido cuando se establece `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |131| `CLAUDE_CODE_OAUTH_SCOPES` | Alcances de OAuth separados por espacios con los que se emitió el token de actualización, como `"user:profile user:inference user:sessions:claude_code"`. Requerido cuando se establece `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |

132| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acceso de OAuth para autenticación de Claude.ai. Alternativa a `/login` para SDK y entornos automatizados. Tiene precedencia sobre credenciales almacenadas en llavero. Genere uno con [`claude setup-token`](/es/authentication#generate-a-long-lived-token) |132| `CLAUDE_CODE_OAUTH_TOKEN` | Token de acceso de OAuth para autenticación de Claude.ai. Alternativa a `/login` para SDK y entornos automatizados. Tiene precedencia sobre credenciales almacenadas en llavero. Genere uno con [`claude setup-token`](/es/authentication#generate-a-long-lived-token) |

133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Establezca en `1` para mantener [modo rápido](/es/fast-mode) en Claude Opus 4.6. Tiene precedencia sobre `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`, por lo que establezca esto si necesita fijar Opus 4.6 independientemente de cómo cambie el valor predeterminado |133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Establezca en `1` para fijar [modo rápido](/es/fast-mode) a Claude Opus 4.6 en lugar del Opus 4.7 predeterminado. Con la variable establecida, `/fast` se ejecuta en Opus 4.6. Sin ella, `/fast` se ejecuta en Opus 4.7 |

134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tiempo de espera en milisegundos para vaciar spans de OpenTelemetry pendientes (predeterminado: 5000). Consulte [Monitoreo](/es/monitoring-usage) |134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tiempo de espera en milisegundos para vaciar spans de OpenTelemetry pendientes (predeterminado: 5000). Consulte [Monitoreo](/es/monitoring-usage) |

135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para actualizar encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulte [Encabezados dinámicos](/es/monitoring-usage#dynamic-headers) |135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervalo para actualizar encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulte [Encabezados dinámicos](/es/monitoring-usage#dynamic-headers) |

136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagar (predeterminado: 2000). Aumente si las métricas se descartan al salir. Consulte [Monitoreo](/es/monitoring-usage) |136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagar (predeterminado: 2000). Aumente si las métricas se descartan al salir. Consulte [Monitoreo](/es/monitoring-usage) |

141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Establezca en `1` para mantener el caché de marketplace existente cuando un `git pull` falla en lugar de borrar y volver a clonar. Útil en entornos sin conexión o aislados donde volver a clonar fallaría de la misma manera. Consulte [Las actualizaciones de Marketplace fallan en entornos sin conexión](/es/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Establezca en `1` para mantener el caché de marketplace existente cuando un `git pull` falla en lugar de borrar y volver a clonar. Útil en entornos sin conexión o aislados donde volver a clonar fallaría de la misma manera. Consulte [Las actualizaciones de Marketplace fallan en entornos sin conexión](/es/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Establezca en `1` para clonar fuentes de plugins de GitHub `owner/repo` sobre HTTPS en lugar de SSH. Útil en ejecutores de CI, contenedores o cualquier entorno sin una clave SSH configurada para `github.com` |142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Establezca en `1` para clonar fuentes de plugins de GitHub `owner/repo` sobre HTTPS en lugar de SSH. Útil en ejecutores de CI, contenedores o cualquier entorno sin una clave SSH configurada para `github.com` |

143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Ruta a uno o más directorios de semilla de plugins de solo lectura, separados por `:` en Unix o `;` en Windows. Utilice esto para agrupar un directorio de plugins previamente poblado en una imagen de contenedor. Claude Code registra mercados desde estos directorios al inicio y utiliza plugins almacenados en caché previamente sin volver a clonar. Consulte [Pre-popular plugins para contenedores](/es/plugin-marketplaces#pre-populate-plugins-for-containers) |143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Ruta a uno o más directorios de semilla de plugins de solo lectura, separados por `:` en Unix o `;` en Windows. Utilice esto para agrupar un directorio de plugins previamente poblado en una imagen de contenedor. Claude Code registra mercados desde estos directorios al inicio y utiliza plugins almacenados en caché previamente sin volver a clonar. Consulte [Pre-popular plugins para contenedores](/es/plugin-marketplaces#pre-populate-plugins-for-containers) |

144| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Establezca en `1` para dejar de pasar `-ExecutionPolicy Bypass` a Claude Code cuando genera PowerShell para llamadas de herramientas, hooks y comandos de línea de estado, y respete la política de ejecución efectiva de la máquina en su lugar. De forma predeterminada, Claude Code omite la política de ejecución en el ámbito del proceso para que scripts `.ps1` e importaciones de módulos funcionen en instalaciones de Windows predeterminadas restringidas. El bypass de ámbito de proceso nunca anula la Política de Grupo `MachinePolicy` o `UserPolicy` independientemente de esta configuración |

144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Se establece por plataformas host que incrustan Claude Code y administran el enrutamiento del proveedor de modelo en su nombre. Cuando se establece, la selección de proveedor, endpoint y variables de autenticación como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` y `ANTHROPIC_API_KEY` en archivos de configuración se ignoran para que la configuración del usuario no pueda anular el enrutamiento del host. La opción de exclusión automática de telemetría para Bedrock, Vertex y Foundry también se omite, por lo que la telemetría sigue la opción de exclusión estándar `DISABLE_TELEMETRY`. Consulte [Comportamientos predeterminados por proveedor de API](/es/data-usage#default-behaviors-by-api-provider) |145| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Se establece por plataformas host que incrustan Claude Code y administran el enrutamiento del proveedor de modelo en su nombre. Cuando se establece, la selección de proveedor, endpoint y variables de autenticación como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` y `ANTHROPIC_API_KEY` en archivos de configuración se ignoran para que la configuración del usuario no pueda anular el enrutamiento del host. La opción de exclusión automática de telemetría para Bedrock, Vertex y Foundry también se omite, por lo que la telemetría sigue la opción de exclusión estándar `DISABLE_TELEMETRY`. Consulte [Comportamientos predeterminados por proveedor de API](/es/data-usage#default-behaviors-by-api-provider) |

145| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Establezca en `1` para permitir que el proxy realice la resolución de DNS en lugar de la persona que llama. Opción de inclusión para entornos donde el proxy debe manejar la resolución de nombres de host |146| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Establezca en `1` para permitir que el proxy realice la resolución de DNS en lugar de la persona que llama. Opción de inclusión para entornos donde el proxy debe manejar la resolución de nombres de host |

146| `CLAUDE_CODE_REMOTE` | Se establece automáticamente en `true` cuando Claude Code se ejecuta como una [sesión en la nube](/es/claude-code-on-the-web). Lea esto desde un hook o script de configuración para detectar si se encuentra en un entorno en la nube |147| `CLAUDE_CODE_REMOTE` | Se establece automáticamente en `true` cuando Claude Code se ejecuta como una [sesión en la nube](/es/claude-code-on-the-web). Lea esto desde un hook o script de configuración para detectar si se encuentra en un entorno en la nube |

153| `CLAUDE_CODE_SESSION_ID` | Se establece automáticamente en subprocesos de herramientas Bash y PowerShell en el ID de sesión actual. Coincide con el campo `session_id` pasado a [hooks](/es/hooks). Se actualiza en `/clear`. Utilice para correlacionar scripts y herramientas externas con la sesión de Claude Code que las lanzó |154| `CLAUDE_CODE_SESSION_ID` | Se establece automáticamente en subprocesos de herramientas Bash y PowerShell en el ID de sesión actual. Coincide con el campo `session_id` pasado a [hooks](/es/hooks). Se actualiza en `/clear`. Utilice para correlacionar scripts y herramientas externas con la sesión de Claude Code que las lanzó |

154| `CLAUDE_CODE_SHELL` | Anule la detección automática de shell. Útil cuando su shell de inicio difiere de su shell de trabajo preferido (por ejemplo, `bash` vs `zsh`) |155| `CLAUDE_CODE_SHELL` | Anule la detección automática de shell. Útil cuando su shell de inicio difiere de su shell de trabajo preferido (por ejemplo, `bash` vs `zsh`) |

155| `CLAUDE_CODE_SHELL_PREFIX` | Prefijo de comando que envuelve comandos shell que Claude Code genera: llamadas de herramienta Bash, comandos [hook](/es/hooks) y comandos de inicio de [servidor MCP](/es/mcp) stdio. Útil para registro o auditoría. Ejemplo: establecer `/path/to/logger.sh` ejecuta cada comando como `/path/to/logger.sh <command>` |156| `CLAUDE_CODE_SHELL_PREFIX` | Prefijo de comando que envuelve comandos shell que Claude Code genera: llamadas de herramienta Bash, comandos [hook](/es/hooks) y comandos de inicio de [servidor MCP](/es/mcp) stdio. Útil para registro o auditoría. Ejemplo: establecer `/path/to/logger.sh` ejecuta cada comando como `/path/to/logger.sh <command>` |

156| `CLAUDE_CODE_SIMPLE` | Establezca en `1` para ejecutar con un indicador del sistema mínimo y solo las herramientas Bash, lectura de archivo y edición de archivo. Las herramientas MCP de `--mcp-config` siguen estando disponibles. Deshabilita el descubrimiento automático de hooks, skills, plugins, servidores MCP, memoria automática y CLAUDE.md. La bandera CLI [`--bare`](/es/headless#start-faster-with-bare-mode) establece esto |157| `CLAUDE_CODE_SIMPLE` | Establezca en `1` para ejecutar con un indicador del sistema mínimo y solo las herramientas Bash, lectura de archivo y edición de archivo. Las herramientas MCP de `--mcp-config` siguen estando disponibles. Deshabilita el descubrimiento automático de hooks, skills, plugins, servidores MCP, memoria automática y CLAUDE.md. OAuth tokens y credenciales de llavero no se leen, por lo que la autenticación de Anthropic debe provenir de `ANTHROPIC_API_KEY` o un `apiKeyHelper` en `--settings`. Equivalente a pasar [`--bare`](/es/headless#start-faster-with-bare-mode) |

157| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Establezca en `1` para utilizar un indicador del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establezca en `0`, `false`, `no` u `off` para optar por no participar incluso en modelos donde el experimento o la configuración del servidor lo habilitaría de otra manera. El conjunto completo de herramientas, hooks, servidores MCP y descubrimiento de CLAUDE.md permanecen habilitados |158| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Establezca en `1` para utilizar un indicador del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establezca en `0`, `false`, `no` u `off` para optar por no participar incluso en modelos donde el experimento o la configuración del servidor lo habilitaría de otra manera. El conjunto completo de herramientas, hooks, servidores MCP y descubrimiento de CLAUDE.md permanecen habilitados |

158| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Omita la autenticación del lado del cliente para [Claude Platform on AWS](/es/claude-platform-on-aws), para puertas de enlace que firman solicitudes por sí mismas |159| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Omita la autenticación del lado del cliente para [Claude Platform on AWS](/es/claude-platform-on-aws), para puertas de enlace que firman solicitudes por sí mismas |

159| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Omita la autenticación de AWS para Bedrock (por ejemplo, cuando se utiliza una puerta de enlace LLM) |160| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Omita la autenticación de AWS para Bedrock (por ejemplo, cuando se utiliza una puerta de enlace LLM) |

161| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Omita la autenticación de AWS para Bedrock Mantle (por ejemplo, cuando se utiliza una puerta de enlace LLM) |162| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Omita la autenticación de AWS para Bedrock Mantle (por ejemplo, cuando se utiliza una puerta de enlace LLM) |

162| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Establezca en `1` para omitir escribir historial de indicadores y transcripciones de sesiones en disco. Las sesiones iniciadas con esta variable establecida no aparecen en `--resume`, `--continue` o historial de flecha hacia arriba. Útil para sesiones con scripts efímeros |163| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Establezca en `1` para omitir escribir historial de indicadores y transcripciones de sesiones en disco. Las sesiones iniciadas con esta variable establecida no aparecen en `--resume`, `--continue` o historial de flecha hacia arriba. Útil para sesiones con scripts efímeros |

163| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Omita la autenticación de Google para Vertex (por ejemplo, cuando se utiliza una puerta de enlace LLM) |164| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Omita la autenticación de Google para Vertex (por ejemplo, cuando se utiliza una puerta de enlace LLM) |

165| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de veces consecutivas que un hook [Stop](/es/hooks#stop) o [SubagentStop](/es/hooks#subagentstop) puede bloquear el final del turno antes de que Claude Code lo anule y termine el turno de todas formas (predeterminado: 8). Establezca en `0` para deshabilitar el límite. Aumente esto si su hook legítimamente necesita más iteraciones para resolver |

165| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Establezca en `1` para eliminar credenciales de Anthropic y proveedores de nube de entornos de subprocesos (herramienta Bash, hooks, servidores MCP stdio). El proceso Claude principal mantiene estas credenciales para llamadas de API, pero los procesos secundarios no pueden leerlas, reduciendo la exposición a ataques de inyección de indicadores que intentan exfiltrar secretos a través de expansión de shell. En Linux, esto también ejecuta subprocesos Bash en un espacio de nombres PID aislado para que no puedan leer entornos de procesos de host a través de `/proc`; como efecto secundario, `ps`, `pgrep` y `kill` no pueden ver ni señalar procesos de host. `claude-code-action` establece esto automáticamente cuando se configura `allowed_non_write_users` |167| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Establezca en `1` para eliminar credenciales de Anthropic y proveedores de nube de entornos de subprocesos (herramienta Bash, hooks, servidores MCP stdio). El proceso Claude principal mantiene estas credenciales para llamadas de API, pero los procesos secundarios no pueden leerlas, reduciendo la exposición a ataques de inyección de indicadores que intentan exfiltrar secretos a través de expansión de shell. En Linux, esto también ejecuta subprocesos Bash en un espacio de nombres PID aislado para que no puedan leer entornos de procesos de host a través de `/proc`; como efecto secundario, `ps`, `pgrep` y `kill` no pueden ver ni señalar procesos de host. `claude-code-action` establece esto automáticamente cuando se configura `allowed_non_write_users` |

166| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Establezca en `1` en modo no interactivo (la bandera `-p`) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y pueden no estar disponibles en el primer turno. Combine con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar la espera |168| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Establezca en `1` en modo no interactivo (la bandera `-p`) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y pueden no estar disponibles en el primer turno. Combine con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar la espera |

180| `CLAUDE_CONFIG_DIR` | Anule el directorio de configuración (predeterminado: `~/.claude`). Todos los ajustes, credenciales, historial de sesiones y plugins se almacenan bajo esta ruta. Útil para ejecutar múltiples cuentas lado a lado: por ejemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |182| `CLAUDE_CONFIG_DIR` | Anule el directorio de configuración (predeterminado: `~/.claude`). Todos los ajustes, credenciales, historial de sesiones y plugins se almacenan bajo esta ruta. Útil para ejecutar múltiples cuentas lado a lado: por ejemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

181| `CLAUDE_EFFORT` | Se establece automáticamente en subprocesos de herramientas Bash y comandos hook en el [nivel de esfuerzo](/es/model-config#adjust-effort-level) activo para el turno: `low`, `medium`, `high`, `xhigh` o `max`. Coincide con el campo `effort.level` pasado a [hooks](/es/hooks). Solo se establece cuando el modelo actual admite el parámetro de esfuerzo |183| `CLAUDE_EFFORT` | Se establece automáticamente en subprocesos de herramientas Bash y comandos hook en el [nivel de esfuerzo](/es/model-config#adjust-effort-level) activo para el turno: `low`, `medium`, `high`, `xhigh` o `max`. Coincide con el campo `effort.level` pasado a [hooks](/es/hooks). Solo se establece cuando el modelo actual admite el parámetro de esfuerzo |

182| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Establezca en `1` para forzar la habilitación del perro guardián de inactividad de transmisión a nivel de byte, o establezca en `0` para forzar su deshabilitación. Cuando no se establece, el perro guardián se habilita de forma predeterminada para conexiones de API de Anthropic. El perro guardián de byte aborta una conexión cuando no llegan bytes en el cable durante la duración establecida por `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, con un mínimo de 5 minutos, independientemente del perro guardián a nivel de evento |184| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Establezca en `1` para forzar la habilitación del perro guardián de inactividad de transmisión a nivel de byte, o establezca en `0` para forzar su deshabilitación. Cuando no se establece, el perro guardián se habilita de forma predeterminada para conexiones de API de Anthropic. El perro guardián de byte aborta una conexión cuando no llegan bytes en el cable durante la duración establecida por `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, con un mínimo de 5 minutos, independientemente del perro guardián a nivel de evento |

183| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Establezca en `1` para habilitar el perro guardián de inactividad de transmisión a nivel de evento. Desactivado de forma predeterminada. Para Bedrock, Vertex y Foundry, este es el único perro guardián de inactividad disponible. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |185| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Establezca en `1` para habilitar el perro guardián de inactividad de transmisión a nivel de byte en respuestas `vnd.amazon.eventstream` de Amazon Bedrock. Desactivado de forma predeterminada. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

186| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Establezca en `1` para habilitar el perro guardián de inactividad de transmisión a nivel de evento. Desactivado de forma predeterminada. Se aplica a todos los proveedores, incluido Bedrock. Para Vertex y Foundry, este es el único perro guardián de inactividad disponible. En Bedrock, también puede habilitar el perro guardián independiente a nivel de byte con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; los dos se ejecutan juntos cuando ambos se establecen. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

184| `CLAUDE_ENV_FILE` | Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando Bash en el mismo proceso de shell, por lo que las exportaciones en el archivo son visibles para el comando. Utilice para persistir la activación de virtualenv o conda entre comandos. También se completa dinámicamente por hooks [SessionStart](/es/hooks#persist-environment-variables), [Setup](/es/hooks#setup), [CwdChanged](/es/hooks#cwdchanged) y [FileChanged](/es/hooks#filechanged) |187| `CLAUDE_ENV_FILE` | Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando Bash en el mismo proceso de shell, por lo que las exportaciones en el archivo son visibles para el comando. Utilice para persistir la activación de virtualenv o conda entre comandos. También se completa dinámicamente por hooks [SessionStart](/es/hooks#persist-environment-variables), [Setup](/es/hooks#setup), [CwdChanged](/es/hooks#cwdchanged) y [FileChanged](/es/hooks#filechanged) |

185| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefijo para nombres de sesión de [Control Remoto](/es/remote-control) generados automáticamente cuando no se proporciona un nombre explícito. El valor predeterminado es el nombre de host de su máquina, produciendo nombres como `myhost-graceful-unicorn`. La bandera CLI `--remote-control-session-name-prefix` establece el mismo valor para una única invocación |188| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefijo para nombres de sesión de [Control Remoto](/es/remote-control) generados automáticamente cuando no se proporciona un nombre explícito. El valor predeterminado es el nombre de host de su máquina, produciendo nombres como `myhost-graceful-unicorn`. La bandera CLI `--remote-control-session-name-prefix` establece el mismo valor para una única invocación |

186| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Tiempo de espera en milisegundos antes de que el perro guardián de inactividad de transmisión cierre una conexión estancada. Predeterminado y mínimo `300000` (5 minutos) para ambos perros guardianes a nivel de byte y a nivel de evento; los valores más bajos se fijan silenciosamente para absorber pausas de pensamiento extendido y almacenamiento en búfer de proxy. Para proveedores de terceros, requiere `CLAUDE_ENABLE_STREAM_WATCHDOG=1` |189| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Tiempo de espera en milisegundos antes de que el perro guardián de inactividad de transmisión cierre una conexión estancada. Predeterminado y mínimo `300000` (5 minutos) para ambos perros guardianes a nivel de byte y a nivel de evento; los valores más bajos se fijan silenciosamente para absorber pausas de pensamiento extendido y almacenamiento en búfer de proxy. Para proveedores de terceros, requiere `CLAUDE_ENABLE_STREAM_WATCHDOG=1`. En Bedrock, también se aplica cuando `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

187| `DEBUG` | Establezca en `1` para habilitar el modo de depuración, equivalente a lanzar con [`--debug`](/es/cli-reference#cli-flags). Los registros de depuración se escriben en `~/.claude/debug/<session-id>.txt`, o en la ruta establecida por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo los valores verdaderos `1`, `true`, `yes` y `on` habilitan el modo de depuración, por lo que patrones de espacio de nombres como `DEBUG=express:*` establecidos para otras herramientas no lo activan |190| `DEBUG` | Establezca en `1` para habilitar el modo de depuración, equivalente a lanzar con [`--debug`](/es/cli-reference#cli-flags). Los registros de depuración se escriben en `~/.claude/debug/<session-id>.txt`, o en la ruta establecida por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo los valores verdaderos `1`, `true`, `yes` y `on` habilitan el modo de depuración, por lo que patrones de espacio de nombres como `DEBUG=express:*` establecidos para otras herramientas no lo activan |

188| `DISABLE_AUTOUPDATER` | Establezca en `1` para deshabilitar actualizaciones automáticas en segundo plano. El comando manual `claude update` sigue funcionando. Use `DISABLE_UPDATES` para bloquear ambos |191| `DISABLE_AUTOUPDATER` | Establezca en `1` para deshabilitar actualizaciones automáticas en segundo plano. El comando manual `claude update` sigue funcionando. Use `DISABLE_UPDATES` para bloquear ambos |

189| `DISABLE_AUTO_COMPACT` | Establezca en `1` para deshabilitar la compactación automática cuando se aproxime al límite de contexto. El comando manual `/compact` sigue estando disponible. Utilice cuando desee control explícito sobre cuándo ocurre la compactación |192| `DISABLE_AUTO_COMPACT` | Establezca en `1` para deshabilitar la compactación automática cuando se aproxime al límite de contexto. El comando manual `/compact` sigue estando disponible. Utilice cuando desee control explícito sobre cuándo ocurre la compactación |

192| `DISABLE_DOCTOR_COMMAND` | Establezca en `1` para ocultar el comando `/doctor`. Útil para despliegues administrados donde los usuarios no deben ejecutar diagnósticos de instalación |195| `DISABLE_DOCTOR_COMMAND` | Establezca en `1` para ocultar el comando `/doctor`. Útil para despliegues administrados donde los usuarios no deben ejecutar diagnósticos de instalación |

194| `DISABLE_EXTRA_USAGE_COMMAND` | Establezca en `1` para ocultar el comando `/extra-usage` que permite a los usuarios comprar uso adicional más allá de los límites de velocidad |197| `DISABLE_EXTRA_USAGE_COMMAND` | Establezca en `1` para ocultar el comando `/usage-credits` que permite a los usuarios comprar uso adicional más allá de los límites de velocidad |

195| `DISABLE_FEEDBACK_COMMAND` | Establezca en `1` para deshabilitar el comando `/feedback`. El nombre anterior `DISABLE_BUG_COMMAND` también se acepta |198| `DISABLE_FEEDBACK_COMMAND` | Establezca en `1` para deshabilitar el comando `/feedback`. El nombre anterior `DISABLE_BUG_COMMAND` también se acepta |

196| `DISABLE_GROWTHBOOK` | Establezca en `1` para deshabilitar la obtención de banderas de características de GrowthBook y utilizar valores predeterminados de código para cada bandera. El registro de eventos de telemetría permanece activado a menos que `DISABLE_TELEMETRY` también esté establecido |199| `DISABLE_GROWTHBOOK` | Establezca en `1` para deshabilitar la obtención de banderas de características de GrowthBook y utilizar valores predeterminados de código para cada bandera. El registro de eventos de telemetría permanece activado a menos que `DISABLE_TELEMETRY` también esté establecido |

197| `DISABLE_INSTALLATION_CHECKS` | Establezca en `1` para deshabilitar advertencias de instalación. Utilice solo cuando administre manualmente la ubicación de instalación, ya que esto puede enmascarar problemas con instalaciones estándar |200| `DISABLE_INSTALLATION_CHECKS` | Establezca en `1` para deshabilitar advertencias de instalación. Utilice solo cuando administre manualmente la ubicación de instalación, ya que esto puede enmascarar problemas con instalaciones estándar |

210| `ENABLE_CLAUDEAI_MCP_SERVERS` | Establezca en `false` para deshabilitar [servidores MCP de claude.ai](/es/mcp#use-mcp-servers-from-claude-ai) en Claude Code. Habilitado de forma predeterminada para usuarios conectados |213| `ENABLE_CLAUDEAI_MCP_SERVERS` | Establezca en `false` para deshabilitar [servidores MCP de claude.ai](/es/mcp#use-mcp-servers-from-claude-ai) en Claude Code. Habilitado de forma predeterminada para usuarios conectados |

211| `ENABLE_PROMPT_CACHING_1H` | Establezca en `1` para solicitar un TTL de caché de indicador de 1 hora en lugar de los 5 minutos predeterminados. Destinado a usuarios de clave de API, [Bedrock](/es/amazon-bedrock), [Vertex](/es/google-vertex-ai), [Foundry](/es/microsoft-foundry) y [Claude Platform on AWS](/es/claude-platform-on-aws). Los usuarios de suscripción reciben TTL de 1 hora automáticamente. Las escrituras de caché de 1 hora se facturan a una tasa más alta |214| `ENABLE_PROMPT_CACHING_1H` | Establezca en `1` para solicitar un TTL de caché de indicador de 1 hora en lugar de los 5 minutos predeterminados. Destinado a usuarios de clave de API, [Bedrock](/es/amazon-bedrock), [Vertex](/es/google-vertex-ai), [Foundry](/es/microsoft-foundry) y [Claude Platform on AWS](/es/claude-platform-on-aws). Los usuarios de suscripción reciben TTL de 1 hora automáticamente. Las escrituras de caché de 1 hora se facturan a una tasa más alta |

213| `ENABLE_TOOL_SEARCH` | Controla [búsqueda de herramientas MCP](/es/mcp#scale-with-mcp-tool-search). Sin establecer: todas las herramientas MCP diferidas de forma predeterminada, pero cargadas por adelantado en Vertex AI o cuando `ANTHROPIC_BASE_URL` apunta a un host que no es de primera parte. Valores: `true` (siempre diferir e incluir el encabezado beta, las solicitudes fallan en Vertex AI o proxies que no admiten `tool_reference`), `auto` (modo de umbral: cargar por adelantado si las herramientas caben dentro del 10% del contexto), `auto:N` (umbral personalizado, p. ej., `auto:5` para 5%), `false` (cargar todo por adelantado) |216| `ENABLE_TOOL_SEARCH` | Controla [búsqueda de herramientas MCP](/es/mcp#scale-with-mcp-tool-search). Sin establecer: todas las herramientas MCP diferidas de forma predeterminada, pero cargadas por adelantado en Vertex AI o cuando `ANTHROPIC_BASE_URL` apunta a un host que no es de primera parte. Valores: `true` (siempre diferir e incluir el encabezado beta, las solicitudes fallan en modelos de Vertex AI anteriores a Sonnet 4.5 u Opus 4.5, o en proxies que no admiten `tool_reference`), `auto` (modo de umbral: cargar por adelantado si las herramientas caben dentro del 10% del contexto), `auto:N` (umbral personalizado, p. ej., `auto:5` para 5%), `false` (cargar todo por adelantado) |

214| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Establezca en cualquier valor no vacío para activar el respaldo a [`--fallback-model`](/es/cli-reference#cli-flags) después de errores de sobrecarga repetidos en cualquier modelo principal. De forma predeterminada, solo los modelos Opus activan el respaldo |217| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Establezca en cualquier valor no vacío para activar el respaldo a [`--fallback-model`](/es/cli-reference#cli-flags) después de errores de sobrecarga repetidos en cualquier modelo principal. De forma predeterminada, solo los modelos Opus activan el respaldo |

215| `FORCE_AUTOUPDATE_PLUGINS` | Establezca en `1` para forzar actualizaciones automáticas de plugins incluso cuando el actualizador automático principal está deshabilitado mediante `DISABLE_AUTOUPDATER` |218| `FORCE_AUTOUPDATE_PLUGINS` | Establezca en `1` para forzar actualizaciones automáticas de plugins incluso cuando el actualizador automático principal está deshabilitado mediante `DISABLE_AUTOUPDATER` |

216| `FORCE_PROMPT_CACHING_5M` | Establezca en `1` para forzar el TTL de caché de indicador de 5 minutos incluso cuando el TTL de 1 hora se aplicaría de otra manera. Anula `ENABLE_PROMPT_CACHING_1H` |219| `FORCE_PROMPT_CACHING_5M` | Establezca en `1` para forzar el TTL de caché de indicador de 5 minutos incluso cuando el TTL de 1 hora se aplicaría de otra manera. Anula `ENABLE_PROMPT_CACHING_1H` |

221| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de veces para reintentar cuando la respuesta del modelo falla la validación contra el [`--json-schema`](/es/cli-reference#cli-flags) en modo no interactivo (la bandera `-p`). El valor predeterminado es 5 |224| `MAX_STRUCTURED_OUTPUT_RETRIES` | Número de veces para reintentar cuando la respuesta del modelo falla la validación contra el [`--json-schema`](/es/cli-reference#cli-flags) en modo no interactivo (la bandera `-p`). El valor predeterminado es 5 |

222| `MAX_THINKING_TOKENS` | Anule el presupuesto de tokens de [pensamiento extendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). El techo es el [máximo de tokens de salida](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) del modelo menos uno. Establezca en `0` para deshabilitar el pensamiento completamente. En modelos con [razonamiento adaptativo](/es/model-config#adjust-effort-level), el presupuesto se ignora a menos que el razonamiento adaptativo esté deshabilitado a través de `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |225| `MAX_THINKING_TOKENS` | Anule el presupuesto de tokens de [pensamiento extendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). El techo es el [máximo de tokens de salida](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) del modelo menos uno. Establezca en `0` para deshabilitar el pensamiento completamente. En modelos con [razonamiento adaptativo](/es/model-config#adjust-effort-level), el presupuesto se ignora a menos que el razonamiento adaptativo esté deshabilitado a través de `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |

223| `MCP_CLIENT_SECRET` | Secreto de cliente OAuth para servidores MCP que requieren [credenciales preconfiguradas](/es/mcp#use-pre-configured-oauth-credentials). Evita el indicador interactivo al agregar un servidor con `--client-secret` |226| `MCP_CLIENT_SECRET` | Secreto de cliente OAuth para servidores MCP que requieren [credenciales preconfiguradas](/es/mcp#use-pre-configured-oauth-credentials). Evita el indicador interactivo al agregar un servidor con `--client-secret` |

224| `MCP_CONNECTION_NONBLOCKING` | Establezca en `true` en modo no interactivo (`-p`) para omitir completamente la espera de conexión MCP. Útil para canalizaciones con scripts donde las herramientas MCP no son necesarias. Sin esta variable, la primera consulta espera hasta 5 segundos para que se conecten los servidores `--mcp-config`. Los servidores configurados con [`alwaysLoad: true`](/es/mcp#exempt-a-server-from-deferral) siempre bloquean el inicio independientemente de esta variable, ya que sus herramientas deben estar presentes cuando se construye el primer indicador |227| `MCP_CONNECTION_NONBLOCKING` | Controla si el inicio espera a que se conecten los servidores MCP antes de la primera consulta. {/* min-version: 2.1.142 */}A partir de Claude Code v2.1.142, el inicio de MCP es no bloqueante de forma predeterminada: los servidores se conectan en segundo plano y sus herramientas se vuelven disponibles a medida que terminan. Establezca en `0` para restaurar la espera de conexión bloqueante de 5 segundos. Los servidores configurados con [`alwaysLoad: true`](/es/mcp#exempt-a-server-from-deferral) siguen bloqueando el inicio independientemente, ya que sus herramientas deben estar presentes cuando se construye el primer indicador |

225| `MCP_CONNECT_TIMEOUT_MS` | Cuánto tiempo espera la primera consulta, en milisegundos, para que se complete el lote de conexión MCP antes de tomar una instantánea de la lista de herramientas (predeterminado: 5000). Los servidores aún pendientes en la fecha límite continúan conectándose en segundo plano pero no aparecerán hasta la siguiente consulta. Distinto de `MCP_TIMEOUT`, que limita el intento de conexión de un servidor individual. Más relevante para sesiones no interactivas que emiten una única consulta y necesitan que servidores de conexión lenta sean visibles |228| `MCP_CONNECT_TIMEOUT_MS` | Cuánto tiempo espera el inicio bloqueante de MCP, en milisegundos, para que se complete el lote de conexión antes de tomar una instantánea de la lista de herramientas (predeterminado: 5000). Se aplica cuando `MCP_CONNECTION_NONBLOCKING=0` o para servidores marcados [`alwaysLoad: true`](/es/mcp#exempt-a-server-from-deferral). Los servidores aún pendientes en la fecha límite continúan conectándose en segundo plano pero no aparecerán hasta la siguiente consulta. Distinto de `MCP_TIMEOUT`, que limita el intento de conexión de un servidor individual |

226| `MCP_OAUTH_CALLBACK_PORT` | Puerto fijo para la devolución de llamada de redirección de OAuth, como alternativa a `--callback-port` al agregar un servidor MCP con [credenciales preconfiguradas](/es/mcp#use-pre-configured-oauth-credentials) |229| `MCP_OAUTH_CALLBACK_PORT` | Puerto fijo para la devolución de llamada de redirección de OAuth, como alternativa a `--callback-port` al agregar un servidor MCP con [credenciales preconfiguradas](/es/mcp#use-pre-configured-oauth-credentials) |

227| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) para conectar en paralelo durante el inicio (predeterminado: 20) |230| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP remotos (HTTP/SSE) para conectar en paralelo durante el inicio (predeterminado: 20) |

228| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locales (stdio) para conectar en paralelo durante el inicio (predeterminado: 3) |231| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Número máximo de servidores MCP locales (stdio) para conectar en paralelo durante el inicio (predeterminado: 3) |

errors.md +8 −6

Details

162 162

163Estos errores significan que se ha alcanzado una cuota vinculada a su cuenta o plan. Son distintos de los [errores del servidor](#server-errors), que afectan a todos.163Estos errores significan que se ha alcanzado una cuota vinculada a su cuenta o plan. Son distintos de los [errores del servidor](#server-errors), que afectan a todos.

164 164

165### You've hit your session limit165### Ha alcanzado su límite de sesión

166 166

167Los planes de suscripción incluyen una asignación de uso continuo. Cuando se agota, ve uno de estos mensajes:167Los planes de suscripción incluyen una asignación de uso continuo. Cuando se agota, ve uno de estos mensajes:

168 168

178 178

179* Espere la hora de reinicio que se muestra en el error179* Espere la hora de reinicio que se muestra en el error

180* Ejecute `/usage` para ver los límites de su plan y cuándo se reinician180* Ejecute `/usage` para ver los límites de su plan y cuándo se reinician

181* Ejecute `/extra-usage` para comprar uso adicional en Pro y Max, o para solicitarlo a su administrador en Team y Enterprise. Consulte [Extra usage for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber cómo se factura esto.181* Ejecute `/usage-credits` para comprar uso adicional en Pro y Max, o para solicitarlo a su administrador en Team y Enterprise. Consulte [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) para saber cómo se factura esto.

182* Para actualizar su plan para obtener límites base más altos, consulte [claude.com/pricing](https://claude.com/pricing)182* Para actualizar su plan para obtener límites base más altos, consulte [claude.com/pricing](https://claude.com/pricing)

183 183

184Para ver su asignación restante antes de alcanzar el límite, agregue los campos `rate_limits` a una [línea de estado personalizada](/es/statusline#rate-limit-usage), o en la aplicación de escritorio haga clic en el [anillo de uso](/es/desktop#check-usage) junto al selector de modelo.184Para ver su asignación restante antes de alcanzar el límite, agregue los campos `rate_limits` a una [línea de estado personalizada](/es/statusline#rate-limit-usage), o en la aplicación de escritorio haga clic en el [anillo de uso](/es/desktop#check-usage) junto al selector de modelo.

185 185

186### Server is temporarily limiting requests186### El servidor está limitando temporalmente las solicitudes

187 187

188La API aplicó una aceleración de corta duración que no está relacionada con su cuota de plan.188La API aplicó una aceleración de corta duración que no está relacionada con su cuota de plan.

189 189

198* Espere brevemente e intente de nuevo198* Espere brevemente e intente de nuevo

199* Consulte [status.claude.com](https://status.claude.com) si persiste199* Consulte [status.claude.com](https://status.claude.com) si persiste

200 200

201### Request rejected (429)201### Solicitud rechazada (429)

202 202

203Ha alcanzado el límite de velocidad configurado para su clave de API, proyecto de Amazon Bedrock o proyecto de Google Vertex AI.203Ha alcanzado el límite de velocidad configurado para su clave de API, proyecto de Amazon Bedrock o proyecto de Google Vertex AI.

204 204

205```text theme={null}205```text theme={null}

206API Error: Request rejected (429) · this may be a temporary capacity issue206API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

207```207```

208 208

209La oración final indica dónde verificar el estado del servicio y varía según el proveedor. Las configuraciones de Bedrock y Vertex AI nombran el estado del servicio de ese proveedor en lugar de la página de estado de Anthropic.

210

209**Qué hacer:**211**Qué hacer:**

210 212

211* Ejecute `/status` y confirme que la credencial activa es la que espera. Un `ANTHROPIC_API_KEY` extraviado en su entorno puede enrutar solicitudes a través de una clave de nivel bajo en lugar de su suscripción.213* Ejecute `/status` y confirme que la credencial activa es la que espera. Un `ANTHROPIC_API_KEY` extraviado en su entorno puede enrutar solicitudes a través de una clave de nivel bajo en lugar de su suscripción.

213* Para claves de API de Anthropic, consulte la [referencia de límites de velocidad](https://platform.claude.com/docs/en/api/rate-limits) para saber cómo funcionan los niveles y cómo establecer límites por espacio de trabajo215* Para claves de API de Anthropic, consulte la [referencia de límites de velocidad](https://platform.claude.com/docs/en/api/rate-limits) para saber cómo funcionan los niveles y cómo establecer límites por espacio de trabajo

214* Reduzca la concurrencia: reduzca [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/es/env-vars), evite ejecutar muchos subagentos paralelos, o cambie a un modelo más pequeño con `/model` para ejecuciones de alto volumen con scripts216* Reduzca la concurrencia: reduzca [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/es/env-vars), evite ejecutar muchos subagentos paralelos, o cambie a un modelo más pequeño con `/model` para ejecuciones de alto volumen con scripts

215 217

216### Credit balance is too low218### El saldo de crédito es demasiado bajo

217 219

218Su organización de Console se ha quedado sin créditos prepagados.220Su organización de Console se ha quedado sin créditos prepagados.

219 221

fast-mode.md +14 −48

Details

12 12

13El modo rápido es una configuración de alta velocidad para Claude Opus, haciendo que el modelo sea 2.5x más rápido a un costo más alto por token. Actívalo con `/fast` cuando necesites velocidad para trabajo interactivo como iteración rápida o depuración en vivo, y desactívalo cuando el costo sea más importante que la latencia.13El modo rápido es una configuración de alta velocidad para Claude Opus, haciendo que el modelo sea 2.5x más rápido a un costo más alto por token. Actívalo con `/fast` cuando necesites velocidad para trabajo interactivo como iteración rápida o depuración en vivo, y desactívalo cuando el costo sea más importante que la latencia.

14 14

15El modo rápido no es un modelo diferente. Utiliza Claude Opus con una configuración de API diferente que prioriza la velocidad sobre la eficiencia de costos. Obtienes la misma calidad y capacidades, solo respuestas más rápidas. El modo rápido es compatible con Opus 4.6 y Opus 4.7. No está disponible en Sonnet, Haiku u otros modelos.15El modo rápido no es un modelo diferente. Utiliza Claude Opus con una configuración de API diferente que prioriza la velocidad sobre la eficiencia de costos. Obtienes la misma calidad y capacidades con respuestas más rápidas. El modo rápido es compatible con Opus 4.7 y Opus 4.6. No está disponible en Sonnet, Haiku u otros modelos.

16 16

17<Note>17<Note>

18 El modo rápido requiere Claude Code v2.1.36 o posterior. Verifica tu versión con `claude --version`.18 El modo rápido requiere Claude Code v2.1.36 o posterior. Verifica tu versión con `claude --version`.

21Lo que debes saber:21Lo que debes saber:

22 22

23* Usa `/fast` para activar o desactivar el modo rápido en Claude Code CLI. También disponible a través de `/fast` en la Extensión Claude Code VS Code.23* Usa `/fast` para activar o desactivar el modo rápido en Claude Code CLI. También disponible a través de `/fast` en la Extensión Claude Code VS Code.

24* De forma predeterminada, `/fast` se ejecuta en Opus 4.6. Para ejecutar el modo rápido en Opus 4.7 en su lugar, establece la variable de entorno [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7).24* Los precios del modo rápido son $30/$150 MTok tanto en Opus 4.7 como en Opus 4.6.

~~25* Los precios del modo rápido son \$30/150 MTok tanto en Opus 4.6 como en Opus 4.7.~~

26* Disponible para todos los usuarios de Claude Code en planes de suscripción (Pro/Max/Team/Enterprise) y Claude Console.25* Disponible para todos los usuarios de Claude Code en planes de suscripción (Pro/Max/Team/Enterprise) y Claude Console.

27* Para los usuarios de Claude Code en planes de suscripción (Pro/Max/Team/Enterprise), el modo rápido está disponible solo a través de uso adicional y no está incluido en los límites de velocidad de la suscripción.26* Para los usuarios de Claude Code en planes de suscripción (Pro/Max/Team/Enterprise), el modo rápido está disponible solo a través de créditos de uso y no está incluido en los límites de velocidad de la suscripción.

28 27

29Esta página cubre cómo [activar el modo rápido](#toggle-fast-mode), [usar el modo rápido en Opus 4.7](#use-fast-mode-on-opus-4-7), la [compensación de costos](#understand-the-cost-tradeoff), [cuándo usarlo](#decide-when-to-use-fast-mode), [requisitos](#requirements), [opción de participación por sesión](#require-per-session-opt-in), y [comportamiento de límite de velocidad](#handle-rate-limits).28Esta página cubre cómo [activar el modo rápido](#toggle-fast-mode), su [compensación de costos](#understand-the-cost-tradeoff), [cuándo usarlo](#decide-when-to-use-fast-mode), [requisitos](#requirements), [opción de participación por sesión](#require-per-session-opt-in), y [comportamiento de límite de velocidad](#handle-rate-limits).

30 29

31## Activar el modo rápido30## Activar el modo rápido

32 31

41 40

42Cuando habilitas el modo rápido:41Cuando habilitas el modo rápido:

43 42

44* Si estás en un modelo diferente, Claude Code cambia automáticamente al modelo de modo rápido: Opus 4.6 de forma predeterminada, u Opus 4.7 cuando [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7) está establecido.43* Si estás en un modelo diferente, Claude Code cambia automáticamente a Opus

45* Verás un mensaje de confirmación: "Fast mode ON"44* Verás un mensaje de confirmación: "Fast mode ON"

46* Un pequeño icono `↯` aparece junto al prompt mientras el modo rápido está activo45* Un pequeño icono `↯` aparece junto al prompt mientras el modo rápido está activo

47* Ejecuta `/fast` nuevamente en cualquier momento para verificar si el modo rápido está activado o desactivado46* Ejecuta `/fast` nuevamente en cualquier momento para verificar si el modo rápido está activado o desactivado

48 47

49Cuando desactivas el modo rápido con `/fast` nuevamente, permaneces en la misma versión de Opus en la que se estaba ejecutando el modo rápido. El modelo no revierte a tu modelo anterior. Para cambiar a un modelo diferente, usa `/model`.48Cuando desactivas el modo rápido con `/fast` nuevamente, permaneces en Opus. El modelo no revierte a tu modelo anterior. Para cambiar a un modelo diferente, usa `/model`.

50 49

~~51## Usar el modo rápido en Opus 4.7~~50Opus 4.7 es el valor predeterminado del modo rápido en Claude Code v2.1.142 y posterior. Para fijar el modo rápido a Opus 4.6 en su lugar, establece `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`.

~~53<Note>~~

~~54 El modo rápido en Opus 4.7 requiere Claude Code v2.1.139 o posterior.~~

~~55</Note>~~

57El modo rápido para Claude Opus 4.7 está en vista previa de investigación. Se ejecuta a la misma velocidad 2.5x y al mismo precio que el modo rápido para Opus 4.6, sin otros cambios de comportamiento.

~~59<Note>~~

~~60 El 14 de mayo de 2026, Opus 4.7 se convierte en el modelo de modo rápido predeterminado. Hasta entonces, participa estableciendo `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1`.~~

~~61</Note>~~

63Para participar, establece `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` antes de lanzar Claude Code. Con la variable establecida, `/fast` se ejecuta en Opus 4.7. Sin ella, `/fast` continúa ejecutándose en Opus 4.6.

~~65Puedes establecer la variable como una exportación de shell:~~

~~67```bash theme={null}~~

~~68export CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1~~

~~69```~~

~~71O en cualquier [archivo de configuración](/es/settings#settings-files) de Claude Code, incluyendo configuración de usuario, proyecto y administrada, para limitar el alcance de la participación:~~

~~73```json theme={null}~~

~~74{~~

~~75 "env": {~~

~~76 "CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE": "1"~~

~~77 }~~

~~78}~~

~~79```~~

81El modo rápido para Opus 4.6 sigue estando disponible junto a Opus 4.7. Los dos comparten el mismo grupo de límite de velocidad del modo rápido: el uso en cualquiera de los modelos se extrae de los mismos límites.

83Para fijar el modo rápido a Opus 4.6 explícitamente, establece `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`. Esta variable tiene prioridad, por lo que el modo rápido se ejecuta en Opus 4.6 independientemente de si `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` está establecida.

84 51

85## Comprender la compensación de costos52## Comprender la compensación de costos

86 53

87El modo rápido tiene precios por token más altos que el Opus estándar:54El modo rápido tiene precios por token más altos que el Opus estándar:

88 55

~~90| ----------------------- | -------------- | ------------- |~~57| ----------- | -------------- | ------------- |

~~91| Modo rápido en Opus 4.6 | \$30 | \$150 |~~58| Modo rápido | \$30 | \$150 |

~~92| Modo rápido en Opus 4.7 | \$30 | \$150 |~~

93 59

94Los precios del modo rápido son fijos en toda la ventana de contexto de 1M tokens.60Los precios del modo rápido son fijos en toda la ventana de contexto de 1M tokens.

95 61

124 90

125El modo rápido requiere todos los siguientes:91El modo rápido requiere todos los siguientes:

126 92

127* **No disponible en proveedores de nube de terceros**: el modo rápido no está disponible en Amazon Bedrock, Google Vertex AI o Microsoft Azure Foundry. El modo rápido está disponible a través de la API de Anthropic Console y para planes de suscripción de Claude usando uso adicional.93* **No disponible en proveedores de nube de terceros**: el modo rápido no está disponible en Amazon Bedrock, Google Vertex AI o Microsoft Azure Foundry. El modo rápido está disponible a través de la API de Anthropic Console y para planes de suscripción de Claude usando créditos de uso.

128* **Uso adicional habilitado**: tu cuenta debe tener el uso adicional habilitado, lo que permite facturación más allá del uso incluido en tu plan. Para cuentas individuales, habilita esto en tu [configuración de facturación de Console](https://platform.claude.com/settings/organization/billing). Para Teams y Enterprise, un administrador debe habilitar el uso adicional para la organización.94* **Créditos de uso activados**: tu cuenta debe tener los créditos de uso activados, lo que permite facturación más allá del uso incluido en tu plan. Para cuentas individuales, activa esto en tu [configuración de facturación de Console](https://platform.claude.com/settings/organization/billing). Para Teams y Enterprise, un administrador debe activar los créditos de uso para la organización.

129 95

130<Note>96<Note>

131 El uso del modo rápido se factura directamente al uso adicional, incluso si tienes uso restante en tu plan. Esto significa que los tokens del modo rápido no cuentan contra el uso incluido en tu plan y se cobran a la tarifa del modo rápido desde el primer token.97 El uso del modo rápido se extrae directamente de los créditos de uso, incluso si tienes uso restante en tu plan. Esto significa que los tokens del modo rápido no cuentan contra el uso incluido en tu plan y se cobran a la tarifa del modo rápido desde el primer token.

132</Note>98</Note>

133 99

134* **Habilitación del administrador para Teams y Enterprise**: el modo rápido está deshabilitado de forma predeterminada para organizaciones Teams y Enterprise. Un administrador debe [habilitar explícitamente el modo rápido](#enable-fast-mode-for-your-organization) antes de que los usuarios puedan acceder a él.100* **Habilitación del administrador para Teams y Enterprise**: el modo rápido está deshabilitado de forma predeterminada para organizaciones Teams y Enterprise. Un administrador debe [habilitar explícitamente el modo rápido](#enable-fast-mode-for-your-organization) antes de que los usuarios puedan acceder a él.

160 126

161## Manejar límites de velocidad127## Manejar límites de velocidad

162 128

163El modo rápido tiene límites de velocidad separados del Opus estándar. El modo rápido para Opus 4.6 y Opus 4.7 comparten el mismo grupo de límite de velocidad: el uso en cualquiera de los modelos se extrae de los mismos límites. Cuando alcanzas el límite de velocidad del modo rápido o se agotan tus créditos de uso adicional:129El modo rápido tiene límites de velocidad separados del Opus estándar. El modo rápido para Opus 4.7 y Opus 4.6 comparten el mismo grupo de límite de velocidad: el uso en cualquiera de los modelos se extrae de los mismos límites. Cuando alcanzas el límite de velocidad del modo rápido o se agotan tus créditos de uso:

164 130

1651. El modo rápido automáticamente vuelve a velocidad estándar en la misma versión de Opus1311. El modo rápido automáticamente vuelve a velocidad estándar

1662. El icono `↯` se vuelve gris para indicar enfriamiento1322. El icono `↯` se vuelve gris para indicar enfriamiento

1673. Continúas trabajando a velocidad y precios estándar1333. Continúas trabajando a velocidad y precios estándar

1684. Cuando expira el enfriamiento, el modo rápido se vuelve a habilitar automáticamente1344. Cuando expira el enfriamiento, el modo rápido se vuelve a habilitar automáticamente

features-overview.md +2 −2

Details

271 271

272 **Qué se carga:** Contexto fresco y aislado que contiene:272 **Qué se carga:** Contexto fresco y aislado que contiene:

273 273

274 * El prompt del sistema (compartido con el padre para eficiencia de caché)274 * El prompt del sistema, no el prompt del sistema completo de Claude Code

275 * Contenido completo de skills listadas en el campo `skills:` del agente275 * Contenido completo de skills listadas en el campo `skills:` del agente

276 * CLAUDE.md y estado de git (heredado del padre)276 * CLAUDE.md y estado de git, excepto los agentes Explore y Plan integrados [omiten ambos](/es/sub-agents#what-loads-at-startup)

277 * Cualquier contexto que el agente principal pase en el prompt277 * Cualquier contexto que el agente principal pase en el prompt

278 278

279 **Costo de contexto:** Aislado de la sesión principal. Los subagents no heredan su historial de conversación o skills invocadas.279 **Costo de contexto:** Aislado de la sesión principal. Los subagents no heredan su historial de conversación o skills invocadas.

hooks.md +1 −1

Details

732# Hook de notificación: ping al escritorio cuando Claude Code necesita atención.732# Hook de notificación: ping al escritorio cuando Claude Code necesita atención.

733input=$(cat)733input=$(cat)

734title="Claude Code'734title="Claude Code'

735body=$(jq -r '.message // 'Needs your attention"' <<<"$input")735body=$(jq -r '.message // 'Needs your attention'' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```738```

hooks-guide.md +5 −3

Details

910* Verifica que tu JSON sea válido (las comas finales y comentarios no están permitidos)910* Verifica que tu JSON sea válido (las comas finales y comentarios no están permitidos)

911* Confirma que el archivo de configuración está en la ubicación correcta: `.claude/settings.json` para hooks de proyecto, `~/.claude/settings.json` para hooks globales911* Confirma que el archivo de configuración está en la ubicación correcta: `.claude/settings.json` para hooks de proyecto, `~/.claude/settings.json` para hooks globales

912 912

913### El hook Stop se ejecuta para siempre913### El hook Stop alcanza el límite de bloqueo

914 914

915Claude sigue trabajando en un bucle infinito en lugar de detenerse.915Claude sigue trabajando en lugar de detenerse, luego termina el turno con una advertencia de que el hook Stop bloqueó demasiadas veces consecutivas.

916 916

917Tu script de hook Stop necesita verificar si ya activó una continuación. Analiza el campo `stop_hook_active` de la entrada JSON y sal temprano si es `true`:917Claude Code anula un hook Stop después de que bloquea 8 veces seguidas sin progreso. Tu script de hook necesita verificar si ya activó una continuación. Analiza el campo `stop_hook_active` de la entrada JSON y sal temprano si es `true`:

918 918

919```bash theme={null}919```bash theme={null}

920#!/bin/bash920#!/bin/bash

925# ... resto de tu lógica de hook925# ... resto de tu lógica de hook

926```926```

927 927

928Si tu hook legítimamente necesita más de ocho iteraciones para converger, aumenta el límite con [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/es/env-vars).

929

928### Falló la validación JSON930### Falló la validación JSON

929 931

930Claude Code muestra un error de análisis JSON aunque tu script de hook produzca JSON válido.932Claude Code muestra un error de análisis JSON aunque tu script de hook produzca JSON válido.

mcp.md +3 −1

Details

143 143

144El panel `/mcp` muestra el recuento de herramientas junto a cada servidor conectado e indica los servidores que anuncian la capacidad de herramientas pero no exponen ninguna herramienta.144El panel `/mcp` muestra el recuento de herramientas junto a cada servidor conectado e indica los servidores que anuncian la capacidad de herramientas pero no exponen ninguna herramienta.

145 145

146Si su solicitud necesita herramientas de un servidor que aún se está conectando en segundo plano, Claude espera a que ese servidor continúe. Con [búsqueda de herramientas](#scale-with-mcp-tool-search) habilitada, que es la predeterminada, la espera ocurre dentro de la llamada `ToolSearch`. En configuraciones sin búsqueda de herramientas, como Vertex AI, un `ANTHROPIC_BASE_URL` personalizado, o `ENABLE_TOOL_SEARCH=false`, Claude utiliza la herramienta `WaitForMcpServers` en su lugar.

147

146El nombre del servidor `workspace` está reservado para uso interno. Si su configuración define un servidor con ese nombre, Claude Code lo omite al cargar y muestra una advertencia pidiéndole que lo renombre.148El nombre del servidor `workspace` está reservado para uso interno. Si su configuración define un servidor con ese nombre, Claude Code lo omite al cargar y muestra una advertencia pidiéndole que lo renombre.

147 149

148### Actualizaciones dinámicas de herramientas150### Actualizaciones dinámicas de herramientas

1007 1009

1008El campo `alwaysLoad` está disponible en todos los tipos de servidor y requiere Claude Code v2.1.121 o posterior. Un servidor MCP también puede marcar herramientas individuales como siempre cargadas incluyendo `"anthropic/alwaysLoad": true` en el objeto `_meta` de la herramienta, que tiene el mismo efecto solo para esa herramienta.1010El campo `alwaysLoad` está disponible en todos los tipos de servidor y requiere Claude Code v2.1.121 o posterior. Un servidor MCP también puede marcar herramientas individuales como siempre cargadas incluyendo `"anthropic/alwaysLoad": true` en el objeto `_meta` de la herramienta, que tiene el mismo efecto solo para esa herramienta.

1009 1011

1010Establecer `alwaysLoad: true` también bloquea el inicio hasta que el servidor se conecte, limitado al tiempo de espera de conexión estándar de 5 segundos. Esto se aplica incluso cuando [`MCP_CONNECTION_NONBLOCKING=1`](/es/env-vars) está establecido, ya que las herramientas deben estar presentes cuando se construye el primer mensaje. Otros servidores aún se conectan en segundo plano cuando el modo no bloqueante está habilitado.1012Establecer `alwaysLoad: true` también bloquea el inicio hasta que el servidor se conecte, limitado al tiempo de espera de conexión estándar de 5 segundos. Esto se aplica incluso cuando MCP startup es de otro modo [no bloqueante de forma predeterminada](/es/env-vars), ya que las herramientas deben estar presentes cuando se construye el primer mensaje. Otros servidores aún se conectan en segundo plano.

1011 1013

1012## Usar indicaciones MCP como comandos1014## Usar indicaciones MCP como comandos

1013 1015

model-config.md +2 −2

Details

284Puede utilizar las siguientes variables de entorno, que deben ser **nombres de modelo** completos (o equivalentes para su proveedor de API), para controlar los nombres de modelo a los que se asignan los alias.284Puede utilizar las siguientes variables de entorno, que deben ser **nombres de modelo** completos (o equivalentes para su proveedor de API), para controlar los nombres de modelo a los que se asignan los alias.

285 285

286| Variable de entorno | Descripción |286| Variable de entorno | Descripción |

287| -------------------------------- | ----------------------------------------------------------------------------------------------- |287| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | El modelo a utilizar para `sonnet`, o para `opusplan` cuando Plan Mode no está activo. |289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | El modelo a utilizar para `sonnet`, o para `opusplan` cuando Plan Mode no está activo. |

290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | El modelo a utilizar para `haiku`, o [funcionalidad de fondo](/es/costs#background-token-usage) |290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | El modelo a utilizar para `haiku`, o [funcionalidad de fondo](/es/costs#background-token-usage) |

291| `CLAUDE_CODE_SUBAGENT_MODEL` | El modelo a utilizar para [subagents](/es/sub-agents) |291| `CLAUDE_CODE_SUBAGENT_MODEL` | El modelo a utilizar para todos los [subagents](/es/sub-agents#choose-a-model). Anula tanto el parámetro `model` por invocación como el frontmatter `model` de la definición del subagent |

292 292

293Nota: `ANTHROPIC_SMALL_FAST_MODEL` está deprecado en favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.293Nota: `ANTHROPIC_SMALL_FAST_MODEL` está deprecado en favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

294 294

overview.md +1 −1

Details

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

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

4 4

~~5# Descripción general de Claude Code~~5# Descripción general

6 6

7> Claude Code es una herramienta de codificación agencial que lee tu base de código, edita archivos, ejecuta comandos e integra con tus herramientas de desarrollo. Disponible en tu terminal, IDE, aplicación de escritorio y navegador.7> Claude Code es una herramienta de codificación agencial que lee tu base de código, edita archivos, ejecuta comandos e integra con tus herramientas de desarrollo. Disponible en tu terminal, IDE, aplicación de escritorio y navegador.

8 8

permission-modes.md +3 −1

Details

73 | Modo automático | `auto` |73 | Modo automático | `auto` |

74 | Omitir permisos | `bypassPermissions` |74 | Omitir permisos | `bypassPermissions` |

75 75

76 El modo automático aparece en el indicador de modo después de que habilites **Permitir omitir permisos peligrosamente** en la configuración de la extensión, pero permanece no disponible hasta que tu cuenta cumpla todos los requisitos listados en la [sección de modo auto](#eliminate-prompts-with-auto-mode). La configuración `claudeCode.initialPermissionMode` no acepta `auto`; para comenzar en modo auto por defecto, establece `defaultMode` en tu [`settings.json`](/es/settings#settings-files) de Claude Code en su lugar.76 El modo automático aparece en el indicador de modo después de que habilites **Permitir omitir permisos peligrosamente** en la configuración de la extensión, pero permanece no disponible hasta que tu cuenta cumpla todos los requisitos listados en la [sección de modo auto](#eliminate-prompts-with-auto-mode). La configuración `claudeCode.initialPermissionMode` no acepta `auto`; para comenzar en modo auto por defecto, establece `defaultMode` en tu [configuración de usuario](/es/settings#settings-files) en su lugar. Claude Code ignora `defaultMode: "auto"` en la configuración del proyecto y local.

77 77

78 Omitir permisos también requiere el interruptor **Permitir omitir permisos peligrosamente** antes de que aparezca en el indicador de modo.78 Omitir permisos también requiere el interruptor **Permitir omitir permisos peligrosamente** antes de que aparezca en el indicador de modo.

79 79

179 179

180Si Claude Code reporta el modo automático como no disponible, uno de estos requisitos no se cumple; esto no es una interrupción transitoria. Un mensaje separado que nombra un modelo y dice que el modo automático "no puede determinar la seguridad" de una acción es una interrupción transitoria del clasificador; consulte la [referencia de errores](/es/errors#auto-mode-cannot-determine-the-safety-of-an-action).180Si Claude Code reporta el modo automático como no disponible, uno de estos requisitos no se cumple; esto no es una interrupción transitoria. Un mensaje separado que nombra un modelo y dice que el modo automático "no puede determinar la seguridad" de una acción es una interrupción transitoria del clasificador; consulte la [referencia de errores](/es/errors#auto-mode-cannot-determine-the-safety-of-an-action).

181 181

182Si establece `defaultMode: "auto"` en [configuración](/es/settings#available-settings) y la sesión comienza en modo `default` sin error, la configuración probablemente esté en `.claude/settings.json` o `.claude/settings.local.json`. Claude Code ignora `auto` de esos archivos para que un repositorio no pueda otorgarse a sí mismo modo automático. Muévalo a `~/.claude/settings.json`.

183

182### Qué bloquea el clasificador por defecto184### Qué bloquea el clasificador por defecto

183 185

184El clasificador confía en su directorio de trabajo y en los remotos configurados de su repositorio. Todo lo demás se trata como externo hasta que [configure infraestructura confiable](/es/auto-mode-config).186El clasificador confía en su directorio de trabajo y en los remotos configurados de su repositorio. Todo lo demás se trata como externo hasta que [configure infraestructura confiable](/es/auto-mode-config).

plugin-dependencies.md +24 −0

Details

114 114

115Cuando desinstala el último plugin que restringe una dependencia, la dependencia ya no se mantiene y reanuda el seguimiento de su entrada de marketplace en la próxima actualización.115Cuando desinstala el último plugin que restringe una dependencia, la dependencia ya no se mantiene y reanuda el seguimiento de su entrada de marketplace en la próxima actualización.

116 116

117## Habilitar o deshabilitar un plugin con dependencias

118

119Habilitar un plugin también habilita los plugins de los que depende, y deshabilitar un plugin se bloquea si otro plugin habilitado aún lo necesita. Ambos comportamientos requieren Claude Code v2.1.143 o posterior. Las versiones anteriores habilitan o deshabilitan solo el plugin nombrado y muestran un error `dependency-unsatisfied` en la próxima carga.

120

121Cuando habilita un plugin, Claude Code también habilita sus dependencias en el mismo ámbito. Si una dependencia tiene sus propias dependencias, Claude Code también las habilita. El mensaje de éxito lista qué más se habilitó junto con el plugin que nombró. Si una dependencia no se puede habilitar, el comando se rechaza y le dice qué está bloqueando y cómo solucionarlo:

122

123| Condición | Resultado |

124| :-------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |

125| Una dependencia no está instalada | La habilitación falla e imprime el comando `claude plugin install` para cada dependencia faltante. |

126| Una dependencia está bloqueada por la política de plugins de su organización | La habilitación falla y nombra la dependencia bloqueada. |

127| Una dependencia se establece en `false` en un ámbito con mayor precedencia que el ámbito de destino | La habilitación falla. Habilite la dependencia en ese ámbito, o pase `--scope` para escribir allí. |

128| Todas las dependencias están instaladas y permitidas | La habilitación tiene éxito y escribe `true` para el plugin y cada dependencia que no estaba ya habilitada en el ámbito de destino. |

129

130Cuando deshabilita un plugin, Claude Code se rechaza si otro plugin habilitado aún depende de él. El error nombra los plugins que dependen de él y le da un comando encadenado que los deshabilita en el orden correcto, terminando con el que pidió.

131

132Por ejemplo, si `deploy-kit` depende de `secrets-vault`, deshabilitar `secrets-vault` solo falla con una salida similar a la siguiente:

133

134```text theme={null}

135secrets-vault is still required by deploy-kit. Disable that plugin first, or

136disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

137```

138

139Copie el comando encadenado del error para deshabilitar el conjunto completo en un paso.

140

117## Eliminar dependencias auto-instaladas huérfanas141## Eliminar dependencias auto-instaladas huérfanas

118 142

119Las dependencias auto-instaladas permanecen en el disco después de que se desinstalan los plugins que las instalaron, en caso de que desee reinstalar un plugin dependiente o desee seguir usando la dependencia directamente. Para limpiarlas, ejecute `claude plugin prune` para listar las dependencias auto-instaladas que ya no tienen ningún plugin instalado que las requiera y eliminarlas después de un mensaje de confirmación. Esto requiere Claude Code v2.1.121 o posterior.143Las dependencias auto-instaladas permanecen en el disco después de que se desinstalan los plugins que las instalaron, en caso de que desee reinstalar un plugin dependiente o desee seguir usando la dependencia directamente. Para limpiarlas, ejecute `claude plugin prune` para listar las dependencias auto-instaladas que ya no tienen ningún plugin instalado que las requiera y eliminarlas después de un mensaje de confirmación. Esto requiere Claude Code v2.1.121 o posterior.

plugin-marketplaces.md +2 −1

Details

162 162

163<Note>163<Note>

164 **Nombres reservados**: Los siguientes nombres de marketplace están reservados para uso oficial de Anthropic y no pueden ser utilizados por marketplaces de terceros: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `knowledge-work-plugins`, `life-sciences`. Los nombres que se hacen pasar por marketplaces oficiales (como `official-claude-plugins` o `anthropic-tools-v2`) también están bloqueados.164 **Nombres reservados**: Los siguientes nombres de marketplace están reservados para uso oficial de Anthropic y no pueden ser utilizados por marketplaces de terceros: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`. Los nombres que se hacen pasar por marketplaces oficiales, como `official-claude-plugins` o `anthropic-tools-v2`, también están bloqueados.

165</Note>165</Note>

166 166

167### Campos del propietario167### Campos del propietario

200 200

202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |202| :------------ | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

203| `displayName` | string | {/* min-version: 2.1.143 */}Nombre legible mostrado en superficies de interfaz de usuario. Recurre a `name` cuando se omite. Puede contener espacios y cualquier capitalización. No se utiliza para espacios de nombres o búsqueda. Requiere Claude Code v2.1.143 o posterior. |

204| `version` | string | Versión del plugin. Si se establece (aquí o en `plugin.json`), el plugin se fija a esta cadena y los usuarios solo reciben actualizaciones cuando cambia. Omita para recurrir al SHA del commit de git. Consulte [Resolución de versiones](#version-resolution-and-release-channels). |205| `version` | string | Versión del plugin. Si se establece (aquí o en `plugin.json`), el plugin se fija a esta cadena y los usuarios solo reciben actualizaciones cuando cambia. Omita para recurrir al SHA del commit de git. Consulte [Resolución de versiones](#version-resolution-and-release-channels). |

plugins-reference.md +9 −4

Details

20 20

21Los plugins añaden skills a Claude Code, creando atajos `/name` que usted o Claude pueden invocar.21Los plugins añaden skills a Claude Code, creando atajos `/name` que usted o Claude pueden invocar.

22 22

~~23**Ubicación**: Directorio `skills/` o `commands/` en la raíz del plugin~~23**Ubicación**: Directorio `skills/` o `commands/` en la raíz del plugin, o un único archivo `SKILL.md` en la raíz del plugin

24 24

25**Formato de archivo**: Los skills son directorios con `SKILL.md`; los comandos son archivos markdown simples25**Formato de archivo**: Los skills son directorios con `SKILL.md`; los comandos son archivos markdown simples

26 26

367```json theme={null}367```json theme={null}

368{368{

369 "name": "plugin-name",369 "name": "plugin-name",

370 "displayName": "Plugin Name",

370 "version": "1.2.0",371 "version": "1.2.0",

371 "description": "Brief plugin description",372 "description": "Brief plugin description",

372 "author": {373 "author": {

412| :------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |413| :------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

413| `$schema` | string | URL del esquema JSON para autocompletado y validación del editor. Claude Code ignora este campo en el momento de la carga. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |414| `$schema` | string | URL del esquema JSON para autocompletado y validación del editor. Claude Code ignora este campo en el momento de la carga. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

415| `displayName` | string | {/* min-version: 2.1.143 */}Nombre legible por humanos mostrado en el selector `/plugin` y otras superficies de interfaz de usuario. Recurre a `name` cuando se omite. A diferencia de `name`, puede contener espacios y cualquier capitalización. No se utiliza para espacios de nombres o búsqueda. Requiere Claude Code v2.1.143 o posterior. | `"Deployment Tools"` |

414| `version` | string | Opcional. Versión semántica. Establecer esto fija el plugin a esa cadena de versión, por lo que los usuarios solo reciben actualizaciones cuando la incrementas. Si se omite, Claude Code recurre al SHA del commit de git, por lo que cada commit se trata como una nueva versión. Si también se establece en la entrada del marketplace, `plugin.json` gana. Consulta [Gestión de versiones](#version-management). | `"2.1.0"` |416| `version` | string | Opcional. Versión semántica. Establecer esto fija el plugin a esa cadena de versión, por lo que los usuarios solo reciben actualizaciones cuando la incrementas. Si se omite, Claude Code recurre al SHA del commit de git, por lo que cada commit se trata como una nueva versión. Si también se establece en la entrada del marketplace, `plugin.json` gana. Consulta [Gestión de versiones](#version-management). | `"2.1.0"` |

416| `author` | object | Información del autor | `{"name": "Dev Team", "email": "dev@company.com"}` |418| `author` | object | Información del autor | `{"name": "Dev Team", "email": "dev@company.com"}` |

525* Se pueden especificar múltiples rutas como arrays527* Se pueden especificar múltiples rutas como arrays

526* Cuando una ruta de skill apunta a un directorio que contiene un `SKILL.md` directamente, por ejemplo `"skills": ["./"]` apuntando a la raíz del plugin, el campo frontmatter `name` en `SKILL.md` determina el nombre de invocación de la skill. Esto proporciona un nombre estable independientemente del directorio de instalación. Si `name` no se establece en el frontmatter, el nombre base del directorio se usa como alternativa.528* Cuando una ruta de skill apunta a un directorio que contiene un `SKILL.md` directamente, por ejemplo `"skills": ["./"]` apuntando a la raíz del plugin, el campo frontmatter `name` en `SKILL.md` determina el nombre de invocación de la skill. Esto proporciona un nombre estable independientemente del directorio de instalación. Si `name` no se establece en el frontmatter, el nombre base del directorio se usa como alternativa.

527 529

530Un plugin que tiene un `SKILL.md` en su raíz, sin subdirectorio `skills/`, y sin campo de manifiesto `skills` se carga automáticamente como un plugin de una sola skill en Claude Code v2.1.142 y posterior. No necesitas establecer `"skills": ["./"]` en `plugin.json` para este diseño. El nombre de invocación de la skill sigue la misma regla que arriba: el campo frontmatter `name`, o el nombre base del directorio como alternativa.

531

528**Ejemplos de rutas**:532**Ejemplos de rutas**:

529 533

530```json theme={null}534```json theme={null}

814 818

815### plugin enable819### plugin enable

816 820

817Habilita un plugin deshabilitado.821Habilita un plugin deshabilitado. Si el plugin declara [dependencias](/es/plugin-dependencies), Claude Code las habilita transitivamente en el mismo alcance, y el comando falla cuando una dependencia no está instalada.

818 822

819```bash theme={null}823```bash theme={null}

820claude plugin enable <plugin> [options]824claude plugin enable <plugin> [options]

833 837

834### plugin disable838### plugin disable

835 839

836Deshabilita un plugin sin desinstalarlo.840Deshabilita un plugin sin desinstalarlo. Falla cuando otro plugin habilitado [depende de](/es/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) el objetivo. El mensaje de error incluye un comando encadenado que deshabilita primero cada dependiente.

837 841

838```bash theme={null}842```bash theme={null}

839claude plugin disable <plugin> [options]843claude plugin disable <plugin> [options]

889 893

890### plugin details894### plugin details

891 895

892Muestra el inventario de componentes de un plugin y el costo de tokens proyectado. La salida lista todos los componentes que el plugin contribuye, agrupados como Skills (skills y comandos), Agents, Hooks, y servidores MCP, junto con una estimación de cuántos tokens añade a cada sesión.896Muestra el inventario de componentes de un plugin y el costo de tokens proyectado. La salida lista todos los componentes que el plugin contribuye, agrupados como Skills, Agents, Hooks, servidores MCP y servidores LSP, junto con una estimación de cuántos tokens añade a cada sesión. El grupo Skills incluye tanto entradas de `skills/` como de `commands/`.

893 897

894```bash theme={null}898```bash theme={null}

895claude plugin details <name>899claude plugin details <name>

922 Agents (0)926 Agents (0)

923 Hooks (1) (harness-only — no model context cost)927 Hooks (1) (harness-only — no model context cost)

924 MCP servers (0)928 MCP servers (0)

929 LSP servers (0)

925 930

926Projected token cost931Projected token cost

927 Always-on: ~180 tok added to every session932 Always-on: ~180 tok added to every session

remote-control.md +1 −1

Details

188* **El proceso local debe seguir ejecutándose**: Remote Control se ejecuta como un proceso local. Si cierra la terminal, cierra VS Code, o detiene el proceso `claude` de otra manera, la sesión finaliza.188* **El proceso local debe seguir ejecutándose**: Remote Control se ejecuta como un proceso local. Si cierra la terminal, cierra VS Code, o detiene el proceso `claude` de otra manera, la sesión finaliza.

189* **Interrupción de red extendida**: si su máquina está despierta pero no puede alcanzar la red durante más de aproximadamente 10 minutos, la sesión agota el tiempo de espera y el proceso se cierra. Ejecute `claude remote-control` nuevamente para iniciar una nueva sesión.189* **Interrupción de red extendida**: si su máquina está despierta pero no puede alcanzar la red durante más de aproximadamente 10 minutos, la sesión agota el tiempo de espera y el proceso se cierra. Ejecute `claude remote-control` nuevamente para iniciar una nueva sesión.

190* **Ultraplan desconecta Remote Control**: iniciar una sesión de [ultraplan](/es/ultraplan) desconecta cualquier sesión de Remote Control activa porque ambas características ocupan la interfaz claude.ai/code y solo una puede estar conectada a la vez.190* **Ultraplan desconecta Remote Control**: iniciar una sesión de [ultraplan](/es/ultraplan) desconecta cualquier sesión de Remote Control activa porque ambas características ocupan la interfaz claude.ai/code y solo una puede estar conectada a la vez.

191* **Algunos comandos son solo locales**: comandos que abren un selector interactivo en la terminal, como `/mcp`, `/plugin`, o `/resume`, funcionan solo desde la CLI local. Los comandos que producen salida de texto, incluyendo `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/extra-usage`, `/recap`, y `/reload-plugins`, funcionan desde móvil y web.191* **Algunos comandos son solo locales**: comandos que abren un selector interactivo en la terminal, como `/mcp`, `/plugin`, o `/resume`, funcionan solo desde la CLI local. Los comandos que producen salida de texto, incluyendo `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, y `/reload-plugins`, funcionan desde móvil y web.

192 192

193## Solución de problemas193## Solución de problemas

194 194

routines.md +1 −1

Details

360 360

361Las rutinas reducen el uso de suscripción de la misma manera que lo hacen las sesiones interactivas. Además de los límites de suscripción estándar, las rutinas tienen un límite diario de cuántas ejecuciones pueden comenzar por cuenta. Vea su consumo actual y ejecuciones diarias de rutina restantes en [claude.ai/code/routines](https://claude.ai/code/routines) o [claude.ai/settings/usage](https://claude.ai/settings/usage).361Las rutinas reducen el uso de suscripción de la misma manera que lo hacen las sesiones interactivas. Además de los límites de suscripción estándar, las rutinas tienen un límite diario de cuántas ejecuciones pueden comenzar por cuenta. Vea su consumo actual y ejecuciones diarias de rutina restantes en [claude.ai/code/routines](https://claude.ai/code/routines) o [claude.ai/settings/usage](https://claude.ai/settings/usage).

362 362

363Cuando una rutina alcanza el límite diario o el límite de uso de su suscripción, las organizaciones con uso adicional habilitado pueden continuar ejecutando rutinas en exceso medido. Sin uso adicional, las ejecuciones adicionales se rechazan hasta que se reinicia la ventana. Habilite el uso adicional desde **Settings > Billing** en claude.ai.363Cuando una rutina alcanza el límite diario o el límite de uso de su suscripción, las organizaciones con créditos de uso habilitados pueden continuar ejecutando rutinas en exceso medido. Sin créditos de uso, las ejecuciones adicionales se rechazan hasta que se reinicia la ventana. Habilite los créditos de uso desde **Settings > Billing** en claude.ai.

364 364

365Las ejecuciones únicas no cuentan contra el límite diario de ejecuciones de rutina. Reducen su uso de suscripción regular como cualquier otra sesión, pero están exentas de la asignación diaria de ejecuciones de rutina por cuenta.365Las ejecuciones únicas no cuentan contra el límite diario de ejecuciones de rutina. Reducen su uso de suscripción regular como cualquier otra sesión, pero están exentas de la asignación diaria de ejecuciones de rutina por cuenta.

366 366

scheduled-tasks.md +1 −1

Details

12 12

13Las tareas programadas permiten que Claude vuelva a ejecutar un prompt automáticamente en un intervalo. Úselas para sondear una implementación, supervisar un PR, verificar una compilación de larga duración o recordarse a sí mismo que debe hacer algo más adelante en la sesión. Para reaccionar a eventos a medida que ocurren en lugar de sondear, consulte [Channels](/es/channels): su CI puede insertar el error directamente en la sesión. Para mantener la sesión funcionando turno tras turno hasta que se cumpla una condición en lugar de en un intervalo, consulte [`/goal`](/es/goal).13Las tareas programadas permiten que Claude vuelva a ejecutar un prompt automáticamente en un intervalo. Úselas para sondear una implementación, supervisar un PR, verificar una compilación de larga duración o recordarse a sí mismo que debe hacer algo más adelante en la sesión. Para reaccionar a eventos a medida que ocurren en lugar de sondear, consulte [Channels](/es/channels): su CI puede insertar el error directamente en la sesión. Para mantener la sesión funcionando turno tras turno hasta que se cumpla una condición en lugar de en un intervalo, consulte [`/goal`](/es/goal).

14 14

15Las tareas tienen alcance de sesión: viven en la conversación actual y se detienen cuando inicia una nueva. Reanudar con `--resume` o `--continue` trae de vuelta cualquier tarea que no haya [expirado](#seven-day-expiry): una tarea recurrente creada en los últimos 7 días, o una única cuyo tiempo programado aún no ha pasado. Para la programación que sobrevive independientemente de cualquier sesión, utilice [Routines](/es/routines), [tareas programadas de Desktop](/es/desktop-scheduled-tasks) o [GitHub Actions](/es/github-actions).15Las tareas tienen alcance de sesión: viven en la conversación actual y se detienen cuando inicia una nueva. Reanudar con `--resume` o `--continue` trae de vuelta cualquier tarea que no haya [expirado](#seven-day-expiry): una tarea recurrente creada en los últimos 7 días, o una única cuyo tiempo programado aún no ha pasado. Para la programación que sobrevive independientemente de cualquier sesión, utilice [Routines](/es/routines) para crear una rutina en la infraestructura administrada por Anthropic, configure una [tarea programada de Desktop](/es/desktop-scheduled-tasks) o utilice [GitHub Actions](/es/github-actions).

16 16

17## Comparar opciones de programación17## Comparar opciones de programación

18 18

settings.md +6 −4

Details

224| `prUrlTemplate` | Plantilla de URL para la insignia de PR mostrada en el pie de página y en resúmenes de resultados de herramientas. Sustituye `{host}`, `{owner}`, `{repo}`, `{number}` y `{url}` de la URL de PR reportada por `gh`. Use para apuntar enlaces de PR a una herramienta de revisión de código interna en lugar de `github.com`. No afecta autolinks `#123` en la prosa de Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |224| `prUrlTemplate` | Plantilla de URL para la insignia de PR mostrada en el pie de página y en resúmenes de resultados de herramientas. Sustituye `{host}`, `{owner}`, `{repo}`, `{number}` y `{url}` de la URL de PR reportada por `gh`. Use para apuntar enlaces de PR a una herramienta de revisión de código interna en lugar de `github.com`. No afecta autolinks `#123` en la prosa de Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

225| `respectGitignore` | Controlar si el selector de archivo `@` respeta patrones `.gitignore`. Cuando es `true` (predeterminado), los archivos que coinciden con patrones `.gitignore` se excluyen de las sugerencias | `false` |225| `respectGitignore` | Controlar si el selector de archivo `@` respeta patrones `.gitignore`. Cuando es `true` (predeterminado), los archivos que coinciden con patrones `.gitignore` se excluyen de las sugerencias | `false` |

226| `showClearContextOnPlanAccept` | Mostrar la opción "borrar contexto" en la pantalla de aceptación del plan. Predeterminado: `false`. Establecer en `true` para restaurar la opción | `true` |226| `showClearContextOnPlanAccept` | Mostrar la opción "borrar contexto" en la pantalla de aceptación del plan. Predeterminado: `false`. Establecer en `true` para restaurar la opción | `true` |

227| `showThinkingSummaries` | Mostrar resúmenes de [pensamiento extendido](/es/model-config#extended-thinking) en sesiones interactivas. Cuando no está definido o es `false` (predeterminado en modo interactivo), los bloques de pensamiento se redactan por la API y se muestran como un stub contraído. La redacción solo cambia lo que ve, no lo que genera el modelo: para reducir el gasto de pensamiento, [baje el presupuesto o deshabilite el pensamiento](/es/model-config#extended-thinking) en su lugar. El modo no interactivo (`-p`) y los llamadores de SDK siempre reciben resúmenes independientemente de esta configuración | `true` |227| `showThinkingSummaries` | Mostrar resúmenes de [pensamiento extendido](/es/model-config#extended-thinking) en sesiones interactivas. Cuando no está definido o es `false` (predeterminado en modo interactivo), los bloques de pensamiento se redactan por la API y se muestran como un stub contraído. La redacción solo cambia lo que ve, no lo que genera el modelo: para reducir el gasto de pensamiento, [baje el presupuesto o deshabilite el pensamiento](/es/model-config#extended-thinking) en su lugar. Esta configuración no tiene efecto en modo no interactivo (`-p`), el Agent SDK, o extensiones IDE como VS Code | `true` |

228| `showTurnDuration` | Mostrar mensajes de duración de turno después de respuestas, por ejemplo "Cooked for 1m 6s". Predeterminado: `true`. Aparece en `/config` como **Show turn duration** | `false` |228| `showTurnDuration` | Mostrar mensajes de duración de turno después de respuestas, por ejemplo "Cooked for 1m 6s". Predeterminado: `true`. Aparece en `/config` como **Show turn duration** | `false` |

229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Fracción del contexto del modelo reservada para el [listado de skills](/es/skills#skill-descriptions-are-cut-short) que Claude ve cada turno (predeterminado: `0.01` = 1%). Cuando el listado excede el presupuesto, las descripciones de los skills menos utilizados se contraen a nombres desnudos para que Claude aún pueda invocarlos pero no verá por qué. Aumente para mantener más descripciones visibles al costo de más contexto por turno. `/doctor` muestra el recuento de truncamiento actual y qué skills se ven afectados. Requiere Claude Code v2.1.105 o posterior | `0.02` |229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Fracción del contexto del modelo reservada para el [listado de skills](/es/skills#skill-descriptions-are-cut-short) que Claude ve cada turno (predeterminado: `0.01` = 1%). Cuando el listado excede el presupuesto, las descripciones de los skills menos utilizados se contraen a nombres desnudos para que Claude aún pueda invocarlos pero no verá por qué. Aumente para mantener más descripciones visibles al costo de más contexto por turno. `/doctor` muestra el recuento de truncamiento actual y qué skills se ven afectados. Requiere Claude Code v2.1.105 o posterior | `0.02` |

230| `skillOverrides` | {/* min-version: 2.1.129 */}Anulaciones de visibilidad por skill con clave de nombre de skill. El valor es `"on"`, `"name-only"`, `"user-invocable-only"`, o `"off"`. Permite ocultar o contraer un skill sin editar su SKILL.md. No se aplica a skills de plugin, que se gestionan a través de `/plugin`. El menú `/skills` escribe estos en `.claude/settings.local.json`. Consulte [Anular visibilidad de skill desde configuraciones](/es/skills#override-skill-visibility-from-settings). Requiere Claude Code v2.1.129 o posterior | `{"legacy-context": "name-only", "deploy": "off"}` |230| `skillOverrides` | {/* min-version: 2.1.129 */}Anulaciones de visibilidad por skill con clave de nombre de skill. El valor es `"on"`, `"name-only"`, `"user-invocable-only"`, o `"off"`. Permite ocultar o contraer un skill sin editar su SKILL.md. No se aplica a skills de plugin, que se gestionan a través de `/plugin`. El menú `/skills` escribe estos en `.claude/settings.local.json`. Consulte [Anular visibilidad de skill desde configuraciones](/es/skills#override-skill-visibility-from-settings). Requiere Claude Code v2.1.129 o posterior | `{"legacy-context": "name-only", "deploy": "off"}` |

269| `worktree.baseRef` | Qué ref ramifican los nuevos worktrees. `"fresh"` (predeterminado) ramifica desde `origin/<default-branch>` para un árbol limpio que coincida con el remoto. `"head"` ramifica desde su `HEAD` local actual, por lo que los commits no enviados y el estado de rama de características están presentes en el worktree. Se aplica a `--worktree`, la herramienta `EnterWorktree` y el aislamiento de subagent | `"head"` |269| `worktree.baseRef` | Qué ref ramifican los nuevos worktrees. `"fresh"` (predeterminado) ramifica desde `origin/<default-branch>` para un árbol limpio que coincida con el remoto. `"head"` ramifica desde su `HEAD` local actual, por lo que los commits no enviados y el estado de rama de características están presentes en el worktree. Se aplica a `--worktree`, la herramienta `EnterWorktree` y el aislamiento de subagent | `"head"` |

270| `worktree.symlinkDirectories` | Directorios a enlazar simbólicamente desde el repositorio principal en cada worktree para evitar duplicar directorios grandes en disco. No se enlazan directorios de forma predeterminada | `["node_modules", ".cache"]` |270| `worktree.symlinkDirectories` | Directorios a enlazar simbólicamente desde el repositorio principal en cada worktree para evitar duplicar directorios grandes en disco. No se enlazan directorios de forma predeterminada | `["node_modules", ".cache"]` |

271| `worktree.sparsePaths` | Directorios a verificar en cada worktree a través de git sparse-checkout. Solo las rutas listadas más archivos de nivel raíz se escriben en disco, lo que es más rápido en monorepos grandes | `["packages/my-app", "shared/utils"]` |271| `worktree.sparsePaths` | Directorios a verificar en cada worktree a través de git sparse-checkout. Solo las rutas listadas más archivos de nivel raíz se escriben en disco, lo que es más rápido en monorepos grandes | `["packages/my-app", "shared/utils"]` |

272| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Modo de aislamiento para [sesiones de fondo](/es/agent-view#how-file-edits-are-isolated). `"worktree"` (predeterminado) bloquea `Edit`/`Write` en el checkout principal hasta que se llame a `EnterWorktree`. `"none"` permite que los trabajos de fondo editen la copia de trabajo directamente. Requiere Claude Code v2.1.143 o posterior | `"none"` |

272 273

273Para copiar archivos ignorados por git como `.env` en nuevos worktrees, use un [archivo `.worktreeinclude`](/es/worktrees#copy-gitignored-files-into-worktrees) en la raíz de su proyecto en lugar de una configuración.274Para copiar archivos ignorados por git como `.env` en nuevos worktrees, use un [archivo `.worktreeinclude`](/es/worktrees#copy-gitignored-files-into-worktrees) en la raíz de su proyecto en lugar de una configuración.

274 275

275### Configuración de permisos276### Configuración de permisos

276 277

278| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |279| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

279| `allow` | Matriz de reglas de permiso para permitir el uso de herramientas. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) a continuación para detalles de coincidencia de patrones | `[ "Bash(git diff *)" ]` |280| `allow` | Matriz de reglas de permiso para permitir el uso de herramientas. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) a continuación para detalles de coincidencia de patrones | `[ "Bash(git diff *)" ]` |

280| `ask` | Matriz de reglas de permiso para pedir confirmación al usar herramientas. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) a continuación | `[ "Bash(git push *)" ]` |281| `ask` | Matriz de reglas de permiso para pedir confirmación al usar herramientas. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) a continuación | `[ "Bash(git push *)" ]` |

281| `deny` | Matriz de reglas de permiso para denegar el uso de herramientas. Use esto para excluir archivos sensibles del acceso de Claude Code. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) y [Limitaciones de permiso de Bash](/es/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |282| `deny` | Matriz de reglas de permiso para denegar el uso de herramientas. Use esto para excluir archivos sensibles del acceso de Claude Code. Consulte [Sintaxis de regla de permiso](#permission-rule-syntax) y [Limitaciones de permiso de Bash](/es/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

282| `additionalDirectories` | [Directorios de trabajo](/es/permissions#working-directories) adicionales para acceso a archivos. La mayoría de la configuración de `.claude/` [no se descubre](/es/permissions#additional-directories-grant-file-access-not-configuration) desde estos directorios | `[ "../docs/" ]` |283| `additionalDirectories` | [Directorios de trabajo](/es/permissions#working-directories) adicionales para acceso a archivos. La mayoría de la configuración de `.claude/` [no se descubre](/es/permissions#additional-directories-grant-file-access-not-configuration) desde estos directorios | `[ "../docs/" ]` |

283| `defaultMode` | [Modo de permiso](/es/permission-modes) predeterminado al abrir Claude Code. Valores válidos: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. La bandera CLI `--permission-mode` anula esta configuración para una única sesión | `"acceptEdits"` |284| `defaultMode` | [Modo de permiso](/es/permission-modes) predeterminado al abrir Claude Code. Valores válidos: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}A partir de Claude Code v2.1.142, `auto` se ignora cuando se establece en configuraciones de proyecto o local (`.claude/settings.json`, `.claude/settings.local.json`) para que un repositorio no pueda otorgarse a sí mismo modo automático. Establézcalo en `~/.claude/settings.json` en su lugar. La bandera CLI `--permission-mode` anula esta configuración para una única sesión | `"acceptEdits"` |

284| `disableBypassPermissionsMode` | Establecer en `"disable"` para evitar que se active el modo `bypassPermissions`. Esto deshabilita la bandera de línea de comandos `--dangerously-skip-permissions`. Típicamente colocado en [configuraciones administradas](/es/permissions#managed-settings) para aplicar política organizacional, pero funciona desde cualquier ámbito | `"disable"` |285| `disableBypassPermissionsMode` | Establecer en `"disable"` para evitar que se active el modo `bypassPermissions`. Esto deshabilita la bandera de línea de comandos `--dangerously-skip-permissions`. Típicamente colocado en [configuraciones administradas](/es/permissions#managed-settings) para aplicar política organizacional, pero funciona desde cualquier ámbito | `"disable"` |

285| `skipDangerousModePermissionPrompt` | Omitir el aviso de confirmación mostrado antes de entrar en modo de permisos de derivación a través de `--dangerously-skip-permissions` o `defaultMode: "bypassPermissions"`. Se ignora cuando se establece en configuraciones de proyecto (`.claude/settings.json`) para evitar que repositorios no confiables omitan automáticamente el aviso | `true` |286| `skipDangerousModePermissionPrompt` | Omitir el aviso de confirmación mostrado antes de entrar en modo de permisos de derivación a través de `--dangerously-skip-permissions` o `defaultMode: "bypassPermissions"`. Se ignora cuando se establece en configuraciones de proyecto (`.claude/settings.json`) para evitar que repositorios no confiables omitan automáticamente el aviso | `true` |

286 287

510 * Políticas implementadas por TI a través de entrega de servidor, perfiles de configuración MDM, políticas de registro o archivos de configuración administrados511 * Políticas implementadas por TI a través de entrega de servidor, perfiles de configuración MDM, políticas de registro o archivos de configuración administrados

511 * No pueden ser anuladas por ningún otro nivel, incluyendo argumentos de línea de comandos512 * No pueden ser anuladas por ningún otro nivel, incluyendo argumentos de línea de comandos

512 * Dentro del nivel administrado, la precedencia es: administrado por servidor > políticas de MDM/nivel de SO > archivo basado (`managed-settings.d/*.json` + `managed-settings.json`) > registro HKCU (solo Windows). Solo se usa una fuente administrada; las fuentes no se fusionan entre niveles. Dentro del nivel basado en archivos, los archivos de entrega y el archivo base se fusionan juntos.513 * Dentro del nivel administrado, la precedencia es: administrado por servidor > políticas de MDM/nivel de SO > archivo basado (`managed-settings.d/*.json` + `managed-settings.json`) > registro HKCU (solo Windows). Solo se usa una fuente administrada; las fuentes no se fusionan entre niveles. Dentro del nivel basado en archivos, los archivos de entrega y el archivo base se fusionan juntos.

514 * Los hosts de incrustación como Claude Desktop pueden suministrar política a través de la opción SDK `managedSettings`. De forma predeterminada, esto se ignora cuando está presente cualquier nivel administrado. Los administradores pueden optar por establecer [`parentSettingsBehavior`](#available-settings) en `"merge"`. Los valores del incrustador se filtran para que puedan restringir la política administrada pero no flexibilizarla.

513 515

5142. **Argumentos de línea de comandos**5162. **Argumentos de línea de comandos**

515 * Anulaciones temporales para una sesión específica. JSON pasado a través de `--settings <file-or-json>` se fusiona con configuraciones basadas en archivos usando las mismas reglas que las otras capas: una clave establecida aquí anula la misma clave en configuraciones locales, de proyecto o de usuario, y omitir una clave deja el valor de capa inferior en su lugar517 * Anulaciones temporales para una sesión específica. JSON pasado a través de `--settings <file-or-json>` se fusiona con configuraciones basadas en archivos usando las mismas reglas que las otras capas: una clave establecida aquí anula la misma clave en configuraciones locales, de proyecto o de usuario, y omitir una clave deja el valor de capa inferior en su lugar

525 527

526Esta jerarquía asegura que las políticas organizacionales siempre se apliquen mientras aún permite que equipos e individuos personalicen su experiencia. La misma precedencia se aplica si ejecuta Claude Code desde la CLI, la [extensión de VS Code](/es/vs-code), o un [IDE de JetBrains](/es/jetbrains).528Esta jerarquía asegura que las políticas organizacionales siempre se apliquen mientras aún permite que equipos e individuos personalicen su experiencia. La misma precedencia se aplica si ejecuta Claude Code desde la CLI, la [extensión de VS Code](/es/vs-code), o un [IDE de JetBrains](/es/jetbrains).

527 529

528Por ejemplo, si su configuración de usuario permite `Bash(npm run *)` pero la configuración compartida de un proyecto la deniega, la configuración del proyecto tiene precedencia y el comando se bloquea.530Por ejemplo, si su configuración de usuario establece `permissions.defaultMode` en `acceptEdits` y la configuración compartida de un proyecto la establece en `default`, el valor del proyecto se aplica. El ejemplo a continuación cubre cómo se combinan las configuraciones con valores de matriz como reglas de permiso en su lugar.

529 531

530<Note>532<Note>

531 **Las configuraciones de matriz se fusionan entre ámbitos.** Cuando la misma configuración con valor de matriz (como `sandbox.filesystem.allowWrite` o `permissions.allow`) aparece en múltiples ámbitos, las matrices se **concatenan y se deduplicán**, no se reemplazan. Esto significa que los ámbitos de menor prioridad pueden agregar entradas sin anular las establecidas por ámbitos de mayor prioridad, y viceversa. Por ejemplo, si las configuraciones administradas establecen `allowWrite` en `["/opt/company-tools"]` y un usuario agrega `["~/.kube"]`, ambas rutas se incluyen en la configuración final.533 **Las configuraciones de matriz se fusionan entre ámbitos.** Cuando la misma configuración con valor de matriz (como `sandbox.filesystem.allowWrite` o `permissions.allow`) aparece en múltiples ámbitos, las matrices se **concatenan y se deduplicán**, no se reemplazan. Esto significa que los ámbitos de menor prioridad pueden agregar entradas sin anular las establecidas por ámbitos de mayor prioridad, y viceversa. Por ejemplo, si las configuraciones administradas establecen `allowWrite` en `["/opt/company-tools"]` y un usuario agrega `["~/.kube"]`, ambas rutas se incluyen en la configuración final.

skills.md +3 −3

Details

437Los skills y los [subagents](/es/sub-agents) funcionan juntos en dos direcciones:437Los skills y los [subagents](/es/sub-agents) funcionan juntos en dos direcciones:

438 438

440| :-------------------------- | :------------------------------------------ | :------------------------------ | :----------------------------- |440| :-------------------------- | :--------------------------- | :------------------------------ | :--------------------------------------------------- |

443 443

444Con `context: fork`, escribe la tarea en tu skill y elige un tipo de agent para ejecutarla. Para lo inverso (definir un subagent personalizado que use skills como material de referencia), consulte [Subagents](/es/sub-agents#preload-skills-into-subagents).444Con `context: fork`, escribe la tarea en tu skill y elige un tipo de agent para ejecutarla. Los agents integrados Explore y Plan [omiten CLAUDE.md y git status](/es/sub-agents#what-loads-at-startup) para mantener su contexto pequeño, por lo que un skill bifurcado usando `agent: Explore` solo ve el contenido de SKILL.md y el prompt del sistema del agent. Para lo inverso, donde define un subagent personalizado que usa skills como material de referencia, consulte [Subagents](/es/sub-agents#preload-skills-into-subagents).

445 445

446#### Ejemplo: Skill de investigación usando agent Explore446#### Ejemplo: Skill de investigación usando agent Explore

447 447

statusline.md +6 −1

Details

916 916

917### Configuración de Windows917### Configuración de Windows

918 918

919En Windows, Claude Code ejecuta comandos de línea de estado a través de Git Bash cuando Git Bash está instalado, o a través de PowerShell cuando Git Bash está ausente. Para ejecutar un script de PowerShell como tu línea de estado, invócalo mediante `powershell`; esto funciona desde cualquier shell:919En Windows, Claude Code ejecuta comandos de línea de estado a través de Git Bash cuando Git Bash está instalado, o a través de PowerShell cuando Git Bash está ausente.

920

921Git Bash trata las barras invertidas sin comillas como caracteres de escape, por lo que una ruta de estilo Windows como `C:\Users\username\script.mjs` llega al ejecutor de scripts con sus separadores eliminados y el comando falla sin un error visible. Escribe rutas de archivo en la cadena `command` con barras diagonales, como se muestra en los ejemplos a continuación. El atajo `~` también funciona y se expande a tu directorio de inicio de Windows.

922

923Para ejecutar un script de PowerShell como tu línea de estado, invócalo mediante `powershell`. Esto funciona ya sea que Claude Code enrute el comando a través de Git Bash o PowerShell:

920 924

921<CodeGroup>925<CodeGroup>

922 ```json settings.json theme={null}926 ```json settings.json theme={null}

999* Verifica que tu script sea ejecutable: `chmod +x ~/.claude/statusline.sh`1003* Verifica que tu script sea ejecutable: `chmod +x ~/.claude/statusline.sh`

1000* Comprueba que tu script genere salida a stdout, no stderr1004* Comprueba que tu script genere salida a stdout, no stderr

1001* Ejecuta tu script manualmente para verificar que produce salida1005* Ejecuta tu script manualmente para verificar que produce salida

1006* En Windows con Git Bash instalado, es probable que las barras invertidas en la ruta del `command` se consuman como caracteres de escape antes de que se ejecute el script. Usa barras diagonales en la ruta. Consulta [Configuración de Windows](#windows-configuration).

1002* Si `disableAllHooks` está establecido en `true` en tu configuración, la línea de estado también está deshabilitada. Elimina esta configuración o establécela en `false` para volver a habilitarla.1007* Si `disableAllHooks` está establecido en `true` en tu configuración, la línea de estado también está deshabilitada. Elimina esta configuración o establécela en `false` para volver a habilitarla.

1003* Ejecuta `claude --debug` para registrar el código de salida y stderr de la primera invocación de línea de estado en una sesión1008* Ejecuta `claude --debug` para registrar el código de salida y stderr de la primera invocación de línea de estado en una sesión

1004* Pídele a Claude que lea tu archivo de configuración y ejecute el comando `statusLine` directamente para exponer errores1009* Pídele a Claude que lea tu archivo de configuración y ejecute el comando `statusLine` directamente para exponer errores

sub-agents.md +32 −2

Details

37 37

38Claude Code incluye subagentes integrados que Claude utiliza automáticamente cuando es apropiado. Cada uno hereda los permisos de la conversación principal con restricciones de herramientas adicionales.38Claude Code incluye subagentes integrados que Claude utiliza automáticamente cuando es apropiado. Cada uno hereda los permisos de la conversación principal con restricciones de herramientas adicionales.

39 39

40Explore y Plan omiten sus archivos CLAUDE.md y el estado de git de la sesión principal para mantener la investigación rápida y económica. Todos los demás subagentes integrados y [subagentes personalizados](#configure-subagents) cargan ambos. Para el desglose completo de lo que llega a un subagente, consulte [qué se carga al iniciar](#what-loads-at-startup).

40<Tabs>42<Tabs>

41 <Tab title="Explore">43 <Tab title="Explore">

42 Un agente rápido y de solo lectura optimizado para buscar y analizar bases de código.44 Un agente rápido y de solo lectura optimizado para buscar y analizar bases de código.

652 654

653Esto funciona con subagentes integrados y personalizados, y la opción persiste cuando reanuda la sesión.655Esto funciona con subagentes integrados y personalizados, y la opción persiste cuando reanuda la sesión.

654 656

655Para un subagente proporcionado por plugin, pase el nombre con alcance: `claude --agent <plugin-name>:<agent-name>`. Si el plugin coloca el agente en una subcarpeta de su directorio `agents/`, incluya la subcarpeta en el nombre con alcance, por ejemplo `claude --agent my-plugin:review:security`.657Para un subagente proporcionado por plugin, puede pasar solo el nombre del agente y Claude Code lo encontrará:

658

659```bash theme={null}

660claude --agent security-reviewer

661```

662

663Si múltiples plugins proporcionan agentes con el mismo nombre, pase el nombre con alcance para desambiguar:

664

665```bash theme={null}

666claude --agent my-plugin:security-reviewer

667```

668

669Si el plugin coloca el agente en una subcarpeta de su directorio `agents/`, incluya la subcarpeta en el nombre con alcance, por ejemplo `claude --agent my-plugin:review:security`.

656 670

657Para hacerlo el predeterminado para cada sesión en un proyecto, establezca `agent` en `.claude/settings.json`:671Para hacerlo el predeterminado para cada sesión en un proyecto, establezca `agent` en `.claude/settings.json`:

658 672

741 755

742### Administrar contexto de subagentes756### Administrar contexto de subagentes

743 757

758#### Qué se carga al inicio

759

760Cada subagente comienza con una ventana de contexto fresca e aislada. No ve su historial de conversación, las habilidades que ya ha invocado, o los archivos que Claude ya ha leído. Claude compone un mensaje de delegación que resume la tarea, y el subagente trabaja a partir de ahí. La excepción es un [fork](#fork-the-current-conversation), que hereda la conversación principal en lugar de comenzar de nuevo.

761

762El contexto inicial de un subagente que no es fork contiene:

763

764* **Mensaje del sistema**: el mensaje del agente propio más detalles de entorno que Claude Code añade, no el mensaje del sistema completo de Claude Code. Los subagentes personalizados definen el suyo en el [cuerpo markdown](#write-subagent-files) o campo `prompt`. Los agentes integrados tienen mensajes predefinidos.

765* **Mensaje de tarea**: el mensaje de delegación que Claude escribe cuando entrega el trabajo.

766* **CLAUDE.md y memoria**: cada nivel de la [jerarquía de memoria](/es/memory#how-claude-md-files-load) que la conversación principal carga, incluyendo `~/.claude/CLAUDE.md`, reglas del proyecto, `CLAUDE.local.md` y archivos de política administrados. Los agentes Explore y Plan integrados omiten esto.

767* **Estado de Git**: una instantánea tomada al inicio de la sesión principal. Ausente cuando el directorio de trabajo no es un repositorio de Git o cuando [`includeGitInstructions`](/es/settings#available-settings) es `false`. Explore y Plan lo omiten de todas formas.

768* **Habilidades precargadas**: contenido completo de cualquier habilidad nombrada en el campo [`skills`](#preload-skills-into-subagents) del agente. Los agentes integrados no precargan habilidades.

769

770Explore y Plan son los únicos subagentes que omiten CLAUDE.md y estado de Git. No hay campo de frontmatter o configuración por agente para cambiar qué agentes los omiten.

771

772La conversación principal lee resultados de Explore y Plan con contexto completo de CLAUDE.md, por lo que la mayoría de reglas no necesitan llegar al subagente en sí. Si una regla debe, como "ignore el directorio `vendor/`", restate la en el mensaje que da a Claude cuando delega.

773

744#### Reanudar subagentes774#### Reanudar subagentes

745 775

746Cada invocación de subagente crea una nueva instancia con contexto fresco. Para continuar el trabajo de un subagente existente en lugar de comenzar de nuevo, pida a Claude que lo reanude.776Cada invocación de subagente crea una nueva instancia con contexto fresco. Para continuar el trabajo de un subagente existente en lugar de comenzar de nuevo, pida a Claude que lo reanude.

747 777

748Los subagentes reanudados retienen su historial de conversación completo, incluidas todas las llamadas de herramientas anteriores, resultados y razonamiento. El subagente continúa exactamente donde se detuvo en lugar de comenzar de nuevo.778Los subagentes reanudados retienen su historial de conversación completo, incluyendo todas las llamadas de herramientas anteriores, resultados y razonamiento. El subagente continúa exactamente donde se detuvo en lugar de comenzar de nuevo.

749 779

750Cuando un subagente se completa, Claude recibe su ID de agente. Claude usa la herramienta `SendMessage` con el ID del agente como campo `to` para reanudarlo. La herramienta `SendMessage` solo está disponible cuando [equipos de agentes](/es/agent-teams) están habilitados a través de `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.780Cuando un subagente se completa, Claude recibe su ID de agente. Claude usa la herramienta `SendMessage` con el ID del agente como campo `to` para reanudarlo. La herramienta `SendMessage` solo está disponible cuando [equipos de agentes](/es/agent-teams) están habilitados a través de `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.

751 781

tools-reference.md +2 −1

Details

45| `TaskUpdate` | Actualiza el estado de la tarea, dependencias, detalles, o elimina tareas | No |45| `TaskUpdate` | Actualiza el estado de la tarea, dependencias, detalles, o elimina tareas | No |

46| `TeamCreate` | Crea un [equipo de agentes](/es/agent-teams) con múltiples compañeros de equipo. Solo disponible cuando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está establecido | No |46| `TeamCreate` | Crea un [equipo de agentes](/es/agent-teams) con múltiples compañeros de equipo. Solo disponible cuando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está establecido | No |

47| `TeamDelete` | Disuelve un equipo de agentes y limpia los procesos de compañeros de equipo. Solo disponible cuando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está establecido | No |47| `TeamDelete` | Disuelve un equipo de agentes y limpia los procesos de compañeros de equipo. Solo disponible cuando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está establecido | No |

48| `TodoWrite` | Gestiona la lista de verificación de tareas de la sesión. Disponible en modo no interactivo y el [Agent SDK](/es/headless); las sesiones interactivas utilizan TaskCreate, TaskGet, TaskList y TaskUpdate en su lugar | No |48| `TodoWrite` | {/* min-version: 2.1.142 */}Gestiona la lista de verificación de tareas de la sesión. Deshabilitado por defecto a partir de v2.1.142 en favor de `TaskCreate`, `TaskGet`, `TaskList` y `TaskUpdate`. Establezca `CLAUDE_CODE_ENABLE_TASKS=0` para volver a habilitar | No |

49| `ToolSearch` | Busca y carga herramientas diferidas cuando [búsqueda de herramientas](/es/mcp#scale-with-mcp-tool-search) está habilitada | No |49| `ToolSearch` | Busca y carga herramientas diferidas cuando [búsqueda de herramientas](/es/mcp#scale-with-mcp-tool-search) está habilitada | No |

50| `WaitForMcpServers` | {/* min-version: 2.1.142 */}Espera a uno o más [servidores MCP](/es/mcp) que aún se están conectando en segundo plano, para que una solicitud pueda usar sus herramientas sin reiniciar la sesión. Claude lo llama cuando un servidor necesario aún no está conectado. Solo aparece cuando [búsqueda de herramientas](/es/mcp#scale-with-mcp-tool-search) está deshabilitada, ya que `ToolSearch` maneja la espera cuando está habilitada | No |

50| `WebFetch` | Obtiene contenido de una URL especificada. Consulte [comportamiento de la herramienta WebFetch](#webfetch-tool-behavior) | Sí |51| `WebFetch` | Obtiene contenido de una URL especificada. Consulte [comportamiento de la herramienta WebFetch](#webfetch-tool-behavior) | Sí |

51| `WebSearch` | Realiza búsquedas web. Consulte [comportamiento de la herramienta WebSearch](#websearch-tool-behavior) | Sí |52| `WebSearch` | Realiza búsquedas web. Consulte [comportamiento de la herramienta WebSearch](#websearch-tool-behavior) | Sí |

52| `Write` | Crea o sobrescribe archivos. Consulte [comportamiento de la herramienta Write](#write-tool-behavior) | Sí |53| `Write` | Crea o sobrescribe archivos. Consulte [comportamiento de la herramienta Write](#write-tool-behavior) | Sí |

ultrareview.md +13 −13

Details

46 46

47## Precios y ejecuciones gratuitas47## Precios y ejecuciones gratuitas

48 48

~~49Ultrareview es una característica premium que se factura contra el uso adicional en lugar del uso incluido en tu plan.~~49Ultrareview es una característica premium que se factura contra créditos de uso en lugar del uso incluido en su plan.

50 50

~~52| ----------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |~~52| ----------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------- |

~~53| Pro | 3 ejecuciones gratuitas | facturado como [uso adicional](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) |~~53| Pro | 3 ejecuciones gratuitas | facturado como [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) |

~~54| Max | 3 ejecuciones gratuitas | facturado como [uso adicional](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) |~~54| Max | 3 ejecuciones gratuitas | facturado como [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) |

56 56

57Los suscriptores de Pro y Max reciben tres ejecuciones gratuitas de ultrareview para probar la característica. Estas tres ejecuciones son una asignación única por cuenta y no se renuevan. Después de usar las tres, o después de que finalice el período de ejecuciones gratuitas, cada revisión se factura al uso adicional y típicamente cuesta entre $5 y $20 dependiendo del tamaño del cambio. Una ejecución se cuenta una vez que la sesión remota comienza, por lo que una revisión que detengas temprano o que no se complete correctamente sigue utilizando una ejecución gratuita. Para una revisión pagada, el uso adicional se factura solo por la porción que se ejecutó.57Los suscriptores de Pro y Max reciben tres ejecuciones gratuitas de ultrareview para probar la característica. Estas tres ejecuciones son una asignación única por cuenta y no se renuevan. Después de usar las tres, o después de que finalice el período de ejecuciones gratuitas, cada revisión se factura a los créditos de uso y típicamente cuesta entre $5 y $20 dependiendo del tamaño del cambio. Una ejecución se cuenta una vez que la sesión remota comienza, por lo que una revisión que detenga temprano o que no se complete correctamente sigue utilizando una ejecución gratuita. Para una revisión pagada, los créditos de uso se facturan solo por la porción que se ejecutó.

58 58

59Debido a que ultrareview siempre se factura como uso adicional fuera de las ejecuciones gratuitas, tu cuenta u organización debe tener el uso adicional habilitado antes de poder lanzar una revisión pagada. Si el uso adicional no está habilitado, Claude Code bloquea el lanzamiento y te vincula a la configuración de facturación donde puedes activarlo. También puedes ejecutar `/extra-usage` para verificar o cambiar tu configuración actual.59Debido a que ultrareview siempre se factura como créditos de uso fuera de las ejecuciones gratuitas, su cuenta u organización debe tener los créditos de uso habilitados antes de poder lanzar una revisión pagada. Si los créditos de uso no están habilitados, Claude Code bloquea el lanzamiento y le vincula a la configuración de facturación donde puede activarlos. También puede ejecutar `/usage-credits` para verificar o cambiar su configuración actual.

60 60

61## Rastrear una revisión en ejecución61## Rastrear una revisión en ejecución

62 62

89 89

90## Cómo ultrareview se compara con /review90## Cómo ultrareview se compara con /review

91 91

~~92Ambos comandos revisan código, pero se dirigen a diferentes etapas de tu flujo de trabajo.~~92Ambos comandos revisan código, pero se dirigen a diferentes etapas de su flujo de trabajo.

93 93

94| | `/review` | `/ultrareview` |94| | `/review` | `/ultrareview` |

~~95| ----------- | ---------------------------------------- | ------------------------------------------------------------------------------------- |~~95| ----------- | --------------------------------------- | --------------------------------------------------------------------------------------- |

101 101

102Usa `/review` para retroalimentación rápida mientras trabajas. Usa `/ultrareview` antes de fusionar un cambio sustancial cuando deseas una pasada más profunda que detecte problemas que una revisión única podría perder.102Utilice `/review` para retroalimentación rápida mientras trabaja. Utilice `/ultrareview` antes de fusionar un cambio sustancial cuando desee una pasada más profunda que detecte problemas que una revisión única podría perder.

103 103

104## Recursos relacionados104## Recursos relacionados

105 105

Documentation 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC