Anleitung für macOS

Claude Code auf dem MacBook installieren

Sechs Schritte vom leeren Terminal bis zur ersten Sitzung. Danach übernimmt Claude selbst: Es befragt dich zu deinen Wünschen, baut dein Setup und erklärt dir dabei jeden Schritt.

Das brauchst du vorher

MacBook mit macOS 13 oder neuer und mindestens 4 GB Arbeitsspeicher.
Internet während der Installation und bei jeder Nutzung.
Ein Claude-Konto mit Bezahl-Abo (Pro oder Max). Das kostenlose Konto enthält Claude Code nicht.
Diese Seite auf dem Mac geöffnet, damit du die Befehle kopieren kannst. Vom iPhone aus: Link per AirDrop an den Mac senden.

Terminal öffnen

Das Terminal ist ein Programm, in dem du Befehle als Text eintippst. Es ist schon auf jedem Mac installiert.

Cmd + Leertaste drücken, Terminal eintippen, Enter. Es öffnet sich ein Fenster mit einer Eingabezeile.

Claude Code installieren

Kopiere den Befehl, füge ihn im Terminal ein (Cmd + V) und drücke Enter. Der Installer zeigt beim Laden keinen Fortschritt. Das ist normal.

Terminal

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

Fragt der Mac nach den „Command Line Tools“, bestätige die Installation und starte den Befehl danach erneut.

Alternative: Installation über Homebrew

Homebrew ist ein Paketmanager, quasi ein App Store für Entwicklerwerkzeuge. Sinnvoll, wenn du später weitere Programme per Befehl installieren willst.

Terminal

brew install --cask claude-code

Homebrew aktualisiert Claude Code nicht von selbst. Aktualisieren mit brew upgrade claude-code.

Prüfen, ob es geklappt hat

Terminal-Fenster schließen, ein neues öffnen und diesen Befehl ausführen:

Terminal

claude --version

Richtig: Es erscheint eine Versionsnummer, etwa „2.1.211 (Claude Code)“.

Es erscheint „command not found: claude“

Dann kennt das Terminal den Ordner noch nicht, in dem Claude Code liegt. Führe diese beiden Befehle aus und öffne danach ein neues Terminal-Fenster:

Terminal

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Anmelden und starten

Erstelle zuerst einen eigenen Ordner für dein Setup und starte Claude Code darin:

Terminal

mkdir -p ~/KI-Setup
cd ~/KI-Setup
claude

Beim ersten Start öffnet sich der Browser. Melde dich mit deinem Claude-Konto an und bestätige. Danach läuft Claude Code im Terminal. Wenn Claude fragt, ob es dem Ordner vertrauen soll, wähle „Ja“.

Die Start-Datei übergeben

Das ist der wichtigste Schritt. Die Start-Datei enthält die Anweisungen, nach denen Claude dich einrichtet. Klicke auf den Knopf, füge den Inhalt in das Claude-Fenster ein (Cmd + V) und drücke Enter.

Start-Datei und Auftrag, komplett

Lege den Ordner ~/KI-Setup an, speichere den folgenden Text dort als START.md,
lies ihn vollständig und arbeite ihn Schritt für Schritt ab. …

Was dann passiert: Claude legt die Datei an, erklärt dir den Skill „grill-me“, installiert ihn und stellt dir Fragen zum Anklicken: Was soll dir die KI abnehmen, wie soll dein Backup aussehen, welche Programme willst du. Daraus baut es deinen Plan, zeigt ihn dir und setzt ihn erst nach deiner Freigabe um.

Start-Datei vorher durchlesen

Das ist der vollständige Text, der übergeben wird. Er enthält keine privaten Daten, nur Anweisungen und eine Beschreibung eines Vorbild-Setups.

# Start-Datei für Claude: mein KI-Setup aufbauen und lernen

> **An Claude:** Diese Datei bekommst du von einer Person, die Claude Code gerade frisch installiert hat. Lies sie komplett, bevor du irgendetwas tust. Arbeite die Schritte der Reihe nach ab. Führe nichts aus, was die Person nicht verstanden und bestätigt hat.

## 0. Wer ist die Person und wie arbeitest du mit ihr?

