Claude Code es un agente de línea de comandos que se ejecuta en tu terminal, lee tu repositorio, edita archivos, ejecuta comandos y solicita confirmación antes de realizar acciones potencialmente destructivas. Está diseñado para asistirte 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 encaja 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 utilizan, 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 confirmaciones y solicitudes de extracción | 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 están ordenados aproximadamente por cuándo la mayoría de los desarrolladores los encuentran. Selecciona el que coincida con tu tarea actual.
Casos de uso
1. Reparar 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 solució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 solució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 más.
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 mediante el nombre del archivo o una 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é no está definido y por qué, y propone una solució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 Mayús+Tabulación 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 código carece de cobertura, o necesitas pruebas adicionales de casos extremos que coincidan con las convenciones de prueba existentes de tu proyecto.
Ejemplo de indicación:
> 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 código 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 señala y pregunta si deseas abordarlas.
7. Revisar una solicitud de extracción
Cuándo usar esto: Necesitas revisar o resumir una PR, particularmente en un área de la base de código que no conoces bien.
Requisito previo: GitHub CLI autenticado (ejecuta gh auth login una vez).
Ejemplo de indicación:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
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 la 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 indicación:
<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. La indicación 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 indicación:
<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 un comando de barra
Cuándo usar esto: Repites el mismo indicación 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 indicación:
> make me a /ship command 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 markdown en .claude/commands/. El comando /ship está disponible inmediatamente, sin necesidad de reinicio, y se comparte con cualquiera que clone el repositorio.
Referencia: Comandos de barra
Apéndice: Referencia rápida
# | Caso de uso | Indicación 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 | Mayús+Tab → modo de plan → describe la refactorización |
6 | Escribir pruebas |
|
7 | Revisar una PR |
|
8 | Incorporarse a un repositorio |
|
9 | Trabajar en un problema de principio a fin |
|
10 | Crear un comando de barra |
|
Apéndice: Directorio de recursos
Recurso | Enlace |
Guía de inicio rápido | |
Flujos de trabajo comunes | |
Permisos | |
Memoria y | |
Conectores MCP | |
Comandos de barra |
Para detalles sobre /init, referencias @, modos de permisos, habilidades, MCP y hooks, consulta code.claude.com/docs. Claude Code se actualiza frecuentemente—verifica detalles específicos de la versión en code.claude.com/docs antes de distribuir internamente.