88API88API
使用指南AI 应用API 文档帮助支持

Factory Droid CLI - 自动化工作流 AI 代理工具


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 直接回车(默认 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 直接回车(默认 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 为准。