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

C: 드라이브가 빨갛게 변하면, 요즘은 Claude Code나 Codex에게 원인을 찾아 달라고 하는 사람이 늘었습니다. 에이전트는 그 일에 강합니다. 폴더 수백 개를 나열하고, `AppData\Local\npm-cache`는 패키지 캐시이고 `Documents\WeChat Files`는 채팅 기록이라는 것을 알아보고, 둘 다 쉬운 말로 설명해 줄 수 있습니다. 위험한 것은 그다음 단계입니다. 같은 에이전트가 폴더 크기를 자기 나름대로 읽고 `Remove-Item -Recurse -Force`나 `del /s /q`를 만드는 순간입니다. 생성된 명령에서 따옴표나 백슬래시 하나만 틀려도 엉뚱한 폴더를 가리킬 수 있고, 두 명령 모두 먼저 묻지 않고, 휴지통을 쓰지 않고, 기록도 남기지 않습니다.

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

## 에이전트가 Remove-Item으로 정리하면 안 되는 이유

에이전트가 날것의 PowerShell이나 cmd 명령으로 정리하면 네 가지가 빠집니다.

1. **미리보기.** `Remove-Item`은 실행되는 즉시 동작합니다. 여러분이 승인하는 것은 명령 한 줄이지, 그 명령이 펼쳐지는 수천 개의 파일이 아닙니다. PowerShell에 `-WhatIf`가 있긴 하지만, 에이전트가 그것을 쓰게 만드는 장치는 없습니다.
2. **되돌릴 방법.** 이렇게 지운 파일은 휴지통을 거치지 않습니다.
3. **기록.** 다음 주에 어떤 앱의 설정이 사라져도, 그 정리 작업이 건드렸는지 알려 주는 것이 없습니다.
4. **절대 건드리면 안 되는 목록.** `Cache`라는 폴더에 브라우저 프로필의 세션, 게임 저장 파일, 실행 중인 앱이 아직 쓰고 있는 데이터베이스가 들어 있을 수 있습니다.

이런 용도로 만든 정리 도구에는 이 네 가지가 이미 있습니다. 에이전트가 할 일은 그 출력을 읽고 여러분에게 묻는 것이 됩니다. 어떤 폴더가 중요한지 먼저 알고 싶다면 [Windows에서 지워도 되는 캐시는 어느 것인가](/ko/windows/blog/windows-cache-cleanup)에서 폴더별로 하나씩 살펴봅니다.

## 설치

Scoop으로 Mole CLI for Windows를 설치한 다음 스킬을 설치합니다.

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

