# Mac에서 Claude Code, Codex CLI, OpenCode 제거하기

> 설치 방식에 맞게 프로그램을 제거하고 로그인, 편집기 확장, 설정과 로컬 대화를 보관할지 따로 결정합니다.

Published: 2026-10-31

Mac에서 Claude Code, Codex CLI, OpenCode를 제거하려면 실제 설치 방식에 맞게 프로그램부터 지우고 데이터를 어떻게 할지 결정합니다. 명령을 찾을 수 없는 상태와 대화 기록을 잃는 것은 다릅니다. 다시 쓸 가능성이 있거나 데스크톱 앱과 편집기 확장을 계속 쓴다면 데이터를 먼저 남겨 두세요.

## 무엇을 남길지 결정하기

무엇이든 제거하기 전에 필요한 설정과 로컬 대화를 읽을 수 있는 백업으로 복사합니다. 계정에 로그인하면 로컬 기록까지 돌아온다고 가정하지 마세요. 도구는 유지하고 캐시만 줄이려면 [AI 코딩 도구 공간 정리](https://mole.fit/ko/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`을 설명합니다. Codex의 [인증 안내](https://learn.chatgpt.com/docs/auth)에 따르면 로그인 정보는 파일 또는 운영체제 자격 증명 저장소에 저장될 수 있으며 IDE 확장과 공유되므로 로그아웃이 확장에도 영향을 줄 수 있습니다.

필요 없는 편집기 확장은 해당 편집기의 확장 또는 플러그인 관리자에서 제거합니다. CLI와 확장, 데스크톱 앱은 별도 설치입니다. Anthropic은 다른 클라이언트가 `~/.claude`를 다시 만들 수 있다고 명시합니다. [Claude 가이드](https://mole.fit/tested-apps/claude)는 데스크톱 앱과 별도 Code 제거를, [OpenCode 가이드](https://mole.fit/tested-apps/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
```

경로, 별칭, 함수가 나오면 다른 설치인지 검토합니다. 찾지 못했다는 결과는 해당 셸이 명령을 해석하지 못한다는 뜻이지 모든 데이터와 확장이 없어졌다는 증거는 아닙니다. 편집기를 따로 확인하고 보관할 데이터도 남아 있는지 확인하세요. 데스크톱 앱까지 제거하려면 [AI 도구 잔여 데이터](https://mole.fit/ko/blog/how-to-remove-ai-tool-leftovers-mac)를 참고합니다.

## Mole의 역할

Mole Mac의 별도 AI 페이지는 조건을 충족하는 오래된 대화, Git으로 확인한 worktree, 지원되는 유휴 CLI 제거를 AI 전용 삭제 정책으로 처리합니다. 각각 검토하는 선택이며 도구의 홈 폴더 전체를 비우는 기능은 아닙니다.

OpenCode는 CLI 목록에 있어 조건을 충족한 유휴 설치가 제거 대상으로 표시될 수 있습니다. 데스크톱 공동 사용 앱이나 설치된 스킬이 데이터를 필요로 하면 공유 데이터는 남깁니다. Homebrew 프로그램은 Homebrew로 제거하고, 다른 적격 프로그램과 데이터는 휴지통으로 옮깁니다. Claude Code와 Codex는 전체 도구 제거에서 의도적으로 제외되어 있으므로 위의 수동 절차를 사용합니다. 선택되지 않은 행은 판단을 기다리는 상태일 뿐, 나중에 선택되지 않도록 보호된 것은 아닙니다.

## 자주 묻는 질문

### Claude Desktop을 남기고 Claude Code만 제거할 수 있나요?

네. 별도 CLI와 불필요한 편집기 확장만 제거하고 남은 클라이언트가 필요한 공유 데이터는 보관합니다. 데스크톱 앱도 제거할 때만 해당 가이드를 따릅니다.

### 제거했는데 왜 명령이 실행되나요?

새 터미널에서 해석 결과를 확인하세요. 다른 패키지 관리자, Node 환경, 네이티브 실행 항목이나 셸 별칭이 같은 명령을 제공할 수 있습니다. 식별한 설치만 제거합니다.

### 다시 설치하면 삭제한 대화가 복구되나요?

그렇게 기대하지 마세요. 재설치는 프로그램을 제공하며 삭제된 로컬 대화와 스냅샷의 백업은 아닙니다. 읽을 수 있는 백업과 필요한 휴지통 항목은 복원을 확인할 때까지 보관합니다.

---

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