Claude Code en Obsidian: één vault voor jou en je agent

Waarom Claude Code en Obsidian bij elkaar passen

Een Obsidian-vault is een gewone map met tekstbestanden, zonder database ertussen. Daarom kan een agent er net zo in werken als jij.

Claude Code is een AI-agent die in de terminal, in je editor of in de desktopapp draait en werkt in de map waarin je hem start. Hij leest bestanden, maakt nieuwe aan, wijzigt bestaande en voert commando’s uit. Start je hem in je vault, dan ligt je hele second brain voor hem open: hij vat vergadernotities samen, vult ontbrekende links aan, ordent een verzameling bronnen of maakt van je opzet een eerste versie die als nieuwe notitie in de juiste map belandt.

Dit is niet beperkt tot Claude Code. Codex, Cursor, Gemini CLI en andere agents met bestandstoegang werken op dezelfde manier. Een chat in de browser ziet je vault daarentegen niet, tenzij je er bestanden in kopieert.

Claude Code instellen in je vault

Gebruik je vault als werkmap

Claude Code werkt in de map waarin je hem start. Staat je vault in iCloud Drive, dan ziet dat er in de terminal bijvoorbeeld zo uit:

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

Bepaal bewust hoeveel de agent mag zien. Voor een eerste poging volstaat een submap, zoals de map van één project. Maak een reservekopie van je vault voordat je grotere wijzigingen toestaat: Claude Code kan zijn eigen bestandswijzigingen terugdraaien, maar geen wijzigingen via terminalcommando’s. Git in je vault of Time Machine dicht dat gat.

Geef toegang tot taken in een gekoppelde map

Haal je de gegevensmap van TandemLoop met een symbolische link in je vault, dan ligt de echte locatie buiten de werkmap en vraagt Claude Code bij elke schrijfactie om toestemming. Geef hem daarom ook toegang tot die map: bij het starten met --add-dir, in een lopende sessie met /add-dir of blijvend onder additionalDirectories in de instellingen:

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

Hoe je de link aanmaakt en waarom dat alleen op een Mac werkt, lees je in de gids Je second brain en je to-dolijst verbinden.

CLAUDE.md: de regels voor je vault

Aan het begin van elke sessie leest Claude Code het bestand CLAUDE.md in de werkmap en in de mappen daarboven. Daarin staat wat de agent over je vault moet weten en wat hij mag doen. Met /init maak je een eerste versie, die je daarna verfijnt. Anthropic raadt aan het bestand kort te houden, bij voorkeur onder de 200 regels, en alleen op te schrijven wat de agent niet zelf kan achterhalen.

# Vault

Obsidian-vault met notities in Markdown. Links als wikilinks [[Notitie]].

## Mappen
- Notities/: mijn notities, alleen op verzoek wijzigen
- Onlinecursus/: materiaal en resultaten voor de cursus
- TandemLoop/: gegevensmap van mijn to-do-app (link)

## Regels
- Verwijder of hernoem nooit een notitie zonder te vragen.
- Bewaar resultaten als nieuwe notitie in de passende map.
- Herstructureer de eigenschappen bovenaan een bestand niet.

## Taken
Lees voor taken eerst TandemLoop/AGENTS.md en volg de regels daarin.

Andere agents lezen meestal AGENTS.md in plaats van CLAUDE.md. Claude Code leest zelf een AGENTS.md zolang hij geen CLAUDE.md vindt. Wil je beide gebruiken, neem dan het ene bestand in het andere op met @AGENTS.md. Hoe zulke handleidingen voor agents zijn opgebouwd, lees je in de gids Agentic engineering.

Obsidian-taken: selectievakjes en de Tasks-plug-in

Obsidian behandelt taken als selectievakjes. Een regel als - [ ] Script voor les 2 schrijven is een openstaande taak; met [x] is hij voltooid. Voor een to-dolijst binnen één notitie is dat genoeg.

De communityplug-in Tasks maakt daar takenbeheer voor je hele vault van. Vervaldatum, prioriteit en herhaling schrijf je als symbolen in de regel, zoals 📅 2026-10-23 voor de vervaldatum. Voltooi je een taak, dan voegt de plug-in de datum toe; bij herhalende taken maakt hij de volgende regel aan. Query’s in een codeblok verzamelen taken uit al je notities:

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

De kracht van deze aanpak: taken staan waar ze ontstaan, direct in projectnotities en verslagen. Voor veel mensen die hun second brain in Obsidian bijhouden, is dat genoeg.

Waar de Tasks-plug-in tegen zijn grenzen aanloopt

