Neste artigo
- Como instalar o Claude Code em 2026?
- Quais os requisitos para rodar o Claude Code?
- Como fazer o primeiro login no Claude Code?
- Como dar a primeira tarefa para o agente?
- Quais comandos slash usar dentro da sessão?
- Como continuar uma conversa anterior?
- Como saber se a instalação está saudável?
- Dicas para quem está começando com agentes de codigo
- Como instalar o Claude Code no Windows?
- Preciso de Node.js para usar o Claude Code?
- Qual a diferença entre claude e claude -p?
- O que faz o comando /init?
- O Claude Code e gratuito?
- Quais outros agentes de IA para terminal existem?
O Claude Code é o agente de código da Anthropic que roda no terminal e ajuda a escrever, corrigir e explicar código dentro do seu projeto. Instalar em 2026 é simples: em macOS, Linux ou WSL basta um comando, e os comandos deste guia foram verificados na documentação oficial em 3 de novembro de 2026. Quem está montando a base pode acompanhar o roadmap de dev iniciante na era da IA em 2026.
Neste guia você aprende a instalar, fazer o primeiro login, dar a primeira tarefa para o agente e usar os comandos slash principais, tudo com os comandos reais da documentação da Anthropic, sem atalhos inventados.
Como instalar o Claude Code em 2026?
A forma recomendada pela documentação oficial, consultada em 3 de novembro de 2026, é o instalador nativo. Em macOS, Linux ou WSL, abra o terminal e execute:
curl -fsSL https://claude.ai/install.sh | bash
No Windows, use o PowerShell com o comando equivalente:
irm https://claude.ai/install.ps1 | iex
Se você já usa Node.js, a instalação via npm também funciona e instala o mesmo binário nativo:
npm install -g @anthropic-ai/claude-code
A documentacao oficial e completa de instalacao esta em code.claude.com/docs/en/setup, verificada em 03/11/2026.
Evite usar sudo npm install -g: a documentação alerta que isso causa problemas de permissão. No macOS com Homebrew, a alternativa é brew install --cask claude-code. Depois de instalar, confirme a versão com:
claude --version
Quais os requisitos para rodar o Claude Code?
Para o instalador nativo, você precisa de um terminal com acesso à internet e de uma conta na Anthropic. Para a instalação via npm, a documentação exige Node.js 22 ou superior, consultada em 3 de novembro de 2026. Ter o Git instalado no projeto também é recomendado, porque o agente usa o histórico para entender mudanças e criar pontos de reversão. Um editor como o VS Code completa a experiência, mas não é obrigatório.
Como fazer o primeiro login no Claude Code?
Ao rodar o comando pela primeira vez, o Claude Code abre o navegador para você entrar com a sua conta Anthropic (a mesma do claude.ai). Se preferir usar chave de API, exporte a variável de ambiente antes de iniciar:
export ANTHROPIC_API_KEY="sua-chave-aqui"
Com a variável definida e aprovada no primeiro acesso, o Claude Code pula a tela de login, segundo a documentação de configuração consultada em 03/11/2026.
Como dar a primeira tarefa para o agente?
Navegue até a pasta do seu projeto e inicie a sessão interativa:
cd meu-projeto
claude
Dentro da sessão, descreva a tarefa em linguagem natural, por exemplo: "crie um script Python que calcule o IMC e escreva testes para ele". O agente lê os arquivos, propõe mudanças e pede confirmação antes de editar. Para uma pergunta única, sem abrir a sessão interativa, use o modo print:
claude -p "explique o que esta funcao faz"
O -p (ou --print) executa a consulta, imprime a resposta e sai. Também dá para mandar o conteúdo de um arquivo pelo pipe: cat arquivo.py | claude -p "revise este codigo".
Quais comandos slash usar dentro da sessão?
Os comandos slash começam com barra e controlam a sessão. Os principais, segundo a referência de comandos da documentação oficial em 03/11/2026, são:
/init: gera um arquivo CLAUDE.md inicial com o resumo do projeto./help: lista todos os comandos disponíveis./clear: limpa o histórico da conversa atual./compact: resume a conversa para liberar contexto./cost: mostra o uso e o custo da sessão./model: troca o modelo usado na sessão./permissions: gerencia quais ferramentas o agente pode usar sozinho./resume: continua uma conversa anterior./exit(ou Ctrl+D duas vezes): encerra o Claude Code.
Como continuar uma conversa anterior?
As sessões ficam salvas por diretório. Para reabrir a conversa mais recente do projeto atual, use:
claude -c
Para escolher uma sessão específica por nome ou identificador, use claude -r "nome-da-sessao", ou o comando /resume dentro de uma sessão. Dá para exportar a conversa em texto com /export.
Como saber se a instalação está saudável?
O comando claude doctor faz um diagnóstico somente de leitura da instalação e das configurações, sem iniciar sessão. Dentro da sessão, o comando /doctor faz a checagem e ainda aplica correções. Para atualizar para a versão mais recente, rode claude update. Esses três comandos constam na referência de CLI da documentação oficial consultada em 03/11/2026.
Dicas para quem está começando com agentes de codigo
Comece com tarefas pequenas e vá aumentando a autonomia aos poucos. Descreva o resultado esperado, não só a ação: "o script deve receber peso e altura e imprimir o IMC com duas casas" é melhor do que "faça um script de IMC". Peça testes junto com o código e revise o diff antes de aceitar. Veja também como a Anthropic usa o Claude Code em fluxos dinâmicos e o que acontece quando o terminal passa a usar IA.
⚠️ Atenção: não use a flag --dangerously-skip-permissions por hábito. Ela faz o agente executar comandos sem pedir confirmação, o que é perigoso em projetos reais. Prefira aprovar cada ação até confiar no comportamento do agente no seu código.
💡 Dica: crie um arquivo CLAUDE.md na raiz do projeto com as regras do seu código (estilo, testes, convenções). O comando /init gera esse arquivo automaticamente e o agente passa a segui-lo em todas as sessões.
Perguntas frequentes
Como instalar o Claude Code no Windows?
No Windows, use o PowerShell com irm https://claude.ai/install.ps1 | iex, ou instale via npm com npm install -g @anthropic-ai/claude-code. Também é possível usar o WSL 2, que segue o mesmo comando do Linux.
Preciso de Node.js para usar o Claude Code?
Só se você instalar pelo npm, que exige Node.js 22 ou superior segundo a documentação de 03/11/2026. O instalador nativo baixa um binário próprio e não depende do Node em tempo de execução.
Qual a diferença entre claude e claude -p?
claude abre a sessão interativa, onde você conversa em vários turnos. claude -p "pergunta" executa uma única consulta, imprime a resposta e fecha, ideal para scripts e automações.
O que faz o comando /init?
O /init analisa o projeto e gera um arquivo CLAUDE.md com um resumo da estrutura e das convenções. Esse arquivo passa a ser lido pelo agente em todas as sessões seguintes do mesmo diretório.
O Claude Code e gratuito?
O uso consome créditos conforme o plano da sua conta Anthropic (assinatura ou saldo de API). Consulte os planos e preços atuais na página oficial claude.com/pricing, verificada em 03/11/2026.
Quais outros agentes de IA para terminal existem?
Além do Claude Code, existem opções como o Gemini CLI, do Google, e o GitHub Copilot no terminal. Compare as ferramentas no nosso texto sobre Claude vs ChatGPT vs Perplexity e veja o que muda quando o terminal passa a usar IA.