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 會話 |
❓ 常見問題
遇到其他呼叫報錯或計費疑問？請查閱完整的 常見問題與排障指南。
這篇文件對您有幫助嗎？