• Herinneringen: de Tasks-plug-in zelf geeft geen meldingen. Meldingen komen van een andere plug-in, zoals Reminder, en volgens de documentatie daarvan zijn systeemmeldingen op iPhone en Android niet mogelijk.
• Onderweg vastleggen: sinds iOS 26 biedt Obsidian Quick Capture vanaf het toegangsscherm, het bedieningspaneel en widgets. Wat je zo vastlegt, belandt als tekst in een notitie. Datum, project en wie verantwoordelijk is, vul je later met de hand aan.
• Toewijzing: een regel heeft geen veld voor wie verantwoordelijk is. Je kunt met je agent een tag als #agent afspreken, maar er is geen status voor “ter controle” en geen plek voor zijn resultaat of jullie vragen aan elkaar.
• Jouw notities, niet die van de agent: om een taak af te vinken of aan te vullen, moet de agent de regel in jouw notitie wijzigen. Hoe meer notities taken bevatten, hoe meer bestanden hij daarvoor aanraakt.

Obsidian-taken met Claude Code: wijs ze toe aan je agent

Het alternatief voor een regel is een eigen taak met een status, een vervaldatum en iemand aan wie ze is toegewezen. Daarbij horen een beschrijving van het doel en acceptatiecriteria, en een logboek waarin je agent vastlegt wat hij heeft gedaan.

Als je met een agent werkt, heeft dat concrete voordelen:

• De agent wijzigt een taak zonder je notities aan te raken.
• Verantwoordelijkheid en status zijn duidelijk: je wijst de taak toe aan je agent, en als hij klaar is, komt de taak als “Ter controle” bij je terug.
• Resultaten en vragen blijven bij de taak in plaats van in een chatgeschiedenis die morgen weg is.

Niemand wil deze structuur met de hand bijhouden. Daarvoor zijn een handleiding voor de agent nodig en een app die van de bestanden lijsten, weergaven en herinneringen maakt.

Waar TandemLoop helpt: vastleggen, weergaven, herinneringen

TandemLoop is een to-do-app voor Mac, iPad en iPhone die precies zo werkt. De gegevensmap, lokaal of in iCloud Drive, kan een submap van je vault zijn of daar via een link verschijnen. Je agent werkt dan in de hele vault, notities en taken inbegrepen.

• Vastleggen: snelle invoer, het deelmenu, het bedieningspaneel, Opdrachten en Siri maken een echte taak aan, desgewenst meteen voor je agent.
• Weergaven: lijst, tabel, bord, agenda, kalender, multiweergave en dashboard, met filters, bijvoorbeeld op toewijzing of vervaldatum.
• Herinneringen: vervaldatums met tijd, meldingen met “Voltooi”, “Later” en “Morgen”, en widgets op het beginscherm en het toegangsscherm.
• Agent: de gegevensmap bevat AGENTS.md, de handleiding voor je agent. De agent heeft toegang tot alles in de gegevensmap: hij maakt taken, projecten, gebieden en weergaven aan, wijzigt en verplaatst ze en werkt aan de taken die aan hem zijn toegewezen. Met voorstellen ingeschakeld zet hij alleen nieuwe items direct in de Inbox en legt hij al het andere vast als voorstel.
• Teruggave: is hij klaar of heeft hij iets van je nodig, dan geeft hij de taak terug. De taak verschijnt onder Terug van de agent, op de iPhone in de tab Terug.

Alles over werk verdelen met je agent, van voorstellen tot teruggaven, staat op de pagina To-do-app om met AI-agents te werken. Alle functies zonder agent vind je in het overzicht van de to-do-app.

Voorbeeldworkflow: Inbox → agent → resultaat

Een workflow uit het project “Onlinecursus”: de opzet is een notitie in Obsidian, en de agent moet het script voor les 2 opstellen.

1. Vastleggen. Onderweg naar je werk typ je “Script voor les 2 schrijven” in snelle invoer en wijs je de taak toe aan je agent met de delegatie Concept. Ze komt in de Inbox terecht.
2. Instructie. Op je Mac start je Claude Code in je vault en typ je: “Werk je taken in TandemLoop af.” Hij leest de handleiding, vindt de taak en ook je cursusopzet.
3. Resultaat bij de taak. Hij bewaart het script als notitie in de map Onlinecursus en schrijft in het logboek van de taak wat hij heeft gedaan, met een link naar de notitie.
4. Terug van de agent. Omdat de delegatie Concept was, voltooit hij de taak niet zelf, maar geeft hij haar ter controle terug. Je leest het script in Obsidian en kiest in TandemLoop Accepteer, of Laat verbeteren met een opmerking.
5. Wat alleen jij kunt doen. Heeft hij voor de upload een bevestigd account op het cursusplatform nodig, dan zet hij “Bevestig de toegang tot het cursusplatform” in je Inbox in plaats van het in een lang antwoord te noemen.

Draait de agent in een lus op je Mac, bijvoorbeeld met de worker-skill van TandemLoop en /loop 10m /tandem-worker in Claude Code, dan werkt hij zulke taken ook af als je weg bent. Er zou steeds maar één agent tegelijk moeten schrijven.

Welke aanpak bij je past

Je kunt beide combineren: checklists voor kleine dingen blijven in je notities, en alles waaraan je agent werkt, krijgt een eigen taak. Orden je je taken met Getting Things Done, dan laat de gids over de GTD-methode zien welke stappen je agent kan overnemen.