Mac für Entwickler einrichten: der Leitfaden für 2026

Ein neuer Mac ist schnell ausgepackt, aber bis er zum Programmieren taugt, fehlen ein Paketmanager, Git, ein SSH-Schlüssel, ein Editor und eine aktuelle Programmiersprache. Die Reihenfolge ist dabei nicht egal: Wer zuerst den Editor installiert und erst danach Git einrichtet, klickt sich später durch Fehlermeldungen. Dieser Leitfaden geht die Einrichtung in einer Reihenfolge durch, in der jeder Schritt auf dem vorigen aufbaut, und verweist für die Details auf die passenden Einzelanleitungen.

Stand ist macOS 27 auf einem Mac mit Apple-Chip. Die Optionen für Git und SSH entsprechen Git 2.54 und OpenSSH 10.5, wie sie macOS 27.2 mitbringt.

1. Homebrew installieren

Homebrew ist der Paketmanager für den Mac: Fast jedes Entwicklerwerkzeug installierst Du damit mit einem einzigen Befehl und hältst es genauso einfach aktuell. Öffne das Terminal (Cmd + Leertaste, dann Terminal tippen) und führ den offiziellen Installer von brew.sh aus:

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

Der Installer fragt nach Deinem Passwort und richtet nebenbei die Befehlszeilenwerkzeuge von Apple ein, also auch Git und einen Compiler. Am Ende nennt er zwei Befehle, mit denen Homebrew in jedem neuen Terminalfenster verfügbar wird:

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

Ob alles geklappt hat, zeigt brew doctor. Die Ausgabe sollte mit „Your system is ready to brew.“ enden. Was Homebrew sonst noch kann, erklärt Homebrew auf dem Mac installieren: Anleitung für macOS 27.

2. Git einrichten

Git ist durch die Befehlszeilenwerkzeuge schon da. Es braucht nur noch Deinen Namen und Deine E-Mail-Adresse, die in jedem Commit stehen:

git config --global user.name "Dein Name"
git config --global user.email "du@example.com"
git config --global init.defaultBranch main

Ersetze Name und Adresse durch Deine eigenen. Nimm die E-Mail-Adresse, mit der Du auch bei GitHub angemeldet bist, damit Deine Commits dort Deinem Profil zugeordnet werden. Die dritte Zeile sorgt dafür, dass neue Repositories mit dem Zweig main starten, wie es GitHub erwartet. Mit git config --global --list prüfst Du die Einträge.

3. Einen SSH-Schlüssel erzeugen

Mit einem SSH-Schlüssel meldest Du Dich bei GitHub und bei Servern an, ohne jedes Mal ein Passwort einzutippen. Erzeuge einen modernen Schlüssel vom Typ Ed25519:

ssh-keygen -t ed25519 -C "du@example.com"

Bestätige den vorgeschlagenen Speicherort ~/.ssh/id_ed25519 mit Enter und vergib eine Passphrase. Die musst Du Dir nicht merken, wenn Du sie gleich im Schlüsselbund von macOS ablegst. Dafür öffnest Du die SSH-Konfiguration:

nano ~/.ssh/config

Trag diese Zeilen ein:

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

Speichere mit Control + O, bestätige mit Enter und schließ den Editor mit Control + X. Füge den Schlüssel dann einmalig dem Schlüsselbund hinzu:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Der Befehl fragt ein letztes Mal nach der Passphrase und speichert sie im Schlüsselbund. Ab jetzt entsperrt macOS den Schlüssel bei jeder Anmeldung automatisch. Wenn Du später auf Server zugreifst und eine Warnung zu geänderten Hostschlüsseln bekommst, hilft known_hosts am Mac bearbeiten und SSH-Fehler beheben.

4. Mit GitHub verbinden

Am bequemsten geht das mit dem offiziellen Kommandozeilenwerkzeug von GitHub:

brew install gh
gh auth login

Beantworte die Fragen so: GitHub.com, als Protokoll SSH, dann den eben erzeugten Schlüssel ~/.ssh/id_ed25519.pub hochladen lassen und die Anmeldung im Browser bestätigen. gh überträgt Deinen öffentlichen Schlüssel dabei selbst zu GitHub. Ob die Verbindung steht, testest Du mit:

