セットアップ（Mac）
Claude デスクトップアプリを入れて、残りの準備は Claude に任せます。最初に一度だけ行います。
Windows をお使いの方は セットアップ（Windows） をご覧ください。
管理者から受け取っておくもの
始める前に、次の2つが必要です。
- Claude のアカウント — Claude Code を使えるプランのもの
- GitHub のアカウント — このプラットフォームのリポジトリ（アプリのコードの保管場所）に招待されているもの
まだ受け取っていないとき
管理者に「Claude Code を使えるアカウント」と「GitHub のリポジトリへの招待」を依頼します。GitHub のアカウントをすでに持っている場合は、そのユーザー名を管理者に伝えます。
ステップ1：Claude デスクトップアプリを入れる
- claude.com/download を開き、Mac 用のアプリをダウンロードします。
- ダウンロードしたファイルを開き、Claude を「アプリケーション」フォルダに移動します。
- Claude を起動し、受け取ったアカウントでログインします。
ステップ2：Code タブで作業用のフォルダを選ぶ
- アプリ上部の Code タブを開きます。ここが Claude Code です。
- Local を選びます。あなたの Mac の中のファイルを、Claude が扱えるようになります。
- Select folder で、ホームフォルダを選びます。ホームフォルダは、家のアイコンが付いた、あなたの名前のフォルダです。フォルダを選ぶ画面で
Command + Shift + Hを押すと開きます。
「書類」や「デスクトップ」は選ばない
「書類」と「デスクトップ」は、iCloud と同期されていることがあります。その中にプロジェクトを置くと、動作が不安定になることがあります。
ステップ3：必要な準備を、まとめて Claude に頼む
必要なものの確認とインストール、GitHub へのログイン、プロジェクトの取得までを、1回の依頼で済ませます。次の依頼文をコピーして、Claude Code に貼り付けて送信します。分からない言葉があっても、そのまま貼り付けて大丈夫です。
準備をまとめて頼む
Claudeプロンプトこの Mac で、開発の準備を最後まで済ませたいです。私はプログラミングの経験がありません。次の順番で進めてください。
1. 次のものが入っているか確認し、足りないものだけを入れてください：Git、Git LFS、GitHub CLI（gh）、Node.js（バージョン 20 以上の LTS 版）、pnpm。Git LFS は、クローンする前に使える状態にしてください
2. GitHub CLI で GitHub にログインできているか確認し、まだならログインを手伝ってください。ログインは HTTPS とブラウザを使う方法でお願いします
3. Git に、コミットに使う名前とメールアドレスが設定されているか確認してください。設定されていない項目は、私に尋ねずに、いま GitHub にログインしているアカウントの情報から設定してください。名前は GitHub のプロフィールの名前、無ければユーザー名にします。メールアドレスは、GitHub が用意する非公開用のアドレス（ID+ユーザー名@users.noreply.github.com）にします。設定は、このパソコン全体に効く形で行ってください。すでに設定されている項目は変えないでください
4. https://github.com/algoritmi-tech/brain-vibe-coding-platform を、今開いているフォルダの中にクローンしてください
5. pnpm のバージョンを、クローンしたフォルダのルートにある package.json の packageManager に合わせてください
6. クローンしたフォルダのルートで、依存関係をインストールしてください。アプリを手元で起動する必要はありません
7. 最後に、準備が整ったかどうかと、クローンしてできたフォルダの場所を教えてください
何かを入れる前に、何をなぜ入れるのかを一言で説明してください。パスワードの入力やブラウザでの操作など、私にしかできない作業が必要なときは、手順をひとつずつ教えてください。
Claude が作業を進めるあいだ、次のような操作を頼まれることがあります。
| 頼まれること | どうするか |
|---|---|
| 「実行してよいですか」という確認 | 内容を読み、準備のための操作であれば許可します。迷ったら「これは何をする操作ですか」と聞きます |
| 「コマンドライン・デベロッパツール」のインストール画面 | 「インストール」を押し、終わるまで待ちます。数分から十数分かかります |
| GitHub へのログイン | ブラウザが開きます。Claude が表示する英数字のコードを入力し、許可のボタンを押します |
| Mac のパスワードの入力 | Claude が案内する画面で、自分で入力します。パスワードを Claude との会話に書いてはいけません |
| ターミナルへの貼り付け | 「ターミナル」というアプリを開いて、1行を貼り付けるよう頼まれることがあります。Claude の説明どおりに進めます |
| Claude を起動し直すこと | Claude をいったん終了して起動し直し、同じ会話に戻って「続けてください」と送ります |
インストールには時間がかかることがあります。Claude が「準備が整いました」と答え、フォルダの場所を教えてくれたら、次のステップに進みます。
ステップ4：プロジェクトのフォルダを開き直す
Claude が教えてくれた brain-vibe-coding-platform というフォルダが、プロジェクトのフォルダです。
- Code タブで、新しい会話を始めます。
- Select folder で
brain-vibe-coding-platformフォルダを選びます。
これ以降は、いつもこのフォルダを選ぶ
このフォルダには、Claude がこのプラットフォームの決まりに沿って作業するための手引きが入っています。別のフォルダを選んだまま頼むと、Claude は決まりを知らないまま作業してしまいます。
これで、セットアップは完了です。
うまくいかないとき
| 起きたこと | どうするか |
|---|---|
| Code タブが見つからない、使えない | アカウントのプランで Claude Code を使えるかを、管理者に確認します |
| Claude の作業が途中で止まった | 「続けてください」と送ります |
| GitHub にログインできない、リポジトリが見つからないと言われる | リポジトリへの招待が済んでいるかを、管理者に確認します。招待のメールが届いていたら、承認します |
| 何が起きているのか分からない | 「いま何をしているのか、専門用語を使わずに説明してください」と送ります |
クイズ
Quiz
セットアップが終わったあと、Claude に作業を頼むときは、どのフォルダを選んだ状態にしますか？
次のステップ
基本の流れ に進みます。