---
title: "快速入门"
description: "安装 CLI、运行会话，并合并你的第一个变更请求。"
---

本页面将带你从一个全新的终端开始，直到合并一个变更请求（CR）。
下面的每条命令都可以直接复制粘贴执行。

1. <a id="install-the-cli"></a>

    ### 安装 CLI

    运行安装脚本。它会为你的操作系统下载 `beeuni` 二进制文件。

    ```sh
    curl -fsSL https://beeuni.ai/install | bash
    ```

    Beeuni 支持 macOS 和 Linux。目前还没有 Windows 二进制文件。

2. **登录**

    ```sh
    beeuni login
    ```

    这会打开浏览器供你登录。登录后，`beeuni login` 会为你选择账户和默认的 [项目](/docs/zh/project)。

3. <a id="create-or-clone-a-project"></a>

    ### 创建或克隆项目

    新账户还没有项目，因此 `beeuni login` 没有可供选择的项目。运行带名称的 `beeuni init`，创建你的第一个项目。该命令会在你的计算机上生成项目目录。

    ```sh
    beeuni init my-app
    cd my-app
    beeuni ship
    ```

    `beeuni ship` 首次运行时会在 Beeuni Cloud 中创建项目，然后推送你的代码。之后可随时再次运行 `beeuni ship`，同步本地更改。

    如果要处理 Beeuni Cloud 中已经存在的项目，请改为克隆它：

    ```sh
    beeuni projects clone <project-id>
    ```

    使用 `beeuni projects ls` 查找 `<project-id>`。

4. **运行会话**

    ```sh
    beeuni sessions new --prompt "Build the login page"
    ```

    这会启动一个[会话](/docs/zh/work/sessions)。智能体会在自己的沙盒和分支中工作，因此你的项目暂时不会受到影响。

    连接到会话以查看进度并回复：

    ```sh
    beeuni sessions chat
    ```

5. **审查并合并变更请求**

    智能体完成工作后，会提交一个变更请求，其中包含摘要和准确的差异内容。

    ```sh
    beeuni cr ls
    ```

    这会列出项目中处于打开状态的 CR。审查智能体提交的 CR，然后将其合并，使工作进入默认分支：

    ```sh
    beeuni cr merge 1
    ```

    将 `1` 替换为 `beeuni cr ls` 中的 CR 编号。在你合并之前，任何内容都不会进入项目的默认分支。

<a id="next-steps"></a>

## 后续步骤

<CardGroup>
  <Card icon="route" title="了解各部分如何协作" href="/docs/zh/work">
    解释项目、会话和变更请求。
  </Card>
  <Card icon="terminal" title="CLI 命令参考" href="/docs/zh/cli">
    介绍每条命令、标志和子命令。
  </Card>
  <Card icon="terminal" title="CLI 开发循环" href="/docs/zh/cli">
    从终端关联代码仓库、交付代码并管理会话。
  </Card>
</CardGroup>
