Os 7 níveis do Claude Code — ache o seu, suba um

Eu lidero engenharia numa startup americana, e a diferença entre quem tira alavancagem de verdade do Claude Code e quem não tira não é talento — é em que degrau a pessoa travou. A maioria empaca no nível 3. Aqui está a escada. Ache onde você está e dê o único passo que te sobe um degrau. Cada um é um arquivo ou um comando que dá pra colar hoje.

Se ainda não instalou: curl -fsSL https://claude.ai/install.sh | bash, depois cd seu-projeto && claude.

Nível 1 — Prompting

Você digita, ele responde. Claude como uma busca mais esperta. Rodar claude "escreva testes pro módulo de auth e conserte até passar" ainda é nível 1 se você vigia cada tecla. O passo pra cima é parar de alimentar contexto na mão.

Nível 2 — Contexto (CLAUDE.md)

Um CLAUDE.md na raiz do projeto é lido no começo de toda sessão, pra você parar de reexplicar a sua stack. São os dez minutos de maior retorno da escada inteira. Cole isto e edite cada colchete:

# CLAUDE.md — o arquivo que o Claude lê primeiro, toda sessão

## Stack
[Linguagens, framework, gerenciador de pacotes e o comando exato pra rodar os testes.]

## Convenções
[Nomenclatura, tratamento de erro, os padrões que você usa de verdade — não os ideais.]

## Limites (perguntar antes de mexer)
[Migrations, autenticação, cobrança, qualquer coisa em produção. Cite os arquivos ou pastas.]

## Comandos
- build: [comando exato]
- lint: [comando exato]
- test: [comando exato]

## Lições
[Deixe esta seção aqui. Toda vez que o Claude errar, acrescente uma linha: "Não faça X, faça Y."]

Nível 3 — Ferramentas

Na sua máquina, o Claude abre arquivos, cria novos, executa comandos e faz as próprias buscas na web — sem copia-e-cola. Ele faz em vez de sugerir. É onde a maioria acampa. Pra subir, dê alcance além do repositório.

Nível 4 — MCP

O nível 3 deu mãos na sua máquina; o MCP dá as chaves de todo o resto — sua caixa de entrada, seu quadro de tarefas, seu banco de dados. Adicione um servidor pra ferramenta que você usa todo dia:

# servidor remoto por HTTP
claude mcp add --transport http linear https://mcp.linear.app/mcp
# servidor local via um pacote
claude mcp add sqlite -- npx -y @modelcontextprotocol/server-sqlite ./dev.db

Commite um .mcp.json no projeto pra compartilhar a configuração com o time. Comece com exatamente um — a ferramenta pra qual você trocaria de aba.

Nível 5 — Skills (SKILL.md)

Um .claude/skills/<nome>/SKILL.md é um manual que o Claude carrega sozinho quando a tarefa combina. Só a descrição é lida na inicialização, então não custa nada até disparar. O time da Anthropic segue uma regra aqui: repetiu uma tarefa duas vezes num dia, ela vira skill. Salve isto em .claude/skills/pr-description/SKILL.md:

---
name: pr-description
description: Escreve a descrição do PR no nosso formato. Use quando eu abrir um PR ou pedir um resumo de PR.
---

Produza a descrição do PR. Siga isto à risca.

## Entradas
Leia o diff da branch e as mensagens de commit. Se houver um ticket linkado, pegue o título dele.

## Formato
1. **O quê e por quê** — duas frases, linguagem simples, sem enrolação.
2. **Mudanças** — bullets, cada um começando com um verbo.
3. **Risco e reversão** — o que pode quebrar e como reverter.
4. **Como testei** — os comandos ou passos exatos.

## Régua
Antes de terminar: um revisor precisaria fazer alguma pergunta óbvia? Se sim, responda na descrição primeiro.

Nível 6 — Subagentes

Um .claude/agents/<nome>.md define um trabalhador especializado, com contexto e permissões próprias. O melhor primeiro é um revisor só-leitura — ele vê tudo e não muda nada. Salve isto em .claude/agents/reviewer.md e diga "manda o reviewer conferir antes da gente subir":

---
name: reviewer
description: Segunda opinião independente antes de subir. Só-leitura.
tools: Read, Grep, Glob
---

Você é um revisor sênior exigente. Leia qualquer coisa; não edite nada; não rode nada.

Pro trabalho recebido:
1. Confira contra os objetivos do CLAUDE.md.
2. Cace as três falhas de sempre: contraria a especificação, pulou algo em silêncio, ou nos deixaria mal na frente de um usuário.
3. Reporte como BLOCKER / SHOULD-FIX / NIT — uma linha cada, com arquivo e linha.
4. Termine com um veredito: sobe, ou conserta os blockers primeiro.

Sem elogio, sem enrolação.

Acrescente "use subagentes" em qualquer tarefa grande e o Claude divide o trabalho em paralelo sozinho.

Nível 7 — Times de agentes

Várias sessões completas do Claude coordenando trabalho compartilhado, cada uma num worktree isolado. É onde "usar IA" vira "gerenciar um time de IA". Rode trabalho em paralelo sem colisão:

claude --worktree feature-auth   # cópia isolada; forma curta: -w
claude --worktree "#1234"        # branch direto de um PR

Mantenha uma sessão cujo único trabalho é revisar a saída das outras. Você não precisa desse nível pra maior parte do trabalho — os níveis 4 a 6 já te colocam na frente de quase todo mundo.

O hábito que se acumula

Toda vez que o Claude erra algo, termine a correção com: "anote isso no CLAUDE.md pra nunca mais acontecer". Duas semanas disso e ele para de repetir os seus erros específicos. As habilidades que importam no nível 7 — especificação clara, higiene de contexto, hábito de verificar — são as que você constrói subindo os degraus de baixo.

Faça isso hoje

Ache o seu degrau com honestidade e dê o único passo dele. No nível 1 ou 2, cole o CLAUDE.md acima no seu repositório mais ativo e preencha. Subir um nível por semana te coloca na frente de quase todo engenheiro com quem você trabalha já no mês que vem.

Fontes

• Claude Code documentation
• Claude Code power-user tips