> 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/comment-executer-des-modeles-dia-locaux-dans-vs-code.md).

# Comment exécuter des modèles d’IA locaux dans VS Code

Comment exécuter des LLM locaux avec VS Code

Ce guide vous montre comment connecter un modèle local exécuté dans Unsloth à Copilot Chat de VS Code. Unsloth charge et sert le modèle, tandis que VS Code fournit l’interface de chat et les outils de codage.

Vous pouvez discuter de votre code, poser des questions et utiliser le mode Agent pour créer et modifier des fichiers avec un modèle qui prend en charge les appels d’outils.

### Installer VS Code

{% tabs %}
{% tab title="macOS" %}
{% stepper %}
{% step %}

#### Télécharger VS Code

Ouvrez la [page de téléchargement de VS Code](https://code.visualstudio.com/download) et téléchargez la version macOS pour votre Mac. Choisissez **Apple silicon**, **Intel**ou **Universal** si vous n’êtes pas sûr.
{% endstep %}

{% step %}

#### Configurer VS Code

Ouvrez le `.zip` téléchargé, puis faites glisser **Visual Studio Code.app** dans votre **Applications** dossier.

Puis, pour ouvrir, allez dans **Applications** et double-cliquez sur **Visual Studio Code**.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Windows" %}
{% stepper %}
{% step %}

#### Télécharger VS Code

Ouvrez la [page de téléchargement de VS Code](https://code.visualstudio.com/download) et téléchargez le programme d’installation Windows **User Installer** pour votre appareil. La plupart des PC utilisent **x64**.
{% endstep %}

{% step %}

#### Configurer VS Code

Ouvrez le `.exe` puis suivez les invites du programme d’installation.

Puis, pour ouvrir, allez dans le menu Démarrer, recherchez **Visual Studio Code**et lancez-le.

Si vous aviez un terminal ouvert pendant l’installation, fermez-le et rouvrez-le pour prendre en compte le PATH mis à jour.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Linux" %}
{% stepper %}
{% step %}

#### Télécharger VS Code

Ouvrez la [page de téléchargement de VS Code](https://code.visualstudio.com/download) et choisissez le paquet correspondant à votre distribution :

* **Ubuntu ou Debian :** `.deb`
* **Fedora ou RHEL :** `.rpm`
  {% endstep %}

{% step %}

#### Configurer VS Code

Ouvrez un terminal dans le dossier contenant votre téléchargement et exécutez :

**Ubuntu ou Debian :**

```bash
sudo apt install ./code_*.deb
```

**Fedora ou RHEL :**

```bash
sudo dnf install ./code-*.rpm
```

Puis, pour ouvrir, allez dans votre lanceur d’applications, recherchez **Visual Studio Code**et lancez-le.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

### ⚡ Démarrage rapide

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

{% stepper %}
{% step %}

#### Télécharger Unsloth

Le moyen le plus simple pour commencer est d’installer l’application de bureau Unsloth. 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 :

{% tabs %}
{% tab title="Installation native" %}
**MacOS, Linux, WSL :**

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

**Windows :**

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

{% endtab %}

{% tab title="Docker" %}
Le [L'image Docker Unsloth](https://hub.docker.com/r/unsloth/unsloth) `unsloth/unsloth` est disponible sur Docker. [Lire le guide.](https://unsloth.ai/docs/get-started/install/docker)
{% endtab %}

{% tab title="Homebrew" %}
Installer Unsloth Desktop :

{% code collapsedlinecount="10" %}

```bash
brew install --cask unsloth
```

{% endcode %}

Mettre à jour Unsloth Desktop :

```bash
brew upgrade --cask unsloth
```

{% endtab %}

{% tab title="WinGet" %}
Installer Unsloth Desktop :

```powershell
winget install --id UnslothAI.Unsloth -e
```

Mettre à jour Unsloth Desktop :

```powershell
winget upgrade --id UnslothAI.Unsloth -e
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Installer

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

{% step %}

#### Choisissez un modèle

Ouvrez la liste déroulante « Select model » en haut ou l’onglet « Model hub », choisissez un modèle et une quantification adaptés à 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

Une fois votre modèle chargé dans Unsloth, exécutez ceci dans votre terminal :

```bash
unsloth start vscode
```

Ouvrez **Copilot Chat** dans VS Code et sélectionnez votre modèle sous **Unsloth** dans le sélecteur de modèle. Envoyez un message pour vérifier la connexion.

Laissez Unsloth en cours d’exécution pendant que vous utilisez le modèle.

<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 %}

### 🔌 Connectez votre modèle

Avec un modèle chargé dans Unsloth, ouvrez un terminal et exécutez :

```bash
unsloth start vscode
```

Cela ajoute le modèle actuellement servi par Unsloth au sélecteur de modèle de VS Code. Cela configure la connexion ; ouvrez VS Code séparément s’il n’est pas déjà en cours d’exécution.

Vous pouvez aussi charger un modèle et configurer VS Code en une seule commande :

```bash
unsloth start vscode --model unsloth/Qwen3.8-27B-GGUF:UD-Q4_K_XL --context-length 32768
```

Vous préférez un autre modèle ? Remplacez l’ID du modèle par celui de votre choix. Vous pouvez aussi fournir un fichier GGUF local :

```bash
unsloth start vscode --model "/path/to/model.gguf" --context-length 32768
```

La commande configure automatiquement la connexion, conserve vos autres modèles et sauvegarde les paramètres de modèle de VS Code.

Elle crée aussi une clé API nommée **VS Code**. Pour la révoquer, ouvrez **Paramètres** dans Unsloth et sélectionnez **API**.

### <i class="fa-vscode">:vscode:</i> Utilisez votre modèle local dans VS Code

Ouvrez un dossier de projet dans VS Code, ou un dossier vide pour essayer.

Ouvrez **Copilot Chat** , cliquez sur le sélecteur de modèle sous le champ de saisie du chat et sélectionnez votre modèle sous **Unsloth**. Choisissez **Agent** pour lui permettre de créer et de modifier des fichiers, ou **Ask** pour discuter de votre code.

<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%2Fdimfm9IrGcW4PK2OFNan%2Fimage.png?alt=media&amp;token=6ab59f12-9fdf-4e08-82fc-e52dbe70f375" alt="" width="563"><figcaption></figcaption></figure></div>

Le mode Agent nécessite la prise en charge des appels d’outils. Nous recommandons au moins **32 K de contexte**.

Construisons un jeu simple. Essayez cette requête :

{% code overflow="wrap" %}

```
Créez un jeu Snake jouable dans un seul fichier index.html.

Utilisez les touches fléchées pour vous déplacer, affichez le score et ajoutez un bouton de redémarrage.

Donnez-lui un fond clair et un serpent vert vif. Utilisez HTML, CSS et JavaScript sans dépendances externes.
```

{% endcode %}

{% columns %}
{% column %}
Vérifiez les autorisations des outils avant de les approuver. Une fois que l’agent a créé `index.html`ouvrez-le dans votre navigateur et jouez.

Vous voulez changer quelque chose ? Demandez-lui d’ajouter des niveaux de difficulté ou un suivi des meilleurs scores.

Gardez votre modèle chargé et le serveur Unsloth en cours d’exécution pendant que vous travaillez.
{% endcolumn %}

{% column %}

<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%2F7CYu4PotqktrbwiRXkPP%2Fwormgif.gif?alt=media&amp;token=08dbd04f-c6a4-48ea-986a-428131c8e970" alt="" width="375"><figcaption></figcaption></figure></div>

{% endcolumn %}
{% endcolumns %}

Si votre modèle n’apparaît pas, vérifiez **Gérer les modèles** dans le sélecteur de modèle. Vous pouvez aussi actualiser VS Code en exécutant `Développeur : Recharger la fenêtre` depuis la palette de commandes.

#### Changer de modèle

Chargez un autre modèle dans Unsloth, puis exécutez :

```bash
unsloth start vscode
```

Sélectionnez le nouveau modèle sous **Unsloth** dans Copilot Chat.

## Dépannage

**Mon modèle n’apparaît pas**

Ouvrez **Gérer les modèles** dans le sélecteur de modèle et recherchez **Unsloth**. S’il est absent, vérifiez que GitHub Copilot Chat est activé, puis exécutez `unsloth start vscode` à nouveau.

S’il n’apparaît toujours pas, ouvrez la palette de commandes et exécutez **Développeur : Recharger la fenêtre**.

**Mon modèle apparaît dans Ask mais pas dans le mode Agent**

Le mode Agent nécessite la prise en charge des appels d’outils. Utilisez **Ask** avec ce modèle, ou passez à un modèle dont le modèle de chat prend en charge les outils.

**Je rencontre des erreurs de longueur de contexte**

Les instructions et les outils de l’Agent occupent une partie de la fenêtre de contexte du modèle. Nous recommandons au moins **32 K de contexte** pour le mode Agent.

Remplacez le chemin ci-dessous par votre fichier GGUF et exécutez :

{% code overflow="wrap" %}

```bash
unsloth start vscode --model "/path/to/model.gguf" --context-length 32768
```

{% endcode %}

Rechargez VS Code si les détails du modèle ne se sont pas mis à jour. Il peut afficher 32 768 jetons sous la forme **33 K**.

#### Unsloth s’exécute sur une machine distante

Dans une session SSH ou conteneur sans répertoire utilisateur VS Code, la commande imprime la configuration à ajouter localement et les instructions de connexion.

Suivez les instructions affichées pour rendre le serveur accessible depuis votre ordinateur, puis ajoutez la configuration à votre installation locale de VS Code.

Si le modèle n’apparaît pas dans une fenêtre Remote-SSH, WSL ou conteneur de développement, essayez une **fenêtre locale de VS Code** connectée au serveur Unsloth distant.

Pour plus d’options de chargement de modèles et de paramètres de connexion à distance, consultez le [guide de démarrage Unsloth](https://unsloth.ai/docs/integrations/unsloth-start).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/fr/integrations/comment-executer-des-modeles-dia-locaux-dans-vs-code.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.