Configurez votre premier agent

D'une installation vierge à un agent IA opérationnel. Les deux étapes que la plupart des débutants ratent sont en haut : comment AgentsRoom s'articule avec les CLIs IA, et comment se connecter.

Comment AgentsRoom fonctionne (à lire en premier)

AgentsRoom est le cockpit. Les CLIs IA (Claude Code, Codex, OpenCode, Gemini, Aider) sont les moteurs. Vous vous connectez aux moteurs une seule fois via leur propre commande, puis AgentsRoom les pilote visuellement. AgentsRoom ne stocke ni ne voit jamais vos tokens, clés API ou mot de passe ChatGPT : ils restent dans le stockage sécurisé de chaque CLI sur votre machine.

Il n'y a volontairement pas de bouton "Se connecter à ChatGPT" ou "Se connecter à Anthropic" dans AgentsRoom. La connexion vit dans le CLI que vous installez à l'étape 0 ci-dessous.

Avant de commencer

✓macOS 14+ (Sonoma ou ultérieur)
✓
Au moins un CLI de coding IA installé (Claude, Codex, OpenCode, Gemini CLI ou Aider)
ex. npm install -g @anthropic-ai/claude-code
✓Un abonnement actif ou une clé API pour le provider choisi

Étape 0 : installer et se connecter à votre moteur IA

