Documentation 2026-10-29 23:57 UTC to 2026-10-30 23:01 UTC

77* **Python:** verifique los tipos de mensajes con `isinstance()` contra clases importadas de `claude_agent_sdk` (por ejemplo, `isinstance(message, ResultMessage)`).77* **Python:** verifique los tipos de mensajes con `isinstance()` contra clases importadas de `claude_agent_sdk` (por ejemplo, `isinstance(message, ResultMessage)`).

78* **TypeScript:** verifique el campo de cadena `type` (por ejemplo, `message.type === "result"`). `AssistantMessage` y `UserMessage` envuelven el mensaje de API sin procesar en un campo `.message`, por lo que los bloques de contenido están en `message.message.content`, no en `message.content`.78* **TypeScript:** verifique el campo de cadena `type` (por ejemplo, `message.type === "result"`). `AssistantMessage` y `UserMessage` envuelven el mensaje de API sin procesar en un campo `.message`, por lo que los bloques de contenido están en `message.message.content`, no en `message.content`.

79 79 

80> **Ejemplo: Verificar tipos de mensajes y manejar resultados**80> [accordion] Ejemplo: Verificar tipos de mensajes y manejar resultados

81>81>

82> ```python Python theme={null}82> ```python Python theme={null}

83> import asyncio83> import asyncio

273* **Hook `PreCompact`:** Ejecute lógica personalizada antes de que ocurra la compactación, por ejemplo para archivar la transcripción completa. El hook recibe un campo `trigger` (`manual` o `auto`). Vea [hooks](https://code.claude.com/docs/es/agent-sdk/hooks.md).273* **Hook `PreCompact`:** Ejecute lógica personalizada antes de que ocurra la compactación, por ejemplo para archivar la transcripción completa. El hook recibe un campo `trigger` (`manual` o `auto`). Vea [hooks](https://code.claude.com/docs/es/agent-sdk/hooks.md).

274* **Compactación manual:** Envíe `/compact` como una cadena de prompt para activar la compactación bajo demanda. Los comandos enviados de esta manera son entradas de SDK ordinarias. Vea [dispatch commands by name](https://code.claude.com/docs/es/agent-sdk/skills.md#dispatch-commands-by-name).274* **Compactación manual:** Envíe `/compact` como una cadena de prompt para activar la compactación bajo demanda. Los comandos enviados de esta manera son entradas de SDK ordinarias. Vea [dispatch commands by name](https://code.claude.com/docs/es/agent-sdk/skills.md#dispatch-commands-by-name).

275 275 

276> **Ejemplo: Instrucciones de resumen en CLAUDE.md**276> [accordion] Ejemplo: Instrucciones de resumen en CLAUDE.md

277>277>

278> Agregue una sección al CLAUDE.md de su proyecto diciéndole al compactador qué preservar. El nombre del encabezado no es especial; use cualquier etiqueta clara.278> Agregue una sección al CLAUDE.md de su proyecto diciéndole al compactador qué preservar. El nombre del encabezado no es especial; use cualquier etiqueta clara.

279>279>

42 42 

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

44 44 

45**Python (uv)**45> [tab] Python (uv)

46 46>

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

48uv add httpx48> uv add httpx

49```49> ```

50 

51**Python (pip)**

52 50 

53```bash theme={null}51> [tab] Python (pip)

54pip install httpx52>

55```53> ```bash theme={null}

54> pip install httpx

55> ```

56 56 

57### Ejemplo de herramienta meteorológica57### Ejemplo de herramienta meteorológica

58 58 

198 198 

199Combina este fragmento con las definiciones de herramienta y servidor del [ejemplo de herramienta meteorológica](#weather-tool-example) en un archivo, `weather.py` o `weather.ts`, y luego ejecútalo desde tu terminal:199Combina este fragmento con las definiciones de herramienta y servidor del [ejemplo de herramienta meteorológica](#weather-tool-example) en un archivo, `weather.py` o `weather.ts`, y luego ejecútalo desde tu terminal:

200 200 

201**TypeScript**201> [tab] TypeScript

202 202>

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

204npx tsx weather.ts204> npx tsx weather.ts

205```205> ```

206 

207**Python (uv)**

208 

209```bash theme={null}

210uv run weather.py

211```

212 

213**Python (pip)**

214 206 

215Activa el entorno virtual donde instalaste el SDK y luego ejecuta:207> [tab] Python (uv)

208>

209> ```bash theme={null}

210> uv run weather.py

211> ```

216 212 

217```bash theme={null}213> [tab] Python (pip)

218python weather.py214>

219```215> Activa el entorno virtual donde instalaste el SDK y luego ejecuta:

216>

217> ```bash theme={null}

218> python weather.py

219> ```

220 220 

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

222 222 

585>585>

586> Abra su archivo de utilidad (`utils.py` o `utils.ts`) en su IDE o editor antes de ejecutar el script. Verá que el archivo se actualiza en tiempo real mientras el agente agrega comentarios de documentación, luego revierte al original cuando elige revertir.586> Abra su archivo de utilidad (`utils.py` o `utils.ts`) en su IDE o editor antes de ejecutar el script. Verá que el archivo se actualiza en tiempo real mientras el agente agrega comentarios de documentación, luego revierte al original cuando elige revertir.

587 587 

588**Python**588> [tab] Python

589 589>

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

591python try_checkpointing.py591> python try_checkpointing.py

592```592> ```

593 

594**TypeScript**

595 593 

596```bash theme={null}594> [tab] TypeScript

597npx tsx try_checkpointing.ts595>

598```596> ```bash theme={null}

597> npx tsx try_checkpointing.ts

598> ```

599 599 

600Verá que el agente agrega comentarios de documentación, luego un mensaje preguntando si desea revertir. Si elige sí, el archivo se restaura a su estado original.600Verá que el agente agrega comentarios de documentación, luego un mensaje preguntando si desea revertir. Si elige sí, el archivo se restaura a su estado original.

601 601 

386 386 

387Use el campo `env` para pasar claves API, tokens y otras credenciales al servidor MCP:387Use el campo `env` para pasar claves API, tokens y otras credenciales al servidor MCP:

388 388 

389**En código**389> [tab] En código

390 390>

391```typescript TypeScript hidelines={1,-1} theme={null}391> ```typescript TypeScript hidelines={1,-1} theme={null}

392const _ = {392> const _ = {

393 options: {393> options: {

394 mcpServers: {394> mcpServers: {

395 "api-server": {395> "api-server": {

396 command: "npx",396> command: "npx",

397 args: ["-y", "@your-org/api-mcp-server"],397> args: ["-y", "@your-org/api-mcp-server"],

398 env: {398> env: {

399 API_KEY: process.env.API_KEY399> API_KEY: process.env.API_KEY

400 }400> }

401 }401> }

402 },402> },

403 allowedTools: ["mcp__api-server__*"]403> allowedTools: ["mcp__api-server__*"]

404 }404> }

405};405> };

406```406> ```

407 407>

408```python Python theme={null}408> ```python Python theme={null}

409options = ClaudeAgentOptions(409> options = ClaudeAgentOptions(

410 mcp_servers={410> mcp_servers={

411 "api-server": {411> "api-server": {

412 "command": "npx",412> "command": "npx",

413 "args": ["-y", "@your-org/api-mcp-server"],413> "args": ["-y", "@your-org/api-mcp-server"],

414 "env": {"API_KEY": os.environ["API_KEY"]},414> "env": {"API_KEY": os.environ["API_KEY"]},

415 }415> }

416 },416> },

417 allowed_tools=["mcp__api-server__*"],417> allowed_tools=["mcp__api-server__*"],

418)418> )

419```419> ```

420 420 

421**.mcp.json**421> [tab] .mcp.json

422 422>

423```json theme={null}423> ```json theme={null}

424{424> {

425 "mcpServers": {425> "mcpServers": {

426 "api-server": {426> "api-server": {

427 "command": "npx",427> "command": "npx",

428 "args": ["-y", "@your-org/api-mcp-server"],428> "args": ["-y", "@your-org/api-mcp-server"],

429 "env": {429> "env": {

430 "API_KEY": "${API_KEY}"430> "API_KEY": "${API_KEY}"

431 }431> }

432 }432> }

433 }433> }

434}434> }

435```435> ```

436 436>

437La sintaxis `${API_KEY}` expande variables de entorno en tiempo de ejecución.437> La sintaxis `${API_KEY}` expande variables de entorno en tiempo de ejecución.

438 438 

439### Encabezados HTTP para servidores remotos439### Encabezados HTTP para servidores remotos

440 440 

441Para servidores HTTP y SSE, pase los encabezados de autenticación directamente en la configuración del servidor:441Para servidores HTTP y SSE, pase los encabezados de autenticación directamente en la configuración del servidor:

442 442 

443**En código**443> [tab] En código

444 444>

445```typescript TypeScript hidelines={1,-1} theme={null}445> ```typescript TypeScript hidelines={1,-1} theme={null}

446const _ = {446> const _ = {

447 options: {447> options: {

448 mcpServers: {448> mcpServers: {

449 "secure-api": {449> "secure-api": {

450 type: "http",450> type: "http",

451 url: "https://api.example.com/mcp",451> url: "https://api.example.com/mcp",

452 headers: {452> headers: {

453 Authorization: `Bearer ${process.env.API_TOKEN}`453> Authorization: `Bearer ${process.env.API_TOKEN}`

454 }454> }

455 }455> }

456 },456> },

457 allowedTools: ["mcp__secure-api__*"]457> allowedTools: ["mcp__secure-api__*"]

458 }458> }

459};459> };

460```460> ```

461 461>

462```python Python theme={null}462> ```python Python theme={null}

463options = ClaudeAgentOptions(463> options = ClaudeAgentOptions(

464 mcp_servers={464> mcp_servers={

465 "secure-api": {465> "secure-api": {

466 "type": "http",466> "type": "http",

467 "url": "https://api.example.com/mcp",467> "url": "https://api.example.com/mcp",

468 "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},468> "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},

469 }469> }

470 },470> },

471 allowed_tools=["mcp__secure-api__*"],471> allowed_tools=["mcp__secure-api__*"],

472)472> )

473```473> ```

474 474 

475**.mcp.json**475> [tab] .mcp.json

476 476>

477```json theme={null}477> ```json theme={null}

478{478> {

479 "mcpServers": {479> "mcpServers": {

480 "secure-api": {480> "secure-api": {

481 "type": "http",481> "type": "http",

482 "url": "https://api.example.com/mcp",482> "url": "https://api.example.com/mcp",

483 "headers": {483> "headers": {

484 "Authorization": "Bearer ${API_TOKEN}"484> "Authorization": "Bearer ${API_TOKEN}"

485 }485> }

486 }486> }

487 }487> }

488}488> }

489```489> ```

490 490>

491La sintaxis `${API_TOKEN}` expande variables de entorno en tiempo de ejecución.491> La sintaxis `${API_TOKEN}` expande variables de entorno en tiempo de ejecución.

492 492 

493Para un ejemplo completo y funcional de un servidor remoto autenticado con encabezados, consulte [Listar problemas de un repositorio](#list-issues-from-a-repository).493Para un ejemplo completo y funcional de un servidor remoto autenticado con encabezados, consulte [Listar problemas de un repositorio](#list-issues-from-a-repository).

494 494 

163 163 

164Puede establecer el modo de permisos una vez al iniciar una consulta, o cambiarlo dinámicamente mientras la sesión está activa.164Puede establecer el modo de permisos una vez al iniciar una consulta, o cambiarlo dinámicamente mientras la sesión está activa.

165 165 

166**En el momento de la consulta**166> [tab] En el momento de la consulta

167 167>

168Pasa `permission_mode` (Python) o `permissionMode` (TypeScript) al crear una consulta.168> Pasa `permission_mode` (Python) o `permissionMode` (TypeScript) al crear una consulta.

169 169>

170```python Python theme={null}170> ```python Python theme={null}

171import asyncio171> import asyncio

172from claude_agent_sdk import query, ClaudeAgentOptions172> from claude_agent_sdk import query, ClaudeAgentOptions

173 173>

174 174>

175async def main():175> async def main():

176 async for message in query(176> async for message in query(

177 prompt="Help me refactor this code",177> prompt="Help me refactor this code",

178 options=ClaudeAgentOptions(178> options=ClaudeAgentOptions(

179 permission_mode="default", # Set the mode here179> permission_mode="default", # Set the mode here

180 ),180> ),

181 ):181> ):

182 if hasattr(message, "result"):182> if hasattr(message, "result"):

183 print(message.result)183> print(message.result)

184 184>

185 185>

186asyncio.run(main())186> asyncio.run(main())

187```187> ```

188 188>

189```typescript TypeScript theme={null}189> ```typescript TypeScript theme={null}

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

191 191>

192async function main() {192> async function main() {

193 for await (const message of query({193> for await (const message of query({

194 prompt: "Help me refactor this code",194> prompt: "Help me refactor this code",

195 options: {195> options: {

196 permissionMode: "default" // Set the mode here196> permissionMode: "default" // Set the mode here

197 }197> }

198 })) {198> })) {

199 if ("result" in message) {199> if ("result" in message) {

200 console.log(message.result);200> console.log(message.result);

201 }201> }

202 }202> }

203}203> }

204 204>

205main();205> main();

206```206> ```

207 

208**Durante la transmisión**

209 

210Llame a `set_permission_mode()` (Python) o `setPermissionMode()` (TypeScript) para cambiar el modo durante la sesión. El nuevo modo entra en vigor inmediatamente para todas las solicitudes de herramientas posteriores. Esto le permite comenzar de forma restrictiva y flexibilizar los permisos a medida que aumenta la confianza, por ejemplo, cambiar a `acceptEdits` después de revisar el enfoque inicial de Claude.

211 

212```python Python theme={null}

213import asyncio

214from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

215 

216 

217async def main():

218 async with ClaudeSDKClient(

219 options=ClaudeAgentOptions(

220 permission_mode="default", # Start in default mode

221 )

222 ) as client:

223 await client.query("Help me refactor this code")

224 

225 # Change mode dynamically mid-session

226 await client.set_permission_mode("acceptEdits")

227 

228 # Process messages with the new permission mode

229 async for message in client.receive_response():

230 if hasattr(message, "result"):

231 print(message.result)

232 

233 

234asyncio.run(main())

235```

236 207 

237```typescript TypeScript theme={null}208> [tab] Durante la transmisión

238import { query } from "@anthropic-ai/claude-agent-sdk";209>

239 210> Llame a `set_permission_mode()` (Python) o `setPermissionMode()` (TypeScript) para cambiar el modo durante la sesión. El nuevo modo entra en vigor inmediatamente para todas las solicitudes de herramientas posteriores. Esto le permite comenzar de forma restrictiva y flexibilizar los permisos a medida que aumenta la confianza, por ejemplo, cambiar a `acceptEdits` después de revisar el enfoque inicial de Claude.

240async function main() {211>

241 const q = query({212> ```python Python theme={null}

242 prompt: "Help me refactor this code",213> import asyncio

243 options: {214> from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

244 permissionMode: "default" // Start in default mode215>

245 }216>

246 });217> async def main():

247 218> async with ClaudeSDKClient(

248 // Change mode dynamically mid-session219> options=ClaudeAgentOptions(

249 await q.setPermissionMode("acceptEdits");220> permission_mode="default", # Start in default mode

250 221> )

251 // Process messages with the new permission mode222> ) as client:

252 for await (const message of q) {223> await client.query("Help me refactor this code")

253 if ("result" in message) {224>

254 console.log(message.result);225> # Change mode dynamically mid-session

255 }226> await client.set_permission_mode("acceptEdits")

256 }227>

257}228> # Process messages with the new permission mode

