Obsidian und Claude Code – gemeinsam an Dateien arbeiten

Markdown ist gewöhnlicher Text, in dem ein paar Zeichen die Formatierung übernehmen: Ein Rautezeichen am Zeilenanfang macht die Zeile zur Überschrift, je zwei Sternchen links und rechts machen ein Wort fett, und senkrechte Striche ergeben eine Tabelle. Obsidian, ein kostenloses Notizprogramm, liest diese Zeichen als Formatierung und zeigt dir statt der Zeichen die fertige Seite.

Obsidian brauchst du hier nicht, um jede Datei zu lesen und zu korrigieren, die Claude Code hinterlässt. Es lohnt sich bei den Dateien, an denen ihr zu zweit arbeitet und zu denen du immer wieder zurückkehrst – zum Beispiel beim Entwurf eines Zusammenarbeitsvertrags, noch ohne die Angaben der Vertragsparteien. Claude Code schlägt Absätze und Änderungen vor, und du ergänzt, was nur du weisst. Jede Änderung von Claude Code siehst du in Obsidian sofort, also muss nicht jede Korrektur über Claude Code laufen: Manchmal ist es einfacher, ein Wort in einem Satz direkt in der Datei zu ändern, als Claude Code darum zu bitten, und ihm danach nur Bescheid zu geben. Obsidian stellst du neben das Terminal, und in den Dateien schreibt ihr abwechselnd.

Was Obsidian ist und was diese Lektion weglässt

Obsidian ist ein Programm zum Schreiben und Ordnen von Notizen, die als gewöhnliche Dateien auf deinem Computer liegen. Gedacht ist es für persönliche Wissenssammlungen: Eine Notiz verweist auf die nächste, ein bisschen wie in einer privaten Wikipedia. Meistens baut jemand jahrelang eine Notizsammlung in Obsidian auf und lässt erst danach KI hinein. Bei dir ist es umgekehrt: Die Dateien legt Claude Code an, und du liest sie in Obsidian und bearbeitest sie zusammen mit Claude Code.

Obsidian hat so viele Funktionen, dass sie für einen eigenen Kurs reichen würden. Für die gemeinsame Arbeit brauchst du keine Verbindung zwischen den beiden Programmen, denn beide arbeiten einfach mit denselben Dateien im selben Ordner.

Obsidian ist für jeden Zweck gratis, auch für die Arbeit in einer Firma. Die kommerzielle Lizenz ist freiwillig und dient dazu, dass die Nutzerinnen und Nutzer das Programm selbst finanzieren. Ein Konto brauchst du nicht, und laut der Datenschutzerklärung von Obsidian werden deine Daten lokal auf deinem Computer gespeichert und gelangen nicht auf die Server der Firma.

Obsidian installieren

Lade Obsidian von der offiziellen Seite obsidian.md/download herunter. Dort gibt es Versionen für Windows, macOS und Linux und dazu Apps fürs Handy, die du für diese Lektion nicht brauchst. Lade die Version für dein System herunter, starte das Installationsprogramm und schliess die Installation mit den Standardeinstellungen ab.

Obsidian gibt es auf Deutsch, und wir nennen die Schaltflächen im Folgenden auf Deutsch, mit dem englischen Namen in Klammern. Startet das Programm bei dir auf Englisch, stellst du die Sprache unter Einstellungen → Allgemein → Sprache (Settings → General → Language) um. Die Fenster ändern sich von Version zu Version etwas, also kann dein Bildschirm leicht von der Beschreibung abweichen – halte dich an die Namen der Schaltflächen.

Öffne deinen Ordner als Vault

Ein Vault ist in Obsidian der Ordner, dessen Dateien das Programm anzeigt. Beim ersten Start öffnet Obsidian ein Fenster, in dem du einen Vault auswählst. Die Dateien von Claude Code liegen schon in deinem Arbeitsordner, also wird genau dieser Ordner zum Vault und kein neuer, leerer:

1. Klicke bei Ordner als Vault öffnen (Open folder as vault) auf Öffnen (Open).
2. Wähle den Ordner, in dem du Claude Code startest – den, in dem die Datei CLAUDE.md liegt.
3. Bestätige die Auswahl im Fenster für die Ordnerauswahl.

