Pour utiliser AgentVera, installez les CLI d’agents de code voulus, ajoutez un dossier projet, lancez un ou plusieurs agents depuis New agent et travaillez avec eux côte à côte dans la grille du projet. Chaque agent est le vrai CLI, par exemple Claude Code ou Codex, dans son propre volet de terminal avec sa propre connexion. AgentVera ajoute ce qui l’entoure : une grille par projet, une zone de message avec file d’attente, l’état en un coup d’œil, des checkpoints à chaque tour, la revue de code et la gestion des comptes.
Ce guide vous mène d’une fenêtre vide à quelques agents opérationnels. Il couvre ce qu’il faut installer d’abord, le fonctionnement de la boîte New agent, l’organisation de la grille, la connexion aux CLI et à AgentVera lui-même, et les habitudes qui évitent que des agents parallèles se marchent dessus.
Ce qu’il faut avant de commencer
AgentVera est une application de bureau pour macOS, Windows et Linux. Vous la trouvez sur la page de téléchargement. Elle n’embarque pas son propre modèle. Elle lance les CLI d’agents déjà présents sur votre ordinateur.
| Ce qu’il vous faut | Pourquoi |
|---|---|
| Au moins un CLI d’agent, comme Claude Code ou Codex | AgentVera lance le vrai CLI pour chaque agent |
| Une connexion pour ce CLI | Les agents utilisent la connexion et l’offre propres au CLI |
| Un dossier projet, idéalement un dépôt Git | Les checkpoints, les worktrees et la revue de code reposent sur Git |
| Un compte AgentVera (facultatif) | Uniquement pour les fonctions Pro et Team |
Si vous n’avez jamais utilisé Claude Code, Comment utiliser Claude Code explique l’installation et la connexion. AgentVera prend en charge 18 CLI d’agents, dont Claude Code, Codex, Gemini CLI et GitHub Copilot CLI : commencez par celui que vous payez déjà.
Étape 1 : ajouter votre premier projet
Ouvrez AgentVera et cliquez sur Add project folder dans la barre du haut. Choisissez le dossier d’un dépôt sur lequel vous travaillez. Le projet apparaît sur l’écran Projects home et dans la barre du haut ; vous passez de l’un à l’autre depuis là ou avec la palette de commandes (⌘K, Ctrl K sous Windows et Linux).
Chaque projet a deux vues :
- Workspace : la grille des volets d’agents, où vous passez le plus clair de votre temps.
- Details : les informations sur le projet autour des agents.
Si vous voulez juste poser une question rapide avant de configurer un projet, l’écran d’accueil propose un chat rapide. Ces chats s’exécutent dans le dossier propre à l’app et ne touchent pas vos projets.
Étape 2 : lancer votre premier agent
Cliquez sur New agent dans la barre latérale, ou appuyez sur ⌘N. La boîte de dialogue dit ce qu’elle attend : choisissez un outil, puis donnez un nom à l’agent et, si besoin, un rôle.
- Tool : choisissez le CLI, par exemple Claude Code ou Codex. Un outil qu’AgentVera ne trouve pas sur cet ordinateur est marqué Not installed.
- Agent name et Color : un nom court comme « Backend » ou « Reviewer » rend la grille plus facile à parcourir.
- Runs on : laissez This computer pour l’instant. Vous pouvez aussi lancer un agent sur un serveur SSH.
- Account : la connexion que l’agent utilise. Par défaut, c’est celle déjà présente sur cet ordinateur. Le champ affiche Signed in ou Signed out.
- Workspace : le dossier principal ou l’un des worktrees Git du projet.
- Role and instructions (rôle et instructions) : facultatif. Pour Claude, c’est ajouté au prompt système ; pour Codex, c’est ajouté comme instructions développeur.
- Cliquez sur Start agent.
La boîte propose d’autres options : profil de contexte, navigateur, carte du projet, serveurs MCP, conteneur Docker, budget de tokens et chemins attribués. Vous pouvez tout laisser par défaut pour un premier essai et y revenir plus tard. Économies de tokens explique les profils de contexte, et Docker explique comment exécuter un agent dans un conteneur.
L’agent s’ouvre dans un volet. Ce volet est un vrai terminal qui exécute le CLI : tout ce que le CLI fait dans un terminal normal fonctionne ici aussi, y compris ses commandes slash. En dessous se trouve une zone de message avec historique des prompts, brouillons et file d’attente (⌘Enter met un message en file pendant que l’agent est occupé).
Étape 3 : connecter les agents
Les agents ne se connectent pas via AgentVera. Ils utilisent les connexions propres aux CLI : si claude ou codex fonctionne déjà dans votre terminal, le compte par défaut est prêt. AgentVera marque ce compte par défaut this computer.
Si un compte est déconnecté, la boîte New agent vous prévient : « This account is signed out. Sign in from Settings → Accounts, or the agent will ask you to sign in on first launch. » Vous pouvez suivre l’un ou l’autre chemin.
Pour utiliser plusieurs comptes Claude ou Codex, ouvrez Settings → Accounts, cliquez sur Add Claude account ou Add Codex account, donnez-lui un nom et choisissez Add and sign in. Chaque compte supplémentaire a son propre dossier de configuration, et vous choisissez le compte d’un agent à sa création. Comment changer de compte Claude Code détaille la marche à suivre.
Étape 4 : ajouter des agents et organiser la grille
Un agent est utile. Deux ou trois en parallèle, c’est là qu’AgentVera prend tout son sens. Créez un deuxième agent de la même façon et donnez à chacun une tâche claire et distincte.
La grille se règle dans Screen splitter (⌘⌥L). Choisissez le nombre de colonnes et de lignes, de 1×1 jusqu’à 5×4, ou une disposition toute prête comme « Top 2 · Bottom 1 ». Faites glisser les séparateurs pour redimensionner les volets et utilisez Equalize pane sizes pour les réinitialiser. Chaque projet mémorise sa propre disposition.
| Action | Comment |
|---|---|
| Échanger deux volets | Faire glisser un volet sur un autre |
| Agrandir un volet | Double-clic sur son titre, ou ⌘⇧Enter |
| Changer de focus entre agents | ⌘⌥ + flèches |
| Aller à un volet | ⌘1 à ⌘9 |
| Ouvrir la palette de commandes | ⌘K |
| Ouvrir le screen splitter | ⌘⌥L |
Sous Windows et Linux, utilisez Ctrl à la place de ⌘ et Alt à la place de ⌥. Vous pouvez modifier chaque raccourci dans les réglages. Un volet peut aussi s’ouvrir dans une fenêtre modale ou une fenêtre séparée si vous voulez un agent sur un second écran.
Quand plusieurs agents partagent un même dossier, ils peuvent écraser les fichiers les uns des autres. Pointer chaque agent vers son propre worktree Git dans le champ Workspace l’évite. Git worktrees pour agents parallèles explique la mise en place, et Comment lancer plusieurs agents Claude Code traite du partage du travail.
Étape 5 : suivre ce que fait chaque agent
Chaque agent affiche un statut : Working, Waiting for you, Needs approval, Idle, Asleep, Stopped ou Error. La barre d’état les compte, par exemple « 2 working » ou « 3 agents need approval », pour voir ce qui vous attend sans ouvrir chaque volet. Appuyez sur ⇧⌘A pour aller à l’agent suivant qui attend une approbation.
Quand vous vous éloignez, des notifications de bureau vous préviennent qu’un agent a terminé, a échoué ou attend une approbation. Vous pouvez aussi les recevoir sur votre téléphone. Voir notifications et approbations.
Étape 6 : vérifier le travail et annuler un mauvais tour
Deux fonctions gratuites aident à faire confiance à ce que produisent des agents parallèles.
- Code review : une fois activée dans les réglages du projet, un modèle Claude de votre choix relit le code de chaque agent à la fin de son tour. Les constats arrivent avec une gravité et un lien fichier:ligne, et peuvent en option être renvoyés à l’agent. Voir revue de code.
- Checkpoints : au début de chaque tour, AgentVera prend un instantané du dossier de travail de l’agent. Le bouton Turns de l’en-tête du volet liste les tours et les fichiers modifiés par chacun, et Roll back this turn restaure le dossier. Comment annuler les changements de Claude Code détaille cette étape.
Étape 7 : ne vous connecter à AgentVera que si nécessaire
L’essentiel de ce guide relève de l’offre Free, sans compte. Pro et Team ajoutent des fonctions comme les flows, night shift, l’approbation automatique et la bascule automatique de compte. Pour les utiliser, choisissez Sign in to AgentVera dans l’app. Vous pouvez vous connecter via le navigateur (la connexion Google et l’authentification à deux facteurs y sont gérées) ou avec e-mail et mot de passe. La page des tarifs liste le contenu de chaque offre.
Une première session efficace
Si vous ne savez pas par où commencer, voici une configuration simple qui montre vite l’intérêt :
- Ajoutez un dépôt que vous connaissez bien.
- Lancez un agent Claude Code dans un nouveau worktree et demandez-lui une petite modification bien délimitée.
- Lancez un second agent (Codex, ou un autre Claude Code) dans son propre worktree sur une tâche sans rapport.
- Réglez la grille sur deux colonnes et gardez les deux visibles.
- Pendant qu’ils travaillent, lisez les diffs, répondez aux approbations et mettez votre prochain message en file.
- Quand un tour tourne mal, annulez-le depuis Turns plutôt que de discuter avec l’agent.
Conseils pour la première semaine
- Une tâche par agent. Nommez les agents d’après leur tâche. Un rôle clair dans Role and instructions vous évite de vous répéter.
- Un worktree par agent. C’est le moyen le plus simple d’éviter qu’ils s’écrasent mutuellement.
- Gardez la grille petite au début. Deux ou trois agents que vous lisez vraiment valent mieux que huit que vous survolez.
- Utilisez la palette. ⌘K trouve presque toutes les actions, avec leur raccourci à côté.
- Surveillez les limites. La barre d’état montre l’usage sur 5 heures et sur la semaine de chaque compte. Limites d’usage de Claude Code donne des conseils pour les faire durer.
- Changez de langue si vous voulez. L’interface existe en anglais et en turc, avec des thèmes clair et sombre, dans Settings → Appearance.
En résumé
La prise en main d’AgentVera prend quelques minutes. Vous ajoutez un projet, lancez un agent avec le CLI que vous utilisez déjà, et en ajoutez un second quand vous avez une seconde tâche. Tout le reste, comme les worktrees, les checkpoints, la revue, les comptes supplémentaires et les notifications sur téléphone, repose sur cette même grille. Vous ajoutez chaque élément quand vous en avez besoin.