Factory Droid CLI 教程：终端 AI 编程 agent 接国产模型（2026）

终端 AI 编程这条赛道上，Claude Code、Codex CLI、Qwen Code 已经打得很热闹，但 Factory 的 Droid 是个中文资料极少、能力却相当完整的选择。它的差异化很明确：不锁模型厂商。同一个 CLI 里你可以让 Claude 做架构设计、让 DeepSeek 跑批量重构、让本地 Ollama 处理敏感代码，全靠一份 BYOK 配置切换。这篇 Factory Droid CLI 教程覆盖安装、TUI 上手、droid exec 无头模式、接国产模型的完整配置，以及和主流工具的选型对比。

Factory Droid 是什么

Droid 是 Factory AI 出品的终端 AI 编程 agent。它能读懂整个代码库、自主完成构建调试重构、也能被塞进 CI 流水线批量干活。你可以通过三个入口用它：Droid CLI（全屏终端 TUI）、Factory 桌面客户端、以及 droid exec（无头非交互执行，给 CI 和 cron 用）。

安装：四种方式任选

# macOS / Linux —— 官方安装脚本
curl -fsSL https://app.factory.ai/cli | sh

# macOS —— Homebrew
brew install --cask droid

# 跨平台 —— npm
npm install -g droid

Windows 用户在 PowerShell 里执行：

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

装完进入项目目录直接启动，首次运行会提示通过浏览器登录 Factory 账号：

cd /path/to/your/project
droid

TUI 上手：几个必须知道的键位

• 输入任务后按 Enter 发送；Shift+Enter 换行输入多行内容
• Droid 提出的改动会在 TUI 里以 diff 展示，逐项接受或拒绝
• 按 ! 进入 Bash 模式直接敲 shell 命令，Esc 退回对话
• 按 ? 查看全部可用命令
• /model 切换模型（自定义模型会单独分组显示）
• Ctrl+C 或输入 exit 退出

第一次用建议先让它读代码而不是改代码，比如「分析这个代码库并解释整体架构」或「这个项目用了哪些技术栈和框架」，先确认它对你的仓库理解得准不准，再交给它写东西。

droid exec：把 agent 塞进 CI 和脚本

droid exec 是无头模式，一次性执行不进交互界面，适合 CI/CD、定时任务和批处理。典型用法是给它一句任务描述，让它在流水线里自动改代码、跑测试、提交结果。

droid exec "修复 lint 报错并确保 npm test 通过"

BYOK：接 DeepSeek / GLM / Kimi 等国产模型

这是 Droid 最值得国内开发者关注的能力。它从 ~/.factory/settings.json 读取自定义模型，字段用驼峰命名。（旧版 ~/.factory/config.json 用下划线命名，仍能工作但优先级更低，且不支持环境变量展开——新配置请直接用 settings.json。）

{
  "customModels": [
    {
      "model": "deepseek-chat",
      "displayName": "DeepSeek V3",
      "baseUrl": "https://api.deepseek.com/v1",
      "apiKey": "${DEEPSEEK_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    },
    {
      "model": "glm-4.6",
      "displayName": "GLM 智谱",
      "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
      "apiKey": "${GLM_API_KEY}",
      "provider": "generic-chat-completion-api"
    },
    {
      "model": "kimi-k2-turbo-preview",
      "displayName": "Kimi K2",
      "baseUrl": "https://api.moonshot.cn/v1",
      "apiKey": "${MOONSHOT_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

各字段含义：

provider 只有三个合法值，选错了会直接连不上：

配置好后重启 droid，执行 /model，自定义模型会出现在单独的分组里，选中即生效。同一个项目里随时切——复杂架构任务切 Claude，大批量机械重构切 DeepSeek 省钱，涉密代码切本地 Ollama。

价格：没有免费版，但 BYOK 有额度

计费模型和常见的「每座位 token 桶」不同，Droid 走的是滚动速率限制：5 小时、每周、每月三个窗口同时计。标准额度先消耗；用完之后还有两条路——Droid Core（Factory 指定的一批开源权重模型，走独立速率限制，不额外收费），或者 Extra Usage（预付费点数，最低充值 $10，点数不过期）。另外所有个人套餐都包含一定额度的免费 BYOK 用量。

Droid vs Claude Code vs Codex CLI：怎么选

选型结论很直接：如果你需要在一个 CLI 里频繁切换多家模型、或者要把 agent 大规模塞进 CI 流水线，Droid 的 BYOK 设计比其他工具顺手得多。如果你更看重成熟生态、插件市场和海量中文教程，Claude Code 仍然是稳妥选择。两者并不冲突——不少人日常用 Claude Code，批量任务用 droid exec 接便宜的国产模型跑。

工具本身只是杠杆，真正决定产出的还是你能不能把需求拆清楚、把 agent 的边界划明白、把它写出来的代码审明白。终端 agent 越自主，这三件事就越关键。想系统学会用 AI 工具把想法变成真正能交付的产品，欢迎来 IMAI 看看我们的体系化实战课程。