Droid CLI 安装教程（Linux）

本页介绍在主流 Linux 发行版（Ubuntu/Debian/CentOS 等）及 WSL2 环境下安装 Droid CLI 并接入 AI通道。

0. 前置：安装 Node.js

Droid CLI 要求 Node.js 22 或更高版本。先检查当前版本：

node --version

若低于 v22.0.0，推荐使用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

1. 安装 Droid CLI

npm install -g droid-cli
droid --version

若出现 EACCES 错误，说明你使用的是系统 Node，没有 npm 全局目录写权限。可选方案：改用 nvm 管理的 Node，或为 npm 指定用户级全局目录。

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

2.1 配置文件在哪里

~/.factory/config.json

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

mkdir -p ~/.factory
[ -f ~/.factory/config.json ] && cp ~/.factory/config.json ~/.factory/config.json.bak

2.3 写入配置文件

把下面两处 sk-你的密钥 替换成你在 AI通道 创建的令牌：

cat > ~/.factory/config.json <<'EOF'
{
  "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
    }
  ]
}
EOF

配置字段说明：

字段	说明
model_display_name	CLI 界面展示名称
model	后端模型 ID，必须与 AI通道 可用模型列表一致
base_url	https://ai.aitongdao.com/v1
api_key	AI通道 令牌，sk- 开头
provider	anthropic（Claude）或 openai（GPT）
max_tokens	回复最大 token

2.4 如果你已经有其他配置

Droid CLI 的 custom_models 字段是数组。如果文件中已经有其他模型条目，用编辑器追加新对象即可，不要整体替换。

3. 启动并验证

droid

进入交互会话后，通过 /model 查看与切换模型，发送一条测试消息确认能正常回复。

常见问题

• droid 命令找不到：检查 npm root -g 和 npm bin -g 的路径，确认 bin 目录在 $PATH。nvm 用户一般无需额外配置。
• 配置写入失败：执行 ls -la ~/.factory 检查目录所有者与权限，必要时 sudo chown -R $USER:$USER ~/.factory。
• API 调用返回 401：令牌可能已过期或被删除，返回 aitongdao.com 令牌页面重新生成。
• 返回 403 或无权限：所选令牌分组不包含所请求的模型，重新创建令牌时选择对应分组（Claude 选 claude，GPT 选 codex）。
• WSL2 下无法访问域名：检查 WSL 的 DNS 配置，可以在 /etc/resolv.conf 中临时使用 nameserver 1.1.1.1 测试。