Claude Code es un agente de codificación que lee tu repositorio, edita archivos, ejecuta comandos y solicita confirmación antes de realizar acciones potencialmente destructivas. Está integrado en Claude Desktop y también se ejecuta en tu terminal e IDEs compatibles. Está diseñado para asistir en cada etapa del ciclo de vida del desarrollo de software, desde explorar una base de código desconocida hasta enviar y mantener código en producción.
La tabla a continuación resume dónde se ajusta Claude Code en el ciclo de vida del desarrollo. El resto de este artículo recorre las diez tareas que los desarrolladores más frecuentemente lo usan, con un ejemplo de indicación y resultado esperado para cada una.
1. Descubrir | 2. Diseñar | 3. Construir | 4. Desplegar | 5. Soporte y escalabilidad |
Explorar base de código e historial | Planificar proyecto | Implementar código | Automatizar CI/CD | Depurar errores |
Buscar documentación | Desarrollar especificaciones técnicas | Escribir y ejecutar pruebas | Configurar entornos | Refactorización a gran escala |
Incorporar y aprender | Definir arquitectura | Crear commits y PRs | Gestionar despliegues | Monitorear uso y rendimiento |
Cómo usar esta guía
Cada caso de uso a continuación incluye cuándo usarlo, un ejemplo de indicación y el resultado esperado. No se requiere configuración para ninguno de ellos excepto §9 (integración de rastreador de problemas), que requiere una configuración de conector MCP única.
Los casos de uso se ordenan aproximadamente por cuándo la mayoría de los desarrolladores los encuentran primero. Selecciona el que coincida con tu tarea actual.
Casos de uso
1. Corregir una prueba fallida
Cuándo usar esto: Una prueba está fallando y la causa no es inmediatamente obvia. Úsalo para que Claude Code localice la causa raíz y proponga una corrección sin que necesites identificar el archivo fuente primero.
Ejemplo de indicación:
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
Resultado esperado: Claude Code lee el archivo de prueba, rastrea la ruta del código a través de los módulos bajo prueba, identifica la discrepancia y propone una edición. Después de que apruebes el cambio, vuelve a ejecutar el conjunto de pruebas para confirmar la corrección.
2. Entender código desconocido
Cuándo usar esto: Necesitas entender cómo funciona un módulo, función o subsistema antes de hacer cambios, por ejemplo, al heredar código o revisar un área desconocida.
Ejemplo de indicación:
> walk me through how the payment retry logic works
Resultado esperado: Claude Code localiza los archivos relevantes, lee la implementación y explica el flujo de control en lenguaje simple: puntos de entrada, ramas de decisión, casos extremos y cómo el código se conecta con el resto del sistema. Haz preguntas de seguimiento (por ejemplo, "dónde se establece X") para profundizar.
3. Encontrar dónde sucede algo
Cuándo usar esto: Sabes que existe un comportamiento en la base de código pero no puedes localizarlo por nombre de archivo o búsqueda de texto simple.
Ejemplo de indicación:
> where do we validate email addresses in this codebase? I want to add a new rule
Resultado esperado: Claude Code busca en el repositorio, abre archivos candidatos y devuelve rutas de archivo y números de línea con suficiente contexto circundante para identificar la coincidencia correcta. Si existen múltiples ubicaciones, indica cuál es la fuente de verdad.
4. Clasificar un error o seguimiento de pila
Cuándo usar esto: Tienes un error en tiempo de ejecución, seguimiento de pila o salida de registro y necesitas asignarlo al código responsable.
Ejemplo de indicación:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
Resultado esperado: Claude Code lee los archivos referenciados en el seguimiento, explica qué es indefinido y por qué, y propone una corrección. Para errores sin un seguimiento de pila limpio, pega cualquier salida de registro disponible y Claude Code reconstruirá el fallo desde el contexto.
5. Refactorizar con un plan
Cuándo usar esto: Un cambio abarca múltiples archivos y deseas revisar el alcance completo antes de que se realicen ediciones.
Requisito previo: Presiona Shift+Tab hasta que el indicador de modo muestre "plan."
Ejemplo de indicación:
> refactor the auth module to use the new session store instead of SessionCache
Resultado esperado: Claude Code analiza el código y produce un plan numerado que enumera cada archivo que modificará y el cambio en cada uno. Puedes aprobar el plan tal como está o modificarlo (por ejemplo, "no toques la ruta de cierre de sesión"). Ningún archivo se edita hasta que apruebes.
Referencia: Permisos
6. Escribir pruebas para código existente
Cuándo usar esto: Un archivo de origen carece de cobertura, o necesitas pruebas de casos extremos adicionales que coincidan con las convenciones de prueba existentes de tu proyecto.
Ejemplo de prompt:
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
Resultado esperado: Claude Code lee tanto el archivo de origen como el directorio de pruebas de referencia, genera un nuevo archivo de prueba en el estilo existente y lo ejecuta para confirmar que las pruebas pasan. Si quedan brechas de cobertura obvias, las marca y pregunta si deseas abordarlas.
7. Revisar una solicitud de extracción
Cuándo usar esto: Necesitas revisar o resumir un PR, particularmente en un área del código que no conoces bien.
Requisito previo: GitHub CLI autenticado (ejecuta gh auth login una vez).
Ejemplo de prompt:
> /pr https://github.com/example/api/pull/4471
> is the error handling solid?
Resultado esperado: Claude Code obtiene el diff, comentarios de revisión y estado de CI, luego lee los archivos modificados en su contexto completo del repositorio. Puede producir una revisión enfocada, redactar comentarios de revisión, verificar una preocupación específica o resumir el PR.
8. Incorporarse a un nuevo repositorio
Cuándo usar esto: Estás trabajando en un repositorio por primera vez y necesitas una descripción general estructurada de su arquitectura, comandos de compilación y convenciones.
Ejemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
Resultado esperado: /init escanea el proyecto y escribe un archivo CLAUDE.md que resume comandos de compilación, arquitectura y convenciones. El prompt de tour de seguimiento produce un recorrido guiado de la estructura del proyecto. El contexto del proyecto permanece cargado durante el resto de la sesión.
Referencia: Memoria y CLAUDE.md
9. Trabajar un problema de principio a fin
Cuándo usar esto: Deseas leer un ticket, implementar la corrección y validarla en una sola conversación sin cambiar de herramientas.
Requisito previo: Rastreador de problemas conectado a través de MCP (configuración .mcp.json única).
Ejemplo de prompt:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
Resultado esperado: Claude Code consulta el rastreador de problemas, lee el ticket, localiza el código relevante, propone una corrección y ejecuta las pruebas. La sesión termina con un diff revisable y el contexto necesario para cerrar el ticket.
Referencia: MCP
10. Convertir una tarea recurrente en una Habilidad
Cuándo usar esto: Repites el mismo prompt de varios pasos regularmente (verificaciones previas a la confirmación, resúmenes de standup, descripciones de PR, notas de lanzamiento) y deseas hacerlo reutilizable para todo el equipo.
Ejemplo de prompt:
> make me a /ship skill that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
Resultado esperado: Claude Code escribe un archivo SKILL.md en .claude/skills/ship/. El comando /ship está disponible inmediatamente, sin necesidad de reinicio, y se comparte con cualquiera que clone el repositorio. (La ruta heredada .claude/commands/ aún es compatible, pero las habilidades son la forma recomendada.)
Referencia: Habilidades
Apéndice: Referencia rápida
# | Caso de uso | Prompt de ejemplo |
1 | Reparar una prueba fallida |
|
2 | Entender código desconocido |
|
3 | Encontrar dónde sucede algo |
|
4 | Clasificar un error | Pega el seguimiento de pila, luego pregunta: |
5 | Refactorizar con un plan | Shift+Tab → modo de plan → describe la refactorización |
6 | Escribir pruebas |
|
7 | Revisar un PR |
|
8 | Incorporarse a un repositorio |
|
9 | Trabajar en un problema de principio a fin |
|
10 | Crear una habilidad |
|
Apéndice: Directorio de recursos
Recurso | Enlace |
Inicio rápido | |
Flujos de trabajo comunes | |
Permisos | |
Memoria y | |
Conectores MCP | |
Habilidades | |
Comandos integrados |
Para detalles sobre /init, referencias con @, modos de permisos, habilidades, MCP y hooks, consulta code.claude.com/docs. Claude Code se actualiza frecuentemente—verifica detalles específicos de versión en code.claude.com/docs antes de distribuir internamente.
