> 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).

# So führen Sie lokale KI-Modelle mit OpenCode aus

Leitfaden zur Verbindung offener LLMs mit OpenCode auf Ihrem lokalen Gerät.

Dieser Leitfaden führt Sie durch die Verbindung **OpenCode** mit [Unsloth](https://github.com/unslothai/unsloth) um offene LLMs auszuführen **vollständig lokal.** OpenCode ist ein **Open-Source-KI-Coding-Agent** der mit einem verbundenen Modell Code in Ihrem gesamten Projekt liest, verändert und ausführt. Das funktioniert mit jedem **lokalen Modell** das ü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 dem Einrichten verbindet sich OpenCode mit Unsloth, wo Sie ein geladenes Modell auswählen und es als einen **Coding-Agent**.

Dieser Leitfaden deckt beide Einrichtungsoptionen ab:

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

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

{% hint style="info" %}
In diesem Tutorial verwenden wir `unsloth/Qwen3.6-27B-GGUF` das in Unsloth geladen ist, und greifen direkt in OpenCode darauf zu. Bevorzugen Sie ein anderes Modell? Tauschen Sie es gegen ein anderes Modell aus, 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 `Download` 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 **Anwendungen** Symbol, wie gezeigt.

#### Schritt 3: Starten Sie OpenCode

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

Die **OpenCode** Desktop-App wird geöffnet und ist jetzt für Ihren nächsten Schritt bereit.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FZNP4G1c2hmHyBzNbGH5x%2Fopencode_interface.png?alt=media&amp;token=5af679cb-504d-4299-a40e-0d8310289a90" 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 **Download** 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. Folgen Sie dann den Anweisungen im Installationsfenster, 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 jetzt für Ihren nächsten Schritt bereit

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLECAvpw6DMNCcuFclzoy%2Fimage.png?alt=media&amp;token=7a628b56-3e0c-4d00-8054-ab8b9317e4f9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Linux" %}

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

Gehen Sie 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** soeben heruntergeladene Installationsprogramm.

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 im Terminal 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 jetzt für Ihren nächsten Schritt bereit.
{% endtab %}
{% endtabs %}

### ⚡ Schnellstart

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

{% stepper %}
{% step %}

#### Unsloth herunterladen

Der einfachste Einstieg ist die Installation der Unsloth-Desktop-App. 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> [Download für macOS](https://unsloth.ai/download/mac)
* <i class="fa-windows">:windows:</i> [Download für Windows](https://unsloth.ai/download/windows)
* <i class="fa-linux">:linux:</i> [Download für Linux](https://unsloth.ai/download/linux)

Oder, wenn Sie die manuelle Installation bevorzugen:

**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. Öffnen Sie das Unsloth-Installationsprogramm (`.dmg`, `.exe` Dateien)
2. Ziehen Sie Unsloth unter Mac nach Anwendungen oder schließen Sie unter Windows die Einrichtung ab.
3. Starten Sie die App und warten Sie, bis die Installation abgeschlossen ist
   {% endstep %}

{% step %}

#### Wählen Sie ein Modell

Öffnen Sie oben das Dropdown-Menü 'Modell auswählen' oder den Tab 'Model Hub', wählen Sie ein Modell und eine Quantisierung, die zu Ihrem Gerät passt, und laden Sie es dann herunter. Sobald der Download abgeschlossen ist, können Sie mit dem Chatten beginnen – keine Einrichtung erforderlich.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Unsloth ist jetzt bereit

Um mit dem Chatten zu beginnen, geben Sie eine Nachricht ein und drücken Sie Enter.

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

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FpAGvwjGD0iVMZKBoyu7m%2Fgreeennn.png?alt=media&amp;token=d17a5528-8375-444c-9aff-f9e9f7903bcd" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 🔑 Einen API-Schlüssel erstellen

1. Öffnen Sie die Seitenleiste und klicken Sie auf Ihr **Unsloth** Avatar unten links.
2. Gehen Sie zu **Einstellungen** → **API**.
3. Geben Sie einen aussagekräftigen Namen ein (z. B. `claude-code-macbook`).
4. *(Optional)* Legen Sie ein Ablaufdatum fest.
5. Klicken Sie auf **Erstellen**.
6. **Kopieren Sie den Schlüssel sofort.** Unsloth speichert nur einen Hash, und Sie werden ihn nicht erneut anzeigen können.

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FrWnqY5PgvZdbWK8pmlD5%2Fimage.png?alt=media&amp;token=3507e7d7-b552-447f-b503-2418802b8f6e" alt="" width="375"><figcaption></figcaption></figure>

Alle Schlüssel beginnen mit dem `sk-unsloth-` Präfix. Sie können 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 Anbieter, sodass Sie Unsloth als einen **benutzerdefinierten** Anbieter einbinden können. Die Einrichtung ist ein einmaliger Vorgang innerhalb von opencode's **Anbieter verbinden** Dialog.

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

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fl59D1AVRI57fQBJqgp8t%2Fslash-model.png?alt=media&amp;token=9434f804-6a9e-4b76-ab7e-75cd745fe9c2" alt="" width="563"><figcaption></figcaption></figure></div>

Klicken Sie dann auf **Anbieter verbinden** oben rechts im Dialog zum Modell auswählen.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fi9VOd4yRAmLnqZ1D4tBm%2Fconnect%20provider.png?alt=media&amp;token=cb28387a-9cc3-4c5f-928e-82a56edd86df" alt="" width="375"><figcaption></figcaption></figure></div>

**2. Wählen Sie "Custom".** Scrollen Sie in der Anbieterliste zu **Andere** und wählen Sie **benutzerdefinierten**.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FWyltmg0o9YtyydUSLvcn%2Fcustom%20highlighted.png?alt=media&amp;token=5cc89686-dfae-4ebd-8beb-e6dc78088b4b" alt="" width="375"><figcaption></figcaption></figure></div>

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

| Feld              | Wert                                                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Anbieter-ID**   | `unsloth-studio` *(Kleinschreibung, Bindestriche erlaubt)*                                                          |
| **Anzeigename**   | `Unsloth Studio`                                                                                                    |
| **Basis-URL**     | `http://localhost:8888/v1/` *(ersetzen Sie `8888` durch Ihren* Unsloth *Port; lassen Sie das abschließende `/v1/`)* |
| **API-Schlüssel** | Ihr `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, so 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 in Unsloth angezeigt)* | `unsloth/Qwen3.6-27B-GGUF` *(wird in opencode angezeigt)* |

Lassen Sie **Header** leer, sofern Sie Unsloth nicht über eine Authentifizierungsschicht proxyen, die benutzerdefinierte Header benötigt.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FjGU2OaOKRtqCwmO34BuN%2Fopencode_custom_provider_config.png?alt=media&amp;token=6ef67ecf-23e6-4913-bc02-c26701f5aea0" alt="" width="375"><figcaption></figcaption></figure></div>

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

<figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FuCOOOJhO8brhEwwIsiUC%2Fopencode_model_available_toast.png?alt=media&amp;token=a463bb0c-724a-4809-9ddb-b7bff094b255" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Starten Sie opencode nach dem Hinzufügen des Anbieters neu.** Der neue Anbieter kann erst nach einem Neustart ausgewählt werden.
{% endhint %}

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

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FFRNofXnF7r7CKlHjLMwv%2Fopencode_unsloth_model_usage.png?alt=media&amp;token=4c882e8f-6ac5-4f9b-8f59-5e86e312851b" alt="" width="375"><figcaption></figcaption></figure></div>

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

### ⚙️ **OpenCode CLI**

Die 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 starten Sie OpenCode mit dem derzeit in Unsloth geladenen Modell, 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 \
    --reasoning-effort medium
```

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

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fom5iWH1f42GZ69utVSyf%2Fimage.png?alt=media&amp;token=815a0458-b252-4c96-a341-e345842bd248" alt="" width="563"><figcaption></figcaption></figure></div>

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

```
Erstelle ein Flash-artiges Python-2D-Spiel mit Springen, Dashen und zwei Levels.
```

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="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FOA6dENYOpJdGa3zwS8Ei%2Fimage.png?alt=media&amp;token=266a85f8-ec80-4a7d-bd58-e82d9ff0b864" alt="" width="563"><figcaption></figcaption></figure></div>

In diesem Beispiel hat das Modell einen Jump-'n'-Run mit zwei Levels erstellt. Öffnen wir es und sehen wir uns an, wie es geworden ist.

<div data-with-frame="true"><figure><img src="https://797013937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FHqFv9FyPsM0poo5c6WNb%2Fezgif-68bd7a9b463725d0.gif?alt=media&amp;token=abafdfef-6e13-430b-bccb-140f29ee6d13" alt="" width="563"><figcaption></figcaption></figure></div>

#### Setzen Sie Ihre Arbeit fort

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

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

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

Sehen Sie sich die vollständige [unsloth start](/docs/de/integrationen/unsloth-start.md) Referenz für das Laden von Modellen, entfernte Unsloth-Server und erweiterte Optionen an.

### 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 das Verhalten des Servers beim Start anpassen.

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

{% hint style="warning" %}
Verwenden Sie `--disable-tools` wenn Sie OpenCode (oder einen anderen externen Coding-Agenten) steuern. Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Tools aus, wodurch die Tool-Aufrufe des Agenten verschluckt werden, sodass OpenCode antwortet, aber niemals Dateien bearbeitet. `--disable-tools` schaltet auf Durchleitung um, sodass OpenCodes eigene Tools verwendet werden.
{% endhint %}

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

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

Weitere erweiterte Laufzeitkonfiguration finden Sie im Hauptabschnitt [API-Feinabstimmung](https://unsloth.ai/docs/basics/api#unsloth-run-command) .


---

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