Ollama Droid

Droid 是 Factory 出品的终端编码代理。它对 Ollama 的支持做得比较细——本地、Ollama 云端、ollama.com 直连三种模式各有对应的配置块。

版本基线 v0.40.12，官方 docs.ollama.com/integrations/droid。

一、安装

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

Droid 需要较大上下文，建议至少 64k tokens，低于这个值基本没法正常做编码任务。

二、快速启动

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
    }
  ]
}

几个字段的注意点：

四、用 Ollama 云端模型（经本地 Ollama）

本地 Ollama 代理到云端时，模型名加 -cloud 后缀：

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

区别只有两处：模型名带 -cloud，max_tokens 提到 128000。

五、直连 ollama.com（不经过本地 Ollama）

1. 到 ollama.com/settings/keys 生成 API Key，导出为 OLLAMA_API_KEY
2. 配置块改成直连云端：

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

三个变化：base_url 换成 https://ollama.com/v1/、api_key 用环境变量引用、模型名去掉 -cloud。

改完在新终端里运行 droid 让设置生效。

六、三种模式怎么选

常见问题

动手试

## ① 拉模型
ollama pull qwen3-coder

## ② 一条命令配好
ollama launch droid

## ③ 验证配置已写入
cat ~/.factory/config.json

第 3 条能看到 custom_models 里有 Ollama 段落，就说明配置生效了。