Ler o código dos outros
Uma forma sistemática de entender qualquer base de código
⏱ Estim. ~8 min
01 · Ler
O segredo que surpreende a maioria dos iniciantes: engenheiros profissionais passam mais tempo lendo código do que escrevendo.
Ao entrar em um time, trocar de projeto, ou até voltar para o seu próprio código depois de algumas semanas, você precisa entender código que não escreveu (ou que não lembra ter escrito). Rolar a tela aleatoriamente esperando entender não funciona. Você precisa de um sistema.
A boa notícia? Ler código é uma habilidade, e como toda habilidade, fica mais fácil quanto mais você pratica. Vamos aprender um processo repetível que serve para qualquer base de código.
💡 Imagine assimLer uma base de código nova é como explorar uma cidade nova. Você não começa andando pelas ruas no aleatório. Primeiro olha o mapa (README), vê o que tem por perto (as dependências), encontra as avenidas principais (os pontos de entrada) e depois explora um bairro por vez (os módulos).
02 · Ler
Você acabou de receber o projeto de outra pessoa — uma Task API. Nunca viu esse código. Vamos aplicar o protocolo de leitura de código passo a passo no terminal.
03 · Prática de terminal
Protocolo de leitura de código, passo 1: leia o README. O README te diz o que o projeto faz, como instalar e como rodar. Sempre comece por aqui.
(Esta seção é interativa — ative o JavaScript para usar.)
04 · Prática de terminal
Passo 2: revise o package.json. As dependências te dizem quais tecnologias o projeto usa. Os scripts te dizem como rodar e testar.
(Esta seção é interativa — ative o JavaScript para usar.)
05 · Prática de terminal
Passo 3: encontre o ponto de entrada e olhe a estrutura. Você já sabe pelo package.json que app.js é o ponto de entrada. Primeiro olhe a estrutura de pastas e depois leia o arquivo principal.
(Esta seção é interativa — ative o JavaScript para usar.)
06 · Passo a passo
Protocolo de leitura de código — siga estes passos para qualquer base de código nova
1. Leia o README
O README.md te diz o que o projeto faz, como instalar e como rodar. Sempre comece por aqui. Se não tem README, isso também te diz alguma coisa — o projeto provavelmente tem documentação ruim.
2. Revise o package.json
As dependências te dizem quais tecnologias o projeto usa. Os scripts te dizem como rodar e testar. Olhe "dependencies" para ver as bibliotecas principais e "scripts" para comandos como "start", "test" e "build".
3. Olhe a estrutura de pastas
Como o código está organizado? Procure src/, public/, routes/, models/ — essas pistas revelam a arquitetura. Uma estrutura plana com tudo em uma pasta indica um projeto pequeno. Pastas aninhadas com nomes claros indicam uma boa organização.
4. Encontre o ponto de entrada
Normalmente é index.js, app.js ou main.js — onde o programa começa. O campo "main" ou o script "start" no package.json vai te apontar para ele.
5. Rastreie os imports
A partir do ponto de entrada, siga os require() ou os imports para entender a árvore de dependências. Cada import te leva para a próxima peça. Não tente entender tudo de uma vez — primeiro mapeie as conexões.
6. Peça ajuda ao Claude
Com o Claude Code: "me dá uma visão geral desse projeto" te dá um resumo de alto nível na hora. O Claude consegue ler todos os arquivos e te dar um mapa da base de código em segundos — algo que você poderia levar horas para fazer na mão.
07 · Preencher
Quando você explora um projeto novo, o primeiro arquivo que você lê é _____.
08 · Quiz
Ao explorar uma base de código nova, o que você deve ler primeiro?
- O maior arquivo do projeto
- O arquivo README.md
- Cada arquivo JavaScript de cima a baixo
- Os arquivos de teste
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.