跳转到主要内容

​
Quickstart

这篇指南会让你在 macOS 或 Linux 上启动 Avibe，并和 Avibe 内置的 AI 伙伴 Vibey 聊起来。你只需要一个供网关使用的模型来源：一个 API Key，或者一个登录为网关来源的订阅。由 Claude Code 或 Codex CLI 原生使用的订阅不会供给 Vibey。

​
1. 安装 Avibe

开源脚本，源码在 GitHub 上；该短链只是到这个文件的 307 重定向。 更想用 App？在 macOS 或 Windows 上，也可以改装桌面应用。它会自己打开设置向导，装好后直接看第 2 步。 启动它：
浏览器设置向导会自动打开。如果没有自动打开，请使用终端里打印的本地 URL。

​
2. 添加一个模型来源

向导先打开一个介绍页，选择立即开始。 在添加模型供应商这一步，选择添加订阅或 API Key，然后粘贴一个 API Key，或者用订阅登录并选择添加为模型供应商（登录为网关来源），这样 Vibey 才能使用它。如果 Model Hub（Avibe 的本地模型网关）还没运行，Avibe 会自动安装并启动它。如果 Avibe 检测到你已经配置过的 API Key，会提示直接迁移，不用重新填写。 来源添加好后，选择继续，选择 AI 助手。

​
3. 和 Vibey 聊起来

在选择你的 AI 助手这一步，Vibey 的卡片排在第一，标着内置 · 始终开启。如果卡片上写着还没有模型，选一个即可开始，就从它列出的型号里选一个，或者打开全部模型…。然后选择进入工作台。 在 Workbench 里给 Vibey 发第一条消息：
然后检查本地状态：

​
4. 也带上你自己的 Agent

Avibe 会照原样运行官方的 Claude Code、Codex、OpenCode，和 Vibey 并存。想用哪个就装哪个： OpenCode：
Claude Code：
Codex：
验证：
选择你的 AI 助手这一步会检测已安装的 CLI，对缺失的提供一键安装，并让你逐个启用。如果是设置完成后才装的，到设置 > 后端里启用。你的 Model Hub 来源也可以供给这些 Agent。

​
5. 接入聊天 App（可选）

Workbench 始终开着，所以聊天 App 是可选的。想从 Slack、Discord、Telegram、微信或 Lark / 飞书找到 Avibe，到设置 > 通讯平台里接入——见 Slack、Discord、Telegram 或微信和飞书——然后在启用的聊天里发同一条冒烟测试消息。

​
6. 装进口袋（avibe.bot Cloud）

你的 Avibe 不该被钉在桌面上。手机、平板或者借来的笔记本上：
一行命令拿到你的专属 alex-app.avibe.bot 地址，走 avibe.bot 安全 tunnel。代码库和 Agent 运行时留在你的机器上，tunnel 把 Web UI 流量送回本机。远程访问的完整配置见 avibe.bot Cloud，其他所有网络路径见本地优先边界清单。