Claude Code und Obsidian: ein Vault für dich und deinen Agenten

Warum Claude Code und Obsidian zusammenpassen

Ein Obsidian-Vault ist ein gewöhnlicher Ordner mit Textdateien, ohne Datenbank dazwischen. Deshalb kann ein Agent darin genauso arbeiten wie du.

Claude Code ist ein KI-Agent, der im Terminal, im Editor oder in der Desktop-App läuft und in dem Ordner arbeitet, in dem du ihn startest. Er liest Dateien, legt neue an, ändert bestehende und führt Befehle aus. Startest du ihn in deinem Vault, hat er dein ganzes Second Brain vor sich: Er fasst Besprechungsnotizen zusammen, setzt fehlende Links, sortiert eine Sammlung von Quellen oder schreibt aus deiner Gliederung einen ersten Entwurf, der als neue Notiz im richtigen Ordner landet.

Das gilt nicht nur für Claude Code. Codex, Cursor, Gemini CLI und andere Agenten mit Dateizugriff arbeiten genauso. Ein Chat im Browser dagegen sieht deinen Vault nicht, solange du ihm keine Dateien hineinkopierst.

Claude Code im Vault einrichten

Den Vault als Arbeitsverzeichnis wählen

Claude Code arbeitet im Ordner, in dem du es startest. Liegt dein Vault in iCloud Drive, sieht das im Terminal zum Beispiel so aus:

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vault
claude

Wähle bewusst, wie viel der Agent sehen soll. Für einen ersten Versuch reicht ein Unterordner, etwa dein Ordner für ein Projekt. Sichere den Vault, bevor du größere Umbauten zulässt: Claude Code kann eigene Dateiänderungen zurückdrehen, aber Änderungen über Terminalbefehle erfasst das nicht. Git im Vault oder Time Machine schließen diese Lücke.

Aufgaben aus einem verlinkten Ordner freigeben

Holst du den Datenordner von TandemLoop per symbolischem Link in den Vault, liegt sein echter Ort außerhalb des Arbeitsverzeichnisses, und Claude Code fragt bei jedem Schreiben nach. Gib den Ordner deshalb zusätzlich frei, beim Start mit --add-dir, in einer laufenden Sitzung mit /add-dir oder dauerhaft unter additionalDirectories in den Einstellungen:

claude --add-dir "<TandemLoop-Ordner>"

Wie du den Link anlegst und warum er nur am Mac funktioniert, steht im Ratgeber Second Brain und ToDo-Liste verbinden.

CLAUDE.md: die Regeln für deinen Vault

Zu Beginn jeder Sitzung liest Claude Code die Datei CLAUDE.md im Arbeitsverzeichnis und in den Ordnern darüber. Dort steht, was der Agent über deinen Vault wissen muss und was er darf. Mit dem Befehl /init lässt du einen ersten Entwurf anlegen und verfeinerst ihn danach. Anthropic empfiehlt, die Datei kurz zu halten, möglichst unter 200 Zeilen, und nur aufzuschreiben, was der Agent nicht selbst herausfinden kann.

# Vault

Obsidian-Vault mit Notizen in Markdown. Verweise als Wikilinks [[Notiz]].

## Ordner
- Notizen/: meine Notizen, nur auf Bitte ändern
- Online-Kurs/: Material und Ergebnisse zum Kurs
- TandemLoop/: Datenordner meines ToDo-Managers (Link)

## Regeln
- Keine Notiz löschen oder umbenennen ohne Rückfrage.
- Ergebnisse als neue Notiz im passenden Ordner ablegen.
- Eigenschaften oben in der Datei nicht umbauen.

## Aufgaben
Für Aufgaben zuerst TandemLoop/AGENTS.md lesen und dessen Regeln folgen.

Andere Agenten lesen statt CLAUDE.md meist AGENTS.md. Claude Code liest eine AGENTS.md von sich aus, solange es keine CLAUDE.md findet. Willst du beide nutzen, bindest du die eine Datei mit @AGENTS.md in die andere ein. Wie solche Bedienanleitungen für Agenten aufgebaut sind, steht im Ratgeber Agentic Engineering.

Aufgaben in Obsidian: Checkboxen und Tasks-Plugin

Obsidian kennt Aufgaben als Checkboxen. Eine Zeile wie - [ ] Skript für Lektion 2 schreiben ist eine offene Aufgabe, mit [x] ist sie erledigt. Für eine Obsidian-ToDo-Liste in einer einzelnen Notiz reicht das.

Das Community-Plugin Tasks macht daraus eine Aufgabenverwaltung über den ganzen Vault. Fälligkeit, Priorität und Wiederholung schreibst du als Zeichen in die Zeile, etwa 📅 2026-10-23 für das Fälligkeitsdatum. Erledigst du eine Aufgabe, hängt das Plugin das Datum an; bei wiederkehrenden Aufgaben legt es die nächste Zeile an. Abfragen in einem Codeblock sammeln Aufgaben aus allen Notizen:

```tasks
not done
due next week
```

Die Stärke dieses Ansatzes: Aufgaben stehen dort, wo sie entstehen, mitten in Projektnotizen und Protokollen. Für viele, die ihr Second Brain in Obsidian führen, ist das genug.

Wo das Tasks-Plugin an Grenzen stößt

