Resumo Rápido: Desinstalar o Claude Code requer passos diferentes dependendo do seu método de instalação (instalador nativo, npm ou Homebrew). Para desinstalar uma instalação nativa, execute o comando `claude uninstall` no seu terminal (disponível em Windows, macOS e Linux). Todos os métodos exigem a remoção manual de arquivos de configuração de `~/.claude/` para garantir a remoção completa.
Precisa remover o Claude Code do seu sistema? O processo de desinstalação não é tão simples quanto deveria ser. O método varia drasticamente com base em como você originalmente instalou a ferramenta.
Aqui está o que torna isso complicado: o Claude Code pode ser instalado através de instaladores nativos, npm, Homebrew ou outros gerenciadores de pacotes. Cada método deixa artefatos diferentes.
Identifique Seu Método de Instalação Primeiro
Antes de desinstalar, determine como o Claude Code foi instalado no seu sistema. Execute este comando no seu terminal:
| claude --version |
Verifique estes locais comuns de instalação:
- Instalador nativo (Windows): Arquivos de Programas ou AppData
- Instalador nativo (macOS): Pasta Aplicativos
- Instalação npm: `~/.npm-global/bin/`
- Homebrew: `/usr/local/bin/` ou `/opt/homebrew/bin/`
Desinstalar via Instalador Nativo
Para instalações do Windows usando o script PowerShell (irm claude.ai/install.ps1 | iex), o processo difere das aplicações padrão.
Windows 10/11:
- Abra Configurações > Aplicativos > Aplicativos instalados
- Procure por "Claude Code"
- Clique nos três pontos e selecione Desinstalar
- Confirme a remoção
macOS:
- Abra o Finder e navegue até Aplicativos
- Localize o Claude Code
- Arraste-o para o Lixo ou clique com o botão direito e selecione Mover para o Lixo
- Esvazie o Lixo para completar a remoção
De acordo com os problemas do GitHub (#6920), alguns usuários relatam que o instalador nativo do Windows carece de documentação de desinstalação. Se o Claude Code não aparecer na sua lista de aplicativos padrão, você precisará de métodos de remoção alternativos.
Remover via Gerenciadores de Pacotes
Para instalações npm, execute estes comandos:
| npm uninstall -g @anthropic-ai/claude-code rm -f $HOME/.npm-global/bin/claude |
Para Homebrew no macOS:
| brew uninstall --cask claude-code |
Discussões da comunidade no Reddit confirmam que instalações de gerenciadores de pacotes frequentemente deixam arquivos de configuração para trás. O comando de desinstalação remove o binário, mas não suas configurações.
Excluir Arquivos de Configuração
Este passo é crítico. O desinstalador não remove seus arquivos de configuração, o que pode causar problemas se você reinstalar mais tarde.
Remova estes diretórios e arquivos manualmente:
| rm -rf ~/.claude/ rm ~/.claude.json rm -rf ~/.local/share/claude rm -f $HOME/.local/bin/claude rm -rf $HOME/.bun/bin/../install/global/node_modules/@anthropic-ai |
No Windows, exclua estas pastas:
- %USERPROFILE%\.claude\
- %APPDATA%\Claude\
- %LOCALAPPDATA%\Claude\
Verificar Remoção Completa
Após desinstalar, confirme que o Claude Code foi removido:
| which claude claude --version |
Ambos os comandos devem retornar "command not found" ou erros semelhantes. Se ainda executarem, verifique sua variável PATH em busca de referências remanescentes.
Obtenha Créditos de IA e Descontos de Software em um Só Lugar
Se você ainda está trabalhando com ferramentas de IA após remover o Claude Code, o Get AI Perks pode ser um próximo passo prático. Ele coleta créditos de startups e descontos de software para ferramentas de IA e nuvem em um só lugar. Ele oferece aos fundadores acesso a mais de 200 vantagens, incluindo ofertas de Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom e outros. A plataforma também inclui condições de vantagens, orientação de aprovação e instruções passo a passo para reivindicar cada oferta.
Procurando Créditos de Claude ou Anthropic?
Verifique o Get AI Perks para:
- encontrar créditos e descontos de ferramentas de IA em um só lugar
- revisar as condições das vantagens antes de aplicar
- acessar guias para reivindicar ofertas de startups
👉 Visite Get AI Perks para navegar pelas vantagens disponíveis de Claude, Anthropic e outros softwares de IA.
Problemas Comuns de Desinstalação
Com base no relatório de bug do GitHub #11789, alguns usuários no Linux relataram não conseguir desinstalar sem uma conta paga ativa, embora isso pareça ser um problema específico da plataforma.
Se você enfrentar este problema, ignore o desinstalador padrão e exclua manualmente os arquivos e diretórios da aplicação listados acima. Isso remove o Claude Code sem exigir autenticação.
Outro problema: servidores e plugins MCP desativados permanecem no seu sistema. Para remover servidores MCP, use o comando `claude mcp remove [nome-do-servidor]`.
FAQs
Preciso de uma conta ativa para desinstalar o Claude Code?
Não. Embora alguns usuários do Linux tenham relatado erros de autenticação ao usar 'claude uninstall', a exclusão manual de arquivos remove o Claude Code sem verificação de conta. Exclua os arquivos da aplicação e os diretórios de configuração diretamente.
A desinstalação removerá as configurações do meu projeto?
A remoção manual de `~/.claude/` excluirá as configurações de escopo do usuário. No entanto, diretórios `.claude/` de nível de projeto confirmados no git não são excluídos automaticamente e devem ser removidos manualmente.
Posso reinstalar após desinstalar?
Absolutamente. A reinstalação funciona normalmente após a remoção completa. A remoção de arquivos de configuração garante uma instalação limpa sem conflitos de configurações anteriores.
O que acontece com os servidores MCP após a desinstalação?
Servidores MCP persistem em sua configuração mesmo quando desativados. Exclua manualmente a configuração MCP de `~/.claude/` para removê-los completamente, pois a interface do usuário não fornece uma opção de desinstalação.
O Windows requer direitos de administrador para desinstalar?
Normalmente sim, especialmente para instalações em todo o sistema. Instalações de nível de usuário podem não exigir elevação, mas a limpeza de configuração em diretórios do sistema precisa de acesso de administrador.
Como desinstalo no WSL2?
Instalações WSL2 seguem procedimentos de desinstalação do Linux. Use o método do gerenciador de pacotes ou remova manualmente os arquivos do sistema de arquivos Linux, não do lado do Windows.
Por que a desinstalação não remove todos os arquivos?
Desinstaladores padrão preservam dados de configuração do usuário para possível reinstalação. Esta é uma prática comum, mas requer limpeza manual para remoção completa.
