Qwen Image setup, ComfyUI 템플릿이 안 보일 때 확인할 것

Qwen Image setup에서 의외로 자주 막히는 부분은 모델 다운로드 자체가 아니다. 파일을 정확한 폴더에 넣었는데도 Qwen Image 공식 템플릿이 보이지 않거나, workflow를 불러왔을 때 일부 노드가 없다고 표시되는 경우가 있다.

이때 모델을 다시 받기 전에 먼저 확인할 것은 ComfyUI 버전과 모델 목록 갱신 상태다. Qwen Image는 native workflow를 사용하기 때문에 오래된 ComfyUI에서는 템플릿이나 필요한 core node가 아직 포함되지 않았을 수 있다.

qwen image setup에서 가장 먼저 볼 변화

Qwen Image 템플릿이 없다면 ComfyUI 버전부터 확인한다

ComfyUI의 Qwen-Image 공식 안내에서는 workflow를 사용하기 전에 ComfyUI를 최신 상태로 업데이트하라고 명시한다.

업데이트가 완료된 환경에서는 Workflow Templates에서 Qwen Image workflow를 찾거나 공식 workflow 파일을 직접 불러올 수 있다. 반대로 템플릿 목록에 Qwen Image 자체가 없다면 모델 파일보다 먼저 ComfyUI가 오래된 상태인지 확인해야 한다.

Desktop과 Portable은 업데이트 시점이 다를 수 있다

ComfyUI Desktop은 stable release를 기반으로 업데이트된다. 새 core node가 Nightly에 먼저 들어간 시점이라면 Desktop stable에서는 아직 해당 기능이 보이지 않을 수 있다.

따라서 공식 문서에 있는 노드가 자신의 ComfyUI에는 없다고 해서 곧바로 custom node 설치 문제라고 단정할 필요는 없다. 사용 중인 ComfyUI 배포 방식과 버전 차이를 먼저 구분하는 것이 좋다.

공식 workflow를 열었는데 missing node가 표시되는 경우도 같은 기준으로 볼 수 있다. 최신 ComfyUI인데도 노드가 없다면 startup 과정에서 일부 node import가 실패했는지도 함께 확인해야 한다.

Qwen Image 모델 파일은 세 종류가 각각 인식돼야 한다

Qwen Image용 ComfyUI 구성은 일반적인 checkpoint 하나를 models/checkpoints에 넣는 구조와 다르다.

qwen image setup가 ComfyUI 워크플로우에 미치는 영향

Qwen-Image-2512를 기준으로 보면 diffusion model, text encoder, VAE가 서로 다른 폴더에서 로드된다.

기존 방식과 비교해야 할 부분

qwen_image_2512_fp8_e4m3fn.safetensors → models/diffusion_models

qwen_2.5_vl_7b_fp8_scaled.safetensors → models/text_encoders

qwen_image_vae.safetensors → models/vae

잘못된 폴더에 있으면 loader dropdown에서 찾기 어렵다

파일 자체가 정상적으로 다운로드됐더라도 저장 위치가 다르면 해당 loader의 목록에 나타나지 않는다.

예를 들어 Qwen Image diffusion model을 일반 checkpoint 폴더에 넣는 방식으로는 공식 native workflow가 기대하는 위치와 맞지 않는다. 파일 이름보다 먼저 어떤 종류의 모델을 어느 loader가 읽는지를 구분해야 한다.

따라서 setup이 끝났는데 workflow에 null이 뜨거나 원하는 파일을 선택할 수 없다면 모델을 다시 다운로드하기 전에 폴더 위치부터 다시 확인하는 것이 빠르다.

성능과 결과 품질에서 확인할 차이

모델 파일을 넣은 뒤에는 model list를 refresh한다

워크플로우 구성에서 놓치기 쉬운 부분

ComfyUI를 실행한 상태에서 모델 파일을 새로 추가했다면 현재 열린 화면의 model dropdown에 즉시 나타나지 않을 수 있다.

ComfyUI에서는 모델을 추가하거나 변경한 뒤 R 키를 눌러 object definition과 model list를 refresh할 수 있다. 새 diffusion model이나 text encoder가 목록에 보이지 않을 때 가장 먼저 해볼 수 있는 단계다.

refresh로 안 되면 ComfyUI를 재시작한다

R을 눌러도 모델이 나타나지 않는다면 ComfyUI 자체를 종료하고 다시 실행해 보는 것이 좋다.

모델 로딩 문제에 대한 공식 안내에서도 저장 경로를 확인한 뒤 refresh 또는 restart를 시도하도록 설명한다. 특히 여러 모델 파일을 한꺼번에 넣은 직후라면 재시작을 통해 전체 목록을 다시 읽게 하는 편이 단순하다.

여기까지 했는데도 특정 모델만 보이지 않는다면 파일 위치, 파일 다운로드 완료 여부, startup 로그를 차례대로 확인하면 된다. setup 문제를 workflow 설정 문제와 섞어서 보지 않는 것이 중요하다.

공식 workflow에서 loader 선택 상태를 확인한다

실제로 적용할 때 체크할 점

템플릿이 정상적으로 열렸다고 해서 setup이 모두 끝난 것은 아니다.

Workflow를 불러온 뒤 diffusion model loader에는 Qwen Image diffusion model이, text encoder loader에는 Qwen2.5-VL 파일이, VAE loader에는 Qwen Image VAE가 실제로 선택돼 있는지 확인해야 한다.

모델 파일이 여러 버전 존재하는 환경에서는 workflow가 기대한 파일과 현재 dropdown 선택이 다를 수도 있다. 특히 기존 Qwen-Image와 Qwen-Image-2512를 함께 보관하고 있다면 파일 이름을 한 번 더 확인하는 편이 좋다.

missing node와 missing model은 구분해서 본다

Qwen Image setup 오류를 해결할 때 가장 중요한 구분 중 하나다.

노드 자체가 보이지 않는다면 ComfyUI 버전이나 node import 문제에 가깝다. 반대로 노드는 정상적으로 있는데 dropdown에 모델만 없거나 null로 표시된다면 저장 위치 또는 model list 갱신 문제일 가능성을 먼저 확인해야 한다.

두 문제를 구분하지 않고 모델을 계속 다시 다운로드하거나 custom node를 추가하면 원인을 찾기 더 어려워질 수 있다. 먼저 화면에서 무엇이 실제로 빠져 있는지를 확인하는 것이 좋다.

Qwen Image setup에서 모델 파일을 제대로 넣었는데도 실행이 안 된다면 ComfyUI 업데이트 → 공식 template 확인 → 모델 저장 폴더 확인 → R로 refresh → 재시작 순서로 점검하면 된다.

특히 Qwen Image는 diffusion model·text encoder·VAE가 각각 다른 폴더에 들어가고, native workflow는 최신 core node를 요구할 수 있다는 점을 먼저 기억하는 것이 좋다. missing node인지 missing model인지부터 구분하면 setup 과정에서 불필요하게 모델을 다시 받는 일을 줄일 수 있다.