# Amp

Source: https://docs.aicentos.com/fr/clients/amp

Language: fr

> Utiliser aicentos dans Amp : remplacer l'adresse du back-end via le fichier de configuration

Amp est l'agent de codage de Sourcegraph ; la CLI et l'extension IDE partagent le même compte et les mêmes réglages. Il n'expose pas de champ habituel « Base URL compatible OpenAI » : c'est la clé de configuration `amp.url` qui pointe le back-end entier vers un point d'accès personnalisé, les identifiants étant stockés à part dans un fichier de secrets.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Amp (nommez-la par exemple `amp-cli`, pour suivre plus facilement sa consommation) :

* Console : [https://aicentos.com](https://aicentos.com)
* Créer une clé : [https://aicentos.com/keys](https://aicentos.com/keys)
* Recharger en cas de solde insuffisant : [https://aicentos.com/wallet](https://aicentos.com/wallet)

## Configuration à renseigner

| Champ    | Valeur                                                              |
| -------- | ------------------------------------------------------------------- |
| API Key  | La clé créée dans la console                                        |
| Base URL | `https://aicentos.com/v1`                                           |
| Modèle   | nom du modèle dans la « place de marché des modèles » de la console |

## Étapes de configuration

Les réglages d'Amp portent tous le préfixe `amp.` ; le fichier de configuration utilisateur se trouve à :

* macOS / Linux : `~/.config/amp/settings.json`
* Windows : `%USERPROFILE%\.config\amp\settings.json`

Créez d'abord les répertoires, puis écrivez l'adresse du back-end :

```bash
mkdir -p ~/.config/amp ~/.local/share/amp
```

```json
{
  "amp.url": "https://aicentos.com/v1"
}
```

L'API Key ne s'écrit pas dans ce fichier, mais dans un fichier de secrets distinct, sous la clé `apiKey@<votre-URL>` :

```json
{
  "apiKey@https://aicentos.com/v1": "sk-votre-clé-API"
}
```

Une fois la configuration en place, `amp login` n'a plus besoin d'être exécuté : les requêtes passent directement par le point d'accès que vous avez indiqué. Si vous vous étiez déjà connecté, il est conseillé de faire un `amp logout` puis de redémarrer `amp`, pour éviter qu'un état de connexion résiduel ne prenne le pas sur la configuration.

Vous pouvez aussi passer temporairement par des variables d'environnement, pratique pour une première vérification ponctuelle :

```bash
export AMP_URL="https://aicentos.com/v1"
export AMP_API_KEY="sk-votre-clé-API"
```

**Remarque :** dès que ces deux variables sont définies, Amp passe la procédure de connexion et elles priment sur le fichier de configuration.

## Test

Commencez par une requête légère pour vérifier que le point d'accès a bien basculé :

```bash
amp -x "Réponds en une phrase : combien font 1+1 ?"
```

Une réponse normale confirme que la configuration est active. En cas de 401, la clé du fichier de secrets ne correspond sans doute pas exactement à `amp.url` (y compris la présence ou non du `/v1` final).

## Remarques

* Le protocole du back-end d'Amp est sa propre interface de gestion, pas un protocole générique compatible OpenAI : `amp.url` doit donc pointer vers un point d'accès qui propose aussi une interface de style Anthropic Messages (`/v1/messages`).
* aicentos propose une interface au format Claude natif (voir [Format Claude natif](https://docs.aicentos.com/fr/api/chat/claude)) et une interface compatible OpenAI (voir [Chat Completions](https://docs.aicentos.com/fr/api/chat/openai/chat-completions)) ; Amp passe par la première.
* Amp demande des identifiants de modèles fixes ; si le point d'accès n'a pas de modèle du même nom, une replanification ou une erreur survient. Le cas échéant, vérifiez les noms des modèles dans la « place de marché des modèles » de la console.
* Les réglages de l'extension IDE (VS Code / Cursor / Windsurf) se gèrent séparément de la CLI : l'Amp URL et l'Amp API Key y sont à renseigner indépendamment.
* Le `.amp/settings.json` du répertoire de travail prend le pas sur les réglages utilisateur ; en cas de dépannage, vérifiez d'abord qu'aucun fichier de même nom n'existe dans le répertoire courant.

## Liens utiles

* Documentation officielle des réglages : [https://ampcode.com/docs/cli/settings](https://ampcode.com/docs/cli/settings)