Factory Droid CLI
專案介紹
Command Line: Automation Across the SDLC. Script and parallelize Droids at massive scale for CI/CD, migrations, and maintenance. From automated code review to self-healing builds, integrate agents into every phase of development.
Droid CLI 是由 Factory AI 開發的命令列工具,旨在作為 AI 軟體工程代理執行。它允許使用者透過終端與各種大型語言模型互動,構建、除錯和重構程式碼,甚至建立完整的應用程式。
- 官方主頁:https://factory.ai/product/cli
- 官方文件:https://docs.factory.ai/cli/getting-started/quickstart
- 安裝方法:見本頁下方教程
效果演示

特性
| 類別 | 特性 | 價值/能力 | 示例/備註 |
|---|---|---|---|
| 快速上手與 CLI | 30 秒安裝;在專案目錄中啟動 droid 互動會話;支援 macOS/Linux 與 Windows | 快速接入當前工程,無需新工具 | Windows 安裝:irm https://app.factory.ai/cli/windows | iex;啟動:droid |
| 端到端特性開發 | 從規劃到實現到測試的全流程自動化;透明的評審流程 | 提升交付速度,保持人類把控 | 原生 diff 檢視與批准流程(見“透明與可控”) |
| 程式碼庫深度理解 | 融合組織在程式碼庫、文件、Issue 追蹤中的共享知識;上下文感知,效果隨時間提升 | 更準確的建議與改動 | 持續利用跨倉庫與文件的知識 |
| 工程系統整合 | 原生整合 Jira、Notion、Slack 等工具;開發工作與團隊流程保持同步 | 減少工具切換與資訊孤島 | “等”表示還有更多整合 |
| 生產級自動化 | 工作流可在本地與 CI/CD 複用;企業級安全與合規內建 | 一致性與可審計性 | 適配流水線與企業環境 |
| 企業級能力 | 私有部署選項、SOC-2 合規、空氣隔離(air-gapped)環境 | 滿足安全與合規要求 | 以安全與質量優先 |
| 現有工具增強 | 在終端、IDE 與既有開發環境中工作;無需切換編輯器或學習新介面 | 保持現有工作習慣、低遷移成本 | 與熟悉工具深度整合 |
| 透明與可控 | 每個決策可見且可審閱;對程式碼變更保持完全監督;原生 diff 檢視與審批工作流 | 降低風險、提升可控性 | 稽核友好、可追蹤 |
| 模型靈活性 | 不鎖定單一 AI 提供商;按任務選擇最佳模型;組織級一致行為與記憶 | 在效能與成本間做最優選擇 | 支援多模型路由 |
| 下一步與資源 | Quickstart、Common Use Cases、IDE Integration、Configuration、AGENTS.md | 便於落地與實踐 | 見頁面 “Next steps/Additional resources” |
AI 模型配置方法
Windows 端圖文指引
1.開啟終端

2.安裝 Factory Droid CLI
官方一鍵安裝命令:
一鍵安裝命令
irm https://app.factory.ai/cli/windows | iex

3.修改配置檔案
Droid CLI 透過自訂模型(BYOK)接入第三方 API。一鍵腳本會把 88API 模型合併寫入 ~/.factory/settings.json 的 customModels(Factory 官方現行的設定位置):只替換名稱帶 [88API] 的模型,其他設定和自訂模型保留,原檔案備份為 settings.json.bak.<時間戳>;舊版腳本寫在 ~/.factory/config.json 裡的 88API 模型會一併清理。寫入的模型:
- GPT 模型(
gpt-6.1-sol、gpt-6-astra):provideropenai,Base URLhttps://api.88api.ai/v1 - Claude 模型(
claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5):provideranthropic,Base URLhttps://api.88api.ai(不帶 /v1)

