Droid配置

HuiLiu Team大约 3 分钟CLI 配置

Droid 配置

Droid 是 Factory 出品的 AI 编程 CLI 工具，功能类似 Claude Code，支持自定义第三方模型接入。本节介绍如何通过 HuiLiu API 使用 Droid。

前置条件

已安装 Droid
已用 Google 账号登录 Droid
已在控制台创建令牌（Claude 分组或通用分组，取决于你要用的模型）

安装 Droid

Windows PowerShell（管理员）

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

macOS / Linux

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

安装完成后运行 droid，会自动跳转浏览器完成 Google 账号登录。

配置文件位置

系统	路径
Windows	`C:\Users\<用户名>\.factory\config.json`
macOS	`~/.factory/config.json`
Linux	`~/.factory/config.json`

注意

如果 config.json 不存在，需要手动创建。

快速打开目录：

Windows: 资源管理器地址栏输入 %USERPROFILE%\.factory
macOS: 终端输入 open ~/.factory
Linux: 终端输入 xdg-open ~/.factory

配置 HuiLiu API

在 ~/.factory/config.json 中添加以下内容：

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4 [HuiLiu]",
      "model": "claude-sonnet-4-20250514",
      "base_url": "https://www.huiliuapi.com",
      "api_key": "sk-你的令牌",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 16384
    },
    {
      "model_display_name": "Opus 4 [HuiLiu]",
      "model": "claude-opus-4",
      "base_url": "https://www.huiliuapi.com",
      "api_key": "sk-你的令牌",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 16384
    }
  ]
}

如果你还想加 GPT 或其他 OpenAI 兼容模型，追加到 custom_models 数组中：

{
  "model_display_name": "GPT-4o [HuiLiu]",
  "model": "gpt-4o",
  "base_url": "https://www.huiliuapi.com/v1",
  "api_key": "sk-你的通用分组令牌",
  "provider": "openai",
  "supports_vision": true,
  "max_tokens": 8192
}

关键区别

Claude 模型：base_url 不带 /v1，provider 填 anthropic，令牌选 Claude Code 分组
OpenAI 模型：base_url 带 /v1，provider 填 openai 或 openai-responses，令牌选 通用分组

配置字段说明

字段	说明	必填
`model_display_name`	在 Droid 中显示的名称（自定义）	是
`model`	实际调用的模型 ID	是
`base_url`	API 地址	是
`api_key`	你的 API 令牌	是
`provider`	提供商类型：`anthropic` / `openai` / `openai-responses` / `gemini`	是
`supports_vision`	是否支持图片识别	否
`max_tokens`	最大输出 token 数	否

切换模型

配置完成后，启动 Droid：

cd your-project
droid

在对话界面输入 /model，从列表中选择你配置的 HuiLiu 模型。

压缩设置（重要）

使用第三方模型时，Droid 的上下文压缩功能默认指向官方模型，会因无权限而失败。

解决方法：

在 Droid 中输入 /settings
找到 压缩模型（Summarization Model），切换为当前使用的第三方模型
找到 压缩上下文大小，设置为 200k
保存

开启思考模式

如需开启 Extended Thinking（深度推理），需手动修改 settings.json：

Windows: C:\Users\<用户名>\.factory\settings.json
macOS/Linux: ~/.factory/settings.json

修改以下字段：

{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}

值	说明
`low`	轻度思考，响应快
`medium`	中等思考
`high`	深度思考，适合复杂任务

注意

每次用 /model 切换模型后，settings.json 会被刷新，需要重新设置思考模式。

常用命令

命令	功能
`/model`	切换模型
`/settings`	打开设置
`/clear`	清空对话
`/help`	查看帮助
`/compact`	压缩上下文
`Esc` 两次	中断当前操作
`Ctrl+C`	退出 Droid

常见问题

Q: `/model` 列表中看不到配置的模型

config.json 格式有误。用 jsonlint.com 检查 JSON 语法，修正后重启 Droid。

Q: 报 401 错误

API Key 无效，检查 config.json 中的 api_key
确认令牌分组与 provider 匹配

Q: 报 400 错误

模型名称错误，检查 model 字段是否与控制台"模型广场"中的名称一致。

Q: 压缩失败（compaction failed）

参考上方"压缩设置"章节，将压缩模型切换为当前使用的第三方模型。

Q: 提示 "Failed to create session. Is the daemon running?"

v100+ 版本升级后的常见问题：

删除 settings.json（路径同上）
删除系统环境变量中的 FACTORY_API_KEY（如果有）
重新打开终端，运行 droid，用 Google 账号重新登录
用 /model 重新选择模型
用 /settings 重新配置压缩选项

Q: 如何更新 Droid？

重新运行安装命令即可覆盖更新。