Claude Code: proyectos reales para aprender construyendo
Cinco proyectos en orden creciente para aprender Claude Code: qué habilidad practica cada uno, cuánto tiempo esperar y las trampas comunes al dirigir un agente.
Claude Code se aprende construyendo. La documentación resuelve dudas puntuales y los comandos se memorizan con uso, pero la habilidad central, dirigir a un agente sobre un proyecto de verdad, solo aparece cuando el proyecto es tuyo, te importa el resultado y hay consecuencias en cada decisión.
Esta guía propone cinco proyectos reales en orden creciente de dificultad, cada uno diseñado para practicar una habilidad concreta del trabajo con Claude Code: dirección del agente, verificación con pruebas, git y revisión, APIs externas y rescate de código heredado. Si todavía estás montando tu entorno, la guía de instalación y primer proyecto paso a paso te deja listo en una sesión.
Cómo elegir un buen proyecto para aprender
Un proyecto de aprendizaje cumple cuatro condiciones. Es personal: resuelve algo que te pasa a ti, porque eso mantiene la motivación durante semanas. Es acotado: cabe en tardes, porque los proyectos eternos mueren antes de enseñar. Usa datos reales: archivos, fechas, gastos o textos tuyos, porque el trabajo real expone casos que los ejemplos de juguete esconden. Y tiene resultado verificable: sabes con claridad cuándo funciona, porque esa verificación es justo lo que le vas a pedir al agente.
Con esos cuatro filtros, casi cualquier idea de tu lista de pendientes sirve. Si tienes varias candidatas, gana la que resolverías esta misma semana aunque fuera a mano: esa urgencia real es el mejor filtro de todos. Las cinco que siguen están ordenadas para que cada una agregue una sola habilidad nueva sobre la anterior.
Proyecto 1: organizador de archivos por línea de comandos
El primer proyecto es una herramienta pequeña que ordena una carpeta caótica: descargas, capturas, facturas. El programa clasifica archivos por tipo y fecha, renombra con un formato consistente y reporta lo que hizo. Un detalle que lo vuelve real: ejecútalo primero en modo lectura, donde solo propone el plan de renombrado, y actívalo de verdad cuando el plan se vea correcto. Ese interruptor de simulación es una práctica que luego repetirás en herramientas más serias. Es un clásico por una razón: termina en una o dos tardes y toca lectura de archivos, decisiones de diseño simples y un resultado visible al instante.
Con Claude Code practicas aquí el ciclo básico: describir el objetivo, revisar el plan que propone, aceptar o corregir, y pedir ajustes en lenguaje natural. También es el momento de crear tu primer CLAUDE.md con dos o tres reglas del proyecto y comprobar cómo el agente las respeta en cada sesión siguiente, ajustándolo cuando descubras una preferencia nueva.
Proyecto 2: rastreador personal con datos propios
El segundo proyecto registra algo de tu vida con datos reales: gastos, hábitos, horas de sueño, entrenamientos. Guarda entradas en un archivo simple, calcula totales y tendencias, y muestra un resumen semanal. El formato del archivo importa poco al principio; elegir uno legible a mano te permitirá revisar los datos con cualquier editor y entender cada cálculo que el agente haga sobre ellos. La diferencia con un ejercicio de tutorial es que los datos importan: cuando el cálculo cuadra con tu realidad, la confianza en la herramienta se vuelve concreta.
Aquí la práctica nueva es la verificación. Pides al agente que escriba pruebas para los cálculos, que agregue casos límite y que corra todo antes de cada cambio. Aprendes a exigir evidencia en lugar de aceptar respuestas plausibles, el hábito que más valor tiene en el trabajo con agentes.
Proyecto 3: tu sitio personal estático
El tercer proyecto es público: un sitio estático con tu nombre, tus proyectos y una forma de contacto. Generadores estáticos hay muchos; cualquiera sirve. Pide al agente que te dé dos opciones con las ventajas de cada una para tu caso y elige en cinco minutos: la lección está en el sitio publicado, y cada hora de comparación extra la roba de ese objetivo. Lo importante es que el sitio quede en línea, con dominio propio si tienes, y que cada cambio pase por git.
La habilidad nueva es el trabajo con historial y ramas: pides cambios en una rama, revisas el diff completo con calma, mezclas cuando apruebas y aprendes a revertir con limpieza cuando algo se ve mejor en papel que en pantalla. Claude Code maneja git con soltura, y aprender a revisar sus diffs es la base de toda revisión de código posterior. El repertorio de comandos y atajos para el trabajo diario empieza a volverse memoria muscular en este proyecto.
Proyecto 4: una automatización con una API externa
El cuarto proyecto conecta con el mundo: un pequeño servicio que consulta una API pública, clima, tipo de cambio, cartelera, y te manda un resumen cuando lo pides o en horario fijo. Aquí aparecen credenciales, formatos de respuesta, reintentos y horarios, toda la maquinaria del software que habla con otros sistemas. Empieza por consultar la API a mano una sola vez y guarda la respuesta real en un archivo: ese ejemplo concreto se vuelve la referencia que el agente usa para diseñar el código y las pruebas, y evita ciclos enteros de suposiciones.
La práctica nueva es dirigir al agente con documentación ajena: pegarle la referencia de la API, pedirle que diseñe el cliente, corregir sus supuestos con respuestas reales del servicio. Aprendes también a delimitar lo que el agente puede tocar: las claves viven fuera del código y del alcance del agente, en variables de entorno.
Proyecto 5: rescatar un proyecto viejo tuyo
El proyecto final es el más formativo: toma un proyecto tuyo abandonado, de esos que funcionan pero dan pudor al abrirlos, y modernízalo con Claude Code paso a paso. Actualiza dependencias, agrega pruebas donde faltan, renombra lo confuso, escribe el README que merecía. Trabajar sobre código existente con contexto propio es exactamente el trabajo profesional real, y enseña más que cinco proyectos desde cero.
Aquí se juntan todas las habilidades anteriores: el agente explora primero y explica qué entendió, tú corriges su mapa del proyecto, y cada cambio llega con pruebas y diff revisable. El momento más valioso llega cuando el agente encuentra algo que tú recordabas distinto: comparar su lectura del código con tu memoria del proyecto enseña a mantener el CLAUDE.md actualizado, que es la memoria compartida de todo trabajo futuro. La meta de fondo es confiar en el proceso: exploración, plan, cambio acotado, verificación, historial limpio.
Cuánto tiempo esperar por proyecto
Con sesiones de una o dos horas, el organizador toma una o dos tardes, el rastreador unos tres días, el sitio personal un fin de semana completo, la automatización otra semana de tardes y el rescate dos o tres semanas según el tamaño del proyecto viejo. Son estimaciones para alguien que empieza; la velocidad sube con cada proyecto porque la habilidad que crece es la tuya al dirigir, y esa se transfiere entera al siguiente.
Si algún proyecto se estira más, la causa casi siempre está en el alcance: recorta una función, publica la versión chica y deja la ampliación para después. Terminar proyectos chicos enseña más que arrastrar proyectos grandes.
Qué practica cada proyecto
La escalera completa queda así: el organizador enseña el ciclo básico de dirección y el CLAUDE.md. El rastreador enseña pruebas y verificación exigida. El sitio personal enseña git, ramas y revisión de diffs. La automatización enseña APIs, secretos y documentación externa. El rescate enseña exploración de código heredado y confianza en el proceso.
Cada proyecto deja además un activo útil: algo que usarás cada semana y que podrás mostrar. Vale la pena cerrar cada uno con una bitácora breve de tres líneas: qué le pediste al agente, qué tuviste que corregir y qué harás distinto en el siguiente. Esa doble recompensa, aprendizaje más herramienta, es lo que sostiene la constancia mejor que cualquier curso.
Trampas comunes al aprender con un agente
La primera trampa es aceptar todo lo que el agente propone por inercia. El agente produce rápido y con seguridad, y la tentación de aprobar todo crece con la velocidad; la defensa es la regla personal de leer cada diff completo hasta que la confianza esté ganada proyecto a proyecto. La segunda es pedir demasiado en una sola instrucción: las peticiones grandes producen cambios grandes y difíciles de revisar, mientras que las peticiones acotadas mantienen cada paso verificable.
La tercera es abandonar el proyecto al primer tropiezo, justo cuando el aprendizaje iba a empezar. Un comportamiento inesperado del código es precisamente el momento de mayor aprendizaje: pide al agente que explique qué pasó, que lo reproduzca con una prueba y que lo corrija. Ese ciclo completo, sorpresa, explicación, prueba, corrección, es la lección que ningún tutorial transmite.
Cierre
Cinco proyectos, cinco habilidades, unas cuantas semanas de tardes. Al final tienes un portafolio funcional, un flujo de trabajo probado con tu propio código y el criterio para dirigir agentes en proyectos más grandes. El orden importa menos que la constancia: elige el primero esta semana y termínalo antes de abrir el siguiente. Y guarda cada proyecto en su propio repositorio con su CLAUDE.md, porque juntos forman el registro medible de tu progreso dirigiendo agentes.
Fuentes
¿Te fue útil este artículo?