> 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/desktop/unsloth-start.md). # Agenten mit Unsloth verbinden Unsloth ermöglicht dir, dich zu verbinden [Claude Code](/docs/de/grundlagen/api/claude-code.md), [Codex](/docs/de/grundlagen/api/codex.md), Hermes, OpenCode und andere Coding-Agenten mit einem lokalen Modell über den `unsloth start` Befehl. Der gesamte Workflow kann offline auf deiner eigenen Hardware ausgeführt werden. [Unsloth](/docs/de/desktop.md) konfiguriert automatisch den Endpunkt, den API-Schlüssel, den Provider, das Modell und die Kontextlänge für jeden Start, sodass du deinen bevorzugten Agenten verwenden kannst, ohne ihn zu ändern. Diese Anleitung zeigt dir, wie du Modelle über die Kommandozeile für die Offline-Nutzung startest und dich mit Unsloth verbindest. {% columns %} {% column width="58.333333333333336%" %} ### Schnellstart Zuerst stelle sicher, dass du [Unsloth installiert hast](/docs/de/loslegen/install/install.md). Dann öffne Unsloth, lade ein Modell, gehe in deinen Projektordner und führe den Befehl im Terminal aus: ```bash unsloth start claude ``` Du kannst `claude` durch jeden Agenten unten ersetzen: {% endcolumn %} {% column width="41.666666666666664%" %}

{% endcolumn %} {% endcolumns %} | Agent | Befehl | | ------------------------------------------------------------------ | ------------------------ | | Claude Code | `unsloth start claude` | | OpenAI Codex | `unsloth start codex` | | DeepSeek Harness | `unsloth start dsh` | | OpenCode | `unsloth start opencode` | | Hermes Agent | `unsloth start hermes` | | OpenClaw | `unsloth start openclaw` | | Pi-Agent | `unsloth start pi` | Unsloth verwendet eine temporäre oder sitzungsbezogene Provider-Konfiguration. Es fügt den normalen Konfigurationsdateien des Agenten keinen Unsloth-Provider hinzu. {% hint style="info" %} Codex erfordert derzeit ein GGUF-Modell, das über das `llama-server` Backend bereitgestellt wird. {% endhint %} ### Agenten-Anleitungen

Titel	Titelbild
Claude Code	claude-code.webp	Claude Code
Codex	codex only logo.png	OpenAI Codex
Hermes Agent	images.jpeg	Hermes Agent
OpenClaw	openclaw-hero-light.png	OpenClaw
OpenCode	opencodelogo.png	OpenCode
Unsloth API	unsloth api long logo.png	Wie man Unsloth als API-Endpunkt verwendet

### Ein Modell über die Kommandozeile laden

unsloth start launching Codex with a local GGUF model in Unsloth Studio — Unsloth start findet oder lädt das Modell, konfiguriert den Coding-Agenten und startet ihn aus dem aktuellen Projekt heraus.

Du kannst beim Starten des Agenten ein Modell auswählen und laden: {% hint style="success" %} Wenn keine Einstellungs-/Sampling-Flags gesetzt sind, wählt Unsloth automatisch die besten/empfohlenen Einstellungen für das Modell aus, einschließlich Kontextlänge, Temperatur usw. {% 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 mittel ``` Der `:UD-Q4_K_XL` Suffix wählt die GGUF-Quantisierung aus. An der standardmäßigen lokalen Adresse ermöglicht das Übergeben von `--model` er `unsloth start` einen temporären Server zu starten, 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 es weiterlaufen. Siehe unten Beispiele dafür, wie Agenten mit einem lokalen LLM verbunden werden: {% columns %} {% column width="50%" %}

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

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

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

{% endcolumn %} {% column %}

{% 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`. Für einen verifizierten lokalen Unsloth-Server, `unsloth start` erstellt oder verwendet den API-Schlüssel automatisch erneut. ### Flags + Optionen Wenn keine Einstellungs-/Sampling-Flags gesetzt sind, wählt Unsloth automatisch die besten/empfohlenen Einstellungen für das Modell aus, einschließlich Kontextlänge, Temperatur usw. Andernfalls kannst du diese Flags entsprechend anpassen: | Option | Was es tut | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--model`, `-m` | Wähle ein Modell aus. Ohne es wird das von Unsloth zuerst 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 erzeugte 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. | | `--reasoning` | Nutze Reasoning im Chat: ein, aus oder automatisch. Automatisch folgt der Chatvorlage des Modells, was normalerweise bedeutet: ein. | | `--reasoning-effort` | Reasoning-Aufwand, der an die Chatvorlage des Modells übergeben wird, z. B. mittel. Die Stufen sind modellabhängig, also verwende eine, die das Modell akzeptiert. Wenn nicht gesetzt, bleibt die des Templates erhalten. | | `--context-length`, `--max-seq-length` | Setze beim Laden des Modells die angeforderte Kontextlänge. | | `--load-in-4bit` / `--no-load-in-4bit` | Steuere das Laden in 4 Bit für Hugging-Face-Modelle ohne GGUF. | | `--tensor-parallel` / `--no-tensor-parallel` | Aktiviere oder deaktiviere das GGUF-Laden mit Tensorparallelität für Multi-GPU-Systeme. | | `--persist` / `--no-persist` | Behalte, wo zutreffend, das von Unsloth verwaltete Agenten-Home 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 übergeben: ```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 Hilfe-Befehl des Agenten selbst für seine vollständige Liste nativer Optionen. ### Sitzungen und `--persist` `--persist` verwaltet Speicher. Es setzt eine Unterhaltung nicht von selbst fort; übergebe außerdem den normalen Fortsetzungsbefehl des Agenten. | Agent | Brauchst du `--persist`? | Fortsetzungsbeispiel | | --------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | Claude Code | Nein. Claude verwendet seinen normalen Sitzungs-Speicher. | `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 Sitzungs-Speicher. | `unsloth start opencode run --continue "Fortsetzen"` | | Hermes Agent | Ja. Das verwaltete Hermes-Home ist standardmäßig temporär. | `unsloth start hermes --persist --continue --oneshot "Fortsetzen"` | | 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` beim ersten Start und erneut beim Zurückkehren zur Sitzung. {% tabs %} {% tab title="Codex" %} ```bash unsloth start codex --persist unsloth start codex --persist resume --last ``` {% endtab %} {% tab title="OpenClaw" %} Verwende für eine benannte Sitzung eine stabile Sitzungs-ID: ```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 "Fortsetzen" ``` {% 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 erzeugte Umgebung und den Befehl aus. Die Ausgabe kann Verbindungsanmeldedaten enthalten, also veröffentliche sie nicht in Protokollen oder Screenshots. ### Modus zur Umgehung von Berechtigungen `--yolo` entspricht dem Trust- oder Nicht-Prompting-Modus des ausgewählten Agenten. Er kann Bestätigungsaufforderungen 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

Kein Unsloth-Server gefunden

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

Codex verbindet sich nicht

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

Eine Sitzung wurde nicht wiederhergestellt

Für Codex, OpenClaw, Hermes und Pi verwende \`--persist\` beim ersten und bei späteren Starts, und übergebe dann die native Fortsetzungsoption des Agenten.

--- # 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/de/desktop/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.