# Fx

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

Language: fr

> Utiliser aicentos dans Fx : ajouter une connexion de modèle personnalisée dans le settings.json utilisateur

Fx est l'agent de codage de Vercel Labs, compilé en un unique binaire natif écrit en Zig, indépendant des modèles. Les connexions de modèles personnalisées se définissent dans le fichier utilisateur `~/.fx/settings.json`, en pointant la base URL vers aicentos.

**Un piège à connaître d'emblée :** le `.fx.json` à la racine du projet est une autre affaire. Il interdit délibérément la plupart des champs (modèle compris), afin d'empêcher un dépôt cloné de remplacer votre modèle ou votre point d'accès. **Une connexion de point d'accès personnalisé doit impérativement s'écrire dans `~/.fx/settings.json`** ; dans `.fx.json`, elle n'aurait aucun effet.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Fx (nommez-la par exemple `fx`, 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)

Vérifiez que Fx est installé :

```bash
curl -fsSL https://fx.sh/setup.sh | bash
fx --version
```

## Configuration à renseigner

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

## Étapes de configuration

### 1. Éditer les réglages utilisateur

Dans `~/.fx/settings.json`, enregistrez une connexion au format « connexion de modèle personnalisée ». La structure des champs de l'objet de connexion fait foi dans la documentation officielle :

* Entrée de la documentation : [https://fx.sh/docs](https://fx.sh/docs)
* README : [https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)

Renseignez l'adresse API de la connexion ainsi :

```
https://aicentos.com/v1
```

Pour l'API Key, utilisez la clé créée dans la console ; pour les noms de modèles, référez-vous à la « place de marché des modèles » de la console.

### 2. Désigner cette connexion

Fx permet de préciser provider et modèle au lancement :

```bash
fx provider local FX_MODEL=gpt-4o fx ask "Réponds en une phrase : combien font 1+1 ?"
```

Ou via une variable d'environnement :

```bash
export FX_MODEL="gpt-4o"
```

### 3. Vérifier le provider actuel

Fx mémorise le choix par provider : au prochain démarrage, il reprend le provider précédent.

## Test

Commencez par vérifier la connectivité avec un prompt sans effet de bord :

```bash
fx ask "Réponds en une phrase : combien font 1+1 ?"
```

Une réponse normale signifie que la connexion fonctionne. En cas d'erreur d'authentification, vérifiez d'abord que la base URL contient bien `/v1` et que l'API Key ne comporte pas d'espace parasite.

## Remarques

* **Ne modifiez pas `.fx.json`**. Le fichier de projet n'accepte que quelques champs comme `provider_order` ou `provider_strict`, sans champ `model`, et ne sert pas à configurer un point d'accès personnalisé.
* `provider_order` / `provider_strict` sont des paramètres de routage du Vercel AI Gateway : **ils ne s'appliquent qu'aux requêtes vers le Gateway et sont ignorés par les connexions de modèles personnalisées** ; ne comptez pas sur eux pour changer d'amont.
* La prise en charge officielle des connexions de modèles personnalisées évolue encore ; sur les premières versions, une build récente peut être nécessaire pour la reconnaissance. Après une mise à jour, relancez d'abord la commande de test ci-dessus avant un usage sérieux.
* Le script d'installation du binaire télécharge depuis le réseau ; vérifiez vous-même la fiabilité de la source avant de l'exécuter.

## Liens utiles

* Page du projet : [https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)