윈도우 업데이트 전에 Hugging Face 캐시 비우기 (SATA SSD)

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

대형 업데이트는 20~30GB의 여유를 요구합니다. Hugging Face 캐시는 5~500GB 정도라 그 일부를 채웁니다. 업데이트 직전에 비우면 설치가 통과할 확률이 눈에 띄게 올라갑니다.
항목내용
무엇인가Hugging Face 모델 캐시 (.cache/huggingface)
분류AI 모델·캐시
전형적인 크기5~500GB
안전도지워도 됩니다
지운 뒤 다시 생기나생깁니다
첫 번째 자리%USERPROFILE%\.cache\huggingface\hub
기준 환경SATA SSD

얼마나 필요한가

SATA SSD 기준으로 전체 용량의 10% 입니다.

설치 중에 임시로 더 쓰고 나중에 되돌려줍니다. 그래서 "설치 파일 크기"보다 훨씬 많은 자리를 요구합니다.

Hugging Face 캐시 비우기

아래 순서대로 하면 됩니다. 중간에 프로그램이 켜져 있으면 일부 파일이 "사용 중"으로 남으니, 먼저 닫고 시작하세요.

  1. pip install huggingface_hub 후 huggingface-cli scan-cache 로 목록과 크기를 봅니다
  2. huggingface-cli delete-cache 로 대화형으로 골라 지웁니다
  3. 통째로 지우려면 %USERPROFILE%\.cache\huggingface\hub 폴더를 삭제합니다

명령어로 한 번에

창을 여러 개 열지 않고 끝내려면 아래 한 줄이면 됩니다.

목록과 크기만 보여줍니다. 지울 때는 delete-cache 를 쓰세요.

huggingface-cli scan-cache

같이 비우면 좋은 것

디스크 정리 → 시스템 파일 정리 → 이전 Windows 설치, Windows 업데이트 정리. 여기서 대개 가장 큰 덩어리가 나옵니다.

다운로드 폴더의 설치 파일. 이미 깐 프로그램의 설치 파일은 남길 이유가 없습니다.

그래도 부족하면

업데이트 화면에서 USB 메모리를 임시 작업 공간으로 쓰겠냐고 물어봅니다. 8GB 이상 USB를 꽂으면 그쪽을 빌려 씁니다.

외장 드라이브에 큰 폴더를 통째로 옮겨 두고, 업데이트가 끝난 뒤 되돌리는 방법도 있습니다.

SATA SSD에서는 무엇이 다른가

SATA SSD는 NVMe보다 느리지만 같은 원리로 움직입니다. 꽉 차면 느려지고, 지운 뒤 TRIM이 돌아야 실제로 자리가 납니다.

오래 쓴 SATA SSD라면 지우기 전에 SMART 상태를 한 번 보세요. 수명이 다해가는 디스크는 정리보다 교체가 먼저입니다.

이 환경에서 남겨 둘 여유 용량은 전체 용량의 10% 정도로 잡으세요. 조각 모음을 돌리지 마세요. SSD에는 수명만 깎고 효과가 없습니다.

지금 얼마나 차지하는지 확인하기

huggingface-cli scan-cache 를 실행하면 모델별 크기와 마지막 사용일이 나옵니다. 또는 %USERPROFILE%\.cache\huggingface 폴더 속성으로 보세요.

숫자를 한 번 적어 두세요. 정리한 뒤 다시 재서 비교해야 효과를 알 수 있고, 다음 달에 같은 자리가 또 커졌다면 그건 지울 게 아니라 설정을 바꿔야 하는 항목입니다.

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

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

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

자주 묻는 질문

업데이트가 0x80070070 오류로 실패합니다.

용량 부족 오류 코드입니다. 이 문서대로 자리를 만들고 다시 시도하세요. 20GB 이상 확보하면 대부분 통과합니다.

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

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

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

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

Hugging Face 캐시에 대한 다른 문서

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

환경별로 보기

환경 구분 없이 보기

같이 보면 좋은 것

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