Desinstalar Claude Code, Codex CLI e OpenCode no Mac
Para desinstalar Claude Code, Codex CLI ou OpenCode do Mac, remova primeiro a instalação que você realmente tem e depois decida o que fazer com os dados. Um comando que não aparece e um histórico apagado são resultados diferentes. Preserve os dados se pode voltar à ferramenta ou ainda usa o app desktop ou a extensão do editor.
Decida o que manter
Copie configurações e conversas locais necessárias para um backup que você consiga abrir. Não presuma que entrar na conta restaura o histórico local. Para reduzir caches mantendo as ferramentas, veja a limpeza de ferramentas de programação com IA.
| Ferramenta | Dados padrão para revisar | O que pode ser perdido |
|---|---|---|
| Claude Code | ~/.claude e ~/.claude.json |
Configurações, permissões, configuração MCP e conversas |
| Codex CLI | ~/.codex |
Configuração local, conversas e login salvo em arquivos |
| OpenCode | ~/.local/share/opencode, ~/.config/opencode, ~/.cache/opencode |
Conversas, snapshots, credenciais de provedores, configuração e caches |
Os caminhos vêm da configuração do Claude Code, da configuração do Codex e dos locais de histórico, além das páginas de armazenamento e configuração do OpenCode. São locais para revisar, não uma lista de exclusão em lote.
Use o gerenciador que fez a instalação
Termine o trabalho e as conversas ativas. Para instalação por gerenciador de pacotes, use só a linha correspondente. Os nomes estão nas instruções do Claude, na lista de instalação da OpenAI e no guia do OpenCode. npm uninstall com a opção global remove um pacote global; Homebrew uninstall remove a fórmula ou o cask indicado.
| Instalação | Comando de remoção |
|---|---|
| Claude Code, npm | npm uninstall -g @anthropic-ai/claude-code |
| Claude Code, Homebrew | brew uninstall --cask claude-code |
| Codex CLI, npm | npm uninstall -g @openai/codex |
| Codex CLI, Homebrew | brew uninstall --cask codex |
| OpenCode, npm | npm uninstall -g opencode-ai |
| OpenCode, tap Homebrew V1 | brew uninstall anomalyco/tap/opencode |
Para o cask separado do canal latest do Claude, use brew uninstall --cask claude-code@latest. O tap do fornecedor OpenCode e a fórmula opencode do Homebrew podem representar versões principais diferentes. Confira o nome instalado. Não execute todas as linhas nem acrescente --zap como atalho. Com vários ambientes Node, revise as instalações globais separadamente.
Trate instalações nativas separadamente
Para Claude Code nativo, a Anthropic indica ~/.local/bin/claude e ~/.local/share/claude. Depois de encerrar, confira se correspondem à sua instalação e mova esse link de inicialização e a pasta do programa para o Lixo. Preserve ~/.claude para decidir sobre os dados.
O código do instalador da OpenAI coloca os inicializadores padrão do Codex em ~/.local/bin e o runtime em ~/.codex/packages/standalone. Confira as entradas codex e codex-code-mode-host. Mova só os inicializadores verificados e esse runtime após confirmar que nenhuma instalação Codex mantida precisa deles. CODEX_INSTALL_DIR e CODEX_HOME podem alterar os locais. É uma remoção manual deduzida do instalador, não um comando universal de desinstalação documentado.
Para OpenCode instalado pelo próprio script, use seu desinstalador enquanto o comando existe. Veja a prévia primeiro. A segunda linha remove o programa mantendo configuração, conversas e snapshots:
opencode uninstall --dry-run --keep-config --keep-data
opencode uninstall --keep-config --keep-data
Leia a prévia antes da segunda linha. O simples opencode uninstall remove um conjunto maior de dados. Tenha backup mesmo com opções de retenção e preserve dados compartilhados se ainda usa OpenCode Desktop.
Decida logout e extensões à parte
Se também quiser sair da conta, faça isso antes de remover o executável. O Claude documenta claude auth logout no guia de autenticação, e o Codex documenta codex logout na referência CLI. O guia de autenticação do Codex explica que o login pode ficar em um arquivo ou no armazenamento de credenciais do sistema e é compartilhado com a extensão IDE. Sair pode afetar a extensão também.
Remova extensões indesejadas no gerenciador de extensões ou plugins do editor. CLI, extensão e app desktop são instalações separadas. A Anthropic avisa que outros clientes podem recriar ~/.claude. O guia do Claude trata desktop e Code separado; o guia do OpenCode cobre Desktop e seus dados compartilhados com a CLI.
Remova dados locais só se aceitar perdê-los
Para remover só a CLI, pare aqui, com os dados do backup ainda no lugar. Para uma redefinição intencional, encerre todos os clientes que compartilham os dados, confira o backup e mova ao Lixo apenas os locais exatos e indesejados da primeira tabela. Apagar ~/.codex também remove o runtime nativo dentro dele, portanto não é uma remoção apenas do programa.
Diretórios personalizados e arquivos de projeto exigem revisão separada. A Anthropic documenta CLAUDE_CONFIG_DIR, e o OpenCode mostra os caminhos ativos de dados, configuração, cache e estado com opencode debug paths. Confira antes de desinstalar. .claude, .mcp.json e .opencode do projeto podem ser configuração da equipe. Preserve o código e as alterações necessárias dos worktrees. Não apague um repositório para remover um assistente.
As instruções da Apple sobre o Lixo explicam como restaurar antes de esvaziá-lo. Isso só é possível enquanto o item permanece ali. Desinstalar pelo gerenciador de pacotes não cria um backup do programa no Lixo. Se necessário, reinstale pelo canal original e restaure dados do backup conferido. Reconstruir caches também exige acesso aos pacotes ou outras fontes necessárias.
Confira sem apagar mais
Abra um novo terminal com zsh e confira a resolução dos comandos:
type -a claude
type -a codex
type -a opencode
Um caminho, alias ou função pede revisão e pode indicar outra instalação. Não encontrado só significa que esse shell não resolve o comando, não que todos os dados e extensões sumiram. Confira o editor à parte e se os dados escolhidos continuam presentes. Para remover apps desktop também, veja os resíduos de ferramentas IA.
Onde o Mole entra
A página de IA separada do Mole Mac cuida de conversas antigas elegíveis, worktrees verificados pelo Git e remoção de CLIs inativas compatíveis por sua política de exclusão específica para IA. São escolhas revisadas separadamente, não um comando para apagar toda a pasta pessoal de uma ferramenta.
O OpenCode está no catálogo CLI: uma instalação inativa elegível pode ser oferecida para remoção. Dados compartilhados ficam quando um app desktop ou skills instaladas precisam deles. Programas Homebrew são removidos pelo Homebrew; outros programas e dados elegíveis vão ao Lixo. Claude Code e Codex estão deliberadamente fora da desinstalação completa de ferramentas, então use os passos manuais acima. Uma linha desmarcada aguarda sua decisão, não está protegida de uma seleção posterior.
Perguntas frequentes
Posso remover Claude Code e manter Claude Desktop?
Sim. Remova só a CLI instalada separadamente e as extensões indesejadas. Preserve dados compartilhados necessários aos clientes mantidos. Use o guia desktop apenas se quiser remover esse app também.
Por que o comando ainda funciona depois da desinstalação?
Confira a resolução num terminal novo. Outro gerenciador, ambiente Node, inicializador nativo ou alias pode continuar fornecendo o comando. Remova só a instalação identificada.
Reinstalar recupera conversas apagadas?
Não conte com isso. A reinstalação fornece o programa, não um backup de conversas locais ou snapshots apagados. Mantenha backups legíveis e itens necessários no Lixo até conferir a recuperação.