Tutoriel Grok CLI

Grok CLI est l'agent de programmation en ligne de commande de xAI. Ce guide explique comment installer la CLI officielle, configurer ApiPass comme endpoint de modèle et commencer à utiliser Grok 4.5 depuis votre terminal.

Avant de commencer

Assurez-vous de disposer des éléments suivants :

Une clé API ApiPass obtenue depuis la page Clés API
Un solde ApiPass suffisant pour les requêtes Grok Build
Un terminal compatible avec Bash sous macOS, Linux ou Windows WSL2

Les commandes d'installation et de configuration ci-dessous fonctionnent dans les shells macOS, Linux et WSL2. Sous Windows, exécutez-les dans WSL2 plutôt que dans PowerShell natif.

Étape 1 : installer Grok CLI

Installez la CLI Grok officielle :

1curl -fsSL https://x.ai/cli/install.sh | bash

Une fois l'installation terminée, ouvrez un nouveau terminal pour que votre PATH mis à jour soit chargé.

Étape 2 : configurer ApiPass

Grok CLI lit sa configuration utilisateur depuis ~/.grok/config.toml.

Créez le répertoire de configuration :

1mkdir -p ~/.grok

Créez ou remplacez ~/.grok/config.toml avec la configuration suivante :

1[cli]
2installer = "internal"
3
4[models]
5default = "grok-4.5"
6web_search = "grok-4.5"
7
8[endpoints]
9models_base_url = "https://api.apipass.dev/grok-build/v1"
10
11[model."grok-4.5"]
12model = "grok-4.5"
13name = "Grok 4.5"
14description = "Grok 4.5 ApiPass"
15api_key = "api-key"
16api_backend = "responses"
17context_window = 1000000

Remplacez api-key par la clé API copiée depuis la page Clés API d'ApiPass. Conservez les guillemets autour de la clé.

Vous pouvez également créer le fichier directement depuis votre terminal :

1cat > ~/.grok/config.toml << 'EOF'
2[cli]
3installer = "internal"
4
5[models]
6default = "grok-4.5"
7web_search = "grok-4.5"
8
9[endpoints]
10models_base_url = "https://api.apipass.dev/grok-build/v1"
11
12[model."grok-4.5"]
13model = "grok-4.5"
14name = "Grok 4.5"
15description = "Grok 4.5 ApiPass"
16api_key = "api-key"
17api_backend = "responses"
18context_window = 1000000
19EOF

Si vous utilisez cette commande, modifiez ensuite le fichier et remplacez api-key par votre véritable clé API ApiPass :

1nano ~/.grok/config.toml

Ce fichier contenant votre clé API, limitez ses autorisations d'accès :

1chmod 600 ~/.grok/config.toml

Référence de configuration

[cli] maintient les mises à jour de la CLI sur le canal d'installation interne.
[models] sélectionne grok-4.5 pour les prompts ordinaires et les requêtes de recherche web.
[endpoints] achemine la découverte des modèles et les requêtes de l'API Responses via ApiPass.
[model."grok-4.5"] enregistre le modèle statique Grok 4.5 et stocke la clé API ApiPass utilisée pour authentifier les requêtes.
api_backend = "responses" demande à la CLI d'utiliser le protocole de l'API Responses pris en charge par l'endpoint Grok Build d'ApiPass.
context_window = 1000000 déclare la fenêtre de contexte d'un million de tokens du modèle.

Utilisez l'URL de base exactement telle qu'elle est indiquée :

1https://api.apipass.dev/grok-build/v1

N'ajoutez pas /responses à models_base_url. Grok CLI ajoute automatiquement les chemins du modèle et de l'API Responses.

Étape 3 : vérifier la configuration

Examinez la configuration active de Grok CLI :

1grok inspect

Vérifiez que grok-4.5 est disponible et que l'endpoint configuré est https://api.apipass.dev/grok-build/v1.

Envoyez un prompt ponctuel pour vérifier la connexion de bout en bout :

1grok -p "Réponds exactement : ApiPass connecté" -m grok-4.5

Étape 4 : commencer à utiliser Grok

Ouvrez une session Grok interactive dans votre projet actuel :

1grok

Vous pouvez également exécuter un seul prompt depuis la ligne de commande :

1grok -p "Analyse ce dépôt et suggère l'amélioration qui aurait le plus d'impact." -m grok-4.5

Grâce au paramètre de modèle default, les sessions interactives utilisent Grok 4.5 sans qu'il soit nécessaire de fournir -m à chaque fois.

Coût et utilisation

ApiPass déduit des crédits lorsque Grok CLI envoie des requêtes via l'endpoint Grok Build. Le montant exact dépend du nombre de tokens utilisés et des tarifs ApiPass en vigueur.

Consultez les pages suivantes pour examiner votre compte et l'activité de vos requêtes :

Tarifs pour les tarifs actuels des modèles
Journaux API pour consulter chaque requête et les crédits déduits
Utilisation de l'API pour consulter l'utilisation globale et les tendances
Clés API pour gérer la clé enregistrée dans votre configuration Grok

Résolution des problèmes

`grok: command not found`

Fermez et rouvrez votre terminal après avoir exécuté le programme d'installation. Si la commande reste indisponible, suivez les instructions du programme d'installation concernant le PATH, puis ouvrez une autre session de terminal.

La configuration n'est pas chargée

Vérifiez que le fichier existe dans le compte utilisateur et l'environnement depuis lesquels vous exécutez Grok CLI :

1ls -l ~/.grok/config.toml

Si vous utilisez WSL2, la configuration doit se trouver dans le répertoire personnel WSL. Un fichier créé dans le profil utilisateur Windows natif ne sera pas chargé par la CLI exécutée dans WSL2.

Échec de l'authentification

Ouvrez ~/.grok/config.toml et vérifiez que api_key contient une clé API ApiPass active, et non la valeur d'exemple :

1api_key = "YOUR_APIPASS_API_KEY"

Créez ou gérez vos clés sur la page Clés API d'ApiPass.

Erreur 404 Not Found ou endpoint incorrect

Vérifiez que models_base_url contient /grok-build/v1 et ne contient pas /responses :

1models_base_url = "https://api.apipass.dev/grok-build/v1"

L'endpoint de la CLI Grok Build est distinct de l'endpoint général de l'API Grok. Utilisez donc l'URL ci-dessus pour cette configuration.

`model refresh failed`

Certaines versions de Grok CLI peuvent afficher l'avertissement non bloquant model refresh failed lorsqu'un models_base_url personnalisé est configuré. L'entrée statique [model."grok-4.5"] permet tout de même aux requêtes Grok 4.5 de fonctionner.

Exécutez le prompt de vérification ponctuel pour confirmer la connexion :

1grok -p "Réponds exactement : ok" -m grok-4.5

Modèle indisponible

Utilisez l'identifiant de modèle exact grok-4.5 aux trois emplacements de configuration :

1default = "grok-4.5"
2web_search = "grok-4.5"
3[model."grok-4.5"]

Cookie Preferences

Tutoriel Grok CLI