Vous utilisez Claude Code pour travailler, et Obsidian pour vos notes. Les deux tournent sur votre machine, sur les mêmes fichiers, et pourtant ils s'ignorent. Les brancher ensemble prend une trentaine de minutes et ne demande pas de savoir coder : Obsidian écrit du markdown dans un dossier, Claude Code sait lire et écrire dans un dossier. Il suffit de lui dire lequel, et avec quelles règles.
Ce guide est la version complète et gratuite de ce que j'utilise tous les jours. Je l'ai écrit pour qu'il fonctionne tel quel, sans rien acheter.
Ce que veut dire « brancher Claude Code sur Obsidian »
Il n'y a pas de plugin à installer ni d'API à connecter. Le branchement repose sur un fait tout bête : un vault Obsidian n'est qu'un dossier de fichiers markdown sur votre disque. Pas de base de données, pas de format propriétaire.
Claude Code, de son côté, est un agent qui travaille dans un dossier : il lit les fichiers, les modifie, en crée. Le brancher sur Obsidian, c'est donc simplement le lancer depuis le dossier de votre vault, puis lui donner des règles écrites pour qu'il sache quoi ranger, où, et comment.
Concrètement, une fois branché, vous pouvez lui demander en langage naturel : « range ce que j'ai déposé cette semaine », « fais-moi la synthèse de mes notes sur ce sujet », « retrouve ce que j'avais écrit sur X et relie-le à Y ».
Les deux prérequis, et rien d'autre
- Obsidian, gratuit, avec un vault existant ou un dossier vide. Si vous n'en avez jamais eu, créez-en un : c'est un dossier.
- Claude Code, qui nécessite un abonnement Claude. Une offre Pro suffit pour commencer.
Windows et macOS fonctionnent tous les deux. La seule différence apparaîtra à la dernière étape, celle de l'automatisation.
Étape 1 : ouvrir Claude Code dans votre vault
Ouvrez un terminal, placez-vous dans le dossier de votre vault, et lancez Claude Code. Sur Windows comme sur Mac :
cd "chemin/vers/votre-vault"
claudeC'est tout. Claude Code voit désormais vos notes. Vous pouvez tester immédiatement en lui demandant : « liste-moi les dossiers de ce vault et dis-moi ce que tu comprends de son organisation ». Sa réponse vous dira s'il a bien accès, et accessoirement si votre rangement est lisible par quelqu'un d'autre que vous.
Une précaution de bon sens avant d'aller plus loin : faites une copie de votre vault. Pas parce que c'est risqué, mais parce qu'un dossier de notes accumulé pendant des années mérite une sauvegarde avant qu'un agent y écrive. Un simple copier-coller du dossier suffit.
Étape 2 : créer une boîte d'entrée
C'est l'étape que la plupart des gens sautent, et c'est celle qui fait toute la différence.
Le problème d'un second cerveau n'a jamais été de collecter. Il est de ranger. Si vous demandez à un agent de réorganiser tout votre vault, vous obtiendrez du désordre sophistiqué. Si vous lui donnez un seul dossier à traiter, vous obtenez un résultat fiable.
Créez donc un dossier 00-Inbox à la racine. C'est là que vous jetez tout, en vrac, sans réfléchir : un lien d'article, trois lignes d'idée, une capture, une référence. Vous ne rangez plus rien à la main. L'agent, lui, ne touchera qu'à ce dossier.
Cette règle résout un vrai risque : un agent qui réorganise vos notes existantes sans prévenir. Avec une boîte d'entrée, son périmètre est explicite et vos anciennes notes ne bougent pas.
Étape 3 : écrire le fichier CLAUDE.md
Claude Code lit automatiquement un fichier nommé CLAUDE.md à la racine du dossier où il travaille, et en fait ses instructions permanentes. C'est le cœur du branchement : sans lui, vous répétez vos consignes à chaque session ; avec lui, l'agent connaît vos règles.
Créez CLAUDE.md à la racine de votre vault. Voici une base qui fonctionne, à adapter à votre organisation :
# Règles de ce vault
Ce dossier est mon second cerveau Obsidian. Tout est en markdown.
## Ton périmètre
- Tu ne traites QUE le dossier 00-Inbox.
- Tu ne modifies JAMAIS une note existante hors de 00-Inbox.
- Si un doute existe sur le classement, tu laisses la note dans 00-Inbox
et tu le signales, plutôt que de deviner.
## Comment tu ranges
- Chaque note de 00-Inbox est classée dans le dossier thématique adapté.
- Tu ajoutes en tête de note : une phrase de résumé, et 3 tags maximum.
- Tu relies la note aux notes existantes pertinentes avec des liens [[wiki]].
- Tu ne crées un nouveau dossier que si aucun existant ne convient.
## Ce que tu n'inventes pas
- Tu ne complètes pas une note avec des informations que je n'ai pas écrites.
- Si une note est trop courte pour être comprise, tu poses la question.Prenez le temps sur la section « ton périmètre ». C'est elle qui vous protège. Un agent sans limites écrites finit toujours par prendre une initiative que vous n'aviez pas demandée.
Sur le fond, un bon CLAUDE.md décrit vos habitudes réelles, pas une organisation idéale que vous ne tenez pas. Si vous ne mettez jamais de tags, ne lui demandez pas d'en mettre douze.
Étape 4 : automatiser le passage
Jusqu'ici, tout se fait à la main : vous ouvrez Claude Code et vous demandez le rangement. Ça marche déjà très bien, et beaucoup de gens s'arrêtent là sans rien perdre d'essentiel.
Pour aller plus loin, Claude Code s'exécute aussi sans interface, avec une consigne passée directement en ligne de commande :
claude -p "Traite le dossier 00-Inbox selon les règles de CLAUDE.md, puis écris un résumé de ce que tu as rangé dans 99-Recaps/."Cette commande peut ensuite être déclenchée automatiquement, par le Planificateur de tâches sur Windows ou par launchd (ou une tâche cron) sur macOS. Réglée sur les heures creuses, elle range pendant que vous dormez.
Deux points d'honnêteté sur cette étape. D'abord, c'est la plus technique des quatre : c'est là que les gens bloquent, entre les chemins absolus, les permissions d'écriture et la session qui doit rester authentifiée. Ensuite, elle est facultative : un passage manuel deux fois par semaine donne déjà l'essentiel du bénéfice.
Ce que ce montage fait bien, et ce qu'il ne fait pas
Ce qu'il fait bien : absorber le vrac. Vous arrêtez d'arbitrer entre « je range maintenant » et « je le perds ». Vous déposez, et le classement arrive plus tard sans vous.
Ce qu'il ne fait pas, et il vaut mieux le savoir avant :
- Il ne pense pas à votre place. Un agent qui range vos notes ne remplace pas le fait de les relire.
- Il ne se souvient pas d'une session à l'autre au-delà de ce qui est écrit dans les fichiers. C'est justement pour ça que tout passe par du markdown sur votre disque : la mémoire, ce sont vos notes, pas l'agent.
- Il ne rattrapera pas des notes illisibles. Trois mots jetés sans contexte resteront trois mots sans contexte.
Et si vous ne voulez pas tout monter vous-même
Tout ce qui précède est faisable en une trentaine de minutes, et je vous encourage à le faire : vous comprendrez mieux votre propre système. C'est l'étape 4 qui coûte du temps, entre les scripts, les chemins et les permissions.
C'est exactement ce que j'ai empaqueté dans Le Coffre : le fichier CLAUDE.md complet, la structure de vault, les scripts d'automatisation pour Windows et Mac, et un guide illustré pas à pas. Rien que vous ne puissiez reconstruire avec cet article, mais monté et testé.
FAQ
Faut-il savoir coder pour brancher Claude Code sur Obsidian ?
Non. Les trois premières étapes se résument à créer un dossier et à écrire un fichier texte. La quatrième, l'automatisation, demande de copier-coller quelques lignes dans le planificateur de votre système : c'est la seule qui ressemble à de la technique, et elle reste facultative.
Est-ce que ça casse un vault Obsidian déjà rempli ?
Pas si vous suivez la règle du périmètre. En cantonnant l'agent au dossier 00-Inbox via CLAUDE.md, vos notes existantes ne sont ni déplacées ni réécrites. Faites tout de même une copie de votre vault avant le premier passage : c'est deux minutes et ça enlève toute inquiétude.
Mes notes partent-elles sur un serveur ?
Vos fichiers restent sur votre machine, en markdown, dans votre vault. Ce qui transite, ce sont les contenus que Claude traite pendant qu'il travaille, exactement comme lorsque vous discutez avec Claude directement. Aucun hébergement de votre vault n'est nécessaire.
Ça marche avec ChatGPT à la place de Claude Code ?
La méthode de rangement se transpose, mais pas l'automatisation décrite ici. Ce montage repose sur un agent capable de lire et d'écrire des fichiers directement sur votre disque, ce que fait Claude Code. Sans cette capacité, il faut copier-coller vos notes à la main, et l'intérêt s'effondre.
Combien de temps ça prend au quotidien une fois en place ?
Quelques secondes pour déposer ce que vous voulez garder, et deux ou trois minutes pour relire le récap. Si vous y passez du temps tous les jours, c'est que les règles de votre CLAUDE.md sont trop floues : l'agent vous repose des questions au lieu de trancher.
Quel abonnement Claude faut-il ?
Un abonnement incluant Claude Code. Une offre Pro suffit pour démarrer sur un vault personnel. Le rangement consomme ce que consomme une conversation ordinaire, il n'y a pas de clé API séparée à brancher ni de facturation à l'usage en plus.
Si vous voulez creuser le sujet des agents qui travaillent sur vos outils plutôt que sur du texte isolé, j'en parle aussi dans agents IA en entreprise : automatiser ses processus et dans créer un agent IA avec Claude, ça veut dire quoi.