# Grok Build

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

Language: fr

> Connecter aicentos à Grok Build : model provider personnalisé via config.toml

Grok Build est l'agent de programmation en terminal de xAI ; il appelle par défaut l'interface officielle xAI, mais il permet de déclarer dans `~/.grok/config.toml` n'importe quel point de terminaison compatible OpenAI sous la forme `[model.*]`. Pointez le point de terminaison vers aicentos pour appeler, avec la même clé, les modèles de la famille grok comme ceux des autres fournisseurs.

## Prérequis

* Installez Grok Build (script officiel) :

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

* Créez une clé dédiée dans la console aicentos (nommez-la par exemple `grok-build`).

## Configuration à renseigner

| Champ           | Valeur                                                                                                    |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| base\_url       | `https://aicentos.com/v1`                                                                                 |
| api\_backend    | `chat_completions` (valeur par défaut)                                                                    |
| env\_key        | `AICENTOS_API_KEY`                                                                                        |
| model           | ID du modèle dans la « place de marché des modèles » de la console, par ex. `grok-4.7`, `claude-opus-4-8` |
| context\_window | selon le modèle choisi, par ex. `200000`                                                                  |

## Étapes de configuration

* Écrivez la clé dans les variables d'environnement du shell (dans `~/.zshrc` ou `~/.bashrc`, puis `source` pour l'appliquer) :

  ```bash
  export AICENTOS_API_KEY="your_api_key_here"
  ```

* Éditez `~/.grok/config.toml` en ajoutant un modèle personnalisé :

  ```toml
  [models]
  default = "aicentos-grok"

  [model.aicentos-grok]
  base_url          = "https://aicentos.com/v1"
  env_key           = "AICENTOS_API_KEY"
  api_backend       = "chat_completions"
  context_window    = 200000
  max_completion_tokens = 8192
  description       = "aicentos gateway - grok-4.7"
  ```

  Le `<name>` de `[model.<name>]` est l'ID du modèle ; pour intégrer plusieurs modèles, par exemple `grok-4.7` et `claude-opus-4-8`, ajoutez respectivement un bloc `[model.grok-4.7]` et `[model.claude-opus-4-8]`.

* Lancez Grok Build, puis basculez avec le sélecteur de modèles ou en commande :

  ```bash
  grok
  /model aicentos-grok
  ```

## Test

Vérifiez d'abord que les modèles sont reconnus :

```bash
grok models
```

Envoyez ensuite une invite légère (par ex. `grok -p "présente le répertoire courant en une phrase" -m aicentos-grok`) pour vérifier que la réponse arrive normalement.

## Remarques

* Grok Build n'a **pas de paramètre de ligne de commande `--base-url`** ; le point de terminaison personnalisé ne peut être précisé que par le fichier de configuration ou les variables d'environnement.
* `api_backend` vaut `chat_completions` par défaut ; si vous écrivez explicitement `responses` ou `messages`, vérifiez que la passerelle prend en charge le point de terminaison correspondant, sinon l'appel échouera.
* L'ordre de résolution des identifiants est : `api_key` dans la configuration du modèle → variable d'environnement désignée par `env_key` → token de la session connectée → `XAI_API_KEY` global. Ici, utilisez `env_key` avec votre propre nom de variable, sans risque de mélange avec le compte officiel xAI.
* Si un nouveau modèle omet `context_window`, Grok Build applique par défaut 200 000 ; il est conseillé de le renseigner explicitement selon le modèle choisi.
* Une fois le point de terminaison personnalisé en place, l'abonnement xAI n'est plus nécessaire, mais le modèle sélectionné reste facturé côté aicentos ; vérifiez d'abord le solde sur la [page du portefeuille](https://aicentos.com/wallet).