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.
Ouvir o resumo desta aula
Um recap de cerca de 2 minutos na voz do Valim, para ouvir no trânsito ou na academia.
Ler a transcrição do resumo
Resumo da aula: Instalando o Claude Code no seu sistema.
Os objetivos desta aula. 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.
Veja o essencial, parte por parte.
Requisitos e o caminho recomendado. Requisitos: macOS 13 ou mais novo, Windows 10 (versão 1809) ou mais novo, ou Linux recente; 4 GB de memória e internet.
As alternativas de instalação. O pacote npm pede Node.js na versão 22 ou mais nova nas versões recentes.
Confirmar que deu certo. Depois de instalar, confirme que a ferramenta esta funcionando antes de seguir.
Esse foi o resumo do essencial. Para se aprofundar, leia a aula completa e responda os exercícios.
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 | bashInstalador nativo no Mac, Linux ou WSL (cole no terminal e aperte Enter).
irm https://claude.ai/install.ps1 | iexInstalador nativo no Windows, pelo PowerShell (confira que a linha começa com PS).
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.
| Metodo | Comando | Bom para |
|---|---|---|
| Nativo (recomendado) | curl ... | bash ou irm ... | iex | A maioria dos usuários; atualiza sozinho |
| npm | npm install -g @anthropic-ai/claude-code | Quem já tem Node.js 22 ou mais novo |
| Homebrew | brew install --cask claude-code | Mac e Linux com Homebrew |
| WinGet | winget install Anthropic.ClaudeCode | Windows 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 doctorConfirme 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.