Droid CLI 使用指南

Droid 是 Factory AI 开发的交互式终端 AI 编程助手，支持通过 cch 代理服务使用。使用前必须先注册并登录 Droid 官方账号。

macOS

安装 droid droid

执行：

curl -fsSL https://app.factory.ai/cli | sh

连接 cch 服务

前置步骤：必须先登录 Droid 官方账号

1. 运行 droid 命令
2. 按提示通过浏览器登录 Factory 官方账号
3. 登录成功后，才能继续配置自定义模型

配置自定义模型

配置文件路径：

~/.factory/config.json

编辑配置文件，添加以下内容：

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "当前站点地址",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5.4 [cch]",
      "model": "gpt-5.4",
      "base_url": "当前站点地址/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要说明

• 将 your-api-key-here 替换为您的 cch API 密钥
• Anthropic 格式：使用 当前站点地址（无 /v1）
• OpenAI 格式：使用 当前站点地址/v1（需要 /v1）

切换模型

1. 重启 Droid
2. 输入 /model 命令
3. 选择 GPT-5.4 [cch] 或 Sonnet 4.5 [cch]
4. 开始使用！

启动 droid

在项目目录下运行：

cd /path/to/your/project
droid

首次启动时，droid 会进行初始化配置。

常见问题

1. 命令未找到

 检查 npm 全局安装路径并添加到 PATH（如果不在）
npm config get prefix

 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. 更新 droid

重新运行安装脚本即可更新到最新版本。

Windows

安装 droid droid

在 PowerShell 中执行：

irm https://app.factory.ai/cli/windows | iex

连接 cch 服务

前置步骤：必须先登录 Droid 官方账号

1. 运行 droid 命令
2. 按提示通过浏览器登录 Factory 官方账号
3. 登录成功后，才能继续配置自定义模型

配置自定义模型

配置文件路径：

%USERPROFILE%\.factory\config.json

编辑配置文件，添加以下内容：

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "当前站点地址",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5.4 [cch]",
      "model": "gpt-5.4",
      "base_url": "当前站点地址/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要说明

• 将 your-api-key-here 替换为您的 cch API 密钥
• Anthropic 格式：使用 当前站点地址（无 /v1）
• OpenAI 格式：使用 当前站点地址/v1（需要 /v1）

切换模型

1. 重启 Droid
2. 输入 /model 命令
3. 选择 GPT-5.4 [cch] 或 Sonnet 4.5 [cch]
4. 开始使用！

启动 droid

在项目目录下运行：

cd C:\path\to\your\project
droid

首次启动时，droid 会进行初始化配置。

常见问题

1. 命令未找到

• 确保 npm 全局路径（通常是 C:\Users\你的用户名\AppData\Roaming\npm）已添加到系统 PATH
• 重新打开 PowerShell 窗口

2. 更新 droid

重新运行安装脚本即可更新到最新版本。

Linux

安装 droid droid

执行：

curl -fsSL https://app.factory.ai/cli | sh

提示

Linux 用户需确保已安装 xdg-utils：

group复制
sudo apt-get install xdg-utils

连接 cch 服务

前置步骤：必须先登录 Droid 官方账号

1. 运行 droid 命令
2. 按提示通过浏览器登录 Factory 官方账号
3. 登录成功后，才能继续配置自定义模型

配置自定义模型

配置文件路径：

~/.factory/config.json

编辑配置文件，添加以下内容：

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "当前站点地址",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5.4 [cch]",
      "model": "gpt-5.4",
      "base_url": "当前站点地址/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要说明

• 将 your-api-key-here 替换为您的 cch API 密钥
• Anthropic 格式：使用 当前站点地址（无 /v1）
• OpenAI 格式：使用 当前站点地址/v1（需要 /v1）

切换模型

1. 重启 Droid
2. 输入 /model 命令
3. 选择 GPT-5.4 [cch] 或 Sonnet 4.5 [cch]
4. 开始使用！

启动 droid

在项目目录下运行：

cd /path/to/your/project
droid

首次启动时，droid 会进行初始化配置。

常见问题

1. 命令未找到

 检查 npm 全局安装路径并添加到 PATH（如果不在）
npm config get prefix

 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. 更新 droid

重新运行安装脚本即可更新到最新版本。