Droid 安装配置指南

不要将中转站的 API Key 设置到 Factory 的环境变量中！

30秒快速开始

首次运行会自动打开浏览器登录，推荐使用 Google 账号（免手机验证）

Windows 用户（PowerShell 管理员）

irm https://app.factory.ai/cli | iex

macOS / Linux 用户

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

安装后

cd 你的项目目录
droid

配置文件位置

系统	配置文件路径
Windows	`C:\Users\<用户名>\.factory\config.json`
macOS	`~/.factory/config.json`
Linux	`~/.factory/config.json`

如果 config.json 文件不存在，需要自己手动创建。

快速打开方式：

Windows: 资源管理器地址栏输入 %USERPROFILE%\.factory
macOS: 终端输入 open ~/.factory
Linux: 终端输入 xdg-open ~/.factory
通用: 在 Droid 中输入 /settings

配置第三方渠道 (duojie.games)

获取 API Key

闲鱼购买的兑换码是用于兑换额度的，不是 API Key
API Key 需要在令牌页面自行生成创建

配置示例

在 config.json 中添加以下配置：

{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [duojie.games]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://api.duojie.games",
      "api_key": "你的API密钥",
      "provider": "anthropic",
      "supports_vision": true
    }
  ]
}

多模型配置示例

{
  "custom_models": [
    {
      "model_display_name": "Opus 4.5 [duojie.games]",
      "model": "claude-opus-4-5-20251101",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true
    },
    {
      "model_display_name": "Sonnet 4 [duojie.games]",
      "model": "claude-sonnet-4-20250514",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic"
    }
  ]
}

配置字段说明

字段	说明	必填
`model_display_name`	在 Droid 中显示的模型名称	是
`model`	实际调用的模型 ID	是
`base_url`	API 地址	是
`api_key`	你的 API 密钥（在令牌页面生成）	是
`provider`	提供商类型: `anthropic`, `openai`, `gemini`, `openrouter`	是
`supports_vision`	是否支持图片识别	否
`max_tokens`	最大输出 token 数	否
`supports_prompt_caching`	是否支持提示缓存	否

切换模型

在 Droid 聊天界面输入 /model 命令，在弹出的列表中选择你配置的模型。

如果 /model 列表中看不到你配置的模型，说明 config.json 配置格式有误，请检查 JSON 语法。

常用命令速查

命令/快捷键	功能
`/model`	切换模型
`/settings`	打开设置
`/clear`	清空对话
`/help`	查看帮助
`/compact`	压缩上下文
`Esc` 两次	中断当前操作
`Ctrl+C`	退出 Droid
`droid –version`	查看版本

常见问题

Q: Windows 安装失败？

A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。

Q: 提示 400 错误或 401 错误？

A: 未登录或登录过期。运行 droid 重新登录，推荐使用 Google 账号。

如果Droid成功登录，你的本地会话在Factory.ai官方里能看到的。

Q: 提示 API Key 无效？

A: 检查 api_key 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。

Q: 模型列表中看不到配置的模型？

A: config.json 格式错误。使用在线 JSON 校验工具检查语法，然后重启 Droid。

Q: 找不到 config.json 文件？

A: 该文件默认不存在，需要自己在 .factory 目录下手动创建。

Q: 如何添加多个模型？

A: 在 custom_models 数组中添加多个配置项即可，参考上方多模型配置示例。

Q: 如何更新 Droid？

A: 重新运行安装命令即可覆盖更新。

Q: 代理/VPN 环境下无法连接？

A: 设置环境变量：

# Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
 
# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

Q: 如何完全卸载？

A: 删除配置目录和可执行文件：

Windows: 删除 %USERPROFILE%\.factory 目录
macOS/Linux: 删除 ~/.factory 目录
删除 droid 可执行文件（通常在 ~/.local/bin 或 /usr/local/bin）

重要警告