스킬 명령에는 Node.js가 필요하며, 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`을 실행해도 됩니다. CLI는 1.37.0 이상 버전을 쓰세요. 이 버전에서 에이전트에게 가장 필요한 두 명령인 `mo analyze --json`과 `mo uninstall --list`가 추가됐습니다. 지금 버전은 `mo --version`으로 확인할 수 있습니다.

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

1. **바꾸기 전에 읽는다.** 에이전트는 읽기 전용 명령으로 시작합니다. 디스크 사용량은 `mo analyze --json`, CPU와 메모리와 디스크는 `mo status --json`, 지난 정리 기록은 `mo history --json`, 설치된 앱은 `mo uninstall --list`, 그리고 `mo clean --dry-run`입니다. 이 명령들은 묻지 않고 실행해도 안전합니다.
2. **모든 삭제를 미리 본다.** 에이전트는 먼저 `--dry-run`으로 정리를 실행하고 요약합니다. 전체 크기, 가장 큰 그룹들, 그리고 각각이 영구 삭제되는지, 휴지통으로 가는지, 다시 만들려면 다운로드가 필요한지를 알려 줍니다.
3. **삭제 명령을 입력하기 전에 묻는다.** 에이전트에서 실행하면 `mo clean`은 확인 없이 바로 시작됩니다. 그래서 여러분의 동의는 미리보기를 본 뒤 대화 안에서 나와야 합니다.
4. **일부 단계는 여러분에게 맡긴다.** 앱 제거, 선택 목록, 관리자 PowerShell이 필요한 모든 작업은 여러분의 콘솔에서 합니다. 에이전트는 정확한 명령을 알려 주고 멈춥니다. 권한 상승은 절대 시도하지 않습니다.

스킬은 플래그를 지어내는 것도 금지하고(Mole CLI for Windows에는 `--yes`도 `--force`도 없습니다), Mole이 건너뛰거나 보호한 것을 `Remove-Item`으로 대신 지우는 것도 금지합니다.

## 실제 대화 예시

이렇게 입력했다고 해 봅시다. "C 드라이브가 거의 다 찼어. 뭐가 차지하고 있어?"

에이전트는 `mo --version`을 실행하고, 두 번째 줄에서 `Windows:`를 보고 Windows 규칙으로 바꿉니다. 이어서 `mo analyze --json`이 사용자 폴더와 드라이브의 개요를 돌려줍니다. 크기는 바이트 단위이고, `complete`, `partial`, `unavailable` 중 하나인 `scan_status`가 붙으며, 오래된 다운로드, Temp, 패키지 관리자 캐시처럼 용량을 많이 차지하는 것으로 알려진 곳에는 `insight: true`가 붙습니다. 더 자세히 보려면 `mo analyze --json D:\`나 가장 큰 폴더의 경로를 넣어 실행합니다.

그런 다음 찾은 것을 나눕니다.

| 찾은 것 | 맡는 쪽 |
| --- | --- |
| 임시 파일, 앱과 브라우저 캐시, 로그 | `mo clean` |
| Windows Temp, 시스템 로그, 오류 보고서와 메모리 덤프 | `mo clean --system`, 여러분이 관리자로 실행 |
| 프로젝트 안의 빌드 결과물과 `node_modules` | `mo purge`, 여러분이 실행 |
| 더 이상 쓰지 않는 설치된 앱 | `mo uninstall`, 여러분이 실행 |
| 문서, 사진, 동영상, 게임 라이브러리, 가상 머신 | 여러분이 결정. 이를 지우는 Mole 명령은 없음 |

그다음 공간을 되찾고 싶다면 `mo clean --dry-run`을 실행합니다. 모든 후보 경로는 `%USERPROFILE%\.config\mole\clean-list.txt`에 기록되고, 에이전트는 이 파일을 읽어서 아무 일도 일어나기 전에 "내 Chrome 비밀번호도 들어 있어?" 같은 질문에 답할 수 있습니다. 여러분이 좋다고 말한 뒤에야 `mo clean`을 실행합니다. Windows에서 `mo clean`은 휴지통을 비우지 않습니다. 게임 리플레이와 GPU 셰이더 캐시는 `--game-media`나 `--gpu-shaders`를 요청하지 않는 한 대상에서 빠집니다. 게임이 다음 실행 때 셰이더를 다시 만드는 데 시간이 오래 걸리기 때문입니다.

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

**관리자 단계.** 에이전트에서 실행한 `mo clean`은 여러분의 사용자 계정만 다룹니다. 시스템 전체 캐시를 정리하려면 "관리자 권한으로 실행"으로 PowerShell을 열고 `mo clean --system --dry-run`을 실행한 뒤 `mo clean --system`을 실행하세요. 관리자 계정이 다른 Windows 사용자라면 그 셸은 자체 프로필 폴더를 쓰므로, 화이트리스트와 로그가 여러분의 것과 따로 관리됩니다.

**앱 제거.** 에이전트는 `mo uninstall --list`에서 앱을 찾을 수 있습니다. 이 목록은 앱마다 이름, 출처(레지스트리 또는 Microsoft Store), 게시자, 버전, 크기를 보여 줍니다. 제거 자체는 선택 목록이므로, 먼저 여러분이 `mo uninstall --dry-run`을 실행해 각 앱이 어떤 제거 프로그램을 쓰는지 확인한 다음, `mo uninstall`을 실행하고 입력해서 앱을 검색합니다. Mole은 공급업체의 제거 프로그램을 실행하고, 그 폴더 안에서 무엇을 지울지는 제거 프로그램이 정합니다. 그 뒤 Mole이 확인된 남은 설치 폴더를 휴지통으로 옮깁니다. 일부 제거 프로그램은 자체 UAC 프롬프트나 마법사를 띄웁니다. 보통 무엇이 남는지는 [Windows 앱이 제거 뒤에 남기는 것](/ko/windows/blog/what-apps-leave-after-uninstall)을 참고하세요.

**프로젝트 폴더와 시스템 파일 검사기.** `mo purge`는 선택 목록을 열기 때문에 여러분의 콘솔에서 실행합니다. `mo optimize`는 마지막에 몇 분이 걸리는 시스템 파일 검사기를 실행할지 묻는데, 그 답도 여러분의 몫입니다.

## 나중에 확인하기

실제로 실행한 뒤 에이전트는 명령 요약과 `mo history --json --limit 1`을 읽고, 무엇이 제거되고 무엇이 건너뛰어졌는지 알려 줍니다. 건너뛴 항목은 다시 시도하지 않습니다. 기록은 `%USERPROFILE%\.config\mole\operations.log`에 저장됩니다. 미리보기는 기록되지 않으므로 그곳에는 실제 삭제만 남습니다.

이 로그는 몇 주 뒤 "Mole이 내 파일을 지웠어?"라는 질문에도 답해 줍니다. 에이전트는 `mo history --json --limit 200`에서 그 경로를 찾습니다. 일치하는 것이 없으면 Mole에 그것을 지운 기록이 없다는 뜻이고, 다른 무언가가 지우지 않았다는 증거는 아닙니다.

어떤 폴더를 앞으로의 모든 정리에서 빼고 싶다면 에이전트에게 보호해 달라고 하세요. 여러분이 동의하면 그 경로를 `%USERPROFILE%\.config\mole\whitelist.txt`에 추가합니다. 이 파일은 BOM이 있는 UTF-8로 저장되므로 Windows PowerShell 5.1도 영어가 아닌 경로를 제대로 읽습니다. 마지막으로 `mo clean --dry-run`을 새로 실행해 확인합니다.

## 다른 도구를 쓴다면

이 규칙은 Mole에만 해당하지 않습니다. 다른 도구를 쓸 때는 대화를 시작하면서 이런 내용을 붙여 넣으세요.

```prompt
무엇이든 지우기 전에 먼저 목록을 보여 주고, 어떤 항목이 휴지통으로 가고 어떤 항목이 영구 삭제되는지 알려 줘.
도구의 미리보기나 -WhatIf 모드를 쓰고, Remove-Item -Recurse -Force나 del /s는 절대 쓰지 마.
권한을 올리거나 관리자 셸을 요청하지 마. 파일을 지우는 명령은 내가 좋다고 할 때까지 기다리고,
끝나면 무엇을 지웠고 무엇을 건너뛰었는지 알려 줘.
```

## 자주 묻는 질문

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

설치 명령에는 Claude Code, Codex, Cursor가 나와 있고, `npx skills`는 스킬 파일을 읽는 다른 에이전트에도 설치할 수 있습니다. 에이전트가 PC에서 셸을 쓸 수 있어야 하며, Windows PowerShell 5.1과 PowerShell 7 모두 됩니다.

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

스킬은 먼저 미리 보고 여러분의 동의를 기다리라고 지시하지만, 그것은 지시이지 잠금장치가 아닙니다. 셸 명령에 대한 에이전트의 승인 프롬프트는 켜 두고, 설정에서 `mo clean`이나 `Remove-Item`을 미리 허용하지 마세요. 앱 제거와 관리자 정리는 에이전트에서 아예 실행할 수 없습니다.

### 휴지통이나 게임 저장 파일도 지워지나요?

Windows에서 `mo clean`은 휴지통을 비우지 않고, 요청하지 않는 한 게임 미디어와 셰이더 캐시도 건너뜁니다. 게임 저장 파일과 라이브러리는 사용자 데이터이고, 이를 지우는 Mole 명령은 없습니다. 다만 앱 자체의 제거 프로그램은 여전히 그 폴더 안의 데이터를 지울 수 있습니다. 에이전트가 앱 제거를 여러분에게 넘기는 이유입니다.

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

네. GPL-3.0 오픈 소스이고, 스킬도 같은 저장소에 있습니다. Mole for Windows는 창이 있는 별도의 유료 앱이며, 차이는 [Mole CLI for Windows와 Mole for Windows, 각각 무엇을 하나](/ko/windows/blog/mole-cli-vs-windows-app)에 정리했습니다.

### Mac에서도 같은 설정이 되나요?

네. 스킬은 `mo --version`을 읽고 Mac에서는 macOS 명령을 씁니다. Mac에서는 제거한 앱이 휴지통으로 가고, `mo clean`이 기본적으로 휴지통을 비웁니다. 이 가이드의 Mac 버전은 [Claude Code나 Codex로 Mac 공간을 안전하게 확보하는 방법](/blog/use-claude-code-to-clean-up-mac)입니다.

## 관련 글

- [Windows C 드라이브가 가득 찼을 때 정리, 이동, 제거 중 고르기](/ko/windows/blog/windows-c-drive-full): 공간이 보통 어디로 가는지.
- [Windows 개발 캐시, npm과 pip와 Gradle이 담는 것](/ko/windows/blog/windows-developer-caches): npm, pip, Gradle 등 코딩 도구가 채우는 저장소.
- [Windows 드라이브를 채우는 항목 찾기](/ko/windows/blog/find-large-files-on-windows): 같은 검색을 손으로 하는 방법.


Canonical: https://mole.fit/ko/windows/blog/use-claude-code-to-clean-up-windows