ssh -T git@github.com

Beim ersten Mal fragt SSH, ob Du dem Server vertraust. Tippe yes. Die Antwort „Hi …! You’ve successfully authenticated“ bestätigt, dass alles passt.

5. VS Code installieren

Visual Studio Code ist der verbreitetste Editor und kostenlos. Mit Homebrew installierst Du ihn samt Befehl code für das Terminal:

brew install --cask visual-studio-code

Danach öffnest Du jeden Projektordner direkt aus dem Terminal mit code .. Nützliche erste Erweiterungen sind die für Deine Programmiersprache, etwa Python von Microsoft, sowie GitLens für einen besseren Blick auf die Git-Historie.

6. Python und Node.js

Für Python bringt macOS nur eine veraltete Version mit, die Du nicht anfassen solltest. Installier stattdessen eine aktuelle über Homebrew und lege pro Projekt eine eigene Umgebung an. Wie das zusammen mit VS Code funktioniert, steht in Python am Mac mit Homebrew installieren und in VS Code nutzen.

Arbeitest Du mit JavaScript oder TypeScript, kommt Node.js dazu:

brew install node

node --version zeigt danach die installierte Version.

7. Claude Code als KI-Helfer

Ein KI-Agent im Terminal gehört 2026 für viele zum Handwerkszeug: Er liest Dein Projekt, schlägt Änderungen vor und führt Befehle aus, fragt aber vorher. Claude Code installierst Du mit dem offiziellen Installer:

curl -fsSL https://claude.ai/install.sh | bash

Für die Nutzung brauchst Du ein kostenpflichtiges Claude-Abo. Anmeldung, erste Schritte und sinnvolle Arbeitsweisen erklärt Anleitung: Claude Code auf dem Mac installieren & nutzen. Wer lieber ein lokales Modell ohne Abo nutzen will, findet in Ollama auf dem Mac: lokale KI mit MLX nutzen einen Weg, Coding-Agenten mit Modellen auf dem eigenen Mac zu betreiben.

8. Docker für Container

Sobald ein Projekt eine Datenbank, einen Webserver oder mehrere Dienste braucht, führt kaum ein Weg an Docker vorbei. Damit läuft die Umgebung auf Deinem Mac genauso wie später auf dem Server. Installier Docker Desktop über die offizielle Seite, achte dabei auf die Version für Apple Silicon, und starte die App einmal. Danach funktionieren im Terminal die Befehle docker und docker compose. Der Test:

docker run --rm hello-world

Die Ausgabe beginnt mit „Hello from Docker!“. Docker Desktop reserviert sich eigenen Arbeitsspeicher. Unter Settings > Resources stellst Du ein, wie viel. Auf einem Mac mit 16 GB reichen für die meisten Projekte 4 GB.

Docker Desktop ist für private Nutzung, Ausbildung und kleine Firmen kostenlos, größere Unternehmen brauchen ein Abo. Eine schlanke Alternative für den Mac ist OrbStack, das sich bei den Befehlen genauso verhält.

9. macOS für Entwickler einstellen

Ein paar Einstellungen erleichtern die Arbeit am Code erheblich:

• Versteckte Dateien anzeigen. Konfigurationsdateien wie .env, .gitignore oder der Ordner .git beginnen mit einem Punkt und sind im Finder unsichtbar. Mit Cmd + Shift + . blendest Du sie im Finder ein und wieder aus. Mehr dazu in Versteckte Dateien am Mac anzeigen: Tastenkürzel und Terminal.
• Dateiendungen immer zeigen. Im Finder unter Finder > Einstellungen > Erweitert schaltest Du Alle Dateinamensuffixe einblenden ein. So siehst Du, ob eine Datei config.yaml oder config.yaml.txt heißt.
• Schnellere Tastenwiederholung. Wer viel mit den Pfeiltasten durch Code navigiert, stellt unter Systemeinstellungen > Tastatur die Tastenwiederholrate auf schnell und die Ansprechverzögerung auf kurz.

10. Git und SSH noch etwas komfortabler

Zwei kleine Dateien sparen auf Dauer viel Ärger.

