【进阶】对于已经熟练掌握Droid的玩家，可以尝试 OpenCode 安装配置指南

完整配置只需 4 步：

1. 步骤1 - 安装 Droid：运行安装命令
2. 步骤2 - 设置环境变量：让 Droid 能启动（FACTORY_API_KEY 随便填个值）
3. 步骤3 - 配置 config.json：
   • 在中转站 钱包 里用兑换码兑换余额
   • 在 令牌 页面生成 API Key
   • 把 Key 填入 config.json
   • 如果以前有用过，需要更新或删除setting.json
4. 步骤4 - 切换模型：在 Droid 里用 /model 切换到 custom 里的模型

Windows 用户（PowerShell 管理员）：

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

macOS / Linux 用户：

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

Windows 用户：

方法一：PowerShell 临时设置（关闭窗口后失效）

$env:FACTORY_API_KEY="fk-your-key-here"

方法二：永久设置系统环境变量（推荐）

# 以管理员身份运行 PowerShell
[System.Environment]::SetEnvironmentVariable("FACTORY_API_KEY", "fk-your-key-here", "User")

或者：右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 新建用户变量

• 变量名：FACTORY_API_KEY
• 变量值：fk-your-key-here

macOS 用户：

方法一：临时设置（关闭终端后失效）

export FACTORY_API_KEY="fk-your-key-here"

方法二：永久设置（推荐）

# 添加到 ~/.zshrc（macOS 默认 shell）
echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc
source ~/.zshrc

Linux 用户：

方法一：临时设置（关闭终端后失效）

export FACTORY_API_KEY="fk-your-key-here"

方法二：永久设置（推荐）

# Bash 用户添加到 ~/.bashrc
echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.bashrc
source ~/.bashrc
 
# Zsh 用户添加到 ~/.zshrc
echo 'export FACTORY_API_KEY="fk-your-key-here"' >> ~/.zshrc
source ~/.zshrc

cd 你的项目目录
droid

快速打开方式：

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

在 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,
      "max_tokens": 8192
    }
  ]
}

{
  "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,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Opus 4.5 Think [duojie.games]",
      "model": "claude-opus-4-5-think",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "max_tokens": 8192
    },
    {
      "model_display_name": "GLM-4.7 [duojie.games]",
      "model": "glm-4.7",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true
    },
    {
      "model_display_name": "Gemini 3 Pro [duojie.games]",
      "model": "gemini-3-pro-preview",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true
    },
    {
      "model_display_name": "gpt 5.2 [duojie.games]",
      "model": "gpt-5.2",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "openai-response",
      "supports_vision": true
    },
    {
      "model_display_name": "gpt 5.2 codex[duojie.games]",
      "model": "gpt-5.2-codex",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "openai-response",
      "supports_vision": true
    }
  ]
}

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

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

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

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

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

使用模型：`claude-opus-4-5-think`

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 无效。检查 FACTORY_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: 如何更新 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）

• 官方文档