ComfyUI가 모델 파일을 찾지 못할 때 해결 방법

ComfyUI 워크플로를 실행할 때 빨간 노드, 빈 모델 드롭다운, 또는 "Model not found" / "Checkpoint not found" 오류가 보이면, ComfyUI가 그 워크플로에 필요한 모델 파일을 보지 못한다는 뜻입니다.

대부분 파일이 손상된 것이 아닙니다. 모델을 아직 다운로드하지 않았거나, 잘못된 폴더에 넣었거나, 실행 중인 ComfyUI가 아닌 다른 설치 폴더에 넣은 경우가 많습니다.

지금 보이는 상황과 가장 가까운 항목부터 확인하세요.

지금 어떤 상황인가요?

상황 A: 모델이 없다는 메시지가 나오거나 모델 드롭다운이 비어 있음

공유 워크플로를 가져온 뒤 Queue Prompt를 눌렀을 때 X required models are missing, Checkpoint not found가 나오거나, 로더의 모델 드롭다운에 선택할 항목이 없습니다.

 ╭─────────────────────────╮
 │ 🔴 Load Checkpoint      │
 ├─────────────────────────┤
 │ ckpt_name               │
 │ ╭─────────────────────╮ │
 │ │ [Empty / None]    ▼ │ │
 │ ╰─────────────────────╯ │
 ╰─────────────────────────╯

👉 가능성이 큰 원인: 모델을 아직 다운로드하지 않았거나, ComfyUI가 스캔하는 폴더에 들어 있지 않습니다. 🔗 해결로 이동: 모델을 다운로드해서 올바른 폴더에 넣기

상황 B: 모델을 다운로드했는데도 ComfyUI가 찾지 못함

PC에서는 파일이 보이지만 ComfyUI 노드 드롭다운에는 나오지 않거나, 실행하면 여전히 찾지 못한다고 나옵니다.

👉 가능성이 큰 원인: 모델 하위 폴더가 틀렸거나, 다른 드라이브에 두고 extra_model_paths.yaml을 설정하지 않았거나, 다른 ComfyUI 설치 폴더에 넣었습니다. 🔗 해결로 이동: 폴더 위치와 모델 경로 설정 확인

상황 C: 폴더에는 파일이 있는데 워크플로가 계속 실패함

정확한 폴더를 열면 모델 파일이 보이지만 ComfyUI가 Value not in list: ckpt_name: 'xxx.safetensors' not in [] 같은 오류를 냅니다.

👉 가능성이 큰 원인: 워크플로에 저장된 파일명과 로컬 파일명이 다르거나, 다운로드가 불완전하거나, 로더가 다른 모델 종류를 요구합니다. 🔗 해결로 이동: 파일명 일치와 파일 무결성 확인

모델 문제가 맞는지 모르겠다면

먼저 아래 표로 방향을 확인하세요.

ComfyUI 검증 오류는 보통 이렇게 보입니다.

Prompt outputs failed validation:
CheckpointLoaderSimple:
- Value not in list: ckpt_name: 'model-name.safetensors' not in []

상황 A: 모델을 다운로드해서 올바른 폴더에 넣기

공유 워크플로 JSON에는 보통 모델 파일 자체가 포함되지 않습니다. 필요한 모델 파일을 받은 뒤, 해당 로더가 읽는 위치에 넣어야 합니다.

수동 단계:

1. 누락된 파일명을 확인합니다. 빨간 노드, 검증 오류, missing model 알림을 봅니다. 예: v1-5-pruned-emaonly.safetensors.
2. 그 정확한 파일을 다운로드합니다. 보통 Hugging Face 또는 Civitai에서 찾습니다. 워크플로 작성자가 특정 모델명을 적었다면 같은 이름부터 찾으세요.
3. 맞는 하위 폴더에 넣습니다. 가장 자주 틀리는 부분입니다.

자주 쓰는 ComfyUI 모델 폴더:

ComfyUI/
└── models/
    ├── checkpoints/       ← SD 1.5 / SDXL 체크포인트
    ├── loras/             ← LoRA 파일
    ├── vae/               ← VAE 파일
    ├── clip/              ← 일부 로더가 쓰는 CLIP 파일
    ├── text_encoders/     ← 새 워크플로에서 쓰는 텍스트 인코더
    ├── controlnet/        ← ControlNet 모델
    ├── upscale_models/    ← ESRGAN 같은 업스케일러
    ├── embeddings/        ← Textual Inversion 임베딩
    ├── clip_vision/       ← IP-Adapter용 CLIP Vision
    ├── ipadapter/         ← IP-Adapter 모델
    ├── diffusion_models/  ← 독립 diffusion / UNet 모델
    ├── unet/              ← 예전 구성이나 커스텀 노드용 UNet 폴더
    └── sams/              ← Segment Anything 모델

4. ComfyUI를 새로고침합니다. UI에 모델 새로고침 버튼이 있으면 누르고, 없다면 ComfyUI를 완전히 재시작해 폴더를 다시 스캔하게 합니다.

PowerShell로 폴더를 확인할 수도 있습니다.

dir ComfyUI\models\checkpoints\

checkpoints는 사용하는 로더에 맞는 폴더명으로 바꾸세요.

상황 B: 폴더 위치와 모델 경로 설정 확인

