Droid（Factory）接入

把 QCode.cc 配成 Factory Droid CLI 的 BYOK 自定义模型：~/.factory/settings.json 里 provider=anthropic + baseUrl

Droid（Factory）接入 ¶

Droid 是 Factory 出品的终端 AI 编程 Agent，支持 BYOK（自带密钥）自定义模型，可以把 QCode.cc 配成上游。

走哪条腿 ¶

Droid 的自定义模型用 provider 字段区分协议。要用 Claude 就填 anthropic——QCode 的 OpenAI 端点不接受 Claude 模型（见接入点与 API 格式）。

你想用的模型	`provider`	`baseUrl`
Claude	`anthropic`	`https://api.qcode.cc/api`
GPT 系 / 国产四家族	`openai`（OpenAI 兼容）	`https://api.qcode.cc/openai/v1`

安装 ¶

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

安装到 ~/.local/bin/droid。如提示 PATH 未配置，按脚本给出的命令加进 ~/.zshrc / ~/.bashrc。

验证（以实际输出为准）：

droid --version

配置 ¶

编辑（不存在则新建）~/.factory/settings.json：

{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "QCode Sonnet 5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    },
    {
      "model": "claude-haiku-4-5",
      "displayName": "QCode Haiku 4.5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 4096
    }
  ]
}

密钥用环境变量注入：

export QCODE_KEY="cr_你的QCode密钥"

字段	说明
`model`	传给 API 的模型 id，须与 qcode.cc/models 逐字符一致
`displayName`	模型选择器里显示的名字，随便起
`baseUrl`	填到 `/api` 为止，Droid 会自己拼 `/v1/messages`
`apiKey`	支持 `${变量名}` 形式的环境变量引用
`provider`	Claude 用 `anthropic`
`maxOutputTokens`	单次回复的输出上限

Factory 官方说明：API Key 保存在本地，不会上传到 Factory 服务器。国内用户把域名换成 https://asia.qcode.cc/api（香港节点）即可。

验证 ¶

droid exec --model "claude-sonnet-5" "reply with exactly: OK"

返回 OK 即接通。

阴性对照（证明配置真的生效）：把 baseUrl 临时改成一个不存在的路径再跑一次，应当报错失败。只看到成功不能证明走的是你配的这条腿。

常用用法 ¶

# 交互模式
droid

# 非交互执行
droid exec "把测试跑一遍，修掉失败的用例"

# 指定工作目录
droid --cwd /path/to/project

# 在 git worktree 里跑（隔离改动）
droid -w feature-x

# 自主程度
droid --auto medium