OpenCode mit Ollama einrichten: Provider Schritt für Schritt

Die OpenCode-Ollama-Einrichtung mit einem Provider-Weg starten

OpenCode Ollama einrichten bedeutet meist drei Entscheidungen: Wie findet OpenCode Ollama, welche Base-URL wird genutzt und welches Modell-Tag wird angefordert? Nur einen Wert auf einmal ändern, damit Provider- und Modellfehler getrennt bleiben.

Wenn der Launcher den Provider anlegt, die erzeugte Config vor einem zweiten Provider prüfen. Bei manueller Config zuerst ein lokales Modell und ein Repository ohne vertrauliche Dateien testen.

Voraussetzungen für OpenCode-Ollama-Provider und Modell

Vor Änderungen an opencode.json prüfen, dass Ollama läuft, das Modell in ollama list erscheint und OpenCode denselben Endpoint erreicht. Ein korrekter Provider behebt weder ein fehlendes Modell noch einen falschen Netzwerk-Namespace.

Für den ersten Test ein Modell wählen, das Speicher für Editor, Repository-Kontext und Betriebssystem übrig lässt. Der größte Tag ist nicht automatisch der beste Workflow.

Was der Launcher konfiguriert

Das interaktive Menü zeigt unterstützte Integrationen und Modelle. Nach der Auswahl verbindet OpenCode den Repository-Kontext mit Ollama.

Lokale Modelle brauchen RAM oder VRAM; Cloud-Modelle sparen lokale Ressourcen, benötigen aber Internet und übertragen Prompts.

Manuelle OpenCode-Ollama-Config: Provider, Base-URL und Modell

Manuelle Config ist sinnvoll, wenn der Launcher den gewünschten Provider nicht anlegt oder die Datei reviewbar bleiben soll. Provider, Base-URL und Modell-Tag explizit setzen und die kleinste Anfrage testen, bevor Tools oder großer Kontext dazukommen.

Das Modell-Tag aus ollama list als verifizierten Wert behandeln. Ein falscher Tag wird nicht durch mehr Kontext oder andere Berechtigungen repariert.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://localhost:11434/v1" },
      "models": { "your-model": { "name": "your-model" } }
    }
  }
}

Kontext erst nach der OpenCode-Ollama-Verbindung erhöhen

Ein großes Kontextfenster ist eine andere Optimierung als die Provider-Verbindung. Erst beweisen, dass das Modell antwortet; Kontext nur erhöhen, wenn Speicher und Antwortzeit passen.

Als erstes Beispiel eine kleine Datei lesen, die Änderung erklären und einen Patch zeigen lassen, bevor Schreibzugriff erlaubt wird. So bleiben Provider, Modell und Repository-Grenze sichtbar.

FROM your-model
PARAMETER num_ctx 65536

Ein Ollama-Modell für OpenCode auswählen

Die Wahl hängt von RAM, Kontext, Coding-Fähigkeit und Latenz ab. Modellklasse und Maschine vergleichen, statt mehr Parameter automatisch mit einem besseren Workflow gleichzusetzen.

OpenCode-Ollama-Provider- und Config-Fehler beheben

Wenn OpenCode Ollama nicht aufrufen kann, Provider-Key, Base-URL, Modell-Tag, Ollama-Prozess und Runtime-Netzwerk in dieser Reihenfolge prüfen. Ein nativer Endpoint kann aus einem Container oder Remote-Prozess anders lauten.

Verbindet der Provider, aber die Antwort ist leer oder ungültig, exakten Modell-Tag prüfen und die Anfrage verkleinern, bevor das Kontextfenster geändert wird.

Sichere erste Aufgabe nach der OpenCode-Ollama-Einrichtung

Nach erfolgreicher Einrichtung mit einer schreibgeschützten Repository-Aufgabe beginnen. Erklärung, Patch-Vorschlag und Testplan anfordern; Diff prüfen, bevor Schreiben oder Shell erlaubt wird.

Für breitere Entscheidungen die vorhandenen Guides zu lokalem Coding-Agent und Speicher nutzen. Diese Seite bleibt der fokussierte OpenCode-plus-Ollama-Setup-Pfad.