Droid CLI 安装教程（Windows）

本页介绍在 Windows 系统上安装 Droid CLI 并接入 AI通道 的完整步骤，使用 PowerShell 作为操作终端。

0. 前置：安装 Node.js

Droid CLI 要求 Node.js 22 或更高版本。打开 PowerShell 执行：

node --version

如果返回结果低于 v22.0.0，请先查阅 Node.js Windows 安装指南 完成升级。

1. 安装 Droid CLI

在 PowerShell 中执行全局安装命令：

npm install -g droid-cli

安装完成后校验版本号：

droid --version

若提示 droid 不是内部或外部命令，通常是 npm 全局路径没有加入系统 PATH，关闭并重新打开 PowerShell 窗口再试。

2. 配置 Droid CLI（接入 AI通道）

2.1 配置文件在哪里

Droid CLI 读取用户目录下的 .factory\config.json，完整路径为：

%USERPROFILE%\.factory\config.json

2.2 备份现有配置（如果有）

如果该文件已经存在（例如你之前接入过其他服务），先备份一份：

if (Test-Path "$env:USERPROFILE\.factory\config.json") {
  Copy-Item "$env:USERPROFILE\.factory\config.json" "$env:USERPROFILE\.factory\config.json.bak"
}

2.3 创建配置目录

确保目录存在：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.factory" | Out-Null

2.4 写入配置文件

下面这段命令会把同时包含 Claude 与 GPT 的配置写入 config.json，记得替换两处 sk-你的密钥：

$config = @'
{
  "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
    }
  ]
}
'@
Set-Content -Path "$env:USERPROFILE\.factory\config.json" -Value $config -Encoding UTF8

字段说明：

字段	说明
model_display_name	在 Droid CLI 交互界面显示的名称，自定义
model	实际请求时发给后端的模型 ID
base_url	接口基地址，AI通道 使用 https://ai.aitongdao.com/v1
api_key	你在 AI通道 令牌页面创建的 sk- 密钥
provider	协议类型：anthropic 走 Claude 协议，openai 走 OpenAI 协议
max_tokens	单次回复最大 token 数，常用 8192

2.5 如果你已经有其他配置

Droid CLI 的 custom_models 是一个数组，可以追加条目而不是整体覆盖。用任意编辑器打开 %USERPROFILE%\.factory\config.json，把上面示例中 custom_models 数组里的两条记录追加到你现有数组的末尾即可。

3. 启动并验证

在任意目录下执行：

droid

进入会话后通过 /model 命令查看模型列表，你应该能看到刚才写入的 Claude Sonnet 4.6 (AI通道) 与 GPT-5 (AI通道)。选中任一条，向其发送一个简单问题即可验证调用是否成功。

常见问题

• droid 命令找不到：多半是 Node.js 全局路径未生效，关闭 PowerShell 窗口重开；或执行 npm config get prefix 查看全局目录是否在 PATH 中。
• 配置写入失败：Windows 下用户目录可能带中文或空格，如果 Set-Content 报权限错误，可以用记事本手动创建 %USERPROFILE%\.factory\config.json 并粘贴 JSON 内容。
• API 调用提示 401：检查 api_key 是否完整复制、是否误带多余空格，确认账户仍有余额。
• 模型返回 404 not found：确认 model 字段与 AI通道 后台「可用模型」列表中的名称一致，模型名区分大小写。
• 长回复被截断：适当调高 max_tokens，部分模型支持到 16384 或更高。