SetupClaude · Guide complet

01 · Installation Claude CLI

Installe Claude Code dans ton terminal. À faire une seule fois.

1

Vérifie Node.js

Claude Code tourne avec Node.js 18+. Vérifie qu'il est installé :

bash

node --version

Pas installé ? Télécharge la version LTS sur nodejs.org

2

Installe Claude Code

bash

npm install -g @anthropic-ai/claude-code

bash

# Vérifie l'installation
claude --version

3

Connecte ton compte

Connecte Claude à ton compte Anthropic, une page s'ouvre dans le navigateur.

bash

claude login

Utilise ton compte claude.ai. Un abonnement Pro ou une clé API est nécessaire pour une utilisation intensive.

02 · Installation globale du kit

Copie le student kit dans ton profil. À faire une seule fois sur ton PC.

Progression 0 / 5 étapes

Étape 1 : Télécharger et extraire le kit

Télécharge student-kit.zip depuis la section Téléchargements, puis extrais-le dans ton dossier Téléchargements.

Tu dois avoir un dossier student-kit\ dans tes Téléchargements.

Étape 2 : Ouvrir PowerShell

Ouvre PowerShell (le terminal du PC, pas VS Code). Touche Windows → tape "powershell" → Entrée.

Étape 3 : Aller dans le dossier extrait

powershell

cd $HOME\Downloads\student-kit

Étape 4 : Copier les fichiers globaux

powershell

mkdir -Force $HOME\.claude\skills
mkdir -Force $HOME\.claude\agents
Copy-Item -Recurse .\.claude\skills\* $HOME\.claude\skills\
Copy-Item -Recurse .\.claude\agents\* $HOME\.claude\agents\
Copy-Item .\.claude\settings.json $HOME\.claude\settings.json
Copy-Item .\CLAUDE.md $HOME\.claude\CLAUDE.md

Étape 5 : Installer le profil PowerShell

Télécharge claude-profile.ps1, puis :

powershell

# Crée et ouvre ton profil PowerShell
New-Item -Path $PROFILE -ItemType File -Force
notepad $PROFILE

Colle le contenu de claude-profile.ps1 dans Notepad, fais Ctrl+S, ferme. Puis recharge :

powershell

. $PROFILE

Tu dois voir : Kit Claude chargé. Tape aide-claude pour voir les commandes.

Étape 6 : Installer la skill /route

Télécharge route-SKILL.md depuis la section Téléchargements, puis :

powershell

mkdir -Force $HOME\.claude\skills\route
Copy-Item $HOME\Downloads\route-SKILL.md $HOME\.claude\skills\route\SKILL.md

Ce que settings.json configure automatiquement :

Securite — apres chaque fichier cree ou modifie, Claude scanne le contenu pour detecter des secrets en dur (mot de passe, cle API, token, URL MongoDB/JDBC avec identifiants). Si quelque chose est detecte, il t'avertit immediatement.
Protection .env — si tu crees un fichier .env et qu'il n'est pas dans .gitignore, Claude t'alerte avant que tu puisses committer tes secrets.
Demarrage automatique — a chaque nouvelle session, Claude cree tasks/session-log.md, tasks/todo.md et tasks/lessons.md s'ils n'existent pas encore, et injecte leur contenu dans le contexte pour repartir exactement ou tu en etais.
CLAUDE.md auto — si le projet n'a pas encore de CLAUDE.md, Claude en cree un avec les sections PROJET / STACK / COMMANDES / ARCHITECTURE / NOTES a remplir.
Rappel de cloture — a la fin de chaque session, Claude te rappelle de mettre a jour session-log.md et todo.md pour ne rien perdre.
Permissions pre-autorisees — npm run build/test/lint, git status/diff/add/commit/push/pull s'executent sans demande de confirmation.

03 · Nouveau projet

À faire à chaque nouveau projet. Prend 30 secondes.

1

Aller dans ton projet

powershell

cd C:\chemin\vers\ton-projet

2

