> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avibe.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> 安装 Avibe，启动设置向导，并从聊天 App 发送第一个任务。

# Quickstart

这篇指南会让你在 macOS 或 Linux 上启动 Avibe，并配置一个聊天平台和一个编码 Agent。

## 1. 安装 Avibe

```bash theme={null}
curl -fsSL https://avibe.bot/install.sh | bash
```

开源脚本，源码在 [GitHub](https://github.com/avibe-bot/avibe/blob/master/install.sh) 上；该短链只是到这个文件的 307 重定向。

启动它：

```bash theme={null}
vibe
```

浏览器设置向导会自动打开。如果没有自动打开，请使用终端里打印的本地 URL。

## 2. 安装一个编码 Agent

至少选择一个后端。

OpenCode：

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
```

Claude Code：

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

Codex：

```bash theme={null}
npm install -g @openai/codex
```

验证：

```bash theme={null}
opencode --version || true
claude --version || true
codex --version || true
```

## 3. 配置设置向导

在向导里选择：

1. 聊天平台：Slack、Discord、Telegram、微信或 Lark / 飞书。
2. Agent 后端：Claude Code、OpenCode 或 Codex。
3. 项目工作目录。
4. Avibe 应该响应的 channel 或 chat。

<Note>
  还不想接聊天 App？可以跳过平台这一步——内置的 **Avibe Workbench**（Web UI 里的本地 Web 聊天）始终开着。下面的冒烟测试消息直接在 Workbench 里发就行，之后再添加聊天平台。见[设置向导](/zh/get-started/setup-wizard)。
</Note>

## 4. 发送冒烟测试消息

在启用的聊天里发送：

```text theme={null}
Say hello and tell me which project directory you are running in.
```

然后检查本地状态：

```bash theme={null}
vibe status
```

## 5. 装进口袋(avibe.bot Cloud)

你的 Avibe 不该被钉在桌面上。手机、平板或者借来的笔记本上:

```bash theme={null}
vibe remote
```

一行命令拿到你的专属 `alex-app.avibe.bot` 地址,走 avibe.bot 安全 tunnel。数据和 Agent 始终留在你机器上,过隧道的只是 Web UI 流量。完整配置见 [avibe.bot Cloud](/zh/concepts/remote-ui)。