Référence des réglages

Presque tous les réglages de Bromure Agentic Coding appartiennent à une machine. L'interface des sessions l'appelle une machine ; l'éditeur de réglages l'appelle encore un espace de travail — c'est la même chose. Chaque machine porte ses propres identifiants, politiques de sécurité, apparence de terminal, dossiers partagés et ressources de VM, tous modifiés dans une seule fenêtre : l'éditeur de réglages.

Quelques choses ne sont pas par machine :

• Modèles a un tableau global dans Préférences › Modèles dont chaque machine hérite. Le volet Modèles propre à une machine en est une surcharge facultative.
• Automatisation (l'API HTTP de bouclage et le serveur bromure-ac mcp) vaut pour toute l'app et n'apparaît que dans les Préférences.
• L'image du navigateur, les modèles des détecteurs d'injection de prompt et de données personnelles, et les téléchargements de modèles sur l'appareil sont partagés par toutes les machines du Mac.

Ce chapitre est la référence de l'éditeur et de chacun de ses volets. Chaque volet a sa propre page, avec une capture d'écran, un tableau des réglages et de leurs valeurs par défaut, et des renvois vers le chapitre qui explique la fonction derrière lui.

Ouvrir l'éditeur

L'éditeur s'ouvre d'où que vous soyez :

Pour créer une machine, servez-vous du + sur l'en-tête de la section Machines virtuelles (info-bulle Nouvel espace de travail), de Nouvelle machine… dans le sélecteur de machines de l'écran de nouvelle session, ou de Nouvelle machine… dans ⌘K. Ils ouvrent le même éditeur, intitulé Nouvel espace de travail jusqu'à ce que vous tapiez un nom, avec Créer à la place d'Enregistrer. Voir Machines pour le cycle de vie d'une machine.

Il n'existe qu'une fenêtre d'éditeur à la fois. Ouvrir les réglages d'une autre machine la remplace ; ouvrir les réglages de la même machine ramène la fenêtre existante au premier plan.

La fenêtre de l'éditeur

Le titre de la fenêtre et l'en-tête de chaque volet montrent le nom de la machine. La colonne de gauche est une barre latérale de volets en cinq groupes, avec un champ Rechercher dans les réglages en haut ; la colonne de droite est le volet sélectionné. Annuler (Échap) jette vos modifications ; Enregistrer (Retour) — Créer pour une nouvelle machine — les applique.

Les groupes et les volets, dans l'ordre de la barre latérale :

Rechercher dans les réglages filtre la barre latérale à mesure que vous tapez. Il apparie les noms de volets, les noms de groupes, et quelques mots-clés par volet — par exemple firewall ou openshell trouve Politique du bac à sable, ram trouve Ressources, clé api trouve Modèles, rgpd trouve Protection des données personnelles. Chaque mot tapé doit correspondre. Si le volet sélectionné est filtré, l'éditeur saute à la première correspondance.

Ce qui s'enregistre à chaud, et ce qui attend Enregistrer

Les modifications dans l'éditeur sont un brouillon jusqu'à ce que vous cliquiez Enregistrer. Ce qui suit dépend de si la machine tourne.

Appliqué à une machine en cours d'exécution à l'enregistrement, sans redémarrage : les variables d'environnement, les identifiants (jetons git, clés d'API, DigitalOcean, Linear, Twilio, registres de conteneurs, bases de données), l'identité git, les politiques d'écriture des garde-fous et les filtres de demande avant usage, les règles du pare-feu et la politique réseau OpenShell (les deux s'appliquent pendant que vous les modifiez), prévenir l'agent, le chien de garde des agents, les identifiants stricts, l'interception transparente, les interrupteurs de contournement non sécurisé et d'alerte d'exfiltration, la politique de chaîne d'approvisionnement, la politique d'injection de prompt, la protection des données personnelles, le niveau de trace, la surcharge de modèles de l'espace de travail, la police du terminal, ses couleurs, son curseur et son opacité, et le nom et la couleur de la machine.

Demande un redémarrage : la mémoire de la VM, le mode réseau, les dossiers partagés, les clés SSH (la clé de l'espace de travail et les clés importées), les contextes Kubernetes, les identifiants AWS, et — sous le moteur OpenShell — Enforce binaries (le bac à sable strict), le bac à sable du système de fichiers et des processus et le mode de la sentinelle du noyau. Quand vous enregistrez l'un de ceux-là pendant que la machine tourne, l'app demande Redémarrer « nom » pour appliquer ces changements ?, les liste, et propose Redémarrer maintenant… ou Plus tard.

Deux modifications demandent avant d'enregistrer :

• Changer les dossiers partagés d'une machine suspendue : Abandonner la VM suspendue de « nom » ? — l'état RAM enregistré ne peut pas être repris avec un autre ensemble de partages, donc enregistrer l'abandonne et le démarrage suivant est un amorçage à froid. Abandonner et enregistrer ou Annuler.
• Changer les autorisations du navigateur ou Rester connecté aux sites web pendant que le navigateur est ouvert : Redémarrer le navigateur de « nom » ? — Redémarrer et enregistrer ou Annuler.

Immédiat, quoi que vous fassiez ensuite (pas défait par Annuler) :

• Tout ce qui est dans Préférences › Modèles sur ce Mac : fournisseurs, connexions, clés d'API et choix de modèles s'enregistrent à mesure que vous les faites.
• Les téléchargements de modèles : les détecteurs d'injection de prompt et le modèle de données personnelles commencent à se télécharger dès que vous cochez leur case ; les modèles sur l'appareil se téléchargent depuis la source Sur l'appareil.
• Se connecter à un fournisseur ou s'en déconnecter, et Autoriser avec OAuth… / Révoquer dans MCP.
• Le volet Automatisation, et dans Préférences › Ressources les réglages Sous-réseau des espaces de travail et Transport distant.
• Télécharger maintenant / Retélécharger pour l'image du navigateur.
• Les actions de stockage dans Ressources (Effacer le dossier personnel…, Restaurer le dossier personnel…, Réinitialiser à la base…), chacune après sa propre confirmation.

Les secrets que vous tapez dans l'éditeur ne vont jamais dans le profile.json en clair. À l'enregistrement, ils sont mis à part dans secrets.enc, chiffrés avec une clé conservée dans le Trousseau de macOS. Voir Identifiants et la frontière du fil.

Le modèle Valeurs par défaut (Préférences)

Préférences… (⌘,) ouvre une fenêtre intitulée Bromure — Préférences. Elle contient le même éditeur, mais rattaché à une machine modèle nommée Valeurs par défaut plutôt qu'à une vraie machine. Chaque nouvelle machine démarre comme une copie de ce modèle, si bien que ce que vous y posez — identifiants, garde-fous, règles de chaîne d'approvisionnement, apparence, mémoire — devient le point de départ des machines que vous créerez ensuite. Les machines existantes ne changent pas.

La variante Préférences diffère de l'éditeur d'une machine sur quelques points :

• Général masque Nom, Démarrer cette VM à l'ouverture de session, Notes et Portée — ils appartiennent à une machine, pas à un défaut.
• Ressources n'a pas de pile de stockage (il n'y a pas de disques sur lesquels agir) et ajoute deux sections valables pour toute l'app : Sous-réseau des espaces de travail et Transport distant (les Préférences de ce Mac seulement).
• Modèles est le tableau global, pas une surcharge, et s'enregistre à mesure que vous modifiez.
• Le groupe App apparaît, avec le volet Automatisation (les Préférences de ce Mac seulement).

Le modèle d'usine fait tourner Claude Code, met chaque politique d'écriture sur Demander avant écriture, et enregistre les sessions au niveau Détails des requêtes IA. Les valeurs par défaut citées dans ce chapitre sont ces valeurs d'usine ; dès que vous modifiez les Préférences, les nouvelles machines héritent des vôtres.

Modèles globaux et surcharge par machine

Quels fournisseurs vous avez, quelles connexions, et quel modèle chaque agent fait tourner se règlent une fois, globalement, dans Préférences › Modèles. Chaque machine hérite de ce tableau. Le volet Modèles propre à une machine peut le surcharger — Hériter, avec des changements (par exemple sa propre clé d'API pour un fournisseur, ou un fournisseur éteint) ou Autonome (sa configuration complète à elle). Avec la surcharge désactivée, le volet résume simplement ce dont la machine hérite.

Voir Modèles pour la surcharge et Modèles et fournisseurs pour le tableau global.

Réglages pour : modifier les défauts d'un Mac distant

Quand au moins une fenêtre miroir vers un Mac distant est ouverte, les Préférences affichent un sélecteur Réglages pour : au-dessus de l'éditeur, proposant Ce Mac et chaque Mac distant connecté. Appuyer sur ⌘, depuis une fenêtre miroir présélectionne ce Mac distant. Choisir un Mac distant charge son modèle par la connexion (« Chargement des préférences depuis hôte… ») ; le titre devient Préférences — hôte. Si la récupération échoue, la fenêtre affiche Impossible de charger les préférences distantes avec Réessayer.

Le modèle d'un Mac distant et son tableau Modèles global se modifient comme un brouillon et sont renvoyés quand vous cliquez Enregistrer. Les clés d'API stockées sur le Mac distant ne sont pas envoyées à votre Mac : elles apparaissent comme configurées, et elles sont gardées à moins que vous n'en tapiez une nouvelle. Changer de cible jette un brouillon non enregistré au lieu de l'emporter.

Note : le volet Automatisation et les sections Sous-réseau des espaces de travail et Transport distant de Ressources appartiennent à ce Mac, ils n'apparaissent donc que dans les Préférences de ce Mac — pas dans celles d'un Mac distant, ni quand vous modifiez une machine distante depuis sa fenêtre miroir. L'éditeur d'une machine distante ne montre pas non plus de pile de stockage dans Ressources.

Voir Accès à distance et client riche pour les fenêtres miroir.

Sur iPhone, iPad et Apple Vision Pro

Le client iPhone, iPad et Vision Pro utilise le même éditeur pour changer une machine sur le serveur auquel il se connecte :

• iPhone — une liste à la manière de Réglages : les volets groupés forment le premier écran et chacun pousse sa propre page. Annuler et Enregistrer sont dans la barre de navigation. Il n'y a pas de champ de recherche.
• iPad et Apple Vision Pro — la disposition barre latérale et détail du Mac, avec Rechercher dans les réglages, et Annuler / Enregistrer en bas.

Tout ce qui est dans l'éditeur s'applique sur le serveur. L'éditeur mobile laisse de côté ce qui n'a de sens que sur le Mac qui fait tourner les machines : les volets Modèles et Automatisation, la section de l'image du navigateur, la table de règles du pare-feu et l'éditeur de politique OpenShell, et le sélecteur d'interface en pont. Quelques champs changent de forme : Ajouter un dossier… demande le chemin absolu du dossier sur le serveur, et AWS SSO prend le nom de profil tel qu'il est tapé.

Les volets

Où les réglages sont stockés

Les réglages d'une machine vivent dans ~/Library/Application Support/BromureAC/profiles/<uuid>/profile.json, avec ses secrets dans le secrets.enc chiffré voisin. Le modèle Valeurs par défaut est profile-template.json plus profile-template.enc, à côté du répertoire profiles, de sorte qu'il n'apparaît jamais comme une machine. Le tableau Modèles global est stocké chiffré dans models.enc. Le volet Automatisation et les réglages de sous-réseau et de transport distant sont des préférences d'app (le domaine de défauts io.bromure.agentic-coding), ils ne font partie d'aucun profil.