Comment exécuter des modèles d’IA locaux avec OpenCode
Guide pour connecter des LLMs ouverts avec OpenCode sur votre appareil local.
Ce guide vous explique comment connecter OpenCode à 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 tout 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 plus encore.
OpenCode agit comme le client, tandis qu'Unsloth charge et sert 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.
Ce guide couvre les deux options de configuration :
OpenCode Desktop : ajoutez manuellement Unsloth Studio comme fournisseur personnalisé compatible OpenAI.
OpenCode CLI : lancez-le avec
unsloth start opencodeet connectez-vous automatiquement à votre modèle local.
Installation d'OpenCode Desktop
Étape 1 : Téléchargez l'installateur OpenCode pour Mac
Ouvrez opencode.ai/download dans votre navigateur préféré. Faites défiler jusqu'à OpenCode Desktop (Beta) , et cliquez sur le bouton Télécharger à 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 de l'installateur s'ouvrira. Utilisez votre souris pour faire glisser l' OpenCode icône de l'application sur le Applications comme indiqué.
Étape 3 : Lancez OpenCode
Localisez et double-cliquez sur le OpenCode icône sous le Applications dossier.
L' OpenCode application de bureau s'ouvrira et est maintenant prête pour votre prochaine action.
Étape 1 : Téléchargez l'installateur OpenCode pour Windows
Ouvrez opencode.ai/download dans votre navigateur. Faites défiler jusqu'à OpenCode Desktop (Beta), et cliquez sur le bouton Télécharger bouton à côté de l'installateur Windows (x64).
Étape 2 : Installez OpenCode
repérez le OpenCode Desktop Installer.exe dans votre dossier Téléchargements et double-cliquez dessus. Vous pouvez ensuite suivre les instructions dans la fenêtre de l'installateur pour terminer l'installation.
Étape 3 : Lancez OpenCode
Ouvrez le menu Démarrer de Windows et recherchez OpenCode. Cliquez sur l'icône de l'application OpenCode pour la lancer. L'application de bureau OpenCode s'ouvrira et est maintenant prête pour votre prochaine action
Étape 1 : Téléchargez l'installateur OpenCode pour Linux
Allez sur opencode.ai/download en utilisant votre navigateur Web préféré. Trouvez la OpenCode Desktop (Beta) section, puis choisissez l'option de téléchargement Linux pour votre système.
Étape 2 : Installez OpenCode
Ouvrez votre dossier Téléchargements et trouvez le OpenCode installateur que vous venez de télécharger.
Pour un téléchargement AppImage, faites un clic droit sur le fichier, ouvrez Propriétés, et activez l'option permettant d'exécuter le fichier comme un programme. Double-cliquez ensuite sur l'AppImage pour démarrer OpenCode.
Ou, si vous préférez utiliser le terminal, exécutez :
Si vous avez téléchargé un .deb fichier, installez-le avec :
Si vous avez téléchargé un .rpm fichier, installez-le avec :
Étape 3 : Lancez OpenCode
Ouvrez votre lanceur d'applications Linux et recherchez OpenCode.
Cliquez sur l'icône de l'application OpenCode pour la lancer. L'application de bureau OpenCode s'ouvrira et est maintenant prête pour votre prochaine action.
⚡ Démarrage rapide
Après avoir installé OpenCode, nous devons installer Unsloth Desktop pour permettre à OpenCode de servir et d'exécuter l'inférence des modèles locaux.
🔑 Création d'une clé API
Ouvrez la barre latérale, cliquez sur votre Unsloth avatar en bas à gauche.
Allez sur Paramètres → API.
Entrez un nom convivial (par ex.
claude-code-macbook).(Facultatif) Définissez une date d'expiration.
Cliquez sur Créer.
Copiez immédiatement la clé. Unsloth ne stocke qu'un hachage et vous ne pourrez plus la voir.
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 tout fournisseur compatible OpenAI, vous pouvez donc brancher Unsloth en tant que fournisseur personnalisé . La configuration se fait une seule fois dans la boîte de dialogue Connexion du fournisseur .
1. Ouvrez le sélecteur de fournisseur. Dans opencode, tapez /model (ou cliquez sur le sélecteur de modèle en bas de la zone de saisie).
Puis cliquez sur Connexion du fournisseur en haut à droite de la boîte de dialogue de sélection du modèle.
2. Choisissez « Personnalisé ». Dans la liste des fournisseurs, faites défiler jusqu'à Autre et choisissez fournisseur personnalisé.
3. Remplissez le formulaire du fournisseur personnalisé :
ID du fournisseur
unsloth-studio (en minuscules, traits d'union autorisés)
Nom d'affichage
Unsloth Studio
URL de base
http://localhost:8888/v1/ (remplacez 8888 par votre Unsloth port ; conservez le /v1/)
Clé API
Votre sk-unsloth-… clé
Dans la section Modèles , 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 :
unsloth/Qwen3.6-27B-GGUF (le nom exact du modèle tel qu'affiché dans Unsloth)
unsloth/Qwen3.6-27B-GGUF (affiché dans opencode)
Laissez En-têtes vide, sauf si vous faites passer Unsloth par une couche d'authentification nécessitant des en-têtes personnalisés.
4. Cliquez sur Soumettre. Vous devriez voir un toast « Unsloth Studio connecté. Les modèles Unsloth sont maintenant disponibles » .
Redémarrez opencode après avoir ajouté le fournisseur. Le nouveau fournisseur n'est sélectionnable qu'après un redémarrage.
5. Sélectionnez votre modèle Unsloth. Une fois opencode relancé, tapez /model, recherchez unsloth, et choisissez le modèle sous le Unsloth Studio groupe. Il sera actif pour votre prochain message.
Unsloth prend en charge les SDK Python OpenAI et Anthropic.
⚙️ OpenCode CLI
OpenCode CLI peut se connecter à un modèle déjà en cours d'exécution dans Unsloth Studio, ou en démarrer un automatiquement lorsque Unsloth n'est pas en cours d'exécution.
Si Unsloth Studio est déjà en cours d'exécution
Avec un modèle chargé dans Unsloth Studio, ouvrez le dossier de votre projet et exécutez :
L'utilisation de cette commande lance OpenCode avec le modèle actuellement chargé dans Unsloth, sans modifier votre configuration OpenCode existante.
Démarrer un modèle automatiquement
Si Unsloth n'est pas déjà en cours d'exécution, vous pouvez lancer un serveur temporaire et charger un modèle en une seule commande :
Pour lancer OpenCode directement avec un modèle, exécutez :
Unsloth sélectionne automatiquement les bons paramètres à utiliser, mais vous pouvez toujours les modifier.
Une fois OpenCode ouvert, donnez-lui une tâche telle que :
Il peut inspecter le projet, créer des fichiers, modifier le code et exécuter des commandes à l'aide du modèle local.
Dans cet exemple, le modèle a créé un jeu de plateforme à deux niveaux. Ouvrons-le et voyons comment cela s'est passé.
Reprenez votre travail
OpenCode conserve automatiquement l'historique de votre session, vous n'avez donc pas besoin --persist. Pour reprendre là où vous vous étiez arrêté, même si Unsloth ne s'exécute plus, utilisez :
Pour ouvrir une session particulière à la place, utilisez --session <session-id>.
Voir la référence complète unsloth start pour le chargement des modèles, les serveurs Unsloth distants et les options avancées.
Optionnel : 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 --disable-tools lorsque vous pilotez OpenCode (ou tout autre agent de codage externe). Par défaut, Unsloth Studio exécute ses propres outils côté serveur, ce qui absorbe les appels d'outils de l'agent, de sorte qu'OpenCode répond mais ne modifie jamais les fichiers. --disable-tools passe en mode relais, de sorte que les propres outils d'OpenCode sont utilisés.
Utilisez -p pour modifier le port sur lequel le serveur s'exécute.
Cela démarre le serveur sur 0.0.0.0:8888, permettant à d'autres appareils de votre réseau local de se connecter.
Pour une configuration d'exécution plus avancée, consultez la section principale réglage de l'API .
Mis à jour
Ce contenu vous a-t-il été utile ?