Factory Droid CLI
Factory Droid CLI（Droid CLI）是由 Factory AI 推出的终端智能软件工程代理。它深度理解大型代码库上下文与工程规范，能够在命令行中自主执行需求规划、代码实现、测试运行与重构，为开发者提供沉浸式的本地自主编程体验。
✨ AI 一键配置
复制下方提示词发送给您的 AI 助手，即可自动完成环境探测与安装配置：
AI 配置提示词 (Prompt)
点击卡片任意位置复制
请参考 OpenRely 官方文档（https://openrely.ai/zh/docs/apps/factory-droid-cli）帮我配置当前机器的 Factory Droid CLI：
1. 获取密钥：若我尚未提供 API 密钥，请先提醒我前往 OpenRely 控制台（https://api.openrely.ai/keys）创建并输入
2. 安装环境：检查本机是否已安装 Factory Droid CLI（命令为 droid），若未安装则执行官方安装脚本（macOS/Linux: curl -fsSL https://app.factory.ai/cli | sh；Windows: irm https://app.factory.ai/cli/windows | iex）
3. 配置文件：创建 ~/.factory 目录，写入配置文件 ~/.factory/config.json：
将自定义模型接入点指向 OpenRely（base_url 为 https://api.openrely.ai/v1，api_key 为 <我的_API_KEY>），模型标识可参考 OpenRely 模型广场（https://api.openrely.ai/pricing）
4. 验证就绪：执行 droid --version 检查安装状态，并提示我直接运行 droid 开启开发会话
🔑 准备
1登录控制台
api.openrely.ai/sign-in前往 ↗
2获取 API Key
api.openrely.ai/keys
sk-...3填写服务地址点击复制
https://api.openrely.ai/v1
🚀 步骤
全局安装 CLI
根据您的操作系统选择官方一键安装命令，安装完成后即可在终端中调用 droid 命令：
curl -fsSL https://app.factory.ai/cli | sh安装完成后请根据终端提示，确保将 Droid 路径追加至您的 Shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）。
以管理员身份打开 PowerShell 运行：
irm https://app.factory.ai/cli/windows | iex配置端点与密钥
Factory Droid CLI 使用用户主目录下的 ~/.factory/config.json 存储第三方自定义模型接入点：
在终端中执行以下命令写入配置目录与配置文件：
# 1. 创建配置目录
mkdir -p ~/.factory
# 2. 写入自定义模型配置文件（指向 OpenRely）
cat > ~/.factory/config.json <<EOF
{
"custom_models": [
{
"model_display_name": "OpenRely",
"model": "<在定价中心选择的模型标识>",
"base_url": "https://api.openrely.ai/v1",
"api_key": "sk-your-openrely-api-key",
"provider": "openai",
"max_tokens": 128000
}
]
}
EOF
chmod 600 ~/.factory/config.json在 PowerShell 窗口中运行以下命令完成配置写入：
# 1. 创建配置目录
New-Item -ItemType Directory -Force -Path "$HOME\.factory"
# 2. 写入自定义模型配置文件（指向 OpenRely）
@"
{
"custom_models": [
{
"model_display_name": "OpenRely",
"model": "<在定价中心选择的模型标识>",
"base_url": "https://api.openrely.ai/v1",
"api_key": "sk-your-openrely-api-key",
"provider": "openai",
"max_tokens": 128000
}
]
}
"@ | Out-File -Encoding utf8 "$HOME\.factory\config.json"启动与验证
进入您的代码工程根目录，运行 droid 启动交互式会话：
droid首次进入会话后，发送一条测试指令验证端点连通性：
> 分析当前项目的整体架构设计，并列出关键入口文件若能正常流式返回代码分析回复，即表示已成功接入 OpenRely。
💡 常用
在 Factory Droid CLI 交互会话中，常用的内置快捷指令：
| 指令 | 说明 |
|---|---|
/help | 查看所有内置命令与配置选项 |
/model | 交互式查看或切换当前使用的模型 |
/clear | 清空当前对话上下文，开启全新任务 |
/exit | 退出 Droid CLI 会话 |
❓ 常见问题
遇到其他调用报错或计费疑问？请查阅完整的 常见问题与排障指南。
这篇文档对您有帮助吗？