Primeiros passos com o Claude Code

O Claude Code é o assistente de programação da Anthropic que roda no terminal. Ele lê os arquivos do seu projeto, escreve e altera código, executa comandos e cuida do git, tudo a partir de pedidos em linguagem comum. Também tem versão web (claude.ai/code), aplicativo para desktop, extensões para VS Code e JetBrains, e funciona dentro do Slack. Este guia trata do terminal, que é a forma mais completa de usá-lo.

O que você precisa antes de começar

1. Um plano pago do Claude: Pro, Max, Team ou Enterprise. O plano gratuito não dá acesso ao Claude Code. A alternativa é uma conta no Claude Console, que é acesso à API com créditos pré-pagos.
2. Um computador com macOS 13 ou mais recente, Windows 10 (versão 1809) ou mais recente, ou Linux (Ubuntu 20.04+, Debian 10+, Alpine 3.19+), com 4 GB de RAM e processador x64 ou ARM64.
3. Conexão com a internet e um terminal aberto.

Passo 1: instalar

No macOS, Linux ou WSL, abra o terminal e cole:

$ curl -fsSL https://claude.ai/install.sh | bash

No Windows, abra o PowerShell e cole:

PS> irm https://claude.ai/install.ps1 | iex

Se você usa o Prompt de Comando (CMD) em vez do PowerShell, o comando é outro:

> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

No Windows, instale também o Git for Windows. Não é obrigatório, mas sem ele o Claude executa os comandos pelo PowerShell em vez do Bash.

Se preferir um gerenciador de pacotes:

$ brew install --cask claude-code        # Homebrew, Mac
$ winget install Anthropic.ClaudeCode    # WinGet, Windows

Para confirmar que deu certo:

$ claude --version

Deve aparecer um número de versão seguido de "(Claude Code)". Se algo parecer errado, claude doctor faz um diagnóstico da instalação sem abrir uma sessão.

A instalação nativa se atualiza sozinha em segundo plano. Homebrew e WinGet não: rode brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode de vez em quando. No Homebrew, o pacote claude-code segue o canal estável, que fica cerca de uma semana atrás e pula versões com problemas graves; quem quer cada versão no dia do lançamento instala claude-code@latest. Debian, Ubuntu, Fedora, RHEL e Alpine também têm repositórios oficiais para apt, dnf e apk (veja os links no final).

Passo 2: fazer login

Entre na pasta do seu projeto e inicie o Claude Code:

$ cd /caminho/do/projeto
$ claude

Na primeira vez, o navegador abre para você fazer login. Depois disso, as credenciais ficam salvas. Para trocar de conta mais tarde, digite /login dentro da sessão.

Passo 3: a primeira conversa

Você pode escrever em português. Comece deixando o Claude conhecer o projeto:

> o que esse projeto faz?
> explica a estrutura de pastas
> onde fica o ponto de entrada principal?

Depois peça uma alteração pequena:

> adiciona uma função hello world no arquivo principal

O Claude encontra o arquivo e mostra a alteração. Se ele perguntar antes de salvar, escolha Yes.

Quem aprova o que ele faz

Vale entender isto antes de seguir. Nos planos Pro, Max e Team, as sessões começam no modo automático (auto mode). Nesse modo não é você quem aprova cada passo: um segundo modelo revisa as ações, e o Claude altera a maioria dos arquivos e executa a maioria dos comandos sem perguntar. Algumas coisas ficam bloqueadas por padrão, como publicar em produção ou forçar um push no git, mas o resto segue em frente.

Nos outros planos, e às vezes na primeira sessão logo depois da instalação, ele começa no modo manual, que pede sua autorização antes de alterar arquivos ou executar comandos.

Aperte Shift+Tab a qualquer momento para trocar de modo. Se você está começando e prefere ver cada alteração antes de ela acontecer, escolha o modo manual. Para começar sempre assim, adicione isto ao arquivo ~/.claude/settings.json:

{
  "permissions": {
    "defaultMode": "manual"
  }
}

O Claude Code pode perguntar uma vez se você quer passar para o modo automático. Se responder que não, sua configuração continua valendo.

Comandos do dia a dia

No terminal:

• claude inicia uma sessão
• claude "tarefa" inicia uma sessão já com um primeiro pedido
• claude -c continua a conversa mais recente nesta pasta
• claude -r deixa você escolher uma conversa anterior para retomar
• claude -p "pergunta" responde uma vez e sai, sem abrir sessão

Dentro da sessão:

• /help lista os comandos
• /init cria o arquivo CLAUDE.md com anotações sobre o projeto, que o Claude lê em todas as sessões
• /model escolhe o modelo
• /clear limpa a conversa
• /exit (ou Ctrl+D duas vezes) sai

Digite / para ver todos os comandos disponíveis para você. Tab completa, e a seta para cima traz de volta os pedidos anteriores.

Cinco hábitos que fazem diferença

1. Seja específico. Em vez de "corrige o bug", diga "corrige o bug em que o login mostra uma tela em branco depois de uma senha errada".
2. Divida tarefas grandes em passos numerados.
3. Deixe ele explorar primeiro ("analisa o esquema do banco de dados") antes de pedir alterações.
4. Use git. Assim você vê exatamente o que mudou e consegue voltar atrás. No modo automático isso pesa ainda mais, porque muitas alterações acontecem sem pedir confirmação. O próprio Claude faz commits se você pedir.
5. Crie o CLAUDE.md com /init e vá acrescentando as regras do projeto. Assim você não precisa repetir a mesma coisa em toda sessão. O guia do CLAUDE.md explica como.

Fontes

• Quickstart, documentação oficial, consultada em 16 de setembro de 2026.
• Advanced setup: requisitos, instaladores, apt, dnf e apk, canais de atualização.
• Choose a permission mode: modo automático, modo manual, defaultMode.
• Troubleshoot installation