Saltar al contenido principal
Esta página recopila recetas cortas para el desarrollo cotidiano. Para orientación de nivel superior sobre indicaciones y gestión de contexto, consulte Mejores prácticas. Esta página cubre:

​
Recetas de prompts

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

​
Comprender bases de código nuevas

Para configurar Claude Code en un monorepo o en una base de código grande, consulta Monorepos y repositorios grandes.

​
Obtener una visión general rápida de la base de código

Supongamos que acabas de unirte a un proyecto nuevo y necesitas comprender su estructura rápidamente.
1

Navega al directorio raíz del proyecto

Reemplaza /path/to/project con la ruta de tu proyecto.
2

Inicia Claude Code

3

Pide una visión general de alto nivel

4

Profundiza en componentes específicos

Consejos:
  • Comienza con preguntas amplias y luego enfócate en áreas específicas
  • Pregunta sobre las convenciones de código y los patrones usados en el proyecto
  • Solicita un glosario de términos específicos del proyecto

​
Encontrar código relevante

Supongamos que necesitas localizar código relacionado con una funcionalidad específica.
1

Pide a Claude que encuentre los archivos relevantes

2

Obtén contexto sobre cómo interactúan los componentes

3

Comprende el flujo de ejecución

Consejos:
  • Sé específico sobre lo que buscas
  • Usa el lenguaje del dominio del proyecto
  • Instala un plugin de inteligencia de código para tu lenguaje para darle a Claude navegación precisa de “ir a la definición” y “buscar referencias”

​
Corregir errores de forma eficiente

Supongamos que te encontraste con un mensaje de error y necesitas encontrar y corregir su origen.
1

Comparte el error con Claude

2

Pide recomendaciones para corregirlo

3

Aplica la corrección

Consejos:
  • Dile a Claude el comando para reproducir el problema y obtener un stack trace
  • Menciona los pasos para reproducir el error
  • Indícale a Claude si el error es intermitente o constante

​
Refactorizar código

Supongamos que necesitas actualizar código antiguo para usar patrones y prácticas modernas. Para 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 en el blog.
1

Identifica código heredado para refactorizar

2

Obtén recomendaciones de refactorización

3

Aplica los cambios de forma segura

4

Verifica la refactorización

Consejos:
  • Pide a Claude que explique los beneficios del enfoque moderno
  • Solicita que los cambios mantengan la compatibilidad con versiones anteriores cuando sea necesario
  • Refactoriza en incrementos pequeños y comprobables

​
Trabajar con pruebas

Supongamos que necesitas agregar pruebas para código sin cobertura.
1

Identifica código sin pruebas

2

Genera la estructura base de las pruebas

3

Agrega casos de prueba significativos

4

Ejecuta y verifica las pruebas

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

​
Crear pull requests

Puedes crear pull requests pidiéndoselo a Claude directamente (“create a pr for my changes”), o guiar a Claude paso a paso:
1

Resume tus cambios

2

Genera un pull request

3

Revisa y refina

Para 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. 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.
Revisa el PR generado por Claude antes de enviarlo y pide a Claude que destaque posibles riesgos o consideraciones.

​
Gestionar la documentación

Supongamos que necesitas agregar o actualizar la documentación de tu código.
1

Identifica código sin documentar

2

Genera la documentación

3

Revisa y mejora

4

Verifica la documentación

Consejos:
  • Especifica el estilo de documentación que quieres (JSDoc, docstrings, etc.)
  • Pide ejemplos en la documentación
  • Solicita documentación para API públicas, interfaces y lógica compleja

​
Trabajar en notas y carpetas que no son de código

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

​
Trabajar con imágenes

Supongamos que necesitas trabajar con imágenes en tu base de código y quieres la ayuda de Claude para analizar su contenido.
1

Agrega una imagen a la conversación

Puedes usar cualquiera de estos métodos:
  1. Arrastra y suelta una imagen en la ventana de Claude Code
  2. Copia una imagen y pégala en la CLI con Ctrl+V, o con Alt+V en Windows y WSL
  3. Proporciona a Claude la ruta de una imagen, por ejemplo “Analyze this image: /path/to/your/image.png”
2

Pide a Claude que analice la imagen

3

Usa imágenes como contexto

4

Obtén sugerencias de código a partir de contenido visual

Consejos:
  • Usa imágenes cuando las descripciones de texto serían poco claras o engorrosas
  • Incluye capturas de pantalla de errores, diseños de UI o diagramas para dar un mejor contexto
  • Puedes trabajar con varias imágenes en una conversación
  • El análisis de imágenes funciona con diagramas, capturas de pantalla, mockups y más
  • 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

