Louis LAURENT
Grok Build Docs désigne la documentation de Grok Coding, l’agent de code en terminal de 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. Ce coding agent arrive en bêta avec un mode Plan, des permissions configurables et une compatibilité avec AGENTS.md, les skills, les hooks et les serveurs MCP. Voici comment il fonctionne vraiment.
Mise à jour vérifiée au 7 août 2026
Depuis son lancement, Grok Build a franchi une étape importante : xAI a publié l’agent en open source. Le produit reste un agent de terminal connecté aux modèles xAI, mais son architecture, son interface TUI et sa couche d’outils peuvent désormais être inspectées directement.
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.
L’angle utile n’est plus « xAI lance encore un agent ». C’est de comprendre ce que l’ouverture du code change pour une équipe : audit plus facile, comportement plus observable et possibilité de vérifier les mécanismes avant de lui confier un dépôt sensible.
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.
Le produit est lancé en bêta pour les 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.
Les limites à garder en tête
Le produit est en bêta. Les comportements, les limites et l’accès peuvent changer rapidement
L’accès reste lié aux offres xAI. SuperGrok et X Premium Plus sont les portes d’entrée annoncées au lancement
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
Grok Build est-il disponible gratuitement ?
La bêta annoncée par xAI vise les abonnés SuperGrok et X Premium Plus. Les conditions d’accès peuvent évoluer pendant le déploiement.
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.
Les réglages à vérifier avant un usage avancé
Avant d’intégrer Grok Coding dans un flux avancé, vérifie la documentation active pour le headless mode, le choix d’un custom model, la compatibilité macOS ou Linux, la context window et la base URL. Contrôle aussi la version de Grok, les sources de configuration, les plugins, hooks et MCP servers, ainsi que l’intégration CI/CD ou Agent Client Protocol. Ces options évoluent : valide chaque commande dans les docs xAI avant de l’exécuter.
Glossaire des contrôles de Grok Build
Dans les journaux xAI Grok, vérifie notamment grok version, les shell commands, l’agent loop et le réglage models default. Les options grok inspect, run grok et les plugins, hooks and MCP servers doivent être testés sur un projet isolé avant d’entrer dans un flux de production.
Commande d’installation officielle
La documentation xAI donne la commande suivante pour macOS, Linux et WSL : curl -fsSL https://x.ai/cli/install.sh | bash. Lis le script ou préfère l’installation npm officielle avant de l’exécuter sur une machine sensible. 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.
Continuer avec
Pars d’une vraie tâche de ton poste. Kryve t’aide à la cadrer, la confier à l’IA et contrôler le résultat.