Wenn CLAUDE.md in deinem Arbeitsordner liegt, links im Fenster aber nicht angezeigt wird, hat Obsidian einen anderen Ordner geöffnet. Klicke unten links auf das Vault-Symbol, wähle Vaults verwalten… (Manage vaults…) und öffne den richtigen Ordner noch einmal.

Im geöffneten Ordner legt Obsidian einen versteckten Ordner .obsidian mit seinen Einstellungen an. Lass ihn in Ruhe. Claude Code erfährt davon über den Eintrag in CLAUDE.md, den du am Ende der Lektion machst.

Öffne CLAUDE.md und lies die Datei in Obsidian

Den Baum der Ordner und Dateien aus deinem Arbeitsordner zeigt Obsidian links im Fenster. Klicke dort auf CLAUDE.md. Es ist dieselbe Datei, die in einem einfachen Texteditor wie dem Windows-Editor voller Rautezeichen und Sternchen steckt. Hier sind die Überschriften grösser, fette Stellen fett, und die Tabelle, die im Editor ein Gewirr aus Strichen war, hat Zeilen und Spalten.

Eine angeklickte Datei öffnet Obsidian standardmässig im Bearbeitungsmodus. Sie sieht dort schon formatiert aus, weil die meisten Markdown-Zeichen verschwinden, und du kannst den Text gleich korrigieren. Willst du die Datei nur lesen, wechselst du mit dem Tastenkürzel Ctrl+E (auf macOS Cmd+E) in die Leseansicht (Reading view), die nur den formatierten Inhalt zeigt. Dasselbe Kürzel bringt dich zurück zum Bearbeiten.

Die grosse Schrift über dem Inhalt ist keine Überschrift, sondern der Dateiname. Obsidian lässt dich ihn dort ändern, und jede Korrektur an dieser Schrift benennt die Datei auf der Festplatte um. Diese Schrift liest du nur.

Word- und Excel-Dateien erscheinen im Baum links standardmässig nicht. Obsidian zeigt die Formate, die es öffnen kann: Markdown, Bilder, PDF, Aufnahmen und seine eigenen Canvas-Dateien. Offerten und Preislisten bleiben auf der Festplatte, wo sie waren, und du öffnest sie wie bisher. Ein PDF dagegen, etwa die Preisliste eines Lieferanten, liest du im selben Fenster wie deine Notizen. Weitere Funktionen bringen Externe Erweiterungen (Community plugins), die du in den Einstellungen von Obsidian einschaltest – für diese Lektion brauchst du keine.

Datei- und Ordnernamen ändert Claude Code

Der Dateibaum in Obsidian verleitet dazu, den Ordner nach eigenem Geschmack aufzuräumen: eine Datei in einen anderen Ordner ziehen, einen Namen korrigieren. Das Verschieben und Umbenennen von Dateien überlässt du Claude Code, und zwar nicht nur in Obsidian, sondern auch im Datei-Explorer unter Windows oder im Finder auf macOS. CLAUDE.md und die Notizen, die Claude Code schreibt, sagen ihm, wo was liegt – zum Beispiel «die Vorlagen für Offerten sind im Ordner offerten».

Claude Code ist hier wie eine Assistenz, die weiss, dass der Vertrag mit dem Grosshändler im Nebenraum liegt, im dritten Regal von oben. Trägst du ihn selbst in einen anderen Raum, geht die Assistenz morgen zum dritten Regal und kommt mit leeren Händen zurück. Bittest du sie, ihn an einen anderen Ort zu bringen und aufzuschreiben, wo er jetzt liegt, geht sie morgen direkt an den neuen Ort.

Beim Umbenennen eines Ordners ist es genauso, nur betrifft es alle Dateien darin auf einmal. Das Verschieben oder Umbenennen gibst du deshalb im Gespräch in Auftrag:

Verschiebe die Datei sitzungsnotizen.md in den Ordner sitzungen, und wenn es diesen Ordner nicht gibt, leg ihn an. Geh danach CLAUDE.md und die anderen Dateien durch, in denen du festhältst, wo was liegt, und korrigiere jede Stelle mit dem alten Pfad.

