如果你只想尽快跑通第一个 Agent，请看快速开始，那是一条六步的最短路径。本页补充的是它没展开的部分：各平台的差异，以及 BootAgent 到底往你机器上写了什么。

下载哪一个

下载中心会根据你的系统推荐一个构建，各平台的产物都列在同一页，你可以手动选。

需要校验时，对照 GitHub Releases 随发行公布的校验清单；算出来的值不一致就不要运行它。

macOS：已签名并通过公证

自 v0.7.0 起，macOS 产物带 Developer ID 签名并经 Apple 公证。打开 DMG、把应用拖进「应用程序」、正常启动即可，不会再出现“无法验证开发者”的拦截。

如果你打开的是 v0.6.x 或更早的历史预览版，Gatekeeper 仍会拦截——那些包没有签名。不要为旧版添加放行例外，升级到当前版本即可。BootAgent 不会提供任何降低你系统安全策略的绕过方法。

Windows 的 Authenticode 签名还没完成，首次运行时 SmartScreen 可能提示“未知发布者”，确认发布来源与 SHA-256 后再继续。

Linux 没有系统级的签名拦截，下载后加可执行权限即可运行。

它本身是一个应用，不常驻后台、不装系统服务、不改你的 shell 配置。真正会被写入的只有两类文件：

Agent 的配置文件。 每个 Agent 有自己的位置，比如 Codex 是 ~/.codex/config.toml，Claude Code 是 ~/.claude/settings.json。只有你在界面上确认之后才会写，写之前一定先备份，详见备份与回退。

BootAgent 自己的目录。 ~/.bootagent/，存放配置模版、以及它托管安装的运行时。

命令行 Agent 大多需要 Node。如果你机器上没有，BootAgent 会把它装进 ~/.bootagent/runtimes/，不动系统的 Node，也不改 PATH。已经装了的话它会直接用现有的。

包和运行时默认走 npmmirror（阿里云）镜像，国内网络不用另外配代理。

打开后第一屏是环境总览：本机每个 Agent 分别处于“已安装”、“已配置”、“未安装”哪个状态。这三件事是分开列的——装了和配好了是两回事，压成一个对勾反而让人不知道下一步做什么。