Factory Droid CLI

Droid CLI 是 Factory AI 开发的命令行工具，作为 AI 软件工程代理运行。可以在终端里与各种大模型交互，构建、调试和重构代码，甚至创建完整的应用。

官方主页：https://factory.ai/product/cli
官方文档：https://docs.factory.ai/cli/getting-started/quickstart

特性

类别	特性
快速上手	一行命令安装，在项目目录中运行 `droid` 即可开始，支持 macOS、Linux 和 Windows
端到端开发	从规划、实现到测试的全流程自动化，评审流程透明
代码库理解	结合代码库、文档和 Issue 中的知识，上下文感知
工程系统集成	原生集成 Jira、Notion、Slack 等工具
生产级自动化	工作流可以在本地和 CI/CD 中复用
透明可控	每个决策都可见、可审阅，原生 diff 查看和审批流程
模型灵活	不锁定单一 AI 服务商，可以按任务选择模型

安装

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

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

macOS / Linux 安装后，按安装提示把 Droid CLI 加入 PATH（根据你使用的 shell 选择 ~/.bashrc 或 ~/.zshrc），例如：

echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

配置 ZeroCat

Droid CLI 通过配置文件 ~/.factory/config.json（Windows 为 %USERPROFILE%\.factory\config.json）中的 custom_models 使用第三方模型。没有这个文件就新建一个，已有的话先备份再修改：

{
  "custom_models": [
    {
      "model_display_name": "GPT-6.1 Sol [ZeroCat]",
      "model": "gpt-6.1-sol",
      "base_url": "https://zero.cat/v1",
      "api_key": "sk-你的API密钥",
      "provider": "openai",
      "max_tokens": 128000
    }
  ]
}

字段	说明
`model_display_name`	在 Droid 模型列表中显示的名称，可以自定义
`model`	ZeroCat 中的模型 ID，可在模型广场复制。示例中的模型名需要换成你的分组可用的模型
`base_url`	`https://zero.cat/v1`，必须带 `/v1`
`api_key`	你的 ZeroCat API 密钥
`provider`	`openai`
`max_tokens`	单次最大输出 Token 数

想用多个模型，就在 custom_models 数组里添加多项。

开始使用

# 进入你的项目目录
cd /path/to/your/project

# 启动 Droid CLI
droid

启动后在模型列表中选择带 [ZeroCat] 标记的模型即可。

Droid CLI 要求先登录 Factory 官方账号（免费）才能使用。

常见问题

安装时提示 permission denied

这通常是权限问题，可以尝试：

以管理员身份运行 PowerShell；
或者让 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 提示执行策略错误

运行以下命令后重试：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

AI 编程工具

AI 客户端

机器人与智能体

翻译工具

特性

安装

配置 ZeroCat

开始使用

常见问题

​特性

​安装

​配置 ZeroCat

​开始使用

​常见问题

特性

安装

配置 ZeroCat

开始使用

常见问题