> 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 dich durch das Verbinden **OpenCode** zu [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 deinem 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 dem Einrichten verbindet sich OpenCode mit Unsloth, wo du ein geladenes Modell auswählen und es als **Coding-Agenten**.

Diese Anleitung behandelt beide Einrichtungsoptionen:

* **OpenCode Desktop:** füge Unsloth Studio manuell als benutzerdefinierten, OpenAI-kompatiblen Anbieter hinzu.
* **OpenCode CLI:** starte es mit `unsloth start opencode` und verbinde es automatisch mit deinem 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` in Unsloth geladen und greife direkt in OpenCode darauf zu. 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).

#### Schritt 2: Installiere OpenCode

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

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.

Der **OpenCode** Desktop-App wird geöffnet und ist jetzt bereit für deine 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: Lade das OpenCode-Installationsprogramm für Windows herunter**

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

#### **Schritt 2: Installiere OpenCode**

suche die `OpenCode Desktop Installer.exe` in deinem Downloads-Ordner und doppelklicke sie. Anschließend kannst du den Anweisungen im Installationsfenster folgen, um die Installation abzuschließen.

#### **Schritt 3: Starte OpenCode**

Öffne das Windows-Startmenü und suche nach **OpenCode**.\n\nKlicke auf das OpenCode-App-Symbol, um es zu starten. Die OpenCode-Desktop-App wird geöffnet und ist jetzt bereit für deine 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: Lade das OpenCode-Installationsprogramm für Linux herunter**

Gehe zu `opencode.ai/download` mit deinem bevorzugten Webbrowser herunter. Suche den **OpenCode Desktop (Beta)** Abschnitt und wähle dann die Linux-Download-Option für dein System.

#### **Schritt 2: Installiere OpenCode**

Öffne deinen Downloads-Ordner und suche das **OpenCode** Installationsprogramm, das du gerade heruntergeladen hast.

Bei einem AppImage-Download klicke mit der rechten Maustaste auf die Datei und öffne **Eigenschaften**, und aktiviere die Option, die es der Datei erlaubt, als Programm ausgeführt zu werden. Doppelklicke dann auf das AppImage, um zu starten **OpenCode**.

Oder führe, wenn du lieber das Terminal verwendest, Folgendes aus:

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

Wenn du eine `.deb` Datei heruntergeladen hast, installiere sie mit:

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

Wenn du eine `.rpm` Datei heruntergeladen hast, installiere sie mit:

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

#### **Schritt 3: Starte OpenCode**

Öffne deinen Linux-Anwendungsstarter und suche nach **OpenCode**.

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

### ⚡ Schnellstart

Nachdem OpenCode installiert ist, müssen wir Unsloth Studio installieren, damit OpenCode lokale Modelle bereitstellen und Inferenz ausführen kann.

1. **Installiere oder aktualisiere Unsloth Studio.** 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`. Sie sehen ihn in der Terminalausgabe und in der Browser-URL (`http://localhost:PORT`).
3. **Lade ein Modell.** Klicken Sie auf **Neuer Chat**, wähle oder suche ein Modell (GGUF) und warte, bis das Laden abgeschlossen ist.
4. **Verbinde OpenCode.** Führen Sie aus `unsloth start opencode`. Es erstellt einen API-Schlüssel, schreibt die Konfiguration und startet OpenCode mit deinem geladenen Modell.

### 🔑 Einen API-Schlüssel erstellen

1. Öffne die Seitenleiste und klicke unten links auf dein **Unsloth** Profilbild.
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. Klicken Sie auf **Erstellen**.
6. **Kopieren Sie den Schlüssel sofort.** Unsloth speichert nur einen Hash und du kannst ihn nicht erneut ansehen.

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

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

## 🖇️ Unsloth mit OpenCode Desktop verbinden

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

**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="" width="563"><figcaption></figcaption></figure></div>

Klicke dann **Anbieter verbinden** oben rechts im Dialog zur Modellauswahl.

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

**2. Wähle „Custom“.** Scrolle in der Anbieterliste zu **Andere** und wähle **benutzerdefinierten**.

<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` *(Kleinschreibung, 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** | Deine `sk-unsloth-…` Schlüssel                                                                               |

Im **Modelle** Abschnitt fügst du pro Modell, das du bereitstellen möchtest, 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` *(wird in opencode angezeigt)* |

Lass **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 Senden.** Du solltest 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" %}
**Starte opencode nach dem Hinzufügen des Anbieters neu.** Der neue Anbieter ist erst nach einem Neustart auswählbar.
{% endhint %}

**5. Wähle dein Unsloth-Modell aus.** Sobald opencode wieder läuft, gib `/model`, 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.

### ⚙️ **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

Öffne bei einem in Unsloth Studio geladenen Modell deinen Projektordner und führe aus:

```bash
unsloth start opencode
```

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

#### Modell automatisch starten

Wenn Unsloth Studio noch nicht läuft, kannst du mit einem einzigen Befehl einen temporären Server starten und ein Modell laden:

```bash
unsloth start opencode --model unsloth/gemma-4-26B-A4B-it-GGUF
```

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

Sobald **OpenCode** es geöffnet ist, gib ihm eine Aufgabe wie:

```
Erstelle ein Python-2D-Spiel im Flash-Stil 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="/files/64d7c077f7a06e361a2eebdd6ea5d04a61e7444a" alt="" width="563"><figcaption></figcaption></figure></div>

In diesem Beispiel hat das Modell einen Platformer mit zwei Levels 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>

#### Setze deine Arbeit fort

OpenCode speichert deinen Sitzungsverlauf automatisch, daher musst du nicht `--persist`. Um dort weiterzumachen, wo du aufgehört hast, selbst wenn Unsloth nicht mehr läuft, verwende:

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

Um stattdessen eine bestimmte Sitzung zu öffnen, verwende `--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. Du kannst auch anpassen, wie sich der Server beim Start verhält.

```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 verschluckt werden; OpenCode antwortet dann, bearbeitet aber nie Dateien. `--disable-tools` schaltet auf Durchleitung um, sodass OpenCodes eigene Tools verwendet werden.
{% endhint %}

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

```bash
# Anderen Geräten in deinem Netzwerk erlauben, 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 Ihrem lokalen Netzwerk eine Verbindung herstellen können.

Für eine erweiterte Laufzeitkonfiguration siehe den Hauptabschnitt [API-Optimierung](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.