Instalar uma ferramenta de código costuma parecer mais complicado do que é. O Claude Code começa com três coisas bem concretas: um terminal, uma pasta de projeto e uma conta que dê acesso ao serviço. Depois disso, você conversa com o agente, acompanha o que ele leu e aprova as mudanças antes de deixar qualquer arquivo diferente.
A documentação oficial da Anthropic organiza o primeiro uso em uma sequência simples. No Windows, há comandos diferentes para PowerShell e para o Prompt de Comando. No macOS, Linux e WSL, o caminho nativo usa outro instalador. Essa diferença parece pequena, mas é uma das causas mais comuns de erro: copiar um comando para o terminal errado.
Antes de começar, separe um projeto pequeno ou uma cópia do repositório. Também tenha um terminal aberto e uma forma de acesso ao Claude Code: uma assinatura Pro, Max, Team ou Enterprise, uma conta do Claude Console ou um provedor de nuvem compatível. A disponibilidade pode depender do plano e da configuração da organização.
No Windows, a Anthropic recomenda o Git for Windows para que o Claude Code possa usar o Bash. Sem ele, a ferramenta pode usar o PowerShell como shell. Isso não impede o uso, mas muda os comandos disponíveis. Quem trabalha com WSL pode seguir esse ambiente sem instalar o Git for Windows separadamente.
No PowerShell, use o instalador indicado pela documentação: irm https://claude.ai/install.ps1 | iex. No Prompt de Comando, a instrução é: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. O prompt ajuda a identificar o ambiente. No PowerShell, o caminho começa com PS C:\; no CMD, aparece apenas C:\.
Quando terminar, feche e abra o terminal de novo. Em seguida, confirme a instalação com claude --version. O comando deve mostrar um número de versão seguido por uma identificação do Claude Code. Se o sistema disser que o comando não foi encontrado, reabra o terminal antes de tentar outra coisa. O instalador nativo atualiza a instalação em segundo plano, segundo a documentação.
No macOS, Linux e WSL, a página oficial apresenta este instalador: curl -fsSL https://claude.ai/install.sh | bash. Depois, abra um novo terminal e rode claude --version. Se aparecer um erro de sintaxe, um 403 ou outro problema do curl, consulte o guia de solução de problemas da Anthropic. Não baixe um executável aleatório para contornar a mensagem.
Entre na pasta do projeto e inicie a ferramenta com cd /caminho/do/seu/projeto e depois claude. No primeiro uso, o Claude Code pede o login. Siga a autenticação na página oficial aberta pelo fluxo. Para trocar de conta depois, use /login dentro da sessão. Nunca cole senha, token ou código de autenticação em uma conversa.
Comece com uma pergunta de leitura, como “o que este projeto faz?” ou “onde fica o ponto de entrada?”. O agente consegue analisar os arquivos conforme precisa, mas a pergunta ainda deve explicar o que você quer descobrir. Contexto vago produz uma resposta bonita e pouco útil.
Quando a leitura fizer sentido, peça uma mudança fácil de conferir, como adicionar uma função simples ou escrever um teste para um módulo conhecido. Na primeira sessão após a instalação, o Claude Code pede aprovação antes de cada alteração. Leia o arquivo e o diff antes de confirmar.
A documentação informa que sessões posteriores podem começar em um modo automático, dependendo do plano, das configurações pessoais e da organização. Esse modo pode editar arquivos e executar comandos sem perguntar a cada passo. Pressione Shift+Tab para alternar o modo de permissão. Para um primeiro projeto, vale manter mais controle até entender o comportamento da ferramenta.
Antes de deixar o agente editar, confira o estado do repositório e crie um commit se a mudança atual estiver pronta. Dentro do Claude Code, você pode perguntar quais arquivos foram alterados, pedir uma revisão ou solicitar um commit com uma mensagem descritiva. Ainda assim, não trate a resposta do agente como prova de que o estado está correto.
Depois da tarefa, confira o diff no Git e rode os testes disponíveis. Se o agente tocou em arquivos demais, volte ao último checkpoint conhecido e reformule o pedido. Uma tarefa que pode ser desfeita em poucos minutos ensina mais do que uma feature grande aprovada no escuro.
Os comandos /help, /clear, /exit e /resume ajudam no começo. O Claude Code também pode investigar um bug, refatorar um módulo, escrever testes, atualizar documentação e revisar alterações. O melhor pedido costuma dizer qual arquivo ou comportamento está envolvido, qual resultado você espera e quais limites não devem ser ultrapassados.
Instalar é a parte rápida. O hábito que evita dor de cabeça vem depois: abrir o terminal na pasta certa, começar em modo de leitura, conceder apenas as permissões necessárias, revisar o diff e testar. O agente pode acelerar o trabalho, mas não sabe sozinho se a mudança combina com o produto, com os dados ou com a regra de negócio.
Fonte oficial: Quickstart do Claude Code, Anthropic.
