Factory Droid CLI - 自动化工作流 AI 代理工具
项目介绍
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 直接回车(默认 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 直接回车(默认 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 为准。