Obsidian + Claude Code :
La méthode Karpathy
pour un RAG sans infrastructure

🔥 Le tweet qui a tout changé

Andrej Karpathy — l’une des figures les plus respectées du monde de l’IA — a partagé sa vision d’une stack de travail centrée sur Obsidian comme mémoire externe pour les LLM. Ce tweet n’a pas simplement buzzé : il a redessiné la façon dont des milliers de builders pensent leur architecture de contexte.

En complément du tweet, Karpathy a publié un fichier llmwiki.md sur son GitHub — un traité complet sur l’utilisation d’Obsidian comme substitut au RAG classique pour alimenter les LLM en contexte. Un document dense, à lire absolument.

Concrètement, l’idée est simple mais puissante : au lieu de déployer une infrastructure RAG complexe (base vectorielle, embeddings, retrieval…), on utilise des fichiers Markdown simples dans un vault Obsidian. Humain et machine ont chacun leur espace. Mais avant d’aller plus loin — qu’est-ce qu’Obsidian exactement ?

📓 Qu’est-ce qu’Obsidian ?

Obsidian est une application de gestion des connaissances personnelles (PKM — Personal Knowledge Management) qui repose sur un principe radical : tes notes t’appartiennent entièrement. Pas de base de données propriétaire, pas de cloud obligatoire, pas de format fermé. Juste des fichiers Markdown simples, stockés localement sur ton ordinateur.

Le concept central est le vault (coffre-fort) : un simple dossier sur ton disque qui contient toutes tes notes en Markdown. Obsidian ouvre ce dossier et y ajoute une couche de liens, de visualisation et d’automatisation. La grande force : si Obsidian disparaissait demain, tes fichiers resteraient parfaitement lisibles dans n’importe quel éditeur de texte — pour l’éternité.

⚙️ Les fonctionnalités clés

Ce qui distingue Obsidian d’un simple éditeur Markdown, c’est son écosystème pensé pour créer des connexions entre les idées — exactement ce dont les LLM ont besoin pour naviguer efficacement dans un vault.

🎯 Pour qui ? Les limites à connaître

Obsidian est un outil puissant mais pas universel. Il convient particulièrement aux personnes qui aiment construire des systèmes et les affiner progressivement. Voici une grille de lecture honnête.

🛠️ Installation pas à pas

Obsidian est disponible sur toutes les plateformes — Windows, macOS, Linux, Android et iOS. L’installation prend moins de deux minutes. Sélectionne ton système ci-dessous.

# Optionnel : installation via winget (PowerShell)
winget install Obsidian.Obsidian

# Optionnel : installation via Homebrew
brew install --cask obsidian

# Rendre exécutable et lancer
chmod +x Obsidian-*.AppImage
./Obsidian-*.AppImage

sudo dpkg -i obsidian_*.deb
sudo apt-get install -f   # corrige les dépendances manquantes

flatpak install flathub md.obsidian.Obsidian
flatpak run md.obsidian.Obsidian

sudo snap install obsidian --classic

🗄️ Créer et configurer son premier vault

Après l’installation, Obsidian te demande de créer ou d’ouvrir un vault. C’est l’étape fondatrice — c’est ici que tout commence.

🔥 Configurer le RAG nouvelle génération

Le vault Obsidian est installé. Place maintenant au cœur du sujet : connecter Claude Code à ce vault pour créer un système RAG sans infrastructure — local, chiffré, et jusqu’à 95 % moins coûteux que les solutions vectorielles classiques.

✅ Prérequis

# Se placer dans le vault
cd ~/Documents/MonVault

# Créer les 3 couches + dossiers skills
mkdir -p raw wiki .claude/skills
mkdir -p wiki/intelligence wiki/projets wiki/daily wiki/ressources

MonVault/
├── raw/              ← zone humaine (brut)
├── wiki/             ← zone LLM (compilé)
│   ├── intelligence/
│   ├── projets/
│   ├── daily/
│   └── ressources/
├── .claude/skills/   ← commandes slash
└── CLAUDE.md         ← instructions (étape suivante)

# CLAUDE.md — à la racine du vault

# Vault Obsidian — Instructions Claude Code

## Architecture

### /raw — ZONE HUMAINE (lecture seule pour toi)
- Données brutes : articles, PDFs, notes non organisées
- Tu ne modifies JAMAIS ce dossier

### /wiki — TON ESPACE DE TRAVAIL
- Tu lis, crées et organises les notes ici
- Toujours lire wiki/index.md EN PREMIER
- Utiliser des [[wikilinks]] entre les notes

### /wiki/index.md — PANNEAU DE DIRECTION
- Lire ce fichier avant toute recherche de contenu

## Règles absolues
1. Ne JAMAIS écrire dans /raw
2. Mettre à jour index.md après chaque ingestion
3. Créer une entrée daily/ à chaque session active

# wiki/index.md — Master Index

## intelligence/
Notes sur l'IA, LLM, outils no-code/low-code.
Benchmarks, comparatifs, tutoriels techniques.

## projets/
Fiches projets actifs : objectif, contexte, étapes suivantes.

## daily/
Journal automatique des sessions Claude Code.

## ressources/
Prompts réutilisables, liens de référence, templates.

# Skill /un-geste — Ingestion RAW → WIKI

## Procédure
1. Lire wiki/index.md (cartographie actuelle)
2. Scanner tous les fichiers de /raw
3. Pour chaque nouveau fichier non encore dans le wiki :
   - Analyser le contenu
   - Créer une note structurée dans le bon sous-dossier /wiki
   - Ajouter des [[wikilinks]] vers les notes connexes
4. Mettre à jour wiki/index.md
5. Logger l'ingestion dans wiki/daily/[date].md

