Utiliser Droid : guide pas à pas de la CLI Factory Droid

Pour utiliser Droid, l’agent de code de Factory, vous installez la CLI avec curl -fsSL https://app.factory.ai/cli | sh, lancez droid dans un projet, vous connectez dans le navigateur et décrivez la tâche. Droid demande avant de modifier un fichier ou d’exécuter une commande ; pour les scripts et la CI, il existe droid exec, en lecture seule tant que vous n’augmentez pas son autonomie.

Ce guide couvre la CLI Droid telle qu’elle est en novembre 2026 (version 1.12) : installation, connexion, modèles, session interactive, droid exec et ses niveaux d’autonomie, AGENTS.md, serveurs MCP, droids personnalisés et prix.

Qu’est-ce que Droid ?

Droid est l’agent de code en terminal de Factory. Il lit votre base de code, propose des modifications et les applique une fois que vous les avez approuvées. Le même agent tourne aussi dans les applications de bureau et web de Factory, dans des intégrations IDE et via un SDK. La version 1.0 est sortie le 29 octobre 2026, et de nouvelles versions arrivent plusieurs fois par semaine.

Droid n’est lié à aucun fournisseur de modèles. Il propose des modèles d’Anthropic, d’OpenAI, de Google et de xAI, ainsi que des modèles open-weight que Factory regroupe sous le nom « Droid Core », et vous pouvez ajouter vos propres endpoints.

Étape 1 : installer la CLI

Sous macOS ou Linux :

curl -fsSL https://app.factory.ai/cli | sh

Autres options :

brew install --cask droid      # Homebrew
npm install -g droid           # npm

Sous Windows PowerShell :

irm https://app.factory.ai/cli/windows | iex

Sous Linux, la connexion nécessite aussi xdg-utils (sudo apt-get install xdg-utils). Pour mettre à jour plus tard : droid update.

Étape 2 : se connecter

cd my-project
droid

Le premier lancement ouvre le navigateur pour vous connecter avec un compte Factory. Pour la CI et les autres machines sans navigateur, créez une clé API dans les réglages de Factory et exportez-la :

export FACTORY_API_KEY=fk-...

Étape 3 : travailler dans une session

Décrivez la tâche avec des mots simples. Droid explique ce qu’il prévoit, puis demande avant chaque modification ou commande. Touches et commandes utiles :

• Shift+Tab bascule entre le mode normal et le mode spec, où Droid rédige un plan avant de modifier le code.
• ! vous permet d’exécuter vous-même une commande shell ; ? affiche les raccourcis.
• /model change de modèle, /settings ouvre les réglages, /review demande une revue des modifications.
• /compress raccourcit une longue conversation ; /sessions liste les précédentes.

Pour revenir plus tard, lancez droid --resume (ou droid --resume <id>). droid search "checkout bug" retrouve une ancienne session par son texte, et --fork <id> en copie une.

Étape 4 : choisir un modèle

Changez de modèle avec /model dans une session, -m en ligne de commande ou une clé model dans les réglages. Sur les offres payantes, chaque modèle compte dans votre usage avec un multiplicateur : en novembre 2026, Claude Opus 5.5 compte pour 1,6x, Claude Sonnet 5.5 pour 0,8x et Claude Haiku 5.5 pour 0,04x. Prenez un petit modèle pour les modifications courantes et un grand pour la conception et le débogage.

Pour utiliser votre propre clé, ajoutez un modèle personnalisé dans ~/.factory/settings.json :

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Sonnet (my key)",
      "baseUrl": "https://api.anthropic.com",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "provider": "anthropic"
    }
  ]
}

provider vaut anthropic, openai, generic-chat-completion-api ou bedrock-converse. Les clés restent sur votre machine.

Étape 5 : droid exec et niveaux d’autonomie

droid exec exécute une seule tâche sans chat, ce qu’il vous faut dans les scripts et la CI :

droid exec "summarize the changes on this branch"
droid exec --auto low "fix the failing unit test in price.test.ts"
droid exec -f task.md -o json --auto medium

Par défaut, il est en lecture seule. C’est vous qui élargissez ce qu’il peut faire :

--skip-permissions-unsafe désactive toutes les demandes de confirmation ; réservez-le aux conteneurs jetables. Notez qu’un code de sortie 0 signifie que Droid a terminé, pas que la tâche a réussi : vérifiez donc le résultat dans la CI. Pour les sessions interactives, vous pouvez définir un niveau par défaut avec sessionDefaultSettings.autonomyLevel et des permissionRules plus fines (allow, ask, block) dans les réglages.

Étape 6 : AGENTS.md et réglages

Droid lit AGENTS.md comme les instructions du dépôt. Gardez-le court : la stack, comment lancer les tests, ce qu’il ne faut pas toucher et ce que « terminé » veut dire. Notre guide sur CLAUDE.md et AGENTS.md explique quoi y mettre.

Les réglages se trouvent dans ~/.factory/settings.json pour vous et dans .factory/settings.json pour le projet, chacun avec un settings.local.json pour les surcharges que vous ne commitez pas.

Étape 7 : serveurs MCP et droids personnalisés

Ajoutez des serveurs MCP depuis la ligne de commande :

droid mcp add docs https://example.com/mcp --type http
droid mcp add memory "npx -y @modelcontextprotocol/server-memory"

Ils sont enregistrés dans ~/.factory/mcp.json (ou .factory/mcp.json pour le projet) sous mcpServers. Dans une session, /mcp les gère, y compris les connexions OAuth.

Les droids personnalisés sont des sous-agents : un fichier Markdown avec un en-tête YAML (name, description, model, tools et plus) dans .factory/droids/ ou ~/.factory/droids/. Droid leur confie du travail via son outil Task, et /droids permet de les gérer. Un petit droid « rédacteur de tests » ou « relecteur » sur un modèle bon marché est un bon premier choix.

Combien coûte Droid (en novembre 2026)

Consultez la page des tarifs de Factory avant de décider ; les offres changent souvent.

Pièges courants

• Anciens liens vers la documentation. La documentation est passée de docs.factory.ai à docs.factory.com ; les URL d’installation utilisent toujours app.factory.ai.
• Lancer exec avec une autonomie élevée trop tôt. Démarrez les jobs de CI en --auto low et n’augmentez le niveau que pour les étapes qui en ont besoin.
• Se fier au code de sortie 0. Il signifie seulement que l’exécution s’est terminée. Vérifiez ensuite les tests ou le diff.
• -r a deux sens. Dans droid, -r reprend une session ; dans droid exec, il règle l’effort de raisonnement. Écrivez --resume en entier pour éviter les surprises.

Faire tourner Droid à côté d’autres CLI dans AgentVera

Si Droid est votre seul agent, les applications de Factory suffisent peut-être. Les choses se compliquent quand Droid tourne à côté de Claude Code, Codex ou Gemini CLI sur le même projet. AgentVera est une application de bureau qui exécute ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et connexions. La prise en charge de Droid fonctionne ainsi :

• Une session par agent. AgentVera repère la session créée par Droid et la rouvre avec droid --resume <id> aux lancements suivants : la conversation survit à un redémarrage de l’application.
• Modèle, effort et rôle. Le modèle et l’effort choisis pour l’agent sont transmis via un fichier de réglages, et le rôle de l’agent avec --append-system-prompt.
• Votre connexion ou vos clés API. Droid conserve votre connexion Factory. Dans Réglages → Comptes, vous pouvez ajouter des comptes FACTORY_API_KEY et attribuer le sien à chaque agent.
• Volets, worktrees et revue. Faites tourner Droid dans la grille du workspace à côté d’autres agents, chacun dans son propre git worktree, et vérifiez leurs modifications avec la 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. Pour essayer, téléchargez AgentVera.

En résumé

Deux commandes suffisent pour démarrer avec Droid : le script d’installation et droid. Ensuite, tout est affaire de contrôle : gardez les sessions interactives sous approbation, démarrez droid exec en --auto low, mettez les règles du projet dans AGENTS.md et choisissez un modèle par tâche en tenant compte du multiplicateur d’usage.

Sources : démarrage rapide de Droid, référence de la CLI, droid exec, modèles, MCP, changelog.