ラボ環境のセットアップ

co-consultやco-deckのようなマルチエージェントシステムを使用するには、いくつかの追加ツールが必要です。この章では、すべてを一度にインストールして動作を確認する手順を説明します。

事前チェックリスト

インストールを始める前に、以下の項目が準備できていることを確認してください。マルチエージェントハーネスを使用するためにすべて必須です。

必要なサブスクリプション

マルチエージェントハーネスはClaude Code上に構築されており、Claude Codeを使用するにはClaude ProまたはClaude Maxサブスクリプションが必要です。

システム要件

マルチエージェントハーネスを実行するには、コンピュータが以下の最小スペックを満たしている必要があります。

8 GBのRAMはClaude Desktop Appを追加ツール（Git、Bunなど）と一緒に実行するために必要な最小メモリです。複数のエージェントを同時に実行したり、ブラウザを開いたままにしたりする場合は、16 GB以上を推奨します。

10 GBのディスク容量はツールのインストールとプロジェクトファイルのためのスペースです。複数のプロジェクトで作業する場合は、時間とともにさらに容量が必要になる場合があります。

フォルダのセットアップ

インストール中に使用するスクリプトと設定ファイルを保存するための専用フォルダを作成します。このフォルダは今後のすべての実践演習の拠点として機能します。

フォルダの作成

オペレーティングシステムに合わせて以下のコマンドを実行してください。setupフォルダはGitプロジェクトを保存するディレクトリの下に作成します。

mkdir C:\git\project\setup

mkdir -p ~/git/project/setup

このフォルダには、これ以降インストール検証スクリプト、設定ファイル、プロジェクトテンプレートが保存されます。フォルダの場所はいつでも変更できますが、このハンドブックでは上記のパスを参照標準として使用します。

フォルダ構造

セットアップフォルダは以下の構造になります。現時点では空ですが、インストールを進めるにつれて各項目が設定されていきます。

MacOSインストール

MacOSでは、Homebrewを使うと必要なツールを簡単にインストールできます。HomebrewはMacOSで最も広く使われているオープンソースパッケージマネージャーです。

brew --version

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install git

brew install gh

brew install oven-sh/bun/bun

gh auth login

Windowsインストール

Windowsでは、各ツールを個別にインストールします。PowerShellまたはコマンドプロンプト（CMD）を使用して進めてください。

winget install --id Git.Git -e --source winget

winget install --id GitHub.cli -e --source winget

powershell -c "irm bun.sh/install.ps1 | iex"

gh auth login

Linuxインストール

Linux（Ubuntu/Debian系）では、aptパッケージマネージャと公式インストールスクリプトを使用します。

sudo apt update && sudo apt upgrade -y

sudo apt install -y git

(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
&& cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y

curl -fsSL https://bun.sh/install | bash

source ~/.bashrc

gh auth login

インストール検証

すべてのツールが正しくインストールされたことを確認しましょう。ターミナルを開き、以下のコマンドを順番に実行します。

バージョンチェック

各ツールがバージョン番号を表示することを確認してください。バージョン番号が表示されれば、インストールは成功しています。

git --version

期待される結果：git version 2.45.0（バージョン番号は異なる場合があります）

gh --version

期待される結果：gh version 2.62.0（バージョン番号は異なる場合があります）

bun --version

期待される結果：1.1.30（バージョン番号は異なる場合があります）

検証スクリプトの実行

セットアップフォルダの検証スクリプトは、すべてのツールのインストール状態を一度にチェックします。

git clone https://github.com/5throck/setup.git
cd setup
bun setup-common.ts       # インストール検証スクリプトを実行

検証スクリプトは、Git、GitHub CLI、Bunがインストールされているか、そのバージョンを表示し、GitHub認証ステータスを確認します。

検証結果の例

すべてのツールが正しくインストールされると、以下のような出力が表示されます：

トラブルシューティング

以下に最も一般的なインストール問題とその解決策を示します。何かがうまくいかない場合は、以下のリストから該当する問題を探してください。

Bunのインストール失敗：command not found: bun

原因：Bunはインストールされましたが、システムのPATHに追加されていない可能性があります。

解決策：

echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

$env:Path += ";$env:USERPROFILE\.bun\bin"

GitHub CLI認証エラー：gh auth statusが失敗

原因：GitHub CLIのブラウザ認証が完了しなかったか、認証トークンが期限切れです。

解決策：

gh auth logout
gh auth login

Claude Desktop Appの接続エラー

原因：インターネット接続の問題、Anthropicサーバーの障害、または認証トークンの期限切れです。

解決策：

Gitはインストール済みだがgitコマンドが認識されない

原因：Gitはインストールされましたが、そのパスがシステムPATHに追加されていません。

解決策：

echo $PATH

その他の問題