Instalar e atualizar o Claude Code CLI: Mac, Linux, Windows

Instalar o Claude Code é um comando por plataforma – curl -fsSL https://claude.ai/install.sh | bash no macOS, Linux e WSL, ou irm https://claude.ai/install.ps1 | iex no Windows PowerShell – e a atualização é automática (o padrão) ou um único claude update. O que a maioria das páginas deixa de fora é tudo o que vem depois desse primeiro comando: qual método de instalação escolher quando existem quatro, como o autoupdater se comporta e como desligá-lo, como fixar uma versão específica e como desinstalar cada método sem deixar sobras. Esta página é essa referência, uma tabela por tarefa, atualizada até a v2.1.224 (agosto de 2026).¹

TL;DR

• Use o instalador nativo. Ele não tem dependência de Node.js, entrega o binário testado de cada plataforma e é o padrão desde a v2.1.113. O pacote npm é o caminho legado – descontinuado desde a v2.1.15 e hoje exige Node.js 22 ou superior.¹
• As atualizações são automáticas por padrão: o Claude Code verifica na inicialização e periodicamente durante as sessões, baixa em segundo plano e aplica na próxima abertura. claude update força uma agora.²
• Desligar as atualizações envolve dois interruptores diferentes: DISABLE_AUTOUPDATER=1 interrompe as atualizações em segundo plano; DISABLE_UPDATES=1 (v2.1.118+) bloqueia todos os caminhos de atualização, inclusive um claude update manual.²
• Fixe uma versão passando-a para o instalador: curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58. Confira o que está rodando com claude --version; veja o que mudou com /release-notes.¹²
• Quando algo sair do esperado, rode claude doctor – ele informa o tipo de instalação, a versão e os problemas detectados, e desde a v2.1.205 o /doctor dentro da sessão diagnostica e corrige falhas de configuração.²

Como instalar o Claude Code CLI?

Um comando, por plataforma:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# 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

Prefere um gerenciador de pacotes? Os dois são caminhos de primeira classe:

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

Depois, rode claude no diretório de um projeto e faça a autenticação com uma assinatura Claude Pro/Max/Team ou uma conta da API da Anthropic.¹ O instalador nativo não precisa de Node.js, nem de sudo, nem de nada pré-instalado. Se você precisar usar o caminho legado do npm (npm install -g @anthropic-ai/claude-code), ele exige Node.js 22 ou superior e nunca deve ser executado com sudo: módulos globais pertencentes ao root criam problemas de permissão que sobrevivem à instalação.¹ Já está no npm? O claude install migra você para o binário nativo ali mesmo.

Para a configuração da primeira sessão – escolhas de autenticação, o primeiro prompt, os modos de permissão –, o passo a passo de início rápido cobre o caminho do zero ao primeiro resultado.

Quais plataformas o Claude Code suporta?

A pergunta que sempre volta sobre o Windows: o Windows nativo funciona e não exige direitos de administrador; a orientação da própria Anthropic é escolher pelo lugar onde ficam os seus projetos e pelo que você precisa, com o WSL 2 quando você quer toolchains Linux ou execução de comandos em sandbox, e o mesmo instalador do Linux roda dentro dele.³ O modo automático do Claude Code não é uma fronteira de segurança defende que o isolamento do sistema operacional, e não o modo automático, é a fronteira real.

Como atualizar o Claude Code?

Na maior parte do tempo, você não precisa fazer nada. O Claude Code se atualiza sozinho por padrão – ele procura uma versão nova na inicialização e periodicamente durante as sessões, baixa em segundo plano e aplica a atualização na próxima vez que abre.² Para forçar uma atualização imediata, ou caso você tenha desativado o autoupdater:

claude update

Instalações feitas por gerenciador de pacotes se atualizam pelo canal delas – brew upgrade --cask claude-code, winget upgrade Anthropic.ClaudeCode – e, desde a v2.1.129, definir CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 faz com que essas instalações rodem a atualização do gerenciador em segundo plano e peçam um reinício.²

Controlar as atualizações são dois interruptores distintos, e a diferença pesa em ambientes travados:

