다운로드 버전 선택

Windows x64Intel / AMD Windows Arm64Snapdragon / Arm

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

개발게시 9분 읽기

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에서 지워도 되는 캐시는 어느 것인가에서 폴더별로 하나씩 살펴봅니다.

설치

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

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 앱이 제거 뒤에 남기는 것을 참고하세요.

프로젝트 폴더와 시스템 파일 검사기. 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에만 해당하지 않습니다. 다른 도구를 쓸 때는 대화를 시작하면서 이런 내용을 붙여 넣으세요.

무엇이든 지우기 전에 먼저 목록을 보여 주고, 어떤 항목이 휴지통으로 가고 어떤 항목이 영구 삭제되는지 알려 줘.
도구의 미리보기나 -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, 각각 무엇을 하나에 정리했습니다.

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

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

관련 글