知识库:droid指南
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）
重要警告
不要将中转站的 API Key 设置到 Factory 的环境变量中！
- 中转站的 Key 只能用于
config.json中的 BYOK 配置 - Factory 自身的环境变量（如
ANTHROPIC_API_KEY）应使用官方 Key - 混用会导致认证失败
官方资源
知识库/droid指南.txt · 最后更改: 由 邪让多杰
