Mac-Ersteinrichtung für Entwickler — die erste Stunde nach dem Auspacken

Ein brandneuer Mac kann in 30 bis 60 Minuten für echte Entwicklungsarbeit bereit sein. Dieser Leitfaden richtet sich an Apple Silicon + macOS 14 (Sonoma) oder neuer und bringt dich bis zum Punkt „Terminal öffnen und git push" — nicht weiter.

Produktivitäts-Tools (Raycast/Rectangle), Editoren und Sprach-Laufzeiten werden in separaten Leitfäden behandelt. Hier installieren wir nur das Nötigste für ein funktionsfähiges Terminal.

TL;DR

1. Fünf macOS-Systemeinstellungen (Tastenwiederholung, Trackpad, Finder, Dock, Screenshots)
2. Xcode Command Line Tools → Homebrew → sieben essentielle CLI-Tools (eine brew-Zeile)
3. Git globals + SSH-Schlüssel (ed25519) → bei GitHub registrieren → gh auth login

Automatisierungsskript (optional)

Wenn du lieber ein einzelnes Skript ausführst als jeden Schritt manuell durchzugehen — immer herunterladen → SHA-256 verifizieren → prüfen → ausführen.

# 1. Herunterladen
curl -fsSL https://devalice.jaceclub.com/assets/mac/initial-setup/setup-mac.sh -o setup-mac.sh
 
# 2. SHA-256 verifizieren
shasum -a 256 setup-mac.sh
# erwartet: d6b501f8fa1986d980c70525d1d4476bef444bc0dd2c62fb13f2e5a9128c63cf
 
# 3. Prüfen
less setup-mac.sh
 
# 4. Ausführen
bash setup-mac.sh

Das Skript ist idempotent — es kann nach teilweiser Ausführung oder bei Fehlern bedenkenlos erneut gestartet werden. Es automatisiert die ersten sechs Abschnitte unten; die SSH-Schlüssel-Registrierung bei GitHub sowie gh auth login erfordern weiterhin manuelle Bestätigung im Browser.

Wenn du jeden Schritt nachvollziehen möchtest, gehe die manuellen Abschnitte unten durch.

Voraussetzungen

• macOS 14 (Sonoma) oder neuer — macOS 12 (Monterey) und früher funktionieren nicht mit einigen neueren Homebrew-Paketen
• Apple Silicon (M1–M4) empfohlen — Intel-Mac funktioniert, aber das Homebrew-Präfix unterscheidet sich (/opt/homebrew vs. /usr/local). Inline vermerkt.
• Administratorkonto (sudo verfügbar)
• Internetverbindung und angemeldete Apple ID

Intel-Mac-Nutzer: denk daran, dass dein Homebrew-Präfix /usr/local ist. Ansonsten gilt dieser Leitfaden unverändert.

1. macOS-Systemeinstellungen — 5 Minuten

Über Systemeinstellungen oder Terminal-Befehle anwenden. Einmalig einrichten — sie zahlen sich täglich aus.

1.1 Tastenwiederholung — die wichtigste Änderung

Die Standardwerte sind zu langsam und bremsen dein Tippen unbemerkt. Auf Maximum setzen.

# Tastenwiederholung (Rate nach der ersten Wiederholung) — schneller als der Schieberegler-Max
defaults write -g KeyRepeat -int 1
# Erste Tastenwiederholung (Verzögerung vor der ersten Wiederholung) — kürzer als das Schieberegler-Min
defaults write -g InitialKeyRepeat -int 10

Aus- und wieder einloggen, damit das wirksam wird. (Ein Neustart funktioniert auch.)

1.2 Trackpad — Tippen zum Klicken + Drei-Finger-Ziehen

# Tippen zum Klicken aktivieren
defaults write com.apple.AppleMultitouchTrackpad Clicking -bool true
defaults -currentHost write -g com.apple.mouse.tapBehavior -int 1

Drei-Finger-Ziehen nur über GUI: Systemeinstellungen → Bedienungshilfen → Zeigersteuerung → Trackpad-Optionen → „Trackpad zum Ziehen verwenden" → „Mit drei Fingern ziehen".

1.3 Finder — versteckte Dateien, vollständige Pfade, Erweiterungen anzeigen

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 — automatisch ausblenden, keine Animation

Bildschirmfläche zurückgewinnen und das Dock schneller erscheinen lassen.

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 Screenshots — Desktop sauber halten

Der Standardspeicherort ist der Desktop, der sich schnell unübersichtlich füllt. Verschieben.

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 Minuten

Homebrew, Git und Compiler hängen alle davon ab.

xcode-select --install

Ein GUI-Dialogfenster erscheint → Installieren → Lizenz akzeptieren → ~5 Minuten warten (~100 MB).

Verifizieren

xcode-select -p
# /Library/Developer/CommandLineTools  ← erwartet

