88API88API
使用指南AI 應用API 文件幫助支援

Factory Droid CLI


WindowsmacOSLinux

專案介紹

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 軟體工程代理執行。它允許使用者透過終端與各種大型語言模型互動,構建、除錯和重構程式碼,甚至建立完整的應用程式。

  1. 官方主頁:https://factory.ai/product/cli
  2. 官方文件:https://docs.factory.ai/cli/getting-started/quickstart
  3. 安裝方法:見本頁下方教程

效果演示


droid.webp

特性

類別特性價值/能力示例/備註
快速上手與 CLI30 秒安裝;在專案目錄中啟動 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.開啟終端

windows_open_terminal

2.安裝 Factory Droid CLI

官方一鍵安裝命令:

一鍵安裝命令

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

windows-install

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):provider openai,Base URL https://api.88api.ai/v1
  • Claude 模型(claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5):provider anthropic,Base URL https://api.88api.ai(不帶 /v1)

windows-configure.webp

腳本提示為簡體中文,數值與正文相同。

一鍵修改配置檔案

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

macos-open-terminal

macos-img-02.webp

按照安裝提示修改環境變數 (直接複製安裝提示程式碼):

Linux 視情況選擇 ~/.bashrc 或 ~/.zshrc

Droid CLI 環境變數 (僅作示例)

echo 'export PATH=/Users/修改此處/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

2.修改配置檔案

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):provider openai,Base URL https://api.88api.ai/v1
  • Claude 模型(claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5):provider anthropic,Base URL https://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,再執行一次腳本即可。

macos-img-03.webp

腳本提示為簡體中文,數值與正文相同。

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 為準。