Guia de campo do Claude Code em português

Como atualizar o Claude Code no Windows, no Mac e no Linux

O Claude Code que você instalou hoje não é o mesmo da semana que vem: entre 24/09 e 15/10/2026 saíram dezoito versões, com cerca de 1.600 itens de mudança (p. 107). Quem atualiza o programa depende de como você o instalou. Abaixo, como descobrir o seu caso, o comando de cada um e as armadilhas do Windows.

Primeiro: como você instalou?

Rode claude doctor no terminal, fora de uma sessão. A linha Running diz o método (native, por exemplo), e outras três dizem se a atualização automática está ligada, qual canal ela segue e o resultado da última tentativa (p. 108 e 110).

PowerShell

claude doctor
# Running: native (2.1.301)
# Auto-updates: enabled
# Auto-update channel: latest
# Last update attempt: ...

Dentro de uma sessão o comando é /doctor, que também conserta; o claude doctor só diagnostica.

O comando de cada jeito de instalar

Como instalou	Quem atualiza	O comando
Instalador nativo	O Claude Code, sozinho, em segundo plano	`claude update`
WinGet	Você	`winget upgrade Anthropic.ClaudeCode`
Homebrew (Mac)	Você	`brew upgrade claude-code` ou `brew upgrade claude-code@latest`
npm	O Claude Code, se a pasta global aceita escrita	`npm install -g @anthropic-ai/claude-code@latest`
apt (Debian, Ubuntu)	O sistema	`sudo apt update && sudo apt upgrade claude-code`

Só no nativo e no npm o Claude Code se atualiza por conta própria (p. 110). Pelo WinGet, pelo Homebrew ou pelos repositórios do Linux, ele avisa que há versão nova e você roda o comando. No npm, prefira o install -g ...@latest: o npm update -g respeita a faixa da instalação original e pode não chegar à mais nova.

O claude update responde "Successfully updated from <antiga> to version <nova>" quando instala, ou "Claude Code is up to date" quando você já está na mais nova (p. 108).

Atualizei e nada mudou

A versão nova só passa a valer na próxima vez que você abrir o Claude Code: a sessão aberta segue na antiga até o fim (p. 108). Feche e abra de novo. Para confirmar, claude --version.

WinGet: o aviso chega antes do pacote

O Claude Code pode anunciar a versão nova antes de ela entrar no WinGet ou no Homebrew. Em 15/10/2026, com a 2.1.301 já publicada, o winget show Anthropic.ClaudeCode oferecia a 2.1.295 (p. 110). Se o upgrade não acha nada, espere um ou dois dias. Se quiser que o Claude Code rode o winget upgrade por você, ligue a variável abaixo num terminal novo; como o Windows trava o executável em uso, o upgrade pode falhar com o programa aberto, e aí ele mostra o comando para você rodar depois de fechar.

PowerShell

[Environment]::SetEnvironmentVariable(
  'CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE', '1', 'User')

Duas armadilhas do Windows

Duas instalações, versão errada. Nativo e WinGet juntos fazem o claude abrir um enquanto o outro se atualiza. Get-Command claude -All lista os executáveis; fique com um só (p. 110).
"claude" não é reconhecido logo depois de atualizar. A troca do claude.exe falhou no meio, e o backup está ao lado, em %USERPROFILE%\.local\bin\claude.exe.old.*: renomeie o mais novo para claude.exe.

latest ou stable: receber na hora ou uma semana depois

O canal decide qual versão a atualização instala. latest, o padrão, traz cada versão no dia em que sai. stable traz uma versão de cerca de uma semana antes e pula as que tiveram regressão grave (p. 108). A escolha fica em /config → Auto-update channel. Quem usa o Claude Code no trabalho e não quer ser o primeiro a achar o defeito fica no stable. Um detalhe: modelo recém-lançado pode exigir versão mais nova que a do stable (p. 109).

Para fixar uma versão que funcionava, o instalador aceita um número: claude install 2.1.299. Para ela não mudar sozinha, desligue também a atualização automática com DISABLE_AUTOUPDATER; quem bloqueia até o claude update é DISABLE_UPDATES (p. 109 e 112). Parado não é seguro: versão travada também não recebe correção de segurança, então trave por um motivo e com data para soltar.

Ler o que mudou sem gastar contexto

Na sessão, /release-notes abre um seletor de versões; as notas aparecem na tela e não entram na conversa que o Claude vê (p. 111). Pedir ao Claude "leia o changelog inteiro" põe mais de um milhão de caracteres na janela. A rotina do guia: uma vez por semana, claude --version e o /release-notes da versão que chegou, olhando os itens que começam com Changed, misturados aos Fixed e Added (o /release-notes não os agrupa): é onde mora o que muda o seu dia.