Claude koppelen aan Obsidian: zo doe je het, stap voor stap

Kies je route

Claude en Obsidian koppelen: drie routes en welke bij jou past

Een Obsidian-vault is gewoon een map met Markdown-bestanden op je computer. Obsidian zegt dat zelf: je notities zijn platte tekstbestanden, dus andere programma's kunnen ermee werken. Daarom kan Claude er op meerdere manieren bij. Welke route past, hangt af van hoeveel controle je wilt en of je een terminal durft te openen.

De beslisregel

Wil je Claude je vault laten ordenen, linken en bijhouden, kies dan route 1. Claude Code is gebouwd om in een map met bestanden te werken en heeft een ingebouwde terugdraaiknop. Open je nooit een terminal en wil je vooral vragen stellen over je notities of een map laten opruimen, kies dan route 2. Kies route 3 alleen als je een reden hebt die de eerste twee niet dekken, bijvoorbeeld omdat je Claude op je actieve notitie wilt laten reageren of Obsidian-commando's wilt laten uitvoeren. Een plugin uit route 4 zet je er pas bij als route 1 al werkt: ze draaien zelf op Claude Code.

Cowork bestaat niet meer als apart onderdeel

Veel video's uit 2026 zeggen "zet Claude in Cowork-modus en wijs je vault aan". Sinds september 2026 zijn chat en Cowork samengevoegd tot één Claude. Je kiest geen aparte modus meer. In de desktop-app heet het onderdeel nu Files and folders, en mappen die je hebt vrijgegeven staan in Settings onder Trusted folders. Zie je in je berichtvenster nog aparte knoppen voor Chat en Cowork, dan heeft je account de nieuwe versie nog niet. Meer achtergrond staat op Claude Cowork.

Wat heb je nodig

Wat heb je nodig voor Claude in Obsidian?

Dit is de lijst voor route 1, Claude Code in je vault. Alles staat erin wat je nodig hebt om binnen een halfuur een eerste taak te laten uitvoeren. Voor de andere routes staat het verschil in de laatste kolom.

Kosten in het kort

Obsidian zelf kost niets. Obsidian vraagt organisaties wel om een commerciële licentie, maar zegt erbij dat je daartoe niet verplicht bent. Obsidian Sync is optioneel. Het Claude-deel valt binnen je bestaande abonnement: je verbruik in Claude Code telt mee in dezelfde limiet als je chats. Welk plan bij je past, lees je op Claude abonnementen.

Voor je begint

Eerst een backup, en wat er niet in je vault hoort

Claude Code schrijft ook in je bestanden. Eén verkeerd begrepen opdracht ("ruim de map Klanten op") kan honderd notities tegelijk aanpassen. Daarom regel je twee dingen voordat Claude iets mag wijzigen: een backup die je kunt terugzetten, en een vault waar niets in staat dat er niet hoort.

Optie A: Git, de beste backup voor dit werk

Git houdt elke wijziging per bestand bij, zodat je precies ziet wat Claude heeft veranderd en elke stap kunt terugdraaien. Installeer in Obsidian de community-plugin Git van Vinzent03 (12,2k sterren op GitHub op 28 oktober 2026). Die maakt automatisch commits, een soort momentopnames, op een schema. Werk je liever zonder plugin, vraag Claude Code dan in je eerste sessie: Maak van deze map een git-repository en commit alles als startpunt. Zet je vault daarna niet in een openbare GitHub-repository: dan staan je klantnotities online.

Optie B: Obsidian Sync of File recovery

Gebruik je Obsidian Sync, dan heb je versiegeschiedenis per notitie: selecteer de notitie, kies Open version history, kies een versie en klik Restore. Hoe lang versies bewaard blijven hangt af van je Sync-abonnement. Zonder Sync is er de ingebouwde plugin File recovery (Settings, Core plugins, File recovery). Die maakt standaard hooguit elke 5 minuten een momentopname en bewaart die 7 dagen. Obsidian zegt er zelf bij dat dit geen volledige backup is. Het vangt dus een ongeluk op, maar geen grote verbouwing van je hele vault.

Optie C: kopieer de map

