Grok Build est l’agent de code en terminal de SpaceXAI, l’éditeur de Grok (xAI). Tu lui donnes un objectif, il explore le projet, modifie les fichiers, lance les tests et peut répartir le travail entre plusieurs sous-agents. Il a un mode Plan, des permissions configurables et une compatibilité avec AGENTS.md, les skills, les hooks et les serveurs MCP. Ce guide résume la documentation officielle (Grok Build Docs) et ce qui a changé depuis l’été.
Par Louis LAURENT · Publié le 23 juillet 2026 · Mis à jour le 12 octobre 2026 : Grok 4.7, prix et accès, installation Windows, modèles personnalisés, mode Build dans le chat
En bref. Grok Build s’installe en une commande sur macOS, Linux et Windows, se lance avec grok dans ton projet et se connecte avec ton compte Grok ou une clé API. Depuis le 21 septembre 2026, il donne accès à Grok 4.7, le modèle de code le plus avancé de SpaceXAI (2 $ par million de tokens en entrée et 6 $ en sortie via l’API). Son code est open source depuis juillet et il accepte n’importe quel modèle compatible.
Ce qui a changé depuis l’été
15 juillet : SpaceXAI publie le code de Grok Build en open source : boucle d’agent, outils, interface et système d’extensions. L’agent peut tourner entièrement en local, compilé par toi et branché sur ton propre serveur d’inférence.
19 août : le nom Grok Build désigne aussi le mode Build de l’application Grok, qui crée des apps, jeux, sites et tableaux de bord dans le chat, sur web, iOS et Android, ouvert à toutes les offres. Un projet créé là s’exporte vers GitHub pour continuer dans Grok Build en terminal.
21 septembre : Grok 4.7 arrive dans Grok Build et dans Cursor. SpaceXAI le présente comme son modèle le plus capable pour le code, au même prix que Grok 4.6, avec une variante rapide deux fois plus chère.
Aujourd’hui : la documentation donne une installation Windows (PowerShell), une connexion par clé API
XAI_API_KEYpour les environnements sans navigateur, et la prise en charge de modèles personnalisés déclarés dans~/.grok/config.toml.
La documentation officielle de Grok Build reste la source à vérifier avant installation, car les commandes, permissions et intégrations évoluent vite. Ce guide distingue donc les capacités documentées des performances réelles : une liste de fonctions ne prouve ni la fiabilité sur un gros dépôt ni le coût d’une mission terminée.
Pour une équipe, l’ouverture du code change trois choses : un audit plus facile, un comportement plus observable et la possibilité de vérifier les mécanismes avant de confier un dépôt sensible à l’agent.
Grok Build, c’est quoi exactement ?
Grok Build est une interface en ligne de commande conçue pour transformer les modèles de xAI en agents capables d’agir sur un projet logiciel. Au lieu de copier du code depuis un chat, tu ouvres ton dépôt, tu décris le résultat attendu et l’agent se charge d’explorer les fichiers, de proposer un plan, d’écrire puis de vérifier.
Au lancement, la bêta était réservée aux abonnés SuperGrok et X Premium Plus. xAI le positionne sur le même terrain que Claude Code, Codex et les autres agents de terminal : des tâches longues, un contexte de projet persistant et une boucle complète entre compréhension, modification et test.
Si le concept reste flou, commence par notre guide agent IA : définition et cas concrets. La différence fondamentale avec un chatbot est là : Grok Build ne se contente pas de répondre, il utilise des outils et modifie un environnement.
Ce que la première version sait déjà faire
La documentation officielle liste une base étonnamment complète pour un produit en bêta :
Explorer un dépôt. L’agent recherche les fichiers utiles, lit les instructions et construit une compréhension du projet
Modifier et tester. Il écrit dans les fichiers, lance des commandes et vérifie le résultat dans la même session
Planifier avant d’agir. Le mode Plan sépare l’analyse de l’exécution pour te laisser corriger la direction
Déléguer à des sous-agents. Une tâche peut être divisée entre plusieurs agents travaillant en parallèle
Utiliser des instructions locales. Grok Build lit notamment les fichiers AGENTS.md pour suivre les règles du projet
Étendre ses capacités. Skills, plugins, hooks et serveurs MCP permettent d’ajouter des méthodes ou des connexions
Tourner sans interface interactive. Le mode headless permet d’intégrer l’agent dans un script ou une autre application
Sur le papier, xAI ne livre donc pas un simple assistant de complétion. L’ambition est une plateforme d’exécution. La vraie question sera la fiabilité sur des projets longs, un point qu’une bêta ne peut pas encore prouver.
Les trois modes : Plan, Auto et Always approve
Les modes déterminent ce que l’agent peut faire sans t’interrompre. Ils ne remplacent pas les règles de sandbox ou les listes d’autorisation, mais ils contrôlent la posture générale de la session.
Mode Plan
Grok Build analyse le projet et prépare une stratégie sans appliquer immédiatement les changements. C’est le bon point de départ pour une refonte, une migration ou un problème mal défini. Tu peux vérifier les fichiers visés, la séquence de travail et les risques avant de lancer l’exécution.
Le mode Plan évite une erreur classique des agents : partir très vite dans la mauvaise direction. Il est aussi utile pour transformer une demande métier en étapes techniques compréhensibles, même si tu ne codes pas toi-même.
Mode Auto
L’agent exécute de manière autonome les opérations autorisées par ta configuration. Il peut lire, écrire et lancer des commandes dans le périmètre prévu, tout en demandant une validation pour ce qui sort des règles.
C’est le mode quotidien le plus équilibré : assez autonome pour finir une correction, mais toujours limité par les permissions et la sandbox.
Always approve
Ce mode réduit fortement les interruptions. Il peut être pratique dans un environnement jetable ou un projet de test, mais il devient dangereux sur une machine contenant des secrets, plusieurs clients ou des accès de production.
Notre avis est simple : ne l’active pas par confort. Utilise-le seulement quand le dossier est isolé, les identifiants sont limités et le résultat peut être annulé. Pour comprendre la logique générale derrière ces garde-fous, lis notre article sur les limites de l’autonomie totale.
Permissions et sandbox : deux choses différentes
La documentation xAI sépare clairement les autorisations et la sandbox. Une autorisation répond à la question « cette commande est-elle permise ? ». La sandbox répond à « même permise, jusqu’où peut-elle aller ? ».
Tu peux construire des règles d’autorisation ou de refus pour des commandes précises. En parallèle, l’isolation peut limiter le système de fichiers et le réseau accessibles au processus. Les deux couches sont complémentaires :
Une règle bloque une catégorie d’action connue
La sandbox réduit les dégâts d’un comportement inattendu
La validation humaine protège les décisions difficiles à annuler
La configuration propre consiste à autoriser les lectures, les tests et les modifications locales courantes, puis à garder une validation pour les suppressions, les publications, les accès de production et les commandes utilisant des secrets.
AGENTS.md : le manuel du projet
Grok Build prend en charge AGENTS.md, un fichier d’instructions placé dans le projet. Tu peux y expliquer les conventions, les commandes de test, les zones interdites, la façon de rédiger ou les preuves attendues avant de considérer une tâche terminée.
Un bon AGENTS.md ne raconte pas toute l’histoire de l’entreprise. Il donne les règles qui changent concrètement le comportement de l’agent :
La commande exacte pour vérifier le projet
Les fichiers générés qu’il ne faut pas modifier à la main
Les actions qui demandent une validation
Le format attendu pour les nouveaux fichiers
La définition d’un travail réellement terminé
C’est une différence importante entre un agent improvisé et un système durable. Le modèle peut changer, mais les règles du projet restent dans le dépôt.
Sous-agents et travail en parallèle
Grok Build peut déléguer des parties d’une mission à plusieurs sous-agents. L’un peut analyser les tests, un autre rechercher la cause d’une erreur et un troisième préparer une modification indépendante. xAI mentionne aussi l’utilisation de worktrees Git pour isoler ces chantiers.
Le parallèle est utile quand les sous-tâches sont réellement indépendantes. Il ne rend pas automatiquement le résultat meilleur. Quatre agents qui modifient le même fichier produisent surtout quatre versions à réconcilier.
La bonne délégation respecte trois règles :
Chaque sous-agent reçoit un objectif borné et vérifiable
Les fichiers ou zones de travail se chevauchent le moins possible
Un agent principal assemble et teste le résultat final
Le gain vient du temps de recherche économisé, pas du nombre d’agents affiché à l’écran. C’est la même logique que la boucle de feedback des agents IA : observer, agir, vérifier, corriger.
Les commandes qui comptent
La documentation publiée le 21 juillet 2026 présente plusieurs commandes utiles pour piloter une session :
/tasks affiche le travail en cours et les tâches déléguées
/dashboard ouvre une vue de suivi de l’activité
/loop permet de répéter une consigne selon une cadence
/import-claude aide à récupérer une configuration existante issue de Claude
/privacy expose les réglages liés aux données
Le mode non interactif utilise l’option -p. xAI mentionne également une compatibilité ACP, pensée pour faire communiquer l’agent avec des éditeurs ou d’autres interfaces. Ce mode intéressera surtout les équipes qui veulent intégrer Grok Build dans une chaîne existante.
Plugins, skills, hooks et MCP
xAI reprend les briques devenues standard dans les environnements d’agents :
Les skills décrivent une méthode spécialisée, par exemple auditer un site ou préparer un déploiement
Les hooks déclenchent un contrôle ou une action à un moment précis de la boucle
Les plugins regroupent plusieurs capacités installables
MCP connecte l’agent à des services externes et à leurs données
Cette ouverture est un avantage pour l’adoption, mais elle élargit aussi la surface de risque. Un plugin peut contenir des consignes, un serveur MCP peut disposer d’un accès externe et un hook peut exécuter une commande automatiquement. Installe uniquement ce que tu comprends et limite chaque connexion au strict nécessaire.
Un premier workflow propre en 30 minutes
Pour tester Grok Build sans lui confier un chantier critique, utilise un petit projet ou une copie locale. Puis suis cette séquence :
Ouvre le dossier dédié. Aucun secret de production, aucune donnée client inutile
Lance une demande en mode Plan. Exemple : « analyse ce projet et propose trois améliorations de fiabilité sans modifier les fichiers »
Corrige le plan. Retire les changements trop larges et demande les preuves attendues
Passe en mode Auto avec permissions limitées. Autorise les modifications locales et les tests, pas les publications
Lis le résultat et les différences. L’agent doit expliquer ce qui a changé et montrer les tests passés
Annule ou valide. Le premier test sert à évaluer la discipline de l’agent, pas sa capacité à produire beaucoup de lignes
Une bonne première tâche est petite mais complète : corriger une erreur reproductible, ajouter un test ou améliorer une page isolée. Une mauvaise première tâche est « refais toute mon application ».
Grok Build face à Claude Code et Codex
Le positionnement est proche : les trois outils comprennent un projet, utilisent le terminal, modifient des fichiers et peuvent suivre des instructions persistantes. Grok Build se distingue au lancement par l’intégration directe à l’écosystème xAI et par une compatibilité affichée avec plusieurs conventions déjà utilisées ailleurs.
Il est trop tôt pour déclarer un vainqueur. La documentation décrit les capacités, pas leur taux de réussite. Les critères décisifs seront la qualité des modifications sur de gros dépôts, la discipline face aux permissions, le coût réel d’une tâche terminée et la stabilité des sessions longues.
Si tu compares surtout les modèles sous-jacents, notre article GPT-5.6 vs Claude vs Grok 4.5 pose les prix et les forces de chacun. Pour choisir un outil de travail, mesure plutôt le résultat complet sur trois tâches représentatives de ton quotidien.
Grok Build | Claude Code | Codex | |
|---|---|---|---|
Éditeur | SpaceXAI | Anthropic | OpenAI |
Code source | Open source | Fermé | CLI open source |
Modèles | Grok 4.7 ou tout modèle compatible déclaré | Modèles Claude | Modèles OpenAI |
Accès | Compte Grok ou clé API xAI | Abonnement Claude ou clé API | Abonnement ChatGPT ou clé API |
Pour le duel entre les deux agents les plus utilisés, lis notre comparatif Codex vs Claude Code. Et si tu veux voir où se placent ces agents de code parmi tous les agents IA, notre classement des meilleurs agents IA en 2026 fait le tour.
Les limites à garder en tête
Le produit bouge vite. Les comportements, les limites et l’accès peuvent changer d’une version à l’autre
Les limites d’usage ne sont pas chiffrées. SpaceXAI ne publie pas de quota précis par offre : mesure ta consommation sur une vraie tâche avant de t’engager
Les sous-agents ne garantissent pas la cohérence. Le travail parallèle exige une vraie phase d’intégration
La compatibilité n’est pas la qualité. Prendre en charge AGENTS.md ou MCP ne prouve pas que chaque tâche sera bien exécutée
La supervision reste obligatoire. Un agent de code peut introduire une régression parfaitement plausible
FAQ
Combien coûte Grok Build ?
Grok Build fait partie des offres Grok. Selon la grille de SpaceXAI, SuperGrok coûte 30 $ par mois et SuperGrok Plus 100 $ par mois, avec un usage « nettement plus élevé » sur Build. Tu peux aussi le brancher sur une clé API et payer au token : 2 $ par million de tokens en entrée et 6 $ en sortie pour Grok 4.7. Les comparateurs qui ont relu la grille fin septembre y voient Grok Build jusque dans l’offre gratuite, avec des limites non publiées.
Grok Build marche-t-il sous Windows ?
Oui. La documentation donne une commande PowerShell en plus de la commande curl pour macOS, Linux et WSL.
Faut-il savoir coder pour l’utiliser ?
Pas pour donner un objectif ou lire un plan, mais il faut savoir vérifier le résultat. Si tu ne codes pas, commence sur une copie, exige des tests et garde une validation humaine avant toute publication.
Quelle différence entre le mode Plan et le mode Auto ?
Le mode Plan analyse et structure le travail avant modification. Le mode Auto exécute les actions autorisées par ta configuration. Le premier sert à cadrer, le second à produire.
Grok Build peut-il utiliser mes instructions Claude Code ?
xAI documente une commande d’import Claude et prend en charge des conventions comme AGENTS.md. Vérifie néanmoins les permissions et les chemins après import : deux agents peuvent interpréter une règle différemment.
Commande d’installation officielle
La documentation donne la commande suivante pour macOS, Linux et WSL : curl -fsSL https://x.ai/cli/install.sh | bash. Sous Windows, en PowerShell : irm https://x.ai/cli/install.ps1 | iex. Lis le script avant de l’exécuter sur une machine sensible. Lance ensuite grok dans ton projet : au premier lancement, une page de connexion s’ouvre dans le navigateur. Sans navigateur, définis la variable XAI_API_KEY. Pour vérifier ce que l’agent a chargé (configuration, instructions, skills, plugins, hooks, serveurs MCP), utilise grok inspect. Voir la documentation Grok Build.
Avant de partir
Grok Build confirme une tendance plus importante que le produit lui-même : l’agent de terminal devient une interface de travail standard. Le gagnant ne sera pas celui qui écrit le plus vite, mais celui qui termine une mission avec le moins de reprises et les meilleures preuves.
Recevoir Kryve Weekly et le guide de démarrage
Un email pour te l’envoyer. Pas de spam, désinscription en un clic.
