Skip to content

Droid CLI ​

Droid CLI 是 Factory 的终端编程 Agent。接到 AiCodeCat 用本地 settings.json 的 customModels(BYOK),不要去 Factory 控制台抄 Key。

按厂家填地址,能不能加 /v1 不一样:

模型providerbaseUrl注意
Claudeanthropichttps://aicode.cat不要 /v1(走 Anthropic Messages)
GPT / Grokgeneric-chat-completion-apihttps://aicode.cat/v1要 /v1(Chat Completions)
Geminigeneric-chat-completion-apihttps://aicode.cat/v1beta要 /v1beta

不要用 Factory 的 provider: "openai" 去接 GPT:那是 OpenAI Responses 接口,和这里的 Chat Completions 不是一路。

先到 创建 API Key 拿一把 Key。模型 ID 以 主站控制台 为准。

macOS / Linux ​

1. 安装 ​

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

Linux 若提示打不开浏览器,先装 xdg-utils(Debian / Ubuntu:sudo apt-get install xdg-utils)。

装完新开一个终端,确认命令存在:

Bash
droid --version

2. 写入自定义模型 ​

配置文件:~/.factory/settings.json(不要再用旧的 config.json)。把 在这里替换成你的_API_KEY 换成仪表盘 Key:

命令行写入
mkdir -p "$HOME/.factory"
cat > "$HOME/.factory/settings.json" << 'EOF'
{
  "customModels": [
    {
      "model": "claude-opus-4-8",
      "displayName": "AiCodeCat Claude",
      "baseUrl": "https://aicode.cat",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "anthropic"
    },
    {
      "model": "gpt-6.1",
      "displayName": "AiCodeCat GPT",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    },
    {
      "model": "grok-4.6",
      "displayName": "AiCodeCat Grok",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    },
    {
      "model": "gemini-3-pro",
      "displayName": "AiCodeCat Gemini",
      "baseUrl": "https://aicode.cat/v1beta",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    }
  ]
}
EOF
echo "已写入 ~/.factory/settings.json"
手动:settings.json
{
  "customModels": [
    {
      "model": "claude-opus-4-8",
      "displayName": "AiCodeCat Claude",
      "baseUrl": "https://aicode.cat",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "anthropic"
    },
    {
      "model": "gpt-6.1",
      "displayName": "AiCodeCat GPT",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    }
  ]
}

每个厂家一条,不要共用一个 baseUrl。模型名改成控制台里的 ID。

3. 选用并验证 ​

在项目目录运行:

Bash
droid

若弹出登录 Factory,可以登录或关掉;打 AiCodeCat 只认上面的 Key。输入 /model,在 Custom models 里选刚加的模型,发一句「回复 ok」。

Windows ​

1. 安装 ​

在 PowerShell 执行:

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

装完新开一个 PowerShell,确认:

PowerShell
droid --version

2. 写入自定义模型 ​

配置文件:%USERPROFILE%\.factory\settings.json

命令行写入
$dir = Join-Path $env:USERPROFILE ".factory"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
@'
{
  "customModels": [
    {
      "model": "claude-opus-4-8",
      "displayName": "AiCodeCat Claude",
      "baseUrl": "https://aicode.cat",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "anthropic"
    },
    {
      "model": "gpt-6.1",
      "displayName": "AiCodeCat GPT",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    },
    {
      "model": "grok-4.6",
      "displayName": "AiCodeCat Grok",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    },
    {
      "model": "gemini-3-pro",
      "displayName": "AiCodeCat Gemini",
      "baseUrl": "https://aicode.cat/v1beta",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    }
  ]
}
'@ | Set-Content -Encoding utf8 (Join-Path $dir "settings.json")
Write-Host "已写入 $dir\settings.json"
手动:settings.json
{
  "customModels": [
    {
      "model": "claude-opus-4-8",
      "displayName": "AiCodeCat Claude",
      "baseUrl": "https://aicode.cat",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "anthropic"
    },
    {
      "model": "gpt-6.1",
      "displayName": "AiCodeCat GPT",
      "baseUrl": "https://aicode.cat/v1",
      "apiKey": "在这里替换成你的_API_KEY",
      "provider": "generic-chat-completion-api"
    }
  ]
}

把 JSON 里的 Key 换成仪表盘里的,保存后新开终端再运行 droid。

3. 选用并验证 ​

PowerShell
droid

/model → Custom models → 选刚加的模型 →「回复 ok」。

排错 ​

  • Claude 401:在该条上加 "authMode": "bearer"(默认发 x-api-key,有的网关要 Authorization: Bearer)。
  • GPT 连不上:确认 provider 是 generic-chat-completion-api,地址带 /v1,不要写成站点根。
  • 改完配置不生效:完全退出 droid 再开;旧 config.json 会被 settings.json 盖掉。
  • 失败先看 常见报错。

官方说明:Custom Models (BYOK)、安装。