在 Mac 上移除 Claude Code、Codex CLI 和 OpenCode
在 Mac 上解除安裝 Claude Code、Codex CLI 或 OpenCode,先按實際安裝方式移除程式,再決定要不要刪資料,終端機裡找不到指令和聊天記錄沒了是兩回事,如果以後還可能用回來,或還在用桌面 App、編輯器延伸功能,就先留下資料。
先決定保留什麼
動手前把想留的設定和本機對話複製到能打開檢查的備份裡,不要指望重新登入帳號就能復原本機記錄,如果只是想清快取、繼續用這些工具,直接看清理 AI 程式開發工具佔用。
| 工具 | 預設要檢查的資料位置 | 移除可能遺失什麼 |
|---|---|---|
| Claude Code | ~/.claude 和 ~/.claude.json |
設定、權限、MCP 設定和對話記錄 |
| Codex CLI | ~/.codex |
本機設定、對話和以檔案儲存的登入資訊 |
| OpenCode | ~/.local/share/opencode、~/.config/opencode、~/.cache/opencode |
對話、快照、服務供應商憑證、設定和快取 |
路徑分別來自 Claude Code 設定說明、Codex 設定說明及其記錄位置說明,還有 OpenCode 的儲存說明和設定說明,這是一份檢查清單,不是一份批次刪除清單。
用安裝它的套件管理工具移除
先完成正在做的工作,結束工具裡的對話,套件管理工具安裝的版本只用下面對應的一列,Claude 移除說明、OpenAI 的安裝方式列表和 OpenCode 的安裝說明列出了套件名稱,npm uninstall加全域參數移除全域套件,Homebrew uninstall移除指定的 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 原生安裝的官方安裝程式原始碼把預設啟動入口放在 ~/.local/bin,執行檔案放在 ~/.codex/packages/standalone,檢查其中的 codex 和 codex-code-mode-host 入口,確認沒有留下的 Codex 安裝需要它們後,只把核實過的入口和該執行目錄移到垃圾桶,CODEX_INSTALL_DIR 和 CODEX_HOME 可以改變位置,這是按安裝配置手動移除,不是一條官方通用解除安裝指令。
OpenCode 如果是用自己的指令稿安裝,在指令還可用時使用它的解除安裝工具,先預覽,第二列才執行移除,並保留設定、對話和快照。
opencode uninstall --dry-run --keep-config --keep-data
opencode uninstall --keep-config --keep-data
看清預覽再執行第二列,直接用 opencode uninstall 會處理更廣的資料範圍,即使加了保留參數也要先備份,還在用 OpenCode Desktop 時,共用資料要留下。
登出和移除延伸功能分開決定
如果也想登出,在移除程式前處理,Claude 的認證說明記錄了 claude auth logout,Codex 的 CLI 參考記錄了 codex logout,它的認證說明也說明登入資訊可能儲存在檔案或系統憑證儲存區裡,並與 IDE 延伸功能共用,登出也可能影響延伸功能。
不再需要的編輯器延伸功能,到編輯器的延伸功能或外掛管理員裡移除,CLI、延伸功能和桌面 App 分別安裝,Anthropic 明確提醒其他用戶端可能重新建立 ~/.claude,Claude 指南講桌面 App 和單獨安裝的 Code,OpenCode 指南講 OpenCode Desktop 及其與 CLI 共用的資料。
確定不要本機資料時再移除
只解除安裝 CLI,到這裡可以停,備份過的資料繼續保留,如果明確要重設本機資料,先結束所有共用它的用戶端,檢查備份,再把第一張表裡確認不要的確切位置移到垃圾桶,刪除 ~/.codex 也會刪掉儲存在裡面的原生執行檔案,不是只移除程式。
自訂設定目錄和專案檔案要單獨看,Anthropic 記錄了 CLAUDE_CONFIG_DIR,OpenCode 的 opencode debug paths 可以顯示目前資料、設定、快取和狀態目錄,解除安裝前先核對,不要預設路徑一定適用,專案裡的 .claude、.mcp.json 和 .opencode 可能是團隊設定,保留原始碼和需要的 worktree 變更,不要為了移除助手刪掉儲存庫。
Apple 的垃圾桶說明介紹了清空前復原項目的方法,只有項目還在裡面才有這條復原路徑,套件管理工具移除不等於把程式備份進垃圾桶,需要時從原管道重新安裝,再從核對過的備份復原資料,快取重建也要能取得所需的套件或其他來源。
檢查結果,不繼續擴大刪除範圍
新開一個使用 zsh 的終端機,按它的指令解析說明查看指令實際指向哪裡。
type -a claude
type -a codex
type -a opencode
傳回路徑、別名或函式就繼續檢查,可能還有另一份安裝,提示找不到只表示這個 shell 無法解析指令,不代表資料和延伸功能都沒了,編輯器單獨檢查,也確認想保留的資料還在,更大範圍的桌面 App 移除看 AI 工具殘留。
Mole 能處理哪一部分
Mole Mac 的獨立 AI 頁面可以處理符合條件的舊對話、經過 Git 核對的 worktree 和閒置 CLI 移除,走專門的 AI 資料刪除規則,這些是分別確認的選擇,不是把工具的整個個人目錄清空。
OpenCode 在 CLI 目錄裡,符合閒置條件的安裝可以列出來移除,有桌面 App 共用資料或已安裝的技能需要資料時會保留共用部分,Homebrew 安裝的程式交給 Homebrew 移除,其他符合條件的程式和資料目標移到垃圾桶,Claude Code 和 Codex 刻意不在整套工具移除名單裡,要按上面的安裝方式手動處理,預設不勾選表示等你決定,不代表以後勾選了還會保留。
常見問題
能移除 Claude Code,繼續用 Claude Desktop 嗎?
可以,只移除單獨安裝的 CLI 和不需要的編輯器延伸功能,留下的用戶端還要用共用資料時就保留,桌面 App 也不想要了再按它的指南處理。
為什麼移除後指令還能執行?
新開終端機查看指令解析,另一個套件管理工具、Node 環境、原生入口或 shell 別名都可能提供同名指令,確認是哪一份以後只移除那一份。
重新安裝能復原刪掉的對話嗎?
不要指望重新安裝復原,它提供的是程式,不是已刪除本機對話和快照的備份,保留能讀取的備份,垃圾桶裡需要的項目也等核對復原結果後再處理。