Apple Silicon Mac／macOS 14 以降向けの一本道セットアップ。30〜60 分で「git push できる状態」まで仕上げる。

新しい Mac は 30〜60 分で実際の開発ができる状態にできる。このガイドは Apple Silicon＋macOS 14（Sonoma）以降 を対象とし、「ターミナルを開いて git push」できる状態を目標とする——それ以上は扱わない。

生産性ツール（Raycast/Rectangle）、エディター、言語ランタイムは別のガイドで説明する。ここでは動くターミナルを手に入れるために必要なものだけをインストールする。

TL;DR

macOS システム設定 5 つ（キーリピート、トラックパッド、Finder、Dock、スクリーンショット）
Xcode Command Line Tools → Homebrew → 必須 CLI 7 本（brew 1 行）
Git グローバル設定＋SSH キー（ed25519）→ GitHub に登録 → gh auth login

自動化スクリプト（任意）

手順を 1 つずつ手動で踏むより 1 本のスクリプトを実行したい場合は — 必ず ダウンロード → SHA-256 確認 → 内容確認 → 実行 の順で。

setup-mac.sh

# 1. ダウンロード
curl -fsSL https://devalice.jaceclub.com/assets/mac/initial-setup/setup-mac.sh -o setup-mac.sh
 
# 2. SHA-256 を確認
shasum -a 256 setup-mac.sh
# 期待値: d6b501f8fa1986d980c70525d1d4476bef444bc0dd2c62fb13f2e5a9128c63cf
 
# 3. 内容を確認
less setup-mac.sh
 
# 4. 実行
bash setup-mac.sh

スクリプトは冪等——途中で失敗しても再実行できる。最初の 6 セクションを自動化する。GitHub への SSH キー登録と gh auth login はブラウザでの手動操作が必要。

各ステップを理解したい場合は、以下の手動セクションを読み進めること。

前提条件

macOS 14（Sonoma）以降 — macOS 12（Monterey）以前は一部の最新 Homebrew パッケージで問題が起きる
Apple Silicon（M1〜M4）推奨 — Intel Mac でも動くが、Homebrew のプレフィックスが異なる（/opt/homebrew vs /usr/local）。インライン注記あり。
管理者アカウント（sudo 使用可能）
インターネット接続＋Apple ID サインイン済み

Intel Mac ユーザー: Homebrew のプレフィックスが /usr/local であることだけ覚えておけば、それ以外はこのガイドがそのまま適用できる。

1. macOS システム設定 — 5 分

System Settings またはターミナルコマンドで適用する。一度設定すれば毎日効いてくる。

1.1 キーリピート — 最も効果の大きい変更

デフォルトは遅すぎる。最大まで上げる。

# Key Repeat（最初のリピート後のレート）— スライダーの最大より速い
defaults write -g KeyRepeat -int 1
# Initial Key Repeat（最初のリピートまでの遅延）— スライダーの最小より短い
defaults write -g InitialKeyRepeat -int 10

有効にするにはログアウトして戻ること。（再起動でも OK。）

1.2 トラックパッド — タップでクリック＋3 本指ドラッグ

# タップでクリックを有効化
defaults write com.apple.AppleMultitouchTrackpad Clicking -bool true
defaults -currentHost write -g com.apple.mouse.tapBehavior -int 1

3 本指ドラッグは GUI のみ: System Settings → アクセシビリティ → ポインタコントロール → トラックパッドオプション → 「トラックパッドでドラッグする」→「3 本指ドラッグ」を選択。

1.3 Finder — 隠しファイル・フルパス・拡張子を表示

defaults write com.apple.finder AppleShowAllFiles -bool true
defaults write com.apple.finder _FXShowPosixPathInTitle -bool true
defaults write -g AppleShowAllExtensions -bool true
killall Finder

1.4 Dock — 自動非表示、アニメーション短縮

画面スペースを確保し、Dock をすばやく表示する。

defaults write com.apple.dock autohide -bool true
defaults write com.apple.dock autohide-delay -float 0
defaults write com.apple.dock autohide-time-modifier -float 0.15
killall Dock

1.5 スクリーンショット — 保存先を変更

デフォルトはデスクトップに保存されるため、すぐ散らかる。保存先を変える。

mkdir -p ~/Pictures/Screenshots
defaults write com.apple.screencapture location ~/Pictures/Screenshots
defaults write com.apple.screencapture type png
killall SystemUIServer

2. Xcode Command Line Tools — 5 分

Homebrew、Git、コンパイラはすべてこれに依存する。

xcode-select --install

GUI ダイアログが表示される → 「インストール」 → ライセンスに同意 → 待つ（約 5 分・約 100MB）。

確認

xcode-select -p
# /Library/Developer/CommandLineTools  ← 期待値

フル Xcode.app がある場合は /Applications/Xcode.app/Contents/Developer と表示される — これも問題ない。

3. Homebrew＋必須 CLI — 10 分

3.1 Homebrew をインストール

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

インストール後、インストーラーが PATH の設定手順を表示する。Apple Silicon の場合 — ~/.zprofile に次の 2 行を追加する：

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

⚠️ Intel Mac: /opt/homebrew の代わりに /usr/local を使う。インストーラーが表示する指示に従えば正確に設定できる。

