Droid CLI 接入指南

Droid CLI 是 Factory 推出的命令行开发助手，支持通过自定义模型列表接入第三方 OpenAI 兼容或 Anthropic 兼容端点。本页汇总在 AI通道上使用 Droid CLI 的准备事项与跳转入口。

你需要准备

安装方式：Droid CLI 通过 Factory 官方脚本安装（macOS/Linux 用 curl -fsSL https://app.factory.ai/cli | sh，Windows 用 PowerShell irm https://app.factory.ai/cli/windows | iex）。如果你已经在用 nvm 等工具管理 Node，也可以用 npm install -g droid 安装（注意包名是 droid，不是 droid-cli）。
Node.js 22 或更高版本（仅 npm 安装方式需要）：走 npm install -g droid 路径时对 Node 版本敏感，低于 22 会在启动时报错；用官方脚本安装则不依赖本地 Node。
AI通道 API Key：登录 aitongdao.com 后进入「令牌」菜单创建，选择合适的分组（Claude 模型用 claude、GPT 模型用 codex），保存以 sk- 开头的密钥。
接入地址（按协议区分）：Anthropic（Claude）条目用 https://ai.aitongdao.com（不带 /v1，Anthropic 协议库会自动拼接 /v1/messages，写成 /v1 反而会 404）；OpenAI 协议（GPT）条目用 https://ai.aitongdao.com/v1（带 /v1 后缀）。
钱包余额：API Key 所属账户需要有余额才可调用。

选择你的系统

Droid CLI 在三大主流平台的安装流程基本一致，差异主要集中在配置文件的写入方式。请按照你所在的系统选择对应教程：

三个教程的产物都是同一份配置文件：~/.factory/config.json，其中用 custom_models 数组列出你希望在 Droid CLI 中使用的模型条目，每条都指向 AI通道的 base URL 并携带你的 API Key。

配置文件骨架

Droid CLI 的配置以本地模型列表的形式组织，每个模型条目都是独立的一行记录，包含 provider、base_url、api_key 等字段。下面是一个同时包含 Claude 与 GPT 的示例骨架（各平台教程会给出完整可用版本）：

json

{
  "custom_models": [
    {
      "model_display_name": "Claude Sonnet 4.6 (AI通道)",
      "model": "claude-sonnet-4-6",
      "base_url": "https://ai.aitongdao.com",
      "api_key": "sk-你的密钥",
      "provider": "anthropic",
      "max_tokens": 8192
    },
    {
      "model_display_name": "GPT-5.5 (AI通道)",
      "model": "gpt-5.5",
      "base_url": "https://ai.aitongdao.com/v1",
      "api_key": "sk-你的密钥",
      "provider": "openai",
      "max_tokens": 8192
    }
  ]
}

完成配置后，在终端运行 droid 即可进入交互会话，在会话中可通过 /model 命令在你列出的模型之间切换。

Droid CLI 接入指南 ​

你需要准备 ​

选择你的系统 ​

配置文件骨架 ​

Droid CLI 接入指南

你需要准备

选择你的系统

配置文件骨架