Como atualizar o Claude Code para a versão mais recente em 2026

O Claude Code muda quase todos os dias. Abre o changelog mais recente e encontra novos comandos, erros corrigidos e melhorias de velocidade. Entretanto, o seu terminal está a executar uma versão de há duas semanas, e metade dessas melhorias simplesmente não funciona. O Claude também não lhe diz: arranca como de costume, e fica a perguntar-se porque é que outras pessoas têm uma funcionalidade que você não tem.

Vou explicar como verificar a sua versão, atualizá-la para a mais recente e o que fazer se a atualização não for instalada. Os comandos são reproduzidos literalmente da documentação oficial do Claude Code e foram verificados no início de setembro de 2026. Nessa altura, a versão mais recente publicada era a 2.1.261, mas o seu número será diferente. Não vale a pena perseguir um número específico — o importante é simplesmente ter uma versão recente.

As informações sobre como trabalhar com o Ailoot estão disponíveis na documentação.

Como atualizar rapidamente o Claude Code para a versão mais recente?#

Explico cada caso em pormenor abaixo, mas, se tiver pouco tempo, aqui estão três comandos que cobrem quase todas as situações.

claude --version   # which version is installed now
claude update      # update immediately (native installation)
claude doctor      # check the installation and updates

O primeiro mostra a sua versão, o segundo atualiza-a e o terceiro diagnostica problemas se algo correr mal. Abaixo, explico quando utilizar cada um e porque é que claude update não funciona para algumas pessoas.

Como verificar que versão do Claude Code está atualmente instalada?#

Antes de atualizar, convém saber a partir de que versão está a atualizar. O comando é simples:

claude --version

Obterá uma linha como 2.1.211 (Claude Code). Essa é a sua versão atual. Compare os dois primeiros números com o número mais recente no changelog — se o seu for muito inferior, está na altura de atualizar.

Se quiser uma visão mais abrangente, execute claude doctor. Este comando limita-se a verificar e não altera nada: não inicia uma sessão, mas mostra o estado da instalação, erros no ficheiro de definições e avisos com sugestões prontas a utilizar sobre o que deve corrigir. Também mostra o resultado da última tentativa de atualização automática — útil quando suspeita que a atualização em segundo plano falhou silenciosamente.

O Claude Code atualiza-se automaticamente?#

Tudo depende da forma como instalou o Claude Code. A instalação nativa — recomendada pela Anthropic e efetuada pelo script do site — pode atualizar-se automaticamente, e a documentação afirma-o explicitamente.

Funciona assim: o Claude Code verifica se há atualizações ao iniciar e periodicamente enquanto está em execução. Se encontrar uma nova versão, transfere-a e instala-a em segundo plano, aplicando-a na próxima vez que o iniciar. Basta fechar e voltar a abrir a sessão de dois em dois dias, e ficará novamente com a versão mais recente.

Pode verificar como correu a última tentativa em segundo plano com o mesmo comando claude doctor. Este mostra se a atualização não foi instalada por algum motivo.

Mas, se instalou o Claude Code através de um gestor de pacotes — Homebrew num MacBook, WinGet no Windows, apt ou dnf no Linux — não há atualizações em segundo plano. Estas instalações são atualizadas com o comando de atualização habitual; há uma secção separada sobre isso abaixo.

Uma versão recente do Claude Code é uma base, mas não basta por si só. Os resultados consistentes não dependem da versão da ferramenta, mas da forma como trabalha com ela.

Como atualizar manualmente o Claude Code com um único comando?#

Não precisa de esperar pela verificação em segundo plano para detetar uma nova versão. Há um comando que a atualiza imediatamente:

claude update

Há dois resultados possíveis. Se for encontrada e instalada uma atualização, o Claude Code apresentará uma linha como Successfully updated from <old version> to version <new version>. Se já tiver a versão mais recente, verá Claude Code is up to date (<version>) — isso significa que não há nada para atualizar.

Há uma particularidade neste comando quando se utilizam gestores de pacotes. Se o Claude Code foi instalado através do Homebrew, do WinGet ou do apk, claude update apresenta uma resposta mais curta — Claude is up to date! — e nem sempre obtém a nova versão por si só. Para estas instalações, é mais fiável utilizar o próprio comando de atualização do gestor de pacotes, descrito abaixo.

