SchiLf · Fortbildung im Kollegium · BBS Lingen Wirtschaft

Obsidian + Claude Code

Die Installation zum Vortrag „Unterricht bauen mit Obsidian und Claude“ – Schritt für Schritt, für Windows und Mac parallel. Am Ende hast du ein Vault mit drei Ebenen und einer Hausordnung, nach der Claude deine Arbeitsblätter baut.

Diese Seite auf dem eigenen Gerät:
niehausg.de/obsidian-claude-installation.html

Obsidian

Das Gedächtnis

Ein Notizprogramm, das echte Dateien schreibt. Alles liegt lokal in einem Ordner auf deinem Rechner – dem Vault. Word, PDF und Bilder liegen im selben Ordner daneben. Kostenlos, ohne Konto.

Claude Code

Die Werkstatt

Eine KI, die nicht nur im Chatfenster antwortet, sondern in deinem Ordner arbeitet: lesen, schreiben, ablegen. Sie schlägt Rahmenlehrplan und Curriculum selbst nach und baut die fertige Word-Datei.

CLAUDE.md

Die Hausordnung

Einmal aufschreiben statt jedes Mal erklären: Ansprache, Schulform, DQR-Niveau, Layout, Ablageregeln, Quellenpflicht. Klartext in Stichpunkten – das Onboarding in Schritt 5 legt sie für dich an.

Claudian

Die Brücke

Eine Erweiterung, die Claude Code als Chatfenster direkt in Obsidian holt. Dein Vault wird zu Claudes Arbeitsordner – das Terminal brauchst du nach der Installation nicht mehr.

Das brauchst du

ein bezahltes Claude-Abo (Pro oder höher) – der kostenlose Plan enthält Claude Code nicht
Windows 10 (ab Version 1809) oder 11 bzw. macOS 13 Ventura oder neuer
ein Gerät, auf dem du Programme installieren darfst (bei Dienstgeräten oft gesperrt)
Internet, Zugangsdaten zu deinem Claude-Konto und ca. 1 bis 1¼ Stunden Zeit: Installation ca. 20–30 Minuten, Onboarding ca. 30–45 Minuten

Oben rechts kannst du dein System wählen – dann siehst du nur deine Spalte. Hake erledigte Schritte mit ✓ ab; dein Fortschritt erscheint als roter Balken unter der Kopfleiste.

1

Obsidian herunterladen und Vault anlegen

Die Notiz-App installieren und deinen persönlichen Wissensordner erstellen.

Windows Version 1.14.4

Obsidian herunterladen

Download für Windows Obsidian-1.14.4.exeInstallationsprogramm, ca. 1–2 Minuten Download
Installieren: Die Datei im Ordner Downloads doppelklicken. Die Installation läuft automatisch durch, danach startet Obsidian.

Erscheint die blaue Windows-Warnung („Der Computer wurde durch Windows geschützt“): Weitere Informationen → Trotzdem ausführen.
Vault anlegen: Einen neuen Vault erstellen → Erstellen (engl. Create new vault) → Namen vergeben, z. B. Schule → Durchsuchen und Speicherort wählen → Erstellen.

⌘ Mac Version 1.14.4 · Intel & Apple Silicon

Obsidian herunterladen

Download für Mac Obsidian-1.14.4.dmgDisk-Image, ca. 1–2 Minuten Download
Installieren: Die .dmg-Datei doppelklicken und das Obsidian-Symbol in den Ordner Programme ziehen.

Beim ersten Start fragt macOS, ob du die aus dem Internet geladene App öffnen willst → Öffnen.
Vault anlegen: Einen neuen Vault erstellen → Erstellen (engl. Create new vault) → Namen vergeben, z. B. Schule → Durchsuchen und Speicherort wählen → Erstellen.

Tipp: Speicherort mit Bedacht wählen

Legst du den Vault in OneDrive oder iCloud Drive, ist er automatisch gesichert und auf mehreren Geräten verfügbar. Merk dir den Ordner – in Schritt 5 legst du dort die Onboarding-Datei ab.

Obsidian auf Deutsch & Ersatz-Link

Einstellungen (Zahnrad unten links) → Allgemein → Sprache → Deutsch, dann Obsidian neu laden. Funktioniert ein Download-Link nicht mehr, gibt es die aktuelle Version auf obsidian.md/download.

2

Claude Code installieren

Ein einziger Befehl im Terminal – danach heißt es kurz warten.

Windows PowerShell

PowerShell öffnen: ⊞ Windows-Taste drücken bzw. Startmenü öffnen → powershell eintippen → Rechtsklick auf „Windows PowerShell“ → Als Administrator ausführen → Rückfrage mit Ja bestätigen.

Laut Anthropic geht es auch ohne Administratorrechte – mit hat es sich in unseren Tests bewährt.
Befehl kopieren, einfügen und mit Enter ausführen:

irm https://claude.ai/install.ps1 | iex

Einfügen in PowerShell: Strg + V oder einfach Rechtsklick ins Fenster.
Warten! Ruhe bewahren.
Die Installation kann mehrere Minuten dauern, auch wenn scheinbar nichts passiert. Fenster nicht schließen, nichts abbrechen – gut Ding will Weile haben. Steht die Anzeige sichtbar still, einmal Enter drücken.
Speicherort kopieren: Am Ende zeigt das Installationsprogramm, wo Claude Code liegt, z. B. C:\Users\DeinName\.local\bin\claude.exe. Pfad mit der Maus markieren und kopieren – du brauchst ihn gleich in Schritt 3.

⌘ Mac Terminal

Terminal öffnen: ⌘ cmd + Leertaste → Terminal eintippen → Enter.
Befehl kopieren, einfügen (⌘ + V) und mit Enter ausführen:

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

Wer lieber tippt: Den senkrechten Strich | („Pipe“) erzeugst du auf der deutschen Mac-Tastatur mit ⌥ option + 7.
Kurz warten, bis die Installation abgeschlossen ist und die Eingabezeile wieder erscheint. Das geht auf dem Mac meist zügig.

3

Claude Code starten und mit deinem Konto verbinden

Einmalig im Terminal – danach übernimmt Claudian in Obsidian.

Windows PowerShell

Claude Code starten: Den kopierten Speicherort in PowerShell einfügen und Enter drücken. Alternativ funktioniert immer dieser Befehl:

& "$env:USERPROFILE\.local\bin\claude.exe"

Optional: Damit künftig einfach claude reicht

Diese zwei Zeilen tragen den Ordner dauerhaft in den Windows-Suchpfad ein. Danach ein neues PowerShell-Fenster öffnen.

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Farbschema wählen (z. B. Light mode) mit den Pfeiltasten → Enter.
Anmeldeart: 1. Claude account with subscription → Enter.
Im Browser anmelden und Autorisieren klicken.

Startet der Browser nicht: Taste c drücken (kopiert den Link) oder den angezeigten Link markieren und kopieren → im Browser einfügen.
Code zurück ins Terminal: Zeigt der Browser einen Code an, diesen kopieren, in PowerShell einfügen (Rechtsklick) → Enter.

Code lässt sich nicht einfügen? Nicht Strg + V verwenden, sondern einfach mit der rechten Maustaste ins PowerShell-Fenster klicken – der Code wird dann automatisch eingefügt. Danach Enter drücken.

Meldet der Browser stattdessen direkt „erfolgreich angemeldet“, entfällt dieser Schritt – einfach abhaken.
Hinweise bestätigen: Folgende Abfragen (Sicherheitshinweise, Ordner vertrauen) jeweils mit Enter bestätigen. Erscheint das Eingabefeld von Claude, bist du fertig – PowerShell darf geschlossen werden.

⌘ Mac Terminal

Claude Code starten: claude eintippen (ohne Schrägstrich) → Enter.

claude
Meldung „command not found“? Dann diesen Befehl einfügen und Enter drücken – anschließend erneut claude eingeben:

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

Den ganzen Befehl mit echo verwenden – am besten über den Kopieren-Knopf. Nur den Teil export PATH=… einzugeben hilft lediglich im aktuellen Fenster; nach einem Neustart fehlt claude dann wieder. Mit echo … >> ~/.zshrc wird die Einstellung dauerhaft gespeichert. Einmal ausführen genügt.

Nicht betroffen? Einfach abhaken und weiter.
Farbschema wählen (z. B. Dark mode) mit den Pfeiltasten → Enter.
Anmeldeart: 1. Claude account with subscription → Enter.
Im Browser anmelden → Autorisieren → Browser-Tab schließen. Das Terminal meldet die erfolgreiche Anmeldung automatisch.

Klappt die Anmeldung nicht: in Claude Code /login eingeben und neu versuchen.
Hinweise bestätigen: Folgende Abfragen jeweils mit Enter bestätigen. Erscheint das Eingabefeld von Claude, bist du fertig – das Terminal darf geschlossen werden.

Gut zu wissen

Die Anmeldung ist nur einmal nötig. Claudian nutzt ab jetzt im Hintergrund dasselbe Konto – das Terminal brauchst du im Alltag nicht mehr. Falsches Konto erwischt? Im Terminal Claude Code starten und /login eingeben.

4

Claudian in Obsidian installieren

Auf Windows und Mac identisch – Claude zieht in dein Vault ein.

⌘ Windows & Mac

Obsidian starten → Einstellungen öffnen (Zahnrad unten links).
Externe Erweiterungen zulassen: Im Menü links Externe Erweiterungen wählen → Eingeschränkten Modus verlassen.

Bei englischer Oberfläche: Community plugins → Turn on community plugins.
Community-Erweiterungen durchsuchen: Bei Community-Erweiterungen auf Durchsuchen klicken → Claudian eingeben.
Installieren und danach Aktivieren klicken. Einstellungen schließen.
Chat öffnen: In der linken Seitenleiste auf das Claudian-Symbol klicken – rechts erscheint das Chatfenster.
Kurz testen:

Hallo! Welche Ordner und Dateien siehst du in meinem Vault?

Antwortet Claude, steht die Verbindung. Fragt Claudian später um Erlaubnis, Dateien anzulegen oder zu ändern, kurz lesen und zustimmen.

Fehlermeldung „Claude CLI not found“?

Dann findet Claudian das in Schritt 2 installierte Programm nicht. In Obsidian: Einstellungen → Claudian → Bereich Advanced → Feld Claude Code CLI path – dort den Pfad eintragen und Obsidian neu starten.

Pfad unter Windows

Steht meist so aus Schritt 2 in der Zwischenablage. Sonst diesen Befehl in PowerShell ausführen – er zeigt den kompletten Pfad an:

echo "$env:USERPROFILE\.local\bin\claude.exe"

⌘ Pfad auf dem Mac

Diesen Befehl im Terminal ausführen und die Ausgabe (z. B. /Users/DeinName/.local/bin/claude) kopieren:

echo ~/.local/bin/claude

5

Onboarding: Claude richtet dein Vault ein

Ein Interview von ca. 30–45 Minuten – danach stehen die drei Ebenen und deine Hausordnung.

Neu & ungetestet

Hinweis: Diese Onboarding-Datei hat Gert Niehaus für Lehrkräfte an berufsbildenden Schulen angepasst. Sie wurde noch nicht getestet. Wenn beim Onboarding etwas hakt oder seltsam wirkt: Claude im Chat darauf hinweisen und Gert kurz Rückmeldung geben – die Datei wird anhand eurer Erfahrungen verbessert.

⌘ Windows & Mac

Onboarding-Datei herunterladen – angepasst für Lehrkräfte an berufsbildenden Schulen (noch ungetestet, siehe Hinweis oben):

CLAUDE.md herunterladen CLAUDE.mdSetup-Assistent · angepasst von Gert Niehaus · Stand 10/2026
In den obersten Vault-Ordner legen: Die Datei aus Downloads in den Ordner verschieben, den du in Schritt 1 als Vault angelegt hast – nicht in einen Unterordner. Sie muss exakt CLAUDE.md heißen.

Windows: Im Explorer unter Ansicht → Anzeigen → Dateinamenerweiterungen prüfen, dass sie nicht „CLAUDE.md.txt“ heißt. Mac: Hängt ein „.txt“ dran, im Finder umbenennen.

Alternative ohne Download: Inhalt kopieren

Inhalt kopieren → in Obsidian im obersten Ordner eine neue Notiz mit dem Namen CLAUDE anlegen → einfügen.
Neuen Chat starten: In Claudian einen neuen Chat öffnen (nur dann wird die CLAUDE.md geladen) und schreiben:

Tipp vorab: Im Chatfenster den Modus von Ask auf Accept edits umstellen. Sonst fragt Claudian bei jeder der rund 15–20 neuen Dateien einzeln nach Erlaubnis. Nach dem Onboarding kannst du wieder auf Ask zurückstellen.

Hallo! Bitte starte das Onboarding.
Fragen beantworten (ca. 30–45 Min.): Ruhig ausführlich antworten – je mehr Claude weiß, desto besser passen später die Materialien. „Überspringen“ geht immer. Am Ende zeigt Claude die geplante Ordnerstruktur; nach deinem „Passt!“ wird alles angelegt.

Ganz am Ende prüft Claude, ob Python installiert ist – das braucht es, um Word-Dateien zu erzeugen. Fehlt es, bietet Claude die Installation an; unter Windows ist danach meist ein Neustart von Obsidian nötig.

