Como usar Claude Code: 3 passos no terminal sem erros
Alternar entre janelas do navegador e o editor quebra o raciocínio e consome tempo de desenvolvimento. Saber como usar Claude Code resolve isso ao levar refatoração, testes e git para o seu terminal. O processo exige três etapas simples: instalar o binário nativo, autenticar a sessão no projeto e estruturar as diretrizes do repositório.
Por que a instalação via npm foi descontinuada?
Muitos desenvolvedores ainda tentam rodar o comando global do Node por hábito. No entanto, a instalação do Claude Code pelo npm está obsoleta e a Anthropic descontinuou esse canal, conforme o repositório oficial do projeto. Insistir nesse método impede o acesso a novas atualizações do binário oficial.
Os métodos oficiais utilizam instaladores nativos para cada sistema operacional. Essas instalações nativas recebem atualizações automáticas em segundo plano, segundo aponta a documentação do Claude Code. Isso elimina a necessidade de verificar e atualizar pacotes manualmente no terminal.
No Windows, existe um requisito prévio para garantir o funcionamento correto. A equipe do projeto recomenda ter o Git for Windows instalado para permitir o uso da ferramenta Bash, de acordo com o guia oficial. Sem isso, comandos que dependem de utilitários Unix encontram incompatibilidades no PowerShell.
A migração para o instalador oficial garante suporte contínuo e evita ferramentas defasadas. Veja o comparativo técnico entre os dois métodos:
| Critério | Instalação Nativa Oficial | Instalação via npm |
|---|---|---|
| Status de suporte | Ativo e recomendado | Obsoleto e descontinuado |
| Atualizações | Automáticas em segundo plano | Não recebe novos binários |
| Dependência do Node.js | Nenhuma (binário autônomo) | Exige runtime Node e npm |
| Ferramenta Bash (Windows) | Requer Git for Windows | Depende da configuração local |
Como usar Claude Code no terminal em 3 passos?
Passo 1: Instalação do binário nativo
Execute o comando oficial no terminal correspondente ao seu sistema operacional. No macOS e no Linux, utilize o comando via terminal:
curl -fsSL https://claude.ai/install.sh | bash
No Windows, utilize o PowerShell para baixar e instalar o binário:
irm https://claude.ai/install.ps1 | iex
Durante o download dos arquivos, o instalador do Claude Code não exibe indicador ou barra de progresso no terminal, conforme descrito na documentação técnica. Aguarde a conclusão do processo sem fechar a janela.
Ao finalizar, encerre a sessão atual. Abra um novo terminal e execute o comando claude --version para validar o sucesso da instalação, segundo a documentação do Claude Code. Essa confirmação assegura que o binário foi adicionado ao PATH do sistema.
Passo 2: Navegação até o projeto e login
Navegue pelo terminal até o diretório desejado na máquina antes de executar o agente, como determina a documentação oficial. O Claude Code precisa desse ponto de partida para localizar arquivos e entender o contexto do projeto sob demanda.
cd /caminho/do/seu/projeto
claude
O Claude Code solicita a realização de login logo na primeira vez em que é iniciado, conforme explica a visão geral da ferramenta. Siga a instrução no terminal para autenticar sua conta no navegador e autorizar a sessão da CLI. Concluída a validação, a linha de comando do assistente fica ativa no projeto.
Passo 3: Configuração das regras no CLAUDE.md
Crie um arquivo chamado CLAUDE.md na raiz do seu repositório. Ele funciona como a memória persistente da equipe para orientar o comportamento do modelo durante a edição dos arquivos.
# Diretrizes do Projeto
## Comandos de Teste e Build
- Rodar testes unitarios: npm test
- Rodar linter: npm run lint
- Build da aplicacao: npm run build
## Convencoes de Codigo
- Escreva funcoes puras com tipagem estrita no TypeScript.
- Nao altere arquivos em config/ sem aprovacao explicita.
- Nunca realize commits diretos na branch main.
Manter essas regras no CLAUDE.md impede alterações arbitrárias e aplica boas práticas de clean code com IA diretamente no fluxo do terminal, garantindo funções curtas e arquivos organizados.
Como executar tarefas e testes no terminal com segurança?
Instruções em texto no CLAUDE.md orientam o modelo sobre os limites do projeto. No entanto, a revisão do diff e a confirmação manual antes da execução continuam sendo as salvaguardas efetivas contra alterações indevidas no código.
# Exemplo de comando direto para o agente no terminal
claude "Analise src/services/auth.ts, identifique brechas de validacao e crie testes em tests/auth.test.ts"
O agente examina o código e exibe a proposta de alteração linha por linha. Você revisa cada diff antes de autorizar a gravação no disco. Em seguida, solicite a execução dos testes documentados no CLAUDE.md para checar se a suíte passa sem quebras.
Coloque o Claude Code para rodar no seu fluxo
Crie uma branch isolada no seu repositório Git para rodar a primeira refatoração prática com o Claude Code. Peça pequenos ajustes em módulos periféricos e rode a suíte de testes da branch para assegurar a estabilidade do código antes de abrir o pull request.
O trabalho em branch isolada valida as diretrizes do CLAUDE.md sem risco para a base principal. Essa abordagem permite revisar cada diff sugerido e validar o comportamento da aplicação antes de mesclar o código.
Se a sua rotina também envolve pipelines analíticos e preparação de bases brutas, veja como usar o Claude para limpar dados com precisão em arquivos tabulares.
