# 安装 Beav CLI

> 通过官网安装脚本安装或更新 Beav CLI，并在本机浏览器中使用完整工作台。

- 原文: https://www.getbeav.com/docs/getting-started/cli

Beav CLI 适合不需要桌面窗口、希望让 Beav 在后台持续运行，或要把 Beav 连接到 Codex、WorkBuddy 等 Agent 宿主的用户。它与桌面版使用同一套 UI、内部 Agent、工作空间和产品版本；区别只是通过 `localhost` 浏览器访问，不会在 Dock 或任务栏显示桌面窗口。

## macOS 与 Linux

在终端运行：

```bash
curl -fsSL https://www.getbeav.com/install-cli.sh | sh
```

安装器会识别操作系统和 CPU 架构，从 Beav 官网镜像下载对应版本，验证签名、SHA-256 和文件大小，然后安装到当前用户目录。安装成功后会运行 `beav open`，默认工作台地址只监听本机 `127.0.0.1`。

如果 `~/.local/bin` 尚未加入 `PATH`，可以直接运行：

```bash
~/.local/bin/beav open
```

Linux 安装前还需要系统提供 `curl`、`tar` 和 `minisign`。macOS 会同时验证运行时的系统代码签名。

## Windows

在 PowerShell 中运行：

```powershell
irm https://www.getbeav.com/install-cli.ps1 | iex
```

安装器会验证下载摘要、归档内容、Windows Authenticode 签名和 Beav 发布签名，再安装到当前用户的 `%LOCALAPPDATA%\Beav`。

## 启动与后台值守

```bash
beav open
```

`beav open` 会确保本机服务已经启动，并打开浏览器。服务启动后会继续在后台值守；关闭浏览器标签页不会停止 Beav，同一台电脑上的其他浏览器也可以访问终端显示的本机地址。

常用命令：

```bash
beav status
beav open
beav stop
beav doctor
```

CLI 本地模式不需要 Beav 管理员账号。打开工作台后，用户仍然需要登录自己的 Beav 账号。只有显式启用局域网或远程访问时，才需要额外的管理员鉴权和网络安全配置。

## 更新

再次执行同一条官网安装命令即可更新。安装器会下载当前完整版本，验证后切换到新版本；如果安装后的健康检查失败，Unix 安装器会恢复此前的可用版本。

也可以先下载安装器再明确执行更新动作：

```bash
curl -fsSL https://www.getbeav.com/install-cli.sh -o /tmp/beav-install.sh
sh /tmp/beav-install.sh update
```

PowerShell 对应命令：

```powershell
$installer = Join-Path $env:TEMP 'beav-install.ps1'
irm https://www.getbeav.com/install-cli.ps1 -OutFile $installer
& $installer -Action update
```

## 卸载

macOS 与 Linux：

```bash
curl -fsSL https://www.getbeav.com/install-cli.sh | sh -s -- uninstall
```

Windows PowerShell：

```powershell
$installer = Join-Path $env:TEMP 'beav-install.ps1'
irm https://www.getbeav.com/install-cli.ps1 -OutFile $installer
& $installer -Action uninstall
```

普通卸载会删除 CLI 程序，但保留产品数据。清除产品数据属于单独的高风险操作，不要把它与日常更新或重新安装混用。

## 连接 Codex 或 WorkBuddy

CLI 工作台正常启动后，再按照[在 Agent 中使用 Beav](https://www.getbeav.com/docs/agent)安装 Beav Creator Plugin。宿主 Agent 通过 MCP 与 Beav 内部 Agent 通信；浏览器 UI 只供用户查看结果、审批和手动编辑。