Initialiser le projet

powershell

nouveau-projet

Copie CLAUDE.md et tasks\ dans le projet actuel.

3

Configurer le CLAUDE.md du projet

Ouvre CLAUDE.md et remplis la section PROJET avec le nom et la description de ton application. Le reste (workflow, règles Java, SQL, MongoDB) est déjà prérempli.

powershell

notepad CLAUDE.md

4

Lancer Claude

powershell

claude

Claude lit automatiquement ton CLAUDE.md et est prêt à travailler.

Ce que tu obtiens dans chaque projet :

CLAUDE.md · mémoire du projet (stack, conventions Java/SQL/MongoDB, workflow). Remplis juste la section PROJET.
tasks/todo.md · plan de session — Claude écrit les tâches ici avant de coder
tasks/lessons.md · erreurs apprises — Claude les relit à chaque démarrage pour ne pas les répéter
tasks/session-log.md · journal de sessions — Claude le met à jour automatiquement à chaque ouverture

Automatique au démarrage : quand tu tapes claude, le hook SessionStart injecte automatiquement le contenu de session-log.md et todo.md dans le contexte. Claude sait exactement où tu en étais — sans que tu aies à réexpliquer.

04 · Le fichier CLAUDE.md

La mémoire persistante de Claude. Il le relit à chaque session.

C'est quoi ?

CLAUDE.md est un fichier Markdown que tu places à la racine de ton projet. Claude le lit automatiquement au démarrage, pas besoin de ré-expliquer le contexte à chaque fois.

✓ Stack et objectifs du projet
✓ Règles de code (conventions, style)
✓ Comportements à éviter
✓ Leçons apprises (éviter de répéter les erreurs)

Plus ton CLAUDE.md est précis, moins tu réexpliquer le contexte.

Où le mettre ?

$HOME\.claude\

CLAUDE.md global

mon-projet\

CLAUDE.md projet

package.json

src\

Global → tes préférences perso, s'applique partout.
Projet → spécificités de la codebase.

Exemple de CLAUDE.md

markdown

## DÉMARRAGE DE SESSION OBLIGATOIRE
1. Lire tasks/session-log.md — reprendre où on s'est arrêtés
2. Lire tasks/todo.md — voir ce qui reste à faire
3. Lire tasks/lessons.md — ne pas répéter les mêmes erreurs

## PROJET
Application de gestion de bibliothèque
Stack : Java + MySQL
Niveau : intermédiaire — exemples concrets, pas de condescendance

## RÈGLES DE CODE
- Toujours fermer les ressources avec try-with-resources
- PreparedStatement obligatoire, jamais de concaténation SQL
- Nommage : classes PascalCase, méthodes camelCase

## COMPORTEMENTS
- Planifier avant de coder pour les tâches 3+ étapes
- Corriger les bugs directement sans demander confirmation
- Réponses courtes et directes

## CLÔTURE DE SESSION OBLIGATOIRE
1. Écrire dans tasks/session-log.md ce qui a été fait
2. Mettre à jour tasks/todo.md avec ce qui reste

## APPRENTISSAGES
# [date] | problème | règle pour éviter
- 2026-01-15 | connexion non fermée | toujours try-with-resources

Sois précis

Vague = réponses vagues. Détaille le contexte.

Mets à jour

Ajoute tes leçons après chaque bug corrigé.

Global vs Projet

Global pour tes préfs perso, projet pour la codebase.

Pas de secrets

Jamais de tokens ou mots de passe dans CLAUDE.md.

Mon CLAUDE.md étudiant

Le vrai fichier que j'utilise : Java, MySQL, MongoDB. Workflow complet avec session-log, sous-agents et leçons auto. Modifie juste la ligne Stack pour l'adapter à ton projet.

⬇ Télécharger CLAUDE.md Voir tous les fichiers →

05 · Commandes PowerShell

Les commandes ajoutées par le profil PowerShell du kit.

