Obsidian + Claude Code : monter ton opérateur business en 4 étapes

En avril 2026, Andrej Karpathy a posté un gist intitulé "LLM Wiki". Le tweet a fait 20 millions de vues, le repo 5000 stars en une semaine. L'idée tient en une phrase : au lieu d'utiliser un LLM comme un moteur de recherche qui refouille tes documents à chaque question, tu lui laisses construire et maintenir un wiki personnel en markdown qui se densifie au fil du temps. Le LLM fait la maintenance, toi tu fournis les sources et poses les questions. Ce guide applique le pattern à ton business solo avec Obsidian comme vault et Claude Code comme opérateur.

Pourquoi c'est utile

• Tu reçois un brief chaque lundi qui te dit qui relancer, quelles décisions prennent du retard, où ton business saigne du cash.
• Claude répond à tes questions depuis ton historique réel, pas depuis des hallucinations web.
• Ton vault devient un actif qui se valorise dans le temps au lieu d'une décharge de notes oubliées.
• Tu travailles avec un opérateur qui connaît ton business mieux que toi le lundi matin.

Le shift mental à comprendre

Obsidian classique, c'est un second cerveau passif. Tu y poses des notes, la pile grossit, la maintenance te coûte du temps, et au bout de quelques mois la majorité des notes sont devenues du bruit.

Obsidian plus agent, c'est un opérateur actif. L'agent lit ton vault, écrit dedans, fait des cross-references entre tes notes, te propose des actions. Le vault devient un livrable vivant. C'est ce que Karpathy appelle un "compounding artifact" : un artefact qui se densifie à chaque source ajoutée et à chaque question posée. Sa métaphore résume bien l'idée : Obsidian est l'IDE, le LLM est le programmeur, le wiki est la codebase. Ta connaissance devient du code que l'agent maintient.

Architecture en trois couches

Le pattern distingue trois couches. Les sources brutes sont tes documents originaux (contrats, factures, transcripts, articles) que l'agent lit mais ne modifie jamais. Tu les ranges dans un dossier raw/. Le wiki est la couche markdown que l'agent crée et maintient : résumés, pages d'entités, synthèses. Le schéma est un fichier CLAUDE.md à la racine du vault qui dit à l'agent comment ranger les choses et quels workflows déclencher. Tu n'écris jamais le wiki, l'agent le fait.

Au bout de quelques semaines, ton vault ressemble à ça en graph view. Les piliers ancrent l'index. Chaque pilier a ses entités. Les entités sont reliées entre elles quand un contrat client concerne un projet, ou quand une décision impacte les finances. Les sources brutes pendent en périphérie, accrochées aux entités qu'elles documentent.

Étape par étape

Étape 1 : Construire un vault structuré

Crée un vault Obsidian avec des dossiers qui reflètent ton business. Quatre dossiers couvrent 90% des cas d'un solo : Clients, Projets, Finances, Décisions en cours. Ajoute un dossier raw/ pour les sources brutes que tu collectes au quotidien.

Pourquoi ça compte : Obsidian stocke en markdown natif, Claude le lit sans traduction. Pas de base de données, pas de couche d'abstraction qui casse. Tu peux ouvrir tes notes avec n'importe quel éditeur dans 20 ans.

Pour chaque client tu crées un sous-dossier avec contrat.md, historique-paiements.md, derniere-relance.md. Petit tip qui évite des galères : nomme tes fichiers sans espaces ni caractères spéciaux. article-1.md plutôt que Article #1 (Brouillon).md.

Étape 2 : Connecter Claude Code au vault via MCP

MCP (Model Context Protocol) est le standard ouvert d'Anthropic pour donner à un LLM des capacités sur ton système. Le serveur MCP Obsidian fait le pont entre ton vault et Claude Code.

Pourquoi ça compte : c'est ce qui transforme un chatbot en opérateur. Une fois branché, Claude peut lire un fichier précis, écrire dedans, naviguer ton vault comme son propre disque.

Tu installes le serveur MCP Obsidian (open-source sur GitHub), tu l'ajoutes à ta config Claude Code, tu redémarres. Claude voit alors ton vault.

Étape 3 : Écrire un schéma qui pilote l'agent

Crée un fichier CLAUDE.md à la racine du vault. C'est le mode d'emploi que l'agent lit avant chaque session. Tu y précises tes conventions de nommage, ce que tu attends d'un brief du lundi, quelles questions il doit te poser plutôt que d'inventer.

Pourquoi ça compte : sans schéma, tu retombes sur un chatbot générique. Avec schéma, l'agent devient un opérateur discipliné. C'est ce qui transforme un LLM en mainteneur de wiki au lieu d'un assistant lambda.

Tu fais évoluer ce fichier au fur et à mesure. Pour aller plus loin, tu peux créer des slash commands custom dans .claude/commands/ (typiquement ingest, query, lint, save) qui sont des raccourcis vers tes workflows favoris.

Étape 4 : Travailler en boucle ingest, query, lint

Trois opérations rythment la vie du vault. Ingest : tu donnes une nouvelle source à l'agent (compte-rendu d'appel, contrat, mail). Il la lit, te discute des points clés, écrit un résumé, met à jour les pages entités concernées. Une seule source peut toucher 10 à 15 fichiers. Astuce qui change la vie : installe l'extension navigateur Obsidian Web Clipper (Firefox et Chrome). Un clic convertit un article web en markdown direct dans raw/. L'agent le voit au prochain ingest.

Query : tu poses une question (qui relancer, où en est le projet X, quelle marge sur le client Y). L'agent cherche dans le wiki, lit les pages pertinentes, synthétise avec citations. Si la réponse est bonne, range-la comme nouvelle page du wiki au lieu de la laisser disparaître dans l'historique de chat.

Pourquoi ça compte : la même question à un LLM sans vault te donne une réponse plausible mais inventée. Posée à ton agent connecté, elle s'ancre dans ton historique. Gadget vs opérateur.

Lint : une fois par semaine, demande à l'agent un health-check du vault. Contradictions entre pages, claims périmées, pages orphelines, concepts sans page dédiée. L'agent suggère des questions à creuser.

Variante : ce pattern pour ta veille IA

Le même setup marche pour suivre l'IA générative au lieu de gérer un business. Le vault s'organise différemment : concepts/ (RAG, MCP, attention, fine-tuning), entities/ (Anthropic, OpenAI, modèles précis), sources/ (articles, papers, transcripts), synthesis/ (les bonnes réponses qu'on range dans le wiki).

Quand un nouvel article sort sur une faille dans Claude Mythos, l'agent l'ingère, crée la page Glass Wing (le projet qui répond à cette faille), et lie la nouvelle entrée aux pages Anthropic, Opus 4.6 et au concept "alignment" déjà présents. Au bout d'un mois, tu as un mini Wikipedia de l'IA centré sur ce qui t'intéresse, avec un graph view qui montre tes zones denses d'attention. Même pattern, taxonomie différente, schéma adapté.

Limites à connaître

• C'est pas un raccourci. Compte une à deux semaines pour un vault assez riche et un schéma assez précis pour des briefs vraiment utiles.
• Le schéma CLAUDE.md évolue tout le temps. Si tu ne le maintiens pas, l'agent dérive vers un comportement générique.
• Tape tes commandes en anglais. Claude marche mieux en anglais même si le contenu du vault est en français. Les notes restent FR, les directives passent par EN.
• Pas adapté aux grosses équipes. Le pattern marche pour un solo ou une micro-équipe. Au-delà, tu rentres dans des questions de droits d'accès et de conflits non gérées nativement.
• Privacy. Tout ce que l'agent lit passe par les serveurs Anthropic. Pour des données sensibles, évalue le risque avant de connecter ton vault.

Pour aller plus loin

• Le gist original : gist.github.com slash karpathy slash 442a6bf555914893e9891c11519de94f
• Le serveur MCP Obsidian sur GitHub (cherche "mcp-obsidian")
• La doc MCP officielle : modelcontextprotocol.io
• L'extension Obsidian Web Clipper (Firefox et Chrome) pour capturer des articles web
• Plugin Obsidian Dataview pour exposer des tables dynamiques via les frontmatters YAML
• Si ton vault devient gros (plus de quelques centaines de pages), regarde qmd, un moteur de recherche local pour markdown

La règle d'or : commence petit. 5 clients, 10 notes, un schéma de 200 mots, un brief généré chaque lundi. Si ça t'aide, tu enrichis. Si ça ne t'aide pas, tu ajustes le schéma plutôt que d'ajouter des notes.