> 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/de/integrationen/unsloth-start.md).

# Führe Coding-Agents mit lokalen LLMs mit Unsloth Start aus

Mit Unsloth kannst du verbinden [Claude Code](/docs/de/grundlagen/claude-code.md), [Codex](/docs/de/grundlagen/codex.md), Hermes, OpenCode, Pi und andere Coding-Agents über das `unsloth start` Befehl mit einem lokalen Modell verbinden. Der gesamte Workflow kann offline auf deiner eigenen Hardware ausgeführt werden. [Unsloth](/docs/de/desktop.md) konfiguriert bei jedem Start automatisch den Endpunkt, den API-Schlüssel, den Provider, das Modell und die Kontextlänge, sodass du deinen bevorzugten Agenten verwenden kannst, ohne ihn anzupassen. Diese Anleitung zeigt dir, wie du Modelle für die Offline-Nutzung über die Kommandozeile startest und mit Unsloth verbindest.

{% columns %}
{% column width="58.333333333333336%" %}

### Schnellstart

Stelle zuerst sicher, dass du [Unsloth installiert hast](/docs/de/neu/studio/install.md). Öffne dann Unsloth, lade ein Modell, gehe zu deinem Projektordner und führe den Befehl im Terminal aus:

```bash
unsloth start claude
```

Du kannst `claude` durch einen der folgenden Agenten ersetzen:
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/71dc8d04c5322ed18a0af5f03d72f1ec3f286b24" alt=""><figcaption><p>Claude Code, der mit Qwen3.5 lokal ausgeführt wird.</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

| Agent                                                              | Befehl                   |
| ------------------------------------------------------------------ | ------------------------ |
| <i class="fa-claude">:claude:</i> Claude Code                      | `unsloth start claude`   |
| <i class="fa-openai">:openai:</i> OpenAI Codex                     | `unsloth start codex`    |
| <i class="fa-caduceus">:caduceus:</i> Hermes Agent                 | `unsloth start hermes`   |
| <i class="fa-lobster">:lobster:</i> OpenClaw                       | `unsloth start openclaw` |
| <i class="fa-rectangle-vertical">:rectangle-vertical:</i> OpenCode | `unsloth start opencode` |

Unsloth verwendet eine temporäre oder sitzungsspezifische Provider-Konfiguration. Es fügt den normalen Konfigurationsdateien des Agenten keinen Unsloth-Provider hinzu.

{% hint style="info" %}
Codex benötigt derzeit ein GGUF-Modell, das über den `llama-server` Backend bereitgestellt wird.
{% endhint %}

### Agenten-Anleitungen

<table data-column-title-hidden data-view="cards"><thead><tr><th>Titel</th><th data-hidden data-card-cover data-type="image">Titelbild</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Claude Code</td><td><a href="/files/e6f52960cc69f570bc1f297599bbcca5f7d0f8ae">/files/e6f52960cc69f570bc1f297599bbcca5f7d0f8ae</a></td><td><a href="/pages/d12c953ceacbd6c3e44f3aa911056928e0488f5b">/pages/d12c953ceacbd6c3e44f3aa911056928e0488f5b</a></td></tr><tr><td>Codex</td><td><a href="/files/937399f1d3f970847137c52900badbb6762c2691">/files/937399f1d3f970847137c52900badbb6762c2691</a></td><td><a href="/pages/1813c928d883d651dff92062bc0da6e96d06e50a">/pages/1813c928d883d651dff92062bc0da6e96d06e50a</a></td></tr><tr><td>Hermes Agent</td><td><a href="/files/c657d20cf97af323f211418287519a0f2970c992">/files/c657d20cf97af323f211418287519a0f2970c992</a></td><td><a href="/pages/d063f905fd9c48e1a14e204b6afea83a23b390f3">/pages/d063f905fd9c48e1a14e204b6afea83a23b390f3</a></td></tr><tr><td>OpenClaw</td><td><a href="/files/d4875b28e1e68f2cfaa9f24a6ef53f552e41a3ca">/files/d4875b28e1e68f2cfaa9f24a6ef53f552e41a3ca</a></td><td><a href="/pages/4ad33e7ce59bb7203a1fddd7e6e0102f70c191db">/pages/4ad33e7ce59bb7203a1fddd7e6e0102f70c191db</a></td></tr><tr><td>OpenCode</td><td><a href="/files/37c9fc5c8badec4f97706d6b4fbd4ae8b451dd13">/files/37c9fc5c8badec4f97706d6b4fbd4ae8b451dd13</a></td><td><a href="/pages/69edb30cadb1e5ecada5bd2a700b63f49e94955f">/pages/69edb30cadb1e5ecada5bd2a700b63f49e94955f</a></td></tr><tr><td>Unsloth API</td><td><a href="/files/1cd126b6bc3f32688a987931c1d54a4680278773">/files/1cd126b6bc3f32688a987931c1d54a4680278773</a></td><td><a href="/pages/70002e65495a1a44f155c9dabf1fb52b9d84de66">/pages/70002e65495a1a44f155c9dabf1fb52b9d84de66</a></td></tr></tbody></table>

