> 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/unsloth-start.md). # Exécuter des agents de codage avec des LLM locaux en utilisant Unsloth Start Unsloth vous permet de connecter [Claude Code](/docs/fr/notions-de-base/claude-code.md), [Codex](/docs/fr/notions-de-base/codex.md), Hermes, OpenCode et d'autres agents de codage à un modèle local via la `commande unsloth start` . L'ensemble du flux de travail peut s'exécuter hors ligne sur votre propre matériel. [Unsloth](/docs/fr/desktop.md) configure automatiquement l'endpoint, la clé API, le fournisseur, le modèle et la longueur de contexte à chaque lancement, afin que vous puissiez utiliser votre agent préféré sans les modifier. Ce guide vous montrera comment lancer des modèles depuis la ligne de commande pour une utilisation hors ligne, et vous connecter à Unsloth. {% columns %} {% column width="58.333333333333336%" %} ### Démarrage rapide Tout d'abord, assurez-vous d'avoir [Unsloth installé](/docs/fr/nouveau/studio/install.md). Ouvrez ensuite Unsloth, chargez un modèle, allez dans le dossier de votre projet et exécutez la commande dans le terminal : ```bash unsloth start claude ``` Vous pouvez remplacer `claude` par n'importe quel agent ci-dessous : {% endcolumn %} {% column width="41.666666666666664%" %}

Claude Code exécuté localement avec Qwen3.5.

{% endcolumn %} {% endcolumns %} | Agent | Commande | | ------------------------------------------------------------------ | ------------------------ | | Claude Code | `unsloth start claude` | | OpenAI Codex | `unsloth start codex` | | Visual Studio Code | `unsloth start vscode` | | DeepSeek Harness | `unsloth start dsh` | | OpenCode | `unsloth start opencode` | | Agent Hermes | `unsloth start hermes` | | OpenClaw | `unsloth start openclaw` | | Agent Pi | `unsloth start pi` | Unsloth utilise une configuration temporaire ou limitée à la session pour le fournisseur. Il n'ajoute pas de fournisseur Unsloth aux fichiers de configuration normaux de l'agent. ### Guides des agents

Titre	Image de couverture
Claude Code	claude-code.webp	Claude Code
Codex	codex only logo.png	OpenAI Codex
Visual Studio Code	vscode-card.png	Run models in VS Code
Agent Hermes	images.jpeg	Hermes Agent
OpenClaw	openclaw-hero-light.png	OpenClaw
OpenCode	opencodelogo.png	OpenCode

### Charger un modèle depuis la ligne de commande

unsloth start launching Codex with a local GGUF model in Unsloth Studio — Unsloth start trouve ou charge le modèle, configure l'agent de codage et le lance depuis le projet actuel.

Vous pouvez sélectionner et charger un modèle lors du lancement de l'agent : {% hint style="success" %} S'il n'y a aucun paramètre/indicateur d'échantillonnage défini, Unsloth sélectionne automatiquement les meilleurs paramètres recommandés pour le modèle, y compris la longueur de contexte, la température, etc. {% endhint %} ```bash unsloth start claude \\ --model unsloth/Qwen3.8-27B-GGUF:UD-Q4_K_XL \\ --context-length 32768 \\ --temp 1.0 \\ --top-p 0.95 \\ --top-k 20 \\ --min-p 0.0 \\ --reasoning-effort medium ``` Le `:UD-Q4_K_XL` suffixe sélectionne la quantification GGUF. Sur l'adresse locale par défaut, passer `--model` permet `commande unsloth start` de démarrer un serveur temporaire lorsque Unsloth Studio n'est pas déjà en cours d'exécution. Le serveur temporaire s'arrête lorsque l'agent se ferme. Si Unsloth est déjà en cours d'exécution, la commande s'y connecte et le laisse fonctionner. Voir ci-dessous des exemples d'agents connectés à un LLM local : {% columns %} {% column width="50%" %}

{% endcolumn %} {% column width="50%" %}

{% endcolumn %} {% endcolumns %} {% columns %} {% column width="33.33333333333333%" %}

{% endcolumn %} {% column width="33.33333333333333%" %}

{% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} ### Se connecter à un serveur Unsloth distant Définissez l'URL Unsloth et la clé API avant de lancer un agent : ```bash export UNSLOTH_STUDIO_URL=https://studio.example.com export UNSLOTH_API_KEY=sk-unsloth-... unsloth start claude ``` Vous pouvez également fournir la clé avec `--api-key`. Pour un serveur local Unsloth vérifié, `commande unsloth start` crée ou réutilise automatiquement la clé API. #### Utiliser Unsloth dans VS Code Connectez un modèle local au chat Copilot de VS Code. Nécessite l'extension GitHub Copilot Chat ; aucun abonnement Copilot n'est requis. ```bash # Connectez le modèle qu'Unsloth sert déjà unsloth start vscode # Ou chargez un modèle avec un contexte de 32 K pour le mode Agent unsloth start vscode unsloth/Qwen3.5-4B-GGUF:UD-Q4_K_XL --context-length 32768 ``` Ouvrez Copilot Chat et sélectionnez votre modèle sous **Unsloth**. S'il manque, vérifiez **Gérer les modèles** ou exécutez **Développeur : recharger la fenêtre**. Le mode Agent nécessite la prise en charge des appels d'outils et au moins **un contexte de 32 K**. Utilisez le mode Demander pour les modèles sans appel d'outils. La commande sauvegarde votre configuration VS Code et préserve les autres modèles. Après avoir changé de modèle, relancez `unsloth start vscode` pour mettre à jour son entrée. **Serveurs distants :** Dans une session SSH ou conteneur sans répertoire utilisateur VS Code, la commande affiche la configuration à ajouter localement, ainsi que les instructions de connexion ou de redirection de port. Utilisez une fenêtre VS Code locale si le modèle manque dans le sélecteur de modèles de l'espace de travail distant. ### Indicateurs + options S'il n'y a aucun paramètre/indicateur d'échantillonnage défini, Unsloth sélectionne automatiquement les meilleurs paramètres recommandés pour le modèle, y compris la longueur de contexte, la température, etc. Sinon, vous pouvez personnaliser ces indicateurs comme suit : | Option | Ce qu'elle fait | | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--model`, `-m` | Sélectionne un modèle. Sans cela, utilise le premier modèle signalé par Unsloth. | | `--api-key` | Fournit une clé API Unsloth. Vous pouvez aussi définir `UNSLOTH_API_KEY`. | | `--launch` / `--no-launch` | Lance l'agent ou affiche l'environnement et la commande générés. | | `--serve` / `--no-serve` | Autorise ou empêche le démarrage automatique du serveur local. | | `--gguf-variant` | Sélectionne une variante de quantification GGUF. | | `--reasoning` | Utilise le raisonnement dans le chat : activé, désactivé ou automatique. Automatique suit le modèle de chat du modèle, ce qui signifie généralement activé. | | `--reasoning-effort` | Niveau d'effort de raisonnement transmis au modèle via son modèle de chat, par exemple medium. Les niveaux dépendent du modèle, donc utilisez-en un que le modèle accepte. Non défini conserve celui du modèle de chat. | | `--context-length`, `--max-seq-length` | Définit la longueur de contexte demandée lors du chargement du modèle. | | `--load-in-4bit` / `--no-load-in-4bit` | Contrôle le chargement en 4 bits pour les modèles Hugging Face non GGUF. | | `--tensor-parallel` / `--no-tensor-parallel` | Active ou désactive le chargement GGUF en parallèle de tenseurs pour les systèmes multi-GPU. | | `--persist` / `--no-persist` | Conserve le répertoire personnel de l'agent géré par Unsloth lorsque cela s'applique. | | `--yolo` | Utilise le mode de confiance ou sans invite de l'agent sélectionné. | | `-h`, `--help` | Affiche l'aide de la commande. | Les options de chargement sont utilisées lorsque Unsloth doit charger ou réconcilier le modèle demandé. ### Transmettre les commandes normales à l'agent Les arguments qui ne sont pas des options Unsloth sont transmis à l'agent sélectionné : ```bash unsloth start claude --continue unsloth start codex --persist resume --last unsloth start opencode run --continue "Continue the previous task" unsloth start pi --persist --continue ``` Utilisez la commande d'aide de l'agent pour obtenir la liste complète de ses options natives. ### Sessions et `--persist` `--persist` conserve le stockage géré. Il ne reprend pas une conversation à lui seul ; transmettez également la commande normale de reprise de l'agent. | Agent | Avez-vous besoin de `--persist`? | Exemple de reprise | | ------------------ | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | Claude Code | Non. Claude utilise son stockage de session habituel. | `unsloth start claude --continue` | | OpenAI Codex | Oui. Son répertoire personnel Codex géré est temporaire par défaut. | `unsloth start codex --persist resume --last` | | OpenClaw | Oui. La configuration, l'espace de travail et les sessions gérés sont temporaires par défaut. | Utilisez `--persist` avec le même identifiant de session natif. | | OpenCode | Non. OpenCode utilise son stockage de session habituel. | `unsloth start opencode run --continue "Continue"` | | Agent Hermes | Oui. Son répertoire personnel Hermes géré est temporaire par défaut. | `unsloth start hermes --persist --continue --oneshot "Continue"` | | Agent de codage Pi | Oui. Son répertoire personnel Pi géré est temporaire par défaut. | `unsloth start pi --persist --continue` | Pour Codex, OpenClaw, Hermes et Pi, utilisez `--persist` dès le premier lancement et à nouveau lorsque vous revenez à la session. {% tabs %} {% tab title="Codex" %} ```bash unsloth start codex --persist unsloth start codex --persist resume --last ``` {% endtab %} {% tab title="OpenClaw" %} Utilisez un identifiant de session stable pour une session nommée : ```bash unsloth start openclaw --persist \\ agent --local --session-id my-session --message "Inspect this repository" unsloth start openclaw --persist \\ agent --local --session-id my-session --message "Continue" ``` {% endtab %} {% tab title="Agent Hermes" %} ```bash unsloth start hermes --persist --oneshot "Inspect this repository" unsloth start hermes --persist --continue --oneshot "Continue" ``` {% endtab %} {% tab title="Agent de codage Pi" %} ```bash unsloth start pi --persist --print "Inspect this repository" unsloth start pi --persist --continue --print "Continue" ``` {% endtab %} {% endtabs %} #### Afficher la commande de lancement sans l'exécuter ```bash unsloth start claude --no-launch ``` Cela affiche l'environnement et la commande générés. La sortie peut contenir des identifiants de connexion, alors ne la publiez pas dans des journaux ou des captures d'écran. ### Mode de contournement des autorisations `--yolo` correspond au mode de confiance ou sans invite de l'agent sélectionné. Il peut réduire les demandes d'approbation et permettre à l'agent d'exécuter des commandes sans demander d'abord. {% hint style="warning" %} Utilisez-le uniquement dans un environnement où des actions d'agent sans restriction sont acceptables. {% endhint %} #### Problèmes courants

Aucun serveur Unsloth n'a été trouvé

Lancez Unsloth et chargez un modèle, ou fournissez \`--model\` afin qu'Unsloth puisse démarrer un serveur local temporaire.

Codex ne se connecte pas

Utilisez un modèle GGUF exécuté via \`llama-server\`. L'intégration Codex actuelle n'utilise pas le backend transformers d'Unsloth.

Une session n'a pas été restaurée

Pour Codex, OpenClaw, Hermes et Pi, utilisez \`--persist\` au premier lancement et aux suivants, puis transmettez l'option native de reprise de l'agent.

--- # 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/unsloth-start.md?ask=&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.