> ## 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` に含まれていない場合は、シェル設定ファイルに次の行を追加してください：

    ```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` に含まれていない場合は、シェル設定ファイルに次の行を追加してください：

    ```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` に含まれていることを確認し、ターミナルを再起動してください。

## ベータチャンネル

ベータチャンネルは安定版と並行してインストールできます。ベータ版のバイナリ名は `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`](/ja/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

    # ベータ版
    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

    # ベータ版
    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="/ja/cli/authentication">
    パスコードでログインし、ワークスペースのプロファイルを管理します。
  </Card>

  <Card title="コマンドリファレンス" icon="book" href="/ja/cli/commands">
    すべての CLI コマンドとオプションの完全リファレンス。
  </Card>
</CardGroup>