Droid CLI 安装教程（Windows）

0. 前置：安装 Node.js

先装 Node.js：Nodejs Windows

1. 安装 Droid CLI

npm install -g droid-cli
droid --version

2. 配置 Droid CLI（接入词元AI）

2.1 配置文件在哪里？

Droid CLI 配置文件路径：%USERPROFILE%\.factory\config.json

什么意思？

• 完整路径是：C:\Users\你的用户名\.factory\config.json

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

如果你之前已经配置过 Droid CLI，建议先备份：

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

这个命令会检查配置文件是否存在，如果存在就复制一份备份。

2.3 创建配置目录

New-Item -ItemType Directory -Force -Path “$env:USERPROFILE\.factory”

2.4 写入配置文件

下面是一个配置示例，同时添加了 Claude 和 GPT 两个模型（注意替换 API Key）：

@'
{
  “custom_models”: [
    {
      “model_display_name”: “Claude Sonnet (CI-Yuan AI)”,
      “model”: “claude-sonnet-4-6”,
      “base_url”: “https://api.ci-yuan-ai.com/v1”,
      “api_key”: “你的词元AI Key”,
      “provider”: “anthropic”,
      “max_tokens”: 8192
    },
    {
      “model_display_name”: “GPT Codex (CI-Yuan AI)”,
      “model”: “gpt-5.2-codex”,
      “base_url”: “https://api.ci-yuan-ai.com/v1”,
      “api_key”: “你的词元AI Key”,
      “provider”: “openai”,
      “max_tokens”: 16384
    }
  ]
}
'@ | Set-Content -Path “$env:USERPROFILE\.factory\config.json” -Encoding UTF8

必须替换：把两处 你的词元AI Key 都替换成你从词元AI官网复制的真实 Key

配置说明：

• model_display_name - 在界面上显示的模型名称
• model - 实际调用的模型 ID
• base_url - 词元AI的服务地址
• api_key - 你的 API Key
• provider - 模型提供商（anthropic 是 Claude，openai 是 GPT）
• max_tokens - 最大输出长度

2.5 如果你已经有其他配置

重要提示：如果你的 config.json 里已经有其他配置（比如其他模型、其他设置），不要直接用上面的命令覆盖！

正确做法：

1. 用记事本打开配置文件：notepad “$env:USERPROFILE\.factory\config.json”
2. 手动把 custom_models 部分合并进去
3. 或者把上面的模型配置添加到现有的 custom_models 数组里

3. 启动并验证

droid