> 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

Dieser Leitfaden führt dich durch das Verbinden **OpenCode Desktop** zu [Unsloth](https://github.com/unslothai/unsloth) zum Ausführen offener LLMs **vollständig lokal.** OpenCode ist ein **Open-Source-KI-Coding-Agent** der Code in deinem gesamten Projekt liest, verändert und ausführt, indem er ein verbundenes Modell verwendet.\
\
Das funktioniert mit jedem **lokalen Modell** bereitgestellt ü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 du ein geladenes Modell auswählen und es als **Coding-Agent**.

<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 direkt in OpenCode darauf zugegriffen werden. Bevorzugst du ein anderes Modell? Tausche es einfach gegen ein anderes Modell aus, indem du es in Unsloth lädst.
{% endhint %}

### OpenCode Desktop installieren

{% tabs %}
{% tab title="macOS" %}
**Schritt 1: Lade das OpenCode-Installationsprogramm für Mac herunter**

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

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

Ein Popup erscheint und fragt dich, wo du das OpenCode-Installationsprogramm speichern möchtest. Es ist in Ordnung, die Standardeinstellungen zu übernehmen. Klicke auf **Speichern.** Dadurch wird das **OpenCode** Installationsprogramm in deinem `Downloads` Ordner gespeichert.

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

#### Schritt 2: Installiere OpenCode

Suche die `OpenCode Desktop.dmg` Installationsdatei in deinem Downloads-Ordner und doppelklicke darauf.

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

#### Schritt 3: Starte OpenCode

Suche 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 nun bereit für deine nächste Aktion.

<figure><img src="/files/99434848986700dc899ebe21c706ad3e04a2e9af" alt=""><figcaption></figcaption></figure>
{% 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. **Starte Unsloth.** Merke dir den Port, auf dem es startet; das ist normalerweise `8000` oder `8888`. Du siehst ihn in der Terminalausgabe und in der Browser-URL (`http://localhost:PORT`).
3. **Lade ein Modell.** Klicke auf **Neuer Chat**, wähle oder suche ein Modell (GGUF) aus und warte, bis es vollständig geladen ist.
4. **Einen API-Schlüssel erstellen.** Klicke in Unsloth auf deinen **Unsloth** Avatar unten links → **Einstellungen** → **API** → gib einen Schlüsselnamen ein → **Erstellen**. Kopiere den `sk-unsloth-…` Wert, der angezeigt wird. Unsloth zeigt ihn nur einmal an.
5. **Richte deinen Client auf Unsloth aus.** Verwende `http://localhost:PORT` als Basis-URL und deinen `sk-unsloth-…` Schlüssel zur Authentifizierung. Springe unten zum Rezept für dein Tool.

### 🔑 Einen API-Schlüssel erstellen

1. Öffne die Seitenleiste, klicke auf deinen **Unsloth** Avatar unten links.
2. Gehe zu **Einstellungen** → **API**.
3. Gib einen freundlichen Namen ein (z. B. `claude-code-macbook`).
4. *(Optional)* Lege ein Ablaufdatum fest.
5. Klicke auf **Erstellen**.
6. **Kopiere 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 Nicht autorisiert`.

{% hint style="warning" %}
Behandle deinen API-Schlüssel wie ein Passwort. Jeder mit dem Schlüssel und Netzwerkzugriff auf deine Unsloth-Instanz kann Anfragen an dein geladenes Modell senden.
{% endhint %}

## 🖇️ Unsloth mit OpenCode Desktop verbinden

**OpenCode** unterstützt jeden OpenAI-kompatiblen Anbieter, daher kannst du Unsloth als **Benutzerdefiniert** Anbieter einbinden. Die Einrichtung ist ein einmaliger Ablauf im Dialog **Anbieter verbinden** .

**1. Öffne die Anbieterauswahl.** Gib in opencode `/model` (oder klicke unten im Eingabefeld auf die Modellauswahl).

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

Klicke dann **Anbieter 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ähle „Benutzerdefiniert“.** Scrolle in der Anbieterliste zu **Andere** und wähle **Benutzerdefiniert**.

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

**3. Fülle 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/` *(ersetze `8888` durch deinen* Unsloth *Port; behalte das abschließende `/v1/`)* |
| **API-Schlüssel** | Dein `sk-unsloth-…` Schlüssel                                                                                |

Im **Modelle** Abschnitt füge eine Zeile pro Modell hinzu, das du bereitstellen möchtest. 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)* |

Lasse **Header** leer, es sei denn, du leitest Unsloth über eine Authentifizierungsschicht weiter, die benutzerdefinierte Header benötigt.

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

**4. Klicke auf Absenden.** Du solltest einen *„Unsloth Studio verbunden. Unsloth-Modelle können jetzt verwendet werden“* Toast sehen.

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

{% hint style="warning" %}
**Starte opencode nach dem Hinzufügen des Anbieters neu.** Der neue Anbieter wird erst nach einem Neustart auswählbar.
{% endhint %}

**5. Wähle dein Unsloth-Modell aus.** Sobald opencode wieder läuft, gib `/model`ein, suche `unsloth`und wähle das Modell unter der **Unsloth Studio** Gruppe aus. Es wird bei deiner nächsten 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.

### Optional: Serverzugriff konfigurieren

`unsloth run` startet den lokalen API-Server und lädt ein Modell, damit OpenCode eine Verbindung herstellen kann. Du kannst auch das Verhalten des Servers beim Start anpassen.

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

  --disable-tools \

  -p 8888
```

{% hint style="warning" %}
Verwende `--disable-tools` wenn du OpenCode (oder einen anderen externen Coding-Agenten) steuerst. Standardmäßig führt Unsloth Studio seine eigenen serverseitigen Tools aus, wodurch die Tool-Aufrufe des Agents geschluckt werden, sodass OpenCode antwortet, aber niemals Dateien bearbeitet. `--disable-tools` wechselt zu Passthrough, sodass OpenCodes eigene Tools verwendet werden.
{% endhint %}

Verwende `-p` um zu ändern, auf welchem Port der Server ausgeführt wird.

```bash
# Ermögliche anderen Geräten in deinem Netzwerk, sich zu verbinden
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 andere Geräte in deinem lokalen Netzwerk verbinden können.

Weitere erweiterte Laufzeitkonfigurationen findest du im Hauptabschnitt [API-Anpassung](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:

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