Comment exécuter des modèles d’IA locaux avec OpenCode

Ce guide vous explique comment connecter OpenCode Desktop à Unsloth pour exécuter des LLM ouverts entièrement en local. OpenCode est un agent de codage IA open source qui lit, modifie et exécute du code dans l’ensemble de votre projet à l’aide d’un modèle connecté. Cela fonctionne avec n’importe quel modèle local exposé via l’ API compatible OpenAI, notamment : DeepSeek, Qwen, Gemma, et bien d’autres. OpenCode agit comme client, tandis qu’Unsloth charge et diffuse les modèles via une API locale.

Après la configuration, OpenCode se connecte à Unsloth, où vous pouvez sélectionner un modèle chargé et l’utiliser comme agent de codage.

Configuration d’OpenCodeDémarrage rapide

Installation d’OpenCode Desktop

macOS

Windows

Linux

Étape 1 : téléchargez le programme d’installation d’OpenCode pour Mac

Ouvrez opencode.ai/download dans votre navigateur préféré. Faites défiler jusqu’à OpenCode Desktop (bêta), et cliquez sur le Télécharger bouton à côté du nom de l’image macOS correspondant à l’architecture de votre Mac (Apple Silicon ou Intel).

Étape 2 : installez OpenCode

Localisez et double-cliquez sur le OpenCode Desktop.dmg fichier d’installation dans votre dossier Téléchargements.

La fenêtre d’installation s’ouvrira. Utilisez votre souris pour faire glisser l’icône de l’application OpenCode au-dessus de l’icône Applications comme indiqué.

Étape 3 : lancez OpenCode

Localisez et double-cliquez sur le OpenCode icône sous le dossier Applications dossier.

L’ OpenCode application de bureau s’ouvrira et est maintenant prête pour votre prochaine action.

⚡ Démarrage rapide

Après l’installation d’OpenCode, nous devrons installer Unsloth Studio pour permettre à OpenCode de diffuser et d’exécuter l’inférence de modèles locaux.

1. Installez ou mettez à jour Unsloth Studio. Les versions antérieures n’exposent pas l’API externe. Voir Installation.

2. Lancez Unsloth. Notez que le port de démarrage est généralement 8000 ou 8888. Vous le verrez dans la sortie du terminal et dans l’URL du navigateur (http://localhost:PORT).

3. Chargez un modèle. Cliquez sur Nouvelle discussion, choisissez ou recherchez un modèle (GGUF), puis attendez la fin du chargement.

4. Connectez OpenCode. Exécutez unsloth start opencode. Il génère une clé API, écrit la configuration et lance OpenCode avec votre modèle chargé.

⚡ Connecter avec unsloth start

Le moyen le plus rapide de pointer OpenCode vers votre modèle local est unsloth start . Avec Unsloth en cours d’exécution et un modèle chargé, exécutez :

Cela génère pour vous une clé API, écrit le fournisseur unsloth dans ~/.config/opencode/opencode.json, sélectionne le modèle et lance OpenCode. Cela fait la même chose que la configuration manuelle Connecter le fournisseur ci-dessous, vous pouvez donc ignorer cette boîte de dialogue.

Par défaut, il utilise le modèle déjà chargé dans Unsloth. Pour charger et utiliser un modèle spécifique, passez --model:

Vous vous connectez à Unsloth sur une autre machine ? Créez une clé (ci-dessous) et passez-la avec --api-key, puis pointez UNSLOTH_STUDIO_URL vers le serveur.

Les étapes ci-dessous configurent manuellement la même chose dans OpenCode Desktop, si vous préférez l’application ou si vous avez besoin d’une configuration personnalisée.

🔑 Création d’une clé API

1. Ouvrez la barre latérale, cliquez sur votre Unsloth avatar en bas à gauche.

2. Allez dans Paramètres → API.

3. Entrez un nom convivial (par ex. claude-code-macbook).

4. (Facultatif) Définissez une date d’expiration.

5. Cliquez sur Créer.

6. Copiez immédiatement la clé. Unsloth ne stocke qu’un hachage et vous ne pourrez plus la consulter.

Toutes les clés commencent par le préfixe sk-unsloth- . Révoquez une clé depuis la même page à tout moment. Les requêtes effectuées avec une clé révoquée échoueront avec 401 Non autorisé.

🖇️ Connexion d’Unsloth à OpenCode Desktop

OpenCode prend en charge n’importe quel fournisseur compatible OpenAI, vous pouvez donc intégrer Unsloth comme un Personnalisé fournisseur. La configuration est un processus unique dans la Connecter le fournisseur boîte de dialogue.

1. Ouvrez le sélecteur de fournisseur. Dans opencode, saisissez /model (ou cliquez sur le sélecteur de modèle en bas du champ de saisie).

Puis cliquez sur Connecter le fournisseur en haut à droite de la boîte de dialogue de sélection du modèle.

2. Choisissez "Custom". Dans la liste des fournisseurs, faites défiler jusqu’à Autre et sélectionnez Personnalisé.

3. Remplissez le formulaire du fournisseur personnalisé :

Dans la Modèles section, ajoutez une ligne par modèle que vous souhaitez exposer. Le champ de gauche est l’ID du modèle tel qu’Unsloth le sert ; le champ de droite est ce qu’opencode affichera :

Laissez En-têtes vide, sauf si vous faites transiter Unsloth par une couche d’authentification nécessitant des en-têtes personnalisés.

4. Cliquez sur Envoyer. Vous devriez voir une "Unsloth Studio connecté. Les modèles Unsloth sont maintenant disponibles à l’utilisation" notification.

5. Sélectionnez votre modèle Unsloth. Une fois opencode relancé, saisissez /model, recherchez unsloth, puis choisissez le modèle sous le groupe Unsloth Studio . Il sera actif à votre prochain message.

Unsloth prend en charge les SDK Python OpenAI et Anthropic.

Facultatif : configurer l’accès au serveur

unsloth run démarre le serveur API local et charge un modèle auquel OpenCode peut se connecter. Vous pouvez également personnaliser le comportement du serveur au démarrage.

Utilisez -p pour modifier le port sur lequel le serveur s’exécute.

Cela démarre le serveur sur 0.0.0.0:8888, ce qui permet à d’autres appareils de votre réseau local de se connecter.

Pour une configuration d’exécution plus avancée, consultez le principal Ajustement de l’API section.