)` — 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?
O essencial
Os gestores de pacotes não atualizam o Claude Code automaticamente, por isso tem de executar o comando de atualização manualmente. Num MacBook com Homebrew, é brew upgrade claude-code. No Windows com WinGet, é winget upgrade Anthropic.ClaudeCode. No Linux com apt, dnf ou apk, a atualização é incluída na atualização normal do sistema. Se quiser que o próprio Claude Code execute a atualização com o Homebrew e o WinGet, defina a variável de ambiente CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE como one.
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:
```bash
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:
```powershell
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.
| Forma de instalação | Comando de atualização |
|----------------------|----------------|
| Instalador nativo | atualiza-se automaticamente ou `claude update` |
| Homebrew (macOS) | `brew upgrade claude-code` |
| WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` |
| apt / dnf / apk (Linux) | atualização normal do sistema |
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](https://ailoot.ai/blog/pt-pt/install-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?
O essencial
Normalmente, há três causas possíveis. Primeiro, tem várias instalações do Claude Code em conflito: o comando atualiza uma, mas é outra que é iniciada. Segundo, a pasta global do npm não permite escrita, por isso a atualização em segundo plano falha silenciosamente. Terceiro, pode ter substituído o iniciador por um script seu. Comece a resolução de problemas com claude doctor e o comando which -a claude; estes mostram exatamente onde está o problema.
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:
```bash
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:
```bash
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](https://code.claude.com/docs/en/setup#install-claude-code), que não depende de um comando `claude` existente:
```bash
# 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:
```bash
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?
O essencial
O Claude Code tem dois canais de atualização. Latest é o canal predefinido; as novas funcionalidades chegam assim que são lançadas. Stable é uma versão com cerca de uma semana que ignora lançamentos com problemas graves. Se as funcionalidades mais recentes forem importantes para si, mantenha-se no latest. Se a previsibilidade for mais importante e não quiser apanhar versões mal acabadas, mude para stable. Pode alterar esta opção através da definição autoUpdatesChannel no ficheiro settings.json ou do comando /config.
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`:
```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](https://ailoot.ai/blog/pt-pt/claude-personalization-profile-memory/) — 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?
O essencial
O instalador nativo aceita tanto o nome de um canal como um número de versão exato. Para instalar uma versão específica, acrescente o respetivo número no final do comando de instalação, por exemplo bash -s 2.1.89. Pode instalar o canal stable em vez de latest da mesma forma. Para impedir que as atualizações o façam recuar para uma versão inferior a determinado número, defina a opção minimumVersion em settings.json. Este é o limite inferior que nem as atualizações em segundo plano nem claude update ultrapassam.
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:
```bash
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
No Windows, o equivalente em PowerShell é ligeiramente diferente:
```powershell
& ([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`:
```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?
O essencial
Se não precisar das atualizações em segundo plano do Claude Code, desative-as com a variável DISABLE_AUTOUPDATER no bloco env do ficheiro settings.json. Esta variável interrompe apenas a verificação em segundo plano — o comando claude update continuará a funcionar se quiser atualizar manualmente. Se precisar de bloquear todas as formas de atualização, incluindo as manuais, utilize a outra variável, DISABLE_UPDATES. Isto é útil quando distribui o Claude Code à sua equipa e quer que todos mantenham a mesma versão.
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:
```json
{
"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](https://ailoot.ai/blog/pt-pt/claude-account-suspension-appeal/).
## Por onde deve começar?
O essencial
Comece por verificar a sua versão com claude --version e compare-a com o número mais recente no changelog. Se instalou o Claude Code de forma nativa, atualize com claude update e reinicie a sessão. Se o instalou através do Homebrew ou do WinGet, execute o comando de atualização do gestor de pacotes. Se a versão não mudar, execute claude doctor e which -a claude para verificar se há conflitos entre várias instalações. E escolha o canal a utilizar: latest para ter funcionalidades recentes, stable para ter tranquilidade.
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](https://ailoot.ai/blog/pt-pt/claude-code-alternatives/) explica em que difere o Claude Code de outros agentes de terminal e quando faz sentido considerar alternativas.
### Fontes
- [Claude Code - Configuração avançada, documentação oficial](https://docs.claude.com/en/docs/claude-code/setup) - atualizações automáticas para instalações nativas, o comando claude update, os canais latest e stable, as definições autoUpdatesChannel e minimumVersion, DISABLE_AUTOUPDATER e a instalação de uma versão específica
- [Claude Code - Resolução de problemas de instalação, documentação oficial](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - conflitos entre várias instalações, which -a claude, permissões da pasta npm, iniciadores personalizados e bloqueio do claude update
- [Claude Code - CHANGELOG no GitHub](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - lista de versões e alterações em cada versão; onde verificar o número mais recente
Conheça o [Ailoot](https://ailoot.ai/).
## Perguntas frequentes
### Porque continua claude update a iniciar o wrapper personalizado antigo?
O atualizador nativo preserva um iniciador personalizado, pelo que o wrapper continua a escolher o executável. Preserve o wrapper e o destino antes de reparar; use o instalador nativo documentado em vez de eliminar o único comando e o chamar logo a seguir.
### Como verifico que a recuperação do iniciador funcionou?
Abra um terminal novo e execute claude --version; deve apresentar uma versão. Execute depois claude doctor para inspecionar a instalação e os avisos do iniciador. Se o comando não existir, corrija PATH antes de continuar.
## Ailoot · A empresa e a sua carteira de projetos
A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.
A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.
A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.