Wenn du das vollständige Xcode.app hast, siehst du /Applications/Xcode.app/Contents/Developer — ebenfalls in Ordnung.

3. Homebrew + essentielle CLI — 10 Minuten

3.1 Homebrew installieren

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

Nach Abschluss gibt der Installer PATH-Anweisungen aus. Apple Silicon — diese zwei Zeilen zu ~/.zprofile hinzufügen:

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

⚠️ Intel-Mac: /usr/local statt /opt/homebrew verwenden. Die gedruckten Anweisungen des Installers sind für dein Gerät korrekt — ihnen folgen.

Verifizieren

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

3.2 Sieben essentielle CLIs in einer Zeile

Die Tools, die du täglich verwenden wirst:

brew install git gh mise jq ripgrep fzf eza

fzf Shell-Integration (optional)

Ctrl+R-Verlaufssuche aktivieren:

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

4. Git-Konfiguration + SSH-Schlüssel — 10 Minuten

4.1 Git globals

Dieselbe E-Mail-Adresse wie beim GitHub-Konto verwenden.

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"  # wenn du VS Code verwenden wirst

code --wait erfordert, dass VS Code installiert ist. Jetzt überspringen, wenn noch nicht vorhanden.

4.2 SSH-Schlüssel — ed25519 bevorzugen

Kürzer und sicherer als RSA 4096.

ssh-keygen -t ed25519 -C "you@example.com"
# Datei zum Speichern eingeben: [Enter] (Standard ~/.ssh/id_ed25519 verwenden)
# Passphrase eingeben: [optional, aber empfohlen]

Mit ssh-agent und macOS-Schlüsselbund registrieren:

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 Öffentlichen Schlüssel zu GitHub hinzufügen + authentifizieren

Öffentlichen Schlüssel in die Zwischenablage kopieren:

pbcopy < ~/.ssh/id_ed25519.pub

https://github.com/settings/ssh/new im Browser öffnen → Titel: „Mac (Modell)" → Schlüssel: einfügen → SSH-Schlüssel hinzufügen.

gh für HTTPS-Operationen (PR-Erstellung usw.) authentifizieren:

gh auth login
# GitHub.com → HTTPS → Y (Git mit GitHub-Anmeldedaten authentifizieren) → Im Webbrowser anmelden

Ein Browser öffnet sich mit einem Einmalcode. Eingeben, dann autorisieren.

5. Verifizieren — wurde alles korrekt installiert?

Einmaliger Check:

echo "--- Versionen ---"
sw_vers | head -2
brew --version | head -1
git --version
gh --version | head -1
mise --version
echo "--- GitHub-Auth ---"
ssh -T git@github.com 2>&1 | head -1
gh auth status 2>&1 | head -3

Erwartete Ausgabe:

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

Wenn alles korrekt ausgegeben wird, bist du fertig. Du kannst jetzt git clone <repo> ausführen und loslegen.

6. Problembehandlung

„command not found: brew" — PATH nicht geladen

Prüfen, ob ~/.zprofile den Eintrag eval "$(/opt/homebrew/bin/brew shellenv)" enthält. Ein neues Terminal öffnen und erneut versuchen.

„xcrun: error: invalid active developer path"

Command Line Tools sind beschädigt. Neu installieren:

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

Homebrew-Installation „Permission denied"

Berechtigungsfehler bei /opt/homebrew oder /usr/local. Den chown-Befehl ausführen, den der Installer wortwörtlich vorgeschlagen hat.

SSH „Permission denied (publickey)"

ssh-add -l                              # ist der Schlüssel im Agent?
ssh -vT git@github.com 2>&1 | tail -20  # ausführliche Ausgabe

Fehlt der Schlüssel, ssh-add --apple-use-keychain ~/.ssh/id_ed25519 erneut ausführen. Schlägt es weiterhin fehl, prüfen, ob der Schlüssel bei GitHub registriert ist.

git push fragt ständig nach einem Passwort

Du hast über HTTPS geklont. Remote auf SSH umstellen:

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

Einige Homebrew-Pakete schlagen auf Apple Silicon fehl

Einige alte Pakete laufen nur unter Rosetta 2:

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

Was kommt als nächstes

Dieser Leitfaden endete bei „Terminal funktioniert wirklich". Danach:

• Entwickler-Tooling: Editoren, Laufzeiten (Node·Python·Ruby) — /mac/dev-toolchain
• Produktivitäts-Tools: Raycast, Rectangle, Karabiner — /mac/productivity
• KI-Agent-Umgebung: Claude Code, Cursor — /ai-agents/claude-code
• Automatisierungsskript befindet sich oben auf dieser Seite ✅

Referenzen

• Homebrew offiziell
• GitHub SSH-Schlüssel-Registrierung
• mise offiziell — Laufzeit-Versionsmanager
• gh-CLI-Handbuch

Changelog

• 2026-05-12 — Erste Übersetzung (devAlice M2 i18n Seed)