## Format des notes wiki
- Frontmatter YAML avec tags et date
- Titre H1 + résumé 2-3 phrases
- Points clés en liste
- Section "Liens connexes" avec [[wikilinks]]

# Skill /prime — Chargement contexte

## Procédure
1. Lire CLAUDE.md (règles du vault)
2. Lire wiki/index.md (cartographie complète)
3. Lire les 3 dernières entrées wiki/daily/
4. Afficher un résumé : nb notes / dossier, dernière activité
5. Confirmer : "✓ Vault chargé. Prêt."

# Skill /lint — Maintenance vault

## Vérifications
1. [[Wikilinks]] cassés → signaler et proposer corrections
2. Notes orphelines (zéro lien entrant) → lister
3. Entrées index.md manquantes → ajouter automatiquement
4. Fichiers /raw non ingérés → alerter
5. Contradictions entre notes → signaler
6. Rapport final : X problèmes détectés / Y corrigés

# 1. Se placer dans le vault (obligatoire)
cd ~/Documents/MonVault

# 2. Lancer Claude Code
claude

# 3. Initialiser le contexte
/prime

# 4. Premier test d'ingestion (après avoir clippé un article)
/un-geste

# Depuis un projet extérieur au vault
cd ~/projects/mon-projet
claude

# Claude interroge le vault en parallèle via MCP
> Cherche dans mon vault les notes sur l'optimisation SEO
> Résume les 3 dernières ingestions de mon wiki/intelligence

MCP standard :  obsidian-claude-code-mcp (port 22360)
Sémantique :    Claudesidian + Ollama embeddings
Starter kit :   github.com/AgriciDaniel/claude-obsidian
PKM complet :   github.com/ballred/obsidian-claude-pkm

🗺️ Vue d’ensemble du flux complet

┌──────────────────────────────────────────────────────┐
│        FLUX RAG OBSIDIAN × CLAUDE CODE               │
└──────────────────────────────────────────────────────┘

TU  ──(Web Clipper / notes)──▶  📂 raw/
                                     │
                            /un-geste (ingestion)
                                     │
                                     ▼
                                📚 wiki/  ◀── /lint (maintenance)
                                     │
                      /prime (contexte) │ /query (recherche)
                                     │
                                     ▼
                              📄 CLAUDE.md
                         (lu à chaque session)

→ Résultat : mémoire persistante, locale, zéro infra

🔗 Ressources & liens utiles

Tous les liens essentiels pour démarrer avec Obsidian, comprendre l’approche Karpathy, et intégrer le workflow avec Claude Code.

🏗️ L’architecture 3 couches selon Karpathy

Maintenant qu’on sait ce qu’est Obsidian et pourquoi il est pertinent, voici le cœur de l’analogie de Karpathy : une structure en 3 couches distinctes au sein du vault. Chaque couche a un rôle précis, un propriétaire défini (humain ou LLM), et des règles d’interaction claires.

🗺️ L’index : le panneau de direction du wiki

À mesure que le wiki grossit, un problème se pose naturellement : la consommation de tokens. Sans organisation préalable, Claude Code itère sur chaque dossier pour trouver une information. Si elle est dans le dernier dossier parcouru… tu viens de brûler des tokens inutilement.

# index.md — Master Index du Wiki

## Dossiers du wiki

### /wiki/intelligence
Articles sur l'IA, les LLM, les outils no-code/low-code.
Ressources : benchmarks, comparatifs, tutoriels.

### /wiki/projets
Fiches projet actives. Chaque fiche = objectif, contexte, prochaines étapes.

### /wiki/daily
Journal journalier. Log automatique des modifications du vault.

### /wiki/ressources
Liens, références, bibliothèque de prompts réutilisables.

La solution : un fichier index.md à la racine du wiki servant de panneau de direction. Claude Code le consulte d’abord pour identifier le dossier le plus susceptible de contenir l’information, puis y va directement — économisant tokens et temps.

⚡ 3 opérations essentielles avec Claude Code

Une fois le vault structuré, trois types d’opérations (slash commandes) pilotent le workflow au quotidien. Ces commandes sont configurées dans Claude Code comme des skills réutilisables.

⚔️ Obsidian vs RAG classique

La question légitime : pourquoi ne pas utiliser un vrai système RAG avec base vectorielle, embeddings et retrieval ? Voici la comparaison honnête.

🎬 Démo : ingestion d’un article en temps réel

Voici le workflow de bout en bout avec l’extension Obsidian Web Clipper (obsidian.md/clipper) :

## Bilan de l'ingestion — /un-geste

Fichiers scannés :    5
Nouveaux fichiers :   1  ← l'article clipé
Fichiers enrichis :  0
Fichiers skippés :   4  ← déjà dans le wiki
Index mis à jour :   ✓ OUI
Daily note créée :   ✓ OUI

→ wiki/intelligence/optimisation-seo-claude.md créé

🏁 Conclusion & perspectives

L’analogie de Karpathy n’est pas juste un tweet viral — c’est un blueprint opérationnel. Une architecture propre, des règles claires entre humain et machine, et un outil qui cumule toutes les qualités : stockage local, Markdown universel, extensibilité infinie, communauté active, gratuité totale pour un usage local.

• Télécharge Obsidian gratuitement sur obsidian.md et crée ton premier vault
• Installe Obsidian Web Clipper pour alimenter ton RAW depuis le navigateur
• Structure ton vault en 3 couches : RAW / WIKI / claude.md
• Crée ton index.md dès le départ pour économiser les tokens
• Configure les 3 commandes clés : /un-geste, /prime, /lint
• Active le journal journalier pour tracer les modifications automatiques
• Consulte llmwiki.md de Karpathy sur GitHub pour aller plus loin