> ## 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.

# インストール

> CTORをダウンロードしてインストールする

## 要件

CTOR は、プロジェクトの実行、依存関係のインストール、ワークスペースとの通信のためにいくつかのコマンドラインツールに依存しています：

| ツール                        | 最低バージョン | 状態 | 用途                                       |
| -------------------------- | ------- | -- | ---------------------------------------- |
| [BRICKS CLI](/ja/cli)      | 2.24.0  | 必須 | BRICKS ワークスペースと連携するエージェントワークフロー          |
| [Bun](https://bun.sh)      | 1.3.0   | 必須 | 依存関係のインストールとスクリプト実行のための JavaScript ランタイム |
| [Git](https://git-scm.com) | —       | 推奨 | プロジェクト履歴のバージョン管理                         |

ログインするには [BRICKS](https://bricks.tools) ワークスペースアカウントも必要です。

### 要件画面

CTOR を初めて起動したとき、または BRICKS CLI や Bun が未インストールまたは古いバージョンの場合、ログイン画面の前に**セットアップ要件**画面が表示されます。各ツールには、検出されたバージョン、必要な最低バージョン、操作ボタンを備えたカードが用意されています：

* **インストール** — 公式の curl ベースのインストーラーをバックグラウンドで実行し、展開可能なログに出力をストリーミングします。BRICKS CLI は `~/.bricks-cli/bin` に、Bun は `~/.bun/bin` にインストールされます。インストーラーが終了すると CTOR が自動的に再チェックします。
* **更新** — ツールがインストール済みでも最低バージョンを下回る場合に表示されます。インストーラーを再実行して最新リリースを取得します。
* **スキップ** — 任意の Git でのみ利用できます。**スキップ**をクリックすると、インストールせずに Git カードを閉じます。
* **ドキュメントを開く** — 自動インストールがまだサポートされていない Windows で表示されます。アップストリームのインストーラーページを開きます。

手動インストール後は**再チェック**をクリックして再検出し、必要なすべてのツールが満たされたら**続ける**を押してください。

<Info>
  検出は `which` にフォールバックする前に `~/.bricks-cli/bin`、`~/.bun/bin`、npm グローバルプレフィックスを直接探査するため、シェルの PATH が更新されていなくても、新しくインストールされたバイナリを認識します。
</Info>

### 手動インストール

ターミナルからセットアップしたい場合は、同じインストーラーをワンライナーで利用できます：

```bash theme={null}
# BRICKS CLI → ~/.bricks-cli/bin/bricks
curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh

# Bun → ~/.bun/bin/bun
curl -fsSL https://bun.sh/install | bash
```

macOS では `xcode-select --install` を実行して Command Line Tools 経由で Git をインストールしてください。Linux ではパッケージマネージャー（例: `apt install git`）を使用してください。Windows では [git-scm.com](https://git-scm.com/downloads) から Git をダウンロードしてください。

## ダウンロード

<Tabs>
  <Tab title="macOS">
    **Homebrew：**

    ```bash theme={null}
    brew install --cask mybigday/bricks/bricks-ctor
    ```

    **手動ダウンロード：**

    macOS（Apple Silicon）向けの最新ビルドをダウンロードしてください：

    <Card title="macOS用をダウンロード（ARM64）" icon="apple" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-arm64.dmg">
      CTOR-arm64.dmg
    </Card>

    DMGを開き、アプリをアプリケーションフォルダーにドラッグしてください。アプリはAppleにより公証されています。初回起動時にmacOSがセキュリティプロンプトを表示することがあります。**開く**をクリックして続行してください。
  </Tab>

  <Tab title="Linux">
    **クイックインストール：**

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/release/install.sh | sh
    ```

    スクリプトはアーキテクチャを自動検出し、AppImage を `~/.local/bin/bricks-ctor` にダウンロードし、`libfuse2` ランタイム依存関係が無い場合はシステムのパッケージマネージャー経由で導入し、オプションでデスクトップエントリを作成します。

    アンインストールするには：

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/release/uninstall.sh | sh
    ```

    **手動ダウンロード：**

    <CardGroup cols={2}>
      <Card title="Linux (x86_64)" icon="linux" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-x86_64.AppImage">
        CTOR-x86\_64.AppImage
      </Card>

      <Card title="Linux (ARM64)" icon="linux" href="https://cdn.bricks.tools/bricks-project-desktop/release/CTOR-arm64.AppImage">
        CTOR-arm64.AppImage
      </Card>
    </CardGroup>

    ```bash theme={null}
    chmod +x CTOR-x86_64.AppImage
    ./CTOR-x86_64.AppImage
    ```

    <Note>
      AppImage の実行には `libfuse2`（FUSE 2）が必要です。最近のディストリビューションでは標準で同梱されていないことが多くあります。クイックインストールスクリプトは自動で導入しますが、手動ダウンロードの場合は自分でインストールしてください：

      | ディストリビューション              | コマンド                           |
      | ------------------------ | ------------------------------ |
      | Debian / Ubuntu（≤ 22.04） | `sudo apt install libfuse2`    |
      | Ubuntu 24.04+            | `sudo apt install libfuse2t64` |
      | Fedora / RHEL            | `sudo dnf install fuse-libs`   |
      | Arch                     | `sudo pacman -S fuse2`         |
      | openSUSE                 | `sudo zypper install libfuse2` |
      | Alpine                   | `sudo apk add fuse`            |
    </Note>
  </Tab>
</Tabs>

## ベータチャンネル

安定版と並行してベータチャンネルをインストールできます。ベータ版アプリは **CTOR Beta** という名称で、Linux のバイナリは `bricks-ctor-beta` であるため、両チャンネルを共存させられます。

<Tabs>
  <Tab title="macOS">
    **Homebrew：**

    ```bash theme={null}
    brew install --cask mybigday/bricks/bricks-ctor-beta
    ```

    **手動ダウンロード：**

    <Card title="CTOR Beta for macOS（ARM64）をダウンロード" icon="apple" href="https://cdn.bricks.tools/bricks-project-desktop/beta/CTOR-Beta-arm64.dmg">
      CTOR-Beta-arm64.dmg
    </Card>

    DMG を開き、**CTOR Beta** をアプリケーションフォルダーにドラッグしてください。
  </Tab>

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

    スクリプトは AppImage を `~/.local/bin/bricks-ctor-beta` にインストールします。次のコマンドで実行できます：

    ```bash theme={null}
    bricks-ctor-beta
    ```

    アンインストールするには：

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-project-desktop/beta/uninstall.sh | sh -s -- --beta
    ```
  </Tab>
</Tabs>

## 自動アップデート

CTORは自動的にアップデートを確認します。新しいバージョンが利用可能になると：

1. **設定**（歯車アイコン）を開く
2. **アップデート**セクションまでスクロール
3. **ダウンロードしてインストール**をクリックしてその場で更新する

アプリは設定パネルに現在のバージョンと最新の利用可能バージョンを表示します。

## 次のステップ

<Card title="ワークスペースにログイン" icon="right-to-bracket" href="/ja/ctor/guide/authentication">
  BRICKSワークスペースで認証してビルドを開始しましょう。
</Card>