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 indicaciones

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

​
Comprender nuevas bases de código

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

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

Supongamos que acaba de unirse a un nuevo proyecto y necesita comprender su estructura rápidamente.
1

Navegue al directorio raíz del proyecto

2

Inicie Claude Code

3

Solicite una descripción general de alto nivel

4

Profundice en componentes específicos

Consejos:
  • Comience con preguntas amplias, luego reduzca a áreas específicas
  • Pregunte sobre convenciones de codificación y patrones utilizados en el proyecto
  • Solicite un glosario de términos específicos del proyecto

​
Encontrar código relevante

Supongamos que necesita localizar código relacionado con una característica o funcionalidad específica.
1

Pida a Claude que encuentre archivos relevantes

2

Obtenga contexto sobre cómo interactúan los componentes

3

Comprenda el flujo de ejecución

Consejos:
  • Sea específico sobre lo que está buscando
  • Utilice el lenguaje del dominio del proyecto
  • Instale un plugin de inteligencia de código para su lenguaje para dar a Claude una navegación precisa de “ir a definición” y “buscar referencias”

​
Corregir errores de manera eficiente

Supongamos que ha encontrado un mensaje de error y necesita encontrar y corregir su origen.
1

Comparta el error con Claude

2

Solicite recomendaciones de corrección

3

Aplique la corrección

Consejos:
  • Dígale a Claude el comando para reproducir el problema y obtener un seguimiento de pila
  • Mencione cualquier paso para reproducir el error
  • Hágale saber a Claude si el error es intermitente o consistente

​
Refactorizar código

Supongamos que necesita actualizar código antiguo para utilizar patrones y prácticas modernas.
1

Identifique código heredado para refactorización

2

Obtenga recomendaciones de refactorización

3

Aplique los cambios de manera segura

4

Verifique la refactorización

Consejos:
  • Pida a Claude que explique los beneficios del enfoque moderno
  • Solicite que los cambios mantengan la compatibilidad hacia atrás cuando sea necesario
  • Realice la refactorización en incrementos pequeños y comprobables

​
Trabajar con pruebas

Supongamos que necesita agregar pruebas para código no cubierto.
1

Identifique código no probado

2

Genere andamiaje de prueba

3

Agregue casos de prueba significativos

4

Ejecute y verifique las pruebas

Claude 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. Para una cobertura integral, pida a Claude que identifique casos extremos que podría haber perdido. Claude puede analizar sus rutas de código y sugerir pruebas para condiciones de error, valores límite e entradas inesperadas que son fáciles de pasar por alto.

​
Crear solicitudes de extracción

Puede 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:
1

Resuma sus cambios

2

Genere una solicitud de extracción

3

Revise y refine

Cuando crea una PR usando gh pr create, la sesión se vincula automáticamente a esa PR. Para regresar a ella más tarde, ejecute claude --from-pr 123, reemplazando 123 con el número de PR, o pegue la URL de la PR en el selector /resume.
Revise la PR generada por Claude antes de enviarla y pida a Claude que destaque los riesgos potenciales o consideraciones.

​
Manejar documentación

Supongamos que necesita agregar o actualizar documentación para su código.
1

Identifique código sin documentar

2

Genere documentación

3

Revise y mejore

4

Verifique la documentación

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

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

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

​
Trabajar con imágenes

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

Agregue una imagen a la conversación

Puede usar cualquiera de estos métodos:
  1. Arrastre y suelte una imagen en la ventana de Claude Code
  2. Copie una imagen y péguela en la CLI con Ctrl+V. En macOS, Cmd+V también funciona en iTerm2.
  3. Proporcione una ruta de imagen a Claude. Por ejemplo, “Analiza esta imagen: /path/to/your/image.png”
2

Pida a Claude que analice la imagen

3

Usar imágenes para contexto

4

Obtenga sugerencias de código del contenido visual

Consejos:
  • Use imágenes cuando las descripciones de texto serían poco claras o engorrosas
  • Incluya capturas de pantalla de errores, diseños de interfaz de usuario o diagramas para mejor contexto
  • Puede trabajar con múltiples 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]), Cmd+Click (Mac) o Ctrl+Click (Windows/Linux) el enlace para abrir la imagen en su visor predeterminado

​
Archivos y directorios de referencia

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

Haga referencia a un archivo único

Esto incluye el contenido completo del archivo en la conversación.
2

Haga referencia a un directorio

Esto proporciona un listado de directorio con información de archivo.
3

Haga referencia a recursos MCP

Esto obtiene datos de servidores MCP conectados usando el formato @server:resource. Consulte recursos MCP para más detalles.
Consejos:
  • Las rutas de archivo pueden ser relativas o absolutas
  • Las referencias de archivo @ agregan CLAUDE.md en el directorio del archivo y directorios principales al contexto
  • Las referencias de directorio muestran listados de archivos, no contenidos
  • Puede hacer referencia a múltiples archivos en un solo mensaje (por ejemplo, “@file1.js y @file2.js”)

​
Ejecutar Claude en un horario

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

​
Pregunte a Claude sobre sus capacidades

Claude tiene acceso integrado a su documentación y puede responder preguntas sobre sus propias características y limitaciones.

​
Preguntas de ejemplo

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.
Consejos:
  • Claude siempre tiene acceso a la documentación más reciente de Claude Code, independientemente de la versión que esté utilizando
  • Haga preguntas específicas para obtener respuestas detalladas
  • Claude puede explicar características complejas como integración MCP, configuraciones empresariales y 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 worktree es un checkout separado en su propia rama.
Ejecute el mismo comando con un nombre diferente en una segunda terminal para iniciar una sesión paralela aislada. Consulte Worktrees para limpieza, .worktreeinclude y soporte de VCS que no sea git. Para monitorear sesiones paralelas desde una pantalla en lugar de terminales separadas, consulte 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.
También puede presionar Shift+Tab durante una sesión para cambiar al modo de plan. 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