Das Hauptproblem aktueller KI-Workflows ist der massive Kontextverlust. Jede Standard-Chat-Session beginnt bei Null: Die KI weiß nichts über deine Codier-Standards, deine laufenden Projekte oder deinen spezifischen Schreibstil. Das Ergebnis sind generische Antworten, die mühsam nachgebessert werden müssen.
Claude Code & Obsidian: Baue dein KI-gestütztes „Zweites Gehirn“ (Schritt-für-Schritt)
1. Einleitung: Schluss mit generischen KI-Antworten
Das Hauptproblem aktueller KI-Workflows ist der massive Kontextverlust. Jede Standard-Chat-Session beginnt bei Null: Die KI weiß nichts über deine Codier-Standards, deine laufenden Projekte oder deinen spezifischen Schreibstil. Das Ergebnis sind generische Antworten, die mühsam nachgebessert werden müssen.
Die Lösung ist die Implementierung eines „Second Brain“ auf Basis von Obsidian in Kombination mit Claude Code (oder alternativen Agenten wie Codex). Durch das Model Context Protocol (MCP) und den direkten Zugriff auf dein lokales Dateisystem fungiert die KI nicht länger als externer Chatbot, sondern als integrierter Technical Assistant. Dein Wissen bleibt in lokalen Markdown-Dateien gespeichert – du behältst die volle Datenhoheit, während die KI durch jede neue Notiz präziser und wertvoller für dich wird.
2. Voraussetzungen: Das Toolkit für dein System
Für ein robustes Setup benötigst du folgende Komponenten:
- Obsidian: Die Markdown-Zentrale für Visualisierung und Wissensvernetzung.
- Claude Code / Codex / OpenCode: Deine handelnden CLI-Agenten.
- Git & GitHub CLI (
gh): Essenziell für Versionskontrolle, Rollbacks und (optional) Remote-Synchronisation. - Node.js & npm: Voraussetzung für die Installation von Claude Code und erweiterten Skills.
- Anthropic Pro- oder Max-Plan: Erforderlich für die API-Nutzung von Claude Code/Cowork.
3. Installation und Basis-Setup: CLI Integration
Der Workflow findet primär im Terminal statt, um maximale Kontrolle über den Kontext zu behalten.
- Vault-Initialisierung: Erstelle einen neuen Ordner (Vault) in Obsidian (z. B.
Wissen_v2). - Environment Context: Öffne dein Terminal direkt in diesem Ordner oder nutze das integrierte Terminal in VS Code.
- Agent-Start: Starte Claude mit dem Befehl
claude. Alternativ kannst du für ein integriertes Fenster in Obsidian das Claudian-Plugin (Beta) über das BRAT-Plugin installieren. - Der Sicherheits-Check (Plan-Modus): Einer der wichtigsten Befehle für Entwickler. Nutze den Plan-Modus (
Shift + Tab), um vor der Ausführung zu prüfen, welche Änderungen Claude an deinem Dateisystem vornehmen will.
4. Die Architektur: Strukturierung durch claude.md und agents.md
Damit dein System Model-Agnostic bleibt (wichtig bei Rate-Limits), nutzen wir zwei zentrale Steuerungsdateien:
claude.md: Spezifische Instruktionen für Claude Code.agents.md: Initialisiert viaslash-init. Diese Datei macht das System kompatibel mit Codex oder OpenCode.
Diese Dateien fungieren als „Betriebssystem“ deines Gehirns. Sie definieren die Struktur nach dem P.A.R.A.-Prinzip, ergänzt um technische Daten-Pipelines:
00_Context: Branding, Schreibstil, technisches Profil,claude.md.01_Inbox: Unstrukturierte Brain Dumps und Transkripte.02_Projects: Aktive Sprints mit Deadlines.03_Areas: Dauerhafte Verantwortlichkeiten (z. B. „DevOps“, „Marketing“).04_Resources: Das „Wiki“. EnthältSources(Rohdaten) undEntities(extrahierte Konzepte).05_Daily_Notes: Das Logbuch für Fortschritte und Entscheidungen.06_Archive: Abgeschlossene Meilensteine.
Pro-Workflow: Starte mit der Anweisung: „Führe das Onboarding basierend auf der claude.md durch.“ Nach dem Interview schreibt Claude die claude.md von einer Onboarding-Instruktion in eine permanente System-Message um, die deine Vault-Map und Session-Regeln enthält.
5. Wissen injizieren: Die RAW-to-Wiki Pipeline
Um Daten konsistent zu normalisieren, nutzen wir einen strukturierten Ingest-Prozess:
- Ingestion: Nutze den Obsidian Web Clipper, um Artikel direkt in den Ordner
RAW(innerhalb der Resources) zu speichern. - Processing: Befiehl Claude: „Injiziere den neuen Artikel aus RAW.“
- Data Normalization: Claude liest die Markdown-Datei, extrahiert Metadaten, erstellt Entitäten und verknüpft diese via Backlinks mit deinem bestehenden Wiki.
Case Study: Komplexe Fachliteratur einlesen Hinterlege ein PDF (z. B. Philip Fischers „Common Stocks and Uncommon Profits“) im RAW-Ordner. Befehl: Injiziere das PDF [Pfad] und extrahiere die 15 Kern-Thesen als Entitäten. Claude erstellt daraufhin atomare Notizen für jede These und verlinkt sie mit deinem Investment-Kontext.
6. Fortgeschrittene Features & Workflows
- Versionskontrolle & Checkpoints: Nutze Git für lokale Snapshots. Nach jeder größeren Injektion oder Umstrukturierung erfolgt ein
git commit. Bei Fehlern rollst du mitgit checkouteinfach zurück. - Skills Installation: Erweitere die Fähigkeiten deiner KI.
- Dies ermöglicht Claude den Umgang mit JSON Canvases und optimiert die Nutzung der Obsidian CLI.
Automatisierung mit Loops: Nutze den /loop Befehl für repetitive Aufgaben, wie z. B. das regelmäßige Prüfen von Deadlines in deinem Projects-Ordner.
Deep Workflows:
- Weekly Review: „Analysiere die Daily Notes der letzten 7 Tage und erstelle eine Zusammenfassung der erreichten Meilensteine.“
- Meeting-Prozess: Lade ein Transkript in die
Inbox. Claude extrahiert automatisch Action-Items für02_Projectsund neue Fachbegriffe für04_Resources/Entities.
Wikipedia-Export: Über GitHub Actions und GitHub Pages kannst du deinen Vault automatisch als statische HTML-Seite im Wikipedia-Style publizieren – ideal für teaminterne Dokumentationen.
7. Best Practices für den Entwickler-Alltag
- Content Creation: „Schreibe einen LinkedIn-Post über [Thema] basierend auf meinem Schreibstil in
00_Context.“ Das Ergebnis ist authentisch und benötigt kaum Korrekturen. - Smart Briefing: „Was steht heute an?“ Claude korreliert Informationen aus den
Daily Notesder letzten zwei Tage mit den Deadlines imProjects-Ordner. - Wissens-Transfer: „Erkläre mir das neue Architektur-Konzept X basierend auf unseren Erfahrungen aus Projekt Y.“ Die KI nutzt die Backlinks, um verborgene Synergien aufzuzeigen.
8. Fehlerbehebung & FAQ
| Problem | Ursache | Lösung |
|---|---|---|
| Rate-Limits erreicht | Anthropic API-Limits. | Wechsel zu Codex/OpenCode via agents.md (slash-init). |
| KI „halluziniert“ Struktur | Kontext-Überlastung. | Plan-Modus (Shift + Tab) nutzen; claude.md Anweisungen präzisieren. |
| Sync-Fehler | Merge-Konflikte. | GitHub CLI (gh) für manuelle Pushes/Pulls nutzen. |
| Fehlende Skills | Umgebung nicht geladen. | Claude neu starten oder Skill global vs. lokal prüfen. |
9. Fazit: Der Zinseszinseffekt deines Wissens
Ein KI-gestütztes Second Brain ist kein statisches Archiv, sondern ein wachsendes Asset. In der ersten Woche ist der Nutzen spürbar, nach drei bis sechs Monaten – wenn hunderte Dateien vernetzt sind – wird es zu deinem unfairen Wettbewerbsvorteil. Die KI versteht dann nicht nur den Code, sondern deine gesamte Entscheidungshistorie.
Start-Strategie: Beginne klein mit 5 zentralen Dateien (Profil, Schreibstil, 3 Top-Projekte) und lass das System durch tägliche Injektionen organisch wachsen.
Zentrale Takeaways:
- Kontext-Erhalt: Kein „Memory-Loss“ mehr zwischen Sessions dank lokaler Markdown-Basis.
- Lokale Datenhoheit: Dein wertvollstes IP bleibt auf deiner Hardware.
- Automatisierte Pflege: Die KI übernimmt das Tagging, Verlinken und Sortieren.