Commande	Description
`nouveau-projet`	Copie `CLAUDE.md` et `tasks\` dans le dossier actuel
`nouveau-projet-vide`	Copie uniquement `tasks\` (sans CLAUDE.md)
`aller-projet [chemin]`	Va dans un projet et lance Claude directement
`update-kit`	Met à jour les skills et agents globaux depuis le kit
`aide-claude`	Affiche toutes les commandes disponibles

Exemples d'utilisation

powershell

# Démarrer un nouveau projet
cd C:\projets\mon-app
nouveau-projet
claude

# Aller directement dans un projet
aller-projet C:\projets\mon-app

# Mettre à jour les skills après une mise à jour du kit
update-kit

06 · Skills disponibles

Des slash commands spécialisées, incluses dans le kit. Tape-les directement dans Claude.

Commande	Description	Exemple à copier
/route [tâche]	Savoir si aller dans l'extension VS Code ou le terminal Claude Code
/debug-java	Corriger une erreur Java : colle le stack trace après la commande
/explain [concept]	Comprendre un concept de cours avec analogie, exemple et piège classique
/sql [question]	Écrire, corriger ou optimiser une requête MySQL
/mongo [question]	Aide avec MongoDB : requêtes, agrégations, schémas
/simplify	Simplifier un bloc de code complexe sans changer son comportement
/techdebt	Analyser la dette technique : identifier ce qui est à refactorer
/commit-push-pr	Commit propre + push + Pull Request automatique en une commande

07 · Sous-agents disponibles

Des assistants spécialisés que Claude peut déléguer automatiquement.

tutor

Explique comme un prof : essentiel en une phrase, analogie du quotidien, exemple minimal, piège classique, question de vérification.

java-reviewer

Relit le code Java comme un senior : bugs, NullPointer, ressources non fermées, sécurité SQL, bonnes pratiques.

code-reviewer

Revue de code tous langages : bugs, sécurité, performance, lisibilité, tests manquants.

test-writer

Écrit les tests unitaires : cas nominal, cas limites, cas d'erreur. Vitest ou Jest selon le projet.

doc-generator

Génère la documentation utile : Javadoc, JSDoc, commentaires. Jamais de documentation évidente.

Comment les utiliser

claude

# Demande directement à Claude de déléguer
Utilise le sous-agent tutor pour m'expliquer l'héritage en Java

Délègue l'écriture des tests au sous-agent test-writer

Utilise java-reviewer pour relire ce fichier

08 · Raccourcis dans Claude Code

Les touches et mots-clés qui font toute la différence.

Shift + Tab × 2

Plan Mode

Active le mode planification. Claude réfléchit à voix haute et te soumet un plan avant de toucher le code. Indispensable pour les tâches complexes.

ultrathink

Réflexion profonde

Écris ultrathink dans ton message. Force Claude à analyser très profondément avant de répondre. Utile pour les bugs difficiles.

/voice

Mode vocal

Mode push-to-talk. Maintenir la barre espace pour parler, relâcher pour envoyer.

Ctrl + C

Interrompre

Arrête une réponse en cours immédiatement.

! commande

Shell direct

Exécute une commande shell depuis Claude. Ex : ! git status

Shift + Enter

Saut de ligne

Nouvelle ligne sans envoyer le message.

09 · Workflow quotidien

Les bons réflexes à prendre dès maintenant.

Chaque jour

1Ouvrir PowerShell dans ton projet

2Taper claude : le kit injecte automatiquement session-log.md + todo.md — Claude sait où tu en es

3Shift+Tab × 2 si la tâche est complexe (Plan Mode)

4Si Claude fait une erreur → lui dire "ajoute dans tasks/lessons.md"

powershell

cd C:\projets\mon-app
claude

Chaque nouveau projet

1Aller dans le dossier du projet

2Taper nouveau-projet

3Modifier la ligne Stack dans CLAUDE.md

4Taper claude et commencer

powershell

cd C:\projets\nouveau-projet
nouveau-projet
notepad CLAUDE.md
claude

Le cercle vertueux : Claude lit les leçons → fait moins d'erreurs → tu ajoutes de nouvelles leçons → Claude s'améliore encore. Le fichier tasks/lessons.md est ta mémoire partagée avec lui.

10 · Exemples de prompts

Ce que tu peux demander, clique pour copier.

Java

J'ai une NullPointerException ligne [X]. Lis le stack trace, trouve la cause racine et corrige-la.

cliquer pour copier

Crée la classe [nom] avec les attributs [liste]. Génère les getters, setters et toString.

cliquer pour copier

Ce code ne ferme pas la connexion. Réécris-le avec try-with-resources.

cliquer pour copier

Explique-moi l'héritage en Java avec un exemple concret adapté à mon projet.

cliquer pour copier

Ce code compile pas : [erreur javac]. Corrige et explique pourquoi.

cliquer pour copier

MySQL

Écris une requête JOIN entre [table A] et [table B] pour récupérer [colonnes]. Utilise une PreparedStatement.

cliquer pour copier

J'ai cette erreur MySQL : [message d'erreur]. Qu'est-ce qui cloche dans ma requête ?

cliquer pour copier

Crée la table [nom] avec ces colonnes : [liste]. Ajoute les index utiles.

cliquer pour copier

Explique-moi la différence entre INNER JOIN et LEFT JOIN avec un exemple sur mes tables.

cliquer pour copier

MongoDB

Écris une requête find() pour récupérer [condition] dans la collection [nom].

cliquer pour copier

Crée une agrégation MongoDB pour calculer [résultat] groupé par [champ].

cliquer pour copier

Regarde ce document MongoDB : [exemple]. Est-ce que le schéma est bien structuré ? Améliore-le.

cliquer pour copier

Explique-moi la différence entre find() et aggregate() avec un exemple simple.

cliquer pour copier

Débogage

Corrige ce bug : [colle le stack trace]

cliquer pour copier

Lis les logs et trouve la cause racine du problème.

cliquer pour copier

Pourquoi ce test échoue ? Corrige-le sans changer le comportement.

cliquer pour copier

Comprendre le code

Explique ce que fait cette méthode et pourquoi elle est structurée ainsi.

cliquer pour copier

Fais une revue de code de mes derniers changements. Signale ce qui peut poser problème.

cliquer pour copier

Explore le projet et explique l'architecture en 5 lignes.

cliquer pour copier

Git

Crée un commit propre avec un message clair pour ces changements.

cliquer pour copier

Résume tout ce qui a changé depuis main et crée une PR avec une bonne description.

cliquer pour copier

Bonnes pratiques

A faire

Donne le contexte : fichier, méthode, erreur
Demande de planifier avant d'implémenter
Sois spécifique sur ce que tu attends
Demande une explication si tu ne comprends pas

A eviter

"Améliore mon code" sans préciser quoi
Coller 500 lignes sans contexte
Enchaîner 10 demandes sans valider
Ignorer les warnings de Claude

11 · Téléchargements

Tout est préconfiguré, copie-colle et c'est prêt.

Recommandé

Student Kit

Le setup complet pour un étudiant en développement. Contient CLAUDE.md, agents Java, skills SQL/MongoDB et les templates de tâches.

Contenu :

CLAUDE.md · workflow complet (DÉMARRAGE/CLÔTURE, règles Java/SQL/MongoDB). Modifie juste la section PROJET.
agents/ · java-reviewer, tutor, code-reviewer, test-writer, doc-generator
skills/ · debug-java, explain, sql, mongo, techdebt, commit-push-pr, simplify
tasks/ · todo.md + lessons.md + session-log.md
.claude/settings.json · scan de secrets, protection .env, création auto des fichiers tasks/, injection de contexte au démarrage, rappel de clôture, permissions git/java/npm

Après téléchargement :

powershell

cd $HOME\Downloads\student-kit
mkdir -Force $HOME\.claude\skills
mkdir -Force $HOME\.claude\agents
Copy-Item -Recurse .\.claude\skills\* $HOME\.claude\skills\
Copy-Item -Recurse .\.claude\agents\* $HOME\.claude\agents\
Copy-Item .\.claude\settings.json $HOME\.claude\settings.json
Copy-Item .\CLAUDE.md $HOME\.claude\CLAUDE.md

⬇ Télécharger le kit complet (.zip) ← Reprendre l'installation

Profil PowerShell

Ajoute les commandes nouveau-projet, aide-claude et les raccourcis dans ton terminal Windows.

Ce que ça ajoute :

✓ nouveau-projet · init rapide
✓ aller-projet · navigation
✓ update-kit · mise à jour
✓ aide-claude · aide intégrée

Installation :

powershell

New-Item -Path $PROFILE -ItemType File -Force
notepad $PROFILE
# Coller le contenu → Ctrl+S → fermer → . $PROFILE

⬇ Télécharger claude-profile.ps1 ← Reprendre à l'étape 5

Skill /route

La skill qui aide Claude à savoir s'il faut utiliser l'extension VS Code ou le terminal. À installer une seule fois.

Installation :

powershell

mkdir -Force $HOME\.claude\skills\route
Copy-Item $HOME\Downloads\route-SKILL.md $HOME\.claude\skills\route\SKILL.md

⬇ Télécharger route-SKILL.md ← Reprendre à l'étape 6

Dans le doute, télécharge les deux, installe le profil PowerShell en premier, puis copie le kit. La section 02 · Installation du kit détaille chaque étape.

Historique des versions

Vérifie quelle version tu as en ouvrant VERSION.md depuis ton dossier student-kit.

v1.2

31 mars 2026 · version actuelle

Ajout agents : code-reviewer, test-writer, doc-generator
Ajout skills : techdebt, commit-push-pr, code-simplifier
Correction settings.json manquant dans le zip
Liens de téléchargement migrés vers GitHub (InfinityFree supprimait les .json)
Ajout VERSION.md pour identifier la version installée

v1.1

Mars 2026

Ajout skill /route (extension VS Code vs terminal)
Ajout profil PowerShell avec nouveau-projet, update-kit, aide-claude
Ajout tasks/lessons.md et tasks/todo.md dans le kit

v1.0

Fevrier 2026 · premiere version

Kit de base : CLAUDE.md, agents tutor et java-reviewer
Skills : debug-java, explain, sql, mongo
Premiere version du site SetupClaude

12 · Ça marche pas ?

Les erreurs les plus courantes et comment les régler en 2 minutes.

!

node: command not found / 'node' n'est pas reconnu

Node.js n'est pas installé ou pas dans le PATH.

bash

# Vérifie si Node est installé
node --version
# Si erreur → télécharge Node.js LTS sur nodejs.org

!

npm ERR! permission denied / EACCES

Problème de permissions lors de l'installation globale. Sur Windows, ouvre PowerShell en administrateur.

powershell

# Dans PowerShell en admin :
npm install -g @anthropic-ai/claude-code --force

!

'claude' n'est pas reconnu comme commande

Claude Code est installé mais pas dans le PATH. Ferme et réouvre PowerShell. Si ça persiste :

powershell

# Ajoute npm global au PATH temporairement
$env:PATH += ";" + (npm root -g) + "\..\bin"
npx claude --version

!

PowerShell : "l'exécution de scripts est désactivée"

La politique d'exécution PowerShell bloque les scripts (.ps1). À faire une seule fois :

powershell

# Dans PowerShell en admin :
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Réponds O (Oui) quand PowerShell te demande confirmation.

!

Erreur 401 : Clé API invalide dans le terminal IA

Ta clé API est expirée ou incorrecte. Tape /reset dans le terminal IA du site pour en entrer une nouvelle, ou régénère-en une sur :

bash

https://console.anthropic.com/settings/keys

!

Erreur 400 : Solde insuffisant

Ton compte API n'a plus de crédits. L'abonnement Claude.ai (Pro) ne couvre pas les appels directs à l'API, ce sont deux choses séparées.

Pour utiliser le terminal IA du site ou appeler l'API directement, tu as besoin de crédits API séparés sur console.anthropic.com → Plans & Billing ↗

!

nouveau-projet ne fonctionne pas / commande inconnue

Le profil PowerShell n'est pas chargé ou pas installé correctement. Vérifie :

powershell

# Vérifie si le profil existe
Test-Path $PROFILE
# Recharge-le
. $PROFILE
# Test
aide-claude

Si le profil n'existe pas → reprends l'étape 5 de l'installation.

!

Claude ne lit pas mon CLAUDE.md

Vérifie que le fichier est bien à la racine du projet (là où tu lances claude) et qu'il s'appelle exactement CLAUDE.md (majuscules).

powershell

# Vérifie depuis le dossier du projet
ls CLAUDE.md
# Puis lance Claude
claude

Problème non listé ? Ouvre le terminal en bas à droite et décris ton erreur, Claude t'aidera à diagnostiquer.

13 · Mettre à jour le kit

Quand une nouvelle version sort, une seule commande suffit.

1

Vérifier s'il y a une mise à jour

Les nouvelles versions du kit sont publiées sur GitHub. Regarde si la date du fichier student-kit.zip a changé.

lien

https://github.com/Jibril-Filali/student-kit-claude

2

Télécharger le nouveau kit

Télécharge le zip depuis la section Téléchargements et extrais-le dans ton dossier Téléchargements, en remplaçant l'ancien.

3

Lancer update-kit

La commande update-kit copie les nouveaux agents et skills dans ton profil global. Elle ne touche pas à tes projets existants.

powershell

cd $HOME\Downloads\student-kit
update-kit

Tu dois voir : Skills et agents mis à jour !

Tes projets ne sont pas affectés. update-kit met à jour uniquement les fichiers dans $HOME\.claude\ (global). Tes CLAUDE.md et tasks/ de chaque projet restent intacts.

Guide SetupClaude

01 · Installation Claude CLI

Vérifie Node.js

Installe Claude Code

Connecte ton compte

02 · Installation globale du kit

Étape 1 : Télécharger et extraire le kit

Étape 2 : Ouvrir PowerShell

Étape 3 : Aller dans le dossier extrait

Étape 4 : Copier les fichiers globaux

Étape 5 : Installer le profil PowerShell

Étape 6 : Installer la skill /route

03 · Nouveau projet

Aller dans ton projet

Initialiser le projet

Configurer le CLAUDE.md du projet

Lancer Claude

04 · Le fichier CLAUDE.md

C'est quoi ?

Où le mettre ?

Exemple de CLAUDE.md

Sois précis

Mets à jour

Global vs Projet

Pas de secrets

05 · Commandes PowerShell

Exemples d'utilisation

06 · Skills disponibles

07 · Sous-agents disponibles

Comment les utiliser

08 · Raccourcis dans Claude Code

09 · Workflow quotidien

10 · Exemples de prompts

Java

MySQL

MongoDB

Débogage

Comprendre le code

Git

Bonnes pratiques

11 · Téléchargements

Student Kit

Profil PowerShell

Skill /route

Historique des versions

31 mars 2026 · version actuelle

Mars 2026

Fevrier 2026 · premiere version

12 · Ça marche pas ?

node: command not found / 'node' n'est pas reconnu

npm ERR! permission denied / EACCES

'claude' n'est pas reconnu comme commande

PowerShell : "l'exécution de scripts est désactivée"

Erreur 401 : Clé API invalide dans le terminal IA

Erreur 400 : Solde insuffisant

nouveau-projet ne fonctionne pas / commande inconnue

Claude ne lit pas mon CLAUDE.md

13 · Mettre à jour le kit

Vérifier s'il y a une mise à jour

Télécharger le nouveau kit

Lancer update-kit

Clé API Anthropic