Defina qualquer um dos dois como variável de ambiente ou dentro de "env" no settings.json.²

Como instalar uma versão específica?

Passe a versão para o instalador – útil para reproduzir um bug, segurar um time em um release comprovadamente bom ou voltar atrás:

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Confirme com claude --version e leia o que cada release mudou no seletor /release-notes dentro da sessão.² Se você fixar uma versão, combine isso com DISABLE_AUTOUPDATER=1: caso contrário, o autoupdater vai gentilmente desfazer a fixação na próxima abertura. (Use DISABLE_UPDATES=1 quando também quiser deixar o claude update manual bloqueado.)

Como desinstalar o Claude Code?

Faça a desinstalação combinar com o método de instalação:

Sua configuração fica separada, em ~/.claude/, então remover o binário não apaga ajustes, skills nem histórico – apague esse diretório também apenas se quiser realmente começar do zero.¹

Todo o ciclo de vida em uma tabela

E quando algo está errado – versão errada informada, comando não encontrado depois de uma atualização, uma instalação aplicada pela metade –, o claude doctor no shell informa o tipo de instalação, a versão e os problemas detectados, enquanto o /doctor dentro de uma sessão (v2.1.205+) faz uma revisão completa capaz de corrigir o que encontra.² O guia completo do Claude Code cobre tudo o que vem depois da instalação: configuração, permissões, hooks, MCP e subagentes.

Solução de problemas no Windows: claude não reconhecido, shell errado, scripts bloqueados

A maioria das falhas no Windows se encaixa em um de nove casos, cada um com uma mensagem de erro reconhecível. Todas as correções abaixo vêm da página de solução de problemas de instalação e da página de configuração da Anthropic, na versão de 7 de setembro de 2026.³⁴

1. 'claude' is not recognized as an internal or external command (CMD) ou The term 'claude' is not recognized as the name of a cmdlet (PowerShell). O instalador colocou o claude.exe em %USERPROFILE%\.local\bin\claude.exe; esse diretório não está no seu PATH, ou você ainda está no terminal em que fez a instalação, que mantém o PATH antigo. Verifique, adicione e depois abra um terminal novo:⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

No CMD, a verificação é echo %PATH% | findstr /i "local\bin", e a correção é adicionar %USERPROFILE%\.local\bin ao PATH do usuário em Variáveis de Ambiente.⁴

2. 'irm' is not recognized, The token '&&' is not a valid statement separator ou A parameter cannot be found that matches parameter name 'fsSL'. Você rodou a linha de instalação de outro shell. Se o irm não existe, você está no CMD (o prompt mostra C:\): use o instalador do CMD acima ou abra o PowerShell (PS C:\). Se o && é rejeitado, você está no PowerShell rodando a linha do CMD: use irm https://claude.ai/install.ps1 | iex. A reclamação sobre fsSL significa que você colou a linha curl -fsSL ... | bash do macOS/Linux no PowerShell, onde curl é um alias de Invoke-WebRequest. Se o comando imprime o texto do script e não instala nada, você rodou a parte do download sem a parte que o executa.⁴

3. running scripts is disabled on this system / PSSecurityException. A política de execução do PowerShell está bloqueando os shims de inicialização .ps1 que o npm cria (npm.ps1, claude.ps1). Ela não afeta o instalador nativo, que executa o texto baixado via iex em vez de um arquivo salvo, e rodar um ClaudeInstall.ps1 salvo com -ExecutionPolicy Bypass -File não é um dos caminhos de instalação documentados pela Anthropic (a página de configuração lista apenas a linha irm, o instalador do CMD, o WinGet e o npm). As correções, nesta ordem: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser; ou chamar claude.cmd (a política não cobre .cmd); ou trocar a instalação via npm pelo instalador nativo.⁴

