Claude Code x Obsidian - Der vollständige Integrationsleitfaden | KI-Notizen für einen wachsenden Vault

Jeder Obsidian-Nutzer hat es mindestens einmal gedacht: “Könnte sich dieser Vault nicht selbst organisieren?” Claude Code ist der beste Partner von Obsidian. Denn ein Obsidian-Vault ist letztlich nur ein Ordner voller Markdown-Dateien, und das Lesen und Schreiben von Dateibaeumen ist eine der groessten Staerken von Claude Code.

In diesem Artikel zeigen wir, wie Sie Claude Code und Obsidian kombinieren, um Ihren Vault automatisch wachsen zu lassen - mit lauffaehigem Code und echten Beispielen. Von Tagesnotizen und Web-Clipping bis hin zu Backlink-Vervollstaendigung und Plugin-Entwicklung.

Warum Obsidian x Claude Code?

Obsidians Staerken lassen sich auf drei Punkte reduzieren:

• Local-first: Alles sind Markdown-Dateien auf Ihrem eigenen Rechner
• Plain Text: Kein Vendor-Lock-in, auch in Zukunft lesbar
• Link-getrieben: Denken verweben durch [[Notizname]]-Verknuepfungen in alle Richtungen

Das passt perfekt zu Claude Codes Staerken:

• Arbeitet direkt mit dem Dateibaum (Read / Edit / Write / Glob)
• Behandelt Markdown als First-Class-Buerger (kann sogar Wikilinks parsen)
• CLAUDE.md bringt ihm “die Regeln dieses Vaults” bei

Kurz gesagt: Aus Sicht von Claude Code ist ein Obsidian-Vault “ein sehr ordentliches, kleines Projekt.” Notizorganisation laesst sich mit dem gleichen Gefuehl automatisieren wie Programmieren.

Basis-Setup: CLAUDE.md im Vault platzieren

Legen Sie zunaechst eine CLAUDE.md in das Wurzelverzeichnis Ihres Vaults. Wird Claude Code dann im Vault gestartet, laedt es die Datei automatisch.

# Meine Obsidian-Vault-Regeln

## Verzeichnisstruktur
- `daily/YYYY-MM-DD.md` — Tagesnotizen
- `zettel/` — Permanente Notizen (1 Notiz = 1 Idee, Titel = Konzeptname)
- `literature/` — Lesenotizen, Web-Clippings
- `project/` — Laufende Projekte
- `meta/` — Tag-Definitionen, Templates

## Notationsregeln
- Notizverknuepfungen mit `[[Notizname]]`
- Tags stehen im Frontmatter am Dateianfang
- Tagesnotizen: feste 3-Ebenen-Struktur `## Today / ## Learned / ## Questions`
- Quell-URLs im Frontmatter als `source:`

## Verbote
- Umbenennungen bestehender Notizen nur nach Rueckfrage (Backlinks koennten brechen)
- Notizen unter `_archive/` nicht veraendern

Werden die Vault-Regeln explizit angegeben, erzeugt und bearbeitet Claude Code Notizen konform zu Ihren Konventionen. Das verhindert Chaos durch uneinheitliche Formate.

Beispiel 1: Automatische Tagesnotiz-Erstellung

Ein Skript, das morgens die gestrige Notiz zusammenfasst und das heutige Template erzeugt.

#!/bin/bash
# ~/vault/scripts/daily-note.sh

TODAY=$(date +%Y-%m-%d)
YESTERDAY=$(date -d "yesterday" +%Y-%m-%d)
VAULT=~/vault

claude -p "
Bitte fuehre Folgendes aus:

1. Lies $VAULT/daily/$YESTERDAY.md (ueberspringe, falls nicht vorhanden)
2. Extrahiere 'unerledigte Aufgaben' aus dem 'Today'-Abschnitt von gestern
3. Extrahiere 3 'Reflexionspunkte' aus dem 'Learned'-Abschnitt von gestern
4. Erstelle $VAULT/daily/$TODAY.md mit folgendem Template:

---
date: $TODAY
tags: [daily]
---

## Today (heute geplant)
- (unerledigte Aufgaben von gestern hier einfuegen)

## Learned (Entdeckungen)
_leer_

## Questions (zu erforschen)
_leer_

## Review (gestrige Reflexion)
- (die 3 extrahierten Punkte hier einfuegen)

## Links
[[$YESTERDAY]] <-> [[$(date -d tomorrow +%Y-%m-%d)]]
---

