Instalar o Claude Code no Windows, Mac e Linux

Para instalar o Claude Code, execute em um terminal o comando oficial da Anthropic: curl -fsSL https://claude.ai/install.sh | bash no macOS, Linux e WSL, ou irm https://claude.ai/install.ps1 | iex no PowerShell no Windows. Depois, verifique com claude --version e digite claude para fazer login. É necessária uma assinatura paga do Claude ou uma conta do Console: o plano gratuito não inclui o Claude Code.
O Claude Code é instalado com um único comando no Windows, no macOS e no Linux, mas os detalhes mudam de um sistema para outro: PowerShell ou CMD, WSL, Homebrew, repositórios Linux, PATH a corrigir. Este guia traz os comandos oficiais levantados em 18 de novembro de 2026, como verificar se tudo está funcionando, os erros mais comuns e, por fim, a conexão com um modelo local usando Ollama.
#Como instalar o Claude Code? Pré-requisitos e comandos oficiais
O Claude Code é instalado com um único comando oficial: curl -fsSL https://claude.ai/install.sh | bash no macOS, Linux e WSL, ou irm https://claude.ai/install.ps1 | iex no PowerShell no Windows. Esse script nativo é o método recomendado pela Anthropic, pois ele se atualiza sozinho em segundo plano.
O Claude Code é o agente de programação da Anthropic: um programa usado no terminal que lê o código de um projeto, modifica arquivos e executa comandos depois da sua aprovação. O programa é instalado na sua máquina, mas o modelo de IA roda nos servidores da Anthropic: segundo a documentação oficial consultada em 18 de novembro de 2026, uma conexão com a Internet é obrigatória.
| Sistema | Método | Commande | Atualização automática |
|---|---|---|---|
| macOS, Linux, WSL | Script nativo (recomendado) | curl -fsSL https://claude.ai/install.sh | bash | Sim, em segundo plano |
| Windows (PowerShell) | Script nativo (recomendado) | irm https://claude.ai/install.ps1 | iex | Sim, em segundo plano |
| Windows (CMD) | Script nativo | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Sim, em segundo plano |
| macOS | Homebrew | brew install --cask claude-code | Não por padrão: brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | Não por padrão: winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu, Fedora, RHEL, Alpine | Repositórios apt, dnf, apk assinados | Ver a documentação oficial | Não: atualização do sistema |
| Todos (Node.js 22 ou superior) | npm | npm install -g @anthropic-ai/claude-code@latest | Dependendo das permissões da pasta do npm |
#Configuração necessária
Aproveite a nossa experiência e um percurso guiado para escolher as ferramentas certas para o seu Mac e usar a sua IA no dia a dia.
- Espaço online vitalício
- PDF + arquivos
- Reembolsado em 30 dias
- Sistema
- macOS 13.0 ou superior, Windows 10 1809 ou superior (ou Windows Server 2019), Ubuntu 20.04 ou superior, Debian 10 ou superior, Alpine Linux 3.19 ou superior.
- Hardware
- No mínimo 4 GB de RAM e um processador x64 ou ARM64. Nenhuma placa de vídeo é necessária, já que o modelo Claude roda remotamente.
- Compte
- Uma assinatura Claude Pro, Max, Ultra, Team ou Enterprise, ou uma conta Claude Console paga por uso. O plano gratuito do claude.ai não inclui o Claude Code.
- País
- O Claude Code só está acessível nos países suportados pela Anthropic; a França é um deles.
Quanto ao preço, a página oficial da Anthropic consultada em 18 de novembro de 2026 mostra o plano Pro a 20 dólares por mês no faturamento mensal e informa que o Claude Code está incluído em todos os planos pagos, com os mesmos limites de uso do restante da assinatura. Os detalhes dos planos e das alternativas gratuitas estão no guia dedicado ao preço do Claude Code.
#Instalar o Claude Code no Windows: PowerShell, CMD ou WSL
No Windows, o Claude Code é instalado pelo PowerShell com irm https://claude.ai/install.ps1 | iex, sem privilégios de administrador. Uma alternativa é instalá-lo no WSL 2, o subsistema Linux do Windows, com o comando do Linux: esse é o único modo no Windows em que o sandbox de comandos é compatível.
- 01Abrir o PowerShellAbra o menu Iniciar, digite PowerShell e abra-o normalmente, sem usar « Executar como administrador ». O prompt começa com PS C:\Users\SeuNome>, o que confirma que você está no PowerShell e não no prompt de comando CMD.
- 02Executar o script de instalaçãoCole o comando irm https://claude.ai/install.ps1 | iex e confirme com Enter. O script baixa o Claude Code sem exibir barra de progresso: espere o prompt voltar antes de fazer qualquer outra coisa.
- 03Abrir um novo terminalFeche a janela do PowerShell e abra uma nova, para que a pasta de instalação seja reconhecida. O programa fica em %USERPROFILE%\.local\bin\claude.exe.
- 04Verificar a versãoDigite claude --version. Uma instalação bem-sucedida exibe um número de versão seguido de (Claude Code). Se o Windows responder que claude não é reconhecido, aplique a correção do PATH descrita mais abaixo.
- 05Instalar o Git for Windows (recomendado)O Git for Windows é opcional, mas recomendado pela Anthropic: ele fornece o Git Bash, que o Claude Code usa para executar seus comandos. Sem ele, o Claude Code usa o PowerShell. Uma instalação no WSL não precisa dele.
#Instalar o Claude Code no Mac: script nativo ou Homebrew
No Mac, o Claude Code é instalado abrindo o aplicativo Terminal e executando curl -fsSL https://claude.ai/install.sh | bash. É necessário o macOS 13.0 ou superior; tanto os Macs com Apple Silicon (ARM64) quanto os Macs Intel (x64) são suportados. O Homebrew é uma alternativa, mas sem atualização automática.
O Homebrew oferece dois pacotes do Claude Code. O pacote claude-code segue o canal estável, que geralmente fica cerca de uma semana atrasado e descarta as versões com regressões graves. O pacote claude-code@latest recebe cada versão assim que ela é lançada. Por padrão, a atualização pelo Homebrew é feita manualmente com brew upgrade claude-code, ou brew upgrade claude-code@latest para o segundo pacote. Para que o próprio Claude Code execute essa atualização pelo Homebrew ou pelo WinGet, a documentação da Anthropic orienta definir a variável de ambiente CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE como 1.
O script nativo coloca o executável em ~/.local/bin/claude. Se o Terminal responder “command not found: claude”, essa pasta ainda não está no PATH do seu shell: a correção é explicada na seção dedicada aos erros.
#Instalar o Claude Code no Linux: script, apt, dnf ou Alpine
No Linux, o Claude Code é instalado com o mesmo script do Mac: curl -fsSL https://claude.ai/install.sh | bash, sem sudo. A Anthropic também publica repositórios assinados apt (Debian, Ubuntu), dnf (Fedora, RHEL) e apk (Alpine) para máquinas em que os softwares precisam passar pelo gerenciador de pacotes.
O Alpine Linux e as outras distribuições baseadas em musl não incluem bash nem curl por padrão. Sem eles, o script de instalação falha com um erro “not found”. Instale primeiro esses dois pacotes e depois execute novamente o comando de instalação.
Os repositórios apt, dnf e apk oferecem, cada um, um canal stable e um canal latest. A configuração deles exige vários comandos, incluindo a verificação da impressão digital da chave de assinatura da Anthropic: siga-os diretamente na página de instalação avançada da documentação oficial, com link no fim do guia. Essas instalações são atualizadas junto com o sistema, por exemplo sudo apt update && sudo apt upgrade claude-code.
#Como verificar se o Claude Code foi instalado corretamente?
Para verificar a instalação do Claude Code, abra um novo terminal e digite claude --version: deve aparecer um número de versão. Em 18 de novembro de 2026, a versão mais recente no topo do changelog oficial é a 2.1.327, enquanto o canal estável distribui a 2.1.311, segundo o registro do npm. Portanto, um número mais antigo não é necessariamente um erro: o pacote Homebrew claude-code e os repositórios Linux configurados por padrão seguem esse canal estável. Em seguida, o comando claude doctor fornece um diagnóstico completo.
O comando claude doctor mostra, sem abrir uma sessão, o estado da instalação, os erros nos arquivos de configuração e os avisos com uma correção sugerida. É a primeira coisa a fazer quando o Claude Code se comporta de forma estranha após uma instalação ou atualização.
- 01Acessar um projetoNo terminal, vá até a pasta do projeto em que você quer trabalhar com o comando cd seguido do caminho da pasta. O Claude Code trabalha com os arquivos da pasta em que é iniciado.
- 02Iniciar o Claude CodeDigite claude. Na primeira execução, o Claude Code abre o navegador para você entrar com sua conta Claude (Pro, Max, Ultra, Team, Enterprise) ou sua conta do Console. Se o navegador exibir um código em vez de voltar ao terminal, cole esse código no terminal.
- 03Fazer uma primeira perguntaDepois que você faz login, o prompt do Claude Code mostra a versão, o modelo e a pasta de trabalho. Pergunte, por exemplo, “o que este projeto faz?”. As credenciais ficam salvas: o login não é mais solicitado nas próximas execuções.
- 04Preparar o projetoDigite /init para que o Claude Code analise o código e gere um arquivo CLAUDE.md inicial, com os comandos de build e de teste e as convenções do projeto. Digite /help para ver a lista de comandos e /config para as configurações.
#Atualizar ou desinstalar o Claude Code
Uma instalação nativa do Claude Code se atualiza sozinha na inicialização e em segundo plano; o comando claude update aplica imediatamente a versão mais recente. Em uma instalação nativa no macOS, Linux ou WSL, a desinstalação consiste em remover o inicializador e a pasta de versões.
#Claude Code não encontrado ou instalação bloqueada: os erros mais comuns
O erro mais comum após instalar o Claude Code é “command not found: claude” ou “'claude' não é reconhecido”: o programa está instalado corretamente, mas a pasta dele, ~/.local/bin no Mac e no Linux ou %USERPROFILE%\.local\bin no Windows, não está no PATH. O instalador avisa isso nas “Setup notes”, mas não corrige o PATH por conta própria.
| Mensagem exibida | Causa | Correção |
|---|---|---|
| command not found: claude / 'claude' is not recognized | Pasta de instalação ausente do PATH | Adicionar ~/.local/bin (ou %USERPROFILE%\.local\bin) ao PATH e depois abrir um novo terminal |
| The token '&&' is not a valid statement separator | Comando do CMD colado no PowerShell | Usar o comando do PowerShell |
| 'irm' is not recognized as an internal or external command | Comando do PowerShell colado no CMD | Usar o comando do CMD |
| curl: (22) The requested URL returned error: 403 | Proxy ou filtro de rede, ou país não compatível | Verificar a rede ou o proxy da empresa |
| App indisponível na região | País não suportado pela Anthropic | O Claude Code não está disponível neste país |
| not found no Alpine | bash ou curl absents | apk add bash curl |
A correção para o zsh vale para o macOS, em que o zsh é o shell padrão. No Linux com bash, a mesma linha export deve ser adicionada ao arquivo ~/.bashrc; no Mac com bash, ela vai no ~/.bash_profile, porque o Terminal do macOS inicia o bash como shell de login, que ignora o ~/.bashrc. Um terminal aberto antes da correção mantém o PATH antigo, e um terminal integrado a um editor como o VS Code herda o PATH do editor: feche e reabra a janela, ou o editor, antes de testar novamente claude --version.
#Como conectar o Claude Code ao VS Code?
Para usar o Claude Code no VS Code, instale a extensão oficial Claude Code da Anthropic: abra a visualização Extensões com Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows e no Linux, pesquise "Claude Code" e clique em Instalar. É necessário o VS Code 1.94.0 ou superior e uma conta paga do Claude ou uma conta do Console.
A extensão do Claude Code para VS Code inclui sua própria cópia do programa para o painel de chat, mas não a adiciona ao PATH. Para digitar claude no terminal integrado do VS Code, a instalação autônoma descrita acima continua sendo necessária. A extensão também pode ser instalada no Cursor e em outros editores derivados do VS Code, pelo registro Open VSX.
#Conectar o Claude Code a um modelo local com Ollama
O Claude Code pode funcionar com um modelo local graças ao Ollama, que expõe uma API compatível com a da Anthropic. Depois de instalar o Claude Code e o Ollama, o comando ollama launch claude inicia o Claude Code conectado ao Ollama. A documentação do Ollama recomenda um modelo local configurado com um contexto de 64k tokens ou mais.
A documentação de Ollama também descreve uma configuração manual por variáveis de ambiente, que aponta o Claude Code para o servidor local de Ollama na porta 11434. O exemplo oficial usa o modelo qwen3.5, cuja tag padrão na biblioteca Ollama corresponde à versão 9B, de 6,6 a 7,6 GB; um modelo precisa suportar chamada de ferramentas para que o Claude Code possa ler e modificar arquivos.
O Claude Code é grátis?+
É preciso ter Node.js para instalar o Claude Code?+
É preciso ter direitos de administrador para instalar o Claude Code no Windows?+
Como instalar um plugin no Claude Code?+
Como configurar bem o Claude Code após a instalação?+
O Claude Code funciona offline?+
Como atualizar o Claude Code?+
#Fontes e verificação de 18 de novembro de 2026
Os comandos, pré-requisitos, versões e preços deste guia foram levantados em 18 de novembro de 2026 na documentação oficial do Claude Code, na página de preços da Anthropic, no changelog do repositório da Anthropic no GitHub e na documentação do Ollama; comandos e preços mudam com frequência, então verifique-os antes de uma instalação corporativa.
- Fonte: instalação avançada do Claude Code (Anthropic)
- Fonte: início rápido do Claude Code (Anthropic)
- Fonte: solução de problemas de instalação (Anthropic)
- Fonte: extensão do VS Code (Anthropic)
- Fonte: preços dos planos do Claude (Anthropic)
- Fonte: changelog do Claude Code (GitHub, Anthropic)
- Fonte: Claude Code com Ollama (documentação da Ollama)
Um comentário, um erro ou uma observação? Avise-nos; isso ajuda a melhorar o guia para todos.