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

# Lokale KI-Modelle mit OpenCode ausführen

Anleitung zum Verbinden offener LLMs mit OpenCode auf Ihrem lokalen Gerät.

Diese Anleitung führt Sie durch die Verbindung von **OpenCode** an [Unsloth](https://github.com/unslothai/unsloth) um offene LLMs auszuführen **vollständig lokal.** OpenCode ist ein **Open-Source-KI-Coding-Agent** der mithilfe eines verbundenen Modells Code in Ihrem gesamten Projekt liest, verändert und ausführt. Das funktioniert mit jedem **lokalen Modell** , das über Unsloths **OpenAI-kompatible API**, einschließlich: 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, mit 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="/docs/de/integrationen/opencode.md#quickstart" class="button primary">Schnellstart</a>

{% hint style="info" %}
In diesem Tutorial verwenden wir `unsloth/Qwen3.6-27B-GGUF` in Unsloth geladen und greifen Sie direkt in OpenCode darauf zu. Bevorzugen Sie ein anderes Modell? Tauschen Sie es gegen jedes andere 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 Datei `OpenCode Desktop.dmg` des Installationsprogramms in Ihrem Download-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 Datei **OpenCode** Symbol unter dem **Programme** Ordner.

Der **OpenCode** Desktop-App wird geöffnet und ist nun für Ihre nächste Aktion 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 nach der Datei `OpenCode Desktop Installer.exe` in Ihrem Download-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 nun für Ihre nächste Aktion 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**

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

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

Öffnen Sie Ihren Download-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 die AppImage-Datei, um **OpenCode**.

Oder, wenn Sie lieber das Terminal verwenden, führen Sie 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 für Ihre nächste Aktion bereit.
{% endtab %}
{% endtabs %}

### ⚡ Schnellstart

Nach der Installation von OpenCode müssen wir [Unsloth-Desktop](/docs/de/desktop.md) installieren, damit OpenCode lokale Modelle bereitstellen und Inferenz ausführen kann.

{% stepper %}
{% step %}

#### Unsloth herunterladen

Der einfachste Weg für den Einstieg ist die Installation der Unsloth-Desktop-App. Sie unterstützt [macOS](/docs/de/loslegen/install/mac.md), Linux, [Windows](/docs/de/loslegen/install/windows-installation.md), [NVIDIA](/docs/de/loslegen/install/pip-install.md), [AMD](/docs/de/loslegen/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 das Unsloth-Installationsprogramm (`.dmg`, `.exe` -Dateien)
2. Ziehe Unsloth auf dem Mac in den Ordner „Programme“ oder schließe die Einrichtung unter Windows ab.
3. Starte die App und warte, bis die Installation abgeschlossen ist
   {% endstep %}

{% step %}

#### Wähle ein Modell

Öffne oben im Dropdown „Modell auswählen“ oder den Tab „Model Hub“, wähle ein Modell und eine Quantisierung, die zu deinem Gerät passt, und lade es dann herunter. Sobald der Download abgeschlossen ist, kannst du 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, gib 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="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 %}

### 🔑 Erstellen eines API-Schlüssels

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

<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. Du kannst einen Schlüssel jederzeit auf derselben Seite widerrufen. Anfragen mit einem widerrufenen Schlüssel schlagen fehl mit `401 Unauthorized`.

## 🖇️ Unsloth mit OpenCode Desktop verbinden

**Opencode** unterstützt jeden OpenAI-kompatiblen Anbieter, sodass Sie Unsloth als **benutzerdefinierten** Anbieter einbinden können. Die Einrichtung ist ein einmaliger Ablauf innerhalb von opencode's **Anbieter verbinden** Dialog.

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

<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 zur Modellauswahl.

<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`                                                                                                    |
| **Base-URL**      | `http://localhost:8888/v1/` *(ersetzen Sie `8888` durch Ihren* Unsloth *Port; lassen Sie das abschließende `/v1/`)* |
| **API-Schlüssel** | Deine `sk-unsloth-…` Schlüssel                                                                                      |

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

| 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 Authentifizierungsschicht weiterleiten, 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 stehen jetzt zur Verfügung"* 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 wird 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 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**

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

#### Wenn Unsloth Studio bereits läuft

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

```bash
unsloth start opencode
```

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

#### Ein Modell automatisch starten

Wenn Unsloth nicht bereits 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 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 Parameter aus, die verwendet werden sollen, aber Sie können sie trotzdem ä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** es geöffnet ist, geben Sie ihm eine Aufgabe wie:

```
Erstelle ein Python-2D-Spiel im Flash-Stil mit Springen, Dashen 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="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 Plattformer mit zwei Leveln erstellt. Öffnen wir ihn und sehen wir, wie er 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 Sitzungverlauf automatisch, sodass Sie nicht `--persist`. 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>`.

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

### 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` wenn Sie OpenCode (oder einen anderen externen Coding-Agenten) steuern. Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Tools aus, die die Tool-Aufrufe des Agents abfangen, sodass OpenCode antwortet, aber niemals 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 das Verbinden 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 andere Geräte in Ihrem lokalen Netzwerk eine Verbindung herstellen können.

Für eine erweiterte Laufzeitkonfiguration siehe den Abschnitt [API-Tuning](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 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/opencode.md?ask=<question>&goal=<user_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.