De simpelste backup werkt ook: kopieer je hele vault-map naar een andere plek voordat je begint, met de datum in de naam. Doe dat opnieuw voor elke grote opdracht. Het nadeel: je ziet niet per bestand wat er veranderd is.

Wat je niet in je vault zet

Wachtwoorden, API-sleutels en inlogcodes: die horen in een wachtwoordmanager. Alles in je vault kan in een prompt naar Anthropic gaan zodra Claude dat bestand leest. Persoonsgegevens waarvoor je geen grond hebt: een klantnotitie met naam, functie en afspraken is meestal te verdedigen, een notitie over iemands gezondheid of privéomstandigheden niet. Onder de AVG mag je alleen verwerken wat je voor een duidelijk doel nodig hebt. Bestanden van anderen die onder een geheimhoudingsafspraak vallen. Twijfel je over een map, zet hem dan buiten de vault of buiten de map waar Claude in werkt.

Check je privacy-instelling

Op Free, Pro en Max mag Anthropic je gesprekken gebruiken om modellen te trainen, tenzij je de instelling Help Improve Claude uitzet. Op Team en Enterprise gebeurt dat standaard niet. Werk je met klantnotities, zet die instelling dan uit voordat je begint. De details per plan staan op Claude privacy en zakelijk gebruik.

Stap voor stap

Claude Code in je Obsidian-vault starten, stap voor stap

Dit is route 1. Je installeert Claude Code, opent het in de map van je vault en laat het eerst alleen kijken. Pas als je ziet dat Claude je structuur snapt, mag het iets veranderen. Nooit eerder een terminal gebruikt? De installatiepagina loopt elk scherm met je door.

Liever zien wat er openstaat in Obsidian?

Installeer in Obsidian de community-plugin Claude Code IDE (Settings, Community plugins, Browse). Typ daarna in Claude Code /ide en kies Obsidian. Claude ziet dan welke notitie je openhebt en welke tekst je hebt geselecteerd. De plugin zelf schrijft niets; Claude Code bewerkt de bestanden op schijf, zonder vergelijkingsweergave in Obsidian. Op 28 oktober 2026 had de plugin ongeveer 21.000 downloads.

CLAUDE.md

Een CLAUDE.md voor je Obsidian second brain

Een CLAUDE.md is een gewoon tekstbestand in de hoofdmap van je vault. Claude Code laadt het aan het begin van elke sessie. Anthropic adviseert om het onder de 200 regels te houden: hoe langer het bestand, hoe slechter Claude zich aan de regels houdt. Hieronder een voorbeeld voor een MKB-ondernemer met klantnotities, meetingnotities en een kennisbank.

Voorbeeld om te kopiëren en aan te passen

# Vault van [jouw bedrijf]

## Structuur
- 00 Inbox: nieuwe, ongesorteerde notities
- 10 Klanten: één map per klant, per gesprek een notitie met de naam JJJJ-MM-DD Onderwerp
- 20 Meetings: altijd met datum, deelnemers, besluiten en acties
- 30 Kennisbank: hoe wij werken (offertes, onboarding, tarieven)
- 90 Archief

## Regels
- Verwijder nooit een bestand. Verplaats het naar 90 Archief.
- Hernoem of verplaats niets zonder het eerst te vragen.
- Verwijs naar klanten en notities met [[wikilinks]].
- Schrijf in het Nederlands, kort en zakelijk.
- Kom niet aan de map .obsidian.
- Zet nooit wachtwoorden, BSN-nummers of gezondheidsinformatie in een notitie.
- Twijfel je, stel dan eerst een vraag.

Waarom deze regels

Nooit verwijderen, wel archiveren omdat een verwijderd bestand buiten Git of Sync lastig terug te halen is. Eerst vragen bij hernoemen omdat Obsidian links alleen automatisch bijwerkt als je binnen Obsidian hernoemt (Settings, Files and links, Automatically update internal links). Als Claude Code een bestand buiten Obsidian om hernoemt, kun je daar niet op rekenen. Laat Claude dan zelf alle [[links]] naar dat bestand meezoeken en aanpassen, of hernoem het zelf in Obsidian. Niet aan .obsidian komen omdat daar je instellingen en plugins staan; een kapotte instelling daar merk je pas als Obsidian raar doet.

