Droid CLI 安装教程（macOS）

本页介绍在 macOS（Intel 与 Apple Silicon 均适用）上安装 Droid CLI 并接入 AI通道 的完整步骤。

0. 前置：安装 Node.js

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

node --version

如果低于 v22.0.0，请先查阅 Node.js macOS 安装指南 升级，推荐通过 Homebrew 或 nvm 管理。

1. 安装 Droid CLI

执行全局安装命令：

npm install -g droid-cli

安装完成后验证：

droid --version

若提示 EACCES 权限错误，可以使用 nvm 管理的 Node（无需 sudo），或执行 sudo npm install -g droid-cli。

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

2.1 配置文件在哪里

Droid CLI 读取 ~/.factory/config.json：

echo ~/.factory/config.json

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

mkdir -p ~/.factory
if [ -f ~/.factory/config.json ]; then
  cp ~/.factory/config.json ~/.factory/config.json.bak
fi

2.3 写入配置文件

下面这段命令会生成同时包含 Claude 与 GPT 的配置，记得把两处 sk-你的密钥 替换成自己的 API Key：

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	在 Droid CLI 界面显示的名字
model	实际发到后端的模型 ID
base_url	AI通道 的 OpenAI 兼容端点 https://ai.aitongdao.com/v1
api_key	你在令牌页面创建的 sk- 密钥
provider	anthropic 或 openai，决定协议走向
max_tokens	单次回复最大 token 数

2.4 如果你已经有其他配置

如果你之前接入过其他服务，custom_models 里已有其他条目，不要整体覆盖。用编辑器打开 ~/.factory/config.json，把上面示例中的两个对象追加进原数组即可。

cat ~/.factory/config.json

3. 启动并验证

在任意目录执行：

droid

进入会话后用 /model 切换到 Claude Sonnet 4.6 (AI通道)，发送一条简单指令（例如「用一句话介绍你自己」），若能正常返回即说明接入成功。

常见问题

• droid 命令找不到：检查 npm config get prefix 返回的路径 bin 子目录是否已加入 $PATH。使用 nvm 时通常自动加入，系统 Node 可能需要手动添加到 ~/.zshrc。
• 配置写入失败：目录权限异常时执行 chmod -R u+w ~/.factory；或改用编辑器手动保存文件。
• API 调用失败：先核对 api_key 未多空格，其次访问 aitongdao.com 确认账户余额与令牌分组是否匹配所选模型（Claude 用 claude/ccmax，GPT 用 codex）。
• 响应乱码：确认终端使用 UTF-8 编码；配置文件请勿保存为带 BOM 的 UTF-8。
• 模型切换后无反应：退出 droid 重新启动，确认配置保存成功（cat ~/.factory/config.json）。