下载安装

#开始前

• 一台 macOS（Apple Silicon 或 Intel 芯片）或 Windows x64 电脑。
• Windows 需要先装好 Git for Windows 和 Node.js，Caravel 用它们管理项目和安装 Agent。
• Caravel 本身免费下载。Agent 背后的模型按各厂商的订阅或 API 计费，由你自己的账号支付。

#操作步骤

1. 打开 官方下载页，向下滚动到 Assets，按系统下载安装包。

   

   编号	文件	适用系统
   ①	以 _universal.dmg 结尾	macOS，Apple Silicon 和 Intel 通用
   ②	以 _x64-setup.exe 结尾	Windows x64

   列表中的其他文件用于自动更新和校验，不需要下载。

2. 安装：

   • macOS：双击打开 .dmg，把 Caravel 图标拖进「应用程序」文件夹。
   • Windows：双击运行 .exe，按安装向导点击下一步直到完成。

3. 第一次打开。系统可能提示无法验证开发者，按下面「第一次打开被拦截」处理一次即可，以后不会再提示。

#第一次打开被拦截

Caravel 安装包暂未使用 Apple 和微软的开发者签名，所以系统会拦截第一次打开。请先确认安装包来自上面的官方下载页。

#macOS：在系统设置中允许

1. 先双击打开一次 Caravel，让系统弹出阻止提示，点击 完成。
2. 打开「系统设置 → 隐私与安全性」，向下找到 Caravel 被阻止的说明，点击 仍要打开（部分系统版本显示为「仍然打开」）。
3. 输入 Mac 登录密码或使用触控 ID，再点击 打开。

如果找不到这个按钮，也可以打开「终端」，粘贴下面的命令并回车，然后重新打开 Caravel：

xattr -dr com.apple.quarantine /Applications/Caravel.app

这条命令只移除 Caravel 的下载隔离标记，不会关闭系统的安全检查。提示 Permission denied 时，在命令前加上 sudo 再执行，并按提示输入密码。

#Windows：SmartScreen 提示

出现「Windows 已保护你的电脑」时，点击 更多信息，再点击 仍要运行。

#完成后你会看到

Caravel 打开后进入 工作台。第一次使用时任务列表是空的，接下来 安装并登录 Agent。