跳转到主要内容

设置向导

运行:
Avibe 会启动本地 Web UI 并打开设置向导。

你会配置什么

向导共有三屏:
  1. 介绍 —— Vibey 和其他助手如何协作:由 Vibey 统筹,Claude Code、Codex、OpenCode 接力完成。 选择立即开始。
  2. 添加模型供应商 —— 把一个订阅或 API Key 加进 Model Hub。
  3. 选择你的 AI 助手 —— 给 Vibey 选一个型号,启用 Claude Code、Codex 或 OpenCode,然后选择进入工作台。
进入工作台即完成设置,下次启动就不会再被带回向导。所有内容之后都能在「设置」里修改。

模型供应商

向导让每个助手都经由 Model Hub(Avibe 的本地模型网关)获取模型,需要时会自动安装并启动它。选择添加订阅或 API Key,用订阅登录或粘贴 API Key。要给 Vibey 用,请使用 API Key,或者在订阅登录时选择添加为模型供应商(登录为网关来源):由它自己的 CLI 原生使用的订阅不会供给 Vibey。如果 Avibe 检测到你已经配置过的 API Key,会提示直接迁移,不用重新填写。 至少添加一个来源,然后选择继续,选择 AI 助手。正如 Model Hub 卡片上写的:一次接入,所有助手共用。

Agent 后端

设置向导的「选择你的 AI 助手」页面:Vibey 的卡片排第一,接着是 Claude Code、Codex 和 OpenCode,各带默认型号

产品界面,示例项目数据。

选择你的 AI 助手这一屏为每个助手显示一张卡片:Vibey 排第一,然后是 Claude Code、Codex、OpenCode。
  • Vibey 是内置的,卡片上标着内置 · 始终开启,不需要安装或启用。在它有型号之前,卡片会写着还没有模型,选一个即可开始,并列出你的来源提供的型号和全部模型…。只要 Vibey 有了型号,单靠它就能完成设置。见 Vibey。
  • Claude Code、Codex 和 OpenCode 照原样运行它们的官方 CLI。向导会检测哪些已经安装、对缺失的提供一键安装,并让你逐个启用。启用后的助手会显示它将使用的模型路由,配置模型路由可以打开查看。如果 OpenCode 被设置为每次工具调用都要确认,它的卡片上会出现允许工具调用。
要进入工作台,需要给 Vibey 选一个型号,或者启用一个能连上模型的助手:为 Vibey 选择模型或启用一个助手,即可进入工作台。你可以启用多个后端,并把不同 channel 路由到不同 Agent。

Avibe Workbench 始终可用

你不需要任何第三方聊天 App 就能使用 Avibe。Avibe Workbench 是内置在本地 Web UI 里的 Web 聊天界面,始终启用——它是唯一一个你无法关闭的界面。接入 Slack、Discord 等都是可选的、叠加式的。 在手机上,打开 Workbench 的 URL,用浏览器的添加到主屏幕(Add to Home Screen)就能把它装成一个 App。
只用工作台也是一套完整的设置。向导不会要求接入聊天平台,之后想用时再添加。

聊天平台(可选)

在设置 > 通讯平台里接入你本来就在工作的聊天 App。每个平台都有自己的凭证步骤。

优先使用向导,而不是手改配置

Avibe 会把持久化配置存到你的本地用户目录。调试时可以检查配置文件,但首次设置应该走向导,因为向导会验证凭证和模型连接。