Claude Code no onboarding: dá para substituir a primeira semana de um dev novo?

Fala aí, beleza? Dia dois do dev novo e ele está parado, esperando alguém responder no Slack onde fica o módulo de cobrança

É a cena mais clássica do onboarding: metade da primeira semana some em pergunta que não é difícil, é só desconhecida

A pergunta real deste post é essa: quanto dessa primeira semana o agente cobre de verdade, e em que ponto exato ele para de servir? 🙂

Já aviso: aqui não tem bloco de teste próprio nem "na minha experiência". O veredito abaixo vem da documentação oficial do Claude Code e de relatos publicados por empresas, e cada limite está marcado como limite

Claude Code x um sênior do time: quem responde melhor cada tipo de dúvida

O jeito honesto de julgar isso é separar por TIPO de pergunta, porque o recém chegado não faz uma pergunta só, ele faz seis tipos diferentes no mesmo dia

Se liga no padrão: as três últimas linhas não têm cobertura NENHUMA do agente

E isso é bom, viu? Significa que dá pra reservar o tempo do sênior exatamente pra elas

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Como o dev novo usa o Claude Code nos primeiros dias

Aqui é o passo a passo do que o recém chegado faz sozinho, sem chamar ninguém

1. Roda o /init no repositório principal, logo depois de clonar

/init

Ele analisa o projeto e gera um CLAUDE.md inicial com comandos de build, instruções de teste e convenções detectadas

O erro comum deste passo: gente que evita rodar por medo de destruir um CLAUDE.md que já existe. Não destrói. Se o arquivo já está lá, o /init sugere melhorias em vez de sobrescrever

2. Refina com o /memory, que é o fluxo recomendado na referência de comandos: primeiro /init pra gerar, depois /memory pra ajustar o que ficou torto

3. Se a base é grande, começa o trabalho por um subdiretório, não pela raiz

A orientação oficial pra codebase grande é essa mesmo, e o motivo é elegante: o Claude escaneia a árvore de diretórios pra cima, então o contexto global da raiz continua sendo carregado do mesmo jeito

Tu ganha foco sem perder o mapa 😀

4. Delega a exploração pesada pra um subagente, em vez de jogar tudo na conversa principal

use subagents to investigate como o fluxo de checkout chega no gateway de pagamento

A doc de boas práticas fala isso literalmente: pedir em linguagem natural pra usar subagentes faz a pesquisa rodar em contexto separado e mantém a conversa principal limpa

O Explore trabalha em três níveis de profundidade definidos na invocação: quick pra busca pontual, medium pra exploração equilibrada e very thorough pra análise abrangente

No primeiro dia, medium resolve quase tudo. Deixa o very thorough pro dia que tu precisa mapear um fluxo inteiro

5. Acompanha o gasto de contexto com o /context e limpa com o /compact

/context
/compact

O /context mostra em grade colorida o que está ocupando a janela, com aviso de capacidade. O /compact resume a conversa e libera espaço

O erro comum deste passo: achar que o /compact apaga tudo que o time configurou. Não apaga. Depois da compactação, o Claude relê o CLAUDE.md do disco e reinjeta na sessão

É mais ou menos assim que a Anthropic descreve o uso nos times próprios: novos contratados lendo documentação, identificando arquivos relevantes e pedindo pro agente explicar dependências de pipelines de dados

E o relato da incident.io sobre onboarding vai na mesma linha, com um detalhe que costuma passar batido: o recém chegado pediu pro Claude montar queries no Grafana a partir de descrições vagas

Ou seja, o agente serve como tradutor de "eu não sei nem o nome da coisa que eu quero" pra sintaxe da ferramenta

Depois que o mapa está na cabeça, a primeira tarefa real segue o fluxo do primeiro projeto como qualquer outra

O que o time precisa deixar pronto antes de o novato chegar

Agora o outro lado do balcão, que é onde a maioria dos times erra

O CLAUDE.md não é um arquivo só. Existem quatro níveis de escopo, do mais amplo pro mais específico:

• managed policy: nível de organização
• usuário: vale pra todos os projetos daquela pessoa
• projeto: compartilhado pelo time via controle de versão
• local: pessoal, entra no .gitignore