### Ein Modell über die Kommandozeile laden

<div align="center"><figure><img src="/files/a58131574fd12c41c78f09872824953811233cee" alt="unsloth start launching Codex with a local GGUF model in Unsloth Studio" width="563"><figcaption><p>Unsloth start findet oder lädt das Modell, konfiguriert den Coding-Agenten und startet ihn aus dem aktuellen Projekt.</p></figcaption></figure></div>

Du kannst beim Starten des Agenten ein Modell auswählen und laden:

{% tabs %}
{% tab title="Mit Quant-Suffix" %}

```bash
unsloth start codex \\
  --model unsloth/gemma-4-E2B-it-GGUF:UD-Q4_K_XL \\
  --context-length 32768
```

Das `:UD-Q4_K_XL` Suffix wählt die GGUF-Quantisierung aus.
{% endtab %}

{% tab title="Mit `--gguf-variant`" %}

```bash
unsloth start codex \\
  --model unsloth/gemma-4-E2B-it-GGUF \\
  --gguf-variant UD-Q4_K_XL \\
  --context-length 32768
```

Ein explizites `--gguf-variant` überschreibt die hinter dem Modellnamen geschriebene Quantisierung.
{% endtab %}
{% endtabs %}

An der standardmäßigen lokalen Adresse ermöglicht das Übergeben von `--model` das `unsloth start` Starten eines temporären Servers, wenn Unsloth Studio noch nicht läuft. Der temporäre Server stoppt, wenn der Agent beendet wird. Wenn Unsloth bereits läuft, verbindet sich der Befehl damit und lässt ihn weiterlaufen.

Siehe unten für Beispiele, wie Agenten mit einem lokalen LLM verbunden werden:

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

<div align="left"><figure><img src="/files/1872a1db8c64d8df24e89c0ab44fbb215da1f42c" alt=""><figcaption><p>OpenCode</p></figcaption></figure></div>
{% endcolumn %}

{% column width="50%" %}

<div align="left"><figure><img src="/files/36bec668bc6680b779433a963258458e7d94219a" alt=""><figcaption><p>Hermes</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

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

<figure><img src="/files/3a0f834122612aeac86f29c59b2fe4605a558b2f" alt=""><figcaption><p>Claude Code</p></figcaption></figure>
{% endcolumn %}

{% column width="33.33333333333333%" %}

<figure><img src="/files/48389f981365751eabedd2dbfa5ead417ff39e09" alt=""><figcaption><p>Codex</p></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/aad4d3350bb31884ab91335c264b5c9aacdcaddc" alt=""><figcaption><p>Openclaw</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Mit einem entfernten Unsloth-Server verbinden

Setze die Unsloth-URL und den API-Schlüssel, bevor du einen Agenten startest:

```bash
export UNSLOTH_STUDIO_URL=https://studio.example.com
export UNSLOTH_API_KEY=sk-unsloth-...
unsloth start claude
```

Du kannst den Schlüssel auch mit `--api-key`übergeben. Für einen verifizierten lokalen Unsloth-Server `unsloth start` erstellt oder verwendet automatisch denselben API-Schlüssel.

### Optionen

| Option                                       | Was es bewirkt                                                                           |
| -------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `--model`, `-m`                              | Wähle ein Modell aus. Ohne Angabe wird das erste von Unsloth gemeldete Modell verwendet. |
| `--api-key`                                  | Gib einen Unsloth-API-Schlüssel an. Du kannst auch `UNSLOTH_API_KEY`.                    |
| `--launch` / `--no-launch`                   | Starte den Agenten oder gib die generierte Umgebung und den Befehl aus.                  |
| `--serve` / `--no-serve`                     | Erlaube oder verhindere den automatischen Start des lokalen Servers.                     |
| `--gguf-variant`                             | Wähle eine GGUF-Quantisierungsvariante aus.                                              |
| `--context-length`, `--max-seq-length`       | Lege die angeforderte Kontextlänge beim Laden des Modells fest.                          |
| `--load-in-4bit` / `--no-load-in-4bit`       | Steuere das Laden in 4 Bit für nicht-GGUF-Hugging-Face-Modelle.                          |
| `--tensor-parallel` / `--no-tensor-parallel` | Aktiviere oder deaktiviere das tensorparallele GGUF-Laden für Multi-GPU-Systeme.         |
| `--persist` / `--no-persist`                 | Behalte das vom Unsloth verwaltete Agenten-Home, sofern zutreffend, bei.                 |
| `--yolo`                                     | Verwende den Nicht-Prompting- oder Vertrauensmodus des ausgewählten Agenten.             |
| `-h`, `--help`                               | Zeige die Hilfe zum Befehl an.                                                           |

