ComfyUI 설치 및 첫 이미지 생성

Comfy Desktop은 ComfyUI의 공식 데스크톱 프로그램으로, ComfyUI와 필요한 실행 환경을 함께 설치합니다. Python, CUDA 또는 pip를 별도로 설정할 필요가 없습니다. 한 컴퓨터에 여러 설치 인스턴스를 유지할 수도 있으며, 각 인스턴스는 서로 영향을 주지 않으므로 버전이나 설정을 따로 시험하기에 적합합니다.

설치 전 준비

먼저 컴퓨터가 다음 조건을 충족하는지 확인하세요.

Windows 10 이상이며 x64 또는 ARM64를 지원해야 합니다. NVIDIA 또는 AMD 외장 그래픽 카드 사용을 권장하지만, 외장 그래픽 카드가 없어도 설치할 수 있습니다.
macOS 13(Ventura) 이상이며 Apple Silicon(M1 이상)이 필요합니다.
Linux. 설치 패키지는 .deb와 AppImage로 제공되며, Ubuntu 22.04 이상과 x64 아키텍처를 권장합니다.

ComfyUI 설치 인스턴스 하나당 약 4.85 GB의 디스크 공간이 필요합니다. 메모리는 최소 8 GB가 필요하며, 16 GB가 사용하기에 더 적합합니다. 이후 다운로드하는 이미지 모델도 추가 디스크 공간을 차지합니다.

macOS

dmg 열기

응용 프로그램으로 드래그
처음에는 개인정보 보호 및 보안으로 이동
그래도 열기 클릭

Windows

exe 실행

Windows 10 이상
x64 또는 ARM64
시작 페이지에서 설치 생성

Linux

deb 또는 AppImage

Ubuntu 22.04+ 권장
x64
실행에 실패하면 샌드박스 설명 확인

다운로드 페이지가 사용 중인 시스템을 감지합니다. 해당 플랫폼용 설치 패키지를 선택하고 서로 혼용하지 마세요.

설치 및 첫 실행

Comfy Desktop 다운로드 페이지에서 설치 패키지를 받으세요. 페이지가 현재 사용 중인 시스템을 자동으로 감지합니다.

macOS

다운로드한 .dmg를 엽니다.
Comfy Desktop을 응용 프로그램 폴더로 드래그합니다.
Launchpad 또는 Spotlight 검색에서 Comfy Desktop을 엽니다.

처음 실행할 때 macOS에서 보안 경고를 표시할 수 있습니다. 이 경우 시스템 설정의 Privacy & Security(개인정보 보호 및 보안)를 열고 Open Anyway(그래도 열기)를 클릭하세요. 이 버튼을 누르면 시스템에서 방금 차단한 앱을 실행할 수 있습니다.

Windows

다운로드한 .exe(NSIS 설치 패키지)를 실행하고 화면 안내에 따라 설치를 완료한 다음, 시작 메뉴나 바탕 화면 바로 가기에서 Comfy Desktop을 엽니다.

처음 실행하면 시작 화면이 표시되며, 여기에서 첫 번째 ComfyUI 설치 인스턴스를 만들 수 있습니다.

Linux

Linux에서는 공통 다운로드 링크를 사용합니다. Debian 또는 Ubuntu 사용자는 설치 패키지가 있는 다운로드 디렉터리로 이동한 후 다음을 실행하세요.

