<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Claude Code para iniciantes: como instalar e usar em 2026

DA

7 min

Entusiasta das Tecnologias

Claude Code para iniciantes: como instalar e usar em 2026

Guia de 2026 com os comandos reais do Claude Code verificados na documentação da Anthropic: instalação, login, primeira tarefa e comandos slash.

Neste artigo

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.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 03/11/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR