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

URL: https://agentvera.dev/fr/blog/how-to-use-droid/ · Publié: 2026-11-14

Utiliser Factory Droid dans le terminal : installer, se connecter, choisir un modèle, lancer droid exec avec ses niveaux d’autonomie, configurer AGENTS.md, MCP et droids.

**En bref:**

- Installez via curl -fsSL https://app.factory.ai/cli | sh (ou brew install --cask droid), lancez droid dans un projet, connectez-vous par le navigateur et décrivez la tâche. Droid demande avant de modifier ou d’exécuter.
- Pour scripts et CI, droid exec est en lecture seule par défaut ; --auto low autorise les modifications, medium ajoute installs, builds, tests et commits, high les pushs et déploiements. FACTORY_API_KEY sert en headless.
- L’offre Free fonctionne avec votre propre inférence (ChatGPT, Copilot, OpenRouter ou clés API) ; Pro coûte 20 $ par mois en novembre 2026. Les règles vont dans AGENTS.md, réglages et serveurs MCP dans ~/.factory/.

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](https://factory.com "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 :

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

Autres options :

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

Sous Windows PowerShell :

```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

```bash
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 :

```bash
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` :

```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 :

```bash
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 :

| Niveau | Ce qu’il autorise |
|---|---|
| (par défaut) | Lecture seule |
| `--auto low` | Modification de fichiers |
| `--auto medium` | En plus installs, builds, tests, commit, checkout et pull |
| `--auto high` | En plus pushs et déploiements |

`--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](/fr/blog/claude-md-agents-md/ "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 :

```bash
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)

| Offre | Prix | Remarques |
|---|---|---|
| Free | 0 $ | Vous apportez l’inférence : ChatGPT, Copilot, OpenRouter ou vos propres clés |
| Pro | 20 $/mois | Tous les modèles, application de bureau, CLI et SDK |
| Plus | 100 $/mois | Environ 5x l’usage de Pro |
| Max | 200 $/mois | Environ 10x l’usage de Pro |
| Teams | 60 $/mois + 40 $/siège | Jusqu’à 10 sièges |

Consultez la [page des tarifs de Factory](https://factory.com/pricing "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](https://docs.factory.com "Documentation de Factory") ; 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](/fr/ "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](/fr/agents/factory-droid/ "Factory Droid dans AgentVera") 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](/fr/features/workspace/ "Workspace") à côté d’autres agents, chacun dans son propre git worktree, et vérifiez leurs modifications avec la [revue de code](/fr/features/code-review/ "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](/fr/download/ "Télécharger 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](https://docs.factory.com/cli/getting-started/quickstart "Démarrage rapide de Droid"), [référence de la CLI](https://docs.factory.com/docs/droid-cli/cli-reference "Référence de la CLI Droid"), [droid exec](https://docs.factory.com/docs/droid-exec/overview "droid exec"), [modèles](https://docs.factory.com/docs/models "Modèles Droid"), [MCP](https://docs.factory.com/docs/harness/mcp "MCP dans Droid"), [changelog](https://docs.factory.com/changelog/cli-updates "Changelog de la CLI Droid").

## Questions fréquentes

**Factory Droid est-il gratuit ?** Il existe une offre Free à 0 $ où vous apportez l’inférence : connectez-vous avec ChatGPT, GitHub Copilot ou OpenRouter, ou ajoutez vos propres clés API. En novembre 2026, les offres payantes sont Pro à 20 $, Plus à 100 $ et Max à 200 $ par mois, avec plus d’usage à chaque palier.

**Puis-je utiliser ma propre clé API avec Droid ?** Oui. Ajoutez une entrée customModels dans ~/.factory/settings.json avec le nom du modèle, l’URL de base, le fournisseur et la clé (elle peut être lue depuis une variable d’environnement). Les clés restent sur votre machine, et les modèles personnalisés fonctionnent dans la CLI comme dans l’application de bureau.

**Quelle différence entre droid et droid exec ?** droid ouvre une session interactive qui demande avant chaque modification ou commande. droid exec exécute une seule tâche sans chat, pour les scripts et la CI. Il reste en lecture seule tant que vous n’augmentez pas l’autonomie avec --auto low, medium ou high.

**Droid lit-il AGENTS.md ?** Oui. AGENTS.md est le fichier d’instructions que Droid lit pour un dépôt : mettez-y la stack, la commande de test, les règles et ce qu’il ne faut pas toucher.

**Comment reprendre une session Droid ?** Lancez droid --resume pour choisir une session récente, ou droid --resume <id> pour une session précise. droid search "texte" retrouve les anciennes sessions, et --fork <id> en copie une pour essayer une autre piste.

---

**À 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/