Workbranch › Guias

Como começar a usar o Claude Code

O Claude Code é o assistente de programação da Anthropic que lê seu projeto, edita arquivos e executa comandos no seu terminal. Este guia leva você da instalação até a primeira sessão funcionando, além do arquivo que deixa todas as sessões seguintes melhores.

Atualizado em 30 de outubro de 2026

Os comandos abaixo foram conferidos na documentação do Claude Code da Anthropic em outubro de 2026.

Quais planos incluem o Claude Code

Passo 1: instale

1. Abra um terminal. No Windows, o PowerShell mostra PS C:\ no prompt; o CMD mostra só C:\.
2. Execute o comando do seu sistema:
   • macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
   • Windows PowerShell: irm https://claude.ai/install.ps1 | iex
   • Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. Aguarde. O instalador não mostra barra de progresso durante o download.
4. Abra uma janela de terminal nova e execute claude --version. Deve aparecer um número de versão seguido de (Claude Code).

Prefere um gerenciador de pacotes? brew install --cask claude-code no Mac ou winget install Anthropic.ClaudeCode no Windows também funcionam. No Windows nativo, recomenda-se instalar o Git for Windows para que o Claude Code possa usar o Bash; sem ele, o Claude Code usa o PowerShell.

Passo 2: comece sua primeira sessão em um projeto

1. Entre no seu projeto: cd /path/to/your/project.
2. Digite claude e pressione Enter.
3. No primeiro uso, siga a instrução para fazer login pelo navegador. Suas credenciais ficam salvas, então você só faz isso uma vez. Depois, use /login para trocar de conta.
4. Faça uma pergunta para se situar, como o que este projeto faz? ou onde fica o ponto de entrada principal?. O Claude lê os arquivos de que precisa; você não precisa colar código.
5. Experimente uma alteração pequena, por exemplo adicione validação de entrada ao formulário de cadastro. O Claude mostra a edição e pergunta antes de aplicá-la; escolha Yes (sim) para aprovar.

O Claude Code também lida com o Git em linguagem comum: quais arquivos eu alterei? ou faça commit das minhas alterações com uma mensagem descritiva.

Passo 3: passe as regras do projeto ao Claude com o CLAUDE.md

Toda sessão começa com o contexto vazio. Um arquivo CLAUDE.md é carregado no início de cada uma, então é nele que você coloca o que o Claude sempre deve saber: comandos de build e de teste, convenções, coisas a evitar.

1. Em uma sessão, execute /init. O Claude percorre sua base de código e escreve um CLAUDE.md inicial com os comandos e convenções que encontrar. Se o arquivo já existe, ele sugere melhorias em vez de sobrescrevê-lo.
2. Abra o arquivo e acrescente o que o Claude não conseguiu descobrir sozinho, como "rode o linter antes de fazer commit".
3. Faça commit dele para que as sessões dos seus colegas recebam as mesmas instruções.

A Anthropic sugere manter cada arquivo com menos de umas 200 linhas: arquivos mais longos ocupam mais contexto e são seguidos com menos confiabilidade. Você pode incluir outros arquivos com @path/to/file.

Comandos que vale aprender primeiro

• claude "tarefa" inicia uma sessão com sua primeira instrução já preenchida.
• claude -p "pergunta" responde uma vez e sai.
• claude -c continua a última sessão nesta pasta; claude -r escolhe uma mais antiga. Mais detalhes em como retomar uma sessão do Claude Code.
• /help lista os comandos, /clear recomeça do zero, /exit (ou Ctrl+D duas vezes) sai.
• Digite / para ver os comandos e skills disponíveis.

Bom saber

• Uso: no Pro e no Max, o Claude Code e o chat do Claude compartilham os mesmos limites de cinco horas e semanal. Se uma variável de ambiente ANTHROPIC_API_KEY estiver definida e aprovada, o Claude Code usa essa chave e cobra pelas tarifas da API; execute /login para voltar para sua assinatura.
• Permissões: o modo de permissão define o que o Claude pode fazer sem perguntar. Pressione Shift+Tab para alternar entre os modos.
• O CLAUDE.md é uma orientação, não uma trava: o Claude o trata como contexto. Instruções curtas e específicas são seguidas com mais consistência.

Se não funcionar

• claude não é encontrado depois da instalação: abra um terminal novo. Se ainda falhar, a pasta de instalação ainda não está no seu PATH; a página de solução de problemas da Anthropic explica como corrigir.
• The token '&&' is not a valid statement separator: você está no PowerShell; use o comando do PowerShell. 'irm' is not recognized significa que você está no CMD.
• O comando de instalação falha com erro 403 ou de sintaxe: veja a página de solução de problemas de instalação da Anthropic para métodos alternativos.
• O login fica em loop ou usa a conta errada: execute /login dentro de uma sessão para entrar de novo.

Workbranch para o Claude Code

Se você acompanha o trabalho dos projetos no Workbranch, o plugin dele para o Claude Code mostra o que ainda está em aberto quando uma sessão começa em uma pasta ligada a um projeto, e você pode dizer "save this to Workbranch" (salve isto no Workbranch) para arquivar as tarefas, decisões e dúvidas em aberto da sessão por tema. Os detalhes estão na página Workbranch para Claude.

Fontes

• Use Claude Code with your Pro or Max plan (Central de Ajuda do Claude, consultado em 2026-10-30)
• Quickstart (Claude Code Docs, consultado em 2026-10-30)
• How Claude remembers your project (Claude Code Docs, consultado em 2026-10-30)

Perguntas frequentes