Anleitung: Claude Code auf dem Mac installieren & nutzen

Claude Code von Anthropic ist gerade das meistdiskutierte KI-Werkzeug überhaupt: ein KI-Agent, der direkt auf Deinem Mac arbeitet, Dateien liest und schreibt, Befehle ausführt und dabei vor jeder Änderung um Erlaubnis fragt. Viele halten es für ein reines Entwickler-Tool, dabei erledigt es genauso gut Alltagsaufgaben wie Ordner aufräumen oder Texte überarbeiten. In dieser Anleitung installieren wir Claude Code gemeinsam auf dem Mac, machen die erste Session in einem echten Projekt und gehen die wichtigsten Konzepte durch. Danach klären wir, wie sich CLI, Desktop-App und VS-Code-Extension unterscheiden, und warum sich die Arbeit in GitHub-Repositories lohnt, inklusive Cloud-Sessions, die Du vom iPhone aus steuerst, während Dein Mac aus ist. Alle Befehle und Fakten sind auf dem Stand von Juni 2026 und gegen die offizielle Claude-Code-Dokumentation geprüft.

Voraussetzungen

Du brauchst einen Mac mit macOS 13 oder neuer und ein kostenpflichtiges Claude-Konto: Claude Code ist in den Abos Pro, Max, Team und Enterprise enthalten, der kostenlose Claude-Plan reicht nicht. Für den Einstieg genügt das Pro-Abo völlig. Programmierkenntnisse brauchst Du nicht, nur die Bereitschaft, ein Terminal-Fenster zu öffnen.

Schritt 1: Claude Code installieren

Öffne das Terminal (Cmd + Leertaste, dann Terminal tippen) und führe den offiziellen Installer aus:

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

Der Befehl lädt das signierte Claude-Code-Programm herunter und legt es unter ~/.local/bin/claude ab. Node.js oder andere Abhängigkeiten brauchst Du nicht, und die native Installation aktualisiert sich künftig automatisch im Hintergrund. Falls Du Deine Software lieber zentral über Homebrew verwaltest, funktioniert alternativ brew install --cask claude-code; wie Du Homebrew einrichtest, zeigt die Anleitung: Homebrew auf Mac unter MacOS Ventura installieren.

Öffne danach ein neues Terminal-Fenster und prüfe die Installation:

claude --version

Gibt der Befehl eine Versionsnummer aus, ist alles bereit.

Schritt 2: Anmelden und die erste Session starten

Claude Code arbeitet immer in dem Ordner, in dem Du es startest. Wechsle für die erste Session in ein echtes Projekt, zum Beispiel einen Ordner mit Dokumenten oder Code:

cd ~/Documents/mein-projekt
claude

Beim ersten Start öffnet sich Dein Browser für die Anmeldung mit Deinem Claude-Konto. Danach landest Du in einer interaktiven Sitzung: unten eine Eingabezeile, darüber der Verlauf. Schreib einfach auf Deutsch, was Du willst, etwa „Verschaff Dir einen Überblick über diesen Ordner und fasse zusammen, was hier liegt”. Claude liest daraufhin selbstständig die Dateien und antwortet. Mit /help listest Du alle Befehle auf, mit Esc unterbrichst Du Claude jederzeit, und mit /exit beendest Du die Session.

Schritt 3: Die drei wichtigsten Konzepte

CLAUDE.md anlegen. Die Datei CLAUDE.md im Projektordner ist das Gedächtnis Deines Projekts: Claude liest sie bei jedem Start und hält sich an die darin notierten Regeln, etwa welche Ordnerstruktur gilt oder was nicht angefasst werden darf. Du musst sie nicht selbst schreiben, tippe in der Session einfach:

/init

Claude analysiert das Projekt und erstellt eine passende CLAUDE.md, die Du anschließend wie eine normale Textdatei anpassen kannst.

Plan-Modus. Drücke Shift + Tab, um zwischen den Modi zu wechseln. Im Plan-Modus liest Claude nur und schlägt einen Plan vor, ohne irgendetwas zu verändern. Das ist die richtige Einstellung für größere Aufgaben: erst den Plan lesen und freigeben, dann arbeitet Claude ihn ab. Gerade am Anfang nimmt Dir das die Sorge, dass die KI ungefragt in Deinen Dateien wütet.

Permissions. Standardmäßig fragt Claude Code vor jeder Dateiänderung und vor jedem Shell-Befehl nach. Du bestätigst jeweils einmalig, dauerhaft für diese Befehlsart oder lehnst ab. Erst wenn Du einem Projekt vertraust, lohnt der Auto-Accept-Modus (ebenfalls über Shift + Tab), in dem Claude Dateiänderungen ohne Rückfrage durchführt.

Drei Alltags-Workflows jenseits vom Programmieren

Ordner aufräumen. Starte claude im Downloads-Ordner und schreib: „Sortiere alle Dateien in Unterordner nach Typ: PDFs nach Dokumente, Bilder nach Bilder, Installationsdateien nach Installer. Zeig mir vorher den Plan.” Claude listet auf, was es verschieben will, und räumt nach Deiner Freigabe Hunderte Dateien in einem Durchgang auf. Dasselbe funktioniert für Fotosammlungen, Scans oder das Archivieren alter Projektordner.