Choisissez un provider pour commencer (vous pourrez en ajouter d'autres plus tard). Pour chacun : installez le CLI, lancez-le une fois pour vous connecter, vérifiez que ça marche. Ensuite passez à l'étape 1.

Cliquez sur un provider pour déplier ses étapes de setup.

Claude (Anthropic)Recommandé pour débuter

Compatible avec

Claude Pro, Claude Max, ou une clé API Anthropic.

1. Installer

npm install -g @anthropic-ai/claude-code

2. Se connecter

Lancez claude une fois dans n'importe quel terminal. Une fenêtre du navigateur s'ouvre pour vous connecter avec votre compte Anthropic.

3. Vérifier

Lancez la commande d'installation ci-dessus, puis tapez le nom du CLI seul dans votre terminal (par exemple tapez "claude" et appuyez sur entrée). Vous devriez voir un prompt de bienvenue. Tapez "bonjour" et appuyez sur entrée : si vous obtenez une réponse, vous êtes prêt à l'utiliser dans AgentsRoom.

Codex (OpenAI / ChatGPT)Utilisez votre compte ChatGPT

Compatible avec

ChatGPT Plus, Pro, Team ou Enterprise, ou une clé API OpenAI.

1. Installer

npm install -g @openai/codex

2. Se connecter

Lancez codex une fois dans n'importe quel terminal. Une fenêtre du navigateur s'ouvre. Connectez-vous avec votre compte ChatGPT, le même que sur chatgpt.com.

3. Vérifier

OpenCodeChoisissez votre provider

Compatible avec

N'importe quel provider configuré : Anthropic, OpenAI, OpenRouter, et plus.

1. Installer

npm install -g opencode-ai

2. Se connecter

Lancez opencode auth login et suivez les instructions pour ajouter une clé provider.

3. Vérifier

Gemini CLI (Google)Offre gratuite disponible

Compatible avec

Un compte Google (offre gratuite disponible) ou une clé API Gemini.

1. Installer

npm install -g @google/gemini-cli

2. Se connecter

Lancez gemini une fois. Une fenêtre du navigateur s'ouvre pour la connexion Google.

3. Vérifier

AiderPour utilisateurs avancés

Compatible avec

N'importe quel provider via clé API (Anthropic, OpenAI, DeepSeek et plus).

1. Installer

pip install aider-chat

2. Se connecter

Pas de commande de connexion. Mettez votre clé API en variable d'environnement dans votre shell, par exemple : export ANTHROPIC_API_KEY=sk-...

3. Vérifier

Bloqué à cette étape ? Voir la section dépannage en bas de page.

Téléchargez et installez AgentsRoom

Téléchargez le fichier .dmg, ouvrez-le et glissez AgentsRoom dans votre dossier Applications. Lancez-le depuis Spotlight ou le dossier Applications.

Tip: AgentsRoom vérifie automatiquement les mises à jour. Vous serez notifié quand une nouvelle version est disponible.

Créez votre premier projet

Cliquez sur le bouton + dans la barre latérale. Sélectionnez n'importe quel dossier sur votre machine : c'est là que vos agents IA travailleront. Nommez votre projet et assignez-le à une zone.

Tip: Chaque projet correspond à un vrai dossier. Les agents exécutent le CLI du provider choisi dans ce répertoire, exactement comme vous le feriez dans votre terminal.

Ajoutez votre premier agent

Dans votre projet, cliquez sur Ajouter un agent. Choisissez un rôle (Fullstack est un bon début), puis un provider (le moteur configuré à l'étape 0), puis un modèle (Sonnet recommandé pour Claude). Écrivez éventuellement un prompt initial et cliquez sur Lancer. Le terminal s'ouvre et exécute le CLI pour vous.

Tip: Si le terminal semble vide ou affiche un écran de connexion, c'est que le CLI de l'étape 0 n'est pas connecté. Ouvrez un terminal classique, lancez claude ou codex (ou la commande de votre provider) une fois, faites la connexion, puis revenez.

Regardez-le bosser

Le terminal affiche la sortie en direct : chaque fichier lu, chaque modification. Le statut évolue : réfléchit, code, terminé. Vous recevez une notification macOS quand c'est fini.

Tip: Vous pouvez lancer plusieurs agents en même temps. Chacun a son propre terminal et travaille de façon indépendante.

Personnalisez votre setup

Éditez CLAUDE.md directement depuis AgentsRoom pour donner plus de contexte à vos agents. Changez les modèles, ajustez les permissions, configurez les hooks. Ajoutez d'autres agents avec des rôles ou providers différents.

Tip: Opus pour l'architecture. Sonnet pour le dev. Haiku pour les tâches rapides comme les tests.

Astuces

1.Utilisez Opus pour les décisions d'architecture, Sonnet pour le dev quotidien, Haiku pour les tâches rapides

2.Groupez vos projets par zone (Taff, Perso, Side-projects) pour mieux vous organiser

3.Éditez CLAUDE.md depuis AgentsRoom pour donner plus de contexte à vos agents

4.Activez les notifications macOS pour pouvoir faire autre chose pendant que vos agents bossent

5.Commencez avec un agent par projet, ajoutez-en d'autres quand vous êtes à l'aise

Dépannage

Le terminal de mon agent semble vide ou bloqué

La plupart du temps, le CLI n'est pas connecté. Ouvrez un terminal classique (Terminal.app), lancez la commande du CLI seule (claude, codex, gemini, opencode), faites la connexion dans le navigateur, puis revenez dans AgentsRoom et relancez l'agent. AgentsRoom n'a pas son propre écran de connexion : l'auth vit dans le CLI.

command not found: claude (ou codex, gemini, etc.)

Le CLI n'est pas installé, ou votre PATH shell ne le voit pas. Relancez la commande d'installation de l'étape 0 ci-dessus. Si vous utilisez nvm, installez le CLI avec la même version de Node que celle que vous utilisez au quotidien, sinon le binaire ne sera pas dans le PATH au lancement d'AgentsRoom.

Je ne vois pas de bouton pour me connecter à ChatGPT ou Claude dans AgentsRoom

C'est volontaire. AgentsRoom est une interface au-dessus des CLIs et ne manipule jamais vos identifiants directement. La connexion se fait une fois dans le CLI (lancez claude ou codex dans un terminal), ensuite AgentsRoom utilise cette session. C'est ce qui rend AgentsRoom plus sûr que les outils qui interceptent vos tokens.

Agent bloqué sur "réfléchit"

Vérifiez que votre abonnement ou clé API est actif pour le provider sélectionné. Lancez le CLI directement dans votre terminal pour voir le vrai message d'erreur : Claude ou OpenAI throttlent ou expirent parfois les sessions silencieusement.

Aucun projet n'apparaît dans la barre latérale

Vérifiez que vous avez sélectionné un dossier valide lors de la création du projet. Le dossier doit exister sur le disque. Redémarrez AgentsRoom si un projet a été ajouté mais pas encore visible.

J'ai installé le CLI mais AgentsRoom dit toujours "command not found"

AgentsRoom hérite de son PATH du shell de connexion, pas de votre terminal interactif. Quittez AgentsRoom complètement, ouvrez un nouveau terminal, vérifiez que le CLI est appelable depuis une nouvelle session shell (which claude), puis relancez AgentsRoom.