[{"data":1,"prerenderedAt":36},["ShallowReactive",2],{"doc:fr:quick-start":3},{"title":4,"lede":5,"html":6,"headings":7},"Prise en main","Une première session pas à pas : ajouter un projet, créer un agent, choisir son modèle, son effort et son mode de permission, lui confier une demande, répondre à ses questions, relire ce qu’il a changé et commiter.","\u003Ch2 id=\"avant-de-commencer\">Avant de commencer\u003C\u002Fh2>\n\u003Cp>Il te faut Claude Code installé et connecté à ton compte Claude, et git (voir l’\u003Ca href=\"\u002Fdocs\u002Finstallation\u002F\">installation\u003C\u002Fa>). Sous macOS, \u003Ccode class=\"key\">Ctrl\u003C\u002Fcode> devient \u003Ccode class=\"key\">⌘\u003C\u002Fcode> dans les raccourcis de cette page.\u003C\u002Fp>\n\u003Ch2 id=\"ajouter-un-projet\">Ajouter un projet\u003C\u002Fh2>\n\u003Cp>Un projet est un dossier de code. Sur l’écran d’accueil, clique sur « + Ajouter un projet ». Plus tard, le bouton \u003Ccode class=\"key\">+\u003C\u002Fcode> à droite des onglets de la barre de titre fait la même chose. La fenêtre « Nouveau projet » s’ouvre :\u003C\u002Fp>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Champ\u003C\u002Fth>\n\u003Cth>Ce qu’il fait\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>« Dossier »\u003C\u002Ftd>\n\u003Ctd>Le chemin du projet. « Parcourir… » ouvre le sélecteur de dossier. Sous le champ, une ligne dit ce qu’Escouade sait du dossier : « Dépôt git détecté · branche main · propre » (ou le nombre de fichiers modifiés), « Aucun dépôt git · un dépôt sera initialisé » ou « Dossier introuvable ».\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Nom »\u003C\u002Ftd>\n\u003Ctd>Rempli avec le nom du dossier, que tu peux changer. « Aperçu de l’onglet » montre l’onglet tel qu’il sera.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Couleur »\u003C\u002Ftd>\n\u003Ctd>Une des 14 couleurs proposées ; la première qu’aucun projet n’utilise encore est choisie d’office. Elle teinte l’onglet et l’interface quand le projet est affiché.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Créer un premier agent »\u003C\u002Ftd>\n\u003Ctd>Activé par défaut : « Ouvre directement une conversation dans ce projet ». Des boutons « Fable », « Opus », « Sonnet » et « Haiku », chacun avec sa version, choisissent son modèle ; celui du réglage « Modèle par défaut » est déjà coché.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Un worktree git par agent »\u003C\u002Ftd>\n\u003Ctd>Désactivé par défaut : « Isole le travail de chaque agent et permet de voir ses fichiers modifiés séparément ». Tu pourras l’activer plus tard, voir les \u003Ca href=\"\u002Fdocs\u002Fworktrees\u002F\">worktrees\u003C\u002Fa>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>Clique sur « Créer le projet » (le bouton reste grisé tant que le dossier n’existe pas). Le projet s’ouvre dans un nouvel onglet, avec son premier agent si tu l’as demandé.\u003C\u002Fp>\n\u003Cdiv class=\"callout note\">\u003Cp class=\"callout-title\">À noter\u003C\u002Fp>\u003Cp>Si le dossier n’est pas dans un dépôt git, Escouade lance \u003Ccode>git init\u003C\u002Fcode> pour en créer un : sans git, il n’y aurait ni diff ni commit à relire.\u003C\u002Fp>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"creer-un-agent\">Créer un agent\u003C\u002Fh2>\n\u003Cp>Un agent est une conversation avec Claude Code dans ce projet. Pour en créer un, appuie sur \u003Ccode class=\"key\">Ctrl+N\u003C\u002Fcode> ou clique sur « + Nouvel agent » en haut de la barre latérale : l’agent est créé sans rien te demander, et sa conversation s’affiche. Il s’appelle \u003Ccode class=\"key\">agent-1\u003C\u002Fcode>, \u003Ccode class=\"key\">agent-2\u003C\u002Fcode>… jusqu’à sa première demande ; Escouade lui donne alors un nom court tiré de ce que tu as écrit. Pour le renommer toi-même, double-clique sur son nom.\u003C\u002Fp>\n\u003Cp>Son statut est « Prêt », et la conversation vide dit « Agent prêt », avec le dossier où il travaille. La flèche ▾ à droite de « + Nouvel agent » propose « Nouvel agent sur une branche… » (voir les \u003Ca href=\"\u002Fdocs\u002Fbranches\u002F\">branches\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"choisir-le-modele-l-effort-et-le-mode-de-permission\">Choisir le modèle, l’effort et le mode de permission\u003C\u002Fh2>\n\u003Cp>Sous le champ de message, trois menus règlent l’agent (un quatrième, « Compte », apparaît quand tu as plusieurs comptes Claude). Tu peux les changer en cours de conversation.\u003C\u002Fp>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Menu\u003C\u002Fth>\n\u003Cth>Choix\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>« Modèle »\u003C\u002Ftd>\n\u003Ctd>« Fable », « Opus », « Sonnet » et « Haiku ». Chacun lance le modèle le plus récent de sa famille que connaît Claude Code, et s’affiche avec sa version (par exemple « Sonnet 5.5 »).\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Effort »\u003C\u002Ftd>\n\u003Ctd>« Bas » (réponses rapides, peu de réflexion), « Moyen » (équilibré), « Élevé » (réflexion approfondie), « Très élevé » (réflexion très approfondie), « Max » (réflexion maximale, plus de tokens). Haiku ne gère pas l’effort.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Mode »\u003C\u002Ftd>\n\u003Ctd>Le mode de permission, détaillé ci-dessous.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>Les modes de permission décident quand Claude te demande l’autorisation d’agir :\u003C\u002Fp>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Mode\u003C\u002Fth>\n\u003Cth>Ce qui se passe\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>« Auto »\u003C\u002Ftd>\n\u003Ctd>Un classifieur approuve les actions sûres et demande pour le reste. Indisponible avec Haiku.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Demander »\u003C\u002Ftd>\n\u003Ctd>Claude demande ton accord avant chaque action sensible.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Plan »\u003C\u002Ftd>\n\u003Ctd>Claude analyse et propose un plan sans rien modifier.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Édits auto »\u003C\u002Ftd>\n\u003Ctd>Les modifications de fichiers sont acceptées sans demander.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>« Bypass »\u003C\u002Ftd>\n\u003Ctd>Aucune demande de permission.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>Un nouvel agent démarre avec les valeurs de Réglages › Claude Code : « Modèle par défaut » (Sonnet), « Effort par défaut » (Moyen) et « Mode de permission par défaut » (Auto). Voir les \u003Ca href=\"\u002Fdocs\u002Fsettings-claude-code\u002F\">réglages de Claude Code\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fmanaging-agents\u002F\">les agents\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cdiv class=\"callout warning\">\u003Cp class=\"callout-title\">Attention\u003C\u002Fp>\u003Cp>En mode « Bypass », Claude agit sans aucune demande de permission : Escouade te le rappelle quand tu le choisis. Réserve-le aux environnements sûrs.\u003C\u002Fp>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"envoyer-une-premiere-demande\">Envoyer une première demande\u003C\u002Fh2>\n\u003Cp>Clique dans le champ de message, décris la tâche (« Décris la tâche à confier à Claude… »), puis appuie sur \u003Ccode class=\"key\">Entrée\u003C\u002Fcode> pour envoyer. \u003Ccode class=\"key\">Maj+Entrée\u003C\u002Fcode> va à la ligne.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Tape \u003Ccode class=\"key\">@\u003C\u002Fcode> suivi d’un bout de nom de fichier pour choisir un fichier du projet, ou \u003Ccode class=\"key\">\u002F\u003C\u002Fcode> pour choisir une commande.\u003C\u002Fli>\n\u003Cli>Colle ou glisse une image, un PDF ou un fichier texte dans le champ, ou clique sur le trombone, pour le joindre au message.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Dès l’envoi, le statut de l’agent passe à « En cours » et la conversation dit « Claude travaille… ». Ses appels d’outils apparaissent en lignes compactes que tu peux déplier. Tu peux lui écrire pendant qu’il travaille : il en tient compte dès sa prochaine étape. Pour l’arrêter, appuie sur \u003Ccode class=\"key\">Échap\u003C\u002Fcode> dans le champ de message ou clique sur « ■ Stop ».\u003C\u002Fp>\n\u003Ch2 id=\"repondre-a-une-question-ou-a-une-autorisation\">Répondre à une question ou à une autorisation\u003C\u002Fh2>\n\u003Cp>Quand Claude a besoin de toi, une carte à bordure ambre apparaît dans la conversation, le statut de l’agent devient « Question », et son onglet et sa carte clignotent si tu regardes ailleurs. Il y a deux cartes.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>« Claude demande une autorisation »\u003C\u002Fstrong> nomme l’outil et ce qu’il va faire. Trois boutons :\u003C\u002Fp>\n\u003Cul>\n\u003Cli>« Autoriser » (\u003Ccode class=\"key\">Ctrl+Entrée\u003C\u002Fcode>) ;\u003C\u002Fli>\n\u003Cli>« Toujours autoriser » (\u003Ccode class=\"key\">Ctrl+Maj+Entrée\u003C\u002Fcode>), quand Claude Code propose de retenir ce choix ;\u003C\u002Fli>\n\u003Cli>« Refuser ».\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Pour refuser en expliquant quoi faire à la place, écris-le dans le champ de message et envoie-le. Quand Claude Code refuserait la demande par défaut, « Refuser » est le bouton principal et seul un clic sur « Autoriser » l’accorde : les touches ne répondent pas. Quand Claude propose un plan, la carte s’appelle « Claude propose un plan » et les boutons sont « Approuver le plan », « Approuver et accepter les édits » et « Continuer à planifier ».\u003C\u002Fp>\n\u003Cp>\u003Cstrong>« Claude attend ta réponse »\u003C\u002Fstrong> pose une question avec des options. Clique sur une option, ou appuie sur \u003Ccode class=\"key\">Alt+1\u003C\u002Fcode> à \u003Ccode class=\"key\">Alt+9\u003C\u002Fcode>, ou réponds librement dans le champ de message. Avec une seule question à choix unique, la réponse part dès ce clic ; avec plusieurs questions ou un choix multiple, « Valider » (\u003Ccode class=\"key\">Ctrl+Entrée\u003C\u002Fcode>) envoie les réponses.\u003C\u002Fp>\n\u003Cdiv class=\"callout tip\">\u003Cp class=\"callout-title\">Astuce\u003C\u002Fp>\u003Cp>\u003Ccode class=\"key\">Ctrl+J\u003C\u002Fcode> ouvre le prochain agent qui attend ta réponse, le curseur dans son champ de message. Une carte qui vient d’arriver ignore les touches de réponse pendant une demi-seconde, pour qu’une frappe destinée à ton message ne réponde pas à sa place.\u003C\u002Fp>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"voir-ce-que-l-agent-a-change\">Voir ce que l’agent a changé\u003C\u002Fh2>\n\u003Cp>Quand Claude a fini, le statut devient « Terminé » et une carte « Tâche terminée » donne la durée, les tokens, le coût et la liste des fichiers modifiés ; un clic sur un fichier l’ouvre dans l’éditeur.\u003C\u002Fp>\n\u003Cp>Pour relire les changements, ouvre le panneau « Non commités » : clique sur « Fichiers ▸ » dans l’en-tête de la conversation, ou appuie sur \u003Ccode class=\"key\">Ctrl+Maj+B\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Chaque ligne est un fichier, avec sa lettre (M pour modifié, A pour ajouté, D pour supprimé) et ses lignes ajoutées et retirées.\u003C\u002Fli>\n\u003Cli>Un clic sur un fichier ouvre son diff dans une grande fenêtre. « Unifié » et « Côte à côte » changent la présentation, \u003Ccode class=\"key\">Échap\u003C\u002Fcode> ferme la fenêtre. Quand il y a plusieurs fichiers, une colonne à gauche permet de passer de l’un à l’autre.\u003C\u002Fli>\n\u003Cli>« Voir le diff » ouvre le diff de tous les fichiers de la liste.\u003C\u002Fli>\n\u003Cli>« Cet agent » liste les fichiers de l’agent ; « Tout le projet » liste ceux de tous les agents du projet.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Pour garder la conversation et le diff sous les yeux ensemble, passe à la disposition côte à côte avec \u003Ccode class=\"key\">Ctrl+Maj+L\u003C\u002Fcode> : le panneau reste affiché à droite et montre le diff du fichier choisi sous la liste.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fimages\u002Fgit.jpg\" alt=\"Un agent dont le panneau « Non commités » liste trois fichiers, avec le diff du premier à droite de la conversation\" width=\"1920\" height=\"960\" loading=\"lazy\" decoding=\"async\">\u003C\u002Fp>\n\u003Ch2 id=\"commiter\">Commiter\u003C\u002Fh2>\n\u003Cp>Le bouton « Commit… » du panneau commite les changements de l’agent (« Commit tout… » quand « Tout le projet » est choisi). Ce qui se passe dépend du réglage « Commit » du projet, dans Réglages › Projets :\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>« Rédigé par l’agent »\u003C\u002Fstrong> (par défaut) : Escouade envoie à l’agent un message qui lui demande de commiter ses changements avec un message clair au format Conventional Commits. Un message éphémère confirme « Demande de commit envoyée à » suivi du nom de l’agent, puis l’agent commite comme pour n’importe quelle demande.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>« Direct, avec un message proposé »\u003C\u002Fstrong> : la fenêtre « Commit » liste les fichiers, Haiku rédige un message que tu relis et modifies, « Régénérer » en demande un autre, et « Commiter » commite. Rien n’est commité sans ce clic.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Si l’agent travaille dans un worktree, le panneau propose aussi « Merger … → … », qui fusionne sa branche dans celle du projet. Voir \u003Ca href=\"\u002Fdocs\u002Fgit\u002F\">Git et commits\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fworktrees\u002F\">les worktrees\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"et-ensuite\">Et ensuite\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fmanaging-agents\u002F\">Les agents\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fchat\u002F\">la conversation\u003C\u002Fa> : modes de permission, messages, images, recherche, historique.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fnotifications\u002F\">Notifications\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Foverview\u002F\">suivre ses agents\u003C\u002Fa> : être prévenu, répondre sans ouvrir chaque conversation.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fgit\u002F\">Git et commits\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Fworktrees\u002F\">les worktrees\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fbranches\u002F\">les branches\u003C\u002Fa> : relire, commiter, isoler les agents.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Feditor\u002F\">L’éditeur\u003C\u002Fa>, \u003Ca href=\"\u002Fdocs\u002Fterminals\u002F\">les terminaux\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Flaunch\u002F\">lancer le projet\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fboard\u002F\">Le Kanban\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fautopilot\u002F\">le pilote auto\u003C\u002Fa> : confier des tickets à des agents.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Faccounts\u002F\">Les comptes Claude\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Fusage\u002F\">les quotas et le coût\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fdocs\u002Fshortcuts\u002F\">Les raccourcis clavier\u003C\u002Fa> et \u003Ca href=\"\u002Fdocs\u002Finterface\u002F\">l’interface\u003C\u002Fa> pour faire le tour de la fenêtre.\u003C\u002Fli>\n\u003C\u002Ful>\n",[8,12,15,18,21,24,27,30,33],{"id":9,"text":10,"depth":11},"avant-de-commencer","Avant de commencer",2,{"id":13,"text":14,"depth":11},"ajouter-un-projet","Ajouter un projet",{"id":16,"text":17,"depth":11},"creer-un-agent","Créer un agent",{"id":19,"text":20,"depth":11},"choisir-le-modele-l-effort-et-le-mode-de-permission","Choisir le modèle, l’effort et le mode de permission",{"id":22,"text":23,"depth":11},"envoyer-une-premiere-demande","Envoyer une première demande",{"id":25,"text":26,"depth":11},"repondre-a-une-question-ou-a-une-autorisation","Répondre à une question ou à une autorisation",{"id":28,"text":29,"depth":11},"voir-ce-que-l-agent-a-change","Voir ce que l’agent a changé",{"id":31,"text":32,"depth":11},"commiter","Commiter",{"id":34,"text":35,"depth":11},"et-ensuite","Et ensuite",1791926754936]