258 229> async for message in client.receive_response():

259main();230> if hasattr(message, "result"):

260```231> print(message.result)

232>

233>

234> asyncio.run(main())

235> ```

236>

237> ```typescript TypeScript theme={null}

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

239>

240> async function main() {

241> const q = query({

242> prompt: "Help me refactor this code",

243> options: {

244> permissionMode: "default" // Start in default mode

245> }

246> });

247>

248> // Change mode dynamically mid-session

249> await q.setPermissionMode("acceptEdits");

250>

251> // Process messages with the new permission mode

252> for await (const message of q) {

253> if ("result" in message) {

254> console.log(message.result);

255> }

256> }

257> }

258>

259> main();

260> ```

261 261 

262### Detalles del modo262### Detalles del modo

263 263 

36 36 

37Instale el paquete del SDK de Agent para su idioma:37Instale el paquete del SDK de Agent para su idioma:

38 38 

39**TypeScript (nuevo proyecto)**39> [tab] TypeScript (nuevo proyecto)

40 40>

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

42npm init -y42> npm init -y

43npm pkg set type=module43> npm pkg set type=module

44npm install @anthropic-ai/claude-agent-sdk44> npm install @anthropic-ai/claude-agent-sdk

45npm install --save-dev tsx45> npm install --save-dev tsx

46```46> ```

47 47>

