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).¹ {.answer-block}

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, mas o WSL 2 entrega a experiência idêntica à do Linux, e o instalador nativo roda dentro dele exatamente do mesmo jeito.¹

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.

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+ nativo é suportado em x64 e ARM64, mas o WSL 2 é o caminho recomendado para paridade total com o Linux – rode o comando de instalação do Linux dentro dele.

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.