> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy CLI 문제 해결 가이드

> Comfy CLI에서 자주 발생하는 설정 문제를 해결합니다: git 미설치, Python 및 가상 환경 요구 사항, 브라우저 없는 Comfy Cloud 인증, GPU 라이브러리 설치.

Comfy CLI의 대부분의 문제는 필수 요구 사항이 빠졌거나 설정 단계를 건너뛰어서 발생합니다. 문제를 보고하기 전에 아래 항목을 순서대로 확인하세요.

## 사전 요구사항

Comfy CLI를 사용하려면 시스템에 [git](https://git-scm.com/downloads)이 설치되어 있어야 합니다. 먼저 git을 설치해야 `comfy install`과 `comfy update`가 ComfyUI와 커스텀 노드를 복제할 수 있습니다.

## 가상 환경에 ComfyUI 설치

`comfy install`은 현재 활성화된 Python 환경에 ComfyUI를 설치하며, Python 3.9 이상이 필요합니다. 먼저 가상 환경을 만들고 활성화하세요:

```bash theme={null}
python3 -m venv comfy-env
source comfy-env/bin/activate
comfy install
```

## GPU 라이브러리는 별도로 설치

`comfy install`은 CUDA나 ROCm을 설치하지 않습니다. 실행하기 전에 하드웨어에 맞는 GPU 라이브러리를 설치하세요. 설치하지 않으면 `comfy launch`로 시작한 ComfyUI가 GPU를 사용할 수 없습니다.

## 브라우저 없이 Comfy Cloud 설정

`comfy setup`은 브라우저로 로그인하므로 CI, devcontainer, 헤드리스 서버에서는 완료할 수 없습니다. 대신 API 키를 전달하고 비대화형 모드로 실행하세요:

```bash theme={null}
comfy setup --where cloud --api-key comfyui-... --non-interactive
```

## 추가 도움말

* [Comfy CLI 시작하기](/ko/comfy-cli/getting-started)에서 설치, 라우팅, 생성을 다룹니다.
* [Comfy CLI 명령 레퍼런스](/ko/comfy-cli/reference)에 모든 명령과 플래그가 정리되어 있습니다.
* 재현 가능한 CLI 버그는 [comfy-cli 저장소](https://github.com/Comfy-Org/comfy-cli/issues)에 보고하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.