> 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 d’IA locaux avec OpenCode

Guide pour connecter des LLM ouverts à OpenCode sur votre appareil local.

Ce guide vous explique comment connecter **OpenCode** à [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 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 opencode` et connectez-vous automatiquement à votre modèle local.

<a href="https://unsloth.ai/docs/integrations/opencode#installing-opencode-desktop" class="button primary">Configuration d'OpenCode</a><a href="/docs/fr/integrations/opencode.md#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éderons directement dans OpenCode. Vous préférez un autre modèle ? Remplacez-le par un autre modèle en le chargeant dans Unsloth.
{% endhint %}

### Installation d'OpenCode Desktop

{% tabs %}
{% 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 (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.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FZNP4G1c2hmHyBzNbGH5x%2Fopencode_interface.png?alt=media&amp;token=5af679cb-504d-4299-a40e-0d8310289a90" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Windows" %}

#### **É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

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLECAvpw6DMNCcuFclzoy%2Fimage.png?alt=media&amp;token=7a628b56-3e0c-4d00-8054-ab8b9317e4f9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Linux" %}

#### **É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 :

```
chmod +x OpenCode*.AppImage
./OpenCode*.AppImage
```

Si vous avez téléchargé un `.deb` fichier, installez-le avec :

```
sudo apt install ./OpenCode*.deb
```

Si vous avez téléchargé un `.rpm` fichier, installez-le avec :

```
sudo dnf install ./OpenCode*.rpm
```

#### **É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.
{% endtab %}
{% endtabs %}

### ⚡ Démarrage rapide

Après avoir installé OpenCode, nous devons installer [Unsloth Desktop](/docs/fr/desktop.md) pour permettre à OpenCode de servir et d'exécuter l'inférence des modèles locaux.

{% stepper %}
{% step %}

#### Télécharger Unsloth

La façon la plus simple de commencer est d'installer l'application Unsloth Desktop. Elle prend en charge [macOS](/docs/fr/commencer/install/mac.md), Linux, [Windows](/docs/fr/commencer/install/windows-installation.md), [NVIDIA](/docs/fr/commencer/install/pip-install.md), [AMD](/docs/fr/commencer/install/amd.md), Intel et les configurations CPU.

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Télécharger Unsloth</a>

* <i class="fa-apple">:apple:</i> [Télécharger pour macOS](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Télécharger pour Windows](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Télécharger pour Linux](https://unsloth.ai/download/linux)

Ou, si vous préférez une installation manuelle :

**MacOS, Linux, WSL :**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows PowerShell :**

```bash
irm https://unsloth.ai/install.ps1 | iex
```

{% endstep %}

{% step %}

#### Installer

1. Ouvrez l'installateur Unsloth (`.dmg`, `.exe` fichiers)
2. Faites glisser Unsloth vers Applications sur Mac ou terminez l'installation sous Windows.
3. Lancez l'application et attendez la fin de l'installation
   {% endstep %}

{% step %}

#### Choisissez un modèle

Ouvrez le menu déroulant « Select model » en haut ou l'onglet « Model hub », choisissez un modèle et une quantisation adaptée à votre appareil, puis téléchargez-le. Une fois terminé, commencez à discuter — aucune configuration requise.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unsloth est maintenant prêt

Pour commencer à discuter, tapez un message et appuyez sur Entrée.

**Connectez OpenCode.** Exécutez `unsloth start opencode`. Il crée une clé API, écrit la configuration et lance OpenCode sur votre modèle chargé.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FpAGvwjGD0iVMZKBoyu7m%2Fgreeennn.png?alt=media&amp;token=d17a5528-8375-444c-9aff-f9e9f7903bcd" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

1. Ouvrez la barre latérale, cliquez sur votre **Unsloth** avatar en bas à gauche.
2. Allez sur **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 voir.

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FrWnqY5PgvZdbWK8pmlD5%2Fimage.png?alt=media&amp;token=3507e7d7-b552-447f-b503-2418802b8f6e" alt="" width="375"><figcaption></figcaption></figure>

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).

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fl59D1AVRI57fQBJqgp8t%2Fslash-model.png?alt=media&amp;token=9434f804-6a9e-4b76-ab7e-75cd745fe9c2" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fi9VOd4yRAmLnqZ1D4tBm%2Fconnect%20provider.png?alt=media&amp;token=cb28387a-9cc3-4c5f-928e-82a56edd86df" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FWyltmg0o9YtyydUSLvcn%2Fcustom%20highlighted.png?alt=media&amp;token=5cc89686-dfae-4ebd-8beb-e6dc78088b4b" alt="" width="375"><figcaption></figcaption></figure></div>

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

| Champ                 | Valeur                                                                                          |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| **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 :

| ID du modèle (gauche)                                                             | Nom d'affichage (droite)                             |
| --------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `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.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FjGU2OaOKRtqCwmO34BuN%2Fopencode_custom_provider_config.png?alt=media&amp;token=6ef67ecf-23e6-4913-bc02-c26701f5aea0" alt="" width="375"><figcaption></figcaption></figure></div>

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

<figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FuCOOOJhO8brhEwwIsiUC%2Fopencode_model_available_toast.png?alt=media&amp;token=a463bb0c-724a-4809-9ddb-b7bff094b255" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Redémarrez opencode après avoir ajouté le fournisseur.** Le nouveau fournisseur n'est sélectionnable qu'après un redémarrage.
{% endhint %}

**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.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FFRNofXnF7r7CKlHjLMwv%2Fopencode_unsloth_model_usage.png?alt=media&amp;token=4c882e8f-6ac5-4f9b-8f59-5e86e312851b" alt="" width="375"><figcaption></figcaption></figure></div>

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 :

```bash
unsloth start opencode
```

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 :

```bash
unsloth start opencode \
    --model unsloth/qwen3.8-27B-GGUF-GGUF:UD-Q4_K_XL
    --temp 1.0 \
    --top-p 0.95 \
    --top-k 20 \
    --min-p 0.0 \
    --reasoning-effort medium
```

Unsloth sélectionne automatiquement les bons paramètres à utiliser, mais vous pouvez toujours les modifier.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fom5iWH1f42GZ69utVSyf%2Fimage.png?alt=media&amp;token=815a0458-b252-4c96-a341-e345842bd248" alt="" width="563"><figcaption></figcaption></figure></div>

Une fois **OpenCode** ouvert, donnez-lui une tâche telle que :

```
Créez un jeu Python 2D de style Flash avec saut, dash et deux niveaux.
```

Il peut inspecter le projet, créer des fichiers, modifier le code et exécuter des commandes à l'aide du modèle local.

<div align="center" data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FOA6dENYOpJdGa3zwS8Ei%2Fimage.png?alt=media&amp;token=266a85f8-ec80-4a7d-bd58-e82d9ff0b864" alt="" width="563"><figcaption></figcaption></figure></div>

Dans cet exemple, le modèle a créé un jeu de plateforme à deux niveaux. Ouvrons-le et voyons comment cela s'est passé.

<div data-with-frame="true"><figure><img src="https://550366147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FHqFv9FyPsM0poo5c6WNb%2Fezgif-68bd7a9b463725d0.gif?alt=media&amp;token=abafdfef-6e13-430b-bccb-140f29ee6d13" alt="" width="563"><figcaption></figcaption></figure></div>

#### 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 :

```bash
unsloth start opencode \
  --model unsloth/Qwen3.6-27B-GGUF \
  --continue
```

Pour ouvrir une session particulière à la place, utilisez `--session <session-id>`.

Voir la référence complète [unsloth start](/docs/fr/integrations/unsloth-start.md) 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.

```bash
# Exécute l'API sur le port 8888 (--disable-tools transmet les propres outils d'OpenCode)
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  --disable-tools \
  -p 8888
```

{% hint style="warning" %}
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.
{% endhint %}

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

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

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](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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.