初期セットアップ

必要なツールをインストールし、開発環境を確認する。

前提条件チェックリスト

Vibe codingを始める前に、以下のツールがインストールされていることを確認してください：

ツール	目的	必須
Claude Desktop	Anthropicのデスクトップアプリ	✅ Yes
Homebrew	macOS用パッケージマネージャー	✅ Yes (Mac)
Node.js	JavaScriptランタイム	✅ Yes
pnpm	高速パッケージマネージャー	✅ Yes
Git	バージョン管理	✅ Yes
Git LFS	Git用大容量ファイルストレージ	✅ Yes
GitHub CLI (gh)	ターミナルからPRを作成	✅ Yes

インストールの確認

すでにいくつかのツールをインストール済みですか？必要なものを確認しましょう：

Claudeにセットアップを確認してもらう

Claudeプロンプト

私のマシンに必要な開発ツールがすべてインストールされているか確認してください： - Homebrew - Node.js (v20+) - pnpm - Git - Git LFS (git-lfs) - GitHub CLI (gh) 各ツールのバージョンを表示してください。

または自分で実行bash

# すべてのバージョンを確認
echo "Homebrew: $(brew --version | head -1)"
echo "Node.js: $(node --version)"
echo "pnpm: $(pnpm --version)"
echo "Git: $(git --version)"
echo "Git LFS: $(git lfs version)"
echo "GitHub CLI: $(gh --version | head -1)"

期待される出力

各ツールのバージョン番号が表示されるはずです：

期待される出力text

Homebrew: Homebrew 4.x.x
Node.js: v20.x.x
pnpm: 9.x.x
Git: git version 2.x.x
Git LFS: git-lfs/3.x.x (GitHub; darwin arm64; go 1.x.x)
GitHub CLI: gh version 2.x.x

いずれかのツールで「command not found」と表示された場合は、以下のインストールガイドに従ってください。

インストールガイド (macOS)

1. Claude Desktopアプリのインストール

Claude DesktopはAnthropicのデスクトップアプリです。claude.com/download からダウンロードしてインストールし、アプリを開いてアカウントでサインインしてください。

2. Homebrewのインストール

HomebrewはmacOS用のパッケージマネージャーです。ターミナルを開いて実行：

Homebrewのインストールbash

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

インストール後、指示に従ってHomebrewをPATHに追加してください。

3. Node.jsのインストール

Node.jsバージョン20以降を推奨します：

Homebrew経由でNode.jsをインストールbash

brew install node@20

# または最新のLTSバージョンをインストール
brew install node

4. pnpmのインストール

pnpmはモノレポ用のパッケージマネージャーです。グローバルnpmパッケージにはsudoが必要です：

pnpmのインストールbash

sudo npm install -g pnpm

なぜsudoが必要？ グローバルnpmパッケージは管理者権限が必要なシステムディレクトリにインストールされます。pnpmのような信頼できるパッケージには安全です。

5. Gitのインストール

Gitは通常macOSにプリインストールされていますが、更新できます：

Gitのインストール/更新bash

brew install git

6. GitHub CLIのインストール

GitHub CLI (gh) を使うとClaudeが直接Pull Requestを作成できます：

GitHub CLIのインストールbash

brew install gh

# GitHubアカウントで認証
gh auth login

gh auth loginを実行する際は以下を選択：

GitHub.com
HTTPS
ウェブブラウザで認証

7. Git LFSのインストール

Git LFS（Large File Storage）はリポジトリ内の大容量バイナリファイルを扱うために必要です：

Git LFSのインストールbash

brew install git-lfs

# ユーザーアカウントでGit LFSを初期化
git lfs install

git lfs installを実行後、以下が表示されるはずです：

期待される出力text

Git LFS initialized.

リポジトリのクローン

すべてのツールがインストールされたら、リポジトリをクローンします：

Claudeにリポジトリをクローンしてもらう

Claudeプロンプト

https://github.com/CoworkingKitchen/vibe-coding-platform-foundation-foundation-foundation-foundation からvibe-coding-platformリポジトリをクローンして、依存関係をインストールしてください。

または自分で実行bash

# リポジトリをクローン
git clone [email protected]:CoworkingKitchen/vibe-coding-platform-foundation-foundation.git

# ディレクトリに移動
cd vibe-coding-platform

# すべての依存関係をインストール
pnpm install

セットアップクイズ

Quiz

このモノレポで依存関係をインストールするにはどのコマンドを使うべきですか？

npm installyarn installpnpm installbun install

トラブルシューティング

"command not found: brew"

HomebrewをPATHに追加してください。Apple Siliconの場合：

HomebrewをPATHに追加bash

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

インストール後に "gh: command not found"

ターミナルを再起動するか、以下を実行：

シェル設定を再読み込みbash

source ~/.zshrc

npmグローバルインストールで "Permission denied" エラー

グローバルnpmパッケージのインストールにはsudoを使用してください：

sudoでインストールbash

sudo npm install -g pnpm

次のステップ

セットアップが完了したら、ワークフローに進んで最初のコントリビューションを始めましょう。