48Establecer `"type": "module"` en `package.json` permite que su script de agente use `await` de nivel superior, y [tsx](https://tsx.hirok.io) ejecuta archivos TypeScript directamente. npm imprime `added N packages` cuando la instalación se realiza correctamente.48> Establecer `"type": "module"` en `package.json` permite que su script de agente use `await` de nivel superior, y [tsx](https://tsx.hirok.io) ejecuta archivos TypeScript directamente. npm imprime `added N packages` cuando la instalación se realiza correctamente.

49 

50**TypeScript (proyecto existente)**

51 

52```bash theme={null}

53npm install @anthropic-ai/claude-agent-sdk

54npm install --save-dev tsx

55```

56 

57[tsx](https://tsx.hirok.io) ejecuta archivos TypeScript directamente. Si su proyecto usa CommonJS, nombre su script de agente `agent.mts` en lugar de `agent.ts`. La extensión `.mts` hace que tsx trate el archivo como un módulo ES, por lo que `await` de nivel superior funciona sin convertir todo su proyecto a módulos ES. Use `agent.mts` en lugar de `agent.ts` en los pasos de creación y ejecución posteriores en este inicio rápido.

58 

59**Python (uv)**

60 

61[Instale uv](https://docs.astral.sh/uv/), un gestor de paquetes de Python rápido que maneja automáticamente los entornos virtuales. Luego inicialice un proyecto y agregue el SDK:

62 

63```bash theme={null}

64uv init

65uv add claude-agent-sdk

66```

67 

68**Python (pip)**

69 

70Cree y active un entorno virtual, luego instale el paquete.

71 

72En macOS o Linux:

73 

74```bash theme={null}

75python3 -m venv .venv

76source .venv/bin/activate

77pip install claude-agent-sdk

78```

79 49 

80En Windows:50> [tab] TypeScript (proyecto existente)

51>

52> ```bash theme={null}

53> npm install @anthropic-ai/claude-agent-sdk

54> npm install --save-dev tsx

55> ```

56>

57> [tsx](https://tsx.hirok.io) ejecuta archivos TypeScript directamente. Si su proyecto usa CommonJS, nombre su script de agente `agent.mts` en lugar de `agent.ts`. La extensión `.mts` hace que tsx trate el archivo como un módulo ES, por lo que `await` de nivel superior funciona sin convertir todo su proyecto a módulos ES. Use `agent.mts` en lugar de `agent.ts` en los pasos de creación y ejecución posteriores en este inicio rápido.

81 58 

82```powershell theme={null}59> [tab] Python (uv)

83py -m venv .venv60>

84.venv\Scripts\Activate.ps161> [Instale uv](https://docs.astral.sh/uv/), un gestor de paquetes de Python rápido que maneja automáticamente los entornos virtuales. Luego inicialice un proyecto y agregue el SDK:

85pip install claude-agent-sdk62>

86```63> ```bash theme={null}

64> uv init

65> uv add claude-agent-sdk

66> ```

87 67 

88Si PowerShell bloquea `Activate.ps1` con un error de política de ejecución, ejecute primero `Set-ExecutionPolicy -Scope Process RemoteSigned`.68> [tab] Python (pip)

69>

70> Cree y active un entorno virtual, luego instale el paquete.

71>

72> En macOS o Linux:

73>

74> ```bash theme={null}

75> python3 -m venv .venv

76> source .venv/bin/activate

77> pip install claude-agent-sdk

78> ```

79>

80> En Windows:

81>

82> ```powershell theme={null}

83> py -m venv .venv

84> .venv\Scripts\Activate.ps1

85> pip install claude-agent-sdk

86> ```

87>

88> Si PowerShell bloquea `Activate.ps1` con un error de política de ejecución, ejecute primero `Set-ExecutionPolicy -Scope Process RemoteSigned`.

89 89 

90> [!NOTE]90> [!NOTE]

91>91>

98 98 

99Obtenga una clave de API de la [Consola de Claude](https://platform.claude.com/), luego establézcala como una variable de entorno en el shell donde ejecutará su agente:99Obtenga una clave de API de la [Consola de Claude](https://platform.claude.com/), luego establézcala como una variable de entorno en el shell donde ejecutará su agente:

100 100 

101**macOS / Linux**101> [tab] macOS / Linux

102 102>

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

104export ANTHROPIC_API_KEY=your-api-key104> export ANTHROPIC_API_KEY=your-api-key

105```105> ```

106 

107**Windows (PowerShell)**

108 106 

109```powershell theme={null}107> [tab] Windows (PowerShell)

110$env:ANTHROPIC_API_KEY = "your-api-key"108>

111```109> ```powershell theme={null}

110> $env:ANTHROPIC_API_KEY = "your-api-key"

111> ```

112 112 

113El SDK lee la clave del entorno del proceso que ejecuta su agente; no carga archivos `.env` automáticamente. Si mantiene la clave en un archivo `.env`, cárguela usted mismo, por ejemplo con el paquete `dotenv`, antes de llamar al SDK.113El SDK lee la clave del entorno del proceso que ejecuta su agente; no carga archivos `.env` automáticamente. Si mantiene la clave en un archivo `.env`, cárguela usted mismo, por ejemplo con el paquete `dotenv`, antes de llamar al SDK.

114 114 

224 224 

225Su agente está listo. Ejecútelo con el siguiente comando:225Su agente está listo. Ejecútelo con el siguiente comando:

226 226 

227**TypeScript**227> [tab] TypeScript

228 228>

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

230npx tsx agent.ts230> npx tsx agent.ts

231```231> ```

232 232>

233Si nombró su script `agent.mts`, ejecute `npx tsx agent.mts` en su lugar.233> Si nombró su script `agent.mts`, ejecute `npx tsx agent.mts` en su lugar.

234 

235**Python (uv)**

236 

237```bash theme={null}

238uv run agent.py

239```

240 

241**Python (pip)**

242 234 

243Con su entorno virtual aún activado:235> [tab] Python (uv)

236>

237> ```bash theme={null}

238> uv run agent.py

239> ```

244 240 

245```bash theme={null}241> [tab] Python (pip)

246python agent.py242>

247```243> Con su entorno virtual aún activado:

244>

245> ```bash theme={null}

246> python agent.py

247> ```

248 248 

249Mientras trabaja, el agente imprime su razonamiento y cada herramienta que llama, terminando con `Done: success`. Después de ejecutar, verifique `utils.py`. Verá código defensivo que maneja listas vacías y usuarios nulos. Su agente de forma autónoma:249Mientras trabaja, el agente imprime su razonamiento y cada herramienta que llama, terminando con `Done: success`. Después de ejecutar, verifique `utils.py`. Verá código defensivo que maneja listas vacías y usuarios nulos. Su agente de forma autónoma:

250 250 

470 470 

471Cada SDK presenta el rechazo de manera diferente:471Cada SDK presenta el rechazo de manera diferente:

472 472 

473**TypeScript**473> [tab] TypeScript

474 474>

475El SDK de TypeScript lanza un `Error` indicando la regla que la entrada rompió. Por ejemplo, `skills: ["docs:*"]` lanza:475> El SDK de TypeScript lanza un `Error` indicando la regla que la entrada rompió. Por ejemplo, `skills: ["docs:*"]` lanza:

476 476>

477```text theme={null}477> ```text theme={null}

478Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.478> Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.

479```479> ```

480 480>

481Un nombre vacío reporta `Skill names must be non-empty strings.`481> Un nombre vacío reporta `Skill names must be non-empty strings.`

482 482>

483Antes de TypeScript Agent SDK 0.3.221, el SDK no ejecutaba esta verificación.483> Antes de TypeScript Agent SDK 0.3.221, el SDK no ejecutaba esta verificación.

484 

485**Python**

486 

487El SDK de Python genera `ValueError` indicando la regla que la entrada rompió. Por ejemplo, `skills=["docs:*"]` genera:

488 

489```text theme={null}

490ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491```

492 

493Un nombre vacío reporta `Skill names must be non-empty strings`.

494 484 

495Antes de Python Agent SDK 0.2.129, el SDK no ejecutaba esta verificación.485> [tab] Python

486>

487> El SDK de Python genera `ValueError` indicando la regla que la entrada rompió. Por ejemplo, `skills=["docs:*"]` genera:

488>

489> ```text theme={null}

490> ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491> ```

492>

493> Un nombre vacío reporta `Skill names must be non-empty strings`.

494>

495> Antes de Python Agent SDK 0.2.129, el SDK no ejecutaba esta verificación.

496 496 

497### Solución de problemas adicional497### Solución de problemas adicional

498 498 

16 16 

17Considere una aplicación de recetas donde un agente busca en la web y trae recetas. Sin salidas estructuradas, obtiene texto de forma libre que tendría que analizar usted mismo. Con salidas estructuradas, define la forma que desea y obtiene datos tipados que puede usar directamente en su aplicación.17Considere una aplicación de recetas donde un agente busca en la web y trae recetas. Sin salidas estructuradas, obtiene texto de forma libre que tendría que analizar usted mismo. Con salidas estructuradas, define la forma que desea y obtiene datos tipados que puede usar directamente en su aplicación.

18 18 

19> **Sin salidas estructuradas**19> [accordion] Sin salidas estructuradas

20>20>

21> ```text theme={null}21> ```text theme={null}

22> ¡Aquí hay una receta clásica de galletas con chispas de chocolate!22> ¡Aquí hay una receta clásica de galletas con chispas de chocolate!

32>32>

33> Para usar esto en su aplicación, tendría que analizar el título, convertir "15 minutos" a un número, separar ingredientes de instrucciones y manejar el formato inconsistente en todas las respuestas.33> Para usar esto en su aplicación, tendría que analizar el título, convertir "15 minutos" a un número, separar ingredientes de instrucciones y manejar el formato inconsistente en todas las respuestas.

34 34 

35> **Con salidas estructuradas**35> [accordion] Con salidas estructuradas

36>36>

37> ```jsonc theme={null}37> ```jsonc theme={null}

38> {38> {

225 225 

226Los ayudantes `ask_user` y `askUser` en los siguientes fragmentos representan la interfaz de usuario de solicitud de su propia aplicación.226Los ayudantes `ask_user` y `askUser` en los siguientes fragmentos representan la interfaz de usuario de solicitud de su propia aplicación.

227 227 

228**Aprobar**228> [tab] Aprobar

229 229>

230El usuario aprueba la acción tal como está. Pase la `input` de su devolución de llamada sin cambios y la herramienta se ejecuta exactamente como Claude solicitó.230> El usuario aprueba la acción tal como está. Pase la `input` de su devolución de llamada sin cambios y la herramienta se ejecuta exactamente como Claude solicitó.

231 231>

232```python Python theme={null}232> ```python Python theme={null}

233async def can_use_tool(tool_name, input_data, context):233> async def can_use_tool(tool_name, input_data, context):

234 print(f"Claude wants to use {tool_name}")234> print(f"Claude wants to use {tool_name}")

235 approved = await ask_user("Allow this action?")235> approved = await ask_user("Allow this action?")

236 236>

237 if approved:237> if approved:

238 return PermissionResultAllow(updated_input=input_data)238> return PermissionResultAllow(updated_input=input_data)

239 return PermissionResultDeny(message="User declined")239> return PermissionResultDeny(message="User declined")

240```240> ```

241 241>

242```typescript TypeScript theme={null}242> ```typescript TypeScript theme={null}

243canUseTool: async (toolName, input) => {243> canUseTool: async (toolName, input) => {

244 console.log(`Claude wants to use ${toolName}`);244> console.log(`Claude wants to use ${toolName}`);

245 const approved = await askUser("Allow this action?");245> const approved = await askUser("Allow this action?");

246 246>

247 if (approved) {247> if (approved) {

248 return { behavior: "allow", updatedInput: input };248> return { behavior: "allow", updatedInput: input };

249 }249> }

250 return { behavior: "deny", message: "User declined" };250> return { behavior: "deny", message: "User declined" };

251};251> };

252```252> ```

253 253 

254**Aprobar con cambios**254> [tab] Aprobar con cambios

255 255>

256El usuario aprueba pero quiere modificar la solicitud primero. Puede cambiar la entrada antes de que se ejecute la herramienta. Claude ve el resultado pero no se le dice que haya cambiado nada. Útil para sanitizar parámetros, agregar restricciones o limitar el acceso.256> El usuario aprueba pero quiere modificar la solicitud primero. Puede cambiar la entrada antes de que se ejecute la herramienta. Claude ve el resultado pero no se le dice que haya cambiado nada. Útil para sanitizar parámetros, agregar restricciones o limitar el acceso.

257 257>

258```python Python theme={null}258> ```python Python theme={null}

259async def can_use_tool(tool_name, input_data, context):259> async def can_use_tool(tool_name, input_data, context):

260 if tool_name == "Bash":260> if tool_name == "Bash":

261 # User approved, but scope all commands to sandbox261> # User approved, but scope all commands to sandbox

262 sandboxed_input = {**input_data}262> sandboxed_input = {**input_data}

263 sandboxed_input["command"] = input_data["command"].replace(263> sandboxed_input["command"] = input_data["command"].replace(

264 "/tmp", "/tmp/sandbox"264> "/tmp", "/tmp/sandbox"

265 )265> )

266 return PermissionResultAllow(updated_input=sandboxed_input)266> return PermissionResultAllow(updated_input=sandboxed_input)

267 return PermissionResultAllow(updated_input=input_data)267> return PermissionResultAllow(updated_input=input_data)

268```268> ```

269 269>

270```typescript TypeScript theme={null}270> ```typescript TypeScript theme={null}

271canUseTool: async (toolName, input) => {271> canUseTool: async (toolName, input) => {

272 if (toolName === "Bash") {272> if (toolName === "Bash") {

273 // User approved, but scope all commands to sandbox273> // User approved, but scope all commands to sandbox

274 const sandboxedInput = {274> const sandboxedInput = {

275 ...input,275> ...input,

276 command: input.command.replace("/tmp", "/tmp/sandbox")276> command: input.command.replace("/tmp", "/tmp/sandbox")

277 };277> };

278 return { behavior: "allow", updatedInput: sandboxedInput };278> return { behavior: "allow", updatedInput: sandboxedInput };

279 }279> }

280 return { behavior: "allow", updatedInput: input };280> return { behavior: "allow", updatedInput: input };

281};281> };

282```282> ```

283 283 

284**Aprobar y recordar**284> [tab] Aprobar y recordar

285 285>

286El usuario aprueba y no quiere que se le pregunte de nuevo para este tipo de llamada. El tercer argumento de devolución de llamada lleva `suggestions`, una matriz de entradas [`PermissionUpdate`](https://code.claude.com/docs/es/agent-sdk/typescript#permissionupdate) ya preparadas. Devuelva una en `updatedPermissions` para aplicarla. Una sugerencia con el destino `localSettings` escribe la regla en `.claude/settings.local.json` para que futuras sesiones omitan la solicitud para llamadas coincidentes.286> El usuario aprueba y no quiere que se le pregunte de nuevo para este tipo de llamada. El tercer argumento de devolución de llamada lleva `suggestions`, una matriz de entradas [`PermissionUpdate`](https://code.claude.com/docs/es/agent-sdk/typescript#permissionupdate) ya preparadas. Devuelva una en `updatedPermissions` para aplicarla. Una sugerencia con el destino `localSettings` escribe la regla en `.claude/settings.local.json` para que futuras sesiones omitan la solicitud para llamadas coincidentes.

287 287>

288En TypeScript, omita la opción de permitir siempre para una solicitud cuyas opciones llevan [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/es/agent-sdk/typescript#canusetool). La sugerencia requiere Agent SDK v0.3.268 o posterior, y el `context` de Python no la lleva.288> En TypeScript, omita la opción de permitir siempre para una solicitud cuyas opciones llevan [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/es/agent-sdk/typescript#canusetool). La sugerencia requiere Agent SDK v0.3.268 o posterior, y el `context` de Python no la lleva.

289 289>

290El ejemplo de Python requiere `claude-agent-sdk` 0.1.80 o posterior.290> El ejemplo de Python requiere `claude-agent-sdk` 0.1.80 o posterior.

291 291>

292```python Python theme={null}292> ```python Python theme={null}

293async def can_use_tool(tool_name, input_data, context):293> async def can_use_tool(tool_name, input_data, context):

294 choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])294> choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])

295 295>

296 if choice == "always":296> if choice == "always":

297 persist = [297> persist = [

298 s for s in context.suggestions if s.destination == "localSettings"298> s for s in context.suggestions if s.destination == "localSettings"

299 ]299> ]

300 return PermissionResultAllow(300> return PermissionResultAllow(

301 updated_input=input_data, updated_permissions=persist301> updated_input=input_data, updated_permissions=persist

302 )302> )

303 if choice == "once":303> if choice == "once":

304 return PermissionResultAllow(updated_input=input_data)304> return PermissionResultAllow(updated_input=input_data)

305 return PermissionResultDeny(message="User declined")305> return PermissionResultDeny(message="User declined")

306```306> ```

307 307>

308```typescript TypeScript theme={null}308> ```typescript TypeScript theme={null}

309canUseTool: async (toolName, input, { suggestions = [] }) => {309> canUseTool: async (toolName, input, { suggestions = [] }) => {

310 const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);310> const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);

311 311>

312 if (choice === "always") {312> if (choice === "always") {

313 const persist = suggestions.filter(313> const persist = suggestions.filter(

314 (s) => s.destination === "localSettings"314> (s) => s.destination === "localSettings"

315 );315> );

316 return {316> return {

317 behavior: "allow",317> behavior: "allow",

318 updatedInput: input,318> updatedInput: input,

319 updatedPermissions: persist319> updatedPermissions: persist

320 };320> };

321 }321> }

322 if (choice === "once") {322> if (choice === "once") {

323 return { behavior: "allow", updatedInput: input };323> return { behavior: "allow", updatedInput: input };

324 }324> }

325 return { behavior: "deny", message: "User declined" };325> return { behavior: "deny", message: "User declined" };

326};326> };

327```327> ```

328 328 

329**Rechazar**329> [tab] Rechazar

330 330>

331El usuario no quiere que esta acción suceda. Bloquee la herramienta y proporcione un mensaje explicando por qué. Claude ve este mensaje y puede intentar un enfoque diferente.331> El usuario no quiere que esta acción suceda. Bloquee la herramienta y proporcione un mensaje explicando por qué. Claude ve este mensaje y puede intentar un enfoque diferente.

332 332>

333```python Python theme={null}333> ```python Python theme={null}

334async def can_use_tool(tool_name, input_data, context):334> async def can_use_tool(tool_name, input_data, context):

335 approved = await ask_user(f"Allow {tool_name}?")335> approved = await ask_user(f"Allow {tool_name}?")

336 336>

337 if not approved:337> if not approved:

338 return PermissionResultDeny(message="User rejected this action")338> return PermissionResultDeny(message="User rejected this action")

339 return PermissionResultAllow(updated_input=input_data)339> return PermissionResultAllow(updated_input=input_data)

340```340> ```

341 341>

342```typescript TypeScript theme={null}342> ```typescript TypeScript theme={null}

343canUseTool: async (toolName, input) => {343> canUseTool: async (toolName, input) => {

344 const approved = await askUser(`Allow ${toolName}?`);344> const approved = await askUser(`Allow ${toolName}?`);

345 345>

346 if (!approved) {346> if (!approved) {

347 return {347> return {

348 behavior: "deny",348> behavior: "deny",

349 message: "User rejected this action"349> message: "User rejected this action"

350 };350> };

351 }351> }

352 return { behavior: "allow", updatedInput: input };352> return { behavior: "allow", updatedInput: input };

353};353> };

354```354> ```

355 355 

356**Sugerir alternativa**356> [tab] Sugerir alternativa

357 357>

358El usuario no quiere esta acción específica, pero tiene una idea diferente. Bloquee la herramienta e incluya orientación en su mensaje. Claude leerá esto y decidirá cómo proceder según sus comentarios.358> El usuario no quiere esta acción específica, pero tiene una idea diferente. Bloquee la herramienta e incluya orientación en su mensaje. Claude leerá esto y decidirá cómo proceder según sus comentarios.

359 359>

360```python Python theme={null}360> ```python Python theme={null}

361async def can_use_tool(tool_name, input_data, context):361> async def can_use_tool(tool_name, input_data, context):

362 if tool_name == "Bash" and "rm" in input_data.get("command", ""):362> if tool_name == "Bash" and "rm" in input_data.get("command", ""):

363 # User doesn't want to delete, suggest archiving instead363> # User doesn't want to delete, suggest archiving instead

364 return PermissionResultDeny(364> return PermissionResultDeny(

365 message="User doesn't want to delete files. They asked if you could compress them into an archive instead."365> message="User doesn't want to delete files. They asked if you could compress them into an archive instead."

366 )366> )

367 return PermissionResultAllow(updated_input=input_data)367> return PermissionResultAllow(updated_input=input_data)

368```368> ```

369 369>

370```typescript TypeScript theme={null}370> ```typescript TypeScript theme={null}

371canUseTool: async (toolName, input) => {371> canUseTool: async (toolName, input) => {

372 if (toolName === "Bash" && input.command.includes("rm")) {372> if (toolName === "Bash" && input.command.includes("rm")) {

373 // User doesn't want to delete, suggest archiving instead373> // User doesn't want to delete, suggest archiving instead

374 return {374> return {

375 behavior: "deny",375> behavior: "deny",

376 message:376> message:

377 "User doesn't want to delete files. They asked if you could compress them into an archive instead."377> "User doesn't want to delete files. They asked if you could compress them into an archive instead."

378 };378> };

379 }379> }

380 return { behavior: "allow", updatedInput: input };380> return { behavior: "allow", updatedInput: input };

381};381> };

382```382> ```

383 383 

384**Redirigir completamente**384> [tab] Redirigir completamente

385 385>

386Para un cambio de dirección completo (no solo un empujón), use [entrada de transmisión](https://code.claude.com/docs/es/agent-sdk/streaming-vs-single-mode.md) para enviar a Claude una nueva instrucción directamente. Esto omite la solicitud de herramienta actual y le da a Claude instrucciones completamente nuevas para seguir.386> Para un cambio de dirección completo (no solo un empujón), use [entrada de transmisión](https://code.claude.com/docs/es/agent-sdk/streaming-vs-single-mode.md) para enviar a Claude una nueva instrucción directamente. Esto omite la solicitud de herramienta actual y le da a Claude instrucciones completamente nuevas para seguir.

387 387 

388## Manejar preguntas aclaratorias388## Manejar preguntas aclaratorias

389 389 

13| [Subagentes](https://code.claude.com/docs/es/sub-agents.md) | Trabajadores delegados dentro de una sesión que realizan una tarea secundaria en su propio contexto y devuelven un resumen | Una tarea secundaria inundaría su conversación principal con resultados de búsqueda, registros o contenidos de archivos que no volverá a consultar |13| [Subagentes](https://code.claude.com/docs/es/sub-agents.md) | Trabajadores delegados dentro de una sesión que realizan una tarea secundaria en su propio contexto y devuelven un resumen | Una tarea secundaria inundaría su conversación principal con resultados de búsqueda, registros o contenidos de archivos que no volverá a consultar |

14| [Vista de agentes](https://code.claude.com/docs/es/agent-view.md) | Una pantalla para enviar y monitorear sesiones que se ejecutan en segundo plano, abierta con `claude agents`. Vista previa de investigación | Tiene varias tareas independientes y desea delegarlas, verificar el estado de un vistazo e intervenir solo cuando una lo necesite |14| [Vista de agentes](https://code.claude.com/docs/es/agent-view.md) | Una pantalla para enviar y monitorear sesiones que se ejecutan en segundo plano, abierta con `claude agents`. Vista previa de investigación | Tiene varias tareas independientes y desea delegarlas, verificar el estado de un vistazo e intervenir solo cuando una lo necesite |

15| [Equipos de agentes](https://code.claude.com/docs/es/agent-teams.md) | Múltiples sesiones coordinadas con una lista de tareas compartida y mensajería entre agentes, administradas por un líder. Experimental y deshabilitado por defecto | Desea que Claude divida un proyecto en partes, las asigne y mantenga a los trabajadores sincronizados |15| [Equipos de agentes](https://code.claude.com/docs/es/agent-teams.md) | Múltiples sesiones coordinadas con una lista de tareas compartida y mensajería entre agentes, administradas por un líder. Experimental y deshabilitado por defecto | Desea que Claude divida un proyecto en partes, las asigne y mantenga a los trabajadores sincronizados |

16| [Proyectos](https://code.claude.com/docs/es/claude-projects.md) | Una conversación continua en claude.ai/code o en la aplicación de escritorio. Claude inicia sesiones paralelas llamadas threads en la nube o, cuando lo solicita, en su computadora a través de Control Remoto, le da a cada una las instrucciones del proyecto y le muestra cuáles lo necesitan. Beta pública en Pro y Max | El trabajo abarca muchas tareas durante días o semanas, debe seguir ejecutándose cuando su máquina está apagada, y prefiere describirlo una vez en lugar de enviar y rastrear cada sesión |16| [Proyectos](https://code.claude.com/docs/es/claude-projects.md) | Una conversación continua en claude.ai/code o en la aplicación de escritorio. Claude inicia sesiones paralelas llamadas threads, en la nube o, cuando lo solicitas, en tu computadora a través de Remote Control. Le da a cada una las instrucciones del proyecto y te muestra cuáles te necesitan. Beta pública en Pro, Max y Ultra | El trabajo abarca muchas tareas durante días o semanas, debe seguir ejecutándose cuando tu máquina está apagada, y prefieres describirlo una vez en lugar de enviar y rastrear cada sesión |

17| [Flujos de trabajo dinámicos](https://code.claude.com/docs/es/workflows.md) | Un script que ejecuta muchos subagentes y verifica sus resultados, para un trabajo demasiado grande para coordinar en un solo turno o que necesita más de un solo paso | Una tarea crece más allá de un puñado de subagentes, o desea que los hallazgos se verifiquen entre sí: una auditoría en toda la base de código, una migración de 500 archivos, investigación verificada de forma cruzada, o un plan elaborado desde varios ángulos |17| [Flujos de trabajo dinámicos](https://code.claude.com/docs/es/workflows.md) | Un script que ejecuta muchos subagentes y verifica sus resultados, para un trabajo demasiado grande para coordinar en un solo turno o que necesita más de un solo paso | Una tarea crece más allá de un puñado de subagentes, o desea que los hallazgos se verifiquen entre sí: una auditoría en toda la base de código, una migración de 500 archivos, investigación verificada de forma cruzada, o un plan elaborado desde varios ángulos |

18 18 

19En cada enfoque, los trabajadores son sesiones de Claude. Para involucrar una herramienta diferente, expóngala a Claude como un [servidor MCP](https://code.claude.com/docs/es/mcp.md).19En cada enfoque, los trabajadores son sesiones de Claude. Para involucrar una herramienta diferente, expóngala a Claude como un [servidor MCP](https://code.claude.com/docs/es/mcp.md).

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Los artefactos están disponibles en los planes Pro, Max, Team y Enterprise y requieren una sesión iniciada con [`/login`](https://code.claude.com/docs/es/setup#authenticate). Consulte [Disponibilidad](#availability) para ver el conjunto completo de requisitos.11> Los artefactos están disponibles en los planes Pro, Max, Ultra, Team y Enterprise y requieren una sesión iniciada con [`/login`](https://code.claude.com/docs/es/setup#authenticate). Consulta [Disponibilidad](#availability) para ver el conjunto completo de requisitos.

12 12 

13Un [artefacto](https://claude.com/features/artifacts) es una página web interactiva en vivo que Claude Code publica desde su sesión en una URL privada en claude.ai. La abre en un navegador y se actualiza en su lugar a medida que continúa la sesión. Compártala desde el encabezado de la página cuando desee que otra persona también la vea.13Un [artefacto](https://claude.com/features/artifacts) es una página web interactiva en vivo que Claude Code publica desde su sesión en una URL privada en claude.ai. La abre en un navegador y se actualiza en su lugar a medida que continúa la sesión. Compártala desde el encabezado de la página cuando desee que otra persona también la vea.

14 14 

197 197 

198## Extraer datos en vivo con conectores MCP198## Extraer datos en vivo con conectores MCP

199 199 

200Un artefacto puede llamar a [conectores MCP](https://code.claude.com/docs/es/mcp.md#use-mcp-servers-from-claude-ai) cada vez que alguien lo visualiza, de modo que la página muestra datos actuales en lugar de una instantánea de la sesión que la construyó. Las llamadas de conectores desde artefactos están disponibles en los planes Pro, Max, Team y Enterprise y requieren Claude Code v2.1.209 o posterior. En versiones anteriores, Claude publica la página con los datos que la sesión recopiló mientras la construía.200Un artefacto puede llamar a [conectores MCP](https://code.claude.com/docs/es/mcp.md#use-mcp-servers-from-claude-ai) cada vez que alguien lo visualiza, de modo que la página muestra datos actuales en lugar de una instantánea de la sesión que la construyó. Las llamadas de conectores desde artefactos están disponibles en los planes Pro, Max, Ultra, Team y Enterprise y requieren Claude Code v2.1.209 o posterior. En versiones anteriores, Claude publica la página con los datos que la sesión recopiló mientras la construía.

201 201 

202Para crear una página respaldada por un conector, nombre el conector y los datos que desea en su indicación:202Para crear una página respaldada por un conector, nombre el conector y los datos que desea en su indicación:

203 203 

314 314 

315> [!NOTE]315> [!NOTE]

316>316>

317> Las plantillas están en versión beta. Están activadas de forma predeterminada en los planes Pro, Max y Team. En los planes Enterprise, un propietario [activa cada plantilla](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) en **Configuración de la organización > Artefactos**. Si su organización tiene la plantilla de Slides desactivada, `/slides` no aparece; si tiene la plantilla de Design desactivada, `/design` no elabora diseños. Ambos comandos requieren Claude Code v2.1.265 o posterior y una sesión donde [los artefactos estén disponibles](#availability).317> Las plantillas están en versión beta. Están activadas de forma predeterminada en los planes Pro, Max, Ultra y Team. En los planes Enterprise, un propietario [activa cada plantilla](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) en **Configuración de la organización > Artefactos**. Si tu organización tiene la plantilla de Slides desactivada, `/slides` no aparece; si tiene la plantilla de Design desactivada, `/design` no elabora diseños. Ambos comandos requieren Claude Code v2.1.265 o posterior y una sesión donde [los artefactos estén disponibles](#availability).

318 318 

319### Crear una presentación de diapositivas319### Crear una presentación de diapositivas

320 320 

368 368 

369| Requisito | Disponible cuando |369| Requisito | Disponible cuando |

370| :- | :- |370| :- | :- |

371| Plan | Pro, Max, Team o Enterprise. En planes Pro y Max, los artefactos son privados para usted hasta que los comparta, y no se aplica ninguna gestión de administrador. En planes Team y Enterprise, los artefactos están habilitados de forma predeterminada, y un propietario puede [desactivarlos para la organización](#manage-artifacts-for-your-organization) en la configuración de administrador de claude.ai. |371| Plan | Pro, Max, Ultra, Team o Enterprise. En planes Pro, Max y Ultra, los artefactos son privados para ti hasta que los compartas, y no se aplica ninguna gestión de administrador. En planes Team y Enterprise, los artefactos están habilitados de forma predeterminada, y un propietario puede [desactivarlos para la organización](#manage-artifacts-for-your-organization) en la configuración de administrador de claude.ai. |

372| Autenticación | La sesión está respaldada por una cuenta de claude.ai: inicia sesión con `/login` en la CLI o la aplicación de escritorio. Las sesiones de Claude Tag no necesitan ningún paso de inicio de sesión. Las sesiones que usan una clave de API, un [token de gateway](https://code.claude.com/docs/es/llm-gateway) o una credencial de proveedor de nube no pueden publicar. |372| Autenticación | La sesión está respaldada por una cuenta de claude.ai: inicia sesión con `/login` en la CLI o la aplicación de escritorio. Las sesiones de Claude Tag no necesitan ningún paso de inicio de sesión. Las sesiones que usan una clave de API, un [token de gateway](https://code.claude.com/docs/es/llm-gateway) o una credencial de proveedor de nube no pueden publicar. |

373| Proveedor de modelo | API de Anthropic. No disponible en [Amazon Bedrock](https://code.claude.com/docs/es/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/es/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/es/microsoft-foundry.md). |373| Proveedor de modelo | API de Anthropic. No disponible en [Amazon Bedrock](https://code.claude.com/docs/es/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/es/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/es/microsoft-foundry.md). |

374| Política de organización | Las claves de cifrado administradas por el cliente (CMEK), HIPAA y [Retención de datos cero](https://code.claude.com/docs/es/zero-data-retention.md) no están habilitadas para la organización. |374| Política de organización | Las claves de cifrado administradas por el cliente (CMEK), HIPAA y [Retención de datos cero](https://code.claude.com/docs/es/zero-data-retention.md) no están habilitadas para la organización. |

23 23 

24Puedes autenticarte con cualquiera de estos tipos de cuenta:24Puedes autenticarte con cualquiera de estos tipos de cuenta:

25 25 

26* **Suscripción Claude Pro o Max**: inicia sesión con tu cuenta de claude.ai. Suscríbete en [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).26* **Suscripción Claude Pro, Max o Ultra**: inicia sesión con tu cuenta de claude.ai. Suscríbete en [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

27* **Claude for Teams o Enterprise**: inicia sesión con la cuenta de claude.ai a la que te invitó el administrador de tu equipo.27* **Claude for Teams o Enterprise**: inicia sesión con la cuenta de claude.ai a la que te invitó el administrador de tu equipo.

28* **Claude Console**: inicia sesión con tus credenciales de Console. Tu administrador debe haberte [invitado](#claude-console-authentication) primero. Puedes iniciar sesión [creando una clave de API o sin crearla](#sign-in-without-an-api-key).28* **Claude Console**: inicia sesión con tus credenciales de Console. Tu administrador debe haberte [invitado](#claude-console-authentication) primero. Puedes iniciar sesión [creando una clave de API o sin crearla](#sign-in-without-an-api-key).

29* **Proveedores de nube**: si tu organización usa [Amazon Bedrock](https://code.claude.com/docs/es/amazon-bedrock.md), [Agent Platform de Google Cloud](https://code.claude.com/docs/es/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/es/microsoft-foundry.md), configura las variables de entorno necesarias antes de ejecutar `claude`, o selecciona **3rd-party platform** en el prompt de inicio de sesión, lo que abre un asistente de configuración interactivo para Bedrock y Vertex AI. No se necesita iniciar sesión en el navegador.29* **Proveedores de nube**: si tu organización usa [Amazon Bedrock](https://code.claude.com/docs/es/amazon-bedrock.md), [Agent Platform de Google Cloud](https://code.claude.com/docs/es/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/es/microsoft-foundry.md), configura las variables de entorno necesarias antes de ejecutar `claude`, o selecciona **3rd-party platform** en el prompt de inicio de sesión, lo que abre un asistente de configuración interactivo para Bedrock y Vertex AI. No se necesita iniciar sesión en el navegador.

2534. Salida del script [`apiKeyHelper`](https://code.claude.com/docs/es/settings-reference#apikeyhelper). Use esto para credenciales dinámicas o rotativas, como tokens de corta duración obtenidos de un almacén.2534. Salida del script [`apiKeyHelper`](https://code.claude.com/docs/es/settings-reference#apikeyhelper). Use esto para credenciales dinámicas o rotativas, como tokens de corta duración obtenidos de un almacén.

2545. Variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth de larga duración generado por [`claude setup-token`](#generate-a-long-lived-token). Use esto para canalizaciones de CI y scripts donde el inicio de sesión del navegador no está disponible. Si ejecuta `/login` mientras la variable está establecida, Claude Code cambia la sesión actual al nuevo inicio de sesión, pero lee la variable nuevamente en cada nueva sesión hasta que la elimine del perfil de su shell o del bloque `env` de un [archivo de configuración](https://code.claude.com/docs/es/settings.md).2545. Variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth de larga duración generado por [`claude setup-token`](#generate-a-long-lived-token). Use esto para canalizaciones de CI y scripts donde el inicio de sesión del navegador no está disponible. Si ejecuta `/login` mientras la variable está establecida, Claude Code cambia la sesión actual al nuevo inicio de sesión, pero lee la variable nuevamente en cada nueva sesión hasta que la elimine del perfil de su shell o del bloque `env` de un [archivo de configuración](https://code.claude.com/docs/es/settings.md).

2556. Credenciales de perfil de Anthropic y de federación, las credenciales que utiliza la CLI `ant` y Workload Identity Federation. Un perfil que `ant auth login` escribió se clasifica aquí solo cuando lo nombra en `ANTHROPIC_PROFILE`; de lo contrario, se clasifica por debajo de `/login`. Consulte [Perfiles de Anthropic y credenciales de federación](#anthropic-profiles-and-federation-credentials).2556. Credenciales de perfil de Anthropic y de federación, las credenciales que utiliza la CLI `ant` y Workload Identity Federation. Un perfil que `ant auth login` escribió se clasifica aquí solo cuando lo nombra en `ANTHROPIC_PROFILE`; de lo contrario, se clasifica por debajo de `/login`. Consulte [Perfiles de Anthropic y credenciales de federación](#anthropic-profiles-and-federation-credentials).

2567. Credenciales OAuth de suscripción de `/login`. Este es el predeterminado para usuarios de Claude Pro, Max, Team y Enterprise.2567. Credenciales OAuth de suscripción de `/login`. Esta es la opción predeterminada para los usuarios de Claude Pro, Max, Ultra, Team y Enterprise.

257 257 

258Una sesión de [puerta de enlace de aplicaciones Claude](https://code.claude.com/docs/es/claude-apps-gateway) con sesión iniciada se encuentra fuera de esta lista: es una selección de proveedor como Amazon Bedrock o la Plataforma de Agentes de Google Cloud, y los supera. Cuando existe una sesión de puerta de enlace, la CLI se autentica con el token de puerta de enlace incluso si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido, y las fuentes de credenciales anteriores como el token de portador, la clave API, `apiKeyHelper` y los perfiles no se utilizan.258Una sesión de [puerta de enlace de aplicaciones Claude](https://code.claude.com/docs/es/claude-apps-gateway) con sesión iniciada se encuentra fuera de esta lista: es una selección de proveedor como Amazon Bedrock o la Plataforma de Agentes de Google Cloud, y los supera. Cuando existe una sesión de puerta de enlace, la CLI se autentica con el token de puerta de enlace incluso si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido, y las fuentes de credenciales anteriores como el token de portador, la clave API, `apiKeyHelper` y los perfiles no se utilizan.

259 259 

300 300 

301El comando abre el mismo flujo de autorización del navegador que `/login`, y el token se imprime en la terminal después de que apruebe el acceso en el navegador. No guarda el token en ningún lugar; cópielo y establézcalo como la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN` donde desee autenticarse:301El comando abre el mismo flujo de autorización del navegador que `/login`, y el token se imprime en la terminal después de que apruebe el acceso en el navegador. No guarda el token en ningún lugar; cópielo y establézcalo como la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN` donde desee autenticarse:

302 302 

303**macOS, Linux, WSL**303> [tab] macOS, Linux, WSL

304 304>

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

306export CLAUDE_CODE_OAUTH_TOKEN=your-token306> export CLAUDE_CODE_OAUTH_TOKEN=your-token

307```307> ```

308 308 

309**Windows PowerShell**309> [tab] Windows PowerShell

310 310>

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

312$env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"312> $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

313```313> ```

314 314 

315**Windows CMD**315> [tab] Windows CMD

316 316>

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

318set CLAUDE_CODE_OAUTH_TOKEN=your-token318> set CLAUDE_CODE_OAUTH_TOKEN=your-token

319```319> ```

320 320 

321Este token se autentica con su suscripción de Claude y requiere un plan Pro, Max, Team o Enterprise. Solo puede hacer solicitudes de modelo, por lo que no puede establecer sesiones de [Remote Control](https://code.claude.com/docs/es/remote-control.md) u obtener [conectores de claude.ai](https://code.claude.com/docs/es/mcp.md#use-mcp-servers-from-claude-ai). Los servidores MCP que configura localmente siguen funcionando.321Este token se autentica con tu suscripción de Claude y requiere un plan Pro, Max, Ultra, Team o Enterprise. Solo puede hacer solicitudes al modelo, por lo que no puede establecer sesiones de [Remote Control](https://code.claude.com/docs/es/remote-control.md) ni obtener [conectores de claude.ai](https://code.claude.com/docs/es/mcp.md#use-mcp-servers-from-claude-ai). Los servidores MCP que configuras localmente siguen funcionando.

322 322 

323[Bare mode](https://code.claude.com/docs/es/headless.md#start-faster-with-bare-mode) no lee `CLAUDE_CODE_OAUTH_TOKEN`. Si su script pasa `--bare`, autentíquese con `ANTHROPIC_API_KEY` o un `apiKeyHelper` en su lugar.323[Bare mode](https://code.claude.com/docs/es/headless.md#start-faster-with-bare-mode) no lee `CLAUDE_CODE_OAUTH_TOKEN`. Si su script pasa `--bare`, autentíquese con `ANTHROPIC_API_KEY` o un `apiKeyHelper` en su lugar.

43 43 

44## Por qué aparece el aviso44## Por qué aparece el aviso

45 45 

46[Revisión del clasificador del lado del servidor](https://code.claude.com/docs/es/permission-modes.md#server-side-classifier-review) enumera qué sesiones solicitan al servidor las comprobaciones del clasificador. Los planes Pro, Max y Team nunca muestran el aviso. Cuando aparece, las causas habituales son:46En un plan Pro, Max, Ultra o Team, nunca ves el aviso. Para saber qué sesiones solicitan al servidor las comprobaciones del clasificador, consulta [Revisión del clasificador del lado del servidor](https://code.claude.com/docs/es/permission-modes.md#server-side-classifier-review). Si ves el aviso, revisa estas causas habituales:

47 47 

48* **Una puerta de enlace LLM o proxy está en la ruta**: una que elimina o reescribe encabezados de solicitud, descarta campos de solicitud que no reconoce o edita respuestas. El servidor entonces nunca recibe la solicitud de comprobaciones, o Claude Code nunca recibe los resultados. Cuando su configuración o las respuestas identifican la puerta de enlace, el aviso la nombra.48* **Una puerta de enlace LLM o proxy está en la ruta**: una que elimina o reescribe encabezados de solicitud, descarta campos de solicitud que no reconoce o edita respuestas. El servidor entonces nunca recibe la solicitud de comprobaciones, o Claude Code nunca recibe los resultados. Cuando su configuración o las respuestas identifican la puerta de enlace, el aviso la nombra.

49* **Las comprobaciones del lado del servidor aún no han llegado a su plataforma, región o credencial**: si una plataforma o región las realiza depende del despliegue de esa plataforma. Si ve el aviso sin ninguna puerta de enlace o proxy en la ruta y sigue apareciendo, esta es la causa probable. Para confirmar, contacte con soporte o el administrador de su empresa, o repórtelo con `/feedback`.49* **Las comprobaciones del lado del servidor aún no han llegado a su plataforma, región o credencial**: si una plataforma o región las realiza depende del despliegue de esa plataforma. Si ve el aviso sin ninguna puerta de enlace o proxy en la ruta y sigue apareciendo, esta es la causa probable. Para confirmar, contacte con soporte o el administrador de su empresa, o repórtelo con `/feedback`.

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` está disponible en los planes Pro, Max, Team y Enterprise y con una clave de API de Claude Console. En un plan Pro, Max o Team, necesitas la v2.1.228 o posterior, o la v2.1.233 o posterior en Windows nativo. En un plan Enterprise o con una clave de API de Claude Console, necesitas la v2.1.283 o posterior. Si el comando no aparece en tu sesión, consulta [`/auto-mode-setup` devuelve "Unknown command"](#auto-mode-setup-returns-unknown-command).164> `/auto-mode-setup` está disponible en los planes Pro, Max, Ultra, Team y Enterprise y con una clave de API de Claude Console. En un plan Pro, Max, Ultra o Team, necesitas la v2.1.228 o posterior, o la v2.1.233 o posterior en Windows nativo. En un plan Enterprise o con una clave de API de Claude Console, necesitas la v2.1.283 o posterior. Si el comando no aparece en tu sesión, consulta [`/auto-mode-setup` devuelve "Unknown command"](#auto-mode-setup-returns-unknown-command).

165 165 

166### Qué lee `/auto-mode-setup`166### Qué lee `/auto-mode-setup`

167 167 

489 489 

490Con una ventana de 1M de tokens en la mayoría de los modelos actuales y la compactación cerca del tope, rara vez te quedarás sin contexto. Aun así, puedes *pagar* por contexto que no necesitas. Cada solicitud envía la conversación completa, así que una sesión que ha acumulado tres tareas no relacionadas vuelve a leer las tres en cada turno de la cuarta. Eso tiene [descuento mientras la caché está activa](https://code.claude.com/docs/es/costs.md#why-usage-climbs-in-a-long-session) y precio completo una vez que expira.490Con una ventana de 1M de tokens en la mayoría de los modelos actuales y la compactación cerca del tope, rara vez te quedarás sin contexto. Aun así, puedes *pagar* por contexto que no necesitas. Cada solicitud envía la conversación completa, así que una sesión que ha acumulado tres tareas no relacionadas vuelve a leer las tres en cada turno de la cuarta. Eso tiene [descuento mientras la caché está activa](https://code.claude.com/docs/es/costs.md#why-usage-climbs-in-a-long-session) y precio completo una vez que expira.

491 491 

492[`/usage`](https://code.claude.com/docs/es/costs) es el primer lugar donde mirar. En Pro, Max, Team y Enterprise desglosa tu uso por skill, subagente, plugin y servidor MCP. También señala patrones como un contexto largo o fallos frecuentes de caché una vez que alguno supera el 10% de tu uso. A partir de ahí, las soluciones habituales:492[`/usage`](https://code.claude.com/docs/es/costs) es el primer lugar donde mirar. En Pro, Max, Ultra, Team y Enterprise desglosa tu uso por skill, subagente, plugin y servidor MCP. También señala patrones como un contexto largo o fallos frecuentes de caché una vez que alguno supera el 10% de tu uso. A partir de ahí, las soluciones habituales:

493 493 

494* `/clear` entre tareas no relacionadas. No cuesta nada, y significa que la siguiente tarea no sigue pagando por el historial de la anterior. `/clear oauth-migration` le pone nombre a la sesión que dejas, para que puedas volver a ella más tarde.494* `/clear` entre tareas no relacionadas. No cuesta nada, y significa que la siguiente tarea no sigue pagando por el historial de la anterior. `/clear oauth-migration` le pone nombre a la sesión que dejas, para que puedas volver a ella más tarde.

495* `/compact` con un enfoque, como `/compact keep the API changes and the test commands`. En una sesión larga, `/compact` es en sí mismo una solicitud grande, ya que lee toda la conversación para resumirla, y más aún una vez que la caché ha expirado.495* `/compact` con un enfoque, como `/compact keep the API changes and the test commands`. En una sesión larga, `/compact` es en sí mismo una solicitud grande, ya que lee toda la conversación para resumirla, y más aún una vez que la caché ha expirado.

24 24 

25Cada canal compatible es un plugin que requiere [Bun](https://bun.sh). Para una demostración práctica del flujo de plugins antes de conectar una plataforma real, pruebe el [inicio rápido de fakechat](#quickstart).25Cada canal compatible es un plugin que requiere [Bun](https://bun.sh). Para una demostración práctica del flujo de plugins antes de conectar una plataforma real, pruebe el [inicio rápido de fakechat](#quickstart).

26 26 

27**Telegram**27> [tab] Telegram

28 

29Vea el [código fuente completo de Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram).

30 

31**1. Crear un bot de Telegram**

32 

33Abre [BotFather](https://t.me/BotFather) en Telegram y envía `/newbot`. Asígnale un nombre para mostrar y un nombre de usuario único que termine en `bot`. Copia el token que devuelve BotFather.

34 

35**2. Instalar el plugin**

36 

37Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

38 

39```

40/plugin install telegram@claude-plugins-official

41```

42 

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

44 

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

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

47 

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

49 

50**3. Configurar tu token**

51 

52Ejecuta el comando de configuración con el token de BotFather:

53 

54```

55/telegram:configure <token>

56```

57 

58Esto lo guarda en `~/.claude/channels/telegram/.env`. También puede establecer `TELEGRAM_BOT_TOKEN` en su entorno de shell antes de lanzar Claude Code.

59 

60**4. Reiniciar con canales habilitados**

61 

62Salga de Claude Code y reinicie con la bandera de canal. Esto inicia el plugin de Telegram, que comienza a sondear mensajes de su bot:

63 

64```bash theme={null}

65claude --channels plugin:telegram@claude-plugins-official

66```

67 

68**5. Emparejar su cuenta**

69 

70Abra Telegram y envíe cualquier mensaje a su bot. El bot responde con un código de emparejamiento.

71 

72> [!NOTE]

73>28>

74> Si su bot no responde, asegúrese de que Claude Code se esté ejecutando con `--channels` del paso anterior. El bot solo puede responder mientras el canal está activo.29> Vea el [código fuente completo de Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram).

75 

76De vuelta en Claude Code, ejecute:

77 

78```

79/telegram:access pair <code>

80```

81 

82Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:

83 

84```

85/telegram:access policy allowlist

86```

87 

88**Discord**

89 

90Vea el [código fuente completo de Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord).

91 

92**1. Crear un bot de Discord**

93 

94Vaya al [Portal de Desarrolladores de Discord](https://discord.com/developers/applications), haga clic en **Nueva Aplicación** y asígnele un nombre. En la sección **Bot**, cree un nombre de usuario y luego haga clic en **Restablecer Token** y copie el token.

95 

96**2. Habilitar Intención de Contenido de Mensaje**

97 

98En la configuración de su bot, desplácese hasta **Intenciones de Puerta de Enlace Privilegiadas** y habilite **Intención de Contenido de Mensaje**.

99 

100**3. Invitar el bot a su servidor**

101 

102Vaya a **OAuth2 > Generador de URL**. Seleccione el alcance `bot` y habilite estos permisos:

103 

104* Ver Canales

105* Enviar Mensajes

106* Enviar Mensajes en Hilos

107* Leer Historial de Mensajes

108* Adjuntar Archivos

109* Agregar Reacciones

110 

111Abre la URL generada para agregar el bot a tu servidor.

112 

113**4. Instalar el plugin**

114 

115Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

116 

117```

118/plugin install discord@claude-plugins-official

119```

120 

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

122 

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

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

125 

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

127 

128**5. Configurar tu token**

129 

130Ejecuta el comando de configuración con el token del bot que copiaste:

131 

132```

133/discord:configure <token>

134```

135 

136Esto lo guarda en `~/.claude/channels/discord/.env`. También puede establecer `DISCORD_BOT_TOKEN` en su entorno de shell antes de lanzar Claude Code.

137 

138**6. Reiniciar con canales habilitados**

139 

140Salga de Claude Code y reinicie con la bandera de canal. Esto conecta el plugin de Discord para que su bot pueda recibir y responder a mensajes:

141 

142```bash theme={null}

143claude --channels plugin:discord@claude-plugins-official

144```

145 

146**7. Emparejar su cuenta**

147 

148Envíe un mensaje directo a su bot en Discord. El bot responde con un código de emparejamiento.

149 

150> [!NOTE]

151>30>

152> Si su bot no responde, asegúrese de que Claude Code se esté ejecutando con `--channels` del paso anterior. El bot solo puede responder mientras el canal está activo.31> **1. Crear un bot de Telegram**

153 

154De vuelta en Claude Code, ejecute:

155 

156```

157/discord:access pair <code>

158```

159 

160Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:

161 

162```

163/discord:access policy allowlist

164```

165 

166**iMessage**

167 

168Vea el [código fuente completo de iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage).

169 

170El canal de iMessage lee su base de datos de Mensajes directamente y envía respuestas a través de AppleScript. Requiere macOS y no necesita token de bot ni servicio externo.

171 

172**1. Otorgar Acceso Completo al Disco**

173 

174La base de datos de Mensajes en `~/Library/Messages/chat.db` está protegida por macOS. La primera vez que el servidor la lee, macOS solicita acceso: haga clic en **Permitir**. El mensaje nombra cualquier aplicación que haya lanzado Bun, como Terminal, iTerm o su IDE.

175 

176Si la solicitud no aparece o hiciste clic en No Permitir, otorga acceso manualmente en **Configuración del Sistema > Privacidad y Seguridad > Acceso Completo al Disco** y agrega tu terminal. Sin esto, el servidor se cierra inmediatamente con `authorization denied`.

177 

178**2. Instalar el plugin**

179 

180Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

181 

182```

183/plugin install imessage@claude-plugins-official

184```

185 

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

187 

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

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

190 

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

192 

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

194 

195**3. Reiniciar con canales habilitados**

196 

197Sal de Claude Code y reinicia con el flag de canal:

198 

199```bash theme={null}

200claude --channels plugin:imessage@claude-plugins-official

201```

202 

203**4. Envíese un mensaje a sí mismo**

204 

205Abra Mensajes en cualquier dispositivo conectado a su ID de Apple y envíese un mensaje a sí mismo. Llega a Claude inmediatamente: el auto-chat evita el control de acceso sin configuración.

206 

207> [!NOTE]

208>32>

209> La primera respuesta que Claude envía activa un mensaje de Automatización de macOS preguntando si su terminal puede controlar Mensajes. Haga clic en **Aceptar**.33> Abre [BotFather](https://t.me/BotFather) en Telegram y envía `/newbot`. Asígnale un nombre para mostrar y un nombre de usuario único que termine en `bot`. Copia el token que devuelve BotFather.

210 34>

211**5. Permitir otros remitentes**35> **2. Instalar el plugin**

212 36>

213De forma predeterminada, solo sus propios mensajes pasan. Para permitir que otro contacto llegue a Claude, agregue su identificador:37> Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

38>

39> ```

40> /plugin install telegram@claude-plugins-official

41> ```

42>

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

44>

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

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

47>

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

49>

50> **3. Configurar tu token**

51>

52> Ejecuta el comando de configuración con el token de BotFather:

53>

54> ```

55> /telegram:configure <token>

56> ```

57>

58> Esto lo guarda en `~/.claude/channels/telegram/.env`. También puede establecer `TELEGRAM_BOT_TOKEN` en su entorno de shell antes de lanzar Claude Code.

59>

60> **4. Reiniciar con canales habilitados**

61>

62> Salga de Claude Code y reinicie con la bandera de canal. Esto inicia el plugin de Telegram, que comienza a sondear mensajes de su bot:

63>

64> ```bash theme={null}

65> claude --channels plugin:telegram@claude-plugins-official

66> ```

67>

68> **5. Emparejar su cuenta**

69>

70> Abra Telegram y envíe cualquier mensaje a su bot. El bot responde con un código de emparejamiento.

71>

72> > [!NOTE]

73> >

74> > Si su bot no responde, asegúrese de que Claude Code se esté ejecutando con `--channels` del paso anterior. El bot solo puede responder mientras el canal está activo.

75>

76> De vuelta en Claude Code, ejecute:

77>

78> ```

79> /telegram:access pair <code>

80> ```

81>

82> Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:

83>

84> ```

85> /telegram:access policy allowlist

86> ```

214 87 

215```88> [tab] Discord

216/imessage:access allow +1555123456789>

217```90> Vea el [código fuente completo de Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord).

91>

92> **1. Crear un bot de Discord**

93>

94> Vaya al [Portal de Desarrolladores de Discord](https://discord.com/developers/applications), haga clic en **Nueva Aplicación** y asígnele un nombre. En la sección **Bot**, cree un nombre de usuario y luego haga clic en **Restablecer Token** y copie el token.

95>

96> **2. Habilitar Intención de Contenido de Mensaje**

97>

98> En la configuración de su bot, desplácese hasta **Intenciones de Puerta de Enlace Privilegiadas** y habilite **Intención de Contenido de Mensaje**.

99>

100> **3. Invitar el bot a su servidor**

101>

102> Vaya a **OAuth2 > Generador de URL**. Seleccione el alcance `bot` y habilite estos permisos:

103>

104> * Ver Canales

105> * Enviar Mensajes

106> * Enviar Mensajes en Hilos

107> * Leer Historial de Mensajes

108> * Adjuntar Archivos

109> * Agregar Reacciones

110>

111> Abre la URL generada para agregar el bot a tu servidor.

112>

113> **4. Instalar el plugin**

114>

115> Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

116>

117> ```

118> /plugin install discord@claude-plugins-official

119> ```

120>

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

122>

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

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

125>

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

127>

128> **5. Configurar tu token**

129>

130> Ejecuta el comando de configuración con el token del bot que copiaste:

131>

132> ```

133> /discord:configure <token>

134> ```

135>

136> Esto lo guarda en `~/.claude/channels/discord/.env`. También puede establecer `DISCORD_BOT_TOKEN` en su entorno de shell antes de lanzar Claude Code.

137>

138> **6. Reiniciar con canales habilitados**

139>

140> Salga de Claude Code y reinicie con la bandera de canal. Esto conecta el plugin de Discord para que su bot pueda recibir y responder a mensajes:

141>

142> ```bash theme={null}

143> claude --channels plugin:discord@claude-plugins-official

144> ```

145>

146> **7. Emparejar su cuenta**

147>

148> Envíe un mensaje directo a su bot en Discord. El bot responde con un código de emparejamiento.

149>

150> > [!NOTE]

151> >

152> > Si su bot no responde, asegúrese de que Claude Code se esté ejecutando con `--channels` del paso anterior. El bot solo puede responder mientras el canal está activo.

153>

154> De vuelta en Claude Code, ejecute:

155>

156> ```

157> /discord:access pair <code>

158> ```

159>

160> Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:

161>

162> ```

163> /discord:access policy allowlist

164> ```

218 165 

219Los identificadores son números de teléfono en formato `+country` o correos electrónicos de ID de Apple como `user@example.com`.166> [tab] iMessage

167>

168> Vea el [código fuente completo de iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage).

169>

170> El canal de iMessage lee su base de datos de Mensajes directamente y envía respuestas a través de AppleScript. Requiere macOS y no necesita token de bot ni servicio externo.

171>

172> **1. Otorgar Acceso Completo al Disco**

173>

174> La base de datos de Mensajes en `~/Library/Messages/chat.db` está protegida por macOS. La primera vez que el servidor la lee, macOS solicita acceso: haga clic en **Permitir**. El mensaje nombra cualquier aplicación que haya lanzado Bun, como Terminal, iTerm o su IDE.

175>

176> Si la solicitud no aparece o hiciste clic en No Permitir, otorga acceso manualmente en **Configuración del Sistema > Privacidad y Seguridad > Acceso Completo al Disco** y agrega tu terminal. Sin esto, el servidor se cierra inmediatamente con `authorization denied`.

177>

178> **2. Instalar el plugin**

179>

180> Inicia Claude Code ejecutando `claude` en tu terminal y luego ingresa esto en su prompt:

181>

182> ```

183> /plugin install imessage@claude-plugins-official

184> ```

185>

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

187>

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

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

190>

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

192>

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

194>

195> **3. Reiniciar con canales habilitados**

196>

197> Sal de Claude Code y reinicia con el flag de canal:

198>

199> ```bash theme={null}

200> claude --channels plugin:imessage@claude-plugins-official

201> ```

202>

203> **4. Envíese un mensaje a sí mismo**

204>

205> Abra Mensajes en cualquier dispositivo conectado a su ID de Apple y envíese un mensaje a sí mismo. Llega a Claude inmediatamente: el auto-chat evita el control de acceso sin configuración.

206>

207> > [!NOTE]

208> >

209> > La primera respuesta que Claude envía activa un mensaje de Automatización de macOS preguntando si su terminal puede controlar Mensajes. Haga clic en **Aceptar**.

210>

211> **5. Permitir otros remitentes**

212>

213> De forma predeterminada, solo sus propios mensajes pasan. Para permitir que otro contacto llegue a Claude, agregue su identificador:

214>

215> ```

216> /imessage:access allow +15551234567

217> ```

218>

219> Los identificadores son números de teléfono en formato `+country` o correos electrónicos de ID de Apple como `user@example.com`.

220 220 

221## Inicio rápido221## Inicio rápido

222 222 

308| `channelsEnabled` | Interruptor maestro. Debe ser `true` para que cualquier channel entregue mensajes. Bloquea todos los channels incluida la bandera de desarrollo cuando está desactivado. Consulte [Habilitar channels para su organización](#enable-channels-for-your-organization). | claude.ai Team y Enterprise: channels bloqueados. Console: channels permitidos a menos que su organización implemente configuración administrada, en cuyo caso los channels se bloquean hasta que se establezca esta clave |308| `channelsEnabled` | Interruptor maestro. Debe ser `true` para que cualquier channel entregue mensajes. Bloquea todos los channels incluida la bandera de desarrollo cuando está desactivado. Consulte [Habilitar channels para su organización](#enable-channels-for-your-organization). | claude.ai Team y Enterprise: channels bloqueados. Console: channels permitidos a menos que su organización implemente configuración administrada, en cuyo caso los channels se bloquean hasta que se establezca esta clave |

309| `allowedChannelPlugins` | Qué plugins pueden registrarse una vez que los channels están habilitados. Reemplaza la lista mantenida por Anthropic cuando se establece. | Se aplica la lista predeterminada de Anthropic |309| `allowedChannelPlugins` | Qué plugins pueden registrarse una vez que los channels están habilitados. Reemplaza la lista mantenida por Anthropic cuando se establece. | Se aplica la lista predeterminada de Anthropic |

310 310 

311Los usuarios de Pro y Max sin una organización omiten estas comprobaciones por completo: los channels están disponibles y los usuarios optan por participar por sesión con `--channels`.311Los usuarios de Pro, Max y Ultra sin una organización omiten estas comprobaciones por completo: los canales están disponibles y los usuarios los habilitan por sesión con `--channels`.

312 312 

313### Habilitar channels para su organización313### Habilitar channels para su organización

314 314 

39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge), u otro navegador basado en Chromium como Brave, Arc, Vivaldi u Opera39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge), u otro navegador basado en Chromium como Brave, Arc, Vivaldi u Opera

40* Extensión [Claude en Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versión 1.0.36 o superior, disponible en la Chrome Web Store40* Extensión [Claude en Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versión 1.0.36 o superior, disponible en la Chrome Web Store

41* [Claude Code](https://code.claude.com/docs/es/quickstart.md#step-1-install-claude-code)41* [Claude Code](https://code.claude.com/docs/es/quickstart.md#step-1-install-claude-code)

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

43 43 

44En las organizaciones Enterprise que tienen HIPAA habilitado, Claude en Chrome está desactivado de forma predeterminada, y un [propietario](https://code.claude.com/docs/es/server-managed-settings.md#access-control) puede activarlo en [**Configuración de la organización > Claude en Chrome**](https://claude.ai/admin-settings/browser-extension). Tu Acuerdo de Asociado Comercial (BAA) con Anthropic no cubre los datos enviados a sitios de terceros a través de Claude en Chrome. Consulta la [Guía de implementación](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver una lista de Servicios Elegibles.44En las organizaciones Enterprise que tienen HIPAA habilitado, Claude en Chrome está desactivado de forma predeterminada, y un [propietario](https://code.claude.com/docs/es/server-managed-settings.md#access-control) puede activarlo en [**Configuración de la organización > Claude en Chrome**](https://claude.ai/admin-settings/browser-extension). Tu Acuerdo de Asociado Comercial (BAA) con Anthropic no cubre los datos enviados a sitios de terceros a través de Claude en Chrome. Consulta la [Guía de implementación](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) para ver una lista de Servicios Elegibles.

45 45 

325 325 

326**7. Implemente**326**7. Implemente**

327 327 

328**ECS Fargate**328> [tab] ECS Fargate

329 329>

330Cree el clúster y un grupo de registros para stderr del gateway, que lleva tanto sus eventos de auditoría como registros operacionales. La retención es una llamada separada, y sin una CloudWatch mantiene los registros para siempre; alinee los 90 días con su política de retención de auditoría:330> Cree el clúster y un grupo de registros para stderr del gateway, que lleva tanto sus eventos de auditoría como registros operacionales. La retención es una llamada separada, y sin una CloudWatch mantiene los registros para siempre; alinee los 90 días con su política de retención de auditoría:

331 331>

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

333aws ecs create-cluster --cluster-name claude-gateway333> aws ecs create-cluster --cluster-name claude-gateway

334aws logs create-log-group --log-group-name /ecs/claude-gateway334> aws logs create-log-group --log-group-name /ecs/claude-gateway

335aws logs put-retention-policy --log-group-name /ecs/claude-gateway \335> aws logs put-retention-policy --log-group-name /ecs/claude-gateway \

336 --retention-in-days 90336> --retention-in-days 90

337```337> ```

338 338>

339Escriba la definición de tarea. El rol de tarea lleva el permiso de Bedrock y el rol de ejecución inyecta los secretos; use los ARN de secretos del paso de Secrets Manager:339> Escriba la definición de tarea. El rol de tarea lleva el permiso de Bedrock y el rol de ejecución inyecta los secretos; use los ARN de secretos del paso de Secrets Manager:

340 340>

341```json claude-gateway-task.json theme={null}341> ```json claude-gateway-task.json theme={null}

342{342> {

343 "family": "claude-gateway",343> "family": "claude-gateway",

344 "networkMode": "awsvpc",344> "networkMode": "awsvpc",

345 "requiresCompatibilities": ["FARGATE"],345> "requiresCompatibilities": ["FARGATE"],

346 "cpu": "1024",346> "cpu": "1024",

347 "memory": "2048",347> "memory": "2048",

348 "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },348> "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },

349 "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",349> "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",

350 "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",350> "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",

351 "containerDefinitions": [351> "containerDefinitions": [

352 {352> {

353 "name": "gateway",353> "name": "gateway",

354 "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",354> "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",

355 "portMappings": [{ "containerPort": 8080 }],355> "portMappings": [{ "containerPort": 8080 }],

356 "secrets": [356> "secrets": [

357 { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },357> { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },

358 { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },358> { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },

359 { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }359> { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }

360 ],360> ],

361 "logConfiguration": {361> "logConfiguration": {

362 "logDriver": "awslogs",362> "logDriver": "awslogs",

363 "options": {363> "options": {

364 "awslogs-group": "/ecs/claude-gateway",364> "awslogs-group": "/ecs/claude-gateway",

365 "awslogs-region": "<region>",365> "awslogs-region": "<region>",

366 "awslogs-stream-prefix": "gateway"366> "awslogs-stream-prefix": "gateway"

367 }367> }