Como atualizar o Claude Code instalado através do Homebrew ou do WinGet?#

Se instalou o Claude Code através de um gestor de pacotes em vez do script do site, fica a seu cargo atualizá-lo. Eis os comandos para cada sistema.

No macOS com Homebrew:

brew upgrade claude-code

O Homebrew oferece duas opções. Instala o Claude Code em duas variantes. A variante claude-code acompanha o canal estável — uma versão com cerca de uma semana que ignora lançamentos com problemas graves. A variante claude-code@latest recebe a versão mais recente assim que é lançada. Atualize a variante que instalou: se tiver claude-code@latest, o comando será brew upgrade claude-code@latest.

No Windows com WinGet:

winget upgrade Anthropic.ClaudeCode

Com o WinGet, a atualização por vezes falha enquanto o Claude Code está em execução porque o Windows está a utilizar o ficheiro executável. O Claude Code apresenta simplesmente o comando manual; feche-o e execute novamente a atualização.

No Linux com apt, dnf ou apk, não há um comando separado para aprender — a versão mais recente chega com a atualização normal do sistema, porque o Claude Code publica repositórios assinados.

Se não quiser ter de se lembrar disto, existe a variável de ambiente CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Defina-a como 1, e o Claude Code executará a atualização em segundo plano com o Homebrew e o WinGet, sugerindo depois que reinicie após uma atualização bem-sucedida. A documentação inclui uma ressalva: por vezes, o Claude Code avisa-o de uma nova versão antes de esta estar efetivamente disponível no gestor de pacotes. Se a atualização não encontrar uma nova versão, espere um pouco e tente novamente.

A propósito, se ainda está a decidir como instalar o Claude Code, há um guia detalhado num artigo separado sobre como instalar o Claude Code — incluindo os motivos pelos quais o instalador nativo é mais prático do que os gestores de pacotes.

Porque é que o Claude Code não atualiza e o que deve fazer?#

Por vezes, atualiza repetidamente, mas claude --version continua teimosamente a mostrar o número antigo. Vou abordar as principais causas, começando pela mais comum.

A primeira coisa a verificar é se tem várias instalações do Claude Code ao mesmo tempo. Isto pode acontecer se o instalou primeiro através do npm e depois voltou a instalá-lo de forma nativa. O comando atualiza uma cópia, mas o terminal inicia outra, pelo que parece que a versão não mudou. Verifique quantas cópias tem:

which -a claude

O Claude Code pode estar em três locais: ~/.local/bin/claude é o instalador nativo, ~/.claude/local/ é a antiga instalação local do npm das primeiras versões e o pacote global do npm é apresentado pelo comando npm -g ls @anthropic-ai/claude-code. Se encontrar mais do que uma cópia, mantenha apenas uma — de preferência, a instalação nativa. Remova as restantes assim:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

A segunda causa comum é uma pasta global do npm que não permite escrita. Se instalou o Claude Code globalmente com o npm e este não tem permissão para escrever na pasta, a atualização em segundo plano não será instalada. O Claude Code apresenta uma notificação única ao iniciar, e claude doctor indica exatamente o que deve corrigir. Esse é mais um motivo para preferir a instalação nativa: escreve na sua pasta pessoal e não exige essas permissões.

A terceira situação é ter substituído anteriormente o iniciador ~/.local/bin/claude por um script ou uma ligação simbólica sua. A partir da versão 2.1.207, as atualizações automáticas deixam esse iniciador intacto: as novas versões continuam a ser instaladas na pasta ~/.local/share/claude/versions/, mas é o seu script que decide qual delas iniciar. Não elimine o único iniciador para chamar depois claude update pelo nome. Preserve primeiro o iniciador personalizado e, tratando-se de ligação simbólica, o destino, num local de cópia separado e ainda não usado. Só retire o iniciador do caminho original depois de verificar a cópia. Reponha o iniciador nativo com o instalador oficial, que não depende de um comando claude existente:

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

Depois da instalação, abra um terminal novo e verifique:

claude --version
claude doctor

O primeiro comando deve apresentar uma versão. Examine avisos de iniciador ou PATH no doctor antes de continuar; não elimine o iniciador preservado enquanto o substituto não funcionar.

