跳转到主要内容

​
安装 Avibe

Avibe 运行在你的数据和编码 Agent 所在的机器上。

​
桌面应用

macOS 和 Windows 桌面应用自带 Avibe 需要的一切，包括 Python 和 Node，不用事先安装别的东西。下载与你的机器对应的安装包： 这些链接始终指向最新的正式版。每个版本及其校验文件也都在 GitHub Releases 上。
  • **macOS：**打开 DMG，把 Avibe 拖进“应用程序”，然后启动。应用使用 Avibe 的 Developer ID 签名，并经过 Apple 公证。如果 macOS 提示它已损坏或无法验证，不要绕过这个警告：删除下载的文件，重新下载。
  • Windows：运行安装程序。它暂时还没有代码签名，Windows 可能会弹出 SmartScreen 或“未知发布者”提示。只有在你机器的策略允许时，才选择更多信息 > 仍要运行。
应用会在自己的窗口里打开设置向导，每次启动时检查更新。Claude Code、Codex 和 OpenCode 如果已经装过会被自动识别，没装过的在你选择时安装。会话、设置和凭证保存在 ~/.avibe，重新安装应用不会丢失。 关闭窗口不会停止 Avibe。卸载时，先在应用菜单里选择卸载 Avibe…，它会同时移除应用的私有运行时和由它安装的 Agent；然后删除应用（macOS）或使用 Windows 的卸载程序。你在 ~/.avibe 里的数据会保留。

​
macOS 和 Linux

开源脚本，源码在 GitHub 上；如果想先审计再安装，看下面的”审计后再安装”小节。该短链只是到这个文件的 307 重定向。 验证安装：
启动服务和设置向导：

​
Windows

Windows 推荐使用 WSL：
  • Windows 负责浏览器和聊天 App。
  • WSL 里的 Ubuntu 负责 Avibe、Agent CLI 和代码仓库。
在 WSL 的 Ubuntu 里运行：
也可以使用原生 PowerShell 安装，但对 Python、Node、Git 和编码 Agent CLI 来说，WSL 通常更顺：
在原生 Windows 安装上，内置的 Vibey Agent 用 PowerShell 运行命令；在 WSL 里则用 bash。

​
审计后再安装

想在执行前先读一下脚本？先把它下到本地、看一遍再执行：
https://avibe.bot/install.sh 是到 GitHub raw 文件的 307 重定向，两个 URL 的内容完全一致。

​
安装脚本做什么

安装脚本会：
  • 安装 vibe CLI。
  • 优先使用 PyPI，必要时回退到 GitHub。
  • 如果命令已安装但当前 shell 不可见，会打印 PATH 指引。
  • 把模型凭证（登录订阅或填入 API Key）留给设置向导，把聊天平台凭证留到设置 > 通讯平台里处理。

​
升级

重新运行安装脚本：

​
卸载

带上 --uninstall 运行安装脚本。它会先停止 Avibe，再删除它在这台机器上装的所有 vibe 命令和安装文件；不是它装的 vibe 不会动。~/.avibe（以及旧版的 ~/.vibe_remote）里的设置、会话和其他数据都会保留：
如果连数据也要删，加上 --purge。它会先列出要删除的全部内容，确认后才删。删除的数据无法恢复。 没有终端可以回答确认时，还需要加 --yes。
如果是原生 PowerShell 安装，带上 -Uninstall 运行 Windows 安装脚本。加上 -Purge 会连数据一起删除；会话无法弹出确认提示时，还需要加 -Yes：
卸载程序从不顺着链接删除。链接背后的内容只会报告出来，由你自己删除。