Eine globale Ignorier-Liste sorgt dafür, dass macOS-Eigenheiten wie die Datei .DS_Store, die der Finder in jedem Ordner anlegt, nie in einem Repository landen:

echo ".DS_Store" >> ~/.gitignore_global
git config --global core.excludesfile ~/.gitignore_global

Kurznamen für Server in der SSH-Konfiguration ersparen Dir lange Befehle. Öffne ~/.ssh/config erneut und ergänze für jeden Server einen Block wie diesen:

Host meinserver
  HostName 203.0.113.10
  User nathan

Ersetze Kurzname, IP-Adresse und Benutzer durch Deine eigenen Werte. Danach genügt ssh meinserver. Diese Kurznamen funktionieren auch für scp und in VS Code. Wie Du Verbindungen noch bequemer verwaltest, zeigt SSH-Verbindungen am Mac speichern: PuTTY-Ersatz.

Für den nächsten Mac festhalten: Brewfile und Dotfiles

Den größten Gefallen tust Du Dir selbst, wenn Du die Einrichtung so festhältst, dass der nächste Mac in einer Viertelstunde fertig ist. Homebrew kann alle installierten Programme in einer Liste speichern, dem Brewfile:

brew bundle dump --file=~/Brewfile

Die Datei enthält jede Zeile wie brew "git" oder cask "visual-studio-code", und je nach Homebrew-Version auch Deine VS-Code-Erweiterungen. Auf einem neuen Mac installiert ein einziger Befehl alles wieder:

brew bundle install --file=~/Brewfile

Die Konfigurationsdateien, die mit einem Punkt beginnen, heißen Dotfiles: ~/.zshrc, ~/.zprofile, ~/.gitconfig, ~/.gitignore_global und ~/.ssh/config. Leg sie zusammen mit dem Brewfile in einen Ordner und versioniere ihn in einem privaten Repository auf GitHub. Wichtig: Deine privaten Schlüssel wie ~/.ssh/id_ed25519 gehören niemals in ein Repository, auch nicht in ein privates. Auf einem neuen Mac erzeugst Du einfach einen neuen Schlüssel und hinterlegst ihn bei GitHub.

Wenn Du iTerm2 statt des Terminals von Apple nutzt, zeigt iTerm2 vollständig auf einen neuen Mac übertragen – inklusive SSH-Zertifikaten und Passwörtern, wie Du auch dessen Einstellungen mitnimmst.

Woran Du erkennst, dass alles bereit ist

Ein kurzer Gesamttest in einem frischen Terminalfenster:

brew --version
git --version
ssh -T git@github.com
code --version
python3 --version

Jeder Befehl sollte eine Versionsnummer beziehungsweise die GitHub-Begrüßung liefern. Erscheint stattdessen „command not found“, fehlt meist die Homebrew-Zeile in ~/.zprofile aus Schritt 1, oder das Terminalfenster war schon vor der Installation offen.

Typische Probleme

• „Permission denied (publickey)“ bei GitHub: Der Schlüssel ist nicht bei GitHub hinterlegt oder nicht geladen. Prüf mit ssh-add -l, ob er im Agenten steckt, und mit gh ssh-key list, ob GitHub ihn kennt.
• Passphrase wird nach jedem Neustart erneut abgefragt: In ~/.ssh/config fehlt UseKeychain yes, oder der Befehl mit --apple-use-keychain wurde nicht ausgeführt.
• code wird nicht gefunden: VS Code wurde per Download statt über Homebrew installiert. Öffne dann in VS Code mit Cmd + Shift + P die Befehlspalette und wähle Shell Command: Install ‘code’ command in PATH.
• Homebrew meldet Warnungen bei brew doctor: Die meisten Hinweise sind harmlos. Lies sie trotzdem, denn oft steht direkt der passende Befehl zur Behebung dabei.

Fazit

Mit Homebrew, einem sauber eingerichteten Git, einem SSH-Schlüssel im Schlüsselbund und VS Code ist ein Mac in einer knappen Stunde startklar fürs Programmieren. Halte alles mit brew update und brew upgrade aktuell, und wenn Du später auf einen neuen Mac umziehst, sind es genau diese sieben Schritte wieder, nur noch schneller.