# Claude Code나 Codex로 Mac 공간을 안전하게 확보하는 방법

> Claude Code, Codex, Cursor가 rm을 실행하지 않고 Mac을 채운 것을 찾게 합니다. Mole 스킬을 설치하고 --dry-run으로 미리 본 뒤 승인하고 로그를 확인하세요.

Published: 2026-10-21

요즘은 Claude Code나 Codex를 열고 "디스크가 꽉 찼어, 원인을 찾아 줘"라고 입력하는 사람이 늘었습니다. 에이전트에게 맡기기 좋은 일입니다. 폴더 수백 개를 읽고, `~/Library/Developer/Xcode/DerivedData`는 빌드 결과물이고 `~/Library/Containers/com.tencent.xinWeChat`는 채팅 기록이라는 것을 알아보고, 둘 다 쉬운 말로 설명해 줄 수 있습니다. 위험한 것은 그다음 단계입니다. 같은 에이전트가 `du` 목록을 자기 나름대로 읽고 `rm -rf`를 만들어 홈 폴더에 실행하는 순간입니다. 셸 명령에는 미리보기도, 휴지통도, 무엇을 지웠는지에 대한 기록도 없습니다.

이 글은 더 안전한 역할 분담을 보여 줍니다. 에이전트는 읽고 설명하고, 미리보기가 있는 정리 도구가 삭제를 맡고, 그 사이에서 여러분이 승인합니다. 여기서 쓰는 도구는 Mole의 무료 명령줄 버전인 Mole CLI와 공식 에이전트 스킬입니다. 이 스킬은 Claude Code, Codex, Cursor 등 여러 에이전트에게 Mole을 쓰는 법을 알려 줍니다. dry run을 지원하는 도구라면 같은 습관을 그대로 쓸 수 있습니다.

## 에이전트가 rm으로 파일을 지우면 안 되는 이유

