Formation Claude Code 2.0 : La SEUL formation dont tu as besoin (TUTO COMPLET)

Cloud Code est présenté comme un outil développé par Anthropic conçu pour assister les développeurs et autres utilisateurs dans l'exécution de tâches informatiques complexes. Cette masterclass vise à fournir une maîtrise complète de la version 2.0 de Cloud Code afin de permettre la création d'applications directement via cet environnement. L'outil est accessible via le site cloud.com/product/cloudcode. Pour débuter l'installation, il est impératif que l'environnement Node JS soit préalablement installé sur la machine de l'utilisateur.

L'installation de Cloud Code s'effectue en exécutant une commande spécifique dans le terminal, un outil de contrôle de l'ordinateur par lignes de commande. Si une erreur survient lors de l'exécution, cela indique souvent l'absence de Node JS. L'installation de Node JS se fait en sélectionnant les paramètres appropriés pour le système d'exploitation (macOS, Windows, Linux) sur le site officiel, puis en collant la commande fournie dans le terminal. Pour ouvrir le terminal sur macOS, la combinaison Commande + Espace suivie de la recherche de "terminal" est recommandée.

Une fois Cloud Code installé, l'étape suivante consiste à se connecter en tapant simplement `cloud` dans le terminal. L'interface initiale propose le choix d'un thème ; le mode sombre est suggéré pour une meilleure expérience visuelle. Deux méthodes de connexion sont disponibles : l'utilisation de la clé API, qui implique un paiement basé sur l'usage réel, ou l'abonnement au compte Cloud.

L'usage peut aller assez vite hein. Si ici je t'ouvre un terminal qui permet de voir combien j'ai dépensé de dollars ces derniers temps, on peut voir qu'ici je suis à $569 dépensés.

Une session est définie comme une période de 5 heures durant laquelle un nombre limité de messages peut être envoyé selon l'abonnement choisi. Après l'expiration de cette période, un nouveau bloc de 5 heures avec le même quota de messages devient disponible. Après avoir sélectionné et souscrit à l'abonnement souhaité, l'utilisateur doit choisir l'option "Cloud account with subscription" dans le terminal, ce qui ouvre le navigateur pour finaliser l'autorisation.

L'autorisation se confirme en cliquant sur le bouton d'autorisation dans le navigateur, menant au message de connexion réussie. Il est ensuite demandé de faire confiance au lancement de Cloud Code dans le répertoire courant, ce qui est validé par la saisie de "yes". Une fois cette étape franchie, l'interface de Cloud Code est opérationnelle et prête à recevoir des instructions pour le codage.

Pour tester les fonctionnalités, il est conseillé de naviguer vers un répertoire de projet spécifique en utilisant des commandes de terminal comme `mkdir` et `cd`. L'interface affiche alors des informations contextuelles, telles que le modèle IA actuellement utilisé, le modèle 4.5 étant le plus performant au moment de la démonstration. L'interface de base montre les astuces (tips) et l'activité récente (recent activity).

Cloud code est une interface de chat. OK ?

La fonctionnalité principale de Cloud Code est son interface de chat. Il est possible de lui demander de créer des fichiers directement. Par exemple, une requête pour générer un fichier `index.html` servant de page d'atterrissage (landing page) pour une application d'upload d'images est exécutée, montrant l'IA travaillant avec un processus de réflexion visible.

Lors de la création de fichiers, l'IA peut générer un contenu substantiel. Après la génération, une confirmation est demandée pour accepter les modifications sur l'ordinateur. Pour visualiser et interagir avec le fichier créé, l'installation de Visual Studio Code est nécessaire. VS Code est un éditeur de code visuel gratuit et open-source.

Pour permettre à Cloud Code d'interagir avec VS Code via le terminal, une extension de shell doit être installée. Ceci s'effectue dans VS Code en utilisant la palette de commandes (`Commande + Shift + P`), en tapant `code paf` et en sélectionnant `shell command install code command in path`. Une fois cette commande installée, l'utilisateur peut basculer en mode Bash en utilisant le préfixe point d'exclamation (`!`) pour exécuter des commandes système, comme `!code .` pour ouvrir le projet actuel dans VS Code.

Bien que le terminal offre une flexibilité maximale, il est possible d'utiliser l'interface graphique de l'extension Cloud Code dans VS Code, ce qui peut être plus confortable pour certains utilisateurs. Il est requis d'installer l'extension Cloud Code for VS Code, en s'assurant que la version installée est supérieure à 2.0.

En cliquant sur l'icône dédiée dans la barre latérale de VS Code, l'interface de chat de Cloud Code s'affiche, répliquant la conversation précédente. Cette interface permet de créer de nouvelles conversations dans des onglets séparés. Un bouton permet de changer le mode d'édition actif, ce qui est crucial pour contrôler la granularité des modifications apportées par l'IA.

