Factory Droid CLI 接入

难度 ⌨️ 进阶　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

Factory Droid CLI（droid）是 Factory AI 出品的终端 AI 编程智能体，可在命令行里直接读代码、改 Bug、重构、写新功能。它支持自定义模型端点，因此可以把推理后端切到半页酥 API。

开始之前

先到 控制台 → 令牌 创建一个 API 令牌（形如 sk-xxxx），并为令牌选对分组——分组决定了你能调用哪些模型、走哪条线路。具体见 选择分组。

第 1 步：安装 Droid CLI

Windows

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

macOS / Linux

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

安装完成后按提示更新 PATH，并需用免费的 Factory 官方账号登录一次（仅用于客户端本体鉴权，不影响模型走 byesu）。

Windows 提示

若遇到权限或执行策略报错：以管理员身份运行 PowerShell，并执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser。

第 2 步：配置接入 byesu

有两种方式，推荐用一键脚本。

方式一（最快）：一键脚本

运行后按提示填入 base_url 和 API Key 即可，脚本会自动写好配置文件：

Windows

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash

• base_url 填：https://byesu.com/v1
• API Key 填：你在 byesu 控制台创建的令牌 sk-xxxx

方式二（手动）：编辑配置文件

编辑 ~/.factory/config.json（Windows 为 %USERPROFILE%\.factory\config.json），在 custom_models 数组里加入 byesu 的模型条目：

{
  "custom_models": [
    {
      "model_display_name": "GPT-5.5 [byesu]",
      "model": "gpt-5.5",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Claude Opus 4.8 [byesu]",
      "model": "claude-opus-4-8",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Gemini 3.1 Pro [byesu]",
      "model": "gemini-3.1-pro-high",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    }
  ]
}

字段说明：

• model：byesu 上的真实模型名（如 gpt-5.5、claude-opus-4-8、gemini-3.1-pro-high），务必确认令牌所在分组支持该模型。
• base_url：固定为 https://byesu.com/v1（OpenAI 兼容格式，带 /v1）。
• api_key：你的令牌 sk-xxxx。
• provider：统一填 openai。
• model_display_name：CLI 选择菜单里显示的名字，可自取。

走 Anthropic 原生格式

上面用的是 OpenAI 兼容端点（最省事）。如果某条目想走 Anthropic 原生协议，把该条目的 provider 改为 anthropic，并将 base_url 改为不带 /v1 的 https://byesu.com。一般保持 openai + https://byesu.com/v1 即可。

第 3 步：跑起来验证

在项目目录下启动：

cd /path/to/your/project
droid

进入交互界面后用 /model（或启动时的模型选择菜单）切换到刚配置的 … [byesu] 模型，随便问一句让它读一个文件或解释一段代码。能正常返回，即接入成功。

卡住了？

• 401 / Unauthorized：api_key 填错或漏了 sk- 前缀；确认令牌未禁用。详见 常见错误 #auth。
• 无可用渠道 / no channel：当前令牌分组不支持所填 model，换一个该分组内的模型，或重新 选择分组。详见 常见错误 #no-channel。
• 额度不足 / 402：账户余额不够，先充值。详见 常见错误 #balance。
• 连接失败 / 404：base_url 写错——OpenAI 兼容格式必须是 https://byesu.com/v1（带 /v1）。

更多排查见 常见错误 与 选择分组。