Módulo 2 - Instalação e primeiros passos

Instalando o Claude Code no seu sistema

9 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

  • Conferir os requisitos mínimos de sistema.
  • Instalar o Claude Code pelo caminho recomendado no seu sistema.
  • Conhecer as alternativas de instalação e quando usar cada uma.
  • Confirmar que a instalação deu certo.

Requisitos e o caminho recomendado

Antes de instalar, confira o básico. O Claude Code roda em macOS 13 ou mais novo, Windows 10 na versão 1809 ou superior e nas distribuicoes recentes de Linux, como Ubuntu 20.04 ou mais novo. Ele pede pelo menos 4 gigabytes de memória e conexão com a internet, já que o raciocínio do agente acontece nos servidores da Anthropic. Nada muito exigente: a maioria dos computadores dos últimos anos atende de sobra. No Windows, instalar o Git para Windows e opcional, mas ajuda o Claude Code a rodar comandos do jeito mais completo.

Com os requisitos em ordem, o caminho recomendado e o instalador nativo. Ele é um comando só, baixa a ferramenta direto da fonte oficial e tem um bonus importante: mantem o Claude Code atualizado sozinho, em segundo plano. No Mac, no Linux ou no WSL (o Linux dentro do Windows), o comando usa a ferramenta curl. No Windows pelo PowerShell, o comando usa a ferramenta irm. Você cola o comando, aperta Enter e espera a instalação terminar. E só isso.

curl -fsSL https://claude.ai/install.sh | bash

Instalador nativo no Mac, Linux ou WSL (cole no terminal e aperte Enter).

irm https://claude.ai/install.ps1 | iex

Instalador nativo no Windows, pelo PowerShell (confira que a linha começa com PS).

Diagrama com quatro caminhos de instalação do Claude Code partindo de uma caixa central: instalador nativo (recomendado, com atualização automática), npm para quem tem Node.js, Homebrew para Mac e Linux, e WinGet para Windows, com o nativo destacado.
Vários caminhos levam ao Claude Code; o instalador nativo e o recomendado para a maioria.

As alternativas de instalação

O instalador nativo resolve a maioria dos casos, mas conhecer as alternativas ajuda quando o seu ambiente pede algo específico. Quem já programa em JavaScript e tem o Node.js instalado pode usar o npm, o gerenciador de pacotes do Node. Quem usa Mac ou Linux e já gosta do Homebrew pode instalar por ele. No Windows, o WinGet, gerenciador de pacotes da própria Microsoft, também funciona. Uma diferença importante: dessas alternativas, só o instalador nativo se atualiza sozinho; nas outras, você roda o comando de atualização de vez em quando.

MetodoComandoBom para
Nativo (recomendado)curl ... | bash ou irm ... | iexA maioria dos usuários; atualiza sozinho
npmnpm install -g @anthropic-ai/claude-codeQuem já tem Node.js 22 ou mais novo
Homebrewbrew install --cask claude-codeMac e Linux com Homebrew
WinGetwinget install Anthropic.ClaudeCodeWindows com WinGet

Os caminhos oficiais. Comandos exatos na documentação; o nativo dispensa atualização manual.

🎮 Jogo da aula

Verdade ou mito na instalação?

Para cada afirmacao sobre instalar o Claude Code, diga se e verdadeira ou falsa.

Confirmar que deu certo

Depois de instalar, confirme que a ferramenta esta funcionando antes de seguir. O jeito mais rápido e pedir a versão instalada: digite claude com a opção de versão e aperte Enter. Se aparecer um número de versão, esta tudo certo. Se aparecer uma mensagem de comando não encontrado, algo saiu do lugar, e a próxima aula sobre resolucao de problemas cobre exatamente esse tipo de tropeco. Vale também conhecer um segundo comando, o claude doctor, que faz um diagnostico mais completo da sua instalação e sugere correções.

claude --version
claude doctor

Confirme a instalação (mostra o número da versão) e faca um diagnostico completo.

Confirmada a instalação, você esta a um passo de conversar com o agente. Mas ainda falta um detalhe que confunde muita gente e que merece uma aula só: o Claude Code precisa de uma conta com plano compatível para funcionar, e você faz o login logo na primeira vez que abre a ferramenta. E o que a próxima aula explica, sem enrolacao, para você não esbarrar nessa parede depois de instalar tudo direitinho.

Teste rápido

Qual comando confirma rapidamente que o Claude Code foi instalado, mostrando a versão?

Perguntas frequentes

Meu computador e antigo. Vai rodar o Claude Code?
Provavelmente sim. Os requisitos são modestos: macOS 13 ou mais novo, Windows 10 versão 1809 ou superior, ou Linux recente, com 4 gigabytes de memória e internet. Como o raciocínio pesado acontece nos servidores da Anthropic, a sua máquina não precisa ser potente para usar a ferramenta.
Qual método de instalação devo escolher?
Para a maioria das pessoas, o instalador nativo, porque e simples e se atualiza sozinho. Escolha uma alternativa apenas se tiver um motivo: usar o npm se já vive no ecossistema Node.js, o Homebrew se já o usa no Mac ou Linux, o WinGet se prefere o gerenciador da Microsoft no Windows.
Preciso instalar o Node.js para usar o Claude Code?
Não, se você usar o instalador nativo, que não depende do Node.js. O Node.js só entra se você escolher instalar pelo npm, e nesse caso ele precisa estar na versão 22 ou mais nova. O caminho nativo evita essa dependencia.
Instalei, mas ao digitar claude aparece comando não encontrado. E agora?
Isso costuma acontecer quando o terminal ainda não reconheceu o novo programa. Fechar e abrir o terminal de novo resolve boa parte dos casos. Se persistir, a próxima aula, sobre resolucao de problemas, mostra os passos, e o comando claude doctor aponta o que ajustar.
A instalação muda alguma coisa importante no meu sistema?
Ela instala a ferramenta em uma pasta do seu usuário e a deixa disponível no terminal. Não mexe nos seus arquivos nem em configurações sensíveis do sistema. Se um dia quiser remover, existe um comando de desinstalacao para cada método, que a aula final deste módulo apresenta.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.