Droid CLI 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js：Nodejs macOS

1. 安装 Droid CLI

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：执行安装命令

npm install -g droid-cli

第三步：验证安装

droid --version

如果看到版本号，说明安装成功了。

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

2.1 配置文件在哪里？

Droid CLI 配置文件路径：~/.factory/config.json

什么意思？

• ~ 表示你的用户主目录
• 完整路径是：/Users/你的用户名/.factory/config.json

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

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

第一步：创建配置目录

mkdir -p ~/.factory

第二步：备份现有配置文件（如果存在）

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

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

2.3 写入配置文件

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

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

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

如何替换？

1. 复制上面整段命令
2. 把两处 你的词元AI Key 都替换成你的真实 Key
3. 然后粘贴到终端执行

配置说明：

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

2.4 如果你已经有其他配置

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

正确做法：

1. 用文本编辑器打开配置文件：open -e ~/.factory/config.json
2. 手动把 custom_models 部分合并进去
3. 或者把上面的模型配置添加到现有的 custom_models 数组里

3. 启动并验证

droid

如果配置正确，Droid CLI 会启动并显示可用的模型列表。

常见问题

1. 提示找不到 droid 命令

原因：全局包路径没有加到 PATH 环境变量里。

解决方法：

1. 检查 Node.js 是否正确安装：node -v
2. 重启终端
3. 如果还不行，重新安装 Droid CLI

2. 配置文件写入失败

原因：可能是权限问题或路径不存在。

解决方法：

1. 手动创建目录：mkdir -p ~/.factory
2. 然后再执行配置文件写入命令

3. API 调用失败

原因：API Key 不正确，或者词元AI账户余额不足。

解决方法：

1. 检查配置文件是否正确：cat ~/.factory/config.json
2. 确认 API Key 是否正确（注意不要有多余的空格）
3. 登录词元AI官网检查账户余额