Droid CLI 接入指南

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

你需要准备

• Node.js 22 或更高版本：Droid CLI 以 npm 全局包分发，对 Node 版本敏感，低于 22 会在启动时报错。
• AI通道 API Key：登录 aitongdao.com 后进入「令牌」菜单创建，选择合适的分组（Claude 模型用 claude、GPT 模型用 codex），保存以 sk- 开头的密钥。
• OpenAI 兼容接入地址：https://ai.aitongdao.com/v1（Droid CLI 的本地模型列表使用 OpenAI 协议格式，带 /v1 后缀）。
• 钱包余额：API Key 所属账户需要有余额才可调用。

选择你的系统

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

• Windows 手动安装
• macOS 手动安装
• Linux 手动安装

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

配置文件骨架

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

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

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