Mac 向け事前準備

「ターミナル」は Mac に標準で入っているコマンド操作用のアプリです。

開く方法（どれでも OK）:

1. Spotlight 検索（一番早い）: ⌘ + Space → 「ターミナル」と入力 → Enter
2. Launchpad から: Launchpad → 「その他」フォルダ → ターミナル
3. Finder から: アプリケーション → ユーティリティ → ターミナル

起動後の見た目:

ウィンドウが開き、ユーザー名@Macのホスト名 ~ % のような表示が出れば準備 OK（zsh の場合）。古い macOS では $ が出ることもありますが動作は同じです。

管理者権限が必要なとき: Windows と違い Mac には「管理者として起動」はありません。管理者権限が必要なコマンドを実行するとその都度パスワードを聞かれるので、ログイン時のパスワードを入力してください（入力中は画面に何も表示されませんが入力されています）。

ターミナルは「コマンドを入力 → Enter キーで実行 → 結果が返る」を繰り返すウィンドウです。

基本の流れ:

1. ... ~ % のあとにカーソルが点滅している
2. このページのコードブロック右上の コピーボタン でコマンドをコピー
3. ターミナルウィンドウ内で ⌘ + V で貼り付け
4. Enter キー を押して実行
5. 結果が表示され、また ... ~ % が出る（次のコマンドを待つ状態）

結果の読み方:

• 白文字・緑文字: 成功・情報
• 赤文字: エラー。最後の 1〜2 行に原因のヒントが書かれていることが多い
• 何も表示されずに次の行に戻った: 成功（コマンドによっては正常な挙動）

困ったとき:

• 実行中のコマンドを中断したい → Ctrl + C（⌘ + C ではありません。⌘ + C はコピー）
• ウィンドウを閉じたい → exit と入力して Enter、または ⌘ + W

sudo とパスワード入力: sudo で始まるコマンドはパスワードを聞かれます。入力中は 何も表示されません（セキュリティのため） が、実際は入力されているのでそのまま打ち切って Enter してください。

Mac 向けのパッケージマネージャー（Windows の winget、Linux の apt に相当）。コマンド一発で公式の配布元からアプリをダウンロード・インストールしてくれます。このあとの Node.js / Cursor / Obsidian もすべて Homebrew で入れます。

すでに入っているか確認:

brew --version

バージョンが表示されたらインストール済みなので、このカードはスキップして OK。command not found: brew と出たら次に進みます。

インストール — 公式手順 (https://brew.sh) のコマンドをそのまま実行:

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

実行中に 管理者パスワード を聞かれたらログインパスワードを入力（画面には表示されません）。

Apple Silicon（M1/M2/M3/M4）の場合の最後の一手間:

インストール完了時の出力末尾に「Run these three commands in your terminal…」と表示されるので、その 3 行をコピーしてターミナルに貼り付けて実行 してください（PATH を通す設定です）。Intel Mac の場合は不要です。

動作確認:

brew --version

バージョン番号が表示されれば OK。

ありがちな詰まりどころ:

• command not found: brew が出続ける → Apple Silicon で PATH 設定の 3 行を実行していない。ターミナルをいったん閉じて開き直してから再確認
• Xcode Command Line Tools のインストールを要求される → 指示通り「インストール」を選べば OK（次の Git + GitHub の項目で使うものと同じ）

Claude Code CLI を動かすランタイムです。Homebrew 経由で入れます。

インストール:

brew install node

動作確認 — ターミナルを いったん閉じて開き直してから:

node --version
npm --version

v22.x 以降・10.x 以降が表示されれば OK。

Homebrew を使わない場合:

1. https://nodejs.org/ja/download を開く
2. 「LTS」タブが選ばれていることを確認
3. 「macOS Installer (.pkg)」をダウンロード
4. .pkg をダブルクリックして画面の指示通りに進める

ありがちな詰まりどころ:

• node: command not found → ターミナルを閉じて開き直す
• Homebrew で古いバージョンが入った → brew upgrade node で更新

Anthropic の公式 CLI。Node.js を先に入れてから進めてください。

インストール:

npm install -g @anthropic-ai/claude-code

初回起動とサインイン:

1. ターミナルで claude と打って Enter
2. ブラウザが起動し、Anthropic アカウントのサインイン画面が表示される
3. サインインするとターミナル側に Claude Code のプロンプトが戻る

動作確認:

claude --version

バージョン番号が出れば OK。

ありがちな詰まりどころ:

• permission denied で npm install -g が失敗 → sudo npm install -g @anthropic-ai/claude-code でパスワードを入れて再実行
• サインイン画面のブラウザが自動で開かない → ターミナルに表示された URL をコピーして手動でブラウザに貼り付ける

Git はファイルの変更履歴を管理するツール。GitHub は Git リポジトリをリモートで保管・共有するサービスです。

Git のインストール — macOS では Xcode Command Line Tools に含まれています:

xcode-select --install

ダイアログが出たら「インストール」を選択。すでに入っている場合は xcode-select: error: command line tools are already installed と出ますが、その状態で問題ありません。

動作確認:

git --version

バージョンが表示されれば OK。

GitHub アカウント作成:

1. https://github.com/ を開く
2. 右上「Sign up」からメールアドレス・パスワード・ユーザー名を入力
3. 認証メールに届くコードを入力して完了

初回設定（コミット時の名前とメール）:

git config --global user.name "あなたの名前"
git config --global user.email "you@example.com"

ありがちな詰まりどころ:

• ユーザー名・メールは GitHub と合わせておくと後で楽（必須ではない）
• 認証メールが届かない → 迷惑メールフォルダを確認、数分待ってから再送信

VS Code ベースで AI 機能が同じウィンドウに統合されたエディタ。「AI に聞く → 解決 → 進む」が同じ画面で完結します。VS Code に慣れている方はそのままでも OK です。

Homebrew を使う場合:

brew install --cask cursor

Homebrew を使わない場合:

1. https://cursor.com/ を開く
2. 「Download for Mac」をクリックして .dmg をダウンロード
3. .dmg をダブルクリック → Cursor を「アプリケーション」フォルダにドラッグ
4. Launchpad または Spotlight から Cursor を起動

初回起動:

1. Cursor を起動（初回は「開発元が未確認」のダイアログが出るかもしれません。その場合はシステム設定 → プライバシーとセキュリティから「このまま開く」を選択）
2. サインイン画面が出たら GitHub アカウントなどでサインイン（無料プランで十分）
3. 「VS Code の拡張機能や設定をインポートしますか」と聞かれたら Skip で OK（後で変更可能）

VS Code と UI はほぼ同じなので、VS Code 経験者は違和感なく使えます。

第 2 の脳パートで使うメモ・ナレッジ管理アプリ。完全無料、アカウント登録不要です。

Homebrew を使う場合:

brew install --cask obsidian

Homebrew を使わない場合:

1. https://obsidian.md/download を開く
2. 「Download for Mac（Intel / Apple Silicon の該当する方）」から .dmg をダウンロード
3. .dmg をダブルクリック → Obsidian を「アプリケーション」フォルダにドラッグ

動作確認:

1. Launchpad または Spotlight から Obsidian を起動
2. 「新規 Vault を作成」または「Create new vault」の画面が出れば OK

Vault の作成は当日一緒に行うので、ここでは 起動して最初の画面が出るところまで で大丈夫です。