FlexAPI Docs

主题

Droid CLI 使用指南 ​

Droid 是 Factory AI 开发的交互式终端 AI 编程助手。使用前必须先注册并登录 Droid 官方账号。 这份教程用于记录 Droid CLI 接入 FlexAPI 的配置流程。

Step 1: 获取 API Key ​

1. 登录 FlexAPI 控制台 ​

前往 FlexAPI，登录并选择对应的分组，创建 FlexAPI API Key。

2. 充值额度或购买订阅 ​

按照使用模式，选择按时长订阅或充值额度按量付费。

3. 获取 API Key ​

在控制台创建或复制你的 FlexAPI API Key，后续配置 Droid CLI 时会用到。

参考：FlexAPI API获取教程

Step 2: 安装 Droid CLI ​

bash
curl -fsSL https://app.factory.ai/cli | sh
powershell
irm https://app.factory.ai/cli/windows | iex

请先参考 Droid CLI 官方说明完成安装，并确认终端中可以正常运行 Droid CLI 命令。

bash
droid --version

如果显示版本号，说明 Droid CLI 已安装成功。

提示

Linux 用户需确保已安装 xdg-utils:

bash
sudo apt-get install xdg-utils

Step 3: 登录 Droid 官方账号 ​

  1. 运行 droid 命令
  2. 按照指示通过浏览器登录 Factory 官方账号
  3. 登陆成功方可继续

Step 4: 配置 FlexAPI ​

将 Droid CLI 的 API Key、Base URL 或模型提供方配置到 FlexAPI 网关：

字段建议值
API Key你的 FlexAPI API Key
Base URLhttps://flexapi.me
Model按需填写 FlexAPI 支持的模型

配置文件路径 ​

text
~/.factory/config.json
text
%USERPROFILE%\.factory\config.json

编辑配置文件 ​

添加以下内容:

text
{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "https://flexapi.me",
      "api_key": "your-Flexapi-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5.5",
      "model": "gpt-5.5",
      "base_url": "https://flexapi.me/v1",
      "api_key": "your-Flexapi-key-here",
      "provider": "openai"
    }
  ]
}

说明

  • 请替换文件中的your-Flexapi-key-here为您的 FlexAPI 密钥
  • 注意Anthropic 格式：使用 https://flexapi.me（无 /v1）
  • 注意OpenAI 格式：使用 https://flexapi.me/v1 （需要 /v1）

Step 5: 启动 ​

在项目目录下运行：

text
cd /path/to/your/project
droid

常见问题 ​

Q: 如何切换模型？ ​

  1. 重启 Droid
  2. 输入/model命令
  3. 按需选择模型

Q: 如何更新droid？ ​

重新运行安装脚本即可更新到最新版本。

Q: 配置后无法调用怎么办？ ​

先确认 API Key 是否正确、Base URL 是否填写为 https://flexapi.me，再检查当前分组是否启用了对应模型。

Q:命令未找到怎么办？ ​

bash
# 检查 npm 全局安装路径并添加到 PATH（如果不在）
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
text
1. 确保 npm 全局路径（通常是 C:\Users\你的用户名\AppData\Roaming\npm）已添加到系统 PATH
2. 重新打开 PowerShell 窗口

FlexAPI Docs

Copyright © 2026 FlexAPI