腳本提示為簡體中文,數值與正文相同。
一鍵修改配置檔案
iex (irm 'https://88api.ai/helper/factory-cli-setup.ps1')按提示操作:Base URL 直接按 Enter(預設 https://api.88api.ai)。腳本會依模型類型分別處理:GPT 模型自動補成 https://api.88api.ai/v1,Claude 模型使用 https://api.88api.ai(不帶 /v1)。API Key 貼上 88API 控制台建立的金鑰(輸入內容不會明文顯示)。之後要換 API Key,再執行一次腳本即可。
4.開始使用 Droid CLI
現在你可以開始使用 Droid CLI 了!
# 進入你的專案目錄(可選)
cd C:\path\to\your\project
# 啟動 Droid CLI
droid切換到 88API 模型
啟動 droid 後輸入 /model,在列表下方的 Custom models(自訂模型) 分組中選擇帶 [88API] 的模型(如 GPT-6.1 Sol [88API]、Claude Opus 5.5 [88API])。不切換時 Droid 使用 Factory 官方模型,請求不會經過 88API。使用 Claude 模型時,你的 88API 金鑰所在分組需要包含對應的 Claude 模型。
Droid CLI 要求使用者登入官方賬號(免費)後才能使用。
5.Windows 常見問題解決
安裝時提示 permission denied 錯誤
這通常是許可權問題,嘗試以下解決方法:
-
以管理員身份執行
PowerShell,然後重新執行安裝命令 -
如果改用 npm 安裝,可配置
npm使用使用者目錄:npm config set prefix "$env:APPDATA\npm"
PowerShell 執行策略錯誤
如果遇到執行策略限制,執行: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
macOS/Linux 端圖文指引
1.安裝 Droid CLI
安裝 Droid CLI
開啟終端,執行以下命令: curl -fsSL https://app.factory.ai/cli | sh


按照安裝提示修改環境變數 (直接複製安裝提示程式碼):
Linux 視情況選擇 ~/.bashrc 或 ~/.zshrc
Droid CLI 環境變數 (僅作示例)
echo 'export PATH=/Users/修改此處/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc2.修改配置檔案
Droid CLI 透過自訂模型(BYOK)接入第三方 API。一鍵腳本會把 88API 模型合併寫入 ~/.factory/settings.json 的 customModels(Factory 官方現行的設定位置):只替換名稱帶 [88API] 的模型,其他設定和自訂模型保留,原檔案備份為 settings.json.bak.<時間戳>;舊版腳本寫在 ~/.factory/config.json 裡的 88API 模型會一併清理。寫入的模型:
- GPT 模型(
gpt-6.1-sol、gpt-6-astra):provideropenai,Base URLhttps://api.88api.ai/v1 - Claude 模型(
claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5):provideranthropic,Base URLhttps://api.88api.ai(不帶 /v1)
一鍵修改配置檔案
curl -fsSL https://88api.ai/helper/factory-cli-setup.sh | bash按提示操作:Base URL 直接按 Enter(預設 https://api.88api.ai)。腳本會依模型類型分別處理:GPT 模型自動補成 https://api.88api.ai/v1,Claude 模型使用 https://api.88api.ai(不帶 /v1)。API Key 貼上 88API 控制台建立的金鑰(輸入內容不會明文顯示)。之後要換 API Key,再執行一次腳本即可。

腳本提示為簡體中文,數值與正文相同。
3.開始使用 Droid CLI
現在你可以開始使用 Droid CLI 了!
# 進入你的專案目錄(可選)
cd /path/to/your/project
# 啟動 Droid CLI
droid切換到 88API 模型
啟動 droid 後輸入 /model,在列表下方的 Custom models(自訂模型) 分組中選擇帶 [88API] 的模型(如 GPT-6.1 Sol [88API]、Claude Opus 5.5 [88API])。不切換時 Droid 使用 Factory 官方模型,請求不會經過 88API。使用 Claude 模型時,你的 88API 金鑰所在分組需要包含對應的 Claude 模型。
Droid CLI 要求使用者登入官方賬號(免費)後才能使用。
手動配置(可選)
不使用一鍵腳本時,可以在 ~/.factory/settings.json(Windows 為 %USERPROFILE%\.factory\settings.json)的 customModels 陣列中手動新增 88API 模型。檔案已存在時只合併 customModels,保留其他設定:
{
"customModels": [
{
"model": "gpt-6.1-sol",
"displayName": "GPT-6.1 Sol [88API]",
"baseUrl": "https://api.88api.ai/v1",
"apiKey": "sk-your-88api-key",
"provider": "openai",
"maxOutputTokens": 128000
},
{
"model": "claude-opus-5-5",
"displayName": "Claude Opus 5.5 [88API]",
"baseUrl": "https://api.88api.ai",
"apiKey": "sk-your-88api-key",
"provider": "anthropic",
"maxOutputTokens": 32000
}
]
}注意:provider 為 openai 時 baseUrl 必須帶 /v1;provider 為 anthropic 時填 https://api.88api.ai(不帶 /v1)。儲存後重新啟動 droid,再透過 /model 選擇模型。
~/.factory/config.json(custom_models、base_url 等底線欄位)是 Factory 的舊版格式:Droid 啟動時會把其中的模型複製到 settings.json,之後再改 config.json 不會生效。請以 settings.json 為準。