> 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écutez des agents de codage avec des LLM locaux à l'aide d'Unsloth Start
Unsloth vous permet de connecter [Claude Code](/docs/fr/bases/claude-code.md), [Codex](/docs/fr/bases/codex.md), Hermes, OpenCode, Pi et d’autres agents de codage à un modèle local via la `unsloth start` commande. L’ensemble du flux de travail peut fonctionner hors ligne sur votre propre matériel. [Unsloth](/docs/fr/desktop.md) configure automatiquement le point de terminaison, la clé API, le fournisseur, le modèle et la longueur de contexte pour 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). Puis ouvrez 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: Claude Code | `unsloth start claude` |
| :openai: OpenAI Codex | `unsloth start codex` |
| :caduceus: Agent Hermes | `unsloth start hermes` |
| :lobster: OpenClaw | `unsloth start openclaw` |
| :rectangle-vertical: OpenCode | `unsloth start opencode` |
Unsloth utilise une configuration de fournisseur temporaire ou limitée à la session. Il n’ajoute pas de fournisseur Unsloth aux fichiers de configuration normaux de l’agent.
{% hint style="info" %}
Codex nécessite actuellement un modèle GGUF servi via le `llama-server` backend.
{% endhint %}
### Guides des agents
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 :
{% tabs %}
{% tab title="Avec le suffixe de quantification" %}
```bash
unsloth start codex \\
--model unsloth/gemma-4-E2B-it-GGUF:UD-Q4_K_XL \\
--context-length 32768
```
Le `:UD-Q4_K_XL` suffixe sélectionne la quantification GGUF.
{% endtab %}
{% tab title="Avec `--gguf-variant`" %}
```bash
unsloth start codex \\
--model unsloth/gemma-4-E2B-it-GGUF \\
--gguf-variant UD-Q4_K_XL \\
--context-length 32768
```
Un `--gguf-variant` explicite remplace la quantification écrite après le nom du modèle.
{% endtab %}
{% endtabs %}
Sur l’adresse locale par défaut, le fait de passer `--model` permet de `unsloth start` 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 quitte. Si Unsloth est déjà en cours d’exécution, la commande s’y connecte et le laisse en fonctionnement.
Voir ci-dessous des exemples d’agents connectés à un LLM local :
{% columns %}
{% column width="50%" %}
{% 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 aussi passer la clé avec `--api-key`. Pour un serveur local Unsloth vérifié, `unsloth start` crée ou réutilise automatiquement la clé API.
### Options
| Option | Ce qu’elle fait |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `--model`, `-m` | Sélectionnez un modèle. Sans cela, utilisez le premier modèle signalé par Unsloth. |
| `--api-key` | Fournissez une clé API Unsloth. Vous pouvez également définir `UNSLOTH_API_KEY`. |
| `--launch` / `--no-launch` | Lancez l’agent ou affichez l’environnement et la commande générés. |
| `--serve` / `--no-serve` | Autorisez ou empêchez le démarrage automatique d’un serveur local. |
| `--gguf-variant` | Sélectionnez une variante de quantification GGUF. |
| `--context-length`, `--max-seq-length` | Définissez la longueur de contexte demandée lors du chargement du modèle. |
| `--load-in-4bit` / `--no-load-in-4bit` | Contrôlez le chargement en 4 bits pour les modèles Hugging Face non GGUF. |
| `--tensor-parallel` / `--no-tensor-parallel` | Activez ou désactivez le chargement GGUF en parallélisme de tenseurs pour les systèmes multi-GPU. |
| `--persist` / `--no-persist` | Conservez le répertoire personnel de l’agent géré par Unsloth lorsque cela s’applique. |
| `--yolo` | Utilisez le mode de confiance ou sans invite de l’agent sélectionné. |
| `-h`, `--help` | Afficher l’aide de la commande. |
Les options de chargement sont utilisées lorsque Unsloth doit charger ou réconcilier le modèle demandé.
### Transmettez des 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 "Continuer la tâche précédente"
unsloth start pi --persist --continue
```
Utilisez la commande d’aide propre à 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 tout seul ; passez aussi la commande de reprise normale de l’agent.
| Agent | Avez-vous besoin de `--persist`? | Exemple de reprise |
| ------------------ | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Claude Code | Non. Claude utilise son stockage de session normal. | `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 normal. | `unsloth start opencode run --continue "Continuer"` |
| Agent Hermes | Oui. Son répertoire personnel Hermes géré est temporaire par défaut. | `unsloth start hermes --persist --continue --oneshot "Continuer"` |
| 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 de 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 "Inspectez ce dépôt"
unsloth start openclaw --persist \\
agent --local --session-id my-session --message "Continuer"
```
{% endtab %}
{% tab title="Agent Hermes" %}
```bash
unsloth start hermes --persist --oneshot "Inspectez ce dépôt"
unsloth start hermes --persist --continue --oneshot "Continuer"
```
{% endtab %}
{% tab title="Agent de codage Pi" %}
```bash
unsloth start pi --persist --print "Inspectez ce dépôt"
unsloth start pi --persist --continue --print "Continuer"
```
{% 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, donc 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é. Cela 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é
Démarrez Unsloth et chargez un modèle, ou passez \`--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 actuelle de Codex n’utilise pas le backend transformers d’Unsloth.
Une session n’a pas été restaurée
Pour Codex, OpenClaw, Hermes et Pi, utilisez \`--persist\` lors du premier lancement et des lancements suivants, puis passez 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 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/unsloth-start.md?ask=&goal=
```
`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.