> 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 dir, 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 den `unsloth start` Befehl zu verbinden. Der gesamte Workflow kann offline auf deiner eigenen Hardware ausgeführt werden. [Unsloth](/docs/de/desktop.md) konfiguriert automatisch bei jedem Start den Endpunkt, den API-Schlüssel, den Provider, das Modell und die Kontextlänge, sodass du deinen bevorzugten Agenten verwenden kannst, ohne sie zu ändern. Diese Anleitung zeigt dir, wie du Modelle von der Kommandozeile aus für die Offline-Nutzung 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 jeden beliebigen Agenten unten ersetzen: {% endcolumn %} {% column width="41.666666666666664%" %}

{% endcolumn %} {% endcolumns %} | Agent | Befehl | | ------------------------------------------------------------------ | ------------------------ | | 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` | | Hermes Agent | `unsloth start hermes` | | OpenClaw | `unsloth start openclaw` | | Pi Agent | `unsloth start pi` | Unsloth verwendet temporäre oder sitzungsgebundene Provider-Konfiguration. Es fügt den normalen Konfigurationsdateien des Agents keinen Unsloth-Provider hinzu. ### Agentenanleitungen

Titel	Titelbild
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
Hermes Agent	images.jpeg	Hermes Agent
OpenClaw	openclaw-hero-light.png	OpenClaw
OpenCode	opencodelogo.png	OpenCode

### Lade ein Modell von der Kommandozeile

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.

Du kannst beim Starten des Agenten ein Modell auswählen und laden: {% hint style="success" %} Wenn keine Einstellungen-/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 medium ``` Der `:UD-Q4_K_XL` -Suffix wählt die GGUF-Quantisierung aus. Wenn die Standard-Lokaladresse verwendet wird, ermöglicht `--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. 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 %} ### Verbinde dich mit einem entfernten Unsloth-Server 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 den API-Schlüssel. #### Unsloth in VS Code verwenden Verbinde ein lokales Modell mit dem Copilot Chat von VS Code. Erfordert die GitHub-Copilot-Chat-Erweiterung; kein Copilot-Plan nötig. ```bash # Verbinde das Modell, das Unsloth bereits bereitstellt unsloth start vscode # Oder lade ein Modell mit 32K Kontext für den Agent-Modus unsloth start vscode unsloth/Qwen3.5-4B-GGUF:UD-Q4_K_XL --context-length 32768 ``` Öffne Copilot Chat und wähle dein Modell unter **Unsloth**. Wenn es fehlt, überprüfe **Modelle verwalten** oder führe **Entwickler: Fenster neu laden**. Der Agent-Modus benötigt Tool-Calling-Unterstützung und mindestens **32K Kontext**. Verwende den Ask-Modus für Modelle ohne Tool-Calling. Der Befehl sichert deine VS-Code-Konfiguration und behält andere Modelle bei. Nachdem du die Modelle gewechselt hast, führe `unsloth start vscode` erneut aus, um seinen Eintrag zu aktualisieren. **Remote-Server:** In einer SSH- oder Container-Sitzung ohne VS-Code-Benutzerverzeichnis gibt der Befehl die Konfiguration aus, die lokal hinzugefügt werden soll, sowie Anweisungen für die Verbindung oder das Port-Forwarding. Verwende ein lokales VS-Code-Fenster, wenn das Modell im Modell-Auswahlmenü des entfernten Workspaces fehlt. ### Flags + Optionen Wenn keine Einstellungen-/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 bewirkt | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--model`, `-m` | Wählt ein Modell aus. Ohne dieses wird das von Unsloth gemeldete erste Modell verwendet. | | `--api-key` | Stelle einen Unsloth-API-Schlüssel bereit. 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 eines lokalen Servers. | | `--gguf-variant` | Wähle eine GGUF-Quantisierungsvariante aus. | | `--reasoning` | Verwende Reasoning im Chat: on, off oder auto. Auto folgt der Chat-Vorlage des Modells, was normalerweise on bedeutet. | | `--reasoning-effort` | Reasoning-Aufwand, der an die Chat-Vorlage des Modells übergeben wird, z. B. medium. Die Stufen sind je nach Modell unterschiedlich, also verwende eine, die das Modell akzeptiert. Wenn nicht gesetzt, bleibt die eigene Vorlage erhalten. | | `--context-length`, `--max-seq-length` | Setzt beim Laden des Modells die angeforderte Kontextlänge. | | `--load-in-4bit` / `--no-load-in-4bit` | Steuert das 4-Bit-Laden für nicht-GGUF-Hugging-Face-Modelle. | | `--tensor-parallel` / `--no-tensor-parallel` | Aktiviert oder deaktiviert das tensorparallele Laden von GGUF für Multi-GPU-Systeme. | | `--persist` / `--no-persist` | Behält den von Unsloth verwalteten Agenten-Home-Bereich bei, sofern zutreffend. | | `--yolo` | Verwendet den Nicht-Prompting- oder Vertrauensmodus des ausgewählten Agenten. | | `-h`, `--help` | Zeigt 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 "Setze die vorherige Aufgabe fort" unsloth start pi --persist --continue ``` Verwende den eigenen Hilfe-Befehl des Agenten für seine vollständige Liste nativer Optionen. ### Sitzungen und `--persist` `--persist` behält verwalteten Speicher bei. Es setzt eine Konversation nicht von selbst fort; übergib auch den normalen Fortsetzen-Befehl des Agenten. | Agent | Brauchst du `--persist`? | Beispiel zum Fortsetzen | | --------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | 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. Verwaltete Konfiguration, Arbeitsbereich und 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` 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 "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 generierte Umgebung und den Befehl aus. Die Ausgabe kann Verbindungsdaten enthalten, daher solltest du sie nicht in Logs oder Screenshots veröffentlichen. ### Modus zum Umgehen von Berechtigungen `--yolo` entspricht dem Vertrauens- oder Nicht-Prompting-Modus des ausgewählten Agents. 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 Agent-Aktionen akzeptabel sind. {% endhint %} #### Häufige Probleme

Es wurde 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 das Unsloth-Transformers-Backend nicht.

Eine Sitzung wurde nicht wiederhergestellt

Für Codex, OpenClaw, Hermes und Pi verwende bei den ersten und späteren Starts \`--persist\` und übergib dann die native Fortsetzen-Option des Agents.

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