Démarrage rapide

Ce chapitre vous guide à travers votre première session complète avec Bromure Agentic Coding : créer un espace de travail, choisir un agent et son mode d'authentification, partager un dossier de projet dans le bac à sable, exécuter une première tâche, inspecter ce que l'agent a envoyé sur le réseau, et fermer la session pour la reprendre plus tard. Comptez une dizaine de minutes environ.

Cette procédure utilise délibérément les valeurs par défaut partout où c'est possible. Chaque paramètre que vous touchez ici dispose d'une référence complète plus loin dans le manuel — des liens sont fournis en chemin et rassemblés dans Pour aller plus loin.

Avant de commencer

Vous avez besoin de :

• Bromure Agentic Coding installé et lancé au moins une fois, avec l'image OS de base prête — voir Installation. (Un Mac avec Apple Silicon exécutant macOS 14 ou une version ultérieure est requis.)
• Un moyen d'authentifier l'agent de codage. Pour Claude Code — l'agent par défaut — il s'agit soit d'une clé API Anthropic, soit d'un abonnement Claude auquel vous pouvez vous connecter. Les deux voies sont couvertes à l'étape 4 ci-dessous.
• Éventuellement, un dossier de projet sur votre Mac sur lequel vous souhaitez que l'agent travaille. Un petit dépôt git constitue le meilleur premier test, mais n'importe quel dossier convient.

Une idée à garder en tête avant de commencer : l'agent s'exécute à l'intérieur d'une VM Ubuntu jetable, et vos véritables identifiants n'entrent jamais dans cette VM. La VM ne contient jamais que de faux jetons fictifs ; un proxy côté hôte les échange contre les véritables valeurs au moment où une requête quitte votre Mac. C'est la frontière du fil, et c'est la raison pour laquelle la procédure vous demande de coller une clé API dans l'application plutôt que dans le terminal.

Créez votre premier espace de travail

Un espace de travail est l'unité d'isolation : une VM Ubuntu avec son propre disque système, son propre dossier personnel persistant, ses propres agents, identifiants et politiques de sécurité. Vous pouvez en créer autant que vous le souhaitez ; cette procédure en crée un seul.

1. Ouvrez la fenêtre principale. La barre latérale de gauche est intitulée ESPACES DE TRAVAIL ; à son bas se trouve un bouton circulaire noir + (info-bulle : Nouvel espace de travail). Cliquez dessus.

2. Un éditeur de paramètres s'ouvre dans une fenêtre intitulée Nouvel espace de travail, pré-remplie à partir de votre modèle de préférences et nommée « Espace de travail par défaut » (numéroté automatiquement si ce nom est déjà pris). Le volet Général est affiché. Saisissez un nom de votre choix — par exemple My First Project. Le nom est le seul champ obligatoire ; tout le reste dans cette procédure est une finition facultative. Si vous le souhaitez, choisissez une Couleur — elle teinte la tuile de l'espace de travail dans la barre latérale.

N'appuyez pas encore sur Créer — deux volets méritent d'abord une visite.

Choisissez un agent et son authentification

3. Cliquez sur Agents dans la barre latérale des catégories de l'éditeur. Le volet affiche une carte par agent pris en charge — Claude Code, Codex et Grok Build — chacune avec un interrupteur d'activation. Claude Code est activé et arbore la pastille orange Principal dès le départ : l'agent principal est celui qui se lance automatiquement dans le premier onglet de la session. Les autres agents activés sont également installés et authentifiés, mais vous les démarrez vous-même depuis un nouvel onglet.

À l'intérieur de la carte Claude Code, vous voyez quatre modes d'authentification : Jeton API, Abonnement (connexion interactive) avec un lien S'inscrire…, Bedrock (AWS) et Modèle local (grisé avec « — téléchargez un modèle dans Modèles locaux » jusqu'à ce qu'un modèle local soit installé). Choisissez l'un des deux premiers :

4. Si vous avez une clé API Anthropic : sélectionnez Jeton API et collez la clé dans le champ Clé API Anthropic. La clé est stockée chiffrée sur l'hôte ; la VM ne reçoit qu'un faux préservant la structure, et le proxy substitue la véritable clé lors des requêtes vers Anthropic — nulle part ailleurs. Laissez la case Exiger une approbation pour l'utiliser décochée pour l'instant ; l'activer ferait demander votre consentement par l'application la première fois que chaque session utilise la clé (voir Identifiants).

5. Si vous avez un abonnement Claude : sélectionnez Abonnement (connexion interactive) — le réglage d'usine — et cliquez sur S'inscrire…. Bromure démarre une VM temporaire et jetable, sans accès à vos dossiers ni à vos identifiants, exécute la véritable connexion Claude à l'intérieur, et ouvre la page de connexion du fournisseur dans le navigateur par défaut de votre Mac. Connectez-vous là ; vous disposez de quelques minutes avant l'expiration du flux. En cas de succès, les jetons capturés sont stockés chiffrés sur l'hôte, la VM jetable est détruite, et l'application demande si vous souhaitez partager l'inscription avec Tous les espaces de travail ou Uniquement cet espace de travail. Une fois inscrit, la carte affiche un sceau vert ainsi que les commandes Se réinscrire… et Oublier. Vos VM d'espace de travail n'effectuent jamais elles-mêmes d'OAuth et ne détiennent jamais les véritables jetons — l'hôte les injecte sur le fil et gère le rafraîchissement.

6. C'est tout ce dont le volet Agents a besoin pour une première session. (Activer Codex ou Grok Build en parallèle fonctionne de la même manière — chaque carte obtient son propre mode d'authentification — mais un seul agent suffit largement aujourd'hui.)

Partagez un dossier de projet

7. Cliquez sur Dossiers dans la barre latérale des catégories. Ce volet répertorie les dossiers de l'hôte qui seront montés dans la VM. Comme l'indique la légende, chaque dossier est monté sous son vrai nom — par exemple ~/Documents sur votre Mac apparaît comme ~ubuntu/Documents dans la VM — et un espace de travail est plafonné à 8 dossiers. Un espace de travail tout neuf affiche « Aucun dossier partagé ».

8. Cliquez sur Ajouter un dossier… et choisissez votre dossier de projet dans le sélecteur de répertoire. Il apparaît dans la liste avec son chemin complet sur l'hôte (retirez-le plus tard avec le bouton moins si vous changez d'avis). À l'intérieur de la VM, il sera actif à /home/ubuntu/<basename> — les mêmes fichiers, pas une copie, de sorte que les modifications de l'agent sont instantanément sur votre Mac.

Remarque : Partager un dossier est facultatif. Tout ce qui se trouve sous /home/ubuntu de la VM est persistant par espace de travail, de sorte que vous pouvez aussi cloner un dépôt à l'intérieur de la VM et garder le bac à sable totalement séparé du système de fichiers de votre Mac. Supprimer un espace de travail ne touche jamais aux dossiers partagés de l'hôte.

9. Cliquez sur Créer. L'éditeur se ferme et votre espace de travail apparaît dans la barre latérale avec l'étiquette d'état Arrêté.

Démarrez la session

10. Cliquez sur la ligne de l'espace de travail dans la barre latérale. La scène de droite affiche le tableau de bord de l'espace de travail : une pastille Arrêté sous le nom, des cartes pour CPU, Mémoire, vCPU, Disque et Temps de fonctionnement (essentiellement des tirets et des zéros avant le premier lancement — le disque est créé au premier démarrage), un récapitulatif CONFIGURATION listant votre agent et son mode d'authentification, les états d'analyse des garde-fous et de l'injection de prompt, et vos dossiers partagés. Cliquez sur le bouton Démarrer en haut à droite.

