安裝

安裝 Droid CLI：

curl -fsSL https://app.factory.ai/cli | sh

注意

Droid 需要較大的上下文視窗。建議使用至少 64k tokens 的上下文視窗。更多資訊請參閱 Context length。

搭配 Ollama 使用

快速設定

ollama launch droid

若要在不啟動的情況下進行設定：

ollama launch droid --config

手動設定

將本地設定區塊新增至 ~/.factory/config.json：

{
  "custom_models": [
    {
      "model_display_name": "qwen3-coder [Ollama]",
      "model": "qwen3-coder",
      "base_url": "http://localhost:11434/v1/",
      "api_key": "not-needed",
      "provider": "generic-chat-completion-api",
      "max_tokens": 32000
    }
  ]
}

雲端模型

qwen3-coder:480b-cloud 是搭配 Droid 使用的推薦模型。 將雲端設定區塊新增至 ~/.factory/config.json：

{
  "custom_models": [
    {
      "model_display_name": "qwen3-coder [Ollama Cloud]",
      "model": "qwen3-coder:480b-cloud",
      "base_url": "http://localhost:11434/v1/",
      "api_key": "not-needed",
      "provider": "generic-chat-completion-api",
      "max_tokens": 128000
    }
  ]
}

連接至 ollama.com

1. 從 ollama.com 建立 API 金鑰，並將其匯出為 OLLAMA_API_KEY。
2. 將雲端設定區塊新增至 ~/.factory/config.json：

   {
     "custom_models": [
       {
         "model_display_name": "qwen3-coder [Ollama Cloud]",
         "model": "qwen3-coder:480b",
         "base_url": "https://ollama.com/v1/",
         "api_key": "OLLAMA_API_KEY",
         "provider": "generic-chat-completion-api",
         "max_tokens": 128000
       }
     ]
   }

在新的終端機中執行 droid 以載入新設定。