# Grok CLI

Source: https://docs.aicentos.com/fr/clients/grok-cli

Language: fr

> Utiliser aicentos dans Grok CLI : connexion via des variables d'environnement ou un fichier de configuration

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érequis

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](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 :

```bash
brew install node
```

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

```bash
node -v
npm -v
```

## Installation de Grok CLI

Installation globale via npm :

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

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

```bash
grok --version
```

## Configuration de la connexion

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é)

Définissez les variables d'environnement suivantes :

```bash
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 configuration

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

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

### Méthode 3 : arguments de ligne de commande

Précisez au lancement via un argument :

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

## Démarrage et utilisation

Une fois la configuration terminée, lancez simplement :

```bash
grok
```

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

## Vérification et dépannage

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.

## Remarques

* 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 utiles

* Documentation officielle : [https://docs.aicentos.com/clients/grok-cli.html](https://docs.aicentos.com/clients/grok-cli.html)