Leer el código de otras personas
Una forma sistemática de entender cualquier base de código
⏱ Estim. ~8 min
01 · Leer
El secreto que sorprende a la mayoría de principiantes: los ingenieros profesionales pasan más tiempo leyendo código que escribiéndolo.
Al entrar a un equipo, cambiar de proyecto, o incluso volver a tu propio código después de unas semanas, tienes que entender código que no escribiste (o que no recuerdas haber escrito). Desplazarse al azar esperando entenderlo no sirve. Necesitas un sistema.
¿La buena noticia? Leer código es una habilidad, y como toda habilidad, se vuelve más fácil mientras más la practicas. Vamos a aprender un proceso repetible que sirve para cualquier base de código.
💡 Imagínalo asíLeer una base de código nueva es como explorar una ciudad nueva. No empiezas caminando al azar por las calles. Primero ves el mapa (README), miras qué hay cerca (las dependencias), encuentras las avenidas principales (los puntos de entrada) y luego exploras un barrio a la vez (los módulos).
02 · Leer
Acabas de recibir el proyecto de alguien más — una Task API. Nunca has visto este código. Vamos a aplicar el protocolo de lectura de código paso a paso en la terminal.
03 · Práctica de terminal
Protocolo de lectura de código, paso 1: lee el README. El README te dice qué hace el proyecto, cómo instalarlo y cómo ejecutarlo. Siempre empieza aquí.
(Esta sección es interactiva — activa JavaScript para usarla.)
04 · Práctica de terminal
Paso 2: revisa package.json. Las dependencias te dicen qué tecnologías usa. Los scripts te dicen cómo ejecutar y probar.
(Esta sección es interactiva — activa JavaScript para usarla.)
05 · Práctica de terminal
Paso 3: encuentra el punto de entrada y revisa la estructura. Ya sabes por package.json que app.js es el punto de entrada. Primero mira la estructura de carpetas y luego lee el archivo principal.
(Esta sección es interactiva — activa JavaScript para usarla.)
06 · Paso a paso
Protocolo de lectura de código — sigue estos pasos para cualquier base de código nueva
1. Lee el README
El README.md te dice qué hace el proyecto, cómo instalarlo y cómo ejecutarlo. Siempre empieza aquí. Si no hay README, eso también te dice algo — el proyecto probablemente tiene mala documentación.
2. Revisa package.json
Las dependencias te dicen qué tecnologías usa. Los scripts te dicen cómo ejecutar y probar. Mira "dependencies" para ver las librerías principales y "scripts" para comandos como "start", "test" y "build".
3. Revisa la estructura de carpetas
¿Cómo está organizado el código? Busca src/, public/, routes/, models/ — estas pistas revelan la arquitectura. Una estructura plana con todo en una carpeta indica un proyecto pequeño. Carpetas anidadas con nombres claros indican una buena organización.
4. Encuentra el punto de entrada
Normalmente es index.js, app.js o main.js — donde empieza el programa. El campo "main" o el script "start" en package.json te apuntará a él.
5. Sigue los imports
Desde el punto de entrada, sigue los require() o los imports para entender el árbol de dependencias. Cada import te lleva a la siguiente pieza. No intentes entenderlo todo de golpe — primero mapea las conexiones.
6. Pídele ayuda a Claude
Con Claude Code: "dame un panorama general de este proyecto" te da un resumen de alto nivel al instante. Claude puede leer todos los archivos y darte un mapa de la base de código en segundos — algo que podría tomarte horas hacer a mano.
07 · Completar
Cuando exploras un proyecto nuevo, el primer archivo que lees es _____.
08 · Quiz
Al explorar una base de código nueva, ¿qué deberías leer primero?
- El archivo más grande del proyecto
- El archivo README.md
- Cada archivo JavaScript de arriba a abajo
- Los archivos de pruebas
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.