主题
Droid CLI
Droid CLI 是 Factory 的终端编程 Agent。接到 AiCodeCat 用本地 settings.json 的 customModels(BYOK),不要去 Factory 控制台抄 Key。
按厂家填地址,能不能加 /v1 不一样:
| 模型 | provider | baseUrl | 注意 |
|---|---|---|---|
| Claude | anthropic | https://aicode.cat | 不要 /v1(走 Anthropic Messages) |
| GPT / Grok | generic-chat-completion-api | https://aicode.cat/v1 | 要 /v1(Chat Completions) |
| Gemini | generic-chat-completion-api | https://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 | shLinux 若提示打不开浏览器,先装 xdg-utils(Debian / Ubuntu:sudo apt-get install xdg-utils)。
装完新开一个终端,确认命令存在:
Bash
droid --version2. 写入自定义模型
配置文件:~/.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
Windows
1. 安装
在 PowerShell 执行:
PowerShell
irm https://app.factory.ai/cli/windows | iex装完新开一个 PowerShell,确认:
PowerShell
droid --version2. 写入自定义模型
配置文件:%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)、安装。