• Erinnerungen: Das Tasks-Plugin selbst meldet sich nicht. Mitteilungen kommen über ein weiteres Plugin wie Reminder, und dessen Anleitung sagt, dass Systemmitteilungen auf iPhone und Android nicht möglich sind.
• Erfassen unterwegs: Seit iOS 26 bietet Obsidian Quick Capture über Sperrbildschirm, Kontrollzentrum und Widgets. Was du so erfasst, landet als Text in einer Notiz. Datum, Projekt und Zuständigkeit ergänzt du später von Hand.
• Zuweisung: Eine Zeile hat kein Feld dafür, wer zuständig ist. Du kannst dich mit deinem Agenten auf ein Tag wie #agent einigen, aber es gibt keinen Status für „zur Prüfung“ und keinen Platz für sein Ergebnis oder eure Rückfragen.
• Fremde Notizen: Damit der Agent eine Aufgabe abhaken oder ergänzen kann, muss er die Zeile in deiner Notiz ändern. Je mehr Notizen Aufgaben enthalten, desto mehr Dateien fasst er dafür an.

Aufgaben, die du deinem Agenten zuweist

Die Alternative zur Zeile ist eine eigene Aufgabe mit Status, Fälligkeit und Zuständigkeit. Dazu gehören eine Beschreibung mit Ziel und Akzeptanzkriterien und ein Verlauf, in dem dein Agent festhält, was er getan hat.

Für die Zusammenarbeit mit einem Agenten hat das handfeste Vorteile:

• Der Agent ändert eine Aufgabe, ohne deine Notizen anzufassen.
• Zuständigkeit und Status sind eindeutig: Du weist die Aufgabe deinem Agenten zu, und ist er fertig, liegt sie „Zur Prüfung“ bei dir.
• Ergebnisse und Rückfragen stehen an der Aufgabe statt in einem Chatverlauf, der morgen weg ist.

Von Hand will diese Struktur niemand pflegen. Dafür braucht es eine Anleitung für den Agenten und eine App, die daraus Listen, Ansichten und Erinnerungen macht.

Wo TandemLoop hilft: Erfassen, Ansichten, Erinnerungen

TandemLoop ist eine To-do-App für Mac, iPad und iPhone, die genau so arbeitet. Ihr Datenordner, lokal oder in iCloud Drive, kann ein Unterordner deines Vaults sein oder per Link darin auftauchen. Dann arbeitet dein Agent im ganzen Vault, Notizen und Aufgaben eingeschlossen.

• Erfassen: Schnellerfassung, Teilen-Menü, Kontrollzentrum, Kurzbefehle und Siri legen eine richtige Aufgabe an, auf Wunsch gleich für den Agenten.
• Ansichten: Liste, Tabelle, Board, Agenda, Kalender, Multi-View und Dashboard, mit Filtern zum Beispiel nach Zuständigkeit oder Fälligkeit.
• Erinnerungen: Fälligkeit mit Uhrzeit, Mitteilungen mit „Erledigt“, „Später“ und „Morgen“, Widgets auf Home- und Sperrbildschirm.
• Agent: Im Datenordner liegt AGENTS.md, die Bedienanleitung für deinen Agenten. Er hat Zugriff auf alles im Datenordner: Er legt Aufgaben, Projekte, Bereiche und Ansichten an, ändert und verschiebt sie und arbeitet die Aufgaben ab, die ihm zugewiesen sind. Im Freigabemodus legt er nur neue Inbox-Einträge direkt an und alles andere als Vorschlag ab.
• Rückgabe: Ist er fertig oder braucht er etwas von dir, gibt er die Aufgabe zurück. Sie erscheint unter „Zurück vom Agenten“, auf dem iPhone im Tab „Zurück“.

Alles über die Arbeitsteilung mit deinem Agenten, vom Freigabemodus bis zur Rückgabe, steht auf der Seite ToDo-Manager für die Arbeit mit KI-Agenten. Den vollen Funktionsumfang ohne Agent zeigt die Aufgaben-App im Überblick.

Beispiel-Workflow: Inbox → Agent → Ergebnis

Ein Ablauf aus dem Projekt „Online-Kurs“: Die Gliederung steht als Notiz in Obsidian, das Skript für Lektion 2 soll der Agent entwerfen.

1. Erfassen. Auf dem Weg zur Arbeit tippst du „Skript für Lektion 2 schreiben“ in die Schnellerfassung und weist die Aufgabe deinem Agenten zu, mit der Delegation „Entwurf“. Sie liegt in der Inbox.
2. Auftrag. Am Mac startest du Claude Code im Vault und schreibst: „Erledige deine Aufgaben in TandemLoop.“ Er liest die Anleitung, findet die Aufgabe und dazu deine Kursgliederung.
3. Ergebnis an der Aufgabe. Er legt das Skript als Notiz in den Ordner Online-Kurs und schreibt in den Verlauf der Aufgabe, was er getan hat, mit Link auf die Notiz.
4. Zurück vom Agenten. Weil die Delegation „Entwurf“ war, hakt er die Aufgabe nicht selbst ab, sondern gibt sie zur Prüfung zurück. Du liest das Skript in Obsidian und wählst in TandemLoop „Annehmen“ oder „Nacharbeiten lassen“ mit einem Kommentar.
5. Was nur du kannst. Braucht er für den Upload ein bestätigtes Konto bei der Kursplattform, legt er dir „Zugang zur Kursplattform bestätigen“ in die Inbox, statt es in einer langen Antwort zu erwähnen.

Läuft der Agent auf deinem Mac in einer Schleife, etwa mit dem Worker-Skill von TandemLoop und /loop 10m /tandem-worker in Claude Code, arbeitet er solche Aufgaben ab, auch während du unterwegs bist. Schreiben sollte dabei immer nur ein Agent zur selben Zeit.

Welcher Weg zu dir passt

Beides lässt sich mischen: Checklisten für Kleinkram bleiben in deinen Notizen, alles, woran dein Agent mitarbeitet, bekommt eine eigene Aufgabe. Wenn du deine Aufgaben nach Getting Things Done ordnest, zeigt der Ratgeber zur GTD-Methode, welche Schritte dein Agent übernehmen kann.