5. Nach Erstellung nur 'Tagesnotiz erstellt' melden
"

Ueber cron, macOS launchd oder den Windows-Taskplaner registriert, ist die Tagesnotiz beim Aufwachen bereits da. Einfach Obsidian oeffnen und loslegen.

Beispiel 2: Web-Artikel in den Vault clippen

Read-Later-Workflow. URL uebergeben, formatierte Notiz landet in literature/.

// scripts/clip-url.mjs
import Anthropic from "@anthropic-ai/sdk";
import { writeFileSync } from "fs";

const url = process.argv[2];
const client = new Anthropic();

const res = await client.messages.create({
  model: "claude-opus-4-6",
  max_tokens: 4096,
  tools: [{ type: "web_search_20250101", name: "web_search" }],
  messages: [{
    role: "user",
    content: `Hole den Artikel unter dieser URL und erzeuge eine Obsidian-Notiz:
URL: ${url}

Ausgabeformat:
---
title: (Artikeltitel)
source: ${url}
tags: [literature, (2-3 Themen-Tags)]
clipped: ${new Date().toISOString().slice(0, 10)}
---

# (Artikeltitel)

## TL;DR
(Zusammenfassung in maximal 3 Zeilen)

## Key Points
- (5 Kernpunkte)

## My Take
_spaeter ergaenzen_

## Related
[[passende Notizen im bestehenden Vault (Schaetzung ok)]]
`,
  }],
});

const body = res.content[0].text;
const slug = body.match(/title: "(.+?)"/)?.[1]?.replace(/[\/:]/g, "-") ?? "untitled";
writeFileSync(`${process.env.VAULT}/literature/${slug}.md`, body);
console.log(`Clipped to literature/${slug}.md`);

Aufruf: node clip-url.mjs https://example.com/article

Mit einem Browser-Kontextmenue verbunden ergibt das einen Workflow, bei dem ein Rechtsklick jeden Artikel in den Vault speichert - spaeter durchsuchbar.

Beispiel 3: Automatische Backlink-Vervollstaendigung

Obsidian legt Backlinks an, sobald Sie [[Notizname]] schreiben, aber “diese Notiz haengt offensichtlich mit jenem Konzept zusammen, und ich habe es vergessen zu verlinken” passiert staendig. Claude Code kann das in einem Rutsch beheben.

claude -p "
Lies alles Markdown in $VAULT/zettel/ und fuehre aus:

1. Extrahiere aus jedem Notiztext 'wichtige Konzepte, Personen, Theorienamen'
2. Pruefe, ob das Konzept als Titel einer anderen Notiz existiert
3. Wickle unverlinkte Vorkommen mit [[...]] ein
4. Falls keine Ueberschrift '## Related' vorhanden, ergaenze sie und liste
   2-3 verwandte Notizen, die im Text nicht organisch vorkommen

Zeige das Diff vor Anwendung und warte auf Bestaetigung.
"

Wichtig: Genehmigungs-Flow nicht vergessen. Automatisches Einfuegen von Backlinks ist praktisch, aber falsche Links zerstoeren das Vertrauen in den Vault. “Diff zeigen, dann anwenden” ist Gesetz.

Beispiel 4: Meeting-Protokolle als Notizen + Tagging

Verwandelt Audio-Transkripte oder Roh-Notizen in strukturierte Notizen.

claude -p "
Lies $VAULT/inbox/raw-meeting-2026-04-16.txt und speichere in
$VAULT/literature/meeting-2026-04-16.md mit dieser Struktur:

---
title: '(vermuteter Meeting-Titel)'
date: 2026-04-16
type: meeting
tags: [meeting, (Tags aus Themen)]
attendees: [(extrahierte Teilnehmer)]
---

## Entscheidungen
## Action Items (mit Verantwortlichen und Fristen)
## Diskussion (nach Themen gegliedert)
## Aufgaben bis zum naechsten Mal

Personenerwaehnungen am Ende zu [[Personenname]] verlinken.
Zum Schluss inbox/raw-meeting-2026-04-16.txt nach _archive/ verschieben.
"

Rohtext in inbox werfen und spaeter gesammelt konvertieren.

Beispiel 5: Obsidian-Plugin-Entwicklung mit Claude Code

Obsidian-Plugins werden in TypeScript geschrieben. Claude Code ist stark in TS, die Kombination passt hervorragend.

cd ~/my-obsidian-plugin
claude

# In Claude Code:
> Lies main.ts und erklaere in 3 Zeilen, was dieses Plugin tut
> Fuege ein neues Feature hinzu: "markierten Text mit Claude-API zusammenfassen und an Cursor einfuegen"
> Aktualisiere manifest.json auf die passende Version
> Stelle sicher, dass npm run build durchlaeuft

Innerhalb von Minuten steht ein lauffaehiges Plugin. Klonen Sie das offizielle Obsidian-Plugin-Sample-Repo, und Claude Code baut darauf auf.

Umgang mit Obsidian-spezifischer Syntax

Obsidian-Notationen, die Claude Code kennen sollte:

Notation	Bedeutung	Beispiel
[[Notizname]]	Wikilink (interner Link)	[[Claude Code]]
[[Notizname#Ueberschrift]]	Link auf Ueberschrift	[[FAQ#Preis]]
[[Notizname|Alias]]	Link mit Alias	[[Claude Code|CC]]
![[Notizname]]	Ganze Notiz einbetten	![[Zitate]]
%%Kommentar%%	In Publish-Ansicht verborgen	%%TODO: ueberarbeiten%%

Werden diese in CLAUDE.md dokumentiert, nutzt Claude Code sie automatisch korrekt.

5 Stolperfallen

1. Sync-Konflikte (Obsidian Sync / iCloud / Dropbox) Waehrend Claude Code schreibt, kann ein Mobilgeraet synchronisieren und Konflikte erzeugen. Sync pausieren, waehrend Claude Code laeuft, ist sicherer. Auch ein “Pause”-Kommando am Anfang des Skripts ist moeglich.

2. Ungueltige Dateinamen-Zeichen Notiztitel mit Doppelpunkt : oder Slash / scheitern auf OS-Ebene. Weisen Sie Claude Code explizit an, “Dateinamen nur mit Buchstaben, Zahlen, Bindestrich und Landeszeichen” zu erzeugen.

3. Massen-Umbenennungen mit Backlinks Automatisierte Umbenennungen fuehren zu uebersehenen Backlinks und toten Links. Umbenennen per Obsidian-UI, reine Dateiverschiebungen Claude Code ueberlassen.

4. Plugin-abhaengige Schreibweisen Erzeugt Claude Code Dataview- oder Templater-Syntax, bricht das in Umgebungen ohne diese Plugins. Auf Standard-Markdown + Wikilinks beschraenken per CLAUDE.md.

5. Vollscan bei riesigen Vaults Glob **/*.md mit komplettem Einlesen eines 5000-Notizen-Vaults sprengt den Kontext. An Sub-Agenten mit begrenztem Scope (“nur zettel/”) delegieren.

Workflow-Beispiel: Ein Tagesablauf

Mein eigener Ablauf als Beispiel:

07:00  daily-note.sh startet automatisch, Tagesnotiz wird erzeugt
09:00  Obsidian oeffnen, Today-Abschnitt fuellen
12:00  Interessante Artikel mit clip-url.mjs speichern
15:00  Meetings, Protokoll in inbox/ werfen
17:00  claude konvertiert Protokoll nach literature/
22:00  Tageserkenntnisse als permanente Notizen in zettel/
Nacht   Woechentlich backlink-suggest.sh laufen lassen

“Schreiben” uebernehme ich, “Ordnen” uebernimmt Claude Code - diese Arbeitsteilung funktioniert. Sie konzentrieren sich auf Denken und Ideen; Organisation und Vernetzung geht an die KI. Das ist der wahre Wert von Obsidian x Claude Code.

Fazit

Ein Obsidian-Vault wird oft mit einem Garten verglichen. Stellt man Claude Code als Garten-Roboter ein, lassen sich Giessen (Tagesnotizen) / Jaeten (Backlink-Pflege) / Ernten (Zusammenfassungen) vollstaendig automatisieren.

Die ersten Schritte fuer heute:

1. CLAUDE.md ins Vault-Root legen und Regeln notieren
2. daily-note.sh fuer Morgenroutine einrichten
3. clip-url.mjs fuer 1-Klick-Web-Clipping installieren

Schon diese drei Schritte veraendern Ihren Umgang mit dem Vault grundlegend.

Verwandte Artikel

• Harness Engineering - Der vollstaendige Leitfaden
• 10 Sub-Agent-Muster fuer Claude Code
• CLAUDE.md Best Practices

Referenzen

• Obsidian Offizielle Dokumentation
• Obsidian Plugin Development Guide
• Claude Code Offizieller Guide