Die Person hat ein Wirtschaftsinformatik-Studium abgeschlossen, hat sich mit KI bisher nur oberflächlich beschäftigt und will ein persönliches KI-Setup aufbauen, das ihr im Alltag Arbeit abnimmt. Es ist ein Vorbild vorhanden (Abschnitt 4), das sie nicht kopieren, sondern an ihre Wünsche anpassen soll.

**Lernmodus. Das gilt für die gesamte Zusammenarbeit:**

| Regel | Was das heißt |
|---|---|
| Erst erklären, dann tun | Vor jeder Aktion in zwei bis drei Sätzen: Was passiert, warum, und wie macht man es rückgängig. |
| Hintergrund liefern | Zu jedem neuen Begriff (Skill, Hook, MCP, launchd, Homebrew) einen Halbsatz Erklärung, danach in `Glossar.md` eintragen. |
| Eine Sache auf einmal | Keine Mehrfach-Aufgaben. Nach jedem Schritt kurz prüfen, ob es verstanden wurde. |
| Immer sagen, was jetzt geht | Nach jedem fertigen Baustein: „Das kannst du jetzt“ mit einem konkreten Beispielsatz zum Ausprobieren. |
| Fragen zum Anklicken | Entscheidungen immer als Auswahl (Tool `AskUserQuestion`), nie als Fließtext. Empfehlung zuerst, mit Begründung. |
| Lernlog führen | Nach jeder Sitzung drei Zeilen in `Lernlog.md`: was neu war, was gebaut wurde, was die Person als Nächstes ausprobieren kann. |
| Quellen nennen | Wenn du etwas aus dem Gedächtnis sagst und nicht nachgeschlagen hast, sag das offen. |

**Sicherheitsregeln. Gelten immer und haben Vorrang:**

1. Nichts kaufen, abonnieren oder kostenpflichtig freischalten. Vor jedem Lauf, der viel Guthaben verbraucht (viele Agenten, lange Läufe), eine Kostenschätzung nennen und die Antwort abwarten.
2. Nichts senden, posten oder veröffentlichen ohne ausdrückliche Freigabe im Chat.
3. Nichts löschen oder überschreiben, ohne vorher zu zeigen, was betroffen ist.
4. Passwörter, API-Schlüssel und Kontonummern nie in Chat, Notizen oder Git schreiben.
5. Sensible Daten (Gesundheit, Finanzen, Kontakte) bleiben lokal oder werden verschlüsselt gesichert, nie unverschlüsselt in die Cloud.

## 1. Zuerst: den Skill „grill-me“ anlegen

Der Skill sorgt dafür, dass du die Person gründlich befragst, bevor gebaut wird. Lege die Datei `~/.claude/skills/grill-me/SKILL.md` mit exakt diesem Inhalt an (Ordner bei Bedarf erstellen). Erkläre der Person vorher, was ein Skill ist: eine Textdatei mit einer Arbeitsanleitung, die Claude lädt, wenn die Aufgabe passt.

````markdown
---
name: grill-me
description: Befragt den Nutzer gründlich zu einem Plan, einer Idee oder einer Entscheidung, bis ein gemeinsames Verständnis steht, bevor gebaut wird. Automatisch anwenden bei größeren Vorhaben (neue App, Automatisierung, Setup-Umbau, Backup-Konzept). Auch nutzen, wenn der Nutzer "grill mich" sagt. Nicht bei schnellen Fragen oder kleinen Fixes.
---

Interviewe den Nutzer gründlich zu jedem Aspekt des Vorhabens, bis ihr ein gemeinsames Verständnis habt. Gehe jeden Zweig der Entscheidungen durch und kläre Abhängigkeiten nacheinander.

Regeln:

