Para atualizar o Claude Code, utilize os comandos adequados para seu ambiente e método de instalação. Verifique a versão atual após a conclusão com claude --version.
Métodos de Atualização por Sistema Operacional
| Ambiente | Método de Instalação | Comando de Atualização |
|---|---|---|
| Windows/Linux | npm | npm install -g @anthropic-ai/claude-code@latest |
| Windows/Linux | pip | pip install --upgrade claude-code |
| Linux/macOS | Homebrew | brew update claude-code |
| Linux/macOS | Cargo | cargo install --force claude-code |
Passos Detalhados para Cada Plataforma
Windows
Se instalado via npm, execute:
npm install -g @anthropic-ai/claude-code@latest
# Ou use o comando integrado
claude update
Se instalado via pip:
pip install --upgrade claude-code
Linux
Para atualizações via npm:
npm install -g @anthropic-ai/claude-code@latest
claude update
Via pip:
pip install --upgrade claude-code
Com Homebrew:
brew update claude-code
Usando Cargo:
cargo install --force claude-code
Verificação da Versão
Após a atualização, confirme com:
claude --version
A saída pode ser semehlante a: 2.1.80 (Claude Code)
Considerações Importantes
- Privilégios de Administrador: Atualizações globais com npm ou pip podem exigir
sudono Linux ou execução como administrador no Windows. - Ambiente do Terminal: Reinicie o terminal ou recarregue as variáveis de ambiente após a atualização.
- Conexão de Rede: Certifique-se de acesso à internet para baixar pacotes dos repositórios oficiais.
- Backup de Configurações: Arquivos como
settings.jsongeralmante são preservados, mas faça backup de configurações críticas.
Resolução de Problemas Comuns
Falha na Atualização via npm
npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest
Falha na Atualização via pip
pip install --upgrade --user claude-code
Problemas de Permissão
No Linux/macOS, use sudo:
sudo npm install -g @anthropic-ai/claude-code@latest
No Windows, abrra o PowerShell como administrador.
Usando Espelhos Locais para npm
# Configuração temporária
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
# Configuração permanente (opcional)
npm config set registry https://registry.npmmirror.com
# Reverter para o repositório oficial após a instalação
npm config set registry https://registry.npmjs.org