完整配置只需 4 步：

1. 步骤1 - 安装 Droid：运行安装命令
2. 步骤2 - 登录账号：用谷歌老账号登录
3. 步骤3 - 配置第三方模型：手动编辑 config.json，填入 API Key
4. 步骤4 - 用 /model 切换到本站模型；用 /settings 配置压缩选项（200k，当前模型）

Windows 用户（PowerShell 管理员）：

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

macOS / Linux 用户：

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

Droid 现在需要使用谷歌老账号登录才能启动。账号可联系管理员获取。

运行 droid 命令后，会自动跳转浏览器完成 Google 账号登录，登录成功后即可使用。

如果你之前设置过 FACTORY_API_KEY 环境变量（旧版假Key方式），请删除它，否则可能引起冲突。

cd 你的项目目录
droid

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

快速打开方式：

• Windows: 资源管理器地址栏输入 %USERPROFILE%\.factory
• macOS: 终端输入 open ~/.factory
• Linux: 终端输入 xdg-open ~/.factory

1. API Key 需要在 本站控制台 的令牌页面自行生成创建

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

{
  "custom_models": [
    {
      "model_display_name": "Claude Opus 4.6 [huanyu]",
      "model": "claude-opus-4-6",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Opus 4.6 Thinking [huanyu]",
      "model": "claude-opus-4-6-thinking",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Sonnet 4.6 [huanyu]",
      "model": "claude-sonnet-4-6",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Claude Sonnet 4.6 Thinking [huanyu]",
      "model": "claude-sonnet-4-6-thinking",
      "base_url": "https://api.huanyuf.top",
      "api_key": "your-api-key",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Gemini 3.1 Pro [huanyu]",
      "model": "gemini-3.1-pro",
      "base_url": "https://api.huanyuf.top/v1",
      "api_key": "your-api-key",
      "provider": "openai",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Gemini 3 Flash [huanyu]",
      "model": "gemini-3-flash",
      "base_url": "https://api.huanyuf.top/v1",
      "api_key": "your-api-key",
      "provider": "openai",
      "supports_vision": true,
      "max_tokens": 8192
    }
  ]
}

2025年12月25日后，如果你改了 config.json 里的已有模型，需要同时删除 settings.json 让配置重新生效。

升级到 v100 版本之后如果出现各种报错，按以下步骤重置：

1. 删除 settings.json：
   • Windows: %USERPROFILE%\.factory\settings.json
   • macOS/Linux: ~/.factory/settings.json
2. 删除系统环境变量中的 FACTORY_API_KEY（旧版假Key残留）
3. 重新打开终端，运行 droid，用谷歌老账号重新登录
4. 用 /model 重新切换到本站模型
5. 用 /settings 重新配置压缩选项：
   • 压缩上下文大小： 200k
   • 压缩模型：选 当前使用的主模型

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

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

思考模式（Extended Thinking）可以让模型在回答前进行更深入的推理，适合复杂任务。

每次切换模型后，settings.json 会被刷新！

如果你需要开启思考模式，必须在切换模型后 手动修改 settings.json 文件。

• Windows: C:\Users\<用户名>\.factory\settings.json
• macOS/Linux: ~/.factory/settings.json

在 settings.json 中找到并修改以下字段：

{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}

1. 使用 /model 切换到你想要的模型
2. 打开配置目录 C:\Users\用户名\.factory
3. 编辑 settings.json 文件
4. 如果想看到思考过程，将 showThinkingInMainView 改为 true
5. 保存文件，配置立即生效

Q: Windows 安装失败？

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

Q: 提示 400 错误？

A: 模型名称错误，检查 config.json 中的 model 字段是否正确。

Q: 提示 401 错误？

A: API Key 无效或未登录。确认已用谷歌老账号登录，并检查 config.json 中的 api_key 是否正确。

Q: 提示 API Key 无效？

A: 检查 api_key 是否正确填写。API Key 需要在令牌页面单独生成。

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

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

Q: 找不到 config.json 文件？

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

Q: 如何添加多个模型？

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

Q: 压缩失败（compaction failed）？

A: 使用第三方模型时，压缩功能的默认模型指向官方模型，会因无权限而失败。解决方法：

1. 在 Droid 中输入 /settings
2. 找到 压缩模型（Summarization Model） 选项，从官方模型切换为 当前正在使用的第三方模型
3. 找到 压缩上下文大小，设置为 200k
4. 保存即可

Q: 创建会话失败（session creation failed）？

A: 旧版安装时可能设置了 FACTORY_API_KEY 环境变量（假Key），导致与新版登录机制冲突。解决方法：

1. 删除系统环境变量 中的 FACTORY_API_KEY（Windows: 系统属性 → 环境变量 → 删除；macOS/Linux: 编辑 ~/.bashrc 或 ~/.zshrc 删除对应 export 行）
2. 关闭并重新打开终端（确保环境变量生效）
3. 运行 droid，使用谷歌老账号重新登录

Q: 升级后登录失败或模型全部消失？

A: 参考上方「v100+ 升级后出现错误？」章节，按步骤重置即可。

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）

• Droid 官方文档
• Droid 官网
• Windows 下载地址
• Droid GitHub
• 本站 API 控制台（令牌页面）