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

cd /path/to/project 

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

2. Inicia Claude Code

claude 

3. Pide una visión general de alto nivel

give me an overview of this codebase

4. Profundiza en componentes específicos

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

[!TIP]

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

find the files that handle user authentication

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

how do these authentication files work together?

3. Comprende el flujo de ejecución

trace the login process from front-end to database

[!TIP]

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

I'm seeing an error when I run npm test

2. Pide recomendaciones para corregirlo

suggest a few ways to fix the @ts-ignore in user.ts

3. Aplica la corrección

update user.ts to add the null check you suggested

[!TIP]

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

find deprecated API usage in our codebase

2. Obtén recomendaciones de refactorización

suggest how to refactor utils.js to use modern JavaScript features

3. Aplica los cambios de forma segura

refactor utils.js to use ES2024 features while maintaining the same behavior

4. Verifica la refactorización

run tests for the refactored code

[!TIP]

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

find functions in NotificationsService.swift that are not covered by tests

2. Genera la estructura base de las pruebas

add tests for the notification service

3. Agrega casos de prueba significativos

add test cases for edge conditions in the notification service

4. Ejecuta y verifica las pruebas

run the new tests and fix any failures

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

summarize the changes I've made to the authentication module

2. Genera un pull request

create a pr

3. Revisa y refina

enhance the PR description with more context about the security improvements

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.

[!TIP]

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

find functions without proper JSDoc comments in the auth module

2. Genera la documentación

add JSDoc comments to the undocumented functions in auth.js

3. Revisa y mejora

improve the generated documentation with more context and examples

4. Verifica la documentación

check if the documentation follows our project standards

[!TIP]

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

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

3. Usa imágenes como contexto

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

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

Generate CSS to match this design mockup

What HTML structure would recreate this component?

[!TIP]

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

Explain the logic in @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, 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

What's the structure of @src/components?

3. Haz referencia a recursos MCP

Show me the data from @github:repos/owner/repo/issues

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

[!TIP]

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:

[!TIP]

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

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

[!NOTE]

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.

[!TIP]

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.

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

[card] Mejores prácticas

Patrones para obtener lo máximo de Claude Code

[card] Gestionar sesiones

Reanudar, nombrar y ramificar conversaciones

[card] Worktrees

Ejecutar sesiones paralelas aisladas

[card] Extender Claude Code

Agregar skills, hooks, MCP, subagentes y plugins