Extra: Obsidian-skills voor Claude Code

De repository kepano/obsidian-skills (50,3k sterren op GitHub op 28 oktober 2026) leert Claude Code onder meer Obsidian-Markdown met wikilinks en callouts, Bases-bestanden, JSON Canvas en de Obsidian CLI. Installeer hem in Claude Code met /plugin marketplace add kepano/obsidian-skills en daarna /plugin install obsidian@obsidian-skills. Handig als Claude je opmaak verkeerd schrijft. Wat skills zijn, lees je op Claude skills.

Werkt het?

Werkt het? De eerste prompt en hoe je het controleert

Je eerste prompt leest alleen. Zo test je of Claude je vault goed ziet, zonder risico. Plak deze prompt in Claude Code terwijl plan mode aanstaat.

Eerste prompt om te plakken

Je bent mijn assistent voor deze Obsidian-vault. Ik ben ondernemer en gebruik deze vault voor klantnotities, meetingnotities en een kennisbank.

Doe het volgende, en wijzig nog niets:
1. Geef de mappenstructuur op het hoogste niveau, met per map het aantal notities.
2. Noem de 5 klanten met de meeste notities.
3. Zoek meetingnotities zonder kopje Acties of zonder datum in de bestandsnaam.
4. Zoek notities waar andere notities naar linken maar die niet bestaan.
5. Stel 3 regels voor die ik in CLAUDE.md kan zetten om deze vault netter te houden.

Noem bij elke bevinding de bestandsnaam, zodat ik het in Obsidian kan nakijken.

Zo zie je dat het werkt

Klopt het aantal mappen met je bestandenlijst in Obsidian? Zijn de bestandsnamen die Claude noemt echt te vinden met de zoekfunctie in Obsidian? Dan leest Claude je vault goed. Noemt Claude mappen die je niet kent, dan staat Claude Code waarschijnlijk in de verkeerde map: sluit af met /exit en ga terug naar stap 3. De regel "noem de bestandsnaam" is het belangrijkste deel van de prompt. Zonder die regel kan Claude een samenvatting geven die klinkt als jouw vault, maar die je niet kunt controleren.

De eerste schrijfopdracht

Kies iets kleins en omkeerbaars, zoals: Maak in 20 Meetings voor elke notitie van deze maand een kopje Acties met de afspraken uit de tekst, als dat kopje nog ontbreekt. Verander verder niets. Toon eerst het plan. Controleer de eerste drie notities in Obsidian. Klopt het, laat Claude de rest doen. Klopt het niet, gebruik /rewind en maak je opdracht specifieker.

MCP en plugins

Obsidian MCP: Claude Desktop koppelen via de Local REST API

Een MCP-server is een programma dat Claude extra gereedschap geeft, in dit geval toegang tot Obsidian zelf in plaats van alleen de bestanden. De community-plugin Local REST API van coddingtonbear (3,1k sterren op 28 oktober 2026) heeft er een ingebouwd. Die server biedt 20 tools, onder meer lezen, schrijven, zoeken, tags opvragen, Obsidian-commando's uitvoeren en de actieve notitie ophalen. De maker schrijft dat losse Obsidian-MCP-servers daardoor niet meer nodig zijn.

Waarom dit niet onze eerste keus is

Deze route heeft meer onderdelen die stuk kunnen: Obsidian moet draaien, het certificaat moet kloppen en de sleutel moet goed in je configuratie staan. Claude Code in je vault heeft dat allemaal niet nodig en kan terugdraaien met /rewind. De MCP-route is wel sterker als je Obsidian-commando's wilt laten uitvoeren of met de notitie wilt werken die je op dat moment openhebt. Hoe MCP in het algemeen werkt, staat op Claude MCP en in de tutorial een MCP-server toevoegen.

Andere MCP-servers en plugins

