Factory Droid CLI

Factory Droid CLI 是 Factory AI 開發的 AI 軟體工程助手 —— 從規劃到測試的全流程自動化，作為 Agent 在你的終端中執行。

• 官網：https://factory.ai/product/cli
• 快速開始：https://docs.factory.ai/cli/getting-started/quickstart

前置要求

項	要求
Droid CLI	最新版本
WRouter	一把可用 sk- Token
Factory 賬號	Factory 本身要求登入（免費）

安裝

macOS / Linux

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

Windows（PowerShell）

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

配置

Droid CLI 在 ~/.factory/ 下讀取模型 provider 配置。新增 WRouter provider：

[providers.wrouter]
type      = "openai"
base_url  = "https://wrouter.ai/v1"
api_key   = "${WROUTER_API_KEY}"

[providers.wrouter.models.claude-sonnet]
id      = "claude-sonnet-4-6"
context = 200000
output  = 32768

設定 API Key：

# macOS / Linux
export WROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Windows PowerShell
$env:WROUTER_API_KEY="sk-xxxx..."

配置檔案欄位名以 Droid 當前 schema 為準，精確拼寫以 Factory 官方文件為準。

驗證

cd path/to/your/project
droid

啟動前必須登入 Factory 賬號（免費）。啟動後選擇 WRouter provider 並 prompt 即可。

推薦模型

模型	用途
claude-sonnet-4-6	通用工程任務
claude-opus-4-8	複雜重構 / 規劃
gpt-5.5	推理密集型除錯

故障排查

現象	處理
Windows 安裝報 permission denied	以管理員身份執行 PowerShell；或 npm config set prefix 到使用者目錄
登入死迴圈	Droid 始終要求 Factory 賬號登入，與模型 provider 無關

已知限制

• Droid 的部分企業級特性（Jira / Notion / Slack 整合、SOC-2 合規材料）由 Factory 雲端提供，不經 WRouter。