So lange dauert das Onboarding

Check & Begrüßungca. 5 Min.
Ebene 01 · Basics Schule (Grundsätze, Layout, Didaktik)ca. 10 Min.
Ebene 02 · Schulformen (je nach Zahl der Bildungsgänge)ca. 5–10 Min.
Ebene 03 · Start-Lernfeld & Datenschutzca. 5 Min.
Vorschau bestätigen, Claude baut das Vaultca. 5–10 Min.
am Ende, nur falls Python fehlt: Installation+ 5–10 Min.

Gesamtca. 30–45 Min.

Schätzung – die Datei ist noch nicht erprobt. Kurze Antworten und „überspringen“ verkürzen die Zeit; alles lässt sich später ergänzen.

Das fragt dich der Assistent

01 · Person & Schule
01 · Oberste Grundsätze
01 · Arbeitsblattstandard & Layout
01 · Didaktik
01 · Was du nie willst
02 · Bildungsgänge
02 · DQR-Niveau & Lerngruppe
02 · Lehrwerk, Rahmenlehrplan, Curriculum
03 · Dein Start-Lernfeld
Datenschutz & KI-Leitfaden

Vorab kurz überlegen

Mit einem Lernfeld starten – nicht mit fünf Klassen gleichzeitig. Überleg dir vorher: Welches Lernfeld soll es sein? Welches DQR-Niveau hat der Bildungsgang? Liegen dir Rahmenlehrplan und schulisches Curriculum als Datei vor?

Das Ergebnis (Beispiel)

Schule/
├── CLAUDE.md                ← Hausordnung
├── 01 Basics Schule/        ← gilt für alle Klassen
│   ├── Schulprofil.md
│   ├── Grundsätze.md
│   ├── Arbeitsblattstandard.md
│   ├── DQR-Niveaus.md
│   └── Didaktik.md
├── 02 Basics Schulformen/   ← gilt für eine Schulform
│   ├── BFS dual/
│   │   ├── BFS dual.md      ← Steckbrief
│   │   └── Rahmenlehrplan, Curriculum
│   └── Fachoberschule Wirtschaft/
└── 03 Unterricht/           ← gilt für ein Lernfeld
    └── BFS dual LF 5 …/
        ├── Lernpfad.md
        └── Lernsituationen, Arbeitsblätter

Im Lernfeld immer von der Vorgabe zum Material: Rahmenlehrplan → Curriculum → Lernpfad → Lernsituation → Arbeitsblatt.

Grenzen und Sorgfaltspflichten

Bevor es losgeht: sechs Punkte, die für uns als Lehrkräfte entscheidend sind.

Keine Schülerdaten in die KI

Alles, was Claude liest oder was du in den Chat schreibst, wird zur Verarbeitung an die Server von Anthropic übertragen. Namen, Noten und Klassenlisten bleiben deshalb draußen. DSGVO, niedersächsisches Schuldatenschutzrecht und der KI-Leitfaden der Schule gelten unverändert.

Privates Konto, dienstliche Grenzen

Ein privates Claude-Abo ist kein von der Schule freigegebener Dienst. Nutze es für die Unterrichtsvorbereitung ohne personenbezogene Daten. Für alles Dienstliche mit Personenbezug gelten die Vorgaben des Landes und deiner Schule.

Modelltraining abschalten

Auf claude.ai unter Einstellungen → Datenschutz die Option deaktivieren, dass deine Chats zur Verbesserung der Modelle verwendet werden dürfen. Das dauert eine Minute und gilt für dein ganzes Konto.

Die fachliche Prüfung bleibt bei dir

Sprachmodelle erzeugen plausibel klingende Falschaussagen. Paragrafen, Fristen, Beträge und Zahlen immer gegenlesen, bevor ein Material in die Klasse geht. Claude ist dein Assistent, nicht dein Ersatz.

Claude arbeitet an echten Dateien

Claude kann im Vault Dateien anlegen, ändern und löschen. Lies Rückfragen, bevor du zustimmst. Ein Vault in OneDrive oder iCloud hat den Vorteil eines Versionsverlaufs – so lässt sich ein versehentlich geänderter Stand wiederherstellen.

Urheberrecht

Keine Verlagstexte hineinkopieren: eigene Formulierungen, eigene Grafiken, Quellen konkret angeben. Lehrwerksangaben (Verlag, Titel, Kapitel) darf Claude nennen – Seiten aus dem Schulbuch gehören nicht ins Vault.

