> 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/opencode.md).

# Wie man lokale KI-Modelle mit OpenCode ausführt

Diese Anleitung führt Sie durch das Verbinden **OpenCode** zu [Unsloth](https://github.com/unslothai/unsloth) offene LLMs auszuführen **vollständig lokal.** OpenCode ist ein **Open-Source-KI-Coding-Agent** der Code in Ihrem Projekt mit einem verbundenen Modell liest, verändert und ausführt. Das funktioniert mit jedem **lokalen Modell** bereitgestellt über Unsloths **OpenAI-kompatible API**, darunter: DeepSeek, Qwen, Gemma und mehr.

OpenCode fungiert als Client, während Unsloth Modelle über eine lokale API lädt und bereitstellt. Nach der Einrichtung verbindet sich OpenCode mit Unsloth, wo Sie ein geladenes Modell auswählen und es als **Coding-Agent**.

Diese Anleitung behandelt beide Einrichtungsoptionen:

* **OpenCode Desktop:** fügen Sie Unsloth Studio manuell als benutzerdefinierten OpenAI-kompatiblen Provider hinzu.
* **OpenCode CLI:** starten Sie es mit `unsloth start opencode` und verbinden Sie es automatisch mit Ihrem lokalen Modell.

<a href="https://unsloth.ai/docs/integrations/opencode#installing-opencode-desktop" class="button primary">OpenCode-Einrichtung</a><a href="/pages/69edb30cadb1e5ecada5bd2a700b63f49e94955f#quickstart" class="button primary">Schnellstart</a>

{% hint style="info" %}
In diesem Tutorial verwenden wir `unsloth/Qwen3.6-27B-GGUF` Es wird in Unsloth geladen, und Sie können direkt in OpenCode darauf zugreifen. Bevorzugen Sie ein anderes Modell? Ersetzen Sie es einfach durch ein anderes Modell, indem Sie es in Unsloth laden.
{% endhint %}

### OpenCode Desktop installieren

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

#### **Schritt 1: Laden Sie das OpenCode-Installationsprogramm für Mac herunter**

Öffnen Sie `opencode.ai/download` in Ihrem bevorzugten Browser. Scrollen Sie nach unten zu **OpenCode Desktop (Beta),** und klicken Sie auf die `Herunterladen` Schaltfläche neben dem macOS-Image-Namen, der der Architektur Ihres Macs entspricht (Apple Silicon oder Intel).

#### Schritt 2: Installieren Sie OpenCode

Suchen Sie die `OpenCode Desktop.dmg` Installationsdatei in Ihrem Downloads-Ordner und doppelklicken Sie darauf.

Das Installationsfenster wird geöffnet. Ziehen Sie mit der Maus das **OpenCode** App-Symbol auf das **Programme** Symbol, wie gezeigt.

#### Schritt 3: Starten Sie OpenCode

Suchen Sie die **OpenCode** Symbol unter dem **Programme** Ordner.

Das **OpenCode** Die Desktop-App wird geöffnet und ist nun bereit für Ihre nächste Aktion.

<div data-with-frame="true"><figure><img src="/files/99434848986700dc899ebe21c706ad3e04a2e9af" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Windows" %}

#### **Schritt 1: Laden Sie das OpenCode-Installationsprogramm für Windows herunter**

Öffnen Sie `opencode.ai/download` in Ihrem Browser. Scrollen Sie zu **OpenCode Desktop (Beta)**, und klicken Sie auf die **Herunterladen** Schaltfläche neben dem Windows-(x64)-Installationsprogramm.

#### **Schritt 2: Installieren Sie OpenCode**

suchen Sie die `OpenCode Desktop Installer.exe` in Ihrem Downloads-Ordner und doppelklicken Sie darauf. Anschließend können Sie den Anweisungen im Installationsfenster folgen, um die Installation abzuschließen.

#### **Schritt 3: Starten Sie OpenCode**

Öffnen Sie das Windows-Startmenü und suchen Sie nach **OpenCode**.\
\
Klicken Sie auf das OpenCode-App-Symbol, um es zu starten. Die OpenCode-Desktop-App wird geöffnet und ist nun bereit für Ihre nächste Aktion

<div data-with-frame="true"><figure><img src="/files/247452b383975ffbe975258d80e265f12aa83f5d" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Linux" %}

#### **Schritt 1: Laden Sie das OpenCode-Installationsprogramm für Linux herunter**

Gehe zu `opencode.ai/download` mit Ihrem bevorzugten Webbrowser. Suchen Sie den **OpenCode Desktop (Beta)** Abschnitt und wählen Sie dann die Linux-Download-Option für Ihr System.

#### **Schritt 2: Installieren Sie OpenCode**

Öffnen Sie Ihren Downloads-Ordner und suchen Sie das **OpenCode** Installationsprogramm, das Sie gerade heruntergeladen haben.

Klicken Sie bei einem AppImage-Download mit der rechten Maustaste auf die Datei und öffnen Sie **Eigenschaften**, und aktivieren Sie die Option, die es der Datei erlaubt, als Programm ausgeführt zu werden. Doppelklicken Sie dann auf das AppImage, um **OpenCode**.

Oder führen Sie, wenn Sie lieber das Terminal verwenden, Folgendes aus:

```
chmod +x OpenCode*.AppImage
./OpenCode*.AppImage
```

Wenn Sie eine `.deb` -Datei heruntergeladen haben, installieren Sie sie mit:

```
sudo apt install ./OpenCode*.deb
```

Wenn Sie eine `.rpm` -Datei heruntergeladen haben, installieren Sie sie mit:

```
sudo dnf install ./OpenCode*.rpm
```

#### **Schritt 3: Starten Sie OpenCode**

Öffnen Sie Ihren Linux-Anwendungsstarter und suchen Sie nach **OpenCode**.

Klicken Sie auf das OpenCode-App-Symbol, um es zu starten. Die OpenCode-Desktop-App wird geöffnet und ist nun bereit für Ihre nächste Aktion.
{% endtab %}
{% endtabs %}

### ⚡ Schnellstart

Nachdem OpenClaw installiert ist, müssen wir [Unsloth Desktop](/docs/de/desktop.md) installieren, damit OpenClaw lokale Modelle bereitstellen und Inferenz ausführen kann.

{% stepper %}
{% step %}

#### Unsloth herunterladen

Am einfachsten starten Sie, indem Sie die Unsloth-Desktop-App installieren. Sie unterstützt [macOS](/docs/de/erste-schritte/install/mac.md), Linux, [Windows](/docs/de/erste-schritte/install/windows-installation.md), [NVIDIA](/docs/de/erste-schritte/install/pip-install.md), [AMD](/docs/de/erste-schritte/install/amd.md), Intel- und CPU-Setups.

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Unsloth herunterladen</a>

* <i class="fa-apple">:apple:</i> [Für macOS herunterladen](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Für Windows herunterladen](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Für Linux herunterladen](https://unsloth.ai/download/linux)

Oder, wenn du die manuelle Installation bevorzugst:

**macOS, Linux, WSL:**

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

**Windows PowerShell:**

```bash
irm https://unsloth.ai/install.ps1 | iex
```

{% endstep %}

{% step %}

#### Installieren

1. Öffne den Unsloth-Installer (`.dmg`, `.exe` Dateien)
2. Ziehe Unsloth auf dem Mac in den Ordner „Applications“ oder schließe das Setup unter Windows ab.
3. Starte die App und warte, bis die Installation abgeschlossen ist
   {% endstep %}

{% step %}

#### Wähle ein Modell

Öffne oben das Dropdown „Select model“ oder den Tab „Model hub“, wähle ein Modell und eine Quantisierung, die zu deinem Gerät passt, und lade es dann herunter. Sobald es fertig ist, kannst du mit dem Chatten beginnen – keine Einrichtung erforderlich.

<figure><img src="/files/c2bbae8035ca6e09125d7a93cb309bb6599d7402" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unsloth ist jetzt bereit

Um mit dem Chatten zu beginnen, tippe eine Nachricht ein und drücke Enter.

**Verbinden Sie OpenCode.** Ausführen `unsloth start opencode`. Es erstellt einen API-Schlüssel, schreibt die Konfiguration und startet OpenCode mit Ihrem geladenen Modell.

<figure><img src="/files/7dd332eeb14ab9597f3e5b90e819b2fc153fd3ca" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 🔑 Erstellen eines API-Schlüssels

1. Öffne die Seitenleiste und klicke auf deinen **Unsloth** Avatar unten links.
2. Gehe zu **Einstellungen** → **API**.
3. Gib einen aussagekräftigen Namen ein (z. B. `claude-code-macbook`).
4. *(Optional)* Legen Sie ein Ablaufdatum fest.
5. Klicke auf **Erstellen**.
6. **Kopieren Sie den Schlüssel sofort.** Unsloth speichert nur einen Hash und du kannst ihn nicht erneut anzeigen.

<figure><img src="/files/79728a63bf4bfe0057e70c6f0dd283ee1d2806b8" alt="" width="375"><figcaption></figcaption></figure>

Alle Schlüssel beginnen mit dem `sk-unsloth-` Präfix. Du kannst einen Schlüssel jederzeit auf derselben Seite widerrufen. Anfragen mit einem widerrufenen Schlüssel schlagen mit `401 Unauthorized`.

## 🖇️ Unsloth mit OpenCode Desktop verbinden

**Opencode** unterstützt jeden OpenAI-kompatiblen Provider, sodass Sie Unsloth als einen **Benutzerdefiniert** Provider. Die Einrichtung ist ein einmaliger Vorgang innerhalb von opencode's **Provider verbinden** Dialogs.

**1. Öffnen Sie die Provider-Auswahl.** Geben Sie in opencode `/model` (oder klicken Sie unten im Eingabefeld auf den Modellauswahlschalter).

<div data-with-frame="true"><figure><img src="/files/bfd079ef7fb9ff3783b9d6ce7eac64e7ca0438fb" alt="" width="563"><figcaption></figcaption></figure></div>

Klicken Sie dann **Provider verbinden** oben rechts im Dialog „Modell auswählen“.

<div data-with-frame="true"><figure><img src="/files/1c60e233b42ce3b5e4368a95948d0a177d2e5a26" alt="" width="375"><figcaption></figcaption></figure></div>

**2. Wählen Sie „Custom“.** Scrollen Sie in der Provider-Liste zu **Andere** und wählen Sie **Benutzerdefiniert**.

<div data-with-frame="true"><figure><img src="/files/e18fa0e5820ee5ededfea9c9b75803a32ee0d39d" alt="" width="375"><figcaption></figcaption></figure></div>

**3. Füllen Sie das Formular für den benutzerdefinierten Provider aus:**

| Feld              | Wert                                                                                                              |
| ----------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Provider-ID**   | `unsloth-studio` *(Kleinschreibung, Bindestriche erlaubt)*                                                        |
| **Anzeigename**   | `Unsloth Studio`                                                                                                  |
| **Base-URL**      | `http://localhost:8888/v1/` *(ersetzen Sie `8888` mit Ihrem* Unsloth *Port; lassen Sie das abschließende `/v1/`)* |
| **API-Schlüssel** | Deine `sk-unsloth-…` Schlüssel                                                                                    |

Im **Modelle** Abschnitt fügen Sie pro Modell, das Sie bereitstellen möchten, eine Zeile hinzu. Das linke Feld ist die Modell-ID, wie Unsloth sie bereitstellt; das rechte Feld ist das, was opencode anzeigt:

| Modell-ID (links)                                                                            | Anzeigename (rechts)                                 |
| -------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `unsloth/Qwen3.6-27B-GGUF` *(der genaue Name des Modells, wie er in Unsloth angezeigt wird)* | `unsloth/Qwen3.6-27B-GGUF` *(in opencode angezeigt)* |

Lassen Sie **Header** leer, sofern Sie Unsloth nicht über eine Auth-Schicht proxien, die benutzerdefinierte Header benötigt.

<div data-with-frame="true"><figure><img src="/files/15f53bd42473673bd387be2453cad5f45b4a1c7a" alt="" width="375"><figcaption></figcaption></figure></div>

**4. Klicken Sie auf Senden.** Sie sollten einen *„Unsloth Studio verbunden. Unsloth-Modelle können jetzt verwendet werden“* Toast-Meldung.

<figure><img src="/files/31f745e19a0c3efb9a92ac078327cff5949deeb9" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Starten Sie opencode nach dem Hinzufügen des Providers neu.** Der neue Provider ist erst nach einem Neustart auswählbar.
{% endhint %}

**5. Wählen Sie Ihr Unsloth-Modell aus.** Sobald opencode wieder läuft, geben Sie `/model`, suchen Sie `unsloth`, und wählen Sie das Modell unter der **Unsloth Studio** Gruppe aus. Es wird für Ihre nächste Nachricht aktiv sein.

<div data-with-frame="true"><figure><img src="/files/f69a31e50127a43c8a0d9f8d7f400ce43cf520f4" alt="" width="375"><figcaption></figcaption></figure></div>

Unsloth unterstützt sowohl die Python-SDKs von OpenAI als auch von Anthropic.

### ⚙️ **OpenCode CLI**

OpenCode CLI kann sich mit einem Modell verbinden, das bereits in Unsloth Studio läuft, oder automatisch eines starten, wenn Unsloth nicht läuft.

#### Wenn Unsloth Studio bereits läuft

Öffnen Sie bei einem in Unsloth Studio geladenen Modell Ihren Projektordner und führen Sie Folgendes aus:

```bash
unsloth start opencode
```

Mit diesem Befehl wird OpenCode mit dem aktuell in Unsloth geladenen Modell gestartet, ohne Ihre bestehende OpenCode-Einrichtung zu ändern.

#### Ein Modell automatisch starten

Wenn Unsloth noch nicht läuft, können Sie mit einem einzigen Befehl einen temporären Server starten und ein Modell laden:

Um OpenCode direkt mit einem Modell zu starten, führen Sie Folgendes aus:

```bash
unsloth start opencode \
    --model unsloth/qwen3.8-27B-GGUF-GGUF:UD-Q4_K_XL
    --temp 1.0 \
    --top-p 0.95 \
    --top-k 20 \
    --min-p 0.0 \
    --chat-template-kwargs '{"reasoning_effort":"medium"}'
```

Unsloth wählt automatisch die richtigen zu verwendenden Parameter aus, Sie können sie aber trotzdem ändern.

<div data-with-frame="true"><figure><img src="/files/a2d362c7cb5c9157f359297d52bf460172448106" alt="" width="563"><figcaption></figcaption></figure></div>

Sobald **OpenCode** geöffnet ist, geben Sie ihm eine Aufgabe wie:

```
Erstelle ein Python-2D-Spiel im Flash-Stil mit Springen, Sprinten und zwei Leveln.
```

Es kann das Projekt untersuchen, Dateien erstellen, Code bearbeiten und Befehle mithilfe des lokalen Modells ausführen.

<div align="center" data-with-frame="true"><figure><img src="/files/64d7c077f7a06e361a2eebdd6ea5d04a61e7444a" alt="" width="563"><figcaption></figcaption></figure></div>

In diesem Beispiel hat das Modell einen Plattformspieler mit zwei Leveln erstellt. Öffnen wir ihn und sehen wir, wie er geworden ist.

<div data-with-frame="true"><figure><img src="/files/9dbc3c81da9c0a802a088ce076da43825e1d7ca0" alt="" width="563"><figcaption></figcaption></figure></div>

#### Setzen Sie Ihre Arbeit fort

OpenCode speichert Ihren Sitzungsverlauf automatisch, sodass Sie nicht `--persist`. Um dort fortzufahren, wo Sie aufgehört haben, verwenden Sie, auch wenn Unsloth nicht mehr läuft:

```bash
unsloth start opencode \
  --model unsloth/Qwen3.6-27B-GGUF \
  --continue
```

Um stattdessen eine bestimmte Sitzung zu öffnen, verwenden Sie `--session <session-id>`.

Siehe die vollständige [unsloth start](/docs/de/integrationen/unsloth-start.md) Referenz für das Laden von Modellen, entfernte Unsloth-Server und erweiterte Optionen.&#x20;

### Optional: Serverzugriff konfigurieren

`unsloth run` startet den lokalen API-Server und lädt ein Modell, mit dem sich OpenCode verbinden kann. Sie können auch anpassen, wie sich der Server beim Start verhält.

```bash
# Führen Sie die API auf Port 8888 aus (--disable-tools leitet die eigenen Tools von OpenCode durch)
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  --disable-tools \
  -p 8888
```

{% hint style="warning" %}
Verwende `--disable-tools` beim Steuern von OpenCode (oder einem anderen externen Coding-Agenten). Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Tools aus, wodurch die Tool-Aufrufe des Agents verschluckt werden, sodass OpenCode antwortet, aber nie Dateien bearbeitet. `--disable-tools` wechselt auf Durchleitung, sodass die eigenen Tools von OpenCode verwendet werden.
{% endhint %}

Verwende `-p` um zu ändern, auf welchem Port der Server läuft.

```bash
# Anderen Geräten in Ihrem Netzwerk die Verbindung erlauben
unsloth run \
  --model unsloth/gemma-4-26B-A4B-it-GGUF \
  -H 0.0.0.0 \
  --disable-tools \
  -p 8888
```

Dies startet den Server auf `0.0.0.0:8888`, sodass sich andere Geräte in Ihrem lokalen Netzwerk verbinden können.

Für eine weitergehende Laufzeitkonfiguration siehe den Hauptabschnitt [API-Abstimmung](https://unsloth.ai/docs/basics/api#unsloth-run-command) Abschnitt.


---

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