4. Erros de análise do iex que citam tags HTML ou CSS, ou curl: (22) The requested URL returned error: 403. A URL de instalação devolveu uma página web em vez do script. Se a página diz “App unavailable in region”, o Claude Code não é oferecido no seu país; caso contrário, há um proxy ou filtro no caminho. Teste o acesso com curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest (chame curl.exe explicitamente; o alias curl do PowerShell rejeita -sI): uma primeira linha 200 significa que o host está acessível e que a falha foi passageira. winget install Anthropic.ClaudeCode é a alternativa documentada.⁴

5. Could not establish trust relationship for the SSL/TLS secure channel ou CRYPT_E_NO_REVOCATION_CHECK (0x80092012). No primeiro caso, force o TLS 1.2 antes do instalador: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Os erros de revogação significam que a sua rede bloqueia as consultas de revogação de certificados; acrescente --ssl-revoke-best-effort à linha curl do CMD ou use o instalador do PowerShell, que baixa pelo .NET e tolera um servidor de revogação inacessível.⁴

6. The process cannot access the file ... because it is being used by another process. Um instalador anterior ainda está rodando ou o antivírus está verificando um download parcial em %USERPROFILE%\.claude\downloads. Feche as outras janelas do PowerShell, espere a verificação terminar e então:⁴

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

7. Roda a versão errada, ou duas instalações não batem. where.exe claude lista todos os claude do seu PATH; Test-Path "$env:USERPROFILE\.local\bin\claude.exe" diz se o instalador nativo colocou o binário dele. Fique com o nativo e remova os demais (winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code, Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" para uma instalação local legada via npm). O claude doctor mostra o tipo de instalação e a versão que está de fato rodando.⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Nenhum dos dois shells foi encontrado. O Git for Windows é opcional: sem ele, o Claude Code roda os comandos pela ferramenta PowerShell; com ele, a ferramenta Bash usa o Git Bash. Se o Git Bash está instalado mas não é encontrado, aponte para ele no settings.json:³

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

9. Claude Code does not support 32-bit Windows. Você abriu a entrada x86 do PowerShell em uma máquina de 64 bits. Abra o “Windows PowerShell”, não o “(x86)”.⁴

Se nenhum desses casos corresponder, o claude doctor (somente leitura, sem iniciar sessão) informa a saúde da instalação, os erros nos arquivos de configuração e o resultado da última tentativa de atualização, e a página de solução de problemas da Anthropic mantém a tabela completa de erros e correções.³⁴

Perguntas frequentes

Como atualizo o Claude Code CLI para a versão mais recente?

Rode claude update ou simplesmente reinicie: por padrão, o Claude Code procura atualizações na inicialização e durante as sessões, baixa em segundo plano e aplica na próxima abertura. Instalações por Homebrew e winget se atualizam por brew upgrade --cask claude-code e winget upgrade Anthropic.ClaudeCode.

O Claude Code se atualiza automaticamente?

Sim, por padrão: ele verifica na inicialização e periodicamente enquanto roda, e depois aplica a atualização baixada na abertura seguinte. DISABLE_AUTOUPDATER=1 desliga as atualizações em segundo plano e mantém o claude update manual; DISABLE_UPDATES=1 bloqueia todos os caminhos de atualização.

Como instalo o Claude Code no Windows?

Rode irm https://claude.ai/install.ps1 | iex no PowerShell (ou winget install Anthropic.ClaudeCode). O Windows 10 (1809+) nativo é suportado em x64 e ARM64 sem direitos de administrador; escolha o WSL 2 quando precisar de toolchains Linux ou de execução de comandos em sandbox, e rode o comando de instalação do Linux dentro dele para ter paridade total com o Linux.

Preciso de Node.js para instalar o Claude Code?

Não – o instalador nativo recomendado não tem dependência de Node.js. Só o pacote npm legado (npm install -g @anthropic-ai/claude-code, descontinuado desde a v2.1.15) precisa de Node, e ele exige Node.js 22 ou superior. Se você está na instalação por npm, o claude install migra você para o binário nativo.

Como vejo qual versão do Claude Code eu tenho?

claude --version no shell, ou /release-notes dentro de uma sessão para um seletor interativo de changelog. O claude doctor informa ainda o tipo de instalação e qualquer problema de configuração detectado.