에이전트는 정리 작업의 모호한 부분에 강합니다. 큰 폴더 트리를 훑고, 경로를 그 경로를 가진 앱과 연결하고, 항목 4천 개 중 살펴볼 만한 12개를 골라 순위를 매기는 일입니다. 어떤 경로를 지워도 안전한지 결정하는 것은 다른 종류의 문제입니다. 매번 같은 답이 나와야 하고 직접 확인할 수 있는 목록이 있어야 하는데, 모델은 둘 다 주지 못합니다. 더 자세한 논의는 [AI Mac 정리 도구: 모델이 결정해도 되는 것과 안 되는 것](https://mole.fit/ko/blog/ai-mac-cleaner-tools)에 있습니다.

실제로 에이전트가 날것의 셸 명령으로 정리하면 네 가지가 빠집니다.

1. **미리보기.** `rm`은 실행되는 즉시 동작합니다. 보이는 것은 명령 한 줄이지, 그 명령이 펼쳐지는 3,000개의 경로가 아닙니다.
2. **되돌릴 방법.** `rm`으로 지운 파일은 휴지통을 거치지 않습니다. 백업이 없으면 그대로 사라집니다.
3. **기록.** 다음 주에 어떤 앱의 설정이 사라져도, 그 정리 작업이 건드렸는지 알려 주는 것이 없습니다.
4. **절대 건드리면 안 되는 목록.** 캐시처럼 보이는 이름의 폴더에 세션, 서명 키, 다른 앱이 아직 쓰고 있는 데이터베이스가 들어 있을 수 있다는 것을 에이전트는 모를 수 있습니다.

이런 용도로 만든 정리 도구에는 이 네 가지가 이미 있습니다. 에이전트가 할 일은 그 출력을 읽고 여러분에게 묻는 것이 됩니다.

## 설치

Homebrew로 Mole CLI를 설치한 다음 스킬을 설치합니다.

```bash
brew install mole
npx skills add tw93/Mole -a claude-code codex cursor -g -y
```

두 번째 명령은 Claude Code, Codex, Cursor에 스킬을 한 번에 설치합니다. 쓰지 않는 에이전트는 명령에서 빼면 됩니다. 에이전트의 플러그인 시스템을 선호한다면 Claude Code에서는 `/plugin marketplace add tw93/Mole`을 실행한 뒤 `/plugin install mole@mole`을, Codex에서는 `codex plugin marketplace add tw93/Mole`을 실행한 뒤 `codex plugin add mole@mole`을 실행하세요. 나중에 스킬을 업데이트할 때는 `npx skills update -g -y`를 씁니다.

따로 설정할 것은 없습니다. 다음에 디스크 공간, 지우고 싶은 앱, Mac이 느린 이유를 물으면 에이전트가 스킬을 불러와 그대로 따릅니다.

## 스킬이 에이전트에게 정한 네 가지 규칙

스킬은 짧은 Markdown 파일이고, 대부분은 명령이 아니라 규칙입니다. 여러분의 파일에 중요한 규칙은 다음 네 가지입니다.

1. **바꾸기 전에 읽는다.** 에이전트는 먼저 읽기 전용 명령으로 답합니다. 디스크 사용량은 `mo analyze --json`, 메모리와 CPU는 `mo status --json`, 지난 정리 기록은 `mo history --json`, 설치된 앱은 `mo uninstall --list`, 그리고 모든 `--dry-run`입니다. 이 명령들은 묻지 않고 실행해도 안전합니다.
2. **모든 삭제를 미리 본다.** 정리 전에 에이전트는 `--dry-run`으로 실행하고 결과를 요약합니다. 전체 크기, 가장 큰 그룹들, 그리고 그룹마다 영구 삭제되는지, 휴지통으로 가는지, 다시 만들려면 다운로드가 필요한지를 알려 줍니다.
3. **삭제 명령을 입력하기 전에 묻는다.** 에이전트에서 실행하면 `mo clean`은 호출되는 순간 확인 없이 시작됩니다. 그래서 동의는 먼저 대화 안에서 이루어져야 합니다. "디스크가 왜 꽉 찼어?"는 질문이지 동의가 아닙니다. 미리보기를 본 뒤 "그거 정리해"라고 하는 것이 동의입니다.
4. **일부 단계는 여러분에게 맡긴다.** 앱 제거, 목록에서 항목 고르기, 관리자 암호가 필요한 모든 작업은 여러분의 터미널에서 합니다. 에이전트는 정확한 명령을 알려 주고 멈춥니다. `sudo`를 실행하지 않고 암호를 묻지도 않습니다.

작은 규칙 두 개가 흔한 우회로를 막습니다. 에이전트는 스킬에 나온 명령과 플래그만 쓸 수 있으므로 `--force` 같은 것을 지어낼 수 없습니다. 그리고 Mole이 건너뛰거나 보호한 경로를 `rm`으로 대신 지워서도 안 됩니다. 건너뛴 것 자체가 Mole의 답입니다.

## 실제 대화 예시

이렇게 입력했다고 해 봅시다. "Mac에서 디스크가 거의 다 찼다고 나와. 뭐가 차지하고 있어?"

에이전트는 `mo --version`을 실행해 macOS 버전과 대화하고 있는지 확인한 다음 `mo analyze --json`을 실행합니다. 결과로는 홈 폴더 안의 큰 위치와 바이트 단위 크기, `complete`, `partial`, `unavailable` 중 하나인 `scan_status`, 그리고 Mole이 캐시로 인식한 폴더에 붙는 `cleanable: true` 같은 플래그가 나옵니다. 가장 큰 두세 항목은 안을 보려고 `mo analyze --json`을 한 번 더 실행할 수도 있습니다.

그런 다음 찾은 것을 처리할 수 있는 쪽에 나눕니다.

| 찾은 것 | 맡는 쪽 |
| --- | --- |
| 앱 캐시, 로그, 이미 지운 앱의 잔여 파일 | `mo clean` |
| 프로젝트 안의 빌드 결과물과 의존성 폴더 | `mo purge` |
| 더 이상 쓰지 않는 설치된 앱 | `mo uninstall`, 여러분이 실행 |
| 다운로드 폴더의 설치 파일 | `mo installer`, 여러분이 실행 |
| 문서, 사진, 음악, 가상 머신, iPhone 백업 | 여러분이 결정. 이를 지우는 Mole 명령은 없음 |

마지막 행은 다른 행만큼 중요합니다. 좋은 답은 그중 40 GB가 Parallels 가상 머신이라고 알려 주고 결정을 여러분에게 남깁니다. 그것을 지울 명령을 찾으러 가지 않습니다.

공간을 되찾고 싶다면 에이전트가 `mo clean --dry-run`을 실행합니다. 요약은 대화에 나타나고, 모든 후보 경로는 `~/.config/mole/clean-list.txt`에 기록됩니다. 에이전트는 이 파일을 읽어서 아무 일도 일어나기 전에 "내 Slack 기록도 들어 있어?" 같은 질문에 답할 수 있습니다. `mo clean`이 기본적으로 휴지통을 비운다는 것도 알려 줍니다. 일부러 휴지통에 남겨 두는 사람이 많기 때문입니다. 여러분이 좋다고 말한 뒤에야 `mo clean`을 실행합니다.

## 여러분에게 남는 일과 그 이유

**관리자 단계.** 일부 시스템 캐시는 관리자 암호가 필요합니다. 에이전트에서 실행한 `mo clean`은 사용자 수준 부분만 정리하고 시스템 부분은 건너뛰며, 그 사실을 알려 줍니다. 둘 다 정리하고 싶으면 에이전트는 여러분의 터미널에서 `mo clean`을 직접 실행해 달라고 합니다. 그곳에서는 Mole이 직접 암호를 묻고 한 번에 모두 처리합니다. 지금 절반, 나중에 나머지 절반으로 나누지 않습니다. 두 번째 실행이 다시 스캔하면서 첫 번째 작업을 반복하게 되기 때문입니다.

**앱 제거.** 에이전트는 `mo uninstall --list`로 앱을 찾고, `mo uninstall --dry-run <name>`으로 무엇이 함께 지워지는지 정확히 보여 줄 수 있습니다. 앱 자체, 그 캐시, 그리고 따로 고르지 않는 한 남는 설정과 데이터를 담은 "Personal data kept" 목록입니다. 실제 제거는 터미널 없이는 실행을 거부하므로 `mo uninstall <name>`은 여러분이 직접 실행합니다. 제거된 파일은 휴지통으로 갑니다. 예전에 지운 앱이 아직 무언가를 남겼다면 [Mac 앱 삭제 후 남은 파일 정리하기](https://mole.fit/ko/blog/how-to-remove-leftover-files-after-uninstalling-mac-apps)를 참고하세요.

**프로젝트 폴더.** `mo purge --dry-run`은 오프라인에서 다시 빌드할 수 있는 빌드 결과물과, 복원하려면 다운로드가 필요한 `node_modules` 같은 의존성 폴더를 나열합니다. 일부 프로젝트만 정리하고 싶다면 에이전트는 `mo purge`를 여러분에게 넘깁니다. 선택 목록에서 직접 고를 수 있습니다.

## 나중에 확인하기

실제로 실행한 뒤 에이전트는 명령 자체의 요약과 `mo history --json --limit 1`을 읽고, 무엇이 제거되고 무엇이 건너뛰어졌는지 알려 줍니다. 건너뛴 항목은 다시 시도하지 않습니다. Mole은 사용 중이거나 보호된 파일을 일부러 건너뜁니다.

이 로그는 보통 일주일쯤 뒤에 나오는 질문, "그때 정리하면서 내 파일이 지워졌어?"에도 답해 줍니다. 에이전트에게 그대로 물어보세요. `mo history --json --limit 200`에서 그 경로와 그 아래의 모든 것을 찾고, 날짜가 더 오래됐다면 전체 삭제 로그를 읽습니다. 일치하는 것이 없으면 Mole에 그것을 지운 기록이 없다는 뜻입니다. 아무것도 지우지 않았다는 증거와는 다르며, 에이전트도 그렇게 말해야 합니다.

어떤 폴더를 앞으로의 모든 정리에서 빼고 싶다면 에이전트에게 보호해 달라고 하세요. 여러분이 동의하면 그 경로를 `~/.config/mole/whitelist`에 추가하고, `mo clean --dry-run`을 새로 실행해 그 경로가 더 이상 목록에 없는지 확인합니다.

## 다른 도구를 쓴다면

스킬은 Mole 전용이지만 그 규칙은 그렇지 않습니다. 다른 도구로 정리를 맡긴다면 대화를 시작할 때 이런 내용을 붙여 넣으세요.

```prompt
무엇이든 지우기 전에 먼저 목록을 보여 주고, 어떤 항목이 휴지통으로 가고 어떤 항목이 영구 삭제되는지 알려 줘.
도구의 dry-run이나 미리보기 모드를 쓰고, rm이나 find -delete는 절대 쓰지 마. sudo는 실행하지 마.
파일을 지우는 명령은 내가 좋다고 할 때까지 기다리고, 끝나면 무엇을 지웠고 무엇을 건너뛰었는지 알려 줘.
```

이것으로 도구에 없는 보호 경로 목록이나 로그가 생기지는 않지만, 미리보기와 결정은 원래 있어야 할 자리로 돌아옵니다. 어떤 도구를 쓰든 남겨야 할 것은 [Mac 클리너가 절대 지우면 안 되는 것](https://mole.fit/ko/blog/what-mac-cleaners-should-never-delete)과 [Mac에서 지워도 되는 캐시와 남겨야 할 데이터](https://mole.fit/ko/blog/which-mac-caches-are-safe-to-delete)에서 폴더별로 하나씩 살펴봅니다.

## 자주 묻는 질문

### 어떤 AI 에이전트가 Mole 스킬을 쓸 수 있나요?

설치 명령에는 Claude Code, Codex, Cursor가 나와 있고, `npx skills`는 스킬 파일을 읽는 다른 에이전트에도 설치할 수 있습니다. Claude Code와 Codex는 각자의 플러그인 마켓플레이스에서도 설치할 수 있습니다. 에이전트가 Mac에서 셸을 쓸 수 있어야 하므로, 터미널 없이 채팅만 하는 어시스턴트는 Mole을 실행할 수 없습니다.

### 에이전트가 묻지 않고 파일을 지울 수도 있나요?

스킬은 그러지 말라고 지시합니다. 삭제 명령은 미리보기와 대화 속 여러분의 동의가 있은 뒤에만 실행됩니다. 다만 이것은 에이전트에게 주는 지시이지 잠금장치가 아닙니다. 셸 명령에 대한 에이전트 자체의 승인 프롬프트는 켜 두고, 권한 설정에서 `rm`이나 `mo clean`을 미리 허용하지 마세요. 앱 제거와 관리자 단계는 에이전트에서 아예 실행할 수 없고 여러분의 터미널이 필요합니다.

### 에이전트를 통해 정리하면 Mole 앱이나 CLI만 쓸 때보다 더 많이 지워지나요?

아니요. 에이전트는 여러분이 직접 입력할 수 있는 것과 같은 CLI 명령을 실행하고, 보호 경로와 미리보기도 같습니다. 에이전트가 더하는 것은 읽고 설명하는 일입니다. 어떤 폴더가 어떤 앱의 것인지, 그리고 어떤 명령이 처리하는지, 아니면 어떤 명령도 처리하지 않는지를 알려 줍니다.

### Mole CLI는 무료인가요?

네. Mole CLI는 GPL-3.0 오픈 소스이고, 스킬도 같은 저장소에 있습니다. Mole for Mac은 입력보다 클릭을 선호하는 사람을 위한 별도의 유료 앱입니다. 에이전트는 많아야 한 번만 언급하며, 제거할 앱을 고르는 일처럼 창으로 하는 편이 나은 단계에서만 꺼냅니다.

### Windows에서도 되나요?

네, Mole CLI for Windows로 됩니다. Windows 버전에는 자체 명령이 있고 휴지통과 관리자 단계에 관한 규칙도 따로 있습니다. 스킬은 `mo --version`을 읽고 자동으로 Windows용 안내로 바꿉니다. 이 가이드의 Windows 버전은 [Claude Code나 Codex로 Windows 공간을 안전하게 확보하는 방법](https://mole.fit/windows/blog/use-claude-code-to-clean-up-windows)입니다.

## 관련 글

- [AI Mac 정리 도구: 모델이 결정해도 되는 것과 안 되는 것](https://mole.fit/ko/blog/ai-mac-cleaner-tools): 정리 작업에서 모델이 도움이 되는 곳과 그렇지 않은 곳.
- [Mac에서 AI 코딩 도구가 남긴 것 정리하기](https://mole.fit/ko/blog/how-to-clean-up-ai-coding-tools-mac): Claude Code, Codex, Cursor가 Mac에 남기는 캐시와 세션.
- [Mole CLI 또는 Mole for Mac](https://mole.fit/ko/blog/mole-cli-vs-mac-app): 명령줄과 앱 중에서 고르기.

---

Canonical HTML page: https://mole.fit/ko/blog/use-claude-code-to-clean-up-mac
Blog index for agents: https://mole.fit/ko/blog/llms.txt
Site index for agents: https://mole.fit/llms.txt