Outro sintoma é quando claude update ou claude doctor fica bloqueado imediatamente depois da linha Checking for updates. Nas versões mais antigas (anteriores à 2.1.214), isto acontecia por vezes quando um dos ficheiros de configuração da shell, como ~/.zshrc, era uma pasta em vez de um ficheiro. As versões recentes já ignoram esse caso, por isso atualizar para a versão mais recente também corrige o erro.

Como escolher um canal de atualização: latest ou stable?#

Atualizar para a versão mais recente nem sempre significa obter a versão mais nova logo no primeiro dia. O Claude Code permite-lhe escolher entre dois canais, o que determina exatamente o que recebe quando atualiza.

O canal latest é o predefinido. As novas funcionalidades chegam assim que são lançadas, o que é útil se quiser experimentá-las primeiro. O canal stable disponibiliza uma versão com cerca de uma semana: teve tempo para estabilizar e ignora lançamentos com problemas graves. É a escolha de quem dá mais valor à tranquilidade do que à rapidez.

A forma mais fácil de mudar de canal é utilizar o comando /config dentro do Claude Code, em Auto-update channel. Também pode introduzir a definição manualmente no ficheiro settings.json:

{
  "autoUpdatesChannel": "stable"
}

Se estiver a configurar o Claude Code de acordo com os seus hábitos, há um guia separado sobre como personalizar o Claude Code — aborda o ficheiro de definições por inteiro, e não apenas o canal de atualização.

Como instalar uma versão específica ou definir uma versão mínima?#

Por vezes, precisa de uma versão específica em vez da mais recente — por exemplo, para voltar a uma versão em que o seu fluxo de trabalho funcionava certamente. O instalador nativo permite fazê-lo: aceita tanto o nome de um canal como um número de versão exato. Instale uma versão específica assim:

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

No Windows, o equivalente em PowerShell é ligeiramente diferente:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Pode instalar o canal stable da mesma forma — escreva stable em vez de um número. O canal que escolher durante a instalação passa a ser o canal predefinido para futuras atualizações automáticas.

Se quiser proteção contra regressões para uma versão mais antiga, defina uma versão mínima em settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Este é o limite inferior. Nem uma atualização em segundo plano nem claude update instalarão uma versão inferior à especificada. Isto é útil quando muda para stable e não quer regressar a uma versão mais antiga do que aquela que já está a utilizar.

Como desativar as atualizações automáticas se atrapalharem?#

Por vezes, as atualizações em segundo plano atrapalham — por exemplo, quando quer manter a sua equipa exatamente na mesma versão. Pode desativá-las através do ficheiro de definições:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Um pormenor importante: DISABLE_AUTOUPDATER silencia apenas a verificação em segundo plano. O comando claude update continuará a funcionar, pelo que ainda poderá atualizar manualmente. Se precisar de bloquear todas as formas de atualização de uma só vez, incluindo as manuais, existe uma variável mais restritiva, DISABLE_UPDATES. É utilizada quando distribui o Claude Code através do seu próprio canal e quer que as pessoas mantenham exatamente a versão que disponibilizou.

Para uma utilização normal a título pessoal, é melhor não alterar estas variáveis: uma versão recente do Claude Code é quase sempre melhor do que uma antiga, e uma atualização pode incluir uma correção de segurança. Manter a ferramenta atualizada faz parte de preservar o acesso e evitar erros estranhos; um artigo separado explica como evitar perder a sua conta Claude.

Por onde deve começar?#

Eis um plano breve.

1. Verifique a sua versão atual: claude --version. Compare-a com o número mais recente no changelog.
2. Atualize. Instalação nativa — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. Reinicie a sessão do Claude Code para que a nova versão entre em vigor.
4. Se a versão não tiver mudado, execute claude doctor e which -a claude. Provavelmente tem várias instalações ou uma pasta do npm que não permite escrita.
5. Escolha o canal mais adequado para si: latest se quiser funcionalidades novas assim que chegam ou stable se a previsibilidade for mais importante. Altere-o através de /config.

Uma versão recente corrige erros e acrescenta novos comandos, mas uma ferramenta atualizada não construirá o seu projeto por si. O guia sobre alternativas ao Claude Code explica em que difere o Claude Code de outros agentes de terminal e quando faz sentido considerar alternativas.

Conheça o Ailoot.