Como começar com o Claude Code

O Claude Code é o assistente de programação da Anthropic que corre no terminal. Lê os ficheiros do teu projeto, escreve e altera código, executa comandos e trata do git, tudo a partir de pedidos em linguagem normal. Também existe em versão web (claude.ai/code), aplicação de desktop, extensões para VS Code e JetBrains e no Slack, mas este guia cobre o terminal, que é a forma mais completa.

O que precisas antes de começar

Uma conta Claude paga: Pro, Max, Team ou Enterprise. O plano gratuito não dá acesso ao Claude Code. Em alternativa, uma conta na Claude Console (API com créditos pré-pagos).
Um computador com macOS 13 ou superior, Windows 10 (versão 1809) ou superior, ou Linux (Ubuntu 20.04+, Debian 10+, Alpine 3.19+). 4 GB de RAM e um processador x64 ou ARM64 chegam.
Ligação à internet e um terminal aberto.

Passo 1: instalar

macOS, Linux ou WSL (abre o Terminal e cola):

Terminal · o teu utilizador

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

Windows (abre o PowerShell e cola):

PowerShell

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

Se no Windows usas a Linha de Comandos (CMD) e não o PowerShell, o comando é outro:

Linha de comandos

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

No Windows, instala também o Git for Windows. Não é obrigatório, mas sem ele o Claude usa o PowerShell para correr comandos em vez do Bash.

Se preferes gestores de pacotes:

Terminal · o teu utilizador

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

Para confirmar que ficou instalado:

Terminal · o teu utilizador

$ claude --version

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

A instalação nativa atualiza-se sozinha. Homebrew e WinGet não: precisas de 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 anda cerca de uma semana atrás e salta versões com problemas graves; quem quer cada versão no dia em que sai instala claude-code@latest. Em Debian, Ubuntu, Fedora, RHEL e Alpine também há repositórios oficiais para apt, dnf e apk (ver a ligação no fim).

Passo 2: entrar na conta

Vai para a pasta do teu projeto e arranca o Claude Code:

Terminal · o teu utilizador

$ cd /caminho/para/o/projeto
$ claude

Na primeira vez abre-se o browser para fazeres login. Depois disso as credenciais ficam guardadas. Para trocar de conta mais tarde, escreve /login dentro da sessão.

Passo 3: a primeira conversa

Podes falar em português. Começa por deixar o Claude conhecer o projeto:

Claude Code

> o que faz este projeto?
> explica a estrutura de pastas
> onde está o ponto de entrada principal?

Depois pede uma alteração pequena:

Claude Code

> adiciona uma função hello world ao ficheiro principal

O Claude encontra o ficheiro e mostra a alteração. Se perguntar antes de gravar, escolhe Yes.

Quem aprova o que ele faz

Isto mudou e convém saber antes de começares. Nos planos Pro, Max e Team, as sessões começam em modo automático (auto mode). Nesse modo não és tu que aprovas cada passo: um segundo modelo revê as ações, e o Claude altera a maior parte dos ficheiros e corre a maior parte dos comandos sem te perguntar. Algumas coisas ficam bloqueadas por defeito, como publicar em produção ou forçar um push no git, mas o resto avança.

Nos outros planos, e por vezes na primeira sessão logo a seguir à instalação, começa em modo manual, que pede autorização antes de alterar ficheiros ou correr comandos.

Com Shift+Tab mudas de modo a qualquer momento. Se estás a começar e preferes ver cada alteração antes de ela acontecer, escolhe o modo manual. Para começar sempre assim, acrescenta isto ao ficheiro ~/.claude/settings.json:

~/.claude/settings.json

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

O Claude Code pode perguntar uma vez se queres passar para o modo automático. Se disseres que não, a tua escolha fica.

Comandos essenciais

No terminal:

claude inicia uma sessão
claude "tarefa" inicia uma sessão já com um primeiro pedido
claude -c continua a última conversa nesta pasta
claude -r escolhe uma conversa anterior para retomar
claude -p "pergunta" responde e sai, sem abrir sessão

Dentro da sessão:

/help lista os comandos
/init cria o ficheiro CLAUDE.md com notas 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

Escreve / para ver todos os comandos disponíveis, Tab completa e a seta para cima repete pedidos anteriores.

Cinco dicas para começar bem

Sê específico. Em vez de "corrige o bug", diz "corrige o bug em que o login mostra um ecrã em branco depois de uma password errada".
Divide tarefas grandes em passos numerados.
Deixa-o explorar primeiro ("analisa a base de dados") antes de pedir alterações.
Usa git. Assim vês exatamente o que mudou e podes voltar atrás. No modo automático isto conta ainda mais, porque muitas alterações acontecem sem te pedir confirmação. O próprio Claude faz commits se pedires.
Cria o CLAUDE.md com /init e vai acrescentando as regras do projeto. Poupa-te repetir o mesmo em cada sessão. O guia do CLAUDE.md explica como.

O que precisas antes de começar

Passo 1: instalar

Passo 2: entrar na conta

Passo 3: a primeira conversa

Quem aprova o que ele faz

Comandos essenciais

Cinco dicas para começar bem

Onde saber mais