mcp-obsidian van MarkusPfundstein (4,5k sterren) is een oudere, losse MCP-server die ook op de Local REST API-plugin draait. Claudian (plugin-id realclaudian, 2,5 miljoen downloads op 28 oktober 2026) zet een chatpaneel in Obsidian dat Claude Code of een andere lokale agent gebruikt, met inline bewerken en een voorbeeld van de wijziging. Dat vraagt Obsidian 1.13 of nieuwer en werkt alleen op desktop. Allemaal community-projecten: kijk vóór installatie wie de maker is en wanneer de laatste update was.

En route 2, zonder terminal?

In de Claude desktop-app geef je Claude toegang tot een map via de mapkeuze in het berichtvenster. Kies je vault-map. Claude kan daarin lezen, ordenen en nieuwe bestanden maken. Standaard vraagt Claude toestemming voordat het bestanden definitief verwijdert. In het berichtvenster kies je tussen Auto en Manual; zet hem op Manual zolang je nog test, dan vraagt Claude vaker om bevestiging. Lokale bestanden zijn alleen bereikbaar zolang de app openstaat. Zie ook Claude Desktop.

Problemen

Claude en Obsidian werken niet samen? Melding, oorzaak, oplossing

Dit zijn de problemen die je bij de eerste opzet het vaakst tegenkomt. Zoek je melding of je symptoom in de eerste kolom.

Ons oordeel

Ons oordeel: wanneer Claude in Obsidian loont en wanneer niet

Claude in je vault is het sterkst bij werk dat je nu laat liggen omdat het saai is: notities ordenen, links leggen, acties uit meetings halen. Het is zwakker als je er een systeem van wilt maken dat je hele team gebruikt.

Wel doen

Je bent ondernemer of zzp'er en je kennis staat al in Obsidian, of in losse bestanden die je erin wilt zetten. Je wilt na een klantgesprek in één opdracht een nette notitie met acties, gekoppeld aan de klant. Je wilt vragen kunnen stellen als "wat heb ik vorig jaar met deze klant afgesproken over tarieven?" en een antwoord met bestandsnaam terugkrijgen. Dan levert dit je wekelijks tijd op, omdat Claude het zoek- en ordenwerk doet dat je nu uitstelt.

Niet doen

Je werkt met een team in SharePoint, Teams of een CRM. Dan staat je kennis al ergens anders en wordt Obsidian een tweede plek die niemand bijhoudt. Kijk dan naar Claude met connectors naar die systemen. Ook niet als je vault gevoelige persoonsgegevens bevat waarvoor je geen verwerkersovereenkomst met Anthropic hebt. Op Team en Enterprise is die er wel; op Pro en Max werk je onder de consumentenvoorwaarden.

De fout die we het vaakst zien

Beginners laten Claude in de eerste sessie meteen "de hele vault opruimen". Claude doet dat ijverig: het hernoemt, verplaatst en voegt mappen samen. Daarna werken de helft van de links niet meer en weet je niet meer waar iets staat. Begin daarom altijd met een leesopdracht, daarna één map, en pas na een week met de rest. Een vaste mappenstructuur in CLAUDE.md voorkomt dat Claude elke sessie een eigen indeling bedenkt.

Een MKB-voorbeeld

Een eigenaar van een installatiebedrijf met vijf medewerkers houdt per klant een map bij in Obsidian. Na elk klantbezoek spreekt hij een memo in en zet de uitgeschreven tekst in 00 Inbox. Eén keer per dag geeft hij Claude Code de opdracht: Verwerk alles in 00 Inbox. Maak per bericht een notitie in de juiste klantmap met datum, wat er besproken is en acties met deadline. Link naar de klant. Verplaats het origineel naar 90 Archief. Op vrijdag vraagt hij: Welke acties uit deze week staan nog open? De meeste tijd wint hij bij het terugvinden van afspraken. Dit is een voorbeeldsituatie, geen klantcase. Voor hem en zijn team is een sessie waarin je samen de structuur en CLAUDE.md opzet de snelste start; met een groter team is de Claude Code Masterclass logischer.

Wat nu?

Wat nu? Je volgende stap met Claude en Obsidian

Werkt route 1 en heb je een week met je vault gewerkt? Dan zijn dit de logische vervolgstappen, van klein naar groot.