Factory Droid

Factory Droid 是一款企业级 AI 编码代理，它运行在你的终端中，负责端到端的软件开发工作流。

Factory Droid 需要成功登录 Factory Droid 账户认证后才能使用。

步骤 1：安装 Factory Droid

macOS / Linux：

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

Windows：

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

步骤 2：配置 WisGate 模型

1. 获取 API 密钥

在 WisGate 控制台中创建并获取您的 API Key。

2. 配置自定义模型

配置文件位置：

• macOS/Linux：~/.factory/settings.json
• Windows：%USERPROFILE%\.factory\settings.json

Anthropic 协议

{
  "customModels": [
    {
      "displayName": "Claude [WisGate] - Sonnet",
      "model": "claude-sonnet-4-6",
      "baseUrl": "https://api.wisgate.cn",
      "apiKey": "your_api_key",
      "provider": "anthropic",
      "maxOutputTokens": 131072
    }
  ]
}

OpenAI Chat Completion 协议

{
  "customModels": [
    {
      "displayName": "GPT [WisGate] - OpenAI",
      "model": "gpt-5.5",
      "baseUrl": "https://api.wisgate.cn/v1",
      "apiKey": "your_api_key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 131072
    }
  ]
}

将 your_api_key 替换为你的实际 API Key。API Key 仅保存在本地。

Anthropic 协议通常填写 Base URL https://api.wisgate.cn。如果工具要求填写完整的 Messages API 地址，请使用 https://api.wisgate.cn/v1/messages。

3. 启动 Factory Droid

cd /path/to/your/project
droid

首次启动时，系统会引导你通过浏览器登录。

4. 选择你的模型

droid 运行后，使用 /model 命令选择刚配置的自定义模型。

步骤 3：开始使用

选择模型后，可以让 Factory Droid 在终端中处理端到端开发任务，例如：

• 分析项目结构和待办事项
• 修改代码并生成说明
• 根据测试失败信息定位问题
• 拆解复杂需求并逐步执行

常见问题

应该使用 Anthropic 还是 OpenAI Chat Completion 协议？

Claude 系列或 Anthropic Messages 兼容模型使用 Base URL https://api.wisgate.cn；如果工具要求完整请求地址，则使用 https://api.wisgate.cn/v1/messages。GPT 系列或 OpenAI 兼容模型使用 https://api.wisgate.cn/v1。

自定义模型没有出现

请确认 ~/.factory/settings.json 路径正确、JSON 格式有效，并重启 droid。