Qué es un repositorio y por qué lo vas a necesitar

Un repositorio es una carpeta con memoria. Guarda tus archivos y, además, todas las versiones anteriores de esos archivos, con la fecha y una nota de qué cambiaste en cada una.

Eso es todo. No hace falta ninguna metáfora rara.

Lo que cambia de tener una carpeta normal a tener un repositorio es que puedes volver atrás. A ayer, a hace tres semanas, al momento exacto antes de romper aquello. Y puedes ver qué cambió entre una versión y otra, línea a línea.

¿Para qué sirve un repositorio?

Para cuatro cosas, y las cuatro sirven aunque no programes:

Para no perder trabajo. El "archivo_final_v2_bueno_ESTE.docx" existe porque a todos nos ha dado miedo pisar algo. Un repositorio elimina ese miedo entero: cada versión está guardada, así que puedes cambiar lo que quieras.

Para saber qué pasó. Cuando algo deja de funcionar, miras qué cambió desde la última vez que iba bien. La respuesta está ahí, con fecha y nombre.

Para trabajar con otros sin pisaros. Dos personas tocan el mismo proyecto y el sistema junta los cambios. Cuando choca, te avisa en vez de machacarte lo tuyo.

Para que una máquina despliegue por ti. Esta es la que más uso yo. Cuando subo un cambio al repositorio, un servidor se entera solo y publica la web. Yo escribo, subo, y dos minutos después está en producción.

Git y GitHub no son lo mismo

Esta confusión la tiene todo el mundo el primer mes y merece la pena aclararla de una.

Git es el programa que gestiona el historial. Vive en tu ordenador. Funciona sin internet. Es lo que hace la magia de guardar versiones.

GitHub es una web donde puedes tener copias de tus repositorios para compartirlos, trabajar en equipo o simplemente tenerlos a salvo fuera de tu disco. Hay alternativas (GitLab y unas cuantas más), pero GitHub es la que usa casi todo el mundo.

O sea: Git es el motor, GitHub es el aparcamiento. Puedes usar Git sin GitHub perfectamente. Lo que no puedes es usar GitHub sin Git, porque no habría nada que subir.

Las cuatro palabras que vas a oír

Commit. Una foto del estado de tus archivos en un momento, con una nota tuya explicando qué cambiaste. Es la unidad de memoria. Cada commit es un punto al que puedes volver.

Push. Mandar tus commits a la copia de internet. Hasta que no haces push, tus cambios solo están en tu ordenador.

Pull. Traerte lo que hay en internet a tu ordenador. Se usa cuando trabajas desde dos sitios o con más gente.

Rama. Una línea de trabajo paralela. Pruebas algo raro en una rama, y si sale mal la borras sin haber tocado lo que funcionaba. Si sale bien, la juntas con la principal.

Con esas cuatro se hace el noventa por ciento del trabajo diario. Todo lo demás son casos especiales que ya buscarás cuando te toquen.

Un caso real que no es de código

Yo tengo mis notas y mi documentación en un repositorio. No es código. Son archivos de texto: contexto de proyectos, borradores, decisiones, listas.

La ventaja no es técnica, es psicológica. Puedo reorganizar la estructura entera, borrar cosas, reescribir un archivo de arriba abajo, sin ningún miedo. Si me arrepiento, vuelvo. Ese "si me arrepiento, vuelvo" cambia cómo trabajas, porque dejas de proteger lo que ya está hecho.

La segunda ventaja es que está sincronizado. Escribo desde el ordenador, hago push, y desde otro sitio hago pull y tengo lo mismo. Sin depender de que una aplicación de notas decida seguir existiendo el año que viene.

Y la tercera: una herramienta como Claude Code trabaja directamente sobre esa carpeta. Lee mis archivos, escribe en ellos, y cada cambio queda registrado. Si hace algo que no me gusta, deshago. Trabajar con IA sobre archivos sin control de versiones es como conducir sin frenos: funciona hasta que hace falta parar.

Tres cosas que dejas de hacer cuando tienes uno

Duplicar carpetas por si acaso. Se acabó el "proyecto" y "proyecto copia" y "proyecto copia buena". Hay una carpeta y un historial.

Tener miedo a borrar. Cuando sabes que todo lo anterior está guardado, borras lo que sobra sin pensarlo dos veces. Los proyectos se quedan mucho más limpios por esta simple razón.

Preguntarte qué cambiaste ayer. La respuesta está escrita, con tu propia nota al lado. Y sí, tu yo del futuro te lo va a agradecer más de lo que crees ahora mismo.

Ninguna de las tres suena espectacular. Las tres son la diferencia entre un proyecto que sobrevive un año y uno que acaba en una carpeta que no te atreves a abrir.

Lo que un repositorio no es

No es una copia de seguridad completa. Guarda lo que tú le has dicho que guarde, cuando le has dicho que lo guarde. Si nunca haces commit, no hay historial. Y si el repositorio solo está en tu ordenador y se muere el disco, se fue todo. Por eso existe la copia en internet.

No es solo para código. Textos, documentación, configuraciones, listas. Todo lo que sea texto plano funciona de maravilla. Lo que no funciona bien son archivos pesados o binarios: vídeos, imágenes grandes, archivos de programas de diseño. Se puede, pero no es su terreno.

No es difícil. Es raro al principio porque los nombres son horribles y la documentación oficial está escrita para gente que ya sabe. Pero el modelo mental (guardar versiones con una nota) lo entiende cualquiera en cinco minutos.

No necesita terminal obligatoriamente. Hay aplicaciones con ventanas y botones que hacen todo esto sin escribir un comando. Y hay una vía aún más cómoda, que es pedírselo a la IA en español. Lo cuento entero en el flujo de trabajo con Git y Claude sin terminal.

Cómo montar el tuyo esta tarde

Crea una carpeta con algo dentro. Da igual qué: tus notas, un proyecto a medias, la lista de la compra.

Conviértela en repositorio. Si usas una herramienta con IA en la terminal, se lo puedes pedir tal cual: "convierte esta carpeta en un repositorio de Git y haz el primer commit". Lo hace y te explica qué ha hecho, que es la mejor forma de aprender esto que he visto.

Cambia algo. Haz otro commit con una nota que diga qué has cambiado. Y ahora pídele que te enseñe la diferencia entre las dos versiones. Ese momento, ver el antes y el después marcados en colores, es cuando se entiende para qué sirve todo esto.

Cuando quieras la copia en internet y el trabajo con otras personas, el paso siguiente está en usar GitHub con Claude Code sin saber Git. Y el terreno completo, con todo lo que se puede hacer sin ser programador, está en el hub de Claude Code para no programadores.

Una cosa más, y esta es la que me habría gustado que me dijeran a mí. Las notas de los commits escríbelas para tu yo de dentro de seis meses. "Cambios" no sirve de nada. "Arreglado el formulario que no enviaba en móvil" te va a salvar una tarde algún día.

Si quieres montar tu propia web de principio a fin con Claude Code, con el repositorio y el despliegue automático incluidos, ese camino completo lo tengo en un curso.

Ver Crea tu web con Claude Code