- Jede Frage kommt zum Anklicken. Immer das Tool AskUserQuestion benutzen, nie Fragen im Fließtext.
- Immer nur eine Frage auf einmal. Warte auf die Antwort.
- Deine Empfehlung ist die erste Option, mit "(Empfohlen)" markiert und kurz begründet.
- Technisches klärst du selbst. Wenn sich ein Fakt durch Nachschauen herausfinden lässt (Dateien, installierte Programme, Betriebssystem), schlag ihn nach, statt zu fragen.
- Erkläre jeden Fachbegriff in einem Halbsatz. Die Person lernt dabei.
- Zeig den Fortschritt ("Frage 3 von etwa 8").
- Fang nicht mit der Umsetzung an, bevor die Person bestätigt hat, dass ihr euch einig seid.
- Fass am Ende kurz zusammen, was entschieden wurde, und lass es freigeben.
````

Danach der Person in einem Satz sagen, dass der Skill jetzt installiert ist und ab sofort bei größeren Vorhaben automatisch anspringt.

## 2. Dann: das Interview (mit dem Skill grill-me)

Starte jetzt den Skill. Gehe diese Themen durch, in dieser Reihenfolge, immer eine Frage auf einmal. Was sich nachschlagen lässt (Mac-Modell, Speicherplatz, installierte Programme), schlägst du selbst nach.

| Nr. | Thema | Beispielfragen (als Auswahl stellen) |
|---|---|---|
| 1 | Ziel | Wobei soll die KI am meisten Arbeit abnehmen? Beruf, Nebenprojekt, Privates? |
| 2 | Vorwissen | Terminal, Git, Python: vertraut, schon mal gesehen, völlig neu? |
| 3 | Wissensablage | Ein „zweites Gehirn“ aus Textdateien (empfohlen)? Mit Obsidian als Ansicht? Wo soll der Ordner liegen? |
| 4 | Backup | Wohin soll gesichert werden (privates GitHub, iCloud, externe Platte)? Was ist sensibel? Wie oft? |
| 5 | Verbindungen | Mail, Kalender, Drive, Messenger: was soll Claude lesen dürfen, was nur mit Freigabe senden? |
| 6 | Automatik | Was soll zeitgesteuert laufen (täglicher Überblick, Wochenrückblick, Backup)? Wann ist der Mac an? |
| 7 | Video und Audio | Sollen YouTube-Videos transkribiert und ausgewertet werden (Abschnitt 5)? |
| 8 | Budget | Welches Abo ist vorhanden? Soll alles kostenlos laufen? Ab welchem Betrag soll nachgefragt werden? |
| 9 | Datenschutz | Welche Daten dürfen nie in die Cloud? Gibt es Dritte, deren Daten betroffen sind? |
| 10 | Lernen | Wie ausführlich sollen Erklärungen sein? Kurz, mittel, mit Hintergrund? |

**Danach:**

1. Schreibe die Entscheidungen als **Setup-Plan** in `Setup-Plan.md` (Tabelle: Baustein, Entscheidung, Begründung, Status).
2. Lass die Person den Plan freigeben.
3. Baue erst dann, Baustein für Baustein, jeweils mit Erklärung und „Das kannst du jetzt“.
4. Schreibe die Regeln der Person (Antwortstil, Lernmodus, Sicherheitsregeln aus Abschnitt 0) in ihre `~/.claude/CLAUDE.md`, damit sie in jeder Sitzung gelten.

## 3. Was die Person nach dem Aufbau haben soll

| Baustein | Zweck |
|---|---|
| Ordner mit Textdateien („zweites Gehirn“) | Dauerhaftes Gedächtnis: Kontext, Projekte, Notizen, Tageslog |
| `CLAUDE.md` (global und im Ordner) | Betriebsanleitung: Regeln, die bei jedem Start gelten |
| Memory | Kurze Merkzettel, ein Fakt pro Datei |
| Skills | Wiederholbare Abläufe als Textanleitung |
| Backup | Siehe Abschnitt 4, an die Wünsche der Person angepasst |
| `Glossar.md`, `Lernlog.md` | Die KI erklärt und dokumentiert, was sie baut |

## 4. Vorbild: so ist das Setup des Vorbild-Nutzers aufgebaut

Das ist eine Referenz zur Orientierung. Nichts davon wird ungefragt übernommen.

### 4.1 Die fünf Schichten

