> 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). # Coding Agents mit lokalen LLMs mit Unsloth Start ausführen Unsloth ermöglicht es Ihnen, zu verbinden [Claude Code](/docs/de/grundlagen/claude-code.md), [Codex](/docs/de/grundlagen/codex.md), Hermes, OpenCode und andere Coding-Agents mit einem lokalen Modell über die `unsloth start` Befehl. Der gesamte Workflow kann offline auf Ihrer eigenen Hardware ausgeführt werden. [Unsloth](/docs/de/desktop.md) Unsloth konfiguriert bei jedem Start automatisch den Endpunkt, den API-Schlüssel, den Anbieter, das Modell und die Kontextlänge, sodass Sie Ihren bevorzugten Agenten verwenden können, ohne diese zu ändern. Diese Anleitung zeigt Ihnen, wie Sie Modelle über die Befehlszeile für die Offline-Nutzung starten und mit Unsloth verbinden. {% columns %} {% column width="58.333333333333336%" %} ### Schnellstart Stellen Sie zuerst sicher, dass Sie [Unsloth installiert](/docs/de/neu/studio/install.md). Öffnen Sie dann Unsloth, laden Sie ein Modell, gehen Sie zu Ihrem Projektordner und führen Sie den Befehl im Terminal aus: ```bash unsloth start claude ``` Sie können `claude` durch einen beliebigen der folgenden Agenten 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 sitzungsgebundene Anbieter-Konfiguration. Es fügt den normalen Konfigurationsdateien des Agenten keinen Unsloth-Anbieter hinzu. {% hint style="info" %} Codex erfordert derzeit ein GGUF-Modell, das über den `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	Unsloth API

### Laden Sie ein Modell über die Befehlszeile

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.

Sie können 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, 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 medium ``` Das `:UD-Q4_K_XL` Suffix wählt die GGUF-Quantisierung aus. Wenn die Standard-Local-Adresse verwendet wird, ermöglicht das Übergeben von `--model` es, `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. Unten finden Sie 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 Legen Sie die Unsloth-URL und den API-Schlüssel fest, bevor Sie einen Agenten starten: ```bash export UNSLOTH_STUDIO_URL=https://studio.example.com export UNSLOTH_API_KEY=sk-unsloth-... unsloth start claude ``` Sie können den Schlüssel auch mit `--api-key`. Bei einem verifizierten lokalen Unsloth-Server `unsloth start` erstellt oder verwendet automatisch den API-Schlüssel erneut. ### Flags + Optionen Wenn keine Einstellungs-/Sampling-Flags gesetzt sind, wählt Unsloth automatisch die besten/empfohlenen Einstellungen für das Modell, einschließlich Kontextlänge, Temperatur usw. Andernfalls können Sie diese Flags entsprechend anpassen: | Option | Was es bewirkt | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--model`, `-m` | Wählen Sie ein Modell aus. Andernfalls wird das erste von Unsloth gemeldete Modell verwendet. | | `--api-key` | Geben Sie einen Unsloth-API-Schlüssel an. Sie können auch `UNSLOTH_API_KEY`. | | `--launch` / `--no-launch` | Starten Sie den Agenten oder geben Sie die erzeugte Umgebung und den Befehl aus. | | `--serve` / `--no-serve` | Das automatische Starten eines lokalen Servers zulassen oder verhindern. | | `--gguf-variant` | Wählen Sie eine GGUF-Quantisierungsvariante aus. | | `--reasoning` | Verwenden Sie Reasoning im Chat: ein, aus oder auto. Auto folgt der Chatvorlage des Modells, was normalerweise ein bedeutet. | | `--reasoning-effort` | Der an die Chatvorlage des Modells übergebene Reasoning-Aufwand, z. B. medium. Die Stufen sind modellabhängig, verwenden Sie also eine, die das Modell akzeptiert. Wenn nicht gesetzt, bleibt die Vorlageeigene Einstellung erhalten. | | `--context-length`, `--max-seq-length` | Legen Sie die angeforderte Kontextlänge beim Laden des Modells fest. | | `--load-in-4bit` / `--no-load-in-4bit` | Steuern Sie das 4-Bit-Laden für Nicht-GGUF-Hugging-Face-Modelle. | | `--tensor-parallel` / `--no-tensor-parallel` | Aktivieren oder deaktivieren Sie das tensorparallele GGUF-Laden für Multi-GPU-Systeme. | | `--persist` / `--no-persist` | Behalten Sie den von Unsloth verwalteten Agent-Home-Ordner bei, wo zutreffend. | | `--yolo` | Verwenden Sie den Nicht-Prompting- oder Vertrauensmodus des ausgewählten Agenten. | | `-h`, `--help` | Befehlshilfe anzeigen. | 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 ``` Verwenden Sie den Hilfe-Befehl des Agenten für die vollständige Liste seiner nativen Optionen. ### Sitzungen und `--persist` `--persist` behält verwalteten Speicher bei. Es setzt eine Unterhaltung nicht von selbst fort; übergeben Sie außerdem den normalen Fortsetzungsbefehl des Agenten. | Agent | Benötigen Sie `--persist`? | Fortsetzungsbeispiel | | --------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | Claude Code | Nein. Claude verwendet seinen normalen Sitzungsspeicher. | `unsloth start claude --continue` | | OpenAI Codex | Ja. Sein verwalteter Codex-Home-Ordner 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. | Verwenden Sie `--persist` mit derselben nativen Sitzungs-ID. | | OpenCode | Nein. OpenCode verwendet seinen normalen Sitzungsspeicher. | `unsloth start opencode run --continue "Continue"` | | Hermes Agent | Ja. Sein verwalteter Hermes-Home-Ordner ist standardmäßig temporär. | `unsloth start hermes --persist --continue --oneshot "Continue"` | | Pi-Coding-Agent | Ja. Sein verwalteter Pi-Home-Ordner ist standardmäßig temporär. | `unsloth start pi --persist --continue` | Für Codex, OpenClaw, Hermes und Pi verwenden Sie `--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" %} Verwenden Sie eine stabile Sitzungs-ID für eine benannte Sitzung: ```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="Hermes Agent" %} ```bash unsloth start hermes --persist --oneshot "Inspect this repository" unsloth start hermes --persist --continue --oneshot "Continue" ``` {% endtab %} {% tab title="Pi-Coding-Agent" %} ```bash unsloth start pi --persist --print "Inspect this repository" unsloth start pi --persist --continue --print "Continue" ``` {% 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 Verbindungsdaten enthalten, veröffentlichen Sie sie also nicht in Protokollen oder Screenshots. ### Berechtigungsumgehungsmodus `--yolo` entspricht dem Vertrauens- oder Nicht-Prompting-Modus des ausgewählten Agenten. Er kann Genehmigungsabfragen reduzieren und dem Agenten erlauben, Befehle auszuführen, ohne vorher zu fragen. {% hint style="warning" %} Verwenden Sie ihn nur in einer Umgebung, in der uneingeschränkte Agentenaktionen akzeptabel sind. {% endhint %} #### Häufige Probleme

Es wurde kein Unsloth-Server gefunden

Starten Sie Unsloth und laden Sie ein Modell, oder übergeben Sie \`--model\`, damit Unsloth einen temporären lokalen Server starten kann.

Codex verbindet sich nicht

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

Eine Sitzung wurde nicht wiederhergestellt

Für Codex, OpenClaw, Hermes und Pi verwenden Sie \`--persist\` beim ersten und bei späteren Starts und übergeben Sie 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 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=&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.