Die Datei- und Ordnernamen in diesem Prompt sind ein Beispiel – setz deine eigenen ein. Genauso bittest du um einen neuen Dateinamen. Und wenn eine Datei schon von Hand verschoben wurde, schreib Claude Code, woher sie kam und wohin sie ging, und füge den zweiten Satz des Prompts ein, den über das Korrigieren der Pfade.

Ein Name ändert sich nie: CLAUDE.md, in Grossbuchstaben, mit .md am Ende. Unter diesem Namen sucht Claude Code zu Beginn eines Gesprächs die Datei mit seinen Anweisungen, und eine anders benannte Datei, zum Beispiel anweisungen.md, bleibt für Claude Code eine gewöhnliche Notiz.

Sieh die Änderung live und korrigiere die Datei selbst

Stell das Fenster von Obsidian neben das Terminalfenster, sodass du beide gleichzeitig siehst. Obsidian aktualisiert den Vault, sobald ein anderes Programm eine Datei ändert, also musst du nichts schliessen und neu öffnen. Probier es an einer Datei aus, die Claude Code vor deinen Augen anlegt:

Leg die Datei tagesplan.md mit meinem Plan für heute an: den Grosshändler wegen der Preisliste zurückrufen, einer neuen Kundin eine Offerte schicken, die Vertragsvorlage durchsehen. Schreib das als Liste zum Abhaken.

Sobald tagesplan.md links im Baum erscheint, klicke die Datei in Obsidian an. Dann bitte Claude Code um einen Nachtrag:

Ergänze in tagesplan.md: um 15 Uhr Gespräch mit dem Lieferanten.

Der neue Punkt erscheint in Obsidian, sobald Claude Code die Datei fertig gespeichert hat. Ändert sich in Obsidian nichts, frag Claude Code nach dem vollständigen Pfad der Datei, die es geändert hat, und prüf, ob diese Datei im Ordner liegt, den du als Vault geöffnet hast. Liegt sie woanders, arbeitet Claude Code in einem anderen Ordner als dem, den Obsidian zeigt – beende dann Claude Code und starte es im Ordner, den du als Vault geöffnet hast.

Jetzt bist du dran. Ändere in tagesplan.md in Obsidian ein Wort, zum Beispiel «zurückrufen» in «anrufen»: Klicke in den Text und korrigiere ihn wie in jedem Editor. Ist die Datei in der Leseansicht, schalte sie zuerst mit Ctrl+E (auf macOS Cmd+E) um. Dann gib Claude Code Bescheid:

In tagesplan.md steht eine Korrektur von mir: Ich habe ein Wort von Hand geändert. Lies die Datei noch einmal, bevor du etwas darin änderst.

In einer Datei schreibt ihr nie gleichzeitig. Wir sehen in unseren Kursen, wie es endet, wenn in einer Datei zwei gleichzeitig schreiben: Ein Satz, den Claude Code kurz vorher ergänzt hat, wird in Obsidian gelöscht, und bei der nächsten Änderung sucht Claude Code danach und versteht nicht, wohin er verschwunden ist. Korrigiere also dann, wenn Claude Code fertig ist, und sag ihm nach jeder eigenen Änderung Bescheid, bevor du um die nächste bittest. Auch das Abhaken eines Listenpunkts in Obsidian ist eine Änderung an der Datei.

Graph-Ansicht und Canvas

Die Graph-Ansicht (Graph view) zeichnet jede Markdown-Datei als Punkt und jeden Link zwischen Dateien als Strich. Du öffnest sie mit der Schaltfläche Graph-Ansicht öffnen (Open graph view) in der Seitenleiste links im Fenster. In einem Ordner, in dem die Dateien nicht aufeinander verweisen, besteht der Graph nur aus losen Punkten. Striche kommen dazu, sobald in den Notizen Verweise auf andere Dateien auftauchen, zum Beispiel wenn du Claude Code bittest, in den Notizen auf die Dateien zu verweisen, auf denen die Notizen beruhen.