​
Hacer referencia a archivos y directorios

Usa @ para incluir rápidamente archivos o directorios sin esperar a que Claude los lea.
1

Haz referencia a un solo archivo

Esto incluye el contenido del archivo en la conversación cuando cabe en el límite de tokens de la herramienta Read, de 25,000 tokens de forma predeterminada. Un archivo de texto de más de 256KB no se incluye.
2

Haz referencia a un directorio

3

Haz referencia a recursos MCP

Esto obtiene datos de los servidores MCP conectados usando el formato @server:resource. Consulta Recursos MCP para más detalles.
Consejos:
  • Las rutas de archivo pueden ser relativas o absolutas
  • 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
  • Las referencias a archivos con @ agregan al contexto el CLAUDE.md del directorio del archivo y de los directorios superiores
  • Las referencias a directorios muestran listados de archivos, no su contenido
  • Puedes hacer referencia a varios archivos en un solo mensaje (por ejemplo, “@file1.js and @file2.js”)
Para evitar que las referencias con @ incluyan el contenido de archivos y los listados de directorios, establece CLAUDE_CODE_DISABLE_FILE_MENTIONS en 1 en tu shell o en el bloque env de la configuración de usuario o de la configuración administrada. 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. Tus 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:
  • Bloquear rutas específicas: agrega una regla de denegación Read para ellas. Claude Code no incluye un archivo que coincida con la regla.
  • 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.

​
Ejecutar Claude de forma programada

Supongamos 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. Elige una opción de programación según dónde quieres que se ejecute la tarea:
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.”

​
Preguntar a Claude sobre sus capacidades

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

​
Preguntas de ejemplo

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.
Consejos:
  • Haz preguntas específicas para obtener respuestas detalladas
  • Claude puede explicar funcionalidades complejas como la integración con MCP, las configuraciones empresariales y los flujos de trabajo avanzados

​
Reanudar conversaciones anteriores

Cuando una tarea abarca múltiples sesiones, continúe donde lo dejó en lugar de volver a explicar el contexto. Claude Code guarda cada conversación localmente.
Esto reanuda la sesión más reciente en el directorio actual; si aún no existe una, imprime No conversation found to continue y sale. Use claude --resume para elegir de una lista, o /resume desde dentro de una sesión en ejecución. Consulte Gestionar sesiones para nombrar, ramificar y la referencia completa del selector.

​
Ejecutar sesiones paralelas con worktrees

Trabaje en una característica en una terminal mientras Claude corrige un error en otra, sin que los cambios choquen. Cada git worktree es un checkout separado en su propia rama, creado a partir de un commit existente, por lo que el repositorio necesita al menos un commit primero.
Ejecuta el mismo comando con un nombre diferente en una segunda terminal para iniciar una sesión paralela aislada. Consulta Worktrees para limpieza, .worktreeinclude y soporte de VCS que no sea git. Para monitorear sesiones paralelas desde una pantalla en lugar de terminales separadas, consulta agentes de fondo.

​
Planificar antes de editar

Para cambios que desea revisar antes de que toquen el disco, cambie al modo de plan. Claude lee archivos y propone un plan pero no realiza ediciones hasta que apruebe. La barra de estado muestra ⏸ plan mode on mientras el modo de plan está activo.
También puede presionar Shift+Tab durante una sesión hasta que la barra de estado muestre ⏸ plan mode on. Consulte Plan mode para el flujo de aprobación y editar el plan en su editor de texto.

​
Delegar investigación a subagentes

Explorar una base de código grande llena su contexto con lecturas de archivos. Delegue la exploración para que solo los hallazgos regresen.
El subagente lee archivos en su propia ventana de contexto e informa un resumen. Consulte Subagentes para definir agentes personalizados con sus propias herramientas e indicaciones.

​
Canalizar Claude en scripts

Ejecute Claude de forma no interactiva para CI, hooks de pre-commit o procesamiento por lotes. Stdin y stdout funcionan como cualquier herramienta Unix.
Consulte Modo no interactivo para formatos de salida, banderas de permiso y patrones de distribución.

​
Próximos pasos

Mejores prácticas

Patrones para obtener lo máximo de Claude Code

Gestionar sesiones

Reanudar, nombrar y ramificar conversaciones

Worktrees

Ejecutar sesiones paralelas aisladas

Extender Claude Code

Agregar skills, hooks, MCP, subagentes y plugins