ComfyUI 모델 폴더는 어디에 있나요? 기본 경로와 추가 경로
포터블 또는 수동 ComfyUI 설치에서 기본 모델 라이브러리는 ComfyUI/models/입니다. 각 파일을 모델 유형에 맞는 하위 폴더에 넣으세요. 체크포인트는 models/checkpoints, LoRAs는 models/loras, VAEs는 models/vae입니다. 파일이 이미 공유 라이브러리에 있다면 전체 사본을 하나 더 만들지 말고 해당 라이브러리를 추가 모델 경로로 지정하세요.
기본 ComfyUI 모델 폴더
ComfyUI는 models을 구분 없는 하나의 바구니로 취급하지 않습니다. 로더는 해당 모델 유형용으로 등록된 폴더를 찾습니다. 기본 ComfyUI LoRA 폴더는 ComfyUI/models/loras입니다. 체크포인트를 그곳에 두어도 여전히 체크포인트입니다. 위치를 바꾼다고 파일 내용이 바뀌지 않습니다.
ComfyUI/
└── models/
├── checkpoints/ # 완전한 확산 체크포인트
├── diffusion_models/ # 확산 또는 UNet 가중치
├── loras/ # LoRA 및 관련 어댑터 파일
├── text_encoders/ # 텍스트 인코더 가중치
├── vae/ # VAE 모델
└── controlnet/ # ControlNet 및 T2I 어댑터 모델
현재 공식 구성 예시는 unet 및 clip 같은 이전 이름도 인식합니다. 새롭고 깔끔한 라이브러리에는 위에 표시된 현재 이름을 우선하세요. 다른 노드 유형은 더 많은 폴더를 등록할 수 있으므로 사용자 지정 노드 패키지가 이 짧은 목록에 없는 모델 위치를 추가할 수 있습니다.
ComfyUI Desktop: 추측하지 말고 폴더 열기
애플리케이션이 레이아웃을 더 많이 관리하므로 Desktop 설치는 오해하기 쉽습니다. ComfyUI Desktop에서 Help → Open Folder → Open Model Folder를 사용하세요. 활성 위치가 열리므로 이전 설치에 속한 비슷한 이름의 폴더로 모델을 복사하는 일을 피할 수 있습니다.
이는 파일이 나타나지 않을 때 가장 빠른 진단이기도 합니다. 파일 시스템 검색에서 반환된 첫 ComfyUI 디렉터리가 아니라 실행 중인 애플리케이션이 사용하는 모델 폴더를 보고 있는지 확인하세요.
추가 모델 경로가 더 깔끔한 답인 경우
두 ComfyUI 설치가 같은 라이브러리를 봐야 하거나, 다른 UI가 이미 파일을 소유하거나, 대형 모델이 다른 디스크에 있을 때 추가 경로가 유용합니다. ComfyUI에 검색할 다른 위치를 알려 줄 뿐 모델을 복사, 변환, 병합 또는 백업하지 않습니다.
불편한 점은 포터블·수동 ComfyUI와 ComfyUI Desktop이 동일한 구성 파일 이름을 사용하지 않는다는 것입니다.
- 포터블 또는 수동 설치:
ComfyUI/extra_model_paths.yaml.example을ComfyUI/extra_model_paths.yaml로 복사한 뒤 사본을 편집하세요. - Windows의 Desktop:
C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml을 편집하세요. - macOS의 Desktop:
~/Library/Application Support/ComfyUI/extra_models_config.yaml을 편집하세요.
Desktop이 생성한 항목을 유지하세요. 공식 Desktop 지침은 기존 파일을 교체하지 말고 구성을 추가하라고 안내합니다. 먼저 YAML을 백업하세요. 들여쓰기는 구문의 일부입니다.
작고 읽기 쉬운 추가 경로 구성
이름을 정한 라이브러리 하나와 실제로 공유하는 모델 유형만으로 시작하세요. base_path은 상위 디렉터리이며 나머지 값은 이를 기준으로 한 상대 경로입니다.
shared_models:
base_path: /Volumes/AI-Library/models/
checkpoints: checkpoints
loras: loras
vae: vae
controlnet: controlnet
text_encoders: text_encoders
diffusion_models: diffusion_models
Windows에서는 base_path에 D:\AI-Library\models\와 같은 절대 Windows 경로를 사용하세요. 실제 경로에 공백이 있으면 유지하세요. YAML 파서가 요구하기 전에는 따옴표나 이스케이프를 임의로 추가하지 마세요. 가장 간단한 구성은 대개 디스크의 폴더와 직접 비교할 수 있는 구성입니다.
재시작, 새로 고침 및 알려진 모델 하나로 입증
구성을 저장하고 ComfyUI를 재시작하세요. 공식 모델 가이드는 r이 노드 정의를 새로 고친다고도 설명하지만 모델 경로를 바꾼 뒤에는 재시작이 더 명확한 확인 방법입니다. 그런 다음 식별 가능한 파일로 설정을 입증하세요.
- 외부 라이브러리에서 알려진 체크포인트 하나와 알려진 LoRA 하나를 선택하세요.
- 각 파일이 인터페이스 어딘가에만 표시되는 것이 아니라 적절한 로더에 나타나는지 확인하세요.
- 기존의 작은 워크플로를 로드하고 두 파일을 실제로 열 수 있는지 확인하세요.
- 새로 재시작한 뒤 테스트에 성공할 때까지 원래 위치를 그대로 두세요.
모델이 누락되면 활성 모델 폴더, YAML 들여쓰기, base_path, 유형별 하위 폴더, 파일 확장자 순으로 확인하세요. YAML 파싱 성공이 체크포인트가 체크포인트 폴더에 분류되었음을 증명하지는 않습니다.
추가 경로는 보존 계획이 아닙니다
공유 디렉터리는 중복 작업 사본을 막을 수 있지만 여전히 실시간 런타임 저장소입니다. 여기서 삭제하면 이 디렉터리를 가리키는 모든 ComfyUI 설치에 영향을 줄 수 있습니다. 마찬가지로 두 애플리케이션이 볼 수 있다고 해서 SafeTensors 파일이 백업된 것은 아닙니다.
런타임 문제를 해결한 다음에 Tensor Archive를 사용하세요. 완료된 연관 패밀리, 예를 들어 베이스 체크포인트와 어댑터를 식별한 뒤 해당 패밀리를 별도로 보관, 검증 및 복원하세요. Tensor Archive는 ComfyUI 구성을 다시 쓰거나 소스 폴더를 몰래 제거하지 않습니다.
실제로 겪는 문제에 따라 다음 가이드 선택
기본 경로와 추가 경로에 걸쳐 워크플로를 보존해야 한다면 ComfyUI 모델 백업 가이드를 사용하세요. SSD가 이미 어댑터로 가득하다면 LoRA 라이브러리에서 디스크 공간을 확보하는 실용 가이드를 따르세요. 학습 방법과 그로 인해 생기는 어댑터 산출물의 차이는 LoRA와 QLoRA 비교를 읽으세요.
출처
- ComfyUI 문서: 모델 — 기본 모델 폴더, Desktop 위치, 추가 경로 구성 및 문제 해결.
- ComfyUI: extra_model_paths.yaml.example — 현재 키와 포터블·수동 구성 구조.
- ComfyUI: folder_paths.py — 현재 기본 폴더 등록 및 이전 별칭.
- ComfyUI 문서: LoRA 로드 — 문서화된 LoRA 파일 기본 위치.