📁 Anatomía de un proyecto

¿Eres nuevo aquí? Carpeta (también llamada "directorio") es el espacio en tu computadora donde se guardan archivos juntos: el mismo ícono amarillo en el que ya haces clic en el Explorador de archivos o en el Finder. Una carpeta de proyecto es una carpeta común dedicada a un solo proyecto: no tiene nada de mágico, es solo organización. El agente solo ve lo que está dentro de la carpeta que abriste con claude; mezclar varios proyectos en una sola carpeta confunde su contexto, porque empieza a leer archivos de distintas automatizaciones como si fueran parte de la misma conversación.

Piensa en la carpeta del proyecto como un archivador físico: cada cajón guarda los papeles de un solo tema. Si pones contratos, recetas y fotos en el mismo cajón, hasta encontrar lo que necesitas se vuelve un trabajo — lo mismo pasa cuando el agente intenta entender un proyecto desordenado. Una automatización por carpeta es la regla que evita ese tipo de confusión desde el primer día.

¿Eres nuevo aquí? Uno repositorio (o “repo”) es una carpeta de proyecto con un historial de versiones guardado por una herramienta llamada git. Cada cambio relevante queda registrado, con fecha y descripción, como un «guardar como» automático que nunca borra la versión anterior.

No es obligatorio tener un repositorio desde el primer proyecto: muchas automatizaciones sencillas del comienzo del curso se ejecutan en una carpeta común, sin usar git. Pero, en cuanto el proyecto adquiere valor (por ejemplo, una automatización que usas todas las semanas), conviene convertir la carpeta en un repositorio: si un archivo se rompe o un comando borra algo por error, puedes volver a una versión anterior guardada en el historial.

Al trabajar en un proyecto, siempre aparecen algunos nombres de carpetas y archivos; reconocerlos evita confusiones. ¿Eres nuevo aquí? Archivo es cualquier documento individual dentro de una carpeta (un texto, una imagen o un código); las carpetas pueden contener otras carpetas, formando un «árbol». Un nombre que empieza con punto, como .claude o .git, es una carpeta oculta — el sistema operativo la oculta por defecto porque es un área de configuración, no de contenido cotidiano, pero siempre está ahí.

Leyenda: la carpeta raíz del proyecto guarda el CLAUDE.md, la carpeta `.claude/` con skills y las carpetas de código — cada una con un papel fijo que se repite en todos los proyectos del curso.

Esta estructura se repite en prácticamente todos los proyectos que vas a construir en el curso — por eso vale la pena memorizar los cuatro nombres. El CLAUDE.md es el único archivo que el agente siempre lee al comienzo de cada sesión (el módulo 0.4 lo explica a fondo); la carpeta .claude/ es donde están las «skills»: procesos enseñados al agente, tema de la Ruta 3; las carpetas de código varían de un proyecto a otro, pero el nombre src/ (de «source», «fuente» en inglés) es la más común.

Los archivos del proyecto están todo el tiempo en tu computadora. Solo el texto de la conversación —y fragmentos de archivos que el agente necesita leer para responder— viaja hasta el modelo de IA en la nube para generar cada respuesta. Nada queda «publicado» ni visible para otras personas solo porque hayas conversado sobre ello.

Leyenda: los archivos nunca salen de tu computadora por sí solos: solo el texto de la conversación y los fragmentos de archivo necesarios para responder viajan hasta el modelo con cada pregunta.

Ver por dentro: cuando pides leer un archivo, Claude Code envía el contenido de ese archivo (o la parte pertinente) junto con tu mensaje para que lo procese el modelo de IA: así es como «ve» lo que hay en la carpeta. Esto tiene un costo: cuanto más texto se envía, más caro es el uso (si usas un plan de pago por uso) y más tarda en llegar la respuesta. Por eso, los proyectos organizados, sin archivos enormes o irrelevantes en la carpeta, hacen que el agente sea más rápido y barato de usar.

Es el ritual que repetirás con cada automatización nueva del curso: crear la carpeta, entrar en ella y abrir el agente. ¿Eres nuevo aquí? Terminal es la ventana de texto donde escribes comandos en lugar de hacer clic en íconos; en Windows suele llamarse «Símbolo del sistema» o «PowerShell»; en Mac y Linux, «Terminal». Comando es la instrucción que escribes y confirmas con Enter; la computadora la ejecuta en ese momento.

Objetivo: tener un proyecto nuevo, vacío, listo para recibir el CLAUDE.md del módulo 0.4. Cómo verificar: en ejecución ls (o dir) ves la carpeta nueva vacía y Claude Code se abre sin errores dentro de ella.

Observa que mkdir e cd necesitan el nombre exacto de la carpeta — si escribes un nombre diferente en los dos comandos, el cd va a fallar. No hay problema si lo olvidas o te equivocas: el terminal te avisa con un mensaje cuando el comando no funciona y basta con volver a escribirlo.

Dos errores aparecen siempre al principio, y ambos tienen una solución sencilla.

Además de estos dos, el primer día aparecen algunos tropiezos concretos para quienes nunca han usado la terminal — ninguno es grave, pero pueden bloquear a quien no sabe qué está pasando.