Installer Grok Build sur macOS, Linux ou Windows en deux minutes

Avant d’installer

Grok Build est une application en terminal de SpaceXSI (anciennement xAI). Des binaires précompilés existent pour macOS, Linux et Windows. Il vous faut :

• Un terminal : Terminal ou iTerm sur macOS, n’importe quel shell sous Linux, PowerShell ou Git Bash sous Windows.
• Un navigateur web pour la première connexion, ou une clé API si vous l’installez sur un serveur.
• Un compte. Grok Build est gratuit à l’essai, et la formule Plus de The X Subscription ($8 par mois) ainsi que les niveaux supérieurs offrent davantage d’utilisation.

Commandes d’installation

1. macOS, Linux ou Git Bash : exécutez curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell : exécutez irm https://x.ai/cli/install.ps1 | iex
3. Vérifiez que ça a fonctionné : exécutez grok --version. Si un numéro de version s’affiche, l’installation a réussi.

Les deux commandes proviennent de la page officielle de Grok Build et du dépôt GitHub. L’installateur place le programme dans ~/.grok/bin, selon un guide d’installation tiers.

Les développeurs peuvent aussi compiler depuis les sources. Cela nécessite une toolchain Rust (installée et figée via rustup), DotSlash (cargo install dotslash) et protoc. macOS et Linux sont les hôtes de compilation pris en charge. Les compilations Windows sont fournies « au mieux » : les utilisateurs Windows devraient donc utiliser le binaire précompilé.

Premier lancement et connexion

1. Ouvrez un terminal dans le dossier de votre projet, pas dans votre dossier personnel.
2. Exécutez grok.
3. Une fenêtre de navigateur s’ouvre pour vous connecter, généralement sur grok.com.
4. Après la connexion, l’interface en terminal démarre. Les identifiants sont enregistrés dans ~/.grok/auth.json.

Pourquoi le dossier du projet compte : en juillet 2026, lancer Grok Build pouvait envoyer tout le répertoire courant vers le stockage cloud de l’entreprise. SpaceXSI a désactivé ce comportement le jour même et affirme que Build peut désormais fonctionner entièrement en local. Démarrer dans le dossier du projet reste l’habitude la plus sûre, car l’agent peut lire et modifier les fichiers là où il s’exécute.

Par défaut, Grok Build utilise le plan mode : il propose un plan et ne fait aucune modification tant que vous ne l’avez pas approuvé.

Mettre à jour et vérifier votre installation

• grok update met Grok Build à jour vers la dernière version.
• grok doctor vérifie la configuration de votre terminal et signale les problèmes.
• grok --version affiche la version installée.

Mettez à jour souvent. SpaceXSI livre des fonctions rapidement, et les nouveaux modèles comme Grok 4.7 arrivent dans Grok Build le jour de leur sortie.

Utiliser une clé API en CI

La connexion par navigateur ne fonctionne pas sur les serveurs de build. Pour la CI, définissez plutôt la variable d’environnement XAI_API_KEY, et utilisez le mode headless pour les scripts et les pipelines.

1. Créez un compte sur console.x.ai.
2. Chargez des crédits. L’API est prépayée, et les requêtes sont refusées quand les crédits sont épuisés.
3. Générez une clé sur la page API Keys.
4. Enregistrez-la comme secret dans votre système de CI et exposez-la sous le nom XAI_API_KEY.

L’utilisation via une clé API est facturée aux tarifs de l’API, et non prélevée sur la réserve de votre abonnement. Le modèle grok-build-0.1 coûte $1 par million de tokens en entrée et $2 par million de tokens en sortie.

Fichier de configuration et permissions

Grok Build conserve ses réglages dans ~/.grok/config.toml. C’est là que se configurent les serveurs MCP, pour se connecter à des outils comme Linear, Sentry ou Postgres.

Les conventions propres à chaque projet se placent dans un fichier AGENTS.md dans chaque répertoire. Un guide tiers cite ces modes de permission : default, acceptEdits, auto, dontAsk, bypassPermissions et plan. Parmi les options utiles : --worktree, --no-plan et --no-subagents. Évitez bypassPermissions sauf si vous faites tourner Build dans un sandbox.

Problèmes courants

• « grok: command not found » : ouvrez un nouveau terminal pour que votre shell recharge son path, et vérifiez que ~/.grok/bin figure dans votre PATH.
• L’affichage semble cassé : exécutez grok doctor pour vérifier la prise en charge du terminal.
• La fenêtre de connexion ne s’ouvre pas : sur une machine distante, utilisez plutôt XAI_API_KEY.
• Clé API refusée : vérifiez que votre compte console dispose de crédits.
• Grok 4.7 Fast absent : Fast ne fait pas partie de la formule gratuite.
• Utilisation épuisée : les formules payantes partagent une seule réserve hebdomadaire avec le chat Grok et Cursor. Une utilisation intensive à un endroit en laisse moins pour les autres.

Questions fréquentes