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

几个字段的注意点：

字段	值	说明
model_display_name	任意，建议带 [Ollama] 后缀	便于在选择器里区分来源
model	与 ollama list 一致	名字错了会加载失败
base_url	http://localhost:11434/v1/	带 /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 让设置生效。

六、三种模式怎么选

模式	base_url	模型名	适合
本地模型	http://localhost:11434/v1/	qwen3-coder	离线、隐私敏感、零成本
经本地代理云端	http://localhost:11434/v1/	xxx-cloud	想统一走 localhost 管理
直连云端	https://ollama.com/v1/	xxx	本机没装 Ollama 或算力不够

常见问题

现象	原因	处理
模型加载失败	model 名与本地不一致	ollama list 核对
请求 404	base_url 缺 /v1/ 或尾斜杠	补齐
改配置不生效	旧进程缓存	新终端重跑 droid
输出频繁截断	max_tokens 偏小	提到 32000+
直连云端 401	API Key 未导出	export OLLAMA_API_KEY=...

动手试

## ① 拉模型
ollama pull qwen3-coder

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

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

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