11. Au premier lancement, Bromure crée le disque système privé de l'espace de travail sous forme de clone en copie sur écriture de l'image de base partagée — c'est instantané et cela ne coûte presque aucun espace disque — et démarre la VM avec 4 vCPU et la RAM affichée sur le tableau de bord (dimensionnée à votre Mac par défaut : 4, 6 ou 8 Go). Pendant que la VM démarre, une superposition animée avec le nom de l'espace de travail et une barre de progression recouvre le volet ; elle s'estompe dès que le premier terminal de l'invité apparaît, généralement en quelques secondes. Si aucun terminal n'apparaît dans les 30 secondes, la superposition bascule vers un panneau ÉCHEC DE LA PLONGÉE avec les boutons Continuer d'attendre et Réinitialiser l'image de base… — voir Dépannage si cela se produit.

12. Une fois le démarrage terminé, vous êtes face à un terminal sur la scène, et l'agent principal — Claude Code — y est déjà en cours d'exécution, prêt à recevoir un prompt. Vous n'exécutez jamais claude login à l'intérieur de la VM ; l'authentification a été gérée à la frontière du fil. Dans la barre latérale, le point d'état de l'espace de travail est maintenant vert, l'étiquette d'état indique En cours d'exécution, et son premier onglet (étiqueté avec le programme au premier plan, par ex. claude) est imbriqué sous la ligne de l'espace de travail avec un nœud Docker. La barre d'outils de la fenêtre affiche désormais un groupe de commandes pour cette VM : son adresse IP sous forme de pastille cliquer-pour-copier, et des boutons pour parcourir les fichiers, redémarrer, inspecter la trace, modifier l'espace de travail, détacher la session dans sa propre fenêtre, et afficher ou masquer les volets de navigateur et de fichiers de dépôt.

Exécutez votre première tâche

13. Saisissez une tâche à l'invite de Claude Code, en référençant le dossier partagé par son chemin dans la VM. Par exemple :

    Read the code in ~/my-project and summarize what it does.
    Then add a README.md with build instructions.
    

    Observez le point d'état sur l'icône de l'onglet dans la barre latérale : il clignote en orange pendant que l'agent travaille, passe au vert lorsque l'agent a terminé, et passe au rouge lorsque l'agent a besoin de votre intervention.

14. Comme le dossier partagé est un montage actif, le README.md que l'agent écrit est immédiatement sur votre Mac — vérifiez-le dans le Finder si vous le souhaitez. Si votre dossier est un dépôt git, le volet d'exploration des fichiers du dépôt s'ouvre automatiquement lorsque le répertoire de travail de l'onglet actif entre dans le dépôt, montrant une arborescence de style IDE avec l'état git et les diffs par fichier ; vous pouvez aussi l'afficher ou le masquer à tout moment avec ⌃⌘E. Appuyez sur ⌘T pour un onglet shell simple supplémentaire à côté de l'agent — chaque onglet est une fenêtre de la même session tmux dans la VM.

15. Tout ce que l'agent fait par ailleurs — apt install, npm install, écrire des fichiers jetables dans le dossier personnel de la VM — reste à l'intérieur du bac à sable. Le disque système et le dossier personnel persistent entre les sessions, et les deux peuvent être réinitialisés indépendamment plus tard (Espaces de travail).

Inspectez la trace