Quand ici je lui dis change le titre de index.html, pour taguer un fichier, tu peux faire commande AT et écrire index.hthtml.

Le mode initial, Ask Before Edit (orange), exige une validation explicite pour chaque modification apportée au code. Si l'utilisateur répond positivement sans demander de confirmation future, le système bascule en mode Edit Automatically, où les changements sont appliqués sans intervention manuelle supplémentaire.

L'outil propose trois modes distincts pour gérer l'interaction avec les modifications de code. Le mode Edit Automatically (blanc) applique les changements immédiatement. Le Plan Mode (bleu) est conçu pour interdire toute modification directe du code et force l'IA à proposer d'abord un plan d'action détaillé. Le mode par défaut, Ask Before Edit (orange), sollicite une confirmation pour chaque édition.

L'interface graphique permet d'interroger l'IA pour améliorer des fonctionnalités existantes, par exemple en demandant de rendre une page web plus moderne. Bien que l'extension soit pratique, le terminal est privilégié pour la suite du tutoriel en raison de ses capacités étendues. Il est également possible d'intégrer le terminal Cloud Code directement dans VS Code via `Commande + Shift + P` puis en créant un nouveau terminal intégré.

Le Thinking Mode permet à l'IA de réfléchir plus profondément à une fonctionnalité demandée. Il s'active via la touche Tab, signalée par le passage des bordures en bleu lorsque le mode est actif. Un outil externe, Voice Ink, est introduit pour la saisie vocale, offrant une alternative moins coûteuse que d'autres solutions comme Super Whisper, avec un paiement unique de $39 ou $25.

En utilisant la saisie vocale, il est possible de dicter des instructions très détaillées, comme la création d'une barre latérale responsive se transformant en menu burger sur mobile. L'IA analyse ensuite les fichiers existants, comme `index.html`, pour contextualiser sa réponse. Les processus de réflexion de l'IA peuvent être visualisés en temps réel en utilisant le raccourci `Contrôle + O`.

Le thinking va avoir tendance à rendre l'aia plus intelligente et à faire des meilleurs résultats en moyenne suivant la complexité surtout que tu veux faire.

Il est fortement recommandé de maintenir le mode Thinking activé pour garantir une meilleure qualité de résultat, surtout pour des tâches complexes. Une fois la fonctionnalité générée, la réactivité du menu burger en mode responsive est testée pour valider l'implémentation.

Après avoir validé la fonctionnalité responsive, l'attention se porte sur la gestion de la mémoire de Cloud. La mémoire persistante est gérée par le fichier `cloud.md`, généré via la commande `/init`. Ce fichier agit comme un ensemble de règles injectées à chaque interaction avec l'IA, influençant directement le résultat des requêtes futures.

Le fichier `cloud.md` contient des directives. Par exemple, une règle peut être ajoutée stipulant que la couleur primaire de l'application doit toujours être `indigo 500`. Si l'utilisateur demande ensuite une modification de style, l'IA utilisera cette règle mémorisée pour appliquer la couleur correcte, démontrant ainsi l'utilité de cette mémoire contextuelle pour maintenir la cohérence du projet.

L'un des usages puissants de `cloud.md` est de définir des commandes rapides pour des tâches récurrentes, comme le lancement du serveur de développement. Dans cet exemple, l'instruction est donnée à l'IA de configurer un projet Vite avec `npm` et de documenter les commandes disponibles dans le fichier `cloud.md` pour les sessions futures.

Lors de l'exécution de commandes shell par l'IA, une autorisation est requise. L'utilisateur peut choisir d'autoriser une commande spécifique (`npm init`) ou de généraliser l'autorisation via un fichier de configuration dans le répertoire `.cloud/settings.json`. En supprimant le paramètre spécifique, l'autorisation est étendue à toutes les commandes `npm`.

Et donc là, tu peux voir que c'est typiquement l'usage du fichier cloud.md qu'il faut faire, c'est de lui donner les différentes commandes.

Une fois la configuration mise à jour, l'IA peut exécuter des commandes mémorisées, comme lancer le serveur de développement. Ceci se manifeste par l'apparition d'une tâche en arrière-plan (`background task`), indiquant que le serveur est lancé et accessible, par exemple sur un port spécifique.

L'exécution des commandes de serveur se fait via des tâches en arrière-plan. Ces tâches sont accessibles en utilisant la flèche du bas dans le terminal, permettant de naviguer dans l'historique des processus lancés. Il est possible d'arrêter complètement un processus en utilisant la touche K, ce qui supprime la tâche du serveur.

L'injection de commandes personnalisées se fait en utilisant le préfixe slash (`/`). Pour structurer le travail de l'IA de manière optimale, il est recommandé de créer des commandes qui suivent le workflow EPCT (Explore, Plan, Code, Test). Un exemple montre comment demander à l'IA de rédiger une commande complexe en lui fournissant la documentation pertinente.

