Grok CLI

Grok CLI est un outil en ligne de commande qui utilise l'interface compatible OpenAI et accepte directement une adresse API personnalisée comme service back-end.

PrérequisCopier le lien d’ancre

Installez d'abord Node.js 18 ou supérieur et npm.

L'installation depuis la page officielle de téléchargement de Node.js est recommandée : https://nodejs.org/en/download

• macOS/Windows : téléchargez et installez la version LTS
• Linux : installez selon la méthode propre à votre distribution

Sous macOS, vous pouvez aussi utiliser Homebrew :

brew install node

Une fois l'installation terminée, vérifiez :

node -v
npm -v

Installation de Grok CLICopier le lien d’ancre

Installation globale via npm :

npm install -g @vibe-kit/grok-cli

Une fois l'installation terminée, vérifiez :

grok --version

Configuration de la connexionCopier le lien d’ancre

Grok CLI propose trois méthodes de configuration, par ordre de priorité : arguments de ligne de commande > variables d'environnement > fichier de configuration.

Méthode 1 : variables d'environnement (recommandé)Copier le lien d’ancre

Définissez les variables d'environnement suivantes :

export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"

Pour un test ponctuel, un simple export dans le shell courant suffit. Pour un effet permanent, ajoutez ces lignes à ~/.zshrc ou ~/.bashrc, puis exécutez source ~/.zshrc pour les appliquer.

Méthode 2 : fichier de configurationCopier le lien d’ancre

Éditez ~/.grok/user-settings.json :

{
  "apiKey": "your_api_key_here",
  "baseURL": "https://aicentos.com/v1",
  "defaultModel": "gpt-4o"
}

Méthode 3 : arguments de ligne de commandeCopier le lien d’ancre

Précisez au lancement via un argument :

grok --base-url https://aicentos.com/v1

Démarrage et utilisationCopier le lien d’ancre

Une fois la configuration terminée, lancez simplement :

grok

Engagez une conversation dans Grok CLI ; si vous recevez une réponse normalement, la connexion fonctionne.

Vérification et dépannageCopier le lien d’ancre

En cas d'erreur d'authentification, vérifiez :

• que GROK_API_KEY est correcte
• que GROK_BASE_URL / baseURL pointe vers la bonne adresse de service (le suffixe /v1 est requis)

Une fois la configuration corrigée, relancez simplement.

RemarquesCopier le lien d’ancre

• Grok CLI utilise l'interface compatible OpenAI ; la configuration est simple et directe
• Les trois méthodes de configuration se choisissent librement ; les variables d'environnement sont recommandées
• L'adresse API doit inclure le suffixe /v1
• Le modèle par défaut est personnalisable

Liens utilesCopier le lien d’ancre

• Documentation officielle : https://docs.aicentos.com/clients/grok-cli.html