Mapa de codebase existente com Claude Code: ler, alterar e verificar em 45 minutos

Por que este fluxo importa

Claude Code costuma gerar mais valor em uma base existente do que em um projeto vazio, mas a primeira sessão também é mais arriscada. Se você pedir uma reescrita ampla, o diff fica difícil de revisar. O primeiro passo deve ser um mapa: entradas, áreas seguras, áreas arriscadas e uma pequena mudança verificável hoje.

Para mais contexto, leia também o guia inicial de Claude Code, harness engineering, o guia de permissões.

O fluxo prático

Use um ciclo de 45 minutos: status, mapa de arquivos, uma alteração limitada, um comando de prova e uma nota de handoff. Em site de conteúdo, inclua PDF grátis, Gumroad e CTA de consultoria.

Kit mínimo para copiar e colar

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

Três casos reais de uso

• Melhorar apenas o CTA final de um artigo e confirmar o caminho do PDF grátis.
• Adicionar comandos seguros, áreas proibidas e definição de pronto no CLAUDE.md.
• Criar um link interno de artigo popular para produtos e verificar h1 mais CTA na URL pública.

Falhas comuns e como evitar

A falha comum é começar com ‘refatore o projeto inteiro’. Claude Code pode gerar mudanças plausíveis, mas o patch fica grande demais. Comece com um arquivo, uma rota e um comando de prova.

Caminho para PDF grátis, Gumroad e consultoria

Use o cheatsheet gratuito enquanto o fluxo for novo. Vá para o Setup Guide quando precisar de CLAUDE.md, hooks, permissões e regras repetíveis. Use consultoria quando adoção ou receita exigirem decisão.

• Cheatsheet gratuito de Claude Code
• Templates de prompts para Claude Code
• Guia de configuração de Claude Code
• Produtos
• Consultoria

Comece pelo cheatsheet gratuito, compre o guia no Gumroad quando o fluxo virar rotina e marque consultoria quando rollout ou conversão forem caros demais para adivinhar.

O que verifiquei neste artigo

Separei comandos PowerShell, fragmento de CLAUDE.md e checklist de CTA para que o fluxo seja copiável em um repositório real.