# 在 Mac 上移除 Claude Code、Codex CLI 和 OpenCode

> 按原生安裝、npm 和 Homebrew 分別移除，登入、編輯器延伸功能、設定和本機對話單獨決定去留。

Published: 2026-10-31

在 Mac 上解除安裝 Claude Code、Codex CLI 或 OpenCode，先按實際安裝方式移除程式，再決定要不要刪資料，終端機裡找不到指令和聊天記錄沒了是兩回事，如果以後還可能用回來，或還在用桌面 App、編輯器延伸功能，就先留下資料。

## 先決定保留什麼

動手前把想留的設定和本機對話複製到能打開檢查的備份裡，不要指望重新登入帳號就能復原本機記錄，如果只是想清快取、繼續用這些工具，直接看[清理 AI 程式開發工具佔用](https://mole.fit/tw/blog/how-to-clean-up-ai-coding-tools-mac)。

| 工具 | 預設要檢查的資料位置 | 移除可能遺失什麼 |
| --- | --- | --- |
| Claude Code | `~/.claude` 和 `~/.claude.json` | 設定、權限、MCP 設定和對話記錄 |
| Codex CLI | `~/.codex` | 本機設定、對話和以檔案儲存的登入資訊 |
| OpenCode | `~/.local/share/opencode`、`~/.config/opencode`、`~/.cache/opencode` | 對話、快照、服務供應商憑證、設定和快取 |

路徑分別來自 [Claude Code 設定說明](https://code.claude.com/docs/en/setup#remove-configuration-files)、[Codex 設定說明](https://learn.chatgpt.com/docs/config-file/config-reference)及其[記錄位置說明](https://learn.chatgpt.com/docs/reference/troubleshooting)，還有 OpenCode 的[儲存說明](https://opencode.ai/docs/troubleshooting/)和[設定說明](https://opencode.ai/docs/config/)，這是一份檢查清單，不是一份批次刪除清單。

## 用安裝它的套件管理工具移除

先完成正在做的工作，結束工具裡的對話，套件管理工具安裝的版本只用下面對應的一列，[Claude 移除說明](https://code.claude.com/docs/en/setup#uninstall-claude-code)、OpenAI 的[安裝方式列表](https://github.com/openai/codex/blob/main/README.md)和 OpenCode 的[安裝說明](https://opencode.ai/docs/)列出了套件名稱，[npm uninstall](https://docs.npmjs.com/cli/v11/commands/npm-uninstall/)加全域參數移除全域套件，[Homebrew uninstall](https://docs.brew.sh/Manpage)移除指定的 formula 或 cask。

| 安裝方式 | 移除指令 |
| --- | --- |
| 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，Homebrew V1 tap | `brew uninstall anomalyco/tap/opencode` |

Claude 如果裝的是另外命名的 latest 通道 cask，就換成 `brew uninstall --cask claude-code@latest`，OpenCode 的官方 tap 和 Homebrew 的 `opencode` formula 可能對應不同主要版本，先核對已安裝的套件名稱，不要把每一列都執行一遍，也別順手加 `--zap`，用了多個 Node 環境時，各環境的全域安裝分別檢查。

## 原生安裝單獨處理

Claude Code 的原生安裝，Anthropic 指定了 `~/.local/bin/claude` 和 `~/.local/share/claude`，結束後確認它們屬於這次安裝，再把啟動連結和程式目錄移到垃圾桶，`~/.claude` 留到後面單獨決定。

Codex 原生安裝的[官方安裝程式原始碼](https://github.com/openai/codex/blob/main/scripts/install/install.sh)把預設啟動入口放在 `~/.local/bin`，執行檔案放在 `~/.codex/packages/standalone`，檢查其中的 `codex` 和 `codex-code-mode-host` 入口，確認沒有留下的 Codex 安裝需要它們後，只把核實過的入口和該執行目錄移到垃圾桶，`CODEX_INSTALL_DIR` 和 `CODEX_HOME` 可以改變位置，這是按安裝配置手動移除，不是一條官方通用解除安裝指令。

OpenCode 如果是用自己的指令稿安裝，在指令還可用時使用它的[解除安裝工具](https://opencode.ai/docs/cli/#uninstall)，先預覽，第二列才執行移除，並保留設定、對話和快照。

```sh
opencode uninstall --dry-run --keep-config --keep-data
opencode uninstall --keep-config --keep-data
```

看清預覽再執行第二列，直接用 `opencode uninstall` 會處理更廣的資料範圍，即使加了保留參數也要先備份，還在用 OpenCode Desktop 時，共用資料要留下。

## 登出和移除延伸功能分開決定

如果也想登出，在移除程式前處理，Claude 的[認證說明](https://code.claude.com/docs/en/authentication)記錄了 `claude auth logout`，Codex 的 [CLI 參考](https://learn.chatgpt.com/docs/developer-commands?surface=cli)記錄了 `codex logout`，它的[認證說明](https://learn.chatgpt.com/docs/auth)也說明登入資訊可能儲存在檔案或系統憑證儲存區裡，並與 IDE 延伸功能共用，登出也可能影響延伸功能。

不再需要的編輯器延伸功能，到編輯器的延伸功能或外掛管理員裡移除，CLI、延伸功能和桌面 App 分別安裝，Anthropic 明確提醒其他用戶端可能重新建立 `~/.claude`，[Claude 指南](https://mole.fit/tested-apps/claude)講桌面 App 和單獨安裝的 Code，[OpenCode 指南](https://mole.fit/tested-apps/opencode)講 OpenCode Desktop 及其與 CLI 共用的資料。

## 確定不要本機資料時再移除

只解除安裝 CLI，到這裡可以停，備份過的資料繼續保留，如果明確要重設本機資料，先結束所有共用它的用戶端，檢查備份，再把第一張表裡確認不要的確切位置移到垃圾桶，刪除 `~/.codex` 也會刪掉儲存在裡面的原生執行檔案，不是只移除程式。

自訂設定目錄和專案檔案要單獨看，Anthropic 記錄了 `CLAUDE_CONFIG_DIR`，OpenCode 的 `opencode debug paths` 可以顯示目前資料、設定、快取和狀態目錄，解除安裝前先核對，不要預設路徑一定適用，專案裡的 `.claude`、`.mcp.json` 和 `.opencode` 可能是團隊設定，保留原始碼和需要的 worktree 變更，不要為了移除助手刪掉儲存庫。

Apple 的[垃圾桶說明](https://support.apple.com/guide/mac-help/mchlp1093/mac)介紹了清空前復原項目的方法，只有項目還在裡面才有這條復原路徑，套件管理工具移除不等於把程式備份進垃圾桶，需要時從原管道重新安裝，再從核對過的備份復原資料，快取重建也要能取得所需的套件或其他來源。

## 檢查結果，不繼續擴大刪除範圍

新開一個使用 zsh 的終端機，按它的[指令解析說明](https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html)查看指令實際指向哪裡。

```sh
type -a claude
type -a codex
type -a opencode
```

傳回路徑、別名或函式就繼續檢查，可能還有另一份安裝，提示找不到只表示這個 shell 無法解析指令，不代表資料和延伸功能都沒了，編輯器單獨檢查，也確認想保留的資料還在，更大範圍的桌面 App 移除看 [AI 工具殘留](https://mole.fit/tw/blog/how-to-remove-ai-tool-leftovers-mac)。

## Mole 能處理哪一部分

Mole Mac 的獨立 AI 頁面可以處理符合條件的舊對話、經過 Git 核對的 worktree 和閒置 CLI 移除，走專門的 AI 資料刪除規則，這些是分別確認的選擇，不是把工具的整個個人目錄清空。

OpenCode 在 CLI 目錄裡，符合閒置條件的安裝可以列出來移除，有桌面 App 共用資料或已安裝的技能需要資料時會保留共用部分，Homebrew 安裝的程式交給 Homebrew 移除，其他符合條件的程式和資料目標移到垃圾桶，Claude Code 和 Codex 刻意不在整套工具移除名單裡，要按上面的安裝方式手動處理，預設不勾選表示等你決定，不代表以後勾選了還會保留。

## 常見問題

### 能移除 Claude Code，繼續用 Claude Desktop 嗎？

可以，只移除單獨安裝的 CLI 和不需要的編輯器延伸功能，留下的用戶端還要用共用資料時就保留，桌面 App 也不想要了再按它的指南處理。

### 為什麼移除後指令還能執行？

新開終端機查看指令解析，另一個套件管理工具、Node 環境、原生入口或 shell 別名都可能提供同名指令，確認是哪一份以後只移除那一份。

### 重新安裝能復原刪掉的對話嗎？

不要指望重新安裝復原，它提供的是程式，不是已刪除本機對話和快照的備份，保留能讀取的備份，垃圾桶裡需要的項目也等核對復原結果後再處理。

---

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