A maioria dos guias "primeiros passos com Claude Code" para no npm install. Isso não é começar. Isso é só instalar um binário.

A pergunta de verdade é: como você configura seu terminal para que dar um objetivo a um agente fique mais fácil que digitar o código você mesmo?

A isso eu chamo workflow antigravidade. Quando você tem isso, deixa de buscar autocomplete. Delegar vira o padrão.

Passo 1 — Instalar (30 segundos)

# Requer Node.js >= 18
npm install -g @anthropic-ai/claude-code

# Verificar
claude --version

É isso. Sem painel SaaS, sem dança de OAuth, sem extensão de IDE para depurar. Na primeira vez que você roda claude num projeto, ele pede sua API key da Anthropic e guarda em ~/.claude/.

Passo 2 — Inicializar o projeto

Na raiz do seu projeto:

cd my-project
claude

# Dentro do prompt do Claude
> /init

/init cria uma pasta .claude/ com:

• settings.json — modelo, max tokens, permissões de tools.
• CLAUDE.md — o "system prompt" do projeto (lido a cada sessão).
• agents/ — definições de sub-agentes que você cria ao longo do tempo.

Essa pasta é a feature mais subutilizada do Claude Code. A maioria deixa CLAUDE.md vazio. É o equivalente a contratar um engenheiro sênior e esquecer de contar o que seu produto faz.

Passo 3 — Escrever um CLAUDE.md de verdade

Um bom CLAUDE.md é mais curto do que você pensa. Três seções:

# Contexto do projeto
- O que é o produto, em 2 frases.
- Stack: framework, versão da linguagem, libs principais.
- Onde o deploy roda (Vercel / AWS / on-prem).

# Convenções
- Comando de teste: `pnpm test`
- Comando de lint: `pnpm lint`
- "Nunca modificar arquivos em `app/_generated/`."

# Definition of done
- Todos os testes passam, lint limpo, sem `console.log` em produção.

Claude Code lê esse arquivo no início de cada sessão. Na prática você está enviando uma janela de contexto permanente.

Passo 4 — O hábito antigravidade

Aqui está a virada de workflow que me levou de "IA é brinquedo" para "IA entrega features":

A virada-chave: o terminal é o IDE. O que você revisa é o diff, não o arquivo. Você para de ler código de cima para baixo; passa a ler diffs.

Passo 5 — As permissões que você realmente quer

Por padrão Claude Code pergunta antes de rodar comandos shell. Depois da primeira sessão você vai ficar tentado a colocar --yes em tudo. Não faça.

Edite .claude/settings.json:

{
  "tools": {
    "shell": {
      "allow": [
        "pnpm test",
        "pnpm lint",
        "pnpm build",
        "git status",
        "git diff *",
        "ls *",
        "rg *"
      ],
      "deny": [
        "rm -rf *",
        "git push *",
        "npm publish *"
      ]
    }
  }
}

Esse é o ponto ideal: o agente roda qualquer coisa não destrutiva sem perguntar, mas nunca encosta no irreversível.

Passo 6 — Slash commands que você deveria ter no dia um

De fábrica você tem /init, /agents, /compact, /clear, /help. Os dois que mais uso:

• /compact — quando a janela de contexto começa a inchar, ele reescreve o resumo mantendo as decisões intactas. É a diferença entre uma sessão de 4 horas e uma sessão de 4 mensagens.
• /agents — abre o seletor de sub-agentes. Vamos a fundo no artigo 5.

Adicione comandos custom em .claude/commands/ mais adiante na série — a maior parte dos times acaba criando pelo menos /review, /test-and-fix e /release-notes quando pega o jeito.

O que "antigravidade" significa de verdade

O nome veio de um amigo que disse: "Quando o Claude Code está bem ajustado, o trabalho não cai sobre mim. Ele flutua."

Na prática, isso vira três coisas:

• Você para de microgerenciar. Você dá um objetivo, não uma lista de passos.
• Você confia no loop. Ler, planejar, escrever, testar, iterar — você deixa rodar.
• Você só intervém em pontos de decisão. Arquitetura, nomes, design de contratos.

Todo o resto — boilerplate, refactors, encanamento de testes, gestão de dependências — passou a ser problema do agente.

---

Próximo artigo: Escrever prompts que funcionam. Porque "deixa melhor" não é prompt. Vamos ver a estrutura de quatro partes que faz o Claude Code de fato terminar o que você pede.