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

Diese Anleitung führt Sie durch die Verbindung von **OpenCode Desktop** mit [Unsloth](https://github.com/unslothai/unsloth) um offene LLMs auszuführen **vollständig lokal.** OpenCode ist ein **Open-Source-KI-Coding-Agenten** der Code in Ihrem gesamten Projekt liest, verändert und ausführt, indem er ein verbundenes Modell verwendet.\
\
Dies funktioniert mit jedem **lokalen Modell** das über Unsloths **OpenAI-kompatible API**bereitgestellt wird, 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-Agenten**.

<a href="https://sites.gitbook.com/preview/site_mXXTe/~/revisions/S6OVzFPYN3gcF4rziUb5/integrations/opencode?theme=light#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` in Unsloth geladen und greifen direkt innerhalb von OpenCode darauf zu. Bevorzugen Sie ein anderes Modell? Tauschen Sie es aus, indem Sie ein anderes Modell in Unsloth laden.
{% endhint %}

### OpenCode Desktop installieren

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

{% endtab %}

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

<figure><img src="/files/c7401cb09572e73d4def575fa9ba520083da9c88" alt=""><figcaption></figcaption></figure>

Ein Popup wird angezeigt und fragt Sie, wo Sie das OpenCode-Installationsprogramm speichern möchten. Es ist in Ordnung, die Standardeinstellungen zu übernehmen. Klicken Sie auf **Speichern.** Dadurch wird das **OpenCode** Installationsprogramm in Ihrem `Downloads` Ordner gespeichert.

<figure><img src="/files/4205095269a6c3ef9d273853aaf50664ad9ef1ae" alt=""><figcaption></figcaption></figure>

#### Schritt 2: OpenCode installieren

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

<figure><img src="/files/6740662e3b7343026c9c7b9ec54d103c6c77a34f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/950f2ed6803cde34bee84f6d7fc56e9a1ba5d65e" alt=""><figcaption></figcaption></figure>

#### Schritt 3: OpenCode starten

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

<figure><img src="/files/25e152acb260b95fa18914f4c1fbd2c9dbd6d877" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/99434848986700dc899ebe21c706ad3e04a2e9af" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Linux/WSL" %}

{% endtab %}
{% endtabs %}

## Unsloth installieren

### ⚡ Schnellstart

Nach der Installation von OpenCode müssen wir Unsloth Studio installieren, damit OpenCode lokale Modelle bereitstellen und Inferenz ausführen kann.

1. **Unsloth Studio installieren oder aktualisieren.** Frühere Versionen stellen die externe API nicht bereit. Siehe Installation.
2. **Starten Sie Unsloth.** Beachten Sie, dass der Port, auf dem es startet, normalerweise `8000` oder `8888`ist. Sie sehen ihn in der Terminalausgabe und in der Browser-URL (`http://localhost:PORT`).
3. **Laden Sie ein Modell.** Klicken Sie auf **Neuer Chat**, wählen oder suchen Sie ein Modell (GGUF) und warten Sie, bis es fertig geladen ist.
4. **Erstellen Sie einen API-Schlüssel.** Klicken Sie in Unsloth auf Ihr **Unsloth** Avatar unten links → **Einstellungen** → **API** → geben Sie einen Schlüsselnamen ein → **Erstellen**. Kopieren Sie den angezeigten `sk-unsloth-…` Wert. Unsloth zeigt ihn nur einmal an.
5. **Richten Sie Ihren Client auf Unsloth aus.** Verwenden Sie `http://localhost:PORT` als Basis-URL und Ihren `sk-unsloth-…` Schlüssel zur Authentifizierung. Springen Sie unten direkt zur Anleitung für Ihr Tool.

### 🔑 Erstellen eines API-Schlüssels

1. Öffnen Sie die Seitenleiste und klicken Sie auf Ihr **Unsloth** Avatar unten links.
2. Gehen Sie zu **Einstellungen** → **API**.
3. Geben Sie einen freundlichen 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 können ihn nicht erneut ansehen.

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

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 Nicht autorisiert`.

{% hint style="warning" %}
Behandeln Sie Ihren API-Schlüssel wie ein Passwort. Jeder mit dem Schlüssel und Netzwerkzugriff auf Ihre Unsloth-Instanz kann Anfragen an Ihr geladenes Modell senden.
{% endhint %}

## 🖇️ 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 im **Anbieter verbinden** Dialog von opencode.

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

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

Klicken Sie dann oben rechts im Dialog zur Modellauswahl auf **Anbieter verbinden** .

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

**2. Wählen Sie „Benutzerdefiniert“.** Scrollen Sie in der Anbieterliste zu **Andere** und wählen Sie **Benutzerdefinierten**.

<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 Anbieter aus:**

| Feld              | Wert                                                                                                                  |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Anbieter-ID**   | `unsloth-studio` *(kleingeschrieben, Bindestriche erlaubt)*                                                           |
| **Anzeigename**   | `Unsloth Studio`                                                                                                      |
| **Basis-URL**     | `http://localhost:8888/v1/` *(ersetzen Sie `8888` durch Ihren* Unsloth *Port; behalten Sie das abschließende `/v1/`)* |
| **API-Schlüssel** | Ihr `sk-unsloth-…` Schlüssel                                                                                          |

Im **Modelle** Bereich 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 anzeigt:

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

Lassen Sie **Header** leer, es sei denn, Sie leiten Unsloth über eine Authentifizierungsschicht mit benutzerdefinierten Headern weiter.

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

**4. Klicken Sie auf Senden.** Sie sollten eine *„Unsloth Studio verbunden. Unsloth-Modelle sind jetzt verfügbar“* Toast-Meldung sehen.

<figure><img src="/files/31f745e19a0c3efb9a92ac078327cff5949deeb9" 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`ein, suchen Sie nach `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.


---

# Agent Instructions: 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:

```
GET https://unsloth.ai/docs/de/integrationen/opencode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.