Flujos de trabajo comunes

Guías paso a paso para explorar bases de código, corregir errores, refactorizar, probar y otras tareas cotidianas con Claude Code.

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 para explorar código, corregir errores, refactorizar, probar, PRs y documentación
• Reanudar conversaciones anteriores para que una tarea pueda abarcar múltiples sesiones
• Ejecutar sesiones paralelas con worktrees para que las ediciones concurrentes no choquen
• Planificar antes de editar para revisar cambios antes de que toquen el disco
• Delegar investigación a subagentes para mantener su contexto principal limpio
• Canalizar Claude en scripts para CI y procesamiento por lotes

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

cd /path/to/project 

Reemplace /path/to/project con la ruta a su proyecto.

2. Inicie Claude Code

claude 

3. Solicite una descripción general de alto nivel

dame una descripción general de esta base de código

4. Profundice en componentes específicos

explica los patrones de arquitectura principales utilizados aquí

¿cuáles son los modelos de datos clave?

¿cómo se maneja la autenticación?

[!TIP]

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

encuentra los archivos que manejan la autenticación de usuarios

2. Obtenga contexto sobre cómo interactúan los componentes

¿cómo funcionan juntos estos archivos de autenticación?

3. Comprenda el flujo de ejecución

rastrea el proceso de inicio de sesión desde el front-end hasta la base de datos

[!TIP]

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

estoy viendo un error cuando ejecuto npm test

2. Solicite recomendaciones de corrección

sugiere algunas formas de corregir el @ts-ignore en user.ts

3. Aplique la corrección

actualiza user.ts para agregar la verificación nula que sugeriste

[!TIP]

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.

Para 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 en el blog.

1. Identifique código heredado para refactorización

encuentra el uso de API obsoleta en nuestra base de código

2. Obtenga recomendaciones de refactorización

sugiere cómo refactorizar utils.js para usar características modernas de JavaScript

3. Aplique los cambios de manera segura

refactoriza utils.js para usar características de ES2024 manteniendo el mismo comportamiento

4. Verifique la refactorización

ejecuta pruebas para el código refactorizado

[!TIP]

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

encuentra funciones en NotificationsService.swift que no están cubiertas por pruebas

2. Genere andamiaje de prueba

agrega pruebas para el servicio de notificaciones

3. Agregue casos de prueba significativos

agrega casos de prueba para condiciones de borde en el servicio de notificaciones

4. Ejecute y verifique las pruebas

ejecuta las nuevas pruebas y corrige cualquier fallo

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

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

resume los cambios que he hecho en el módulo de autenticación

2. Genere una solicitud de extracción

crea un pr

3. Revise y refine

mejora la descripción del PR con más contexto sobre las mejoras de seguridad

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

[!TIP]

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

encuentra funciones sin comentarios JSDoc adecuados en el módulo de autenticación

2. Genere documentación

agrega comentarios JSDoc a las funciones sin documentar en auth.js

3. Revise y mejore

mejora la documentación generada con más contexto y ejemplos

4. Verifique la documentación

verifica si la documentación sigue nuestros estándares de proyecto

[!TIP]

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, o con Alt+V en Windows y WSL
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

¿Qué muestra esta imagen?

Describe los elementos de la interfaz de usuario en esta captura de pantalla

¿Hay algún elemento problemático en este diagrama?

3. Usar imágenes para contexto

Aquí hay una captura de pantalla del error. ¿Qué lo está causando?

Este es nuestro esquema de base de datos actual. ¿Cómo deberíamos modificarlo para la nueva característica?

4. Obtenga sugerencias de código del contenido visual

Genera CSS que coincida con este mockup de diseño

¿Qué estructura HTML recrearía este componente?

[!TIP]

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

Explica la lógica en @src/utils/auth.js

Esto incluye el contenido del archivo en la conversación cuando cabe en el límite de tokens de la herramienta Read, que es 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

¿Cuál es la estructura de @src/components?

3. Haga referencia a recursos MCP

Muéstrame los datos de @github:repos/owner/repo/issues

Esto obtiene datos de servidores MCP conectados usando el formato @server:resource. Consulte recursos MCP para más detalles.

[!TIP]

Consejos:

• Las rutas de archivo pueden ser relativas o absolutas
• 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 mensaje
• 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")

Para evitar que las referencias con @ incluyan el contenido de los 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 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.

Tus 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:

• Bloquear rutas específicas: agrega una regla de denegación de 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 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.

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:

[!TIP]

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

Preguntas de ejemplo

¿puede Claude Code crear pull requests?

¿cómo maneja Claude Code los permisos?

¿qué skills están disponibles?

¿cómo uso MCP con Claude Code?

¿cómo configuro Claude Code para Amazon Bedrock?

¿cuáles son las limitaciones de Claude Code?

[!NOTE]

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.

[!TIP]

Consejos:

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

claude --continue

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.

claude --worktree feature-auth

Ejecute el mismo comando con un nombre diferente en una segunda terminal para iniciar una sesión paralela aislada. En un repositorio sin commits, el comando falla con Failed to resolve base branch "HEAD": git rev-parse failed. 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. La barra de estado muestra ⏸ plan mode on mientras el modo de plan está activo.

claude --permission-mode plan

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.

usa un subagente para investigar cómo nuestro sistema de autenticación maneja la actualización de tokens

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.

git log --oneline -20 | claude -p "summarize these recent commits"

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