Retour aux podcastsClaude
Claude Code 101
Le fichier CLAUDE.md
[Music starts]
[Music starts]
One of the most useful parts of Claude Code is the claude.md file.
L'une des parties les plus utiles de Claude Code est le fichier CLAUDE.md.
It gives Claude Code persistent memory about your project.
Il donne a Claude Code une memoire persistante sur votre projet.
When you open up Claude Code without a claude.md file, it's like it has to start fresh every single time.
Quand vous ouvrez Claude Code sans fichier CLAUDE.md, c'est comme s'il devait repartir de zero.
It has to re-explore your codebase, understand what dependencies are needed and the features that are already implemented.
Il doit ré-explorer votre base de code, comprendre les dépendances nécessaires et les fonctionnalités en place.
Sometimes it has to make assumptions which makes it harder for us to steer Claude in the right direction.
Parfois il doit faire des suppositions, ce qui rend plus difficile pour nous d'orienter Claude dans la bonne direction.
But that's where claude.md comes in.
Mais c'est la que CLAUDE.md intervient.
It's a markdown file that you add to the root of your project and Claude Code reads it automatically every time you start a session.
C'est un fichier Markdown que vous ajoutez à la racine de votre projet et que Claude Code lit automatiquement à chaque session.
It's like an onboarding script for your codebase.
C'est comme un script d'onboarding pour votre base de code.
Simply put, the contents of claude.md file are appended to your own prompt. You can run the /init command which will make Claude generate one based off of your codebase.
En résumé, le contenu du fichier claude.md est ajouté à votre prompt. Lancez /init et Claude en générera un à partir de votre codebase.
So let's have a look at one.
Regardons-en un exemple.
This is a Next.js 15 app using the app router, Tailwind, and Drizzle ORM.
C'est une application Next.js 15 utilisant App Router, Tailwind et Drizzle ORM.
Commands: dev server, run tests, lint.
Commandes : serveur de developpement, lancer les tests, lint.
Code style: use two space indentation, prefer named exports, all API routes go in app/api, use server actions instead of API routes where possible.
Style de code : indentation de deux espaces, exports nommés, routes API dans app/api, préférer Server Actions aux routes API.
And it's pretty straightforward.
Et c'est assez simple.
Now, if I ask Claude Code to create a React component, it knows how to style it with Tailwind or any other CSS framework that I'm using.
Si je demande à Claude Code de créer un composant React, il sait comment le styliser avec Tailwind ou tout autre framework CSS que j'utilise.
We can see that Claude does a better job at doing its job right off the bat versus having to understand where everything is at first.
Nous pouvons voir que Claude fait un meilleur travail dès le départ plutôt que de devoir d'abord comprendre où tout se trouve.
And before you ask, the answer is yes.
Et avant que vous demandiez, la reponse est oui.
You share this in your version control for your team to use.
Vous partagez ceci dans votre controle de version pour que votre equipe puisse l'utiliser.
But there's actually a hierarchy of memory files depending on who it's for.
Mais il y a en fait une hierarchie de fichiers memoire selon pour qui c'est.
So first you have your project-level claude.md that lives in the root directory of your project.
D'abord, vous avez votre CLAUDE.md au niveau projet qui se trouve dans le repertoire racine.
You have a user-level claude.md that lives in your configuration folder.
Vous avez un CLAUDE.md au niveau utilisateur qui se trouve dans votre dossier de configuration.
This one is just for you and goes across all your projects.
Celui-ci est juste pour vous et s'applique a tous vos projets.
So put your personal preferences here, like how you write code comments.
Mettez vos préférences personnelles ici, comme la façon dont vous écrivez les commentaires de code.
First, if you have to correct Claude to do something, like always use server actions instead of API routes, then explicitly ask Claude to save this to memory so that when you come back to this project, it will know every single time.
Premièrement : si vous devez corriger Claude, par exemple utiliser Server Actions au lieu des routes API, demandez-lui d'enregistrer cela en mémoire ; il s'en souviendra à chaque retour.
Second, if you have docs in your project that you want Claude to reference, just use the @ symbol with the file path.
Deuxièmement : pour les docs à consulter par Claude, utilisez le symbole @ avec le chemin.
And third is we recommend you start off a project without a claude.md file so you can see where you have to constantly course correct the model.
Troisièmement : commencez un projet sans fichier Claude.md pour voir où vous devez constamment corriger le modèle.
This keeps your claude.md file compact and contains only the necessary information that Claude can work with.
Cela garde votre fichier CLAUDE.md compact et ne contient que les informations necessaires.
[Music transition]
[Music transition]
The difference between a frustrating Claude Code session and a productive one comes down to the context, and the claude.md file's how you provide that context.
La différence entre une session Claude Code frustrante et une productive vient du contexte, et claude.md est la façon dont vous fournissez ce contexte.
Start with your stack, your preferences, and then commands, and just build from there as you go.
Commencez avec votre stack, vos preferences, puis les commandes, et construisez a partir de la.