Droid CLI 使用教程

Droid CLI 是 Factory.ai 的 AI 编程助手。请访问官网了解安装方式：

验证安装：

droid --version

应显示 Droid CLI 的版本信息

Droid CLI 支持自定义模型配置。创建或编辑配置文件：

配置文件路径：

%USERPROFILE%\.factory\config.json

配置内容：

启动 Droid CLI 后，使用 /model 命令选择自定义模型：

droid

在 Droid CLI 中输入：

/model

然后从列表中选择 Sonnet 4.5 [crs] 或 GPT5-Codex [crs]

问题 1: 找不到配置文件

解决： 手动创建 %USERPROFILE%\.factory 目录和 config.json 文件

问题 2: 自定义模型不显示

检查项：

• JSON 格式是否正确（使用 JSON 验证工具）
• custom_models 数组是否包含模型配置
• 重启 Droid CLI

问题 3: API 连接失败

检查项：

• API Key 是否正确（包含 cr_ 前缀）
• base_url 是否正确（不应包含 /v1）
• 网络连接是否正常
• 防火墙是否阻止连接

问题 4: JSON 格式错误

常见错误：

• 字符串必须使用双引号 "，不能用单引号
• 对象最后一个属性后不应有逗号
• 所有括号必须正确闭合

访问官网获取 Droid CLI：

验证安装：

droid --version

创建或编辑 Droid 配置文件：

配置文件路径：

~/.factory/config.json

快速访问配置目录：

# 打开配置目录
open ~/.factory

# 或使用 Finder 快捷键 ⌘+Shift+G 输入: ~/.factory

配置内容：

启动 Droid CLI：

droid

使用 /model 命令选择自定义模型

问题 1: 配置文件不生效

解决： 重启 Droid CLI，或检查 JSON 格式

问题 2: API 连接失败

检查项： API Key、base_url 配置、网络连接

访问官网获取 Droid CLI：

验证安装：

droid --version

创建或编辑 Droid 配置文件：

配置文件路径：

~/.factory/config.json

配置内容：

启动 Droid CLI：

droid

使用 /model 命令选择自定义模型

问题 1: 配置文件权限

解决： 确保 ~/.factory/ 目录有正确的读写权限

问题 2: JSON 格式错误

解决： 使用 JSON 验证工具检查格式，或使用 jq 命令验证

jq . ~/.factory/config.json