Los geht's – erste Aufträge und Hilfe bei Problemen

Immer von der Vorgabe zum Material. Platzhalter in [eckigen Klammern] ersetzen.

Erste Aufträge für Claudian

Ich habe Rahmenlehrplan und Curriculum für [Bildungsgang] in 02 Basics Schulformen abgelegt. Lies beides und fülle den Lernpfad für LF [Nr.] aus: Stationen, Modellunternehmen, Handlungsprodukt.
Entwirf Station [Nr.] des Lernpfads als Lernsituation: Handlungssituation mit Rolle und Auftrag, Kompetenzen nach DQR [Niveau].
Erstelle aus der Lernsituation [Name] das erste Arbeitsblatt als .docx nach meinem Arbeitsblattstandard.
Prüfe das Arbeitsblatt [Name] fachlich: Welche Paragrafen, Zahlen und Fristen muss ich gegenlesen?
Merk dir: [deine Regel, z. B. „In der Fachoberschule sieze ich die Lernenden.“]
Wo war ich stehen geblieben? Welche Station im Lernpfad ist als Nächstes dran?

Wenn es hakt

Problem	Lösung
„claude“ wird nicht erkannt / command not found	Windows: Claude Code mit dem vollständigen Pfad starten (Schritt 3) oder den Suchpfad dauerhaft ergänzen. Mac: den export-PATH-Befehl aus Schritt 3 ausführen und ein neues Terminalfenster öffnen.
Browser öffnet sich bei der Anmeldung nicht	Im Terminal c drücken oder den Link markieren, kopieren und im Browser einfügen.
Einfügen in PowerShell klappt nicht	Rechtsklick ins Fenster statt Strg + V.
Claudian meldet „Claude CLI not found“	Pfad in den Claudian-Einstellungen unter Advanced → Claude Code CLI path eintragen (Schritt 4), Obsidian neu starten.
Claude startet das Onboarding nicht	Liegt die Datei im obersten Vault-Ordner und heißt exakt CLAUDE.md? Danach einen neuen Chat öffnen.
Falsches Konto oder abgemeldet	Claude Code im Terminal starten und /login eingeben.
Claude kann keine Word-Datei erzeugen	Python bzw. das Paket python-docx fehlt. Claude im Chat bitten: „Prüfe, ob Python und python-docx installiert sind, und installiere sie bei Bedarf.“
„Kostenloser Plan“ / kein Zugriff	Claude Code setzt ein bezahltes Abo (Pro oder höher) voraus.

Voneinander lernen: unsere TaskCard

Erfahrungen, Tipps und Tricks aus dem Kollegium – an einem Ort gesammelt.

Einige Kolleginnen und Kollegen arbeiten bereits mit Obsidian und Claude. Damit nicht jede und jeder dieselben Umwege gehen muss, sammeln wir unsere Erfahrungen auf einer gemeinsamen TaskCard: Was hat gut funktioniert? Welcher Auftrag an Claude hat ein richtig gutes Arbeitsblatt hervorgebracht? Wo lag ein Stolperstein – und wie ließ er sich lösen?

Schau gleich nach der Einrichtung einmal hinein – vieles, was du in den ersten Wochen ausprobieren würdest, hat dort vielleicht schon jemand beschrieben. Und wenn du selbst etwas Cooles entdeckst, erweitere die TaskCard mit einer eigenen Karte. So wächst unser gemeinsames Wissen mit jeder Kollegin und jedem Kollegen, die oder der einsteigt.

Zur TaskCard des Kollegiums

TaskCard auf dem Handy oder Tablet öffnen

Was du dort findest

Bewährte Aufträge (Prompts): Formulierungen, mit denen Claude gute Lernsituationen, Arbeitsblätter oder Klausuren erstellt hat
Zeilen für die Hausordnung: Regeln aus anderen CLAUDE.md-Dateien, die sich bewährt haben
Stolpersteine und Lösungen: Installationsprobleme, Fehlermeldungen, Workarounds
Arbeitsabläufe: wie andere vom Rahmenlehrplan zum fertigen Arbeitsblatt kommen

So trägst du etwas bei

Eine Karte pro Tipp: kurze Überschrift, ein, zwei Sätze, wofür der Tipp gut ist
Prompts im Wortlaut einfügen – Platzhalter in [eckigen Klammern], damit andere sie direkt übernehmen können
Auch Fehlschläge zählen: „Das hat nicht geklappt, weil …“ spart anderen Zeit
Spielregeln gelten auch hier: keine Schülerdaten, keine Verlagstexte