learnaiwithrafa
ClaudeSetup

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

A maioria dos engenheiros empaca no nível 3, tratando o Claude Code como um terminal mais esperto. Aqui está a escada, do chat aos times de agentes — ache o seu degrau e dê o passo que te sobe um.

3 min de leitura2 fontes
  • #claude-code
  • #setup
  • #agents

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ê um passo de configuração pra subir. Se ainda não instalou: curl -fsSL https://claude.ai/install.sh | bash, depois cd seu-projeto && claude.

A escada

  • 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ê fica vigiando cada passo.
  • Nível 2 — Contexto. 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.
  • Nível 3 — Ferramentas. O Claude lê seus arquivos, cria novos, roda comandos, pesquisa — sozinho, na sua máquina. Ele faz em vez de sugerir. É onde a maioria acampa.
  • Nível 4 — MCP. O nível 3 deu mãos na sua máquina; o MCP dá as chaves de todo o resto. claude mcp add --transport http <nome> <url>, ou commite um .mcp.json no projeto. Comece pela ferramenta que você usa todo dia.
  • Nível 5 — Skills. 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. A regra que o próprio time da Anthropic usa: se você já fez mais de uma vez hoje, vira skill.
  • Nível 6 — Subagentes. Um .claude/agents/<nome>.md define um trabalhador especializado, com contexto e permissões próprias — um revisor só-leitura é o melhor primeiro. Adicione "use subagentes" numa tarefa grande e o Claude divide o trabalho em paralelo.
  • 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". Quase ninguém está aqui ainda — e você não precisa disso pra maior parte do trabalho.

O hábito que se acumula

Toda vez que o Claude erra algo, termine a sua correção com: "atualize o CLAUDE.md pra você não cometer esse erro de novo". 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. Se você está no nível 1 ou 2, escreva um CLAUDE.md de uma página pro seu repositório mais ativo. 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