# Desinstalar Claude Code, Codex CLI e OpenCode no Mac

> Remova por método de instalação e decida separadamente sobre login, extensões, configurações e conversas locais.

Published: 2026-10-31

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](https://mole.fit/pt-br/blog/how-to-clean-up-ai-coding-tools-mac).

| 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](https://code.claude.com/docs/en/setup#remove-configuration-files), da [configuração do Codex](https://learn.chatgpt.com/docs/config-file/config-reference) e dos [locais de histórico](https://learn.chatgpt.com/docs/reference/troubleshooting), além das páginas de [armazenamento](https://opencode.ai/docs/troubleshooting/) e [configuração do OpenCode](https://opencode.ai/docs/config/). 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](https://code.claude.com/docs/en/setup#uninstall-claude-code), na [lista de instalação da OpenAI](https://github.com/openai/codex/blob/main/README.md) e no [guia do OpenCode](https://opencode.ai/docs/). [npm uninstall](https://docs.npmjs.com/cli/v11/commands/npm-uninstall/) com a opção global remove um pacote global; [Homebrew uninstall](https://docs.brew.sh/Manpage) 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](https://github.com/openai/codex/blob/main/scripts/install/install.sh) 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](https://opencode.ai/docs/cli/#uninstall) enquanto o comando existe. Veja a prévia primeiro. A segunda linha remove o programa mantendo configuração, conversas e snapshots:

```sh
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](https://code.claude.com/docs/en/authentication), e o Codex documenta `codex logout` na [referência CLI](https://learn.chatgpt.com/docs/developer-commands?surface=cli). O [guia de autenticação do Codex](https://learn.chatgpt.com/docs/auth) 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](https://mole.fit/tested-apps/claude) trata desktop e Code separado; o [guia do OpenCode](https://mole.fit/tested-apps/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](https://support.apple.com/guide/mac-help/mchlp1093/mac) 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](https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html):

```sh
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](https://mole.fit/pt-br/blog/how-to-remove-ai-tool-leftovers-mac).

## 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.

---

Canonical HTML page: https://mole.fit/pt-br/blog/uninstall-claude-code-codex-mac
Blog index for agents: https://mole.fit/pt-br/blog/llms.txt
Site index for agents: https://mole.fit/llms.txt