Projets avec Claude Code : grandes bases de code, tests et Git

01

S'orienter dans une base de code

In simple words

Quand vous entrez dans une grande bibliothèque, vous ne lisez pas tous les livres. Vous demandez où sont les plans, quelle étagère contient quoi et qui connaît l'immeuble. Claude Code peut être votre guide. Vous lui demandez d'abord le plan, et seulement ensuite vous choisissez une étagère sur laquelle travailler.

Key facts

Claude Code fonctionne dans n'importe quel dossier et relit les fichiers à neuf à chaque appel d'outil. Commencez large ("give me an overview of this codebase"), puis précisez ("how is authentication handled?").
Recettes de demandes officielles à essayer : "explain the main architecture patterns used here", "what are the key data models?", "trace the login process from front-end to database".
Tapez @ et un chemin pour inclure un fichier ou un dossier dans votre message, par exemple @src/utils/auth.js. Une référence à un dossier affiche la liste des fichiers, pas leur contenu. Les fichiers de plus de 256 Ko ne sont pas inclus.
Explorer remplit votre contexte de lectures de fichiers. La documentation suggère de déléguer : "use a subagent to investigate how our auth system handles token refresh". Le sous-agent lit dans sa propre fenêtre de contexte et renvoie un résumé.
Une demande précise évite un tour de corrections. Nommez le fichier, décrivez le symptôme et dites à quoi ressemble « corrigé ». Faible : "fix the login bug". Fort : "users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it".
Lancez /context all dans une session pour vérifier quels fichiers, comme CLAUDE.md, ont été chargés.

Exemple project used in this course (Python)

tipcalc/
 __init__.py
 pricing.py   # tip(amount, percent)
 split.py    # split_bill(amount, percent, people)
tests/
 __init__.py
 test_split.py

Step by step

Ouvrez un terminal dans un projet d'au moins cinq fichiers (le vôtre, ou n'importe quel petit projet à code source ouvert). Lancez claude.
Tapez : give me an overview of this codebase. Lisez la réponse.
Demandez : what are the key modules, and how do they depend on each other?
Choisissez un fichier et demandez : Explain the logic in @path/to/file (tapez le vrai chemin après le @).
Demandez : where is the code that handles the most important feature, and which tests cover it?
Écrivez le plan dans vos propres mots dans un fichier de notes : modules, rôle de chacun, emplacement des tests.
Vérification : vous pouvez expliquer, sans regarder, quel fichier vous ouvririez pour modifier une fonctionnalité donnée.

Watch on YouTube

Claude Code best practices from AnthropicAnthropic · YouTube · youtube.com

Videos by other creators on YouTube, for reference. They are not made by or affiliated with The Future Market.

LESSON 01S'orienter dans une base de code

LESSON 01 / ANIMATED LESSON / ENGLISH VOICE00:00 / 01:00

Voice

Read the video script

[Host] "Une grosse base de code? Ne la lisez pas en entier. Demandez un plan."
[Screen: Claude Code répond à 'give me an overview of this codebase'] "Commencez large, puis précisez."
[Text on screen: @path/to/file] "Utilisez l'arobase pour désigner un seul fichier."
[Screen: le résumé d'un sous-agent] "Laissez un sous-agent lire beaucoup de fichiers et ne rapporter que le résumé."
[Host] "Votre propre plan, dans vos propres mots, voilà le vrai but."

Try it now

Choisissez un projet de plusieurs fichiers. Suivez les étapes ci-dessus pour écrire un plan d'une page : modules, circulation des données et emplacement des tests. Ensuite, demandez à Claude de relever une chose fausse ou manquante dans votre plan.

ClaudeStuck? Copy a ready-made prompt for Claude

Copy this, open Claude, paste it, and Claude will walk you through the lesson step by step.

For a grown-up: Claude is for adults (18+). Copy this, paste it into Claude, and use the answer to explain the lesson to your child.

I'm learning "Projets avec Claude Code : grandes bases de code, tests et Git" on The Future Market. Lesson 1: "S'orienter dans une base de code".

What the lesson teaches:
- Claude Code fonctionne dans n'importe quel dossier et relit les fichiers à neuf à chaque appel d'outil. Commencez large ("give me an overview of this codebase"), puis précisez ("how is authentication handled?").
- Recettes de demandes officielles à essayer : "explain the main architecture patterns used here", "what are the key data models?", "trace the login process from front-end to database".
- Tapez @ et un chemin pour inclure un fichier ou un dossier dans votre message, par exemple @src/utils/auth.js. Une référence à un dossier affiche la liste des fichiers, pas leur contenu. Les fichiers de plus de 256 Ko ne sont pas inclus.
- Explorer remplit votre contexte de lectures de fichiers. La documentation suggère de déléguer : "use a subagent to investigate how our auth system handles token refresh". Le sous-agent lit dans sa propre fenêtre de contexte et renvoie un résumé.
- Une demande précise évite un tour de corrections. Nommez le fichier, décrivez le symptôme et dites à quoi ressemble « corrigé ». Faible : "fix the login bug". Fort : "users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it".
- Lancez /context all dans une session pour vérifier quels fichiers, comme CLAUDE.md, ont été chargés.

The exercise I'm working on:
Choisissez un projet de plusieurs fichiers. Suivez les étapes ci-dessus pour écrire un plan d'une page : modules, circulation des données et emplacement des tests. Ensuite, demandez à Claude de relever une chose fausse ou manquante dans votre plan.

I'm stuck. Please:
1. Explain the main idea in plain, simple words with one everyday example.
2. Walk me through the exercise one small step at a time. Ask me what I've done so far before giving the next step.
3. Don't just give me the final answer. Help me do it myself, and check my work when I share it.

I'm a parent helping my child (about 8 years old) with a lesson called "S'orienter dans une base de code" from the course "Projets avec Claude Code : grandes bases de code, tests et Git".

Here's what the lesson says:
Quand vous entrez dans une grande bibliothèque, vous ne lisez pas tous les livres. Vous demandez où sont les plans, quelle étagère contient quoi et qui connaît l'immeuble. Claude Code peut être votre guide. Vous lui demandez d'abord le plan, et seulement ensuite vous choisissez une étagère sur laquelle travailler.

The activity:
Choisissez un projet de plusieurs fichiers. Suivez les étapes ci-dessus pour écrire un plan d'une page : modules, circulation des données et emplacement des tests. Ensuite, demandez à Claude de relever une chose fausse ou manquante dans votre plan.

Please explain this so an 8-year-old understands: short sentences, a fun everyday example, and no hard words.
Then give me 3 simple questions I can ask my child to check they understood, and a way to do the activity together, one tiny step at a time.

Open Claude

Sources

Claude Code docs, Common workflows (Understand new codebases, Reference files and directories, Delegate research to subagents): code.claude.com/docs/en/common-workflows
Claude Code docs, Best practices (Write a specific prompt): code.claude.com/docs/en/best-practices

My notes

I learned this

02