> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/fr/integrations/opencode.md).

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

Ce guide vous explique comment connecter **OpenCode Desktop** à [Unsloth](https://github.com/unslothai/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 avec OpenAI**, notamment DeepSeek, Qwen, Gemma, et bien d’autres. OpenCode agit comme client, tandis qu’Unsloth charge et sert des 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**.

<a href="https://sites.gitbook.com/preview/site_mXXTe/~/revisions/S6OVzFPYN3gcF4rziUb5/integrations/opencode?theme=light#installing-opencode-desktop" class="button primary">Configuration d’OpenCode</a><a href="/pages/5ed7fe5ad328b9ea2064f629be46409a5616379c#quickstart" class="button primary">Démarrage rapide</a>

{% hint style="info" %}
Dans ce tutoriel, nous utiliserons `unsloth/Qwen3.6-27B-GGUF` chargé dans Unsloth et y accéder directement dans OpenCode. Vous préférez un autre modèle ? Remplacez-le par n’importe quel autre modèle en le chargeant dans Unsloth.
{% endhint %}

### Installation d’OpenCode Desktop

{% tabs %}
{% tab title="Windows" %}

{% endtab %}

{% tab title="macOS" %}
**É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 (bêta),** 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).

<figure><img src="/files/3daf1b1923f8df563d9e421f10b77acd58cca6f1" alt=""><figcaption></figcaption></figure>

Une fenêtre contextuelle apparaîtra et vous demandera où vous souhaitez enregistrer l’installateur OpenCode. Vous pouvez accepter les valeurs par défaut. Cliquez sur **Enregistrer.** Cela enregistrera l’ **OpenCode** installateur dans votre `dossier Téléchargements` .

<figure><img src="/files/720f617a00fb8b7346acaa8db065e11fdeb339e9" alt=""><figcaption></figcaption></figure>

#### Étape 2 : Installez OpenCode

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

<figure><img src="/files/626d92daa79e6d10a22f1e0efdeb1cbd4e2396c8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/217e9b7427400c833db45a36a994e154186661ec" alt=""><figcaption></figcaption></figure>

#### Étape 3 : Lancez OpenCode

Localisez et double-cliquez sur le **OpenCode** icône sous l’ **Applications** .

<figure><img src="/files/faa6406a2c24096015485738ad9fd15884c571e1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/89f29b2e5ea1bb37aca0592e93eb21fa68c49836" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Linux/WSL" %}

{% endtab %}
{% endtabs %}

## Installation d’Unsloth

### ⚡ Démarrage rapide

Après avoir installé OpenCode, nous devrons installer Unsloth Studio pour permettre à OpenCode de servir 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 sur lequel il démarre 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. **Créez une clé API.** Dans Unsloth, cliquez sur votre **Unsloth** avatar en bas à gauche → **Paramètres** → **API** → saisissez un nom de clé → **Créer**. Copiez la `sk-unsloth-…` valeur qui s’affiche. Unsloth ne l’affiche qu’une seule fois.
5. **Pointez votre client vers Unsloth.** Utilisez `http://localhost:PORT` comme URL de base et votre `sk-unsloth-…` clé pour l’authentification. Passez à la procédure correspondant à votre outil ci-dessous.

### 🔑 Création d’une clé API

1. Ouvrez la barre latérale, cliquez sur votre **Unsloth** avatar en bas à gauche.
2. Accédez à **Paramètres** → **API**.
3. Saisissez un nom explicite (par ex. `claude-code-macbook`).
4. *(Facultatif)* Définissez une date d’expiration.
5. Cliquez sur **Créer**.
6. **Copiez la clé immédiatement.** Unsloth ne stocke qu’un hachage et vous ne pourrez plus la consulter.

<figure><img src="/files/236f8680018f6e8f0517e6ead4329fe9f5efb49f" alt="" width="375"><figcaption></figcaption></figure>

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

{% hint style="warning" %}
Traitez votre clé API comme un mot de passe. Toute personne disposant de la clé et d’un accès réseau à votre instance Unsloth peut envoyer des requêtes à votre modèle chargé.
{% endhint %}

## 🖇️ Connexion d’Unsloth à OpenCode Desktop

**OpenCode** prend en charge n’importe quel fournisseur compatible avec OpenAI, vous pouvez donc intégrer Unsloth en tant que **personnalisé** fournisseur. La configuration est un processus unique dans la **boîte de dialogue Connecter un fournisseur d’OpenCode** .

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

<div data-with-frame="true"><figure><img src="/files/1fc09fa493e28de5234a23ce2b2492f56fcf4fbb" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/38884147fac21153360983df78a30519993ec02e" alt="" width="375"><figcaption></figcaption></figure></div>

**2. Choisissez « Personnalisé ».** Dans la liste des fournisseurs, faites défiler jusqu’à **Autre** et choisissez **personnalisé**.

<div data-with-frame="true"><figure><img src="/files/f0258cb61cb48b5609a4eb6f2acff42aa447da34" alt="" width="375"><figcaption></figcaption></figure></div>

**3. Remplissez le formulaire du fournisseur personnalisé :**

| Champ                 | Valeur                                                                                          |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| **ID du fournisseur** | `unsloth-studio` *(minuscules, tirets 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** 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 :

| ID du modèle (gauche)                                                            | Nom d’affichage (droite)                             |
| -------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `unsloth/Qwen3.6-27B-GGUF` *(le nom exact du modèle tel qu’affiché dans Studio)* | `unsloth/Qwen3.6-27B-GGUF` *(affiché dans OpenCode)* |

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

<div data-with-frame="true"><figure><img src="/files/967a4599f326dfa51b24566eb0a45036535e132f" alt="" width="375"><figcaption></figcaption></figure></div>

**4. Cliquez sur Soumettre.** Vous devriez voir une *« Unsloth Studio connecté. Les modèles Unsloth sont maintenant disponibles »* notification toast.

<figure><img src="/files/7d2d1b85e7cf72ec1d61f5877ac8b6a5d4d8bceb" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Redémarrez OpenCode après avoir ajouté le fournisseur.** Le nouveau fournisseur ne devient sélectionnable qu’après un redémarrage.
{% endhint %}

**5. Sélectionnez votre modèle Unsloth.** Une fois OpenCode relancé, tapez `/model`, recherchez `unsloth`, puis choisissez le modèle sous le **Unsloth Studio** groupe. Il sera actif lors de votre prochain message.

<div data-with-frame="true"><figure><img src="/files/36b62bcba1dc0c76950b3a97550b371f4839c14c" alt="" width="375"><figcaption></figcaption></figure></div>

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.

```bash
# Exécutez l’API sur le port 8888
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  -p 8888
```

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

```bash
# Autorisez d’autres appareils de votre réseau à se connecter
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  -H 0.0.0.0 \
  -p 8888
```

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 la section principale [de réglage de l’API](https://unsloth.ai/docs/basics/api#unsloth-run-command) .


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://unsloth.ai/docs/fr/integrations/opencode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.