파일이 PC에 있다고 확실하다면, 설정 파일을 수정하기 전에 간단한 확인부터 하세요.

수동 확인:

1단계: 올바른 하위 폴더에 있는지 확인

가장 흔한 실수는 LoRA를 checkpoints/에 넣거나, 체크포인트를 loras/에 넣는 것입니다.

✗ 잘못된 예:
ComfyUI/models/checkpoints/my_lora.safetensors

✓ 올바른 예:
ComfyUI/models/loras/my_lora.safetensors

상황 A의 폴더 표를 보고 파일 종류와 로더를 맞추세요.

2단계: 실행 중인 ComfyUI에 넣었는지 확인

포터블 버전, Git 설치 버전, Launcher 관리 버전, 다른 통합 패키지 등 여러 ComfyUI가 있다면, 지금 실행 중인 것이 어느 것인지 먼저 확인하세요.

ComfyUI 시작 시 콘솔에 표시되는 경로가 좋은 단서입니다. 경로를 확인한 뒤 파일을 옮기세요.

3단계: 모델이 다른 드라이브에 있다면 외부 경로 설정

모델이 D:/AI/models/처럼 ComfyUI 폴더 밖에 있을 때만 이 단계를 사용합니다.

1. ComfyUI 루트에서 extra_model_paths.yaml.example을 찾습니다.
2. extra_model_paths.yaml로 복사하거나 이름을 바꿉니다.
3. 경로를 수정합니다.

my_models:
    base_path: D:/AI/models/
    checkpoints: checkpoints/
    loras: loras/
    vae: vae/
    controlnet: controlnet/

4. 저장하고 ComfyUI를 완전히 재시작합니다.

사용자 지정 설정 경로로 ComfyUI를 실행한다면, 현재 프로세스가 같은 설정 파일을 읽는지 확인하세요. 최근 ComfyUI는 --extra-model-paths-config로 하나 이상의 추가 모델 경로 파일을 읽을 수도 있지만, 대부분의 사용자는 ComfyUI 폴더 안의 extra_model_paths.yaml부터 시작하면 충분합니다.

상황 C: 파일명 일치와 파일 무결성 확인

모델이 올바른 폴더에 있는데도 실패한다면, 아래 두 가지를 확인하세요.

1. 파일명이 워크플로에 저장된 이름과 다름

워크플로에는 원작성자가 선택했던 모델명이 저장됩니다. 워크플로가 sdxl_base_1.0.safetensors를 요구하는데 로컬 파일명이 sdxl_base.safetensors라면, ComfyUI는 서로 다른 선택지로 봅니다.

 ╭─────────────────────────╮
 │ 🔴 Load Checkpoint      │
 ├─────────────────────────┤
 │ ckpt_name               │
 │ ╭─────────────────────╮ │
 │ │ sdxl_base_1.0...  ▼ │ │ ← 이 정확한 이름이 없음
 │ ╰─────────────────────╯ │
 ╰─────────────────────────╯

해결: 노드의 모델 드롭다운을 열고 실제 로컬에 있는 파일명을 다시 선택합니다. 파일명을 바꿔도 될 때가 있지만, 노드에서 로컬 파일을 다시 선택하는 편이 보통 더 안전합니다.

2. 다운로드가 완전히 끝나지 않음

모델 파일은 큽니다. 브라우저 다운로드 실패나 프록시 끊김 때문에 작은 불완전 파일만 남을 수 있습니다.

원래 몇 GB여야 하는 모델이 몇 KB나 몇백 MB밖에 없다면 삭제하고 다시 다운로드하세요. Windows .lnk 바로가기를 모델 파일로 쓰면 안 됩니다. ComfyUI에는 실제 모델 파일 또는 제대로 설정된 모델 경로가 필요합니다.

고쳤다면 마지막으로 확인할 것

모델을 옮기거나 다운로드하거나 경로를 설정한 뒤에는 아래를 확인하세요.

1. ComfyUI를 새로고침하거나 재시작해서 모델 폴더를 다시 스캔하게 합니다.
2. 워크플로를 다시 Queue해서 원래 빨간 노드가 사라졌는지 확인합니다.
3. 다음 누락 모델을 확인합니다. 한 워크플로가 여러 파일을 요구하는 경우가 흔합니다.
4. 모델 종류가 맞는지 확인합니다. 파일이 드롭다운에 보여도 실행이 실패하면 다른 checkpoint, LoRA, VAE, ControlNet, diffusion model, text encoder, GGUF가 필요할 수 있습니다.

다음부터 폴더를 직접 찾고 싶지 않다면

워크플로를 가져올 때마다 모델을 찾고, 폴더를 맞추고, 외부 경로를 고치느라 시간이 든다면 Wonderful Launcher 다운로드를 시도해볼 수 있습니다. 모든 비공개 모델을 자동으로 만들어주지는 않지만, 지원되는 워크플로와 모델 소스에서는 수동 경로 추측을 많이 줄일 수 있습니다.

관련 가이드

• Where ComfyUI Stores Checkpoints
• Model Path Not Detected
• Where to Put Safetensors in ComfyUI
• Install Models in ComfyUI
• Workflow Missing Nodes
• ComfyUI Common Issues

참고 자료

• ComfyUI GitHub
• Official ComfyUI model troubleshooting
• ComfyUI extra_model_paths.yaml.example