Formation — Claude pour le code (1h)

Hypothèse : cette formation couvre à la fois l'usage de Claude (chat) pour des tâches de code, et les commandes principales de Claude Code (l'outil en ligne de commande). Dis-moi si tu veux recentrer sur l'un ou l'autre.

1. Introduction — Claude et le code (5 min)

• Deux façons d'utiliser Claude pour coder :
  • Claude.ai / l'app : poser des questions, coller du code, demander des explications ou des corrections ponctuelles
  • Claude Code : un outil en ligne de commande (ou dans l'IDE) qui peut lire un projet entier, écrire des fichiers, exécuter des commandes, faire des commits, etc.
• Message clé : Claude.ai = assistant ponctuel ; Claude Code = agent qui travaille directement dans le projet.

2. Utiliser Claude (chat) pour coder (15 min)

• Cas d'usage simples

  • Expliquer un bout de code ("qu'est-ce que fait cette fonction ?")
  • Déboguer une erreur (coller le message d'erreur + le code concerné)
  • Générer une fonction à partir d'une description
  • Revoir/améliorer du code existant (lisibilité, performance, bonnes pratiques)
  • Convertir du code d'un langage à un autre

• Bonnes pratiques pour bien formuler une demande de code

  • Préciser le langage et la version (ex : Python 3.11, PHP 8.2)
  • Donner le contexte du projet si pertinent (framework utilisé, contraintes)
  • Coller le code exact plutôt que le décrire de mémoire
  • Demander explicitement le format voulu (fonction seule, fichier complet, avec tests...)

• Démonstration live

  • Coller un extrait de code avec un bug, demander une correction + explication
  • Demander une revue de code sur une fonction existante

Exercice pratique (5 min) : chaque participant colle une fonction de son travail et demande une amélioration ou une explication.

3. Claude Code — présentation et commandes principales (25 min)

Les commandes exactes disponibles dépendent de la version installée et du plan ; /help dans une session affiche toujours la liste à jour.

• Démarrage

  • Lancer Claude Code dans le dossier d'un projet
  • /init : génère un fichier de contexte du projet (structure, commandes courantes, conventions) pour que Claude comprenne le projet plus vite dans les sessions suivantes

• Gestion de la conversation

  • /clear : réinitialise la conversation (repart sans l'historique précédent)
  • /compact : résume la conversation en cours pour libérer du contexte tout en gardant l'essentiel — utile sur les sessions longues

• Aide et configuration

  • /help : liste toutes les commandes disponibles dans la session actuelle
  • /model : changer de modèle en cours de session
  • /memory : consulter/éditer ce que Claude Code retient sur le projet

• Qualité et revue de code

  • Commandes de revue de code / analyse de sécurité (le nom exact varie selon la version — vérifier avec /help)

• Commandes personnalisées

  • Possibilité de créer ses propres commandes (fichiers dans un dossier dédié au projet ou personnel), pour encoder des workflows répétitifs de l'équipe (ex : une commande "revue de PR" avec le format attendu par l'équipe)

Démonstration live (10 min) : montrer /init sur un vrai projet, puis /clear et /compact, puis taper /help pour montrer la liste réelle des commandes disponibles.

4. Comment fonctionnent les tokens (10 min)

• Qu'est-ce qu'un token ?

  • L'unité de texte que le modèle manipule — pas exactement un mot : souvent un mot court, un morceau de mot plus long, ou un symbole de code
  • Exemple simple : "programmation" peut être découpé en plusieurs tokens, alors que "le" est un token entier

• Pourquoi c'est important

  • Chaque échange (message envoyé + réponse reçue + tout l'historique de la conversation) consomme des tokens
  • Chaque modèle a une limite de contexte (nombre maximal de tokens qu'il peut "voir" en même temps : conversation + fichiers collés + réponse)
  • Coller un très gros fichier ou un historique très long peut donc remplir cette limite

• Conséquences concrètes pour l'utilisateur

  • Une conversation très longue peut nécessiter de la résumer (/compact dans Claude Code) ou d'en ouvrir une nouvelle
  • Coller uniquement la portion de code pertinente plutôt que tout le projet accélère les réponses et évite d'atteindre la limite
  • Le code (surtout très verbeux ou avec beaucoup de caractères spéciaux) peut consommer plus de tokens qu'un texte équivalent en langage naturel

Petit exercice mental : montrer une conversation qui s'allonge et demander au groupe "à votre avis, que se passe-t-il quand on atteint la limite ?" avant d'expliquer.

5. Limites et bonnes pratiques (5 min)

• Toujours relire et tester le code généré — Claude peut produire du code qui semble correct mais contient des erreurs subtiles
• Ne jamais faire confiance aveuglément à du code touchant à la sécurité (authentification, gestion de secrets, permissions) sans revue humaine
• Attention à ne pas coller de données sensibles (clés API, mots de passe, données clients) dans les prompts
• Pour Claude Code : toujours vérifier les diffs avant de valider un commit généré automatiquement

Matériel à préparer avant la séance

• Un projet de démonstration installé avec Claude Code fonctionnel
• 2-3 extraits de code avec bugs volontaires pour la démo du bloc 2
• Accès Claude.ai pour chaque participant
• Vérifier en amont les commandes réellement disponibles dans la version installée (via /help), car elles évoluent selon les mises à jour