確認

brew --version
# Homebrew 4.x.x
brew doctor
# Your system is ready to brew.

3.2 必須 CLI 7 本を 1 行で

毎日使う 7 本のツール：

brew install git gh mise jq ripgrep fzf eza

ツール	用途
`git`	Apple バンドルの git より新しい。現代の LFS・プラグインに対応
`gh`	GitHub CLI（PR、リポジトリクローン、認証）
`mise`	ポリグロットランタイムマネージャー（asdf の後継）— Node、Python、Ruby など
`jq`	CLI からの JSON パース・変換
`ripgrep`	`.gitignore` を尊重する高速 `grep` 代替（`rg`）
`fzf`	インタラクティブなファジーファインダー（シェル履歴検索の `Ctrl+R`）
`eza`	git 状態とツリービューを持つモダンな `ls` 代替（`exa` の後継）

fzf シェル統合（任意）

Ctrl+R 履歴検索を有効化：

$(brew --prefix)/opt/fzf/install --all

4. Git 設定＋SSH キー — 10 分

4.1 Git グローバル設定

GitHub アカウントに登録しているメールアドレスを使うこと。

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global core.editor "code --wait"  # VS Code を使う場合

code --wait は VS Code がインストールされていることが必要。まだない場合は今はスキップ。

4.2 SSH キー — ed25519 を推奨

RSA 4096 より短く安全。

ssh-keygen -t ed25519 -C "you@example.com"
# 保存先: [Enter]（デフォルトの ~/.ssh/id_ed25519 を使用）
# パスフレーズ: [任意だが推奨]

ssh-agent と macOS Keychain に登録する：

eval "$(ssh-agent -s)"
 
cat <<'EOF' >> ~/.ssh/config
Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519
EOF
 
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

4.3 GitHub に公開鍵を追加＋認証

公開鍵をクリップボードにコピー：

pbcopy < ~/.ssh/id_ed25519.pub

ブラウザで https://github.com/settings/ssh/new を開く → タイトル: 「Mac（モデル名）」 → キー欄にペースト → 「SSH キーを追加」 をクリック。

HTTPS 操作（PR 作成など）のために gh CLI を認証する：

gh auth login
# GitHub.com → HTTPS → Y（GitHub 認証情報で Git を認証）→ ブラウザでログイン

ブラウザが自動的に開き、ワンタイムコードが表示される。コードを入力して承認する。

5. 確認 — すべて正しくインストールされたか

ワンショットチェック：

echo "--- バージョン ---"
sw_vers | head -2
brew --version | head -1
git --version
gh --version | head -1
mise --version
echo "--- GitHub 認証 ---"
ssh -T git@github.com 2>&1 | head -1
gh auth status 2>&1 | head -3

期待される出力：

--- バージョン ---
ProductName: macOS
ProductVersion: 14.5
Homebrew 4.x.x
git version 2.46.x
gh version 2.x.x
mise 2026.x.x
--- GitHub 認証 ---
Hi <your-username>! You've successfully authenticated, but GitHub does not provide shell access.
github.com
  ✓ Logged in to github.com account <your-username>

すべて正常に表示されたら完了。git clone <repo> して作業を始められる。

6. トラブルシューティング

「command not found: brew」— PATH が読み込まれていない

~/.zprofile に eval "$(/opt/homebrew/bin/brew shellenv)" が含まれているか確認。新しいターミナルを開いて再試行。

「xcrun: error: invalid active developer path」

Command Line Tools が壊れている。再インストール：

sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

Homebrew インストールで「Permission denied」

/opt/homebrew または /usr/local のパーミッション問題。インストーラーが提示した chown コマンドをそのまま実行する。

SSH「Permission denied (publickey)」

ssh-add -l                              # キーがエージェントにあるか確認
ssh -vT git@github.com 2>&1 | tail -20  # 詳細な出力

キーがない場合は ssh-add --apple-use-keychain ~/.ssh/id_ed25519 を再実行。それでも失敗する場合は、キーが GitHub に登録されているか確認。

`git push` でパスワードを求められ続ける

HTTPS でクローンしている。リモートを SSH に切り替える：

git remote set-url origin git@github.com:<user>/<repo>.git

一部の Homebrew パッケージが Apple Silicon で失敗する

一部の古いパッケージは Rosetta 2 でのみ動作する：

softwareupdate --install-rosetta --agree-to-license
arch -x86_64 brew install <package>

次のステップ

このガイドは「ターミナルが動く」ところで止まる。この後は：

開発ツール: エディター、ランタイム（Node・Python・Ruby）— /mac/dev-toolchain
生産性ツール: Raycast、Rectangle、Karabiner — /mac/productivity
AI エージェント環境: Claude Code、Cursor — /ai-agents/claude-code
自動化スクリプト はこのページの上部のセクションにある ✅

参考リンク

Homebrew 公式
GitHub SSH キー登録
mise 公式 — ランタイムバージョンマネージャー
gh CLI マニュアル

更新履歴

2026-05-12 — 初稿（devAlice M2 i18n シード）

Mac 開発者向け初期セットアップ — 開封後の最初の 1 時間