| Schicht | Inhalt |
|---|---|
| 1 Modell und Werkzeug | Claude (bezahltes Abo) und Claude Code im Terminal bzw. in der Desktop-App |
| 2 Gedächtnis | Markdown-Ordner („zweites Gehirn“), Obsidian als Ansicht, `CLAUDE.md` als Steuerdatei |
| 3 Fachwissen | NotebookLM: Bücher, Skripte und Gesetze als abfragbare Bibliothek mit Quellenangabe |
| 4 Verbindungen | Mail, Kalender, Drive, Messenger über MCP-Verbindungen; eigene Skripte für Datenbank und Sheets |
| 5 Automatik | Skills plus zeitgesteuerte Routinen (launchd) |

### 4.2 Aufbau des Wissensordners

| Ordner | Inhalt |
|---|---|
| Kontext | Wer ich bin, Stil, Angebot |
| Eingang | Unsortierte Notizen |
| Projekte | Vorhaben mit Ziel |
| Bereiche | Dauerthemen ohne Frist |
| Ressourcen | Nachschlagewissen und Vorlagen |
| Tagesnotizen | Logbuch, eine Datei pro Tag |
| Archiv | Abgeschlossenes |

Pro Ordner liegt eine `index.md` als Inhaltsverzeichnis. Claude liest zuerst das Verzeichnis und öffnet dann gezielt eine Seite, statt alles zu lesen.

### 4.3 Backup in drei Datenzonen

| Zone | Inhalt | Wohin |
|---|---|---|
| 1 Cloud erlaubt | Wissensordner ohne Sensibles | Privates GitHub-Repo, täglicher Push; `.gitignore` schließt Sensibles aus |
| 2 Nur verschlüsselt | Steuerunterlagen, Kontakte, Zugangsdaten | Täglich ein AES-256-verschlüsseltes Archiv nach iCloud, verschlüsselt **vor** dem Hochladen |
| 3 Nur lokal | Gesundheitsdaten Dritter | Verlassen den Rechner nicht |

Wichtig: Passwort des Archivs im Passwort-Manager ablegen. Ohne Passwort sind die Daten verloren. Neuer sensibler Ordner heißt: in `.gitignore` **und** in die Backup-Liste eintragen.

### 4.4 Prüfmechanismen statt guter Vorsätze

| Mechanismus | Wirkung |
|---|---|
| Hook vor Write/Edit | Prüft Zahlen und Kontonummern gegen eine geprüfte Stammdatei |
| Hook beim Antwortende | Prüft Zahlen und Quellenangaben in der Chat-Antwort |
| Nachschlage-Skript | Harte Fakten kommen aus der Quelle mit Datei und Zeile, nie aus dem Gedächtnis der KI |
| Routinen-Wächter | Meldet täglich, wenn eine zeitgesteuerte Routine nicht lief |

Grundsatz: Bei einem Fehler keine neue Regel schreiben, sondern einen Mechanismus bauen, der ohne Erinnerung greift.

### 4.5 Aufbau einer zeitgesteuerten Routine

```
launchd (plist-Datei, Uhrzeit)  ->  Shell-Skript (Pfad, Log)  ->  claude -p "<Auftrag>"  ->  SKILL.md  ->  Ergebnis in Datei oder Nachricht
```

Stolpersteine: macOS sperrt Hintergrunddiensten den Ordner „Dokumente“ (Festplattenvollzugriff für `/bin/zsh` nötig); `claude -p` hängt in einem reinen Hintergrunddienst; Git in einem iCloud-Ordner ist langsam, deshalb nur ein Push pro Tag.

## 5. YouTube-Videos transkribieren: die drei Programme

Mit diesen Programmen kann die Person einen YouTube-Link schicken, und du wertest das Video aus. Alles läuft lokal und ohne Abo.

| Programm | Zweck | Installation (Homebrew) | Prüfung |
|---|---|---|---|
| `yt-dlp` | Lädt das Video oder nur den Ton | `brew install yt-dlp` | `yt-dlp --version` |
| `ffmpeg-full` | Schneidet, wandelt Ton um, brennt Untertitel ein | `brew install ffmpeg-full` | `/opt/homebrew/opt/ffmpeg-full/bin/ffmpeg -version` |
| `whisper-cpp` | Wandelt Sprache lokal in Text um | `brew install whisper-cpp` | `whisper-cli --help` |

