Como instalar o Claude Code (Windows, Mac, Linux): login, preço e o erro do plano gratuito

Instalar o Claude Code dá menos trabalho quando você usa um comando por vez, no terminal certo. Muita gente tenta misturar dois métodos na mesma tarde e termina sem saber qual deles funcionou. Este guia segue outro caminho, com calma e ordem.

Você vai ver o que conferir antes de começar, qual comando combina com o seu sistema, como entrar com a conta certa e como confirmar que está tudo pronto. Se você chegou aqui pelo mapa geral, volte a ele quando quiser pelo Claude Code do zero. Os comandos, requisitos de memória, opções de login e o diagnóstico estão descritos no guia oficial de início rápido.

Confira a memória primeiro, porque ela define o conforto do uso. O mínimo é 4GB de RAM e o recomendado é 8GB, conforme o guia oficial de início rápido. Se a máquina tem exatamente o mínimo, feche programas pesados durante a instalação para evitar lentidão.

Confira o Node apenas se você pretende instalar pelo npm. A exigência é Node na versão 22 ou superior, também descrita no guia oficial de início rápido. Rode o comando abaixo para ver a versão atual antes de decidir o método.

node --version

Confira o terminal e o Git no Windows antes de rodar qualquer comando. O Windows nativo pede Git for Windows instalado e PowerShell para o método principal, com detalhes no guia oficial de início rápido. No Mac e no Linux, o terminal padrão já resolve, com o WSL cobrindo quem usa Linux dentro do Windows.

Escolha um método e siga só com ele até o fim. Misturar curl com npm ou winget com npm na mesma tentativa cria dois pontos de falha e dificulta o diagnóstico. Todos os caminhos abaixo estão listados no guia oficial de início rápido.

A tabela acima resume a decisão em uma leitura. Se você usa Windows, comece por irm ou winget. Se usa Mac, comece por curl ou brew. Se usa Linux ou WSL, use curl. Deixe o npm como plano B para quando você já mantém o Node atualizado.

Use o PowerShell para o método principal no Windows. O comando oficial usa irm com pipe para iex, e esse fluxo pertence ao PowerShell, conforme o guia oficial de início rápido. Abra o PowerShell, cole um comando e aguarde o fim antes de fechar a janela.

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

Rode o irm no PowerShell passo a passo

Abra o menu iniciar, digite PowerShell e abra o Windows PowerShell. Cole o comando irm exatamente como está acima e pressione Enter. Aguarde a barra de progresso terminar e abra um terminal novo antes de testar, porque o caminho do sistema só atualiza na nova sessão.

Entenda a pegadinha do CMD contra o PowerShell

CMD e PowerShell parecem iguais, mas não rodam os mesmos comandos. O comando irm com pipe para iex não funciona no CMD, então colar ele lá gera erro na hora. A correção é simples. Feche o CMD, abra o PowerShell e rode de novo por um único canal.

Outra pegadinha comum é a política de execução que bloqueia scripts no PowerShell. Se aparecer aviso de script bloqueado, abra o PowerShell normalmente, confira que você copiou o comando completo e tente de novo antes de mudar configurações. Anote a mensagem exata do erro, porque ela indica se o problema é de comando, de rede ou de permissão.

Instale o Git for Windows e prefira um canal

Instale o Git for Windows se você usa Windows nativo, porque ele garante o Git e um ambiente mais previsível para abrir projetos. Confira com o comando abaixo em um terminal novo após instalar.

git --version

Use o winget como alternativa organizada se você já instala programas por ele. Os comandos de instalação e atualização ficam assim, com a lista completa de canais no guia oficial de início rápido.

winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode

Use o curl como caminho padrão no Mac, no Linux e no WSL. Ele baixa o script oficial e executa em sequência, sem depender do Node ou de gerenciador extra. O comando exato está no guia oficial de início rápido.

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

Rode o curl e abra um terminal novo

Copie o comando curl para o terminal, pressione Enter e aguarde até o fim. Feche o terminal e abra outro antes de testar, porque a sessão antiga não enxerga o caminho novo. Esse passo de abrir um terminal novo resolve boa parte dos casos de comando não encontrado.

Use o brew cask no Mac e faça upgrade manual

Use o brew apenas se você já mantém o Homebrew atualizado no Mac. A instalação usa cask, e a atualização é manual quando sai versão nova, conforme o guia oficial de início rápido.