sudo apt install ./*.deb

AppImage를 사용하는 경우 다음을 실행하세요.

chmod +x ./*.AppImage
./*.AppImage

앱 실행에 실패한다면 Linux 배포판이 Electron 샌드박스를 차단했을 수 있습니다. Ubuntu 24.04 이상에서는 AppArmor가 권한 없는 사용자 네임스페이스를 제한합니다. 샌드박스 실행 실패가 확실한 경우에만 --no-sandbox를 추가해 다시 시도하세요. 이 매개변수는 각 프로세스의 Electron 샌드박스를 비활성화하므로 다른 상황에서는 사용하지 않는 것이 좋습니다.

Comfy Desktop을 열면 Chooser 페이지에 기존 설치 인스턴스가 표시됩니다. New Instance를 클릭해 서로 독립된 새 ComfyUI 설치 인스턴스를 만든 다음, 해당 인스턴스 카드를 클릭해 실행하세요.

데스크톱 버전은 기본적으로 안정 버전을 추적합니다. GitHub의 최신 커밋을 모두 따라가려면 포터블 버전이나 수동 git 설치를 사용하거나 인스턴스의 업데이트 채널을 Latest on GitHub로 변경할 수 있습니다.

OmniProxy에서 연결 매개변수 가져오기

여기에는 입력할 수 있는 공통 주소, 키 또는 모델 ID가 없습니다. Comfy Desktop을 설치하고 기본 텍스트 이미지 생성 과정을 완료하는 데 OmniProxy는 필요하지 않습니다.

출처가 불분명한 노드에 다른 도구의 Base URL을 입력하지 마세요. 명확한 공통 연동 안내가 제공된 후 별도로 설정하세요.

도구 설정 입력

여기에는 OmniProxy 설정 양식이 없습니다. 첫 이미지를 생성하려면 먼저 워크플로와 이미지 모델을 준비해야 합니다.

워크플로는 이미지 생성 단계의 집합으로 이해할 수 있으며, 노드는 그 안에서 모델을 불러오거나 텍스트를 입력받거나 이미지를 저장하는 작업 모듈입니다. ComfyUI가 실행되면 일반적으로 기본 텍스트 이미지 생성 워크플로가 자동으로 로드됩니다.

다른 워크플로를 열려면 메뉴에서 Workflows → Open을 선택하세요. 이 옵션은 워크플로 정보가 포함된 이미지 또는 JSON 워크플로 파일을 불러오는 데 사용됩니다.

대부분의 설치에는 기본 모델이 포함되어 있지 않습니다. 워크플로를 불러온 후 컴퓨터에 v1-5-pruned-emaonly-fp16.safetensors가 없으면 인터페이스에 모델 누락 경고가 표시됩니다. 경고를 열면 누락된 모델과 다운로드 링크를 확인할 수 있습니다.

현재 설치에서 사용하는 모델 디렉터리를 확인하려면 상단의 캡슐형 메뉴를 클릭한 다음 Storage를 여세요. 이 메뉴에서 모델 등의 파일이 실제로 저장되는 위치를 확인할 수 있습니다. 상단 캡슐형 메뉴는 데스크톱 앱에서만 제공됩니다. 디렉터리 옆의 폴더 아이콘을 클릭하면 시스템 파일 관리자에서 해당 디렉터리를 바로 열 수 있습니다.

모델은 다음 두 가지 방법으로 다운로드할 수 있습니다.

인터페이스에서 Download를 클릭합니다. 이 버튼을 누르면 누락된 모델 다운로드가 시작됩니다. 데스크톱 버전은 모델을 현재 설치의 ComfyUI/models/checkpoints에 저장하며, 다운로드 진행 상황은 사이드바의 모델 패널에서 확인할 수 있습니다. 자동 다운로드는 일반적으로 Hugging Face를 통해 이루어지므로 네트워크에서 Hugging Face에 접속할 수 있어야 합니다.
오랫동안 다운로드 진행 상황이 표시되지 않으면 누락된 모델의 상세 정보에서 다운로드 링크를 복사하고 파일을 직접 다운로드하세요. 파일을 같은 checkpoints 디렉터리에 저장한 다음 ComfyUI를 새로 고치거나 다시 시작합니다.

모델을 배치한 후 키보드에서 R을 눌러 인터페이스가 노드의 모델 목록을 다시 읽게 하세요.

애플리케이션

Comfy Desktop

환경 설치를 담당함
시작 페이지 또는 새 인스턴스
카드를 클릭해 실행

워크플로

텍스트로 이미지 생성

일반적으로 자동으로 불러옴
메뉴에서도 열 수 있음
모델이 없으면 경고가 표시됨

모델

checkpoints

경고에 있는 링크에서 다운로드
데스크톱 버전은 자동 저장 가능
R을 눌러 목록 새로 고침

먼저 앱을 설치해 연 다음 워크플로를 불러오고, 마지막으로 안내에 따라 체크포인트 모델을 추가하세요.

실제 작업 검증

모델 준비를 마쳤다면 다음 단계에 따라 첫 이미지 생성을 시도하세요.

Load Checkpoint 노드에서 v1-5-pruned-emaonly-fp16.safetensors를 선택합니다. 이 노드는 이번 이미지 생성에 사용할 모델을 불러옵니다.
Run을 클릭하거나 Ctrl + Enter를 누릅니다. Run은 현재 이미지 생성 작업의 실행을 시작합니다.
생성 결과는 Save Image 노드에 표시됩니다. 이 노드는 최종 이미지를 미리 보고 저장하는 데 사용되며, 이미지를 마우스 오른쪽 버튼으로 클릭해 컴퓨터에 저장할 수 있습니다.

Load Checkpoint에 모델이 없거나 드롭다운에 null이 표시되면 먼저 모델 디렉터리를 확인한 다음 ComfyUI를 새로 고치거나 다시 시작하세요.

2026-10-09 기준으로 공식 dmg에서 받은 Comfy Desktop 1.1.6이 macOS에서 실행되는 것을 확인했습니다. 앱에서 설치 인스턴스를 만들고 체크포인트 모델을 다운로드하는 과정이 추가로 필요해 첫 이미지 생성 절차는 완료하지 않았습니다. 따라서 여기서는 이미지 생성에 성공했다고 설명하지 않으며, OmniProxy를 ComfyUI에 연동하지도 않았습니다.

모델

드롭다운에 이름이 있음

null이 아님
체크포인트 선택
R을 눌러 새로 고침함

생성

Run 클릭

또는 Ctrl+Enter 누르기
노드 실행이 끝날 때까지 기다리기
이미지는 Save Image에 있음

범위

우선 게이트웨이에 연결하지 않음

범용 설정 항목이 없음
출처가 불분명한 노드를 설치하지 않기
이미지 생성에 성공하면 됨

이미지가 Save Image 노드에 나타나야 첫 이미지 생성이 완료된 것입니다.

자주 발생하는 오류

macOS에서 열리지 않음: 시스템 설정 → 개인정보 보호 및 보안으로 이동해 그래도 열기를 클릭하세요. 설치 패키지는 Apple Silicon과 macOS 13 이상만 지원합니다.
Linux에서 실행 직후 종료됨: 먼저 .deb 또는 AppImage를 사용했는지 확인하세요. 샌드박스 실행 실패가 확실한 경우에만 --no-sandbox를 추가하세요.
모델 누락 안내가 표시됨: 경고에 포함된 링크를 통해 체크포인트 모델을 다운로드하고 현재 설치의 models/checkpoints에 저장한 다음 R을 눌러 새로 고치세요.
모델 드롭다운에 null이 표시됨: Storage에서 모델 디렉터리를 확인하고 파일이 올바른 위치에 있는지 확인한 다음 새로 고치거나 다시 시작하세요.
여기에서 OmniProxy를 입력하고 싶음: 현재 공통 연동 입력란은 없습니다. 공통 연동 방식이라고 명확히 안내되지 않은 노드를 추가로 설치하지 마세요.

공식 참고 자료

설치 개요는 Comfy Desktop을 참고하세요. 플랫폼별 설치 단계는 macOS, Windows, Linux를 참고하세요. 데스크톱 인터페이스 사용법은 Using Comfy Desktop을 참고하세요. 첫 이미지 생성 단계는 Getting Started with AI Image Generation을 참고하세요.

모든 플레이스홀더를 고유한 OmniProxy 구성의 값으로 바꾸세요. 실제 키를 게시하지 마세요.

저장된 결과나 HTTP 200 만으로는 전체 에이전트 호환성이 입증되지 않습니다. OmniProxy 호출 기록에서 소스와 모델을 확인하세요.

공식 소스 · ComfyUI ↗