16. Appuyez sur ⇧⌘I (ou cliquez sur le bouton Inspecter la trace de la barre d'outils) pour ouvrir l'Inspecteur de traces. Les nouveaux espaces de travail enregistrent au niveau Détails des requêtes IA : chaque requête réseau effectuée par l'agent est répertoriée avec l'hôte, l'état et la latence, et pour les hôtes LLM connus, les corps complets de requête et de réponse sont également capturés. Sélectionnez l'une des requêtes vers Anthropic et l'inspecteur la restitue sous forme de conversation — en-tête du fournisseur et du modèle avec les décomptes de jetons, le prompt système, et les messages utilisateur, assistant et outil sous forme de bulles de discussion.

17. Deux choses valent la peine d'être remarquées sur votre première trace. D'abord, le rapport d'échange : le faux jeton API que la VM détient a été échangé contre votre véritable identifiant sur le fil, exactement une fois par requête, limité à l'hôte du fournisseur. Ensuite, tout ce qui est capturé reste sur votre Mac, chiffré au repos. Les niveaux de trace, les plafonds de rétention et les avertissements de fuite sont couverts dans Traçage.

Fermez et reprenez

18. Fermez la session : survolez la ligne de l'espace de travail dans la barre latérale et cliquez sur son bouton × (ou appuyez sur ⌘W sur son dernier onglet). Les nouveaux espaces de travail ont leur action de fermeture réglée sur Demander, de sorte qu'une invite apparaît — « Fermer « My First Project » ? » — avec les boutons Exécuter en arrière-plan, Suspendre, Éteindre et Annuler, et l'explication : « Exécuter en arrière-plan garde la VM en cours d'exécution pour que vous puissiez vous y rattacher plus tard. Suspendre enregistre son état sur le disque. Éteindre la met hors tension. »

19. Cliquez sur Suspendre. La RAM de la VM est capturée sur le disque et l'étiquette d'état de la ligne dans la barre latérale devient Suspendu. Rien n'est perdu — ni la conversation de l'agent, ni votre historique de shell, ni la disposition des onglets.

20. Reprenez : cliquez sur l'espace de travail et appuyez sur Reprendre sur son tableau de bord (ou utilisez le menu ⋯ de la ligne → Reprendre). La session est restaurée quasi instantanément, exactement là où vous l'avez laissée — les mêmes terminaux, avec Claude Code en pleine conversation.

21. Si vous voulez toujours le même comportement à la fermeture, ouvrez le menu ⋯ de la ligne → Modifier… et réglez Lors de la fermeture de la fenêtre dans le volet Général sur Suspendre (ou Exécuter en arrière-plan / Éteindre) afin que l'invite n'apparaisse jamais. Voir Paramètres — Général.

Astuce : Un espace de travail suspendu ou éteint conserve son disque système et son dossier personnel. Détruire des données est toujours un acte explicite — Réinitialiser le disque, Effacer le dossier personnel… ou Supprimer l'espace de travail — et même supprimer un espace de travail ne touche jamais aux dossiers de l'hôte que vous y avez partagés.

Pour aller plus loin

• Concepts — le modèle mental derrière ce que vous venez de faire : les espaces de travail, le cycle de vie de la VM, la frontière du fil, et comment les pièces s'assemblent.
• Espaces de travail — dupliquer, réinitialiser et supprimer des espaces de travail ; les couches de stockage, les points de contrôle, et le modèle de préférences dont chaque nouvel espace de travail est dérivé.
• Sessions — les onglets et les worktrees git, la grille de terminaux, le volet de navigateur agentique, le transfert de fichiers vers et depuis la VM, et tous les raccourcis clavier.
• Référence des paramètres — chaque volet de paramètres, une page chacun, y compris Agents et Dossiers de cette procédure.
• Identifiants — le catalogue complet des identifiants (jetons git, clés SSH, AWS, Kubernetes, registres de conteneurs, bases de données, et plus), les invites d'approbation, et comment l'échange faux-vers-vrai fonctionne en détail.
• Traçage — les niveaux de trace, l'Inspecteur de traces et la détection de fuites.
• Chaîne d'approvisionnement et Injection de prompt — les protections que vous pouvez superposer à un espace de travail avant de pointer un agent vers du code non fiable.
• Fusion et Modèles locaux — répondre aux prompts avec plusieurs modèles à la fois, et exécuter des modèles sur votre Mac plutôt que dans le cloud.
• Automatisation & CLI — piloter les espaces de travail depuis des scripts, l'API HTTP, et le serveur bromure-cli mcp.