Factory Droid

Factory Droid is an enterprise-grade AI coding agent that runs in your terminal, handling end-to-end software development workflows.

Factory Droid requires successful account authentication before use.

Step 1: Install Factory Droid

macOS / Linux:

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

Windows:

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

Step 2: Configure WisGate Models

1. Get Your API Key

Create and obtain your API Key from the WisGate dashboard.

2. Configure Custom Model

Configuration file location:

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

Anthropic Protocol

{
  "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 Protocol

{
  "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
    }
  ]
}

Replace your_api_key with your actual API Key. The API Key is stored locally only.

For the Anthropic protocol, usually enter the Base URL https://api.wisgate.cn. If the tool asks for the full Messages API URL, use https://api.wisgate.cn/v1/messages.

3. Start Factory Droid

cd /path/to/your/project
droid

On first launch, you will be guided through browser login.

4. Select Your Model

After droid starts, use the /model command to select the custom model you configured.

Step 3: Start Using

After selecting the model, you can let Factory Droid handle end-to-end development tasks in the terminal, such as:

• Analyze project structure and tasks
• Modify code and generate explanations
• Diagnose issues from failed tests
• Break down complex requirements and execute them step by step

FAQ

Should I use the Anthropic or OpenAI Chat Completion protocol?

Use Base URL https://api.wisgate.cn for Claude-family or Anthropic Messages-compatible models. If the tool asks for the full request URL, use https://api.wisgate.cn/v1/messages. Use https://api.wisgate.cn/v1 for GPT-family or OpenAI-compatible models.

The custom model does not appear

Confirm that ~/.factory/settings.json is in the correct path, the JSON format is valid, and restart droid.