Guide d'utilisation

Basé sur les écrans vérifiés avec Claude Code 2.1.288 à 2.1.291

1. Préparation

Les Mac des développeurs se connectent à un seul serveur de l'entreprise.

• Serveur de l'entreprise : installez un serveur d'applications web (WAS) et une base de données sur un serveur interne. La console web est placée derrière le proxy HTTPS de l'entreprise, et les connexions des Agents (/ws/agent · /agent/) ne sont ouvertes qu'au sein du réseau interne (VPN). La connexion web exige identifiant, mot de passe et OTP.
• Chaque Mac : tmux et Claude Code. Claude Code doit être lancé dans une fenêtre tmux pour pouvoir saisir et approuver depuis le Web.
• Installation de l'Agent : exécutez dans le terminal du Mac du développeur (sur le réseau interne) la commande d'une ligne générée par l'administrateur via Gestion › Hôtes › « Ajouter un hôte » sur le Web. Le code d'enregistrement ne sert qu'une fois et doit être utilisé dans les 15 minutes.

# Forme de la commande générée par « Ajouter un hôte » (adresse et code : valeurs affichées à l'écran)
curl -fsSL <adresse du serveur>/agent/install.sh | bash -s -- --code XXXX-XXXX

Le script d'installation vérifie le binaire, enregistre l'hôte, rend l'Agent résident via launchd, installe les hooks Claude Code et termine par une vérification. Par la suite, l'Agent se met à jour via « Mettre à jour maintenant » sur le Web.

2. Suivre les sessions

La liste des sessions affiche les sessions de tous les Mac, triées par état.

Cliquez sur une session pour ouvrir sa conversation. Conversation, appels d'outils et résultats s'ajoutent en temps réel dans le même ordre que dans le terminal ; si vous êtes remonté pour lire, votre position est conservée même à l'arrivée de nouveaux messages (le bouton « Nouveaux messages » ramène en bas).

3. Approbations · questions

• Demande d'autorisation : « Autoriser » · « Toujours autoriser cette commande » · « Refuser ». « Toujours autoriser » n'enregistre que la règle proposée par Claude (généralement cette seule commande). Si les demandes à chaque commande vous gênent, passez le mode d'autorisation sur « Auto ».
• Questions de Claude : dans la carte de question, choisissez une ou plusieurs options, ou rédigez votre réponse, puis « Envoyer la réponse ». S'il y a plusieurs questions, il faut répondre à toutes avant de pouvoir envoyer.
• La même fenêtre s'affiche aussi dans le terminal, et c'est la première réponse qui s'applique.
• Les fenêtres de confirmation propres au terminal (par exemple « Background work is running » lors d'un /exit, ou « Switch model? » lors d'un changement de modèle) apparaissent aussi sous forme de carte « Question posée dans le terminal » et se choisissent depuis le Web.
• Les demandes en attente sont regroupées dans la colonne des alertes (onglet « Alertes » sur mobile).

4. Prompts · fichiers · interruption

• Saisissez le texte et envoyez-le (⌘/Ctrl+Enter). Les longs textes partent tels quels, et la zone de saisie n'est vidée qu'après confirmation de l'envoi.
• Un fichier glissé-déposé ou collé dans la zone de saisie est téléversé dans le dossier uploads/ de la session, et @chemin est inséré dans la zone de saisie. Le bouton de pièce jointe permet aussi de choisir le dossier de destination.
• « Interrompre » équivaut à Esc dans le terminal. Les commandes comme /compact · /clear s'envoient avec les boutons rapides.

5. Nouvelle session · reprise

1. Dans « Nouvelle session », choisissez le Mac (hôte), le compte, le modèle, l'effort, le dossier du projet et le mode d'autorisation. Seuls les dossiers autorisés sur ce Mac peuvent être ouverts.
2. « Nouvelle conversation » ou « Reprendre » (choix d'une conversation terminée). La liste est lue sur le disque du Mac : les conversations des dossiers utilisés uniquement depuis le terminal y figurent aussi (en tête, la plus récente, comme avec claude --continue). La reprise rouvre la conversation avec le mode d'autorisation et l'effort qu'elle utilisait.
3. Si vous reprenez avec un autre compte que celui où la conversation est enregistrée, le fichier de conversation est copié vers ce compte pour la poursuivre (le fichier du compte d'origine reste intact).

6. Modèle · effort · mode d'autorisation

• Modifiez-les avec le bouton « Modèle · effort » de l'en-tête de session. Par défaut, le changement ne concerne que cette session ; si vous activez « Enregistrer aussi comme valeur par défaut des nouvelles sessions », la valeur par défaut du compte change également.
• Changer de modèle en cours de conversation fait relire toute la conversation par le nouveau modèle au message suivant : c'est plus lent et cela consomme davantage de jetons.
• Modes d'autorisation : Par défaut (demande à chaque fois) · Accepter les modifications · Plan · Auto (ne demande que pour ce qui semble risqué) · Tout autoriser (uniquement dans des dossiers de confiance).

7. Déplacer une session

Menu de la session › « Déplacer vers un autre hôte ». Seules les sessions terminées sur le Mac d'origine peuvent être déplacées.

• Déplacez la conversation seule, ou avec le dossier de travail. Le dossier de travail est archivé sans les dossiers régénérables comme node_modules ou target, transite par le serveur, puis est extrait dans un dossier vide du Mac de destination.
• Une barre de progression montre chaque étape (export → archivage → envoi → réception → extraction → reprise). Le transfert continue même si vous fermez le Web, et sa progression réapparaît à votre retour.
• Le code se synchronise normalement avec git. La fenêtre de déplacement compare et affiche l'état git des deux Mac.

8. Explorateur de fichiers

• Le bouton « Fichiers » de l'en-tête de session ouvre le dossier de la session. Onglets, affichage côte à côte, aperçu Markdown et aperçu des images sont pris en charge.
• Pour modifier : déverrouillez, modifiez, puis ⌘+S. Si Claude a modifié le même fichier entre-temps, un conflit est signalé.
• Renommez, dupliquez et supprimez des fichiers. La suppression se limite à un déplacement vers la corbeille, et rien n'est écrit dans .git ni dans .claude.
• Si vous réglez Paramètres › Ce navigateur › « Ouverture de l'explorateur de fichiers » sur « Dans une nouvelle fenêtre », « Fichiers » s'ouvre dans une fenêtre séparée : vous consultez les fichiers tout en suivant la conversation.

9. Tâches · utilisation

• Tâches : toutes sessions confondues, les agents en arrière-plan et les workflows en cours, ainsi que ceux terminés au cours des dernières 24 heures.
• Utilisation : choisissez la période, le compte et l'hôte pour comparer à la période précédente le coût estimé, les requêtes, les jetons de sortie et le succès de cache. Vous y trouverez les limites du compte (5 heures · hebdo · hebdo par modèle) avec une prévision au rythme actuel, des barres quotidiennes par modèle, des classements par projet et par session, et une carte thermique jour × heure.
• Les coûts sont des estimations calculées au tarif de l'API. Il ne s'agit pas du prix de l'abonnement.

10. Gestion · paramètres

• Hôtes : état de connexion, version et métriques, « Ajouter un hôte » et désinscription, « Mettre à jour maintenant » pour l'Agent.
• Comptes · Utilisation : état de connexion des comptes Claude · Ollama sur chaque Mac, connexion et déconnexion depuis le Web.
• Modèles : activation ou désactivation des modèles utilisables, modèle par défaut pour chaque type.
• Sauvegardes : l'Agent envoie toutes les 10 minutes l'historique des conversations de chaque Mac au serveur de l'entreprise. Taille de l'archive et espace disque libre du serveur, état des sauvegardes par hôte et « Sauvegarder maintenant », recherche des conversations sauvegardées et « Restaurer » (administrateurs). Une conversation restaurée s'ouvre via Nouvelle session › Reprendre.
• Paramètres : paramètres du serveur comme les limites d'aperçu des fichiers et les durées de conservation (administrateurs), et paramètres de ce navigateur comme le thème et l'éditeur.

11. Sur mobile et ordinateur

Mobile : dans Safari, utilisez « Sur l'écran d'accueil » pour lancer la console comme une app, puis naviguez avec les onglets du bas (Session · Alertes · Tâches · Utilisation · Gestion). Pour les approbations et les questions, « Répondre dans la session » depuis l'onglet Alertes vous y mène directement.

Ordinateur : la liste des sessions, la conversation et les alertes s'affichent côte à côte sur trois colonnes. Les colonnes latérales peuvent être repliées en bande résumée ou en bande d'icônes (mémorisé par ce navigateur), et l'explorateur de fichiers ouvre deux fichiers côte à côte. Un fichier glissé-déposé dans la zone de conversation est téléversé immédiatement.

12. Terminal web

Ouvrez depuis le Web le shell du Mac d'un développeur (Gestion › Hôtes › « Terminal ») et l'écran tmux réel d'une session claude (Menu de la session › « Voir dans le terminal »). Comme il s'agit d'un shell doté des droits de l'utilisateur de ce Mac, des conditions s'appliquent.

• Il doit être activé directement sur ce Mac — impossible de l'activer depuis le Web. Le désactiver ferme aussi les terminaux ouverts.
• Réservé aux administrateurs, avec un OTP redemandé à chaque ouverture. Ouverture, fermeture, heure et nombre d'octets sont consignés dans le journal d'audit, mais jamais le contenu des frappes. Le terminal se ferme après 30 minutes sans saisie.
• Sur ordinateur, il s'ouvre dans une fenêtre séparée (Paramètres › Ce navigateur › « Ouverture du terminal web »). Fermer ou recharger la fenêtre de la console n'affecte pas le terminal.
• Remontez dans la sortie précédente avec la molette, un glissement, PgUp/PgDn ou Shift+PageUp ; n'importe quelle touche ramène à l'écran courant. Une sélection à la souris est copiée aussitôt ; ⌘+K efface l'écran et la sortie précédente, ⌘+L l'écran seulement.
• Le nombre de lignes de sortie conservées se règle dans Paramètres › « Terminal web › Lignes d'historique » (10 000 lignes par défaut).

# Dans le terminal de ce Mac — activer · désactiver · état
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. Liste des prompts

• Dans « Prompts » de la colonne de droite (onglet « Alertes » sur mobile), seuls les textes saisis par une personne dans la session s'affichent, des plus récents aux plus anciens — numéro, heure et trois premières lignes ; un clic affiche le texte entier.
• Le bouton ↳ amène à ce prompt dans la conversation et le met brièvement en évidence. Pendant votre lecture à partir de là, une nouvelle sortie ne fait pas défiler l'écran vers le bas ; le bouton « Aller en bas » vous y ramène.
• Si vous choisissez un ancien prompt pas encore chargé à l'écran, la conversation qui l'entoure est chargée depuis le serveur avant d'y aller ; poursuivez la lecture avec « Charger la suite de la conversation ».

14. Langue

La console web prend en charge le coréen, l'anglais, le japonais, le chinois simplifié, le français, l'espagnol, l'indonésien, le vietnamien, le khmer et l'arabe. Choisissez la langue avec le bouton 🌐 en haut (en bas sur l'écran de connexion) ou dans Paramètres › Ce navigateur › « Langue ». La langue du navigateur est utilisée au départ, et la langue choisie est mémorisée par ce navigateur. Certains messages envoyés par le serveur ou l'Agent s'affichent encore en coréen.