O que carrega conhecimento compartilhado é o de projeto, versionado junto com o código

Se o teu conhecimento de time está no CLAUDE.md local de alguém, ele não existe pro novato. Simples assim

E se eu quebrar em vários arquivos pra ficar organizado?

Organiza, sim. Mas tome cuidado com a expectativa errada: os arquivos importados via @caminho carregam no início da sessão, então eles NÃO reduzem o consumo de contexto

Separar é questão de arrumação, não de economia

Outra coisa que pesa mais do que parece: a documentação sobre bases grandes coloca o desempenho na conta do harness montado ao redor do modelo, não do modelo em si

E esse harness sai de cinco pontos de extensão: arquivos CLAUDE.md, hooks, skills, plugins e servidores MCP

É como receber alguém em casa sem lençol na cama e sem toalha no banheiro. A pessoa é boa, a casa é boa, mas a primeira noite vai ser esquisita 😛

GUIA DE RAMP-UP PRONTO? TEMOS!

O Claude Code ganhou um comando dedicado a isso: o /team-onboarding, adicionado na versão 2.1.101

Ele gera um guia de ramp-up a partir do uso local do Claude Code, listando principais slash commands, servidores MCP, distribuição por tipo de trabalho e contagem de sessões

Ressalva honesta: esse comando não aparece na página oficial de referência de comandos, e isso virou uma issue de documentação (#46384) no repositório

Então trata ele como recurso que existe nas notas de versão, e confere aí no teu ambiente antes de prometer pro time

A outra decisão que fica pro time é quantos assentos o time precisa, que é conversa separada dessa aqui

Veredito honesto: o que ele não responde e quanto custa colocar no time

O ganho real está bem delimitado: navegação de repositório e explicação de dependência

Achar arquivo, entender como um fluxo se encaixa, descobrir o comando que roda o teste, ler documentação que ninguém lê. Isso o agente faz o dia inteiro sem cansar e sem interromper ninguém

O que ele não responde continua sendo o que já era humano: histórico de decisão, acordo com cliente, política interna e quem revisa o quê

E tem uma ressalva técnica que quase ninguém comenta, mas que muda a leitura da resposta: os subagentes Explore e Plan pulam os arquivos CLAUDE.md e o git status da sessão principal, de propósito, pra manter a pesquisa rápida e barata

Traduzindo: a resposta que vem do subagente NÃO vem com as convenções do teu time embutidas

Ela é boa pra mapear, não pra decidir estilo de código. Já é motivo suficiente pra revisar o que ele devolve antes de virar regra

Agora a parte do custo, que é o que fecha a decisão

No custo de modelo, o Explore herda o modelo da conversa principal, limitado a Opus na Claude API, então ele nunca roda em modelo mais caro que o já escolhido pra sessão

No custo de acesso, o Claude Code está incluído em cada assento do plano Team, pra desenvolvedor ou não desenvolvedor. O assento Standard sai por US$ 20 por mês com desconto anual, ou US$ 25 por mês na cobrança mensal. O Premium sai por US$ 100 por mês no anual, ou US$ 125 na cobrança mensal

E se a pessoa já assina no individual, também está coberto: Pro e Max entregam o Claude na web, desktop e mobile mais o Claude Code no terminal em uma assinatura única

Pra datar o cenário: a versão recente publicada é a v2.1.235, com build de 19 de agosto de 2026

Então o veredito é esse: substituir a primeira semana inteira, não. Substituir a parte da primeira semana que era só "onde fica isso", sim

Conclusão

Se tu quer começar hoje, é curto o caminho

Roda o /init no repositório principal, refina com o /memory, versiona o CLAUDE.md de projeto e deixa ele viver junto com o código

Depois pega aquela tabela lá de cima e marca quais perguntas continuam sendo humanas. O tempo do sênior vai pra essas, e só pra essas

O resto o novato resolve sozinho, no terminal dele, sem fila no Slack 😀

Segue acompanhando o blog que nos próximos posts eu vou destrinchar mais fluxo de trabalho com o agente, que tem MUITA coisa boa pra mostrar…

até o próximo post!