Tutorial de Claude Code 4: ¿Cuáles son los casos de uso de Claude Code?

Casos de uso típicos

Divido los casos de uso en cuatro categorías, ordenadas de mayor a menor frecuencia.

Primera categoría: Entender código

Esta es probablemente la más utilizada. Cuando tomas un proyecto de otra persona, miras un módulo antiguo o abres un repositorio sin documentación, pregúntale directamente.

Cómo hacerlo:

claude "¿De qué trata este proyecto? ¿Dónde está la entrada?" — leerá package.json, la estructura de directorios, archivos clave y dará un resumen.
Abre una función, pídele que explique la lógica y dibuje el flujo (con texto).
Pídele que rastree la ruta completa de una solicitud API desde el frontend hasta la base de datos.

Aquí, lo que hace es esencialmente el "trabajo sucio de leer código". No necesitas hacer grep durante mucho tiempo y luego armar el rompecabezas en tu cabeza. Él organiza la ruta y tú tomas las decisiones.

El equivalente de esta categoría es: buscar manualmente en el código, tomar notas y dibujar diagramas de llamadas.

Segunda categoría: Escribir y modificar código

Esta es la más comentada, pero no es la más usada. Los escenarios de escritura de código suelen ser:

Generar nueva funcionalidad: "Agrega una interfaz para cambiar el correo electrónico en el módulo user, valida el formato del correo y escribe pruebas unitarias."
Refactorización entre archivos: "Reemplaza todos los moment() en estos tres archivos por dayjs(), sin cambiar otra lógica."
Migración y actualización: "Convierte este componente de Vue 2 a la sintaxis de Composition API de Vue 3."

El código generado no siempre es correcto de entrada, pero puede hacer cambios en varios archivos a la vez, y puedes revisar diff por archivo, aceptando o rechazando cada uno.

El equivalente de esta categoría es: escribir código repetitivo manualmente, buscar y reemplazar referencias entre archivos manualmente.

Tercera categoría: Depuración y corrección

Cuando aparece un error, el flujo habitual es: ver el mensaje de error, localizar el archivo, adivinar la causa, probar una modificación, y si no funciona, volver a mirar. Claude Code puede recibir toda la traza de error y localizarla junto con el código del proyecto.

Uso típico:

Pásale la salida de una prueba fallida, leerá el código relacionado, dará una solución, y luego volverá a ejecutar la prueba para ver si pasa.
Ante un error de CI, pega el registro, pídele que lo arregle, y luego ejecuta git diff para confirmar los cambios.

Aquí actúa más como un "investigador de primera ronda". Tú dedicas tiempo a pensar, pero él se encarga de buscar archivos, comparar diferencias y ejecutar comandos de validación.

El equivalente de esta categoría es: ejecutar pruebas repetidamente, leer registros de errores, comparar diferencias de código manualmente.

Cuarta categoría: Automatización miscelánea

Esta categoría es la menos llamativa, pero sumando tareas ahorra la mayor cantidad de tiempo.

Ejemplos:

Escribir mensajes de Git commit: claude "Escribe un mensaje de commit en formato Conventional Commits basado en el diff actual"
Generar descripciones de PR: Pídele que compare la rama actual con main y genere un resumen de los cambios y las pruebas realizadas.
Escribir notas de versión: Que Claude Code lea el historial de commits de la última semana y genere un CHANGELOG.
Resolver problemas de entorno: "Al instalar esta dependencia da error, ayúdame a revisar la salida del terminal y encontrar la causa."

El denominador común de estas tareas: no son complejas, pero son tediosas. Hacerlas tú mismo implica cambiar de ventana y escribir mucho. Delegarlas a él lleva segundos.

El equivalente de esta categoría es: editar texto manualmente, escribir documentación formal, buscar problemas de configuración del entorno.

Un "mapa"

Si colocamos estas cuatro categorías en el flujo de trabajo diario, el mapa sería algo así:

Obtener un proyecto desconocido
    │
    ▼
[Entender código] ─── Averiguar estructura, entrada, lógica clave
    │
    ▼
Empezar a escribir nueva funcionalidad o modificar módulo
    │
    ▼
[Escribir/modificar código] ─── Generar implementación, refactorizar entre archivos
    │
    ▼
Ejecutar pruebas, aparece un error
    │
    ▼
[Depurar y corregir] ─── Analizar error, localizar, arreglar, volver a ejecutar
    │
    ▼
Preparar para commit
    │
    ▼
[Automatización miscelánea] ─── Escribir commit, descripción de PR, notas de versión
    │
    ▼
Commit, completado

No es necesario usarlo en las cuatro áreas. Algunos equipos solo lo usan para entender código, otros solo para escribir pruebas y enviar PR. Comienza por el escenario que más te incomode.

Dos criterios útiles

Si no estás seguro de si una tarea debería delegarse a Claude Code, pregúntate:

1. ¿Es esta tarea más "mecánica" que "creativa"?

Cambiar cien referencias, formatear salidas, generar código boilerplate: hacerlo tú mismo consume tiempo acumulativamente, pero ya tienes la idea. Es adecuado para delegarlo.

2. ¿Es alto el "costo de verificación" de esta tarea?

Si una modificación requiere saltar entre archivos, ejecutar pruebas y mirar registros para confirmarla, entonces probar por ensayo y error es lento. Claude Code puede completar el ciclo "cambiar-ejecutar-verificar-cambiar de nuevo" por sí mismo, y tú te ahorrarás mucho trabajo.