brew install --cask claude-code
brew upgrade --cask claude-code

Use o npm quando o Node 22 já está pronto

Use o npm quando você já cuida do Node e prefere gerenciar a ferramenta junto com outros pacotes globais. A condição é direta, Node 22 ou superior antes de instalar, com o requisito documentado no guia oficial de início rápido. A comparação entre canal nativo e npm, com prós e contras de cada um, aparece no guia de primeiros passos, publicado em 08/abr/2026.

node --version
npm install -g @anthropic-ai/claude-code

Faça login com uma conta que tem direito de uso. As opções são assinaturas Pro, Max, Team ou Enterprise, ou acesso via Console e Bedrock em cenários de empresa e nuvem, conforme o guia oficial de início rápido. O fluxo abre o navegador para confirmar a conta, então conclua a etapa no navegador e volte ao terminal.

O erro mais comum é tentar entrar com o plano gratuito. O plano gratuito não inclui o Claude Code, então o bloqueio nesse caso não indica falha de instalação, conforme o resumo publicado em 14/jul/2026 no guia sobre o que é Claude Code. Se a mensagem fala de plano ou permissão, confira qual conta está logada antes de reinstalar.

Escolha a conta pelo seu contexto para evitar troca no meio do dia. Use Pro ou Max para uso individual, Team ou Enterprise para time, e Console ou Bedrock para integrações de empresa e nuvem. Quando trocar de máquina ou quando a sessão expirar, entre de novo e rode o diagnóstico da próxima seção.

Confirme com dois comandos em um terminal novo. O primeiro mostra a versão instalada e o segundo verifica o ambiente e aponta o que falta, com ambos documentados no guia oficial de início rápido e no guia de primeiros passos de 08/abr/2026.

claude --version
claude doctor

Abra sempre na pasta do projeto, nunca na pasta home. Entre na pasta com cd e só então inicie, porque abrir no lugar errado amplia o alcance do agente sem necessidade. O padrão abaixo vale para todos os sistemas.

cd caminho/do/seu/projeto
claude

Se o terminal diz que o comando não foi encontrado, feche o terminal, abra outro e repita o teste. Se o erro continua, confira qual método você usou e repita a instalação por um único canal, sem alternar entre curl, brew, winget e npm. Anotar o método usado facilita pedir ajuda com a mensagem exata.

Para transformar essa instalação em prática guiada, siga o próximo passo do cluster: roteiro dos primeiros 30 minutos.

O plano gratuito inclui o Claude Code?

Não inclui. O acesso pede Pro, Max, Team, Enterprise, Console ou Bedrock, conforme o resumo publicado em 14/jul/2026 no guia sobre o que é Claude Code. Se você está no plano gratuito e recebe bloqueio, o passo correto é migrar para um plano com direito ou usar o acesso da empresa, não reinstalar.

Preciso do Node 22 para instalar?

Precisa apenas se escolher o canal npm. Os canais curl, irm, brew cask e winget não pedem Node, conforme o guia oficial de início rápido. Se o comando node --version mostra número abaixo de 22, atualize o Node ou troque para o canal nativo do seu sistema.

Qual diferença entre instalar pelo canal nativo e pelo npm?

O canal nativo usa o instalador do sistema e segue o fluxo padrão de cada plataforma. O npm instala como pacote global e combina com quem já mantém o Node atualizado. Essa comparação entre nativo e npm aparece no guia de primeiros passos de 08/abr/2026. Na dúvida, prefira o canal nativo e use o npm como segunda opção.

O terminal diz que claude não foi encontrado. O que faço?

Feche o terminal e abra outro antes de qualquer outra tentativa, porque o caminho novo só aparece na sessão nova. Depois rode claude --version e claude doctor para confirmar, com ambos descritos no guia oficial de início rápido e no guia de primeiros passos de 08/abr/2026. Se o erro continua, reinstale por um único canal e anote a mensagem exata.

Instalação tranquila se resume a três decisões em ordem. Escolha um canal do seu sistema, entre com uma conta que tem direito e confirme com versão e diagnóstico na pasta do projeto. Essa ordem evita a mistura de métodos, o erro do plano gratuito e a abertura na pasta errada.

Continue pelo treino guiado em roteiro dos primeiros 30 minutos. Depois trave a segurança em CLAUDE.md e permissões seguras.

• guia oficial de início rápido
• guia sobre o que é Claude Code
• guia de primeiros passos