Ein Canvas ist in Obsidian eine unbegrenzte Fläche, auf der du Karten mit Notizen anordnest. Obsidian speichert ihn als Datei mit der Endung .canvas, in einem offenen Format, also legt Claude Code ihn genauso an wie jede andere Datei:

Mach aus der Datei tagesplan.md einen Obsidian-Canvas in der Datei tagesplan.canvas: jede Aufgabe auf einer eigenen Karte, angeordnet vom Morgen bis zum Nachmittag.

Klicke links im Baum auf tagesplan.canvas. Die Karten kannst du verschieben, und wenn du eine Karte markierst, erscheinen daneben Schaltflächen, darunter eine zum Ändern der Farbe. Auch das Verschieben einer Karte ist eine Änderung an der Datei, also schreibt ihr auch hier nie gleichzeitig: Ordne die Karten an, während Claude Code nichts tut, und schreib ihm danach, dass du die Karten im Canvas neu angeordnet hast.

Sag Claude Code, dass du Obsidian verwendest

Claude Code weiss nicht, dass du seine Dateien in Obsidian liest und korrigierst, solange du es ihm nicht schreibst. Ein Eintrag in CLAUDE.md genügt, denn diese Datei liest Claude Code zu Beginn jedes Gesprächs:

Halte in CLAUDE.md fest, dass ich die Dateien in diesem Ordner in Obsidian lese und korrigiere. Ergänze drei Regeln: Bevor du eine Datei änderst, liest du sie neu, weil meine Korrekturen darin stehen können; den Ordner .obsidian änderst du nicht, weil er die Einstellungen von Obsidian enthält; Namen und Orte von Dateien änderst du nur auf meine Bitte und korrigierst sofort die Pfade in deinen Dateien.

Ob der Eintrag wirkt, prüfst du in einem neuen Gespräch: Tippe /exit, um Claude Code zu beenden, starte es mit dem Befehl claude im selben Ordner neu und frag, was es über den Ordner .obsidian weiss. Erwähnt die Antwort die Einstellungen von Obsidian nicht, bitte Claude Code, dir den Eintrag in CLAUDE.md zu zeigen, und lies ihn in Obsidian.

Was du aus dieser Lektion mitnimmst

• Mit Claude Code schreibst du abwechselnd. Claude Code schlägt vor und ergänzt, und du liest und korrigierst Kleinigkeiten direkt in der Datei, weil es schneller geht, ein Wort selbst zu ändern, als Claude Code darum zu bitten.
• Dein Arbeitsordner wird zum Vault, nicht ein neuer, leerer Ordner – nur dann zeigt Obsidian die Dateien, an denen Claude Code arbeitet.
• Die Schrift über dem Inhalt einer Datei ist ihr Name, und jede Korrektur daran benennt die Datei auf der Festplatte um.
• Namen und Orte von Dateien ändert Claude Code, auf deine Bitte, und korrigiert sofort die gespeicherten Pfade. CLAUDE.md bleibt CLAUDE.md, in Grossbuchstaben.
• In einer Datei schreibt ihr nie gleichzeitig, und wenn du etwas von Hand korrigierst, sagst du es Claude Code vor der nächsten Änderung.

Aufgaben

Hake ab, was du erledigt hast. Der Stand bleibt im Browser gespeichert, also kannst du morgen zu dieser Liste zurückkehren.

• Obsidian von obsidian.md heruntergeladen und installiert
• Arbeitsordner als Vault geöffnet, die Datei CLAUDE.md links im Baum sichtbar
• CLAUDE.md in der Leseansicht gelesen
• Eine Datei von Claude Code verschoben oder umbenannt, die Pfade in CLAUDE.md korrigiert
• Der Nachtrag in tagesplan.md in Obsidian sichtbar, ohne die Datei neu zu öffnen
• Ein Wort in tagesplan.md in Obsidian von Hand korrigiert und Claude Code darüber informiert
• Der Canvas tagesplan.canvas in Obsidian geöffnet
• Der Eintrag zu Obsidian in CLAUDE.md in einem neuen Gespräch geprüft