Skripte und Automationen generieren. Beschreib eine wiederkehrende Aufgabe, und Claude schreibt Dir das passende Shell- oder AppleScript, testet es direkt und erklärt Dir jede Zeile, zum Beispiel: „Schreib mir ein Shell-Skript, das alle Bilder in diesem Ordner auf 1200 Pixel Breite verkleinert und als WebP speichert.” Solche Skripte kannst Du anschließend auch in macOS-Bordmittel einbauen; wie das geht, zeigt der Artikel Apple Automator: Das vergessene Gratis-Tool auf dem Mac.

Texte überarbeiten. Claude Code arbeitet direkt in Deinen Textdateien. Leg Deine Notizen, Briefe oder Blogentwürfe als Markdown- oder Textdateien in einen Ordner und beauftrage zum Beispiel: „Überarbeite entwurf.md auf klares, fehlerfreies Deutsch, behalte meinen Ton bei und zeig mir die Änderungen.” Der Vorteil gegenüber dem Chat im Browser: Claude ändert die Datei selbst, Du musst nichts hin und her kopieren, und bei zwanzig Dateien erledigt es eben alle zwanzig.

CLI, Desktop-App oder VS Code: Was ist für wen?

Claude Code gibt es inzwischen in drei Formen für den Mac, und alle drei nutzen denselben Motor, dasselbe Konto und dieselbe Konfiguration (CLAUDE.md, Einstellungen, MCP-Server). Du entscheidest also nicht einmal für immer, sondern wählst je nach Aufgabe.

Die CLI ist das Original mit dem vollen Funktionsumfang: alle Befehle, Skills und Konfigurationsmöglichkeiten, dazu ideal für Automatisierung. Ihr einziger Nachteil ist die reine Textoberfläche, die auf Terminal-Neulinge spröde wirkt.

Die Desktop-App (Download und Einrichtung beschreibt der offizielle Desktop-Quickstart) verpackt denselben Agenten in eine grafische Oberfläche mit Seitenleiste für mehrere parallele Sessions, visueller Diff-Ansicht zum Prüfen jeder Änderung, integriertem Terminal und Datei-Editor. Im Tab Code wählst Du einen lokalen Ordner und arbeitest wie in der CLI, nur mit Klick statt Tastatur. Wenn Du noch nie ein Terminal benutzt hast, ist die Desktop-App der angenehmste Einstieg. Sie bringt Claude Code komplett mit, eine separate CLI-Installation ist nicht nötig.

Die VS-Code-Extension installierst Du in VS Code über Cmd + Shift + X, Suche nach „Claude Code”, dann Install. Sie öffnet ein Chat-Panel direkt im Editor, zeigt Änderungen als Seite-an-Seite-Diff, lässt Dich Pläne vor der Ausführung als Dokument kommentieren und Dateien per @-Erwähnung in den Kontext holen. Für alle, die ohnehin den Tag in VS Code verbringen, ist das die natürlichste Form. Einige CLI-Funktionen fehlen im Panel, aber die Extension bringt die CLI gleich mit: ein claude im integrierten Terminal genügt.

Mein Rat: Terminal-Neulinge starten mit der Desktop-App, Entwickler mit der Extension, und sobald Du Gefallen an der Sache findest, kommt die CLI ohnehin dazu. Alle drei parallel zu nutzen ist ausdrücklich vorgesehen und völlig normal.

Mit GitHub-Repositories arbeiten, auch in der Cloud

Sobald Du regelmäßig mit Claude Code arbeitest, solltest Du Deine Projekte als Git-Repository führen, idealerweise auf GitHub. Der Grund ist simpel: Jede Änderung der KI ist dann nachvollziehbar und mit einem Befehl rückgängig zu machen, und Claude Code selbst kann committen, Branches anlegen und Pull Requests erstellen, wenn Du es darum bittest. Ein „mach das Backup erst, dann trau Dich” ist damit eingebaut.

Richtig interessant wird GitHub durch Claude Code on the web unter claude.ai/code, derzeit als Research Preview für Pro-, Max- und Team-Abos verfügbar. Dort verbindest Du Dein GitHub-Konto, wählst ein Repository und gibst eine Aufgabe ab. Die Session läuft dann komplett auf der Cloud-Infrastruktur von Anthropic in einer isolierten Sandbox: Dein Mac kann zugeklappt oder ausgeschaltet sein, die Arbeit läuft weiter. Und weil die Session in der Cloud lebt, siehst Du sie auch in der Claude-App auf dem iPhone, kannst Rückfragen beantworten, den Fortschritt verfolgen und neue Aufgaben anstoßen, während Du unterwegs bist. Aus der CLI heraus startest Du eine solche Cloud-Session mit dem Flag --remote und holst sie Dir mit --teleport später wieder ins lokale Terminal.

Fazit: Klein anfangen, schnell unentbehrlich

Claude Code wirkt von außen wie ein Spezialwerkzeug für Programmierer, ist aber in Wahrheit ein Allzweck-Agent für alles, was auf Deinem Mac in Dateien und Ordnern lebt. Der Einstieg kostet einen curl-Befehl und zehn Minuten, und mit Plan-Modus und Nachfragen vor jeder Änderung bleibt das Risiko überschaubar. Fang mit einem unkritischen Ordner an, lass Dir eine CLAUDE.md generieren und arbeite Dich von Aufräum-Aufgaben zu eigenen Skripten vor. Wenn Du tiefer einsteigen willst, ist die offizielle Dokumentation mit Quickstart, Best Practices und allen Befehlen die beste Anlaufstelle.