# Antigravity CLI

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

Language: fr

> Utiliser aicentos dans Antigravity CLI : connexion via le mode clé API

Antigravity CLI est l'outil en ligne de commande de Google. Il prend en charge, via le mode clé API, la connexion à des services compatibles avec l'API Gemini. Ce document explique comment configurer Antigravity CLI pour utiliser un point d'accès API personnalisé.

## Installation

Choisissez la méthode d'installation selon votre système d'exploitation :

### macOS / Linux

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

### Windows (PowerShell)

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
```

### Windows (CMD)

```cmd
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

### Vérification de l'installation

```bash
agy --version
```

## Configuration

### Activer le mode clé API

Éditez `~/.gemini/antigravity-cli/settings.json` et ajoutez au JSON existant :

```json
{
  "modelProvider": "gemini"
}
```

⚠️ **Attention** : définir uniquement `GEMINI_API_KEY` ne change pas le mode d'authentification. `modelProvider` doit impérativement valoir `"gemini"` en minuscules.

### Définir les variables d'environnement

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
```

**Points importants :**

* `GOOGLE_GEMINI_BASE_URL` reçoit l'adresse racine du service, sans chemin d'interface spécifique. Le point d'accès doit être compatible avec l'API Gemini.
* `GEMINI_API_KEY` reçoit votre clé API.
* Exécutez ces commandes dans le même shell que celui qui lance `agy`. La CLI ne lit ni `.env` ni `GOOGLE_API_KEY`.

Pour un effet permanent, écrivez les deux `export` dans `~/.zshrc` ou `~/.bashrc`.

## Démarrage et vérification

```bash
agy --model gemini-2.0-flash
```

Une fois `Gemini API key` affiché en haut, engagez une conversation.

### Dépannage des problèmes courants

* **La connexion est toujours demandée** : vérifiez `"modelProvider": "gemini"`, puis quittez et relancez `agy`.
* **Clé manquante au démarrage** : redéfinissez `GEMINI_API_KEY` dans le shell courant.
* **Échec des requêtes** : vérifiez la clé API, l'adresse racine du service et les droits d'accès au modèle choisi.

## Remarques

* La clé de configuration `modelProvider` et les variables d'environnement doivent être définies ensemble pour que le mode clé API fonctionne
* Les variables d'environnement doivent être définies dans la session de shell qui lance la CLI, ou écrites dans le fichier de configuration du shell pour un effet permanent
* Le point d'accès du service doit être conforme aux spécifications de l'API Gemini

## Liens utiles

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