Il existe trois catégories de commandes utilisables avec Cloud Code. Les commandes de projet partagées résident dans le dossier `/cloud/commands` du projet et sont publiées sur GitHub. Les commandes personnelles, stockées dans le répertoire `.cloud/commands`, ne sont pas partagées avec l'équipe. Enfin, des commandes CLI externes peuvent être intégrées pour étendre les fonctionnalités natives.

Pour obtenir rapidement l'ensemble des commandes avancées et des configurations utilisées par l'auteur, il est possible d'accéder à un outil CLI via l'adresse mlv.sh/cccli. Cet outil permet d'installer des commandes pour le commit, le débogage, et d'autres utilitaires essentiels. L'utilisation du workflow EPCT permet ensuite de créer des fonctionnalités complexes, comme une application multipage, en guidant l'IA à travers les étapes d'exploration et de planification.

Plusieurs commandes intégrées permettent de gérer l'environnement, telles que `/config` pour ajuster les paramètres (modèle, désactivation des astuces) ou `/status` pour vérifier la santé des connexions et des fichiers mémoire. La commande `/usage` affiche la consommation actuelle de la session, qui se réinitialise périodiquement.

La commande `/rewind` est essentielle pour la gestion des erreurs. Elle affiche l'historique des conversations et les changements de code associés. Si une modification récente n'est pas souhaitée, l'utilisateur peut sélectionner l'étape correspondante et choisir de restaurer uniquement le code (`restore code`) ou à la fois le code et la conversation (`restore code and conversation`).

Cloud Code intègre une liste de tâches dynamique. Lorsque l'IA exécute une séquence d'actions, elle met à jour cette liste. En utilisant `Contrôle + T`, l'utilisateur peut visualiser cette liste de tâches et observer comment l'IA coche chaque étape au fur et à mesure de son exécution, même si l'utilisateur interrompt le processus.

En plus de la mémoire globale, des informations peuvent être sauvegardées spécifiquement pour le projet courant. Par exemple, l'instruction "code always write code in English" peut être ajoutée à la mémoire du projet. Cette information est alors persistante et sera toujours prise en compte par l'IA lors des interactions futures dans ce contexte.

Il est fortement déconseillé d'ajouter un grand nombre de MCP (Memory Context Providers) car chacun augmente le contexte utilisé, réduisant ainsi l'espace disponible pour les informations importantes de la tâche en cours. Pour des intégrations spécifiques comme la gestion de dépôts, l'utilisation d'outils CLI dédiés est préférée.

L'installation du GitHub CLI (via `brew install github-cli`) permet à Cloud Code d'interagir avec GitHub sans nécessiter un MCP spécifique. L'IA est alors capable d'exécuter des commandes Git pour initialiser un projet, gérer les commits et créer des dépôts privés en utilisant cet outil externe, préservant ainsi le contexte pour d'autres tâches.

Plus tu as de MCP, plus tu vas utiliser du contexte et moins tu auras de la place pour ce qui est important.

Le seul MCP recommandé est Context Seven, qui facilite la récupération d'informations de documentation sans nécessiter une recherche internet. Son activation requiert une connexion via GitHub et la fourniture de la clé API correspondante pour charger les contextes documentaires nécessaires.

Les agents sont des entités spécialisées créées pour exécuter des fonctions précises, comme l'agent `explorecode.md`. La création d'un agent nécessite de lui fournir d'abord les meilleures pratiques de prompt engineering et ensuite la documentation spécifique à sa tâche. L'agent reçoit un prompt et retourne un output ciblé, sans polluer le contexte de l'agent principal.

Un agent spécialisé, tel que celui pour l'exploration de code, est conçu pour lire la base de code, analyser les fichiers pertinents et retourner des informations structurées (snippets, chemins de fichiers) à l'agent principal. Ceci est crucial pour les tâches complexes, car cela permet de maintenir la clarté du contexte principal tout en bénéficiant d'une analyse approfondie.

La fonctionnalité la plus avancée est l'invocation d'agents parallèles. Pour une tâche nécessitant une exploration large, comme l'ajout d'une nouvelle page de CGV, il est possible d'invoquer plusieurs agents d'exploration simultanément. Ces agents travaillent en parallèle pour collecter des données et retournent leurs résultats à l'agent principal.

La version 2.0 de Cloud Code offre une suite complète d'outils, allant de la configuration initiale via le terminal à l'utilisation d'agents parallèles pour des tâches d'ingénierie logicielle avancées. L'intégration profonde avec VS Code et la gestion de la mémoire via `cloud.md` permettent un flux de travail de développement assisté par IA très puissant. Pour des configurations plus poussées, une masterclass gratuite est disponible via le lien mlv.sh/ai/ai.