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

# 安裝

> 下載並安裝 BRICKS CLI

BRICKS CLI 以原生單一執行檔的形式發行，支援 macOS、Linux 與 Windows，無須 Node.js 執行環境。您也可以選擇從 npm 或 Bun 安裝。

## 安裝

<Tabs>
  <Tab title="macOS">
    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh
    ```

    指令碼會偵測您的架構（Apple Silicon 或 Intel），將原生執行檔下載至 `~/.local/bin/bricks`，並設定可執行權限。

    若 `~/.local/bin` 不在您的 `PATH` 內，請在 shell 設定檔加入下列這行：

    ```bash theme={null}
    export PATH="$HOME/.local/bin:$PATH"
    ```
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh
    ```

    指令碼會偵測您的架構（x86\_64 或 ARM64）與 C 函式庫（glibc 或 musl），將原生執行檔下載至 `~/.local/bin/bricks`，並設定可執行權限。

    若 `~/.local/bin` 不在您的 `PATH` 內，請在 shell 設定檔加入下列這行：

    ```bash theme={null}
    export PATH="$HOME/.local/bin:$PATH"
    ```
  </Tab>

  <Tab title="Windows">
    在 PowerShell 執行：

    ```powershell theme={null}
    irm https://cdn.bricks.tools/bricks-cli/release/install.ps1 | iex
    ```

    指令碼會偵測您的架構（x64 或 ARM64），並將 `bricks.exe` 安裝至 `%LOCALAPPDATA%\Programs\bricks-cli\bin\`。

    若安裝目錄不在使用者 `PATH` 內，指令碼會印出加入 `PATH` 的指令。您也可從**設定** > **系統** > **關於** > **進階系統設定** > **環境變數**手動加入。
  </Tab>

  <Tab title="npm / Bun">
    CLI 也已發佈至 npm。此方式需要 **Node.js 22+** 或 **Bun**。

    ```bash theme={null}
    # npm
    npm install -g @fugood/bricks-cli

    # Bun
    bun add -g @fugood/bricks-cli
    ```
  </Tab>
</Tabs>

## 確認安裝

```bash theme={null}
bricks --version
```

若提示找不到指令，請確認安裝目錄已加入 `PATH`，並重新啟動終端機。

## Beta 通道

可與穩定版並存安裝 beta 通道。Beta 執行檔名為 `bricks-beta`，因此兩個通道可同時存在。

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-cli/beta/install.sh | sh -s -- --beta
    ```

    以下列指令執行：

    ```bash theme={null}
    bricks-beta --version
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    irm https://cdn.bricks.tools/bricks-cli/beta/install.ps1 -OutFile install-beta.ps1
    .\install-beta.ps1 -Beta
    ```

    以下列指令執行：

    ```powershell theme={null}
    bricks-beta --version
    ```
  </Tab>
</Tabs>

## 更新

執行 `bricks update-cli` 即可就地更新現有安裝。指令會自動偵測 CLI 的安裝方式（npm、Bun 或單一執行檔），並執行對應的更新指令。詳見指令參考中的 [`bricks update-cli`](/zh-Hant/cli/commands#bricks-update-cli)。

```bash theme={null}
bricks update-cli         # 更新前先詢問
bricks update-cli -y      # 非互動式
```

## 解除安裝

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    # 穩定版
    curl -fsSL https://cdn.bricks.tools/bricks-cli/release/uninstall.sh | sh

    # Beta
    curl -fsSL https://cdn.bricks.tools/bricks-cli/beta/uninstall.sh | sh -s -- --beta
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    # 穩定版
    irm https://cdn.bricks.tools/bricks-cli/release/uninstall.ps1 | iex

    # Beta
    irm https://cdn.bricks.tools/bricks-cli/beta/uninstall.ps1 -OutFile uninstall-beta.ps1
    .\uninstall-beta.ps1 -Beta
    ```
  </Tab>

  <Tab title="npm / Bun">
    ```bash theme={null}
    # npm
    npm uninstall -g @fugood/bricks-cli

    # Bun
    bun remove -g @fugood/bricks-cli
    ```
  </Tab>
</Tabs>

## 下一步

<CardGroup cols={2}>
  <Card title="驗證" icon="key" href="/zh-Hant/cli/authentication">
    使用通行碼登入並管理工作區設定檔。
  </Card>

  <Card title="指令參考" icon="book" href="/zh-Hant/cli/commands">
    每個 CLI 指令與選項的完整參考。
  </Card>
</CardGroup>