Cursos/Claude Code + IA Local/Cómo trabajar con tus proyectos

Cómo trabajar con tus proyectos

Este capítulo es la columna vertebral del libro. Cada aplicación que construyas vivirá en una carpeta de proyecto. Aquí aprendes a crearla, guardarla, cerrarla y volver a abrirla otro día sin perder nada.

Objetivos de aprendizaje
  • Organizar tus proyectos en carpetas ordenadas.
  • Arrancar y detener una aplicación web.
  • Reabrir un proyecto días después y continuar donde lo dejaste.
  • Usar Git como una “máquina del tiempo” para no perder trabajo.

Un sitio para todo: la carpeta de proyectos

Crea una carpeta donde vivirán todos tus experimentos. Solo hay que hacerlo una vez:

Terminal
cd ~            # ir a tu carpeta personal
mkdir proyectos-ia
cd proyectos-ia
En cristiano: el símbolo ~. La virgulilla ~ es un atajo que significa “mi carpeta personal de usuario”. Escribir cd ~ te lleva a casa desde cualquier sitio. Muy útil cuando te pierdes.

A partir de ahora, cada proyecto del libro será una subcarpeta aquí dentro. Así siempre sabes dónde está todo.

El ciclo de vida de un proyecto

Todos los proyectos siguen el mismo ritmo:

  1. Crear la carpeta y entrar: mkdir nombre y cd nombre.
  2. Construir con Claude Code (arrancándolo con claude).
  3. Instalar sus piezas una vez: npm install.
  4. Arrancar para probar: npm run dev.
  5. Detener cuando acabas: Ctrl + C en esa terminal.
En cristiano: Ctrl + C. Es la forma universal de decirle a un programa en la terminal “para ya”. No borra nada: solo apaga la aplicación que estaba corriendo. Puedes volver a arrancarla cuando quieras.

Reabrir un proyecto otro día

Esta es la parte que más tranquiliza: nada se pierde al apagar el ordenador. Para retomar un proyecto:

Terminal
cd ~/proyectos-ia/nombre-del-proyecto
npm run dev

Y ya está. El npm install no se repite (salvo que Claude Code añada piezas nuevas). Abre la dirección local que aparezca (por ejemplo http://localhost:3000) y seguirás donde lo dejaste.

Git: la máquina del tiempo de tus archivos

Git guarda “fotos” (llamadas commits) del estado de tu proyecto. Si algo se rompe, vuelves a una foto anterior. Es la mejor red de seguridad que existe.

En cristiano: commit. Un commit es una foto guardada de todos tus archivos en un momento dado, con una nota que explica qué cambió. Puedes tener cientos y saltar entre ellos. Es imposible perder trabajo si haces commits a menudo.

No hace falta que memorices comandos: pídeselo a Claude Code. Al empezar un proyecto:

Escribe esto a Claude Code
Inicializa git en este proyecto y haz un primer commit con todo el código. A partir de ahora, cada vez que terminemos algo importante, recuérdame hacer un commit.

Y cuando quieras guardar un avance:

Escribe esto a Claude Code
Haz un commit con los cambios de ahora y ponle un mensaje que describa lo que hemos hecho.
Idea clave. Regla práctica: haz un commit cada vez que algo funcione. Así, si el siguiente cambio lo estropea, siempre puedes volver a la última versión que iba bien.
Guardar y reabrir el proyecto.
Resumen para no perder nada nunca:
  • Tu trabajo es la carpeta del proyecto. No la borres.
  • Para cerrar: Ctrl + C y cierra la ventana.
  • Para volver: cd a la carpeta y npm run dev.
  • Para dormir tranquilo: haz commits de Git a menudo.
  • Extra: guarda de vez en cuando una copia de la carpeta en un disco externo o en la nube.

Reto para practicar

Crea la carpeta proyectos-ia, entra en ella, crea dentro una carpeta prueba, entra, y pídele a Claude Code que inicialice Git y haga el primer commit. Ya tienes tu método de trabajo montado para todo el libro.

← La terminal sin miedoEscribir buenos encargos →