17* [Delegar investigación a subagentes](#delegate-research-to-subagents) para mantener su contexto principal limpio17* [Delegar investigación a subagentes](#delegate-research-to-subagents) para mantener su contexto principal limpio
18* [Canalizar Claude en scripts](#pipe-claude-into-scripts) para CI y procesamiento por lotes18* [Canalizar Claude en scripts](#pipe-claude-into-scripts) para CI y procesamiento por lotes
19 19
20## Recetas de indicaciones20## Recetas de prompts
21 21
22Estos son patrones de indicaciones para tareas cotidianas como explorar código desconocido, depuración, refactorización, escritura de pruebas y creación de PRs. Cada uno funciona en cualquier superficie de Claude Code; adapte la redacción a su proyecto.22Estos son patrones de prompts para tareas cotidianas como explorar código desconocido, depurar, refactorizar, escribir pruebas y crear PRs. Cada uno funciona en cualquier superficie de Claude Code; adapta la redacción a tu proyecto.
23 23
24### Comprender nuevas bases de código24### Comprender bases de código nuevas
25 25
26Para configurar Claude Code en un monorepo o base de código grande, consulte [Monorepos y repositorios grandes](https://code.claude.com/docs/es/large-codebases.md).26Para configurar Claude Code en un monorepo o en una base de código grande, consulta [Monorepos y repositorios grandes](https://code.claude.com/docs/es/large-codebases.md).
27 27
28#### Obtener una descripción general rápida de la base de código28#### Obtener una visión general rápida de la base de código
29 29
30Supongamos que acaba de unirse a un nuevo proyecto y necesita comprender su estructura rápidamente.30Supongamos que acabas de unirte a un proyecto nuevo y necesitas comprender su estructura rápidamente.
31 31
32**1. Navegue al directorio raíz del proyecto**32**1. Navega al directorio raíz del proyecto**
33 33
34```bash theme={null}34```bash theme={null}
35cd /path/to/project 35cd /path/to/project
36```36```
37 37
38Reemplace `/path/to/project` con la ruta a su proyecto.38Reemplaza `/path/to/project` con la ruta de tu proyecto.
39 39
40**2. Inicie Claude Code**40**2. Inicia Claude Code**
41 41
42```bash theme={null}42```bash theme={null}
43claude 43claude
44```44```
45 45
46**3. Solicite una descripción general de alto nivel**46**3. Pide una visión general de alto nivel**
47 47
48```text wrap theme={null}48```text wrap theme={null}
49dame una descripción general de esta base de código49give me an overview of this codebase
50```50```
51 51
52**4. Profundice en componentes específicos**52**4. Profundiza en componentes específicos**
53 53
54```text wrap theme={null}54```text wrap theme={null}
55explica los patrones de arquitectura principales utilizados aquí55explain the main architecture patterns used here
56```56```
57 57
58```text wrap theme={null}58```text wrap theme={null}
59¿cuáles son los modelos de datos clave?59what are the key data models?
60```60```
61 61
62```text wrap theme={null}62```text wrap theme={null}
63¿cómo se maneja la autenticación?63how is authentication handled?
64```64```
65 65
66> [!TIP]66> [!TIP]
67>67>
68> Consejos:68> Consejos:
69>69>
70> * Comience con preguntas amplias, luego reduzca a áreas específicas70> * Comienza con preguntas amplias y luego enfócate en áreas específicas
71> * Pregunte sobre convenciones de codificación y patrones utilizados en el proyecto71> * Pregunta sobre las convenciones de código y los patrones usados en el proyecto
72> * Solicite un glosario de términos específicos del proyecto72> * Solicita un glosario de términos específicos del proyecto
73 73
74#### Encontrar código relevante74#### Encontrar código relevante
75 75
76Supongamos que necesita localizar código relacionado con una característica o funcionalidad específica.76Supongamos que necesitas localizar código relacionado con una funcionalidad específica.
77 77
78**1. Pida a Claude que encuentre archivos relevantes**78**1. Pide a Claude que encuentre los archivos relevantes**
79 79
80```text wrap theme={null}80```text wrap theme={null}
81encuentra los archivos que manejan la autenticación de usuarios81find the files that handle user authentication
82```82```
83 83
84**2. Obtenga contexto sobre cómo interactúan los componentes**84**2. Obtén contexto sobre cómo interactúan los componentes**
85 85
86```text wrap theme={null}86```text wrap theme={null}
87¿cómo funcionan juntos estos archivos de autenticación?87how do these authentication files work together?
88```88```
89 89
90**3. Comprenda el flujo de ejecución**90**3. Comprende el flujo de ejecución**
91 91
92```text wrap theme={null}92```text wrap theme={null}
93rastrea el proceso de inicio de sesión desde el front-end hasta la base de datos93trace the login process from front-end to database
94```94```
95 95
96> [!TIP]96> [!TIP]
97>97>
98> Consejos:98> Consejos:
99>99>
100> * Sea específico sobre lo que está buscando100> * Sé específico sobre lo que buscas
101> * Utilice el lenguaje del dominio del proyecto101> * Usa el lenguaje del dominio del proyecto
102> * Instale un [plugin de inteligencia de código](https://code.claude.com/docs/es/plugins/code-intelligence.md) para su lenguaje para dar a Claude una navegación precisa de "ir a definición" y "buscar referencias"102> * Instala un [plugin de inteligencia de código](https://code.claude.com/docs/es/plugins/code-intelligence.md) para tu lenguaje para darle a Claude navegación precisa de "ir a la definición" y "buscar referencias"
103 103
104***104***
105 105
106### Corregir errores de manera eficiente106### Corregir errores de forma eficiente
107 107
108Supongamos que ha encontrado un mensaje de error y necesita encontrar y corregir su origen.108Supongamos que te encontraste con un mensaje de error y necesitas encontrar y corregir su origen.
109 109
110**1. Comparta el error con Claude**110**1. Comparte el error con Claude**
111 111
112```text wrap theme={null}112```text wrap theme={null}
113estoy viendo un error cuando ejecuto npm test113I'm seeing an error when I run npm test
114```114```
115 115
116**2. Solicite recomendaciones de corrección**116**2. Pide recomendaciones para corregirlo**
117 117
118```text wrap theme={null}118```text wrap theme={null}
119sugiere algunas formas de corregir el @ts-ignore en user.ts119suggest a few ways to fix the @ts-ignore in user.ts
120```120```
121 121
122**3. Aplique la corrección**122**3. Aplica la corrección**
123 123
124```text wrap theme={null}124```text wrap theme={null}
125actualiza user.ts para agregar la verificación nula que sugeriste125update user.ts to add the null check you suggested
126```126```
127 127
128> [!TIP]128> [!TIP]
129>129>
130> Consejos:130> Consejos:
131>131>
132> * Dígale a Claude el comando para reproducir el problema y obtener un seguimiento de pila132> * Dile a Claude el comando para reproducir el problema y obtener un stack trace
133> * Mencione cualquier paso para reproducir el error133> * Menciona los pasos para reproducir el error
134> * Hágale saber a Claude si el error es intermitente o consistente134> * Indícale a Claude si el error es intermitente o constante
135 135
136***136***
137 137
138### Refactorizar código138### Refactorizar código
139 139
140Supongamos que necesita actualizar código antiguo para utilizar patrones y prácticas modernas.140Supongamos que necesitas actualizar código antiguo para usar patrones y prácticas modernas.
141 141
142Para portar una base de código completa a un nuevo lenguaje, consulte [cómo Anthropic ejecuta migraciones de código a gran escala con Claude Code](https://claude.com/blog/ai-code-migration) en el blog.142Para portar una base de código completa a un lenguaje nuevo, consulta [cómo Anthropic ejecuta migraciones de código a gran escala con Claude Code](https://claude.com/blog/ai-code-migration) en el blog.
143 143
144**1. Identifique código heredado para refactorización**144**1. Identifica código heredado para refactorizar**
145 145
146```text wrap theme={null}146```text wrap theme={null}
147encuentra el uso de API obsoleta en nuestra base de código147find deprecated API usage in our codebase
148```148```
149 149
150**2. Obtenga recomendaciones de refactorización**150**2. Obtén recomendaciones de refactorización**
151 151
152```text wrap theme={null}152```text wrap theme={null}
153sugiere cómo refactorizar utils.js para usar características modernas de JavaScript153suggest how to refactor utils.js to use modern JavaScript features
154```154```
155 155
156**3. Aplique los cambios de manera segura**156**3. Aplica los cambios de forma segura**
157 157
158```text wrap theme={null}158```text wrap theme={null}
159refactoriza utils.js para usar características de ES2024 manteniendo el mismo comportamiento159refactor utils.js to use ES2024 features while maintaining the same behavior
160```160```
161 161
162**4. Verifique la refactorización**162**4. Verifica la refactorización**
163 163
164```text wrap theme={null}164```text wrap theme={null}
165ejecuta pruebas para el código refactorizado165run tests for the refactored code
166```166```
167 167
168> [!TIP]168> [!TIP]
169>169>
170> Consejos:170> Consejos:
171>171>
172> * Pida a Claude que explique los beneficios del enfoque moderno172> * Pide a Claude que explique los beneficios del enfoque moderno
173> * Solicite que los cambios mantengan la compatibilidad hacia atrás cuando sea necesario173> * Solicita que los cambios mantengan la compatibilidad con versiones anteriores cuando sea necesario
174> * Realice la refactorización en incrementos pequeños y comprobables174> * Refactoriza en incrementos pequeños y comprobables
175 175
176***176***
177 177
178### Trabajar con pruebas178### Trabajar con pruebas
179 179
180Supongamos que necesita agregar pruebas para código no cubierto.180Supongamos que necesitas agregar pruebas para código sin cobertura.
181 181
182**1. Identifique código no probado**182**1. Identifica código sin pruebas**
183 183
184```text wrap theme={null}184```text wrap theme={null}
185encuentra funciones en NotificationsService.swift que no están cubiertas por pruebas185find functions in NotificationsService.swift that are not covered by tests
186```186```
187 187
188**2. Genere andamiaje de prueba**188**2. Genera la estructura base de las pruebas**
189 189
190```text wrap theme={null}190```text wrap theme={null}
191agrega pruebas para el servicio de notificaciones191add tests for the notification service
192```192```
193 193
194**3. Agregue casos de prueba significativos**194**3. Agrega casos de prueba significativos**
195 195
196```text wrap theme={null}196```text wrap theme={null}
197agrega casos de prueba para condiciones de borde en el servicio de notificaciones197add test cases for edge conditions in the notification service
198```198```
199 199
200**4. Ejecute y verifique las pruebas**200**4. Ejecuta y verifica las pruebas**
201 201
202```text wrap theme={null}202```text wrap theme={null}
203ejecuta las nuevas pruebas y corrige cualquier fallo203run the new tests and fix any failures
204```204```
205 205
206Claude puede generar pruebas que sigan los patrones y convenciones existentes de su proyecto. Al solicitar pruebas, sea específico sobre qué comportamiento desea verificar. Claude examina sus archivos de prueba existentes para coincidir con el estilo, marcos y patrones de afirmación ya en uso.206Claude puede generar pruebas que sigan los patrones y las convenciones existentes de tu proyecto. Al pedir pruebas, sé específico sobre qué comportamiento quieres verificar. Claude examina tus archivos de prueba existentes para igualar el estilo, los frameworks y los patrones de aserción que ya se usan.
207 207
208Para mejorar la cobertura, pide a Claude que identifique casos extremos que podrías haber pasado por alto. Claude puede analizar tus rutas de código y sugerir pruebas para condiciones de error, valores límite y entradas inesperadas que a menudo se pasan por alto.208Para mejorar la cobertura, pide a Claude que identifique casos límite que podrías haber pasado por alto. Claude puede analizar las rutas de tu código y sugerir pruebas para condiciones de error, valores límite y entradas inesperadas que a menudo se pasan por alto.
209 209
210***210***
211 211
212### Crear solicitudes de extracción212### Crear pull requests
213 213
214Puede crear solicitudes de extracción pidiendo a Claude directamente ("crear una pr para mis cambios"), o guiar a Claude a través de ella paso a paso:214Puedes crear pull requests pidiéndoselo a Claude directamente ("create a pr for my changes"), o guiar a Claude paso a paso:
215 215
216**1. Resuma sus cambios**216**1. Resume tus cambios**
217 217
218```text wrap theme={null}218```text wrap theme={null}
219resume los cambios que he hecho en el módulo de autenticación219summarize the changes I've made to the authentication module
220```220```
221 221
222**2. Genere una solicitud de extracción**222**2. Genera un pull request**
223 223
224```text wrap theme={null}224```text wrap theme={null}
225crea un pr225create a pr
226```226```
227 227
228**3. Revise y refine**228**3. Revisa y refina**
229 229
230```text wrap theme={null}230```text wrap theme={null}
231mejora la descripción del PR con más contexto sobre las mejoras de seguridad231enhance the PR description with more context about the security improvements
232```232```
233 233
234Para encontrar la sesión más tarde, ejecute `claude --from-pr 1234` con su propio número de PR, que abre el selector de sesión filtrado a sesiones vinculadas a esa PR, o pegue la URL de la PR en el selector [`/resume`](https://code.claude.com/docs/es/sessions#use-the-session-picker). Claude Code vincula la sesión a la PR cuando Claude la crea con `gh pr create` o `glab mr create`, y cuando Claude [trabaja en una PR existente](https://code.claude.com/docs/es/agent-view.md#pull-request-status).234Para encontrar la sesión más tarde, ejecuta `claude --from-pr 1234` con tu propio número de PR, lo que abre el selector de sesiones filtrado a las sesiones vinculadas a ese PR, o pega la URL del PR en la búsqueda del [selector de `/resume`](https://code.claude.com/docs/es/sessions#use-the-session-picker). Claude Code vincula la sesión al PR cuando Claude lo crea con `gh pr create` o `glab mr create`, y cuando Claude [trabaja en un PR existente](https://code.claude.com/docs/es/agent-view.md#pull-request-status).
235 235
236> [!TIP]236> [!TIP]
237>237>
238> Revise la PR generada por Claude antes de enviarla y pida a Claude que destaque los riesgos potenciales o consideraciones.238> Revisa el PR generado por Claude antes de enviarlo y pide a Claude que destaque posibles riesgos o consideraciones.
239 239
240### Manejar documentación240### Gestionar la documentación
241 241
242Supongamos que necesita agregar o actualizar documentación para su código.242Supongamos que necesitas agregar o actualizar la documentación de tu código.
243 243
244**1. Identifique código sin documentar**244**1. Identifica código sin documentar**
245 245
246```text wrap theme={null}246```text wrap theme={null}
247encuentra funciones sin comentarios JSDoc adecuados en el módulo de autenticación247find functions without proper JSDoc comments in the auth module
248```248```
249 249
250**2. Genere documentación**250**2. Genera la documentación**
251 251
252```text wrap theme={null}252```text wrap theme={null}
253agrega comentarios JSDoc a las funciones sin documentar en auth.js253add JSDoc comments to the undocumented functions in auth.js
254```254```
255 255
256**3. Revise y mejore**256**3. Revisa y mejora**
257 257
258```text wrap theme={null}258```text wrap theme={null}
259mejora la documentación generada con más contexto y ejemplos259improve the generated documentation with more context and examples
260```260```
261 261
262**4. Verifique la documentación**262**4. Verifica la documentación**
263 263
264```text wrap theme={null}264```text wrap theme={null}
265verifica si la documentación sigue nuestros estándares de proyecto265check if the documentation follows our project standards
266```266```
267 267
268> [!TIP]268> [!TIP]
269>269>
270> Consejos:270> Consejos:
271>271>
272> * Especifique el estilo de documentación que desea (JSDoc, docstrings, etc.)272> * Especifica el estilo de documentación que quieres (JSDoc, docstrings, etc.)
273> * Solicite ejemplos en la documentación273> * Pide ejemplos en la documentación
274> * Solicite documentación para API públicas, interfaces y lógica compleja274> * Solicita documentación para API públicas, interfaces y lógica compleja
275 275
276***276***
277 277
278### Trabajar en notas y carpetas que no son código278### Trabajar en notas y carpetas que no son de código
279 279
280Claude Code funciona en cualquier directorio. Ejecútelo dentro de una bóveda de notas, una carpeta de documentación o cualquier colección de archivos markdown para buscar, editar y reorganizar contenido de la misma manera que lo haría con código.280Claude Code funciona en cualquier directorio. Ejecútalo dentro de un vault de notas, una carpeta de documentación o cualquier colección de archivos markdown para buscar, editar y reorganizar contenido de la misma forma en que lo harías con código.
281 281
282El directorio `.claude/` y `CLAUDE.md` se encuentran junto a los directorios de configuración de otras herramientas sin conflicto. Claude lee archivos nuevos en cada llamada de herramienta, por lo que ve las ediciones que realiza en otra aplicación la próxima vez que lee ese archivo.282El directorio `.claude/` y `CLAUDE.md` conviven con los directorios de configuración de otras herramientas sin conflictos. Claude lee los archivos de nuevo en cada llamada a herramienta, por lo que ve las ediciones que haces en otra aplicación la próxima vez que lee ese archivo.
283 283
284***284***
285 285
286### Trabajar con imágenes286### Trabajar con imágenes
287 287
288Supongamos que necesita trabajar con imágenes en su base de código y desea la ayuda de Claude para analizar el contenido de la imagen.288Supongamos que necesitas trabajar con imágenes en tu base de código y quieres la ayuda de Claude para analizar su contenido.
289 289
290**1. Agregue una imagen a la conversación**290**1. Agrega una imagen a la conversación**
291 291
292Puede usar cualquiera de estos métodos:292Puedes usar cualquiera de estos métodos:
293 293
2941. Arrastre y suelte una imagen en la ventana de Claude Code2941. Arrastra y suelta una imagen en la ventana de Claude Code
2952. Copie una imagen y péguela en la CLI con `Ctrl+V`, o con [`Alt+V` en Windows y WSL](https://code.claude.com/docs/es/interactive-mode#general-controls)2952. Copia una imagen y pégala en la CLI con `Ctrl+V`, o con [`Alt+V` en Windows y WSL](https://code.claude.com/docs/es/interactive-mode#general-controls)
2963. Proporcione una ruta de imagen a Claude. Por ejemplo, "Analiza esta imagen: /path/to/your/image.png"2963. Proporciona a Claude la ruta de una imagen, por ejemplo "Analyze this image: /path/to/your/image.png"
297 297
298**2. Pida a Claude que analice la imagen**298**2. Pide a Claude que analice la imagen**
299 299
300```text wrap theme={null}300```text wrap theme={null}
301¿Qué muestra esta imagen?301What does this image show?
302```302```
303 303
304```text wrap theme={null}304```text wrap theme={null}
305Describe los elementos de la interfaz de usuario en esta captura de pantalla305Describe the UI elements in this screenshot
306```306```
307 307
308```text wrap theme={null}308```text wrap theme={null}
309¿Hay algún elemento problemático en este diagrama?309Are there any problematic elements in this diagram?
310```310```
311 311
312**3. Usar imágenes para contexto**312**3. Usa imágenes como contexto**
313 313
314```text wrap theme={null}314```text wrap theme={null}
315Aquí hay una captura de pantalla del error. ¿Qué lo está causando?315Here's a screenshot of the error. What's causing it?
316```316```
317 317
318```text wrap theme={null}318```text wrap theme={null}
319Este es nuestro esquema de base de datos actual. ¿Cómo deberíamos modificarlo para la nueva característica?319This is our current database schema. How should we modify it for the new feature?
320```320```
321 321
322**4. Obtenga sugerencias de código del contenido visual**322**4. Obtén sugerencias de código a partir de contenido visual**
323 323
324```text wrap theme={null}324```text wrap theme={null}
325Genera CSS que coincida con este mockup de diseño325Generate CSS to match this design mockup
326```326```
327 327
328```text wrap theme={null}328```text wrap theme={null}
329¿Qué estructura HTML recrearía este componente?329What HTML structure would recreate this component?
330```330```
331 331
332> [!TIP]332> [!TIP]
333>333>
334> Consejos:334> Consejos:
335>335>
336> * Use imágenes cuando las descripciones de texto serían poco claras o engorrosas336> * Usa imágenes cuando las descripciones de texto serían poco claras o engorrosas
337> * Incluya capturas de pantalla de errores, diseños de interfaz de usuario o diagramas para mejor contexto337> * Incluye capturas de pantalla de errores, diseños de UI o diagramas para dar un mejor contexto
338> * Puede trabajar con múltiples imágenes en una conversación338> * Puedes trabajar con varias imágenes en una conversación
339> * El análisis de imágenes funciona con diagramas, capturas de pantalla, mockups y más339> * El análisis de imágenes funciona con diagramas, capturas de pantalla, mockups y más
340> * Cuando Claude hace referencia a imágenes (por ejemplo, `[Image #1]`), `Cmd+Click` (Mac) o `Ctrl+Click` (Windows/Linux) el enlace para abrir la imagen en su visor predeterminado340> * Cuando Claude hace referencia a imágenes (por ejemplo, `[Image #1]`), haz `Cmd+Click` (Mac) o `Ctrl+Click` (Windows/Linux) en el enlace para abrir la imagen en tu visor predeterminado
341 341
342***342***
343 343
344### Archivos y directorios de referencia344### Hacer referencia a archivos y directorios
345 345
346Use @ para incluir rápidamente archivos o directorios sin esperar a que Claude los lea.346Usa @ para incluir rápidamente archivos o directorios sin esperar a que Claude los lea.
347 347
348**1. Haga referencia a un archivo único**348**1. Haz referencia a un solo archivo**
349 349
350```text wrap theme={null}350```text wrap theme={null}
351Explica la lógica en @src/utils/auth.js351Explain the logic in @src/utils/auth.js
352```352```
353 353
354Esto incluye el contenido del archivo en la conversación cuando cabe en el límite de tokens de la [herramienta Read](https://code.claude.com/docs/es/tools-reference.md#read-tool-behavior), que es de 25,000 tokens de forma predeterminada. Un archivo de texto de más de 256KB no se incluye.354Esto incluye el contenido del archivo en la conversación cuando cabe en el límite de tokens de la [herramienta Read](https://code.claude.com/docs/es/tools-reference.md#read-tool-behavior), de 25,000 tokens de forma predeterminada. Un archivo de texto de más de 256KB no se incluye.
355 355
356**2. Haz referencia a un directorio**356**2. Haz referencia a un directorio**
357 357
358```text wrap theme={null}358```text wrap theme={null}
359¿Cuál es la estructura de @src/components?359What's the structure of @src/components?
360```360```
361 361
362**3. Haga referencia a recursos MCP**362**3. Haz referencia a recursos MCP**
363 363
364```text wrap theme={null}364```text wrap theme={null}
365Muéstrame los datos de @github:repos/owner/repo/issues365Show me the data from @github:repos/owner/repo/issues
366```366```
367 367
368Esto obtiene datos de servidores MCP conectados usando el formato @server:resource. Consulte [recursos MCP](https://code.claude.com/docs/es/mcp.md#use-mcp-resources) para más detalles.368Esto obtiene datos de los servidores MCP conectados usando el formato @server:resource. Consulta [Recursos MCP](https://code.claude.com/docs/es/mcp.md#use-mcp-resources) para más detalles.
369 369
370> [!TIP]370> [!TIP]
371>371>
372> Consejos:372> Consejos:
373>373>
374> * Las rutas de archivo pueden ser relativas o absolutas374> * Las rutas de archivo pueden ser relativas o absolutas
375> * Escriba `@` para abrir un menú de sugerencias de ruta, luego presione Intro o Tab para aceptar la ruta resaltada e Intro nuevamente para enviar el mensaje375> * Escribe `@` para abrir un menú de sugerencias de rutas, luego presiona Enter o Tab para aceptar la ruta resaltada y Enter de nuevo para enviar el mensaje
376> * Las referencias de archivo @ agregan `CLAUDE.md` en el directorio del archivo y directorios principales al contexto376> * Las referencias a archivos con @ agregan al contexto el `CLAUDE.md` del directorio del archivo y de los directorios superiores
377> * Las referencias de directorio muestran listados de archivos, no contenidos377> * Las referencias a directorios muestran listados de archivos, no su contenido
378> * Puede hacer referencia a múltiples archivos en un solo mensaje (por ejemplo, "@file1.js y @file2.js")378> * Puedes hacer referencia a varios archivos en un solo mensaje (por ejemplo, "@file1.js and @file2.js")
379 379
380Para evitar que las referencias con `@` incluyan el contenido de los archivos y los listados de directorios, establece [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](https://code.claude.com/docs/es/env-vars#variables) en `1` en tu shell o en el [bloque `env`](https://code.claude.com/docs/es/env-vars#set-variables-in-settings-files) de la configuración de usuario o de la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md). Claude recibe entonces las rutas que referenciaste junto con una nota para leerlas usando sus herramientas de archivos. La variable requiere Claude Code v2.1.299 o posterior, y Claude Code la ignora en la configuración de proyecto y local.380Para evitar que las referencias con `@` incluyan el contenido de archivos y los listados de directorios, establece [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](https://code.claude.com/docs/es/env-vars#variables) en `1` en tu shell o en el [bloque `env`](https://code.claude.com/docs/es/env-vars#set-variables-in-settings-files) de la configuración de usuario o de la [configuración administrada](https://code.claude.com/docs/es/managed-settings.md). Claude recibe entonces las rutas que referenciaste con una nota para leerlas usando sus herramientas de archivos. La variable requiere Claude Code v2.1.299 o posterior, y Claude Code la ignora en la configuración de proyecto y local.
381 381
382Tus [hooks `PreToolUse`](https://code.claude.com/docs/es/hooks#pretooluse) no se ejecutan cuando Claude Code incluye un archivo que referencias con `@`, porque no realiza ninguna llamada a herramienta. Si dependes de esos hooks para controlar lo que Claude lee, bloquea rutas específicas o evita que las referencias con `@` incluyan archivos:382Tus [hooks `PreToolUse`](https://code.claude.com/docs/es/hooks#pretooluse) no se ejecutan cuando Claude Code incluye un archivo que referencias con `@`, porque no hace ninguna llamada a herramienta. Si dependes de esos hooks para controlar lo que Claude lee, bloquea rutas específicas o evita que las referencias con `@` incluyan archivos:
383 383
384* **Bloquear rutas específicas**: agrega una [regla de denegación de `Read`](https://code.claude.com/docs/es/permissions#read-and-edit) para ellas. Claude Code no incluye un archivo que coincida con la regla.384* **Bloquear rutas específicas**: agrega una [regla de denegación `Read`](https://code.claude.com/docs/es/permissions#read-and-edit) para ellas. Claude Code no incluye un archivo que coincida con la regla.
385* **Evitar que las referencias con `@` incluyan archivos**: establece `CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`, lo que evita que las referencias con `@` a archivos y directorios en tus mensajes incluyan contenido, incluso para rutas que tus hooks no verifican. Tus hooks coincidentes se ejecutan entonces antes de que Claude abra una ruta referenciada con una herramienta como `Read`.385* **Evitar que las referencias con `@` incluyan archivos**: establece `CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`, lo que impide que las referencias a archivos y directorios con `@` en tus mensajes incluyan contenido, incluso para rutas que tus hooks no verifican. Tus hooks correspondientes se ejecutan entonces antes de que Claude abra una ruta referenciada con una herramienta como `Read`.
386 386
387***387***
388 388
389### Ejecutar Claude en un horario389### Ejecutar Claude de forma programada
390 390
391Supongamos que desea que Claude maneje una tarea automáticamente de forma recurrente, como revisar PRs abiertas cada mañana, auditar dependencias semanalmente o verificar fallas de CI durante la noche.391Supongamos que quieres que Claude se encargue de una tarea automáticamente de forma recurrente, como revisar los PRs abiertos cada mañana, auditar las dependencias cada semana o buscar fallas de CI durante la noche.
392 392
393Elija una opción de programación según dónde desee que se ejecute la tarea:393Elige una opción de programación según dónde quieres que se ejecute la tarea:
394 394
395| Opción | Dónde se ejecuta | Mejor para |395| Opción | Dónde se ejecuta | Ideal para |
396| :- | :- | :- |396| :- | :- | :- |
397| [Tareas programadas en la nube](https://code.claude.com/docs/es/routines.md) | Nube, administrada por Anthropic de forma predeterminada | Tareas que deben ejecutarse incluso cuando tu computadora está apagada. También pueden activarse con llamadas a la API o eventos de GitHub además de un horario. Configúralas en [claude.ai/code/routines](https://claude.ai/code/routines). |397| [Tareas programadas en la nube](https://code.claude.com/docs/es/routines.md) | En la nube, administrada por Anthropic de forma predeterminada | Tareas que deben ejecutarse incluso cuando tu computadora está apagada. También pueden activarse con llamadas a la API o eventos de GitHub además de un horario. Configúralas en [claude.ai/code/routines](https://claude.ai/code/routines). |
398| [Tareas programadas de escritorio](https://code.claude.com/docs/es/desktop-scheduled-tasks.md) | Su máquina, a través de la aplicación de escritorio | Tareas que necesitan acceso directo a archivos locales, herramientas o cambios sin confirmar. |398| [Tareas programadas de escritorio](https://code.claude.com/docs/es/desktop-scheduled-tasks.md) | Tu máquina, mediante la aplicación de escritorio | Tareas que necesitan acceso directo a archivos locales, herramientas o cambios sin confirmar. |
399| [GitHub Actions](https://code.claude.com/docs/es/github-actions.md) | Su canalización de CI | Tareas vinculadas a eventos de repositorio como PRs abiertos, o horarios cron que deben vivir junto con su configuración de flujo de trabajo. |399| [GitHub Actions](https://code.claude.com/docs/es/github-actions.md) | Tu pipeline de CI | Tareas vinculadas a eventos del repositorio como PRs abiertos, o programaciones cron que deben vivir junto a la configuración de tu workflow. |
400| [`/loop`](https://code.claude.com/docs/es/scheduled-tasks) | La sesión CLI actual | Sondeo rápido mientras una sesión está abierta. `--resume` y `--continue` restauran los bucles de intervalo fijo no expirados. |400| [`/loop`](https://code.claude.com/docs/es/scheduled-tasks) | La sesión actual de la CLI | Sondeos rápidos mientras una sesión está abierta. `--resume` y `--continue` restauran los bucles de intervalo fijo que no han expirado. |
401 401
402> [!TIP]402> [!TIP]
403>403>
404> Al escribir indicaciones para tareas programadas, sea explícito sobre qué se ve como éxito y qué hacer con los resultados. La tarea se ejecuta de forma autónoma, por lo que no puede hacer preguntas aclaratorias. Por ejemplo: "Revise PRs abiertas etiquetadas con `needs-review`, deje comentarios en línea sobre cualquier problema y publique un resumen en el canal `#eng-reviews` de Slack."404> Al escribir prompts para tareas programadas, sé explícito sobre cómo se ve el éxito y qué hacer con los resultados. La tarea se ejecuta de forma autónoma, así que no puede hacer preguntas aclaratorias. Por ejemplo: "Review open PRs labeled `needs-review`, leave inline comments on any issues, and post a summary in the `#eng-reviews` Slack channel."
405 405
406***406***
407 407
408### Pregunte a Claude sobre sus capacidades408### Preguntar a Claude sobre sus capacidades
409 409
410Claude puede responder preguntas sobre sus propias características y limitaciones. Busca las respuestas en la documentación actual de Claude Code, por lo que no se limitan a la versión que estás ejecutando.410Claude puede responder preguntas sobre sus propias funcionalidades y limitaciones. Busca las respuestas en la documentación actual de Claude Code, así que no se limitan a la versión que estás ejecutando.
411 411
412#### Preguntas de ejemplo412#### Preguntas de ejemplo
413 413
414```text wrap theme={null}414```text wrap theme={null}
415¿puede Claude Code crear pull requests?415can Claude Code create pull requests?
416```416```
417 417
418```text wrap theme={null}418```text wrap theme={null}
419¿cómo maneja Claude Code los permisos?419how does Claude Code handle permissions?
420```420```
421 421
422```text wrap theme={null}422```text wrap theme={null}
423¿qué skills están disponibles?423what skills are available?
424```424```
425 425
426```text wrap theme={null}426```text wrap theme={null}
427¿cómo uso MCP con Claude Code?427how do I use MCP with Claude Code?
428```428```
429 429
430```text wrap theme={null}430```text wrap theme={null}
431¿cómo configuro Claude Code para Amazon Bedrock?431how do I configure Claude Code for Amazon Bedrock?
432```432```
433 433
434```text wrap theme={null}434```text wrap theme={null}
435¿cuáles son las limitaciones de Claude Code?435what are the limitations of Claude Code?
436```436```
437 437
438> [!NOTE]438> [!NOTE]
439>439>
440> Claude proporciona respuestas basadas en documentación a estas preguntas. Para demostraciones prácticas, ejecute `/powerup` para lecciones interactivas con demostraciones animadas, o consulte las secciones de flujo de trabajo específicas anteriores.440> Claude proporciona respuestas basadas en la documentación para estas preguntas. Para demostraciones prácticas, ejecuta `/powerup` para ver lecciones interactivas con demos animadas, o consulta las secciones de flujos de trabajo específicos anteriores.
441 441
442> [!TIP]442> [!TIP]
443>443>
444> Consejos:444> Consejos:
445>445>
446> * Haga preguntas específicas para obtener respuestas detalladas446> * Haz preguntas específicas para obtener respuestas detalladas
447> * Claude puede explicar características complejas como integración MCP, configuraciones empresariales y flujos de trabajo avanzados447> * Claude puede explicar funcionalidades complejas como la integración con MCP, las configuraciones empresariales y los flujos de trabajo avanzados
448 448
449***449***
450 450