Agents de code IA pour agences : gérer plusieurs projets clients

Pour faire tourner des agents de code IA sur plusieurs projets clients, donnez à chaque client son propre dossier, son propre fichier d’instructions et, quand le contrat l’exige, son propre compte d’agent, puis lancez chaque agent uniquement dans le dossier de ce client. La plupart des problèmes que les agences rencontrent avec les agents (mauvaises conventions, contexte qui fuit, coûts imprévus) viennent d’une configuration partagée, pas du modèle.

Ce guide s’adresse aux petites agences et aux freelances qui utilisent déjà Claude Code, Codex ou un autre agent de code sur un projet et veulent maintenant l’utiliser sur cinq. Il couvre la configuration par client, la visibilité des coûts, la relecture avant livraison et la façon de garder tout cela dans une seule fenêtre.

Pourquoi une seule configuration pour tous les clients ne tient pas

Un agent de code travaille avec ce qu’il voit : le dossier où il démarre, les fichiers d’instructions qui s’y trouvent et le compte avec lequel il est connecté. Quand tout cela est partagé entre clients, trois choses se passent mal :

• Les conventions fuient. L’agent reprend des habitudes du code ou des instructions du client précédent et les applique au suivant.
• Les coûts se brouillent. Un seul compte et une seule barre d’usage pour tout : impossible de savoir quel client a consommé quoi.
• L’accès est plus large que nécessaire. Un agent lancé dans un dossier parent peut lire tous les dossiers clients en dessous, y compris les fichiers .env.

La solution est banale et elle marche : une frontière par client.

Étape 1 : un dossier par client, et lancer les agents dedans

Gardez chaque client dans son propre dossier, avec son propre dépôt :

~/clients/
  acme-shop/
  dental-clinic-site/
  logistics-dashboard/

Lancez toujours l’agent depuis un dossier client, jamais depuis ~/clients/. Claude Code, Codex et Gemini CLI considèrent tous le dossier où vous les lancez comme le projet. S’il vous faut un deuxième agent sur le même client, par exemple un sur un correctif et un sur une nouvelle page, donnez-lui un git worktree pour qu’ils ne modifient pas les mêmes fichiers.

Étape 2 : un fichier d’instructions par client

Chaque agent de code lit un fichier d’instructions de projet au début d’une session : CLAUDE.md pour Claude Code, AGENTS.md pour Codex et beaucoup d’autres. Placez-en un à la racine de chaque dossier client. Faites court et précis :

# Client : boutique en ligne (thème Shopify + API Node)

- Stack : thème Liquid, Node 22, Postgres. Tests : npm test.
- Style du client : pas de nouvelle dépendance sans demander ; textes en turc et en anglais.
- Ne jamais toucher : réglages de paiement, /infra, fichiers .env de production.
- Terminé veut dire : les tests passent, une pull request avec un court résumé pour le client.

Ce fichier fait la différence entre un agent qui devine et un agent qui suit les règles du client. Quand un client change une règle, modifiez le fichier, pas vos prompts.

Étape 3 : choisir les comptes par client

Certains clients se moquent du compte utilisé par l’agent. D’autres veulent que le travail passe par un compte qu’ils paient, ou interdisent d’envoyer leur code à un fournisseur qu’ils n’ont pas validé. Vérifiez d’abord le contrat.

Quand un client a besoin de sa propre connexion, donnez à ce compte son propre dossier de config. Claude Code lit son dossier depuis CLAUDE_CONFIG_DIR et Codex depuis CODEX_HOME : deux dossiers, c’est deux connexions sur la même machine sans vous déconnecter. Notre guide pour changer de compte Claude Code montre la configuration manuelle pas à pas.

Étape 4 : garder les secrets hors de portée

Les agents lisent des fichiers pour comprendre un projet, et les .env sont des fichiers. Pour chaque client :

• gardez les identifiants de production hors du dossier de travail ; utilisez un .env de développement avec des clés de test ;
• ajoutez les chemins sensibles au fichier d’instructions, sous « ne jamais toucher » ;
• utilisez les réglages de permissions de l’agent pour qu’il demande avant de lancer des commandes qui déploient, migrent ou suppriment.

Étape 5 : mesurer les tokens par client

Si vous comptez facturer l’usage de l’IA, ou voulez simplement savoir quel client est rentable, mesurez-le par agent et par dossier dès le premier jour. Deux règles simples aident :

• fixez un plafond quotidien par agent, pour qu’une boucle bloquée ne brûle pas le budget d’un client pendant la nuit ;
• utilisez le modèle le moins cher pour les modifications courantes et le plus puissant seulement pour la conception et le débogage.

Notre article sur les limites d’usage de Claude Code explique comment fonctionnent les limites sur 5 heures et hebdomadaires, ce qui compte dès que plusieurs clients partagent un abonnement.

Étape 6 : relire chaque diff avant que le client ne le voie

Laissez les agents travailler sur une branche et ouvrir une pull request. Lisez le diff, lancez les tests et vérifiez la page vous-même. Les clients ne paient pas pour du code écrit par un agent ; ils paient pour du code vérifié par quelqu’un en qui ils ont confiance. Un court résumé écrit par pull request facilite aussi le point hebdomadaire avec le client.

Tout cela dans une seule fenêtre avec AgentVera

Les étapes ci-dessus fonctionnent avec de simples terminaux. Le plus dur, c’est de garder cinq clients et dix agents sous les yeux. AgentVera est une application de bureau pour macOS, Windows et Linux qui fait tourner Claude Code, Codex, Gemini CLI et d’autres agents côte à côte, chacun dans un vrai terminal avec votre propre installation et votre propre connexion. Pour le travail d’agence, voici ce qui compte :

• Une grille par projet. Chaque dossier client a son propre ensemble d’agents, et vous passez d’un client à l’autre sans perdre leur état. Voir espace de travail.
• Un compte par agent. Ajoutez des comptes dans Settings → Accounts et choisissez-en un à la création d’un agent, pour que les agents d’un client tournent toujours avec la bonne connexion. Voir comptes.
• Plafonds de tokens par agent. Plafonds par agent, par tour et par jour, une alerte à 80 %, et au plafond l’agent s’arrête mais garde sa conversation. Voir budgets de tokens.
• Revue de code avant livraison. Relisez les modifications de l’agent dans l’application avant qu’elles n’arrivent sur le dépôt du client. Voir revue de code.

L’offre gratuite comprend jusqu’à 18 agents, MCP, Git, Docker, SSH, la revue de code et les économies de tokens. Pro coûte 9,99 $ par mois ; si vous n’avez jamais eu d’essai, votre première connexion à l’application active Pro pendant 7 jours, sans carte.

En résumé

Les agents passent à l’échelle sur de nombreux clients quand chaque client a une frontière claire : son propre dossier, son propre fichier d’instructions, le bon compte, aucun secret de production à portée, son propre décompte de tokens et une relecture humaine avant livraison. Mettez cela en place une fois par client, et ajouter le sixième client prend quelques minutes, pas une semaine de nettoyage.

Sources : Claude Code settings, AGENTS.md.