Hugging Face 캐시 정리 체크리스트 (미니 PC)

AI 모델·캐시 · Hugging Face 모델 캐시 (.cache/huggingface) · 미니 PC 기준 · 2026-09-24 기준

순서는 ① 크기 재기 ② 프로그램 끄기 ③ 백업 없이 바로 지우기 ④ 지우기 ⑤ 다시 재서 확인 ⑥ 다음 점검일 정하기 입니다. ⑤를 빼먹으면 효과가 있었는지 알 수 없고, ⑥을 빼먹으면 두 달 뒤에 같은 일을 또 합니다.
항목내용
무엇인가Hugging Face 모델 캐시 (.cache/huggingface)
분류AI 모델·캐시
전형적인 크기5~500GB
안전도지워도 됩니다
지운 뒤 다시 생기나생깁니다
첫 번째 자리%USERPROFILE%\.cache\huggingface\hub
기준 환경미니 PC

체크리스트

위에서 아래로 그대로 따라 하면 됩니다.

  1. 현재 크기를 잰다 — huggingface-cli scan-cache 를 실행하면 모델별 크기와 마지막 사용일이 나옵니다. 또는 %USERPROFILE%\.cache\huggingface 폴더 속성으로 보세요.
  2. 해당 프로그램을 완전히 종료한다 (작업 관리자에서 남은 프로세스까지)
  3. 백업은 건너뛴다 — 다시 생기는 항목이다
  4. 폴더가 아니라 폴더 안의 내용만 지운다
  5. pip install huggingface_hub 후 huggingface-cli scan-cache 로 목록과 크기를 봅니다
  6. huggingface-cli delete-cache 로 대화형으로 골라 지웁니다
  7. 통째로 지우려면 %USERPROFILE%\.cache\huggingface\hub 폴더를 삭제합니다
  8. 휴지통을 비운다
  9. 다시 크기를 재서 얼마나 확보됐는지 확인한다
  10. 달력에 다음 점검일을 적는다

여기서 자주 빠뜨리는 것

프로그램 종료를 창 닫기로 끝내는 것. 트레이에 남아 있으면 파일이 잠겨서 절반만 지워집니다.

휴지통 비우기. 지운 게 휴지통으로 가면 용량은 그대로입니다.

지운 뒤 다시 재기. 이걸 안 하면 다음에도 같은 자리를 의심하게 됩니다.

미니 PC에서는 무엇이 다른가

미니 PC는 eMMC나 작은 SSD가 붙어 있는 경우가 많고, 발열 때문에 디스크 속도가 떨어지기도 합니다. 용량과 열을 같이 봐야 합니다.

대부분 M.2 슬롯이 하나는 있습니다. 정리로 버티기 전에 슬롯이 비어 있는지부터 확인해 보세요.

이 환경에서 남겨 둘 여유 용량은 최소 15GB 정도로 잡으세요. 기본 탑재 용량이 작아 업데이트 실패가 잦습니다.

지우면 무엇을 잃나

다음에 그 모델을 쓰는 코드를 돌리면 다시 받습니다. 시간이 오래 걸립니다.

지금 내 PC에서 얼마인지 보려면

테라클린은 이 문서에서 다룬 자리를 찾아 크기와 함께 목록으로 보여주고, 지워도 되는 이유와 안 되는 이유를 항목마다 적습니다. 지우기 전에 목록을 먼저 봅니다. 파일은 기기를 떠나지 않습니다.

Windows용 무료 다운로드 브라우저에서 체험 →

자주 묻는 질문

순서를 바꿔도 되나요?

크기 재기와 프로그램 종료는 먼저여야 합니다. 나머지는 순서를 바꿔도 결과가 같습니다.

Hugging Face 캐시를 지우면 프로그램이 망가지나요?

망가지지 않습니다. 다음에 그 모델을 쓰는 코드를 돌리면 다시 받습니다. 시간이 오래 걸립니다. 그 이상은 없습니다.

지운 뒤에도 용량이 안 줄어드는데요?

휴지통을 비웠는지 먼저 보세요. 그래도 그대로면 지운 파일을 아직 잡고 있는 프로그램이 있다는 뜻입니다. 재부팅 한 번이면 대개 반영됩니다. 재부팅 뒤에도 같다면 그 자리를 차지하는 건 Hugging Face 캐시가 아니라 다른 것입니다.

Hugging Face 캐시에 대한 다른 문서

Hugging Face 캐시 문서 전체 보기 (48편)

환경별로 보기

환경 구분 없이 보기

같이 보면 좋은 것

이 문서는 Hugging Face 모델 캐시 (.cache/huggingface)에 대한 정리 체크리스트 문서입니다(미니 PC 기준). 경로와 명령어는 확인한 것만 적었고, 확인하지 못한 항목은 비워 두었습니다. 지우기 전에 반드시 크기를 먼저 재고, 되돌릴 수 없는 항목은 사본을 두세요.