Comfy CLI 故障排查指南

Comfy CLI 的大多数故障都源于缺少前置条件或跳过了某个设置步骤。遇到问题时，请先按下面的顺序检查。

前置条件

Comfy CLI 需要系统已安装 git。请先安装 git，这样 comfy install 和 comfy update 才能克隆 ComfyUI 及其自定义节点。

comfy install 会把 ComfyUI 安装到当前激活的 Python 环境，该环境需要 Python 3.9 或更高版本。请先创建并激活虚拟环境：

python3 -m venv comfy-env
source comfy-env/bin/activate
comfy install

comfy install 不会安装 CUDA 或 ROCm。请在启动前安装与你的硬件匹配的 GPU 库，否则 comfy launch 启动的 ComfyUI 无法使用 GPU。

comfy setup 通过浏览器登录，因此在 CI、devcontainer 或无头服务器上无法完成。此时请改用 API Key 并以非交互方式运行：

comfy setup --where cloud --api-key comfyui-... --non-interactive