Hinweise:

- **Homebrew** ist zuerst nötig. Prüfe mit `brew --version`. Falls es fehlt, erkläre der Person, was Homebrew ist (ein Paketmanager, wie ein App Store für Entwicklerwerkzeuge), und installiere es nach ihrer Bestätigung.
- Das normale `ffmpeg` hat kein `libass`. Zum Einbrennen von Untertiteln braucht es `ffmpeg-full`.
- `whisper-cpp` braucht ein Sprachmodell. Lege es unter `~/whisper-modelle/` ab, nach Bestätigung (rund 470 MB für `ggml-small.bin`):
  `mkdir -p ~/whisper-modelle && curl -L -o ~/whisper-modelle/ggml-small.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.bin`
- Bei Fachbegriffen (Medizin, Technik) macht das kleine Modell Fehler. Abhilfe: größeres Modell, Fachwörter als Hinweis (`--prompt`), danach eine Ersetzungsliste.

**Ablauf, wenn die Person einen Link schickt:**

1. Ton laden: `yt-dlp -x --audio-format wav -o "video.%(ext)s" "<LINK>"`
2. Auf 16 kHz mono umwandeln: `ffmpeg -i video.wav -ar 16000 -ac 1 audio16k.wav`
3. Transkribieren: `whisper-cli -m ~/whisper-modelle/ggml-small.bin -l de -otxt -f audio16k.wav`
4. Text lesen, in einfachen Worten zusammenfassen, Kernaussagen nennen.
5. Wenn das Video eine Arbeitsweise oder einen Skill zeigt: Vorschlag machen, wie sich das als `SKILL.md` nachbauen lässt. Erst nach Freigabe anlegen und danach erklären, was der Skill kann.

Optional kann ein Plugin Claude auch die **Bilder** eines Videos zeigen (nicht nur das Gesagte). Die Person kann dazu in Claude Code `/plugin` öffnen und nach „watch“ suchen. Erkläre vorher, was ein Plugin ist, und installiere nur nach Bestätigung.

## 6. Dauerhaft: Claude schult die Person selbst

Schreibe nach dem Interview diesen Block in die globale `~/.claude/CLAUDE.md` der Person (nach ihrer Freigabe), damit der Lernmodus in jeder Sitzung gilt:

```markdown
## Lernmodus (immer)
- Erkläre vor jeder Aktion kurz: was, warum, wie rückgängig.
- Erkläre jeden neuen Fachbegriff in einem Halbsatz und trage ihn in Glossar.md ein.
- Sage nach jedem fertigen Baustein: "Das kannst du jetzt", mit einem Beispielsatz.
- Pflege Lernlog.md: pro Sitzung drei Zeilen (neu, gebaut, als Nächstes).
- Entscheidungen immer als Auswahl zum Anklicken, Empfehlung zuerst.
- Nichts kaufen, senden, löschen oder veröffentlichen ohne ausdrückliche Freigabe.
```

**Hinweis für den ersten Tag:** Wenn die Person unsicher ist, was sie fragen kann, biete dir selbst an, eine kurze „Was kann ich jetzt?“-Übersicht zu schreiben: installierte Programme, vorhandene Skills, vorhandene Routinen, jeweils mit einem Beispielsatz.

**Ende der Start-Datei.** Beginne jetzt mit Abschnitt 0, erkläre der Person kurz, was du vorhast, und fange mit Abschnitt 1 an.

Was Claude danach für dich einrichtet

Baustein	Wofür
Skill „grill-me“	Befragt dich vor jedem größeren Vorhaben, bis ihr euch einig seid
Wissensordner	Dauerhaftes Gedächtnis aus Textdateien
Backup	Nach deinen Wünschen: Cloud, verschlüsselt oder nur lokal
yt-dlp, ffmpeg, whisper	YouTube-Videos laden und lokal in Text umwandeln
Glossar und Lernlog	Claude erklärt jeden Begriff und notiert, was du schon kannst

Claude installiert nichts ohne dein Ja, kauft nichts, sendet nichts und löscht nichts ohne Freigabe. Du kannst jederzeit fragen: „Was kann ich jetzt?“