{"id":323467,"date":"2026-05-15T23:47:17","date_gmt":"2026-05-15T20:47:17","guid":{"rendered":"https:\/\/ceotudent.com\/andrej-karpathy-fichier-claude-md-2026-guide"},"modified":"2026-05-15T23:47:17","modified_gmt":"2026-05-15T20:47:17","slug":"andrej-karpathy-fichier-claude-md-2026-guide","status":"publish","type":"post","link":"https:\/\/ceotudent.com\/fr\/andrej-karpathy-fichier-claude-md-2026-guide","title":{"rendered":"Qu&rsquo;est-ce que le fichier CLAUDE.md d&rsquo;Andrej Karpathy ? La nouvelle m\u00e9moire du d\u00e9veloppement logiciel \u00e0 l&rsquo;\u00e8re de l&rsquo;IA (guide 2026)"},"content":{"rendered":"<blockquote>\n<p><strong>R\u00e9ponse courte :<\/strong> <strong>CLAUDE.md<\/strong> est le fichier de contexte persistant que l&rsquo;outil d\u00e9veloppeur d&rsquo;Anthropic, <strong>Claude Code<\/strong>, lit au d\u00e9but de chaque session. En 2026 il prend en charge <strong>quatre scopes<\/strong> (managed \/ project \/ user \/ local) et une <strong>syntaxe d&rsquo;imports<\/strong> (<code>@path\/to\/file<\/code>) pour int\u00e9grer d&rsquo;autres fichiers. L&rsquo;<strong>auto memory<\/strong> apport\u00e9 en v2.1.59 permet \u00e0 Claude d&rsquo;accumuler des connaissances dans un <code>MEMORY.md<\/code> de son propre chef ; ensemble ils dotent le projet d&rsquo;une <strong>m\u00e9moire \u00e0 deux couches<\/strong>. Entre novembre 2025 et janvier 2026, Andrej Karpathy a bascul\u00e9 <strong>80 % de sa routine de coding vers l&rsquo;agent-driven coding<\/strong>, qualifiant ce passage de <em>\u00ab plus grand changement de workflow en environ 20 ans de programmation. \u00bb<\/em> En <strong>avril 2026<\/strong>, il a publi\u00e9 le gist <a href=\"https:\/\/gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f\" rel=\"noopener\">idea file<\/a> et red\u00e9fini CLAUDE.md comme le <strong>fichier sch\u00e9ma colonne vert\u00e9brale<\/strong> d&rsquo;une architecture de connaissance personnelle compos\u00e9e de <code>raw\/<\/code> (sources), <code>wiki\/<\/code> (base de connaissances maintenue par le LLM) et <code>CLAUDE.md<\/code> (sch\u00e9ma). Ce guide passe en revue toutes ces innovations et l&rsquo;allure d&rsquo;un CLAUDE.md efficace en 2026.<\/p>\n<\/blockquote>\n<p>\u00c0 l&rsquo;\u00e8re de la fusion entre IA et d\u00e9veloppement, <strong>ce que vous dites \u00e0 l&rsquo;IA et comment<\/strong> d\u00e9termine la productivit\u00e9 r\u00e9elle que vous obtenez en retour. Depuis mars 2026, la documentation officielle d&rsquo;Anthropic est pass\u00e9e \u00e0 sa nouvelle adresse (<code>code.claude.com\/docs\/en\/memory<\/code>) et CLAUDE.md reste le concept le plus critique de Claude Code, autour duquel des couches compl\u00e9mentaires \u2014 <strong>auto memory<\/strong>, <strong>path-scoped rules<\/strong>, <strong>imports<\/strong>, <strong>subagent memory<\/strong> \u2014 se sont form\u00e9es. Les publications de Karpathy ces six derniers mois ont propuls\u00e9 ce m\u00e9canisme au-del\u00e0 d&rsquo;un simple fichier de configuration vers <strong>l&rsquo;architecture centrale de la connaissance des logiciels de l&rsquo;\u00e8re IA<\/strong>.<\/p>\n<hr>\n<h2>Andrej Karpathy : de Software 2.0 \u00e0 l&rsquo;Idea File<\/h2>\n<p><strong>Andrej Karpathy<\/strong> (n\u00e9 le 23 octobre 1986 \u00e0 Bratislava) est l&rsquo;un des dix ing\u00e9nieurs les plus influents de l&rsquo;IA moderne. Il a termin\u00e9 son doctorat en informatique \u00e0 Stanford sous la direction de Fei-Fei Li en 2016. Trois \u00e9tapes structurent sa carri\u00e8re : <strong>chercheur fondateur d&rsquo;OpenAI<\/strong> (2015-2017), puis <strong>Director of AI chez Tesla<\/strong> (2017-2022) en charge d&rsquo;Autopilot Vision, retour bref chez OpenAI en 2023, et fondation d&rsquo;<strong>Eureka Labs<\/strong> en 2024. Sa cha\u00eene YouTube, qui h\u00e9berge la s\u00e9rie marathon <em>\u00ab Let&rsquo;s build GPT from scratch \u00bb<\/em>, d\u00e9passe 2 millions d&rsquo;abonn\u00e9s.<\/p>\n<p>Lire Karpathy comme un chercheur strictement technique est incomplet. C&rsquo;est aussi le designer du vocabulaire cr\u00e9atif de l&rsquo;IA. Dans <strong>Software 2.0<\/strong> (2017) il soutenait que les programmes sont de plus en plus \u00ab \u00e9crits \u00bb non plus par des d\u00e9veloppeurs mais par des r\u00e9seaux neuronaux apprenant des poids. Provocant en 2017, r\u00e9alit\u00e9 partag\u00e9e du secteur en 2026. <strong>Vibe coding<\/strong> \u2014 construire du logiciel en discutant avec l&rsquo;IA plut\u00f4t qu&rsquo;en tapant directement le code \u2014 est le terme qu&rsquo;il a popularis\u00e9 d\u00e9but 2025. <strong>Agentic coding<\/strong> d\u00e9signe l&rsquo;automatisation de t\u00e2ches longues avec des mod\u00e8les autonomes comme Claude Code, Codex CLI, Aider et Cline.<\/p>\n<p>La derni\u00e8re rupture est survenue entre <strong>novembre 2025 et janvier 2026<\/strong>. Sur cette p\u00e9riode, Karpathy a d\u00e9plac\u00e9 <strong>80 % de sa routine du coding manuel vers l&rsquo;agent-driven coding<\/strong> et a qualifi\u00e9 ce passage de <em>\u00ab plus grand changement de workflow en environ 20 ans de programmation. \u00bb<\/em> Claude Code et son fichier m\u00e9moire CLAUDE.md \u00e9taient au centre. En <strong>avril 2026<\/strong>, il a pouss\u00e9 le sujet d&rsquo;un cran avec l&rsquo;\u00ab idea file \u00bb : une nouvelle architecture personnelle de connaissance fond\u00e9e sur <strong>partager des id\u00e9es, pas du code<\/strong>. Selon ses mots : <em>\u00ab You just share the idea, then the other person&rsquo;s agent customizes &amp; builds it for your specific needs. \u00bb<\/em><\/p>\n<p><iframe src=\"https:\/\/www.youtube.com\/embed\/LCEmiRjPEtQ?start=13&#038;rel=0\" title=\"Andrej Karpathy \u2014 Software Is Changing (Again), YC AI Startup School 2024\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe><\/p>\n<blockquote>\n<p>\ud83d\udcfa Le point de d\u00e9part de cet article est la keynote de Karpathy <em>\u00ab Software Is Changing (Again) \u00bb<\/em> \u00e0 la <strong>Y Combinator AI Startup School 2024<\/strong>. Vibe coding et agentic coding y sont r\u00e9sum\u00e9s le plus clairement.<\/p>\n<\/blockquote>\n<hr>\n<h2>Qu&rsquo;est-ce que CLAUDE.md et comment s&rsquo;articule-t-il avec l&rsquo;auto memory ?<\/h2>\n<p>CLAUDE.md est le fichier d&rsquo;instructions persistant que vous \u00e9crivez et maintenez ; Claude Code le lit au d\u00e9but de chaque session. La doc d&rsquo;Anthropic le dit clairement : <em>\u00ab Instructions you write to give Claude persistent context. \u00bb<\/em> En 2026 une seconde couche de m\u00e9moire a \u00e9t\u00e9 ajout\u00e9e : <strong>auto memory<\/strong>. Le partage : vous \u00e9crivez CLAUDE.md (r\u00e8gles, architecture) ; Claude \u00e9crit l&rsquo;auto memory (les enseignements qu&rsquo;il a d\u00e9riv\u00e9s de vos corrections et pr\u00e9f\u00e9rences pass\u00e9es). L&rsquo;auto memory est arriv\u00e9e avec Claude Code v2.1.59 et persiste sous <code>~\/.claude\/projects\/&lt;project&gt;\/memory\/MEMORY.md<\/code>. Au d\u00e9but de chaque chat, les 200 premi\u00e8res lignes (ou 25 Ko) de MEMORY.md sont inject\u00e9es dans le contexte.<\/p>\n<table>\n<thead>\n<tr>\n<th>Caract\u00e9ristique<\/th>\n<th><strong>CLAUDE.md<\/strong><\/th>\n<th><strong>Auto memory<\/strong><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Auteur<\/td>\n<td>Vous<\/td>\n<td>Claude<\/td>\n<\/tr>\n<tr>\n<td>Type de contenu<\/td>\n<td>Instructions et r\u00e8gles<\/td>\n<td>Apprentissages d\u00e9riv\u00e9s et patterns<\/td>\n<\/tr>\n<tr>\n<td>Scope<\/td>\n<td>Projet, utilisateur ou organisation<\/td>\n<td>Par worktree<\/td>\n<\/tr>\n<tr>\n<td>Chargement<\/td>\n<td>Complet \u00e0 chaque session<\/td>\n<td>200 premi\u00e8res lignes \/ 25 Ko \u00e0 chaque session<\/td>\n<\/tr>\n<tr>\n<td>Usage principal<\/td>\n<td>Standards de code, architecture, workflow<\/td>\n<td>Commandes de build, observations de debug, pr\u00e9f\u00e9rences<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>CLAUDE.md a elle-m\u00eame gagn\u00e9 une structure plus riche en 2026. <strong>Quatre scopes<\/strong> sont support\u00e9s : des fichiers <strong>managed policy<\/strong> d\u00e9ploy\u00e9s par IT\/DevOps \u00e0 l&rsquo;\u00e9chelle de l&rsquo;organisation (macOS sous <code>\/Library\/Application Support\/ClaudeCode\/CLAUDE.md<\/code>, Linux sous <code>\/etc\/claude-code\/CLAUDE.md<\/code>, Windows sous <code>C:Program FilesClaudeCodeCLAUDE.md<\/code>) ; des fichiers <strong>projet<\/strong> sp\u00e9cifiques \u00e0 l&rsquo;\u00e9quipe (<code>.\/CLAUDE.md<\/code> ou <code>.\/.claude\/CLAUDE.md<\/code>) ; des fichiers <strong>user<\/strong> couvrant tous vos projets (<code>~\/.claude\/CLAUDE.md<\/code>) ; et des fichiers <strong>local<\/strong> pour des notes personnelles propres au projet, mis dans <code>.gitignore<\/code> (<code>.\/CLAUDE.local.md<\/code>). Les scopes plus sp\u00e9cifiques l&rsquo;emportent sur les plus larges.<\/p>\n<p>Le chargement s&rsquo;est aussi \u00e9largi. Partant du r\u00e9pertoire de travail, Claude remonte <strong>jusqu&rsquo;\u00e0 la racine du syst\u00e8me de fichiers<\/strong> en cherchant <code>CLAUDE.md<\/code> et <code>CLAUDE.local.md<\/code> dans chaque dossier ; toutes les correspondances entrent dans le contexte. Les CLAUDE.md des sous-dossiers ne sont pas charg\u00e9s au lancement \u2014 ils chargent <strong>\u00e0 la demande<\/strong> quand Claude lit un fichier dans ce dossier. Si vous ajoutez d&rsquo;autres dossiers via <code>--add-dir<\/code>, d\u00e9finissez <code>CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1<\/code> pour charger leurs CLAUDE.md aussi. Apr\u00e8s une compaction (<code>\/compact<\/code>), le CLAUDE.md \u00e0 la racine du projet est recharg\u00e9 automatiquement ; les fichiers imbriqu\u00e9s reviennent \u00e0 la prochaine lecture pertinente.<\/p>\n<hr>\n<h2>Nouveaut\u00e9s 2026 : Imports, .claude\/rules\/, interop AGENTS.md<\/h2>\n<p>Pour \u00e9viter qu&rsquo;un CLAUDE.md ne grossisse en un fichier unique gigantesque, Anthropic a standardis\u00e9 la syntaxe <strong><code>@path\/to\/import<\/code><\/strong>. Elle ins\u00e8re d&rsquo;autres fichiers Markdown dans CLAUDE.md ; chemins relatifs et absolus pris en charge ; r\u00e9cursion autoris\u00e9e jusqu&rsquo;\u00e0 <strong>5 sauts<\/strong>. Usage typique :<\/p>\n<pre><code class=\"language-markdown\">See @README for project overview and @package.json for available npm commands.\n\n# Additional Instructions\n- git workflow @docs\/git-instructions.md\n- personal preferences @~\/.claude\/my-project-instructions.md\n<\/code><\/pre>\n<p>Deuxi\u00e8me grande nouveaut\u00e9 : le dossier <strong><code>.claude\/rules\/<\/code><\/strong> et ses <strong>path-scoped rules<\/strong>. Au lieu d&rsquo;entasser toutes les instructions dans un CLAUDE.md, scindez les r\u00e8gles en fichiers Markdown th\u00e9matiques, avec un YAML frontmatter qui ne les active que lorsque Claude touche des chemins correspondants :<\/p>\n<pre><code class=\"language-markdown\">---\npaths:\n  - &quot;src\/api\/**\/*.ts&quot;\n  - &quot;lib\/**\/*.{ts,tsx}&quot;\n---\n\n# API Development Rules\n- All API endpoints must include input validation\n- Use the standard error response format\n- Include OpenAPI documentation comments\n<\/code><\/pre>\n<p>Les fichiers de r\u00e8gles sans frontmatter <code>paths<\/code> se chargent toujours ; ceux avec ne s&rsquo;activent que quand Claude travaille sur un fichier correspondant. M\u00e9canisme critique pour les monorepos o\u00f9 plusieurs \u00e9quipes maintiennent leurs propres jeux de r\u00e8gles. Le r\u00e9glage <strong><code>claudeMdExcludes<\/code><\/strong> permet aussi de d\u00e9sactiver s\u00e9lectivement des CLAUDE.md des dossiers anc\u00eatres.<\/p>\n<p>Troisi\u00e8me ajout : l&rsquo;<strong>interop\u00e9rabilit\u00e9 AGENTS.md<\/strong>. Cursor, Codex, Aider et d&rsquo;autres agents lisent AGENTS.md ; Claude Code ne lit que CLAUDE.md. La fa\u00e7on standard de r\u00e9soudre :<\/p>\n<pre><code class=\"language-markdown\">@AGENTS.md\n\n## Claude Code\nUse plan mode for changes under `src\/billing\/`.\n<\/code><\/pre>\n<p>M\u00eame jeu d&rsquo;instructions partag\u00e9 sur tous vos outils d&rsquo;agents ; la courte section sp\u00e9cifique \u00e0 Claude ajoute les extras. C\u00f4t\u00e9 commandes slash : <strong><code>\/init<\/code><\/strong> r\u00e9dige le fichier, <strong><code>\/memory<\/code><\/strong> affiche les fichiers charg\u00e9s et permet de les \u00e9diter, le hook <strong><code>InstructionsLoaded<\/code><\/strong> sert \u00e0 d\u00e9boguer quoi s&rsquo;est charg\u00e9 quand. En d\u00e9finissant <code>CLAUDE_CODE_NEW_INIT=1<\/code>, <code>\/init<\/code> devient un flux multi-phases interactif : un subagent inspecte le repo, vous interroge sur les lacunes et propose un fichier passable en revue avant \u00e9criture.<\/p>\n<hr>\n<h2>L&rsquo;approche idea file de Karpathy (avril 2026)<\/h2>\n<p>Le 3 avril 2026, Karpathy a propos\u00e9 sur X puis dans un gist GitHub un nouveau format de partage : l&rsquo;\u00ab idea file \u00bb. L\u00e0 o\u00f9 l&rsquo;open source classique partage du code, l&rsquo;idea file partage l&rsquo;id\u00e9e, et l&rsquo;agent de l&rsquo;autre c\u00f4t\u00e9 la <strong>reconstruit pour son environnement<\/strong>. La raison est simple : en 2026 \u2014 avec des mod\u00e8les d&rsquo;agents assez puissants \u2014 copier l&rsquo;<strong>intention<\/strong> est plus efficace que copier le code au pixel pr\u00e8s.<\/p>\n<p>La forme concr\u00e8te est une structure \u00e0 trois couches. Couche un : le dossier <code>raw\/<\/code> ; articles, papiers, images, datasets atterrissent ici. Le LLM <strong>lit mais ne modifie jamais<\/strong> ce dossier \u2014 les sources sont immuables et v\u00e9rifiables. Couche deux : le dossier <code>wiki\/<\/code> ; les pages de synth\u00e8se, de concept et d&rsquo;entit\u00e9s produites par le LLM y vivent, recoup\u00e9es et <strong>croissant cumulativement<\/strong> au lieu d&rsquo;\u00eatre red\u00e9riv\u00e9es par requ\u00eate. Couche trois : le fichier <code>CLAUDE.md<\/code> (alternativement <code>AGENTS.md<\/code> ou <code>OPENCODE.md<\/code>) ; il d\u00e9finit le <strong>sch\u00e9ma<\/strong> du syst\u00e8me global et la fa\u00e7on de le maintenir.<\/p>\n<p>Le syst\u00e8me tourne autour de trois op\u00e9rations. <strong>Ingest :<\/strong> quand une nouvelle source arrive dans <code>raw\/<\/code>, le LLM la lit et met \u00e0 jour simultan\u00e9ment 10-15 pages wiki, garde un index et un journal d&rsquo;activit\u00e9. <strong>Query :<\/strong> les questions traversent la structure ; les r\u00e9ponses pr\u00e9cieuses sont reclass\u00e9es comme nouvelles pages \u2014 la connaissance se compose. <strong>Lint :<\/strong> des contr\u00f4les de sant\u00e9 p\u00e9riodiques font \u00e9merger contradictions, pages orphelines, concepts manquants et revues sugg\u00e9r\u00e9es. Karpathy relie cela au <strong>concept Memex de Vannevar Bush en 1945<\/strong> ; la question non r\u00e9solue de Bush \u00ab qui maintient ? \u00bb trouve enfin sa r\u00e9ponse avec les LLM.<\/p>\n<p>Cette architecture diverge du RAG (Retrieval-Augmented Generation) classique sur un point cl\u00e9. Le RAG revient aux sources et synth\u00e9tise \u00e0 chaque requ\u00eate ; l&rsquo;approche idea file <strong>compile la connaissance une fois et la garde \u00e0 jour<\/strong>, plut\u00f4t que de la red\u00e9river \u00e0 chaque appel. Selon Karpathy : <em>\u00ab The knowledge is compiled once and then kept current, not re-derived on every query. \u00bb<\/em> CLAUDE.md est le fichier sch\u00e9ma qui transforme un chatbot g\u00e9n\u00e9rique en un <strong>mainteneur wiki disciplin\u00e9<\/strong>.<\/p>\n<hr>\n<h2>Comment \u00e9crire un CLAUDE.md efficace ? (standards 2026)<\/h2>\n<p>Quatre principes issus de la doc Anthropic forment le noyau de l&rsquo;\u00e9criture efficace d&rsquo;un CLAUDE.md. <strong>Taille :<\/strong> maintenir le fichier sous 200 lignes ; les fichiers plus longs consomment plus de contexte et baissent le taux d&rsquo;adh\u00e9sion. Si les instructions grandissent, scinder via path-scoped rules ou imports. <strong>Structure :<\/strong> instructions group\u00e9es sous des titres Markdown et des bullets, bien plus scannables que des paragraphes diffus ; Claude lit comme un humain. <strong>Sp\u00e9cificit\u00e9 :<\/strong> instructions concr\u00e8tes et v\u00e9rifiables. <em>\u00ab Format the code properly \u00bb<\/em> \u2192 <em>\u00ab Use 2-space indentation \u00bb<\/em> ; <em>\u00ab Test your changes \u00bb<\/em> \u2192 <em>\u00ab Run <code>npm test<\/code> before committing \u00bb<\/em> ; <em>\u00ab Keep files organised \u00bb<\/em> \u2192 <em>\u00ab API handlers live in <code>src\/api\/handlers\/<\/code> \u00bb.<\/em> <strong>Coh\u00e9rence :<\/strong> en cas d&rsquo;instructions contradictoires, Claude en choisit une au hasard ; revoyez p\u00e9riodiquement le CLAUDE.md et les imbrications.<\/p>\n<p>Quand ajouter dans CLAUDE.md ? La recommandation d&rsquo;Anthropic est nette : <em>\u00ab Treat CLAUDE.md as the place you write down what you&rsquo;d otherwise re-explain. \u00bb<\/em> Si Claude fait la m\u00eame erreur deux fois, si une convention attrap\u00e9e en code review devrait aussi \u00eatre connue de Claude, si vous \u00e9crivez aujourd&rsquo;hui la m\u00eame correction que la session pass\u00e9e, ou si un nouveau co\u00e9quipier aurait besoin d&rsquo;un contexte pour \u00eatre productif \u2014 tout cela va dans CLAUDE.md. Les proc\u00e9dures multi-\u00e9tapes ou les r\u00e8gles applicables uniquement \u00e0 un recoin du code vont dans une <strong>skill<\/strong> ou une <strong>path-scoped rule<\/strong>, pas dans CLAUDE.md.<\/p>\n<p>Le mod\u00e8le ci-dessous est le point de d\u00e9part minimal fonctionnel pour un CLAUDE.md en 2026. Copiez-le directement :<\/p>\n<pre><code class=\"language-markdown\"># Project Name\n\n## What this is\nOne-paragraph summary of what the project does and why it exists.\n\n## Tech stack\n- Language: Python 3.12 \/ TypeScript 5.4\n- Framework: FastAPI \/ Next.js 15\n- DB: PostgreSQL 16\n- Tests: pytest + httpx \/ vitest\n\n## Commands\n- Install: `uv sync` \/ `pnpm install`\n- Run dev: `uv run uvicorn app.main:app --reload` \/ `pnpm dev`\n- Test: `uv run pytest -x` \/ `pnpm test`\n- Lint: `uv run ruff check .` \/ `pnpm lint`\n- Typecheck: `uv run mypy app\/` \/ `pnpm typecheck`\n\n## Conventions\n- Type hints everywhere\n- Public functions: docstrings (Google style)\n- Tests live in `tests\/` matching `app\/` structure\n- No global state \u2014 pass dependencies explicitly\n\n## Don't\n- No emoji in code or commits\n- No `print()` for debug \u2014 use `logger.debug()`\n- No new dependencies without justifying in PR description\n- Don't write code comments that just restate what code does\n\n## Common pitfalls\n- DB migrations: run `alembic upgrade head` after pulling\n- The `vendor\/` folder is git-tracked but not editable\n- `pytest` requires `.env.test` (copy from `.env.test.example`)\n\n## Architecture in 3 lines\n- Request \u2192 middleware (auth) \u2192 router \u2192 service \u2192 repository \u2192 DB\n- Async I\/O end-to-end with `asyncpg`\n- Background jobs in `app\/jobs\/` use `arq` (not Celery)\n\n## Imports\n@README.md\n@docs\/architecture.md\n@AGENTS.md\n<\/code><\/pre>\n<p>Deux conseils tir\u00e9s de la pratique de Karpathy : premi\u00e8rement l&rsquo;analogie <em>\u00ab AI is a junior dev with infinite enthusiasm \u00bb<\/em> \u2014 l&rsquo;agent IA ressemble \u00e0 un d\u00e9veloppeur junior talentueux mais amn\u00e9sique qui attend son briefing chaque matin ; CLAUDE.md est ce briefing par \u00e9crit. Deuxi\u00e8mement le principe de <em>\u00ab living memory \u00bb<\/em> : le fichier n&rsquo;est pas un README qu&rsquo;on \u00e9crit une fois et qu&rsquo;on oublie ; il doit grandir avec chaque nouvelle erreur de l&rsquo;IA.<\/p>\n<hr>\n<h2>CLAUDE.md vs Cursor Rules vs ChatGPT Custom Instructions<\/h2>\n<p>Les trois principaux outils de coding IA stockent le contexte d\u00e9veloppeur diff\u00e9remment. En 2026 le <strong>syst\u00e8me CLAUDE.md de Claude Code<\/strong> est le plus riche et le plus hi\u00e9rarchique \u2014 managed\/project\/user\/local + path-scoped rules + auto memory + imports. <strong>Cursor<\/strong> offre une structure similaire via Markdown + YAML frontmatter dans <code>.cursor\/rules\/<\/code>, sans scope utilisateur partag\u00e9. <strong>ChatGPT Custom Instructions<\/strong> est li\u00e9 \u00e0 votre compte OpenAI, stock\u00e9 dans le cloud, deux champs en clair \u2014 pas de contexte projet.<\/p>\n<table>\n<thead>\n<tr>\n<th>Dimension<\/th>\n<th>CLAUDE.md (Claude Code)<\/th>\n<th>Cursor Rules<\/th>\n<th>ChatGPT Custom Instructions<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Emplacement<\/td>\n<td>Repo + user + managed (org)<\/td>\n<td><code>.cursor\/rules\/*.md<\/code><\/td>\n<td>Compte OpenAI (cloud)<\/td>\n<\/tr>\n<tr>\n<td>Hi\u00e9rarchie<\/td>\n<td>4 scopes + imbriqu\u00e9s + auto memory<\/td>\n<td>Projet seulement<\/td>\n<td>Utilisateur seulement<\/td>\n<\/tr>\n<tr>\n<td>Format<\/td>\n<td>Markdown + YAML frontmatter (rules)<\/td>\n<td>Markdown + YAML frontmatter<\/td>\n<td>Texte brut (2 champs)<\/td>\n<\/tr>\n<tr>\n<td>Imports<\/td>\n<td><code>@path<\/code> r\u00e9cursifs 5 sauts<\/td>\n<td>Limit\u00e9s<\/td>\n<td>Aucun<\/td>\n<\/tr>\n<tr>\n<td>Path-scoped rules<\/td>\n<td>\u2705 <code>.claude\/rules\/<\/code> + glob <code>paths<\/code><\/td>\n<td>Partiel<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Auto memory<\/td>\n<td>\u2705 v2.1.59+<\/td>\n<td>\u274c<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Interop AGENTS.md<\/td>\n<td>\u2705 Import <code>@AGENTS.md<\/code><\/td>\n<td>\u274c<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Versioning<\/td>\n<td>Oui (dans Git)<\/td>\n<td>Oui (dans Git)<\/td>\n<td>Non (cloud-only)<\/td>\n<\/tr>\n<tr>\n<td>Partage \u00e9quipe<\/td>\n<td>Oui<\/td>\n<td>Oui<\/td>\n<td>Non<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Recommandation pratique : si vous utilisez tous les outils sur le m\u00eame projet, \u00e9crivez <strong>CLAUDE.md comme source ma\u00eetre<\/strong>, importez AGENTS.md depuis lui, copiez \u00e0 l&rsquo;identique dans <code>.cursor\/rules\/<\/code> pour Cursor. Mettez seulement vos <strong>pr\u00e9f\u00e9rences personnelles<\/strong> dans ChatGPT Custom Instructions (par ex. \u00ab R\u00e9ponds en fran\u00e7ais, commentaires de code en anglais \u00bb) \u2014 les d\u00e9tails de projet n&rsquo;y vont pas car ils s&rsquo;appliquent \u00e0 tous vos projets.<\/p>\n<hr>\n<h2>Conseils pratiques pour les d\u00e9veloppeurs francophones<\/h2>\n<p>L&rsquo;adoption de CLAUDE.md s&rsquo;est rapidement r\u00e9pandue dans la communaut\u00e9 d\u00e9veloppeur francophone \u00e0 partir de fin 2025. On la croise dans des side projects ouverts sur GitHub depuis Paris, Lyon, Montr\u00e9al, Bruxelles. La r\u00e8gle commune est la <strong>coh\u00e9rence linguistique<\/strong> : commentaires de code, messages d&rsquo;erreur, docstrings en anglais ; documentation utilisateur en fran\u00e7ais ; descriptions de PR bilingues. Une seule ligne dans CLAUDE.md suffit : <em>\u00ab Code comments, docstrings, error messages: English. Documentation in <code>docs\/<\/code>: French. PR descriptions: bilingual. \u00bb<\/em><\/p>\n<p>Deuxi\u00e8me sujet r\u00e9current dans les projets francophones : <strong>encoding et locale<\/strong>. UTF-8 (sans BOM), collation <code>utf8mb4_unicode_ci<\/code>, et <code>fr_FR.UTF-8<\/code> explicite dans les tests sensibles au tri sont la pratique standard. Sans cela, les accents et caract\u00e8res sp\u00e9ciaux produisent des r\u00e9sultats incoh\u00e9rents. Troisi\u00e8me bloc critique : <strong>r\u00e9glementation et r\u00e8gles m\u00e9tier locales<\/strong> : conformit\u00e9 RGPD (pas de donn\u00e9es personnelles dans les logs), facture \u00e9lectronique au format Factur-X, formatage des prix en EUR selon <code>f\"{amount:,.2f} \u20ac\"<\/code> \u2014 r\u00e8gles que l&rsquo;IA ne conna\u00eet pas seule.<\/p>\n<p>Dernier conseil : <strong>versionnez CLAUDE.md avec l&rsquo;\u00e9quipe<\/strong>. Fichier sur <code>main<\/code> et review dans chaque PR. Une r\u00e8gle ajout\u00e9e par un d\u00e9veloppeur devient instantan\u00e9ment le standard de l&rsquo;\u00e9quipe car l&rsquo;IA lit toujours la version la plus r\u00e9cente. C&rsquo;est le socle du mouvement par lequel les \u00e9quipes francophones codifient leurs standards techniques avec l&rsquo;IA.<\/p>\n<hr>\n<h2>Foire aux questions sur CLAUDE.md<\/h2>\n<h3>CLAUDE.md et auto memory sont-ils la m\u00eame chose ?<\/h3>\n<p>Non. CLAUDE.md est le fichier que vous \u00e9crivez avec r\u00e8gles et architecture. L&rsquo;auto memory est ce que Claude garde tout seul sous <code>~\/.claude\/projects\/&lt;project&gt;\/memory\/MEMORY.md<\/code> \u2014 pr\u00e9f\u00e9rences d\u00e9duites des corrections pass\u00e9es. Les deux chargent ensemble ; aucun ne remplace l&rsquo;autre. Auto memory disponible \u00e0 partir de Claude Code v2.1.59.<\/p>\n<h3>Que se passe-t-il si <code>~\/.claude\/CLAUDE.md<\/code> et <code>.\/CLAUDE.md<\/code> entrent en conflit ?<\/h3>\n<p>Les deux chargent, le contenu est fusionn\u00e9. En cas de conflit direct, <strong>le niveau projet (.\/CLAUDE.md) l&rsquo;emporte<\/strong> car plus sp\u00e9cifique. Mettez au niveau utilisateur ce que vous voulez dans tous vos projets, au niveau projet ce qui est propre au projet.<\/p>\n<h3>Comment fonctionnent les imports <code>@path<\/code> ?<\/h3>\n<p><code>@README.md<\/code> ou <code>@~\/.claude\/preferences.md<\/code> font int\u00e9grer le fichier dans le contexte. Chemins relatifs et absolus support\u00e9s. R\u00e9cursion maximale de 5 sauts \u2014 un fichier import\u00e9 peut en importer un autre qui en importe un autre, mais le 6e niveau est rejet\u00e9. Au premier import externe une bo\u00eete de dialogue de validation appara\u00eet ; refuser ferme le dialogue durablement.<\/p>\n<h3>Quelle diff\u00e9rence entre <code>.claude\/rules\/<\/code> et CLAUDE.md ?<\/h3>\n<p>CLAUDE.md charge toujours ; les fichiers de <code>.claude\/rules\/<\/code> avec frontmatter <code>paths<\/code> ne chargent que lorsque Claude traite un fichier correspondant. Dans de gros projets, le dossier rules d\u00e9coupe les instructions par sujet\/chemin et <strong>r\u00e9duit la consommation de contexte<\/strong>. Les rules sans frontmatter <code>paths<\/code> ont la m\u00eame priorit\u00e9 que CLAUDE.md.<\/p>\n<h3>Comment les skills, plugins et subagents se relient-ils \u00e0 CLAUDE.md ?<\/h3>\n<p>Les skills sont des modules plus lourds invoqu\u00e9s \u00e0 la demande, non charg\u00e9s \u00e0 chaque session. Les plugins empaquetent serveurs MCP, commandes slash et bundles de skills pour distribution. Les subagents peuvent garder leur propre auto memory (<code>enable-persistent-memory<\/code>). CLAUDE.md sert de couche contextuelle de base sous tout cela ; les flux sp\u00e9cifiques migrent dans les skills.<\/p>\n<h3>Le concept d&rsquo;\u00ab idea file \u00bb de Karpathy a-t-il red\u00e9fini CLAUDE.md ?<\/h3>\n<p>Pas directement, mais il a \u00e9largi son p\u00e9rim\u00e8tre. Le CLAUDE.md classique contient r\u00e8gles et commandes. Dans la proposition d&rsquo;avril 2026 de Karpathy, CLAUDE.md joue en plus le r\u00f4le du <strong>fichier sch\u00e9ma<\/strong> qui g\u00e8re <code>raw\/<\/code> (sources) et <code>wiki\/<\/code> (savoir compil\u00e9 par le LLM). \u00c7a fait passer CLAUDE.md d&rsquo;une liste de commandes au <strong>centre d&rsquo;un syst\u00e8me de gestion de connaissances<\/strong>.<\/p>\n<h3>O\u00f9 suivre Karpathy ?<\/h3>\n<p>Quatre canaux principaux : <strong>YouTube<\/strong> (<a href=\"https:\/\/www.youtube.com\/@AndrejKarpathy\" rel=\"noopener\">@AndrejKarpathy<\/a>) pour les conf\u00e9rences marathon, <strong>X \/ Twitter<\/strong> (<a href=\"https:\/\/x.com\/karpathy\">@karpathy<\/a>) pour les observations quotidiennes, <strong>GitHub<\/strong> (<a href=\"https:\/\/github.com\/karpathy\" rel=\"noopener\">github.com\/karpathy<\/a>) pour les projets open source comme <code>nanogpt<\/code>, <code>nanochat<\/code>, <code>makemore<\/code>, <code>micrograd<\/code>, <code>llm.c<\/code>, et <strong>Eureka Labs<\/strong> (<a href=\"https:\/\/eurekalabs.ai\" rel=\"noopener\">eurekalabs.ai<\/a>) pour les annonces de la plateforme \u00e9ducative IA. Le <strong>gist idea file<\/strong> est directement \u00e0 <a href=\"https:\/\/gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f\" rel=\"noopener\">gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f<\/a>.<\/p>\n<hr>\n<h2>Conclusion : CLAUDE.md, la nouvelle m\u00e9moire du logiciel \u00e0 l&rsquo;\u00e8re de l&rsquo;IA<\/h2>\n<p>CLAUDE.md est une convention d&rsquo;apparence simple qui refa\u00e7onne la nature du d\u00e9veloppement logiciel. En 2026 elle n&rsquo;est plus <strong>un fichier unique<\/strong> mais un syst\u00e8me englobant <strong>quatre scopes, imports, path-scoped rules, auto memory et architecture idea file<\/strong>. Comme le souligne Karpathy : la nouvelle monnaie du logiciel n&rsquo;est pas que du code, c&rsquo;est le contexte que vous donnez \u00e0 l&rsquo;IA. Garder ce contexte persistant, continuellement mis \u00e0 jour et partag\u00e9 en \u00e9quipe est devenu la nouvelle configuration de base des \u00e9quipes logicielles modernes.<\/p>\n<p>Le plan pratique est simple. <strong>Jour un :<\/strong> lancez Claude Code dans n&rsquo;importe quel projet ouvert et ex\u00e9cutez <code>\/init<\/code> (id\u00e9alement avec <code>CLAUDE_CODE_NEW_INIT=1<\/code>). <strong>Jour deux :<\/strong> \u00e9ditez le brouillon g\u00e9n\u00e9r\u00e9 selon le mod\u00e8le de ce guide. <strong>Premi\u00e8re semaine :<\/strong> \u00e0 chaque erreur de l&rsquo;IA, ajoutez une ligne \u00e0 CLAUDE.md avant de la corriger. <strong>Deuxi\u00e8me semaine :<\/strong> partagez avec l&rsquo;\u00e9quipe et int\u00e9grez dans le processus de review PR. <strong>Au bout d&rsquo;un mois :<\/strong> si le fichier approche 200 lignes, scindez via <code>.claude\/rules\/<\/code> et utilisez les imports <code>@path<\/code>. <strong>Trois mois plus tard :<\/strong> envisagez l&rsquo;architecture idea file de Karpathy avec les couches <code>raw\/<\/code> et <code>wiki\/<\/code>.<\/p>\n<p>Recommandation claire : prenez CLAUDE.md au m\u00eame s\u00e9rieux que <code>README.md<\/code>. Chaque ligne ajout\u00e9e en un mois est une erreur que l&rsquo;IA n&rsquo;a pas faite ce mois-l\u00e0. Cet investissement compose \u2014 le rendement cro\u00eet semaine apr\u00e8s semaine.<\/p>\n<hr>\n<h2>Sources<\/h2>\n<ul>\n<li><strong>Anthropic.<\/strong> <em>Claude Code Documentation \u2014 How Claude remembers your project<\/em>. code.claude.com\/docs\/en\/memory (consult\u00e9 : 2026-05-01)<\/li>\n<li><strong>Anthropic.<\/strong> <em>Claude Code: Skills, Plugins, Hooks, Subagents documentation<\/em>. code.claude.com\/docs\/en<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Idea file<\/em> \u2014 gist GitHub, avril 2026. gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Publications X (Twitter)<\/em>, <a href=\"https:\/\/x.com\/karpathy\">@karpathy<\/a> \u2014 tweet idea file du 3 avril 2026 et discussions de suivi.<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Software Is Changing (Again)<\/em> \u2014 keynote, <strong>Y Combinator AI Startup School<\/strong>, 2024. YouTube : youtube.com\/watch?v=LCEmiRjPEtQ<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Software 2.0<\/em>. Medium, novembre 2017. karpathy.medium.com\/software-2-0-a64152b37c35<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <a href=\"https:\/\/github.com\/karpathy\" rel=\"noopener\">github.com\/karpathy<\/a> \u2014 exemples CLAUDE.md et AGENTS.md dans <code>nanogpt<\/code>, <code>nanochat<\/code>, <code>makemore<\/code>, <code>micrograd<\/code>, <code>llm.c<\/code>.<\/li>\n<li><strong>Antigravity Codes.<\/strong> <em>Karpathy&rsquo;s LLM Wiki: The Complete Guide to His Idea File<\/em>. antigravity.codes\/blog\/karpathy-llm-wiki-idea-file<\/li>\n<li><strong>MCP Directory.<\/strong> <em>Claude Code Best Practices: A Developer&rsquo;s Guide (2026)<\/em>. mcp.directory\/blog\/claude-code-best-practices<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>La m\u00e9moire de projet CLAUDE.md de Claude Code (Anthropic) est devenue en 2026 une couche compl\u00e8te de m\u00e9moire avec quatre scopes (managed \/ project \/ user \/ local), la syntaxe d&rsquo;imports @path, l&rsquo;auto memory (v2.1.59+), des r\u00e8gles path-scoped via `.claude\/rules\/` et l&rsquo;interop AGENTS.md. Andrej Karpathy a red\u00e9fini CLAUDE.md en avril 2026 avec son concept d&rsquo;`idea file` comme noyau d&rsquo;une architecture de connaissance \u00e0 3 couches (raw \/ wiki \/ schema). Ce guide couvre toutes ces innovations et les standards 2026 pour \u00e9crire un CLAUDE.md efficace.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4456,9],"tags":[],"class_list":["post-323467","post","type-post","status-publish","format-standard","hentry","category-dijital","category-teknoloji"],"_links":{"self":[{"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/posts\/323467","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/comments?post=323467"}],"version-history":[{"count":0,"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/posts\/323467\/revisions"}],"wp:attachment":[{"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/media?parent=323467"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/categories?post=323467"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ceotudent.com\/fr\/wp-json\/wp\/v2\/tags?post=323467"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}