Dominando o Claude Code: O Guia Definitivo Passo a Passo (com Exemplos Práticos)

Olá de novo, Fazedores de Código! Aqui é o Emerson Delatorre. Se no nosso papo anterior nós arranhamos a superfície dessa ferramenta incrível, hoje nós vamos colocar a mão na massa de verdade. A pedido de vocês, mergulhei fundo na palestra do Boris (o criador do Claude Code na Anthropic) e trouxe um manual prático, cheio de detalhes, exemplos reais e o passo a passo exato que ele demonstrou no palco.

Preparem seus terminais, porque vamos transformar a forma como vocês interagem com o código.

---

Passo 1: O Setup Otimizado (Preparando a Casa)

Antes de sair codificando, você precisa ajustar as ferramentas do seu CLI (Command Line Interface, aquela "tela preta" do terminal). O Claude Code possui comandos curtos (que começam com /) para facilitar sua vida.

Como fazer:
Logo após instalar a ferramenta (com npm install -g @anthropic-ai/claude-code), Boris recomenda rodar os seguintes comandos:

• /terminal-setup: Ativa o Shift+Enter para pular linhas no terminal sem enviar o comando antes da hora (o que poupa o uso de barras invertidas irritantes).
• /theme: Permite escolher o modo claro, escuro ou até temas para daltônicos.
• /install-github-app: Instala um aplicativo que permite que você marque @claude diretamente nas issues (tarefas) ou Pull Requests do seu repositório.
• /allowed-tools: Personaliza quais ferramentas precisam da sua aprovação manual para rodar (ótimo para evitar que ele te pergunte toda hora se pode ler um arquivo inofensivo).
• Dica Ninja para MacOS: Vá em Configurações > Acessibilidade > Ditado, configure um atalho rápido e simplesmente fale seus prompts em vez de digitar.

---

Passo 2: O Ponto de Partida – Perguntas e Respostas (Q&A)

A forma mais fácil de começar e extrair valor imediato (sem precisar configurar nada) é fazer perguntas sobre o seu projeto (Codebase Q&A). Seus dados ficam na sua máquina e você ganha um guia turístico do seu próprio código.

Como fazer:
Use o símbolo @ para mencionar arquivos ou pastas específicas para que o Claude as leia.

Exemplos Práticos demonstrados:

• "Como o @RoutingController.py é usado?"
• "Por que o método recoverFromException recebe tantos argumentos? Olhe o histórico do git para responder." (Sim, ele lê o histórico, o blame e os PRs antigos!)
• "O que eu enviei para produção na semana passada?" (Excelente para se atualizar numa segunda-feira de manhã).

---

Passo 3: Encadeamento e Direcionamento (O "Think Hard")

Uma vez confortável, você não vai apenas perguntar, vai mandar fazer. O segredo aqui é especificar o seu fluxo de trabalho, encadeando múltiplas ações em uma única frase.

Exemplos Práticos:

• "Proponha algumas correções para a issue #8792, **em seguida* implemente a que eu escolher."* (Isso cria um ponto de controle seguro para você revisar).
• "Identifique casos extremos (edge cases) não cobertos em @app/tests/SignupTest.ts, **em seguida* atualize os testes para cobri-los. Pense bastante (Think hard)."* (O "think hard" diz ao Claude para gastar mais tempo raciocinando antes de agir).
• "Faça o commit, o push e abra o PR." (Ele encadeia operações completas do Git de uma vez só).

Você também pode ensinar ferramentas da sua empresa a ele. Se você tem um script interno no terminal chamado barley, basta dizer: "Use a CLI barley para checar logs de erro; use -h para descobrir como usá-la." Ele vai ler o manual de ajuda e executar a tarefa.

---

Passo 4: Como Montar o CLAUDE.md Corretamente

Programadores se amarram em padrões, e o CLAUDE.md é a forma de garantir que a IA não quebre os padrões da sua equipe. É aqui que você dá contexto persistente: coisas que o Claude deve lembrar em todas as sessões.

A Estrutura de Pastas (Hierarquia):

• /CLAUDE.md: Regras globais da sua empresa.
• ~/.claude/CLAUDE.md: Suas regras pessoais para todos os seus projetos.
• CLAUDE.md (na raiz do projeto): Regras do time, que você deve salvar no Git.
• CLAUDE.local.md: Suas anotações pessoais do projeto (que o Git ignora).

Como preencher o arquivo:
Escreva como se estivesse orientando um desenvolvedor júnior que acabou de entrar na equipe.

• "Sempre use pnpm, nunca use npm."
• "Rode os testes usando make test, não use pytest."
• "Nosso estilo de código usa indentação de dois espaços."
• "Quando você fizer um commit, use o padrão de conventional commits (mensagens com prefixos como fix:, feat:, etc.)."

Dica Prática: Você não precisa abrir o arquivo para editar. Apenas digite o atalho # no terminal, escreva a regra, e o Claude perguntará em qual arquivo ele deve salvar isso.

---

Passo 5: Multi-Agentes (O Exército de Claudes em Paralelo)

Aqui é onde a cabeça explode. Segundo Boris, rodar o Claude em paralelo muda completamente o volume de entregas que você consegue fazer. O modelo mental correto é: Cada aba do terminal rodando o Claude é um engenheiro diferente trabalhando para você.

Por que pedir para um engenheiro fazer cinco coisas em série (uma depois da outra) se você tem cinco engenheiros disponíveis? Crie um agente para consertar os testes, outro para escrever a documentação e um terceiro para refatorar o código base. Eles não vão brigar ou atrapalhar o trabalho do outro.

Como usar Multi-Agentes na prática (4 Métodos):

1. Múltiplas abas / Múltiplos clones: Você simplesmente clona o mesmo repositório em pastas diferentes e abre uma aba do terminal para cada um.
2. Git Worktrees: Esta é uma funcionalidade poderosa do Git.
   • (Sem jargões): O "Git Worktree" permite que você tenha várias "filiais" (branches) do mesmo projeto abertas em pastas diferentes ao mesmo tempo, sem precisar clonar tudo de novo. O núcleo (.git) é compartilhado, mas os arquivos visíveis são diferentes. Você bota um Claude trabalhando em uma pasta (branch A) e outro em outra pasta (branch B).
3. SSH + tmux:
   • (Sem jargões): SSH é como você acessa um servidor remoto de forma segura. O "tmux" é um programa que divide a tela preta desse servidor em vários "quadradinhos" independentes. Você pode colocar um Claude rodando em cada quadrado remotamente.
4. GitHub Actions:
   • (Sem jargões): É o sistema de automação do GitHub. Você configura robôs para rodarem tarefas automaticamente quando alguém envia código. Você pode disparar várias dessas ações (jobs) em paralelo, e dentro de cada uma, o Claude Code resolve um problema diferente através do Claude Code SDK (versão focada em automação de código, não interação via terminal).

---

O Lembrete do Fazedor de Código

O objetivo do Claude Code não é substituir o seu cérebro de desenvolvedor. Como o próprio Boris destacou na sessão de perguntas e respostas, você continua sendo a pessoa que decide o que deve ser construído.

Você escreve a especificação, o Claude rascunha a obra pesada e você faz a revisão de código no final. Usem essa ferramenta para ganhar tempo, padronizar projetos via CLAUDE.md e automatizar o tédio. O design refinado do software continua sendo de responsabilidade de vocês!

Um abraço, e bom código!