# Utiliser AgentVera : premier projet, agents et grille

URL: https://agentvera.dev/fr/blog/getting-started-with-agentvera/ · Publié: 2026-10-24

Comment utiliser AgentVera pas à pas : ajouter un dossier projet, lancer des agents Claude Code ou Codex, organiser la grille, suivre leur statut et vous connecter.

**En bref:**

- Installez les CLI d’agents voulus, ouvrez AgentVera, ajoutez un dossier projet et lancez des agents avec New agent ; chacun tourne comme le vrai CLI dans son propre volet de terminal.
- Les agents utilisent les connexions existantes des CLI. Les comptes Claude et Codex supplémentaires se gèrent dans Settings → Accounts, et vous en choisissez un par agent dans la boîte New agent.
- Les fonctions de base marchent sans compte AgentVera. Connectez-vous seulement pour les fonctions Pro et Team : flows, approbation automatique, bascule automatique de compte.

**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](/fr/download/). 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](/fr/blog/how-to-use-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.

1. **Tool :** choisissez le CLI, par exemple Claude Code ou Codex. Un outil qu’AgentVera ne trouve pas sur cet ordinateur est marqué **Not installed**.
2. **Agent name** et **Color :** un nom court comme « Backend » ou « Reviewer » rend la grille plus facile à parcourir.
3. **Runs on :** laissez **This computer** pour l’instant. Vous pouvez aussi lancer un agent sur un serveur SSH.
4. **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**.
5. **Workspace :** le dossier principal ou l’un des worktrees Git du projet.
6. **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.
7. 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](/fr/features/token-savings/) explique les profils de contexte, et [Docker](/fr/features/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](/fr/blog/switch-claude-code-accounts/) 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](/fr/blog/git-worktree-parallel-agents/) explique la mise en place, et [Comment lancer plusieurs agents Claude Code](/fr/blog/run-multiple-claude-code-agents/) 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](/fr/features/notifications-and-approvals/).

## É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](/fr/features/code-review/).
- **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](/fr/blog/undo-claude-code-changes/) 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](/fr/pricing/) 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 :

1. Ajoutez un dépôt que vous connaissez bien.
2. Lancez un agent Claude Code dans un nouveau worktree et demandez-lui une petite modification bien délimitée.
3. Lancez un second agent (Codex, ou un autre Claude Code) dans son propre worktree sur une tâche sans rapport.
4. Réglez la grille sur deux colonnes et gardez les deux visibles.
5. Pendant qu’ils travaillent, lisez les diffs, répondez aux approbations et mettez votre prochain message en file.
6. 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](/fr/blog/claude-code-usage-limits/) 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.

## Questions fréquentes

**Faut-il un compte AgentVera pour commencer ?** Non. Les projets, les agents, la grille, Git, MCP, Docker, SSH, la revue de code et les économies de tokens font partie de l’offre Free et ne demandent aucun compte. Vous ne vous connectez à votre compte AgentVera que pour débloquer les fonctions Pro ou Team.

**AgentVera remplace-t-il Claude Code ou Codex ?** Non. AgentVera lance les vrais CLI. Chaque agent est un processus Claude Code, Codex, Gemini CLI, Copilot CLI ou autre CLI dans son propre terminal, et il utilise la connexion et les réglages de ce CLI.

**Que faire si l’outil choisi affiche Not installed ?** AgentVera n’a pas trouvé ce CLI sur cet ordinateur. Installez-le comme l’indique son éditeur, vérifiez que la commande fonctionne dans un terminal normal, puis rouvrez la boîte New agent.

**Combien d’agents puis-je lancer dans un projet ?** L’offre Free n’impose aucune limite d’agents. La grille affiche jusqu’à 5 colonnes sur 4 lignes de volets par projet, et chaque projet mémorise sa propre disposition.

**Sur quels systèmes AgentVera fonctionne-t-il ?** macOS, Windows et Linux. L’app se met à jour depuis agentvera.dev, et les agents retrouvent leur conversation à la prochaine ouverture.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/