Iniciante 14 minIDE

Instalar o Claude Code no Windows, Mac e Linux

Um notebook aberto ilumina uma mesa escura com luz verde.
Resposta direta

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.

Por Mohamed Meguedmi·Atualização 2026-11-20·Testado no Windows 11

#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.

Métodos de instalação do Claude Code por sistema (documentação da Anthropic, 18 de novembro de 2026)
SistemaMétodoCommandeAtualização automática
macOS, Linux, WSLScript nativo (recomendado)curl -fsSL https://claude.ai/install.sh | bashSim, em segundo plano
Windows (PowerShell)Script nativo (recomendado)irm https://claude.ai/install.ps1 | iexSim, em segundo plano
Windows (CMD)Script nativocurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdSim, em segundo plano
macOSHomebrewbrew install --cask claude-codeNão por padrão: brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCodeNão por padrão: winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu, Fedora, RHEL, AlpineRepositórios apt, dnf, apk assinadosVer a documentação oficialNão: atualização do sistema
Todos (Node.js 22 ou superior)npmnpm install -g @anthropic-ai/claude-code@latestDependendo das permissões da pasta do npm

#Configuração necessária

O kit completo para aproveitar a IA local no seu Mac.

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.

  1. 01
    Abrir o PowerShell
    Abra 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.
  2. 02
    Executar o script de instalação
    Cole 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.
  3. 03
    Abrir um novo terminal
    Feche 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.
  4. 04
    Verificar a versão
    Digite 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.
  5. 05
    Instalar 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.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows (WinGet)
winget install Anthropic.ClaudeCode
→
WSL 2 ou Windows nativo?
Escolha o Windows nativo para projetos e ferramentas do Windows. Escolha o WSL 2 se seus projetos usam ferramentas Linux ou se você quer o sandbox de comandos, que a documentação da Anthropic não oferece no Windows nativo nem no WSL 1. No WSL, instale e execute o claude pelo terminal do WSL, não pelo PowerShell.

#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.

macOS (Terminal, script nativo)
curl -fsSL https://claude.ai/install.sh | bash
macOS (Homebrew)
brew install --cask claude-code

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.

Linux (Ubuntu, Debian, Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

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.

Linux (Alpine)
apk add bash curl

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.

!
Instalação via npm: nunca com sudo
O método via npm exige Node.js 22 ou superior. A documentação da Anthropic desaconselha expressamente sudo npm install -g, que causa problemas de permissão e riscos de segurança, e esclarece que uma instalação que precisa de sudo não consegue se atualizar sozinha. O script nativo evita esse problema.
macOS, Linux, Windows (npm, Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#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.

macOS, Linux, Windows
claude --version
claude doctor

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.

  1. 01
    Acessar um projeto
    No 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.
  2. 02
    Iniciar o Claude Code
    Digite 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.
  3. 03
    Fazer uma primeira pergunta
    Depois 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.
  4. 04
    Preparar o projeto
    Digite /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.

macOS, Linux, WSL (desinstalação nativa)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#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.

Erros de instalação do Claude Code e correções (guia de solução de problemas da Anthropic, 18 de novembro de 2026)
Mensagem exibidaCausaCorreção
command not found: claude / 'claude' is not recognizedPasta de instalação ausente do PATHAdicionar ~/.local/bin (ou %USERPROFILE%\.local\bin) ao PATH e depois abrir um novo terminal
The token '&&' is not a valid statement separatorComando do CMD colado no PowerShellUsar o comando do PowerShell
'irm' is not recognized as an internal or external commandComando do PowerShell colado no CMDUsar o comando do CMD
curl: (22) The requested URL returned error: 403Proxy ou filtro de rede, ou país não compatívelVerificar a rede ou o proxy da empresa
App indisponível na regiãoPaís não suportado pela AnthropicO Claude Code não está disponível neste país
not found no Alpinebash ou curl absentsapk add bash curl
macOS (zsh): adicionar ~/.local/bin ao PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell): adicionar a pasta ao PATH do usuário
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

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.

i
Sem terminal: o aplicativo de desktop
A documentação da Anthropic também oferece o aplicativo de desktop do Claude para usar o Claude Code sem terminal, no macOS, Windows e Linux (versão beta no Linux). Ele exige a mesma conexão a uma conta paga do Claude.

#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.

macOS, Linux, Windows (com Ollama instalado)
ollama launch claude

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.

macOS, Linux (Bash ou Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Configuração não suportada pela Anthropic
A documentação do Claude Code informa que a Anthropic não oferece suporte ao uso do Claude Code com modelos que não sejam Claude por meio de um gateway. A conexão com Ollama funciona de acordo com a documentação de Ollama, mas qualquer problema é responsabilidade de Ollama, não do suporte da Anthropic. A qualidade depende muito do modelo local e da memória disponível.
Perguntas frequentes
O Claude Code é grátis?+
O programa Claude Code é instalado gratuitamente, mas usá-lo com os modelos Claude exige uma assinatura paga (Pro, Max, Ultra, Team, Enterprise) ou uma conta Console paga conforme o uso. Segundo a documentação da Anthropic consultada em 18 de novembro de 2026, o plano gratuito do claude.ai não inclui o Claude Code. A conexão a um modelo local via Ollama substitui os modelos Claude por um modelo da sua máquina, fora do suporte da Anthropic.
É preciso ter Node.js para instalar o Claude Code?+
Não, o Node.js não é mais necessário para instalar o Claude Code com o script nativo, Homebrew, WinGet ou os repositórios Linux. Apenas o método npm exige Node.js 22 ou superior, e a documentação esclarece que o programa instalado é um binário nativo que não usa o Node.js em tempo de execução. O script nativo continua sendo o método recomendado.
É preciso ter direitos de administrador para instalar o Claude Code no Windows?+
Não. A documentação da Anthropic indica que o comando de instalação do Claude Code é executado no PowerShell ou no CMD sem precisar rodar o terminal como administrador. O programa é instalado na pasta do usuário, em %USERPROFILE%\.local\bin.
Como instalar um plugin no Claude Code?+
Em uma sessão do Claude Code, o comando /plugin abre um painel que lista os plugins dos catálogos configurados, e /plugin install seguido do nome e do catálogo, por exemplo commit-commands@claude-plugins-official, abre a página de detalhes do plugin antes da instalação. A documentação da Anthropic lembra que um plugin pode executar hooks e servidores MCP: leia a página de detalhes dele antes de instalá-lo.
Como configurar bem o Claude Code após a instalação?+
Depois de instalar o Claude Code, execute /init no seu projeto para gerar um arquivo CLAUDE.md que descreve os comandos de compilação, de teste e as convenções. As configurações podem ser alteradas com /config ou no arquivo ~/.claude/settings.json. O comando claude doctor aponta arquivos de configuração inválidos e problemas de instalação.
O Claude Code funciona offline?+
Não. A documentação da Anthropic indica que uma conexão com a internet é obrigatória para usar o Claude Code, pois os modelos Claude rodam nos servidores da Anthropic. Com Ollama e um modelo local, as requisições ao modelo ficam na máquina, mas a documentação da Anthropic não descreve um funcionamento totalmente off-line: considere esse ponto como não garantido.
Como atualizar o Claude Code?+
Uma instalação nativa do Claude Code se atualiza sozinha, na inicialização e em segundo plano, e claude update força a atualização imediata. Por padrão, as instalações via Homebrew, WinGet, apt, dnf e apk não se atualizam sozinhas: use brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode ou a atualização do sistema Linux. No Homebrew e no WinGet, a variável CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 delega essa atualização ao 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.

Este guia ajudou você?

Um comentário, um erro ou uma observação? Avise-nos; isso ajuda a melhorar o guia para todos.