Instantané de la documentation · CLI 7.30.1 · SDK 2.6.53. Desktop utilise le runtime fourni avec sa propre version. Les commandes et exemples restent identiques à la source anglaise. Source anglaise

Connecter votre premier fournisseur de modèles

Choisir une connexion

Le fournisseur assure la connexion au service ; le modèle désigne le modèle précis choisi via cette connexion. Connecter un fournisseur ne sélectionne pas tous ses modèles et ne donne pas de droits sur un compte.

Dans l’interface terminal, saisissez /connect, puis choisissez une option ci-dessous. Desktop possède ses propres réglages et son moteur intégré ; ces commandes à barre oblique concernent le terminal.

API cloud : choisissez API Cloud Provider, sélectionnez le service et suivez les étapes d’authentification. Un abonnement de chat n’inclut pas nécessairement l’accès à l’API ni des crédits API.
CLI de programmation : installez un CLI pris en charge et connectez-vous d’abord, puis choisissez CLI Provider. AX Code réutilise cette connexion locale ; les capacités dépendent de l’adaptateur.
Modèle local : démarrez Ollama ou LM Studio et chargez un modèle capable d’appeler des outils, puis choisissez Local LLM runtime et confirmez l’adresse. AX-Engine runtime propose son propre parcours de configuration et de téléchargement sur les Mac compatibles.
Passerelle : choisissez AX Trust pour son service, API Cloud Provider → Custom API provider pour une autre passerelle, ou Private GPU cloud pour un déploiement compatible dédié. Indiquez l’URL, le jeton et les identifiants exacts annoncés par le service.

Vérifier la connexion

Exécutez ces commandes dans un terminal interactif. La connexion demande le fournisseur et les identifiants ; ne collez pas de vraie clé dans une commande partagée ou un fichier du dépôt.

ax-code providers login
ax-code providers list
ax-code models

Le fournisseur et les identifiants de modèles utilisables devraient apparaître. L’enregistrement d’une clé ou l’obtention de la liste ne prouve pas le droit d’inférence. Poursuivez avec la sélection du modèle et envoyez une petite requête de test.

Gérer les identifiants et la configuration

Utilisez /providers pour gérer les connexions et /connect pour remplacer une clé. Désactiver conserve les identifiants enregistrés ; déconnecter les supprime. Des variables d’environnement ou des clés configurées peuvent encore fournir l’accès.

Utilisez le fichier de projet ax-code.json pour les paramètres partagés non secrets, ou le fichier global ~/.config/ax-code/ax-code.json pour vos préférences. Gardez les secrets hors du contrôle de version ; utilisez la saisie d’identifiants ou les références d’environnement du guide des passerelles. Redémarrez après une modification manuelle.

En cas d’échec

Échec d’authentification : vérifiez que la clé correspond au service, à l’adresse et à l’offre API choisis. Pour un CLI, vérifiez d’abord sa propre connexion.
Liste vide ou connexion refusée : vérifiez que le serveur local fonctionne, qu’un modèle est chargé et que l’URL et le port sont corrects. Ollama utilise généralement http://localhost:11434/v1, LM Studio http://localhost:1234/v1.
Modèle refusé : utilisez l’identifiant exact retourné par le service et vérifiez les droits du compte. Le nom affiché par une passerelle peut différer de l’identifiant envoyé en amont.
Fournisseur absent : vérifiez enabled_providers et disabled_providers. Pour diagnostiquer l’installation, lancez ax-code doctor ; cela ne vérifie pas votre compte fournisseur.

Étapes suivantes

Catalogue et méthodes de connexion · Passerelles personnalisées et GPU privés · Choisir un modèle · Créer un AX Wiki · Accueil de la documentation