Guia de campo do Claude Code em português

Claude Code para iniciantes: do zero ao primeiro pedido, no Windows

Este é o caminho de quem nunca abriu o Claude Code: instalar, entrar com a conta, fazer a primeira pergunta, pedir a primeira mudança acompanhando cada passo e conferir o que mudou. Os comandos são os da doc oficial em português (lida em 18/10/2026) e os do capítulo 1 do guia, que está inteiro na amostra grátis.

O que é o Claude Code, em uma frase

É o Claude trabalhando dentro de uma pasta do seu computador: ele lê os arquivos, edita, roda comandos e confere o resultado, em vez de só responder no chat. Ele não responde e espera: lê, age e confere, em laço, até achar que terminou (figura 2.1 do guia, p. 16). Não precisa ser programador para usar; o guia tem 22 receitas de escritório (planilha, PDF, recibo) que partem do mesmo começo deste tutorial.

Antes de começar: a conta

A doc pede "Uma assinatura Claude" (Pro, Max, Team ou Enterprise), uma conta do Console, que é a API cobrada por uso, ou um provedor de nuvem suportado. O plano gratuito do claude.ai não inclui o Claude Code (p. 10). Quanto custa cada plano em reais está no artigo quanto custa o Claude Code.

Passo 1: instalar no Windows

Abra o PowerShell pelo menu Iniciar. A doc ensina a reconhecer: "seu prompt mostra PS C:\ quando você está no PowerShell e C:\ sem o PS quando você está no CMD". No PowerShell, cole:

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

Não precisa ser administrador. O instalador não mostra progresso; quando terminar, abra uma janela nova do terminal e confira:

claude --version

A resposta é um número de versão seguido de "(Claude Code)". Se o Windows disser que claude não é reconhecido, a pasta do programa não está no PATH; o conserto em duas linhas está no artigo "claude não é reconhecido" e na p. 9 do guia.

Se aparecerVocê está
'irm' is not recognizedNo CMD, não no PowerShell
The token '&&' is not a valid statement separatorNo PowerShell, com o comando do CMD

A doc recomenda também o Git for Windows, para o Claude Code ganhar a ferramenta Bash; sem ele, os comandos rodam pelo PowerShell, e tudo deste tutorial funciona igual.

Passo 2: a primeira sessão e o login

Entre na pasta em que vai trabalhar e abra o Claude Code ali. Use uma pasta de teste com cópias, nunca a sua pasta de usuário inteira: ele enxerga a pasta onde foi aberto e as subpastas (p. 12).

New-Item -ItemType Directory "$HOME\teste-claude"
cd "$HOME\teste-claude"
claude

Na primeira vez, o navegador abre para o login; a doc diz que "O Claude Code solicita que você faça login no primeiro uso". Depois disso, "suas credenciais são armazenadas e você não precisará fazer login novamente". Para trocar de conta, /login dentro da sessão.

Passo 3: pergunte antes de pedir mudança

Comece perguntando, sem mudar nada. Ele lê o que precisa sozinho: "Você não precisa adicionar contexto manualmente."

o que tem nesta pasta? resuma em três linhas

Passo 4: a primeira mudança, aprovando cada passo

Aqui está o detalhe que pega quem começa. Salvo configuração em contrário, a sessão de terminal começa no modo auto: o Claude edita e roda comandos sem pedir licença a cada passo, e um classificador barra o que parece arriscado; se o modelo não aceitar o auto ou a organização o tiver desligado, ela começa em Manual (p. 13). Para acompanhar tudo nas primeiras vezes, aperte Shift+Tab até a barra mostrar "manual mode on", ou já abra assim:

claude --permission-mode manual

No modo Manual, toda edição e todo comando que não seja só leitura esperam o seu sim. Peça algo pequeno:

crie um arquivo lista.txt com os nomes dos arquivos desta pasta, um por linha

Ele mostra o que vai fazer e pergunta. Yes aprova só este passo; No (ou Esc) recusa e deixa você dizer o que quer diferente. A doc lembra: "Pressione Shift+Tab a qualquer momento para alternar o modo de permissão".

Passo 5: confira o arquivo, não a resposta

"Pronto, criei a lista" no chat não prova nada; o arquivo prova. Abra o lista.txt e confira. Esse é o hábito que mais evita erro: peça evidência (o arquivo, a saída do comando), não a palavra dele (p. 21).

Tecla ou comandoO que faz
EscPara a resposta no meio; o que já foi feito fica
Esc EscCom o campo vazio, volta a um ponto anterior (rewind)
/clearLimpa o histórico para começar outra tarefa
/helpMostra os comandos disponíveis
/exitSai do Claude Code
claude -cVolta à última conversa desta pasta

O rewind não desfaz o que um comando do terminal apagou ou moveu. Antes de algo grande, trabalhe numa cópia.

Passo 6: pedir bem

A dica da doc para iniciantes é a primeira: seja específico. Em vez de "corrigir o bug", diga o sintoma, onde está e como saber que ficou pronto. O guia organiza isso em cinco partes (objetivo, onde, restrições, padrão e pronto, figura 2.2, p. 18), e a última é a que mais faz diferença: "rode os testes e corrija até passar" termina certo; "conserte isso" termina quando parece certo.

Para onde ir depois

Fora do livro: code.claude.com/docs/pt/quickstart, lida em 18/10/2026.

Leia também