Ladeoptionen werden verwendet, wenn Unsloth das angeforderte Modell laden oder abgleichen muss.

### Normale Befehle an den Agenten übergeben

Argumente, die keine Unsloth-Optionen sind, werden an den ausgewählten Agenten weitergegeben:

```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
```

Verwende den eigenen Hilfebefehl des Agenten für seine vollständige Liste nativer Optionen.

### Sitzungen und `--persist`

`--persist` behält verwalteten Speicher bei. Es setzt eine Unterhaltung nicht von selbst fort; gib außerdem den normalen Fortsetzungsbefehl des Agenten an.

| Agent           | Brauchst du `--persist`?                                                                            | Beispiel für Fortsetzen                                          |
| --------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Claude Code     | Nein. Claude verwendet seinen normalen Sitzungsspeicher.                                            | `unsloth start claude --continue`                                |
| OpenAI Codex    | Ja. Das verwaltete Codex-Home ist standardmäßig temporär.                                           | `unsloth start codex --persist resume --last`                    |
| OpenClaw        | Ja. Die verwaltete Konfiguration, der Arbeitsbereich und die Sitzungen sind standardmäßig temporär. | Verwende `--persist` mit derselben nativen Sitzungs-ID.          |
| OpenCode        | Nein. OpenCode verwendet seinen normalen Sitzungsspeicher.                                          | `unsloth start opencode run --continue "Continue"`               |
| Hermes Agent    | Ja. Das verwaltete Hermes-Home ist standardmäßig temporär.                                          | `unsloth start hermes --persist --continue --oneshot "Continue"` |
| Pi-Coding-Agent | Ja. Das verwaltete Pi-Home ist standardmäßig temporär.                                              | `unsloth start pi --persist --continue`                          |

Für Codex, OpenClaw, Hermes und Pi verwende `--persist` vom ersten Start an und erneut, wenn du zur Sitzung zurückkehrst.

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

```bash
unsloth start codex --persist
unsloth start codex --persist resume --last
```

{% endtab %}

{% tab title="OpenClaw" %}
Verwende eine stabile Sitzungs-ID für eine benannte Sitzung:

```bash
unsloth start openclaw --persist \\
  agent --local --session-id my-session --message "Untersuche dieses Repository"

unsloth start openclaw --persist \\
  agent --local --session-id my-session --message "Fortsetzen"
```

{% endtab %}

{% tab title="Hermes Agent" %}

```bash
unsloth start hermes --persist --oneshot "Untersuche dieses Repository"
unsloth start hermes --persist --continue --oneshot "Continue"
```

{% endtab %}

{% tab title="Pi-Coding-Agent" %}

```bash
unsloth start pi --persist --print "Untersuche dieses Repository"
unsloth start pi --persist --continue --print "Fortsetzen"
```

{% endtab %}
{% endtabs %}

#### Den Startbefehl ausgeben, ohne ihn auszuführen

```bash
unsloth start claude --no-launch
```

Dies gibt die generierte Umgebung und den Befehl aus. Die Ausgabe kann Verbindungsdaten enthalten, also veröffentliche sie nicht in Protokollen oder Screenshots.

### Modus zum Umgehen von Berechtigungen

`--yolo` entspricht dem Vertrauens- oder Nicht-Prompting-Modus des ausgewählten Agenten. Er kann Bestätigungsabfragen reduzieren und dem Agenten erlauben, Befehle auszuführen, ohne vorher zu fragen.

{% hint style="warning" %}
Verwende ihn nur in einer Umgebung, in der uneingeschränkte Agentenaktionen akzeptabel sind.
{% endhint %}

#### Häufige Probleme

<details>

<summary>Kein Unsloth-Server gefunden</summary>

Starte Unsloth und lade ein Modell oder übergib \`--model\`, damit Unsloth einen temporären lokalen Server starten kann.

</details>

<details>

<summary>Codex verbindet sich nicht</summary>

Verwende ein GGUF-Modell, das über \`llama-server\` läuft. Die aktuelle Codex-Integration verwendet nicht das Unsloth-Transformers-Backend.

</details>

<details>

<summary>Eine Sitzung wurde nicht wiederhergestellt</summary>

Verwende für Codex, OpenClaw, Hermes und Pi bei den ersten und späteren Starts \`--persist\` und übergib dann die native Fortsetzungsoption des Agenten.

</details>


---

# 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/de/integrationen/unsloth-start.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.