Amp
Utiliser aicentos dans Amp : remplacer l'adresse du back-end via le fichier de configuration
Dernière mise à jour:
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
- Créer une clé : https://aicentos.com/keys
- Recharger en cas de solde insuffisant : 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 :
mkdir -p ~/.config/amp ~/.local/share/amp{
"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> :
{
"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 :
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é :
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.urldoit 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) et une interface compatible OpenAI (voir 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.jsondu 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