Ihr gebt dem Agenten eine große Aufgabe. Er startet drei Subagenten, einer prüft die Tests, einer liest die Doku, einer räumt ein Modul auf. Bisher habt ihr gewartet, bis alle fertig waren. Mit OpenCode 2.3.0 arbeitet ihr in der Haupt Session einfach weiter. Die Subagenten melden sich, wenn sie fertig sind.
Das ist die größte Änderung in OpenCode 2.3.0. Dazu kommen ruhigere Transcripts, ein schneller Sprung zu alten Prompts und mehrere Verbesserungen für lokale Modelle. Wir arbeiten täglich mit OpenCode und Open Weight Modellen. Hier steht, was neu ist, was davon im Alltag zählt und worauf ihr achten solltet. Den Vorgänger haben wir in OpenCode 2.2.7 eingeordnet.
Mehrere Agenten im Team sicher steuern: Im Workshop arbeiten eure Developer direkt im Terminal. Sie lernen, wie Regeldateien, Permissions und Quality Gates auch parallele Subagenten im Rahmen halten. Zum NCA KI Workshop für Developer
Was ist neu in OpenCode 2.3.0
Das offizielle Release auf GitHub nennt drei Highlights und eine lange Liste an Verbesserungen und Fixes. Für Teams zählen vor allem diese Punkte:
- Subagenten im Hintergrund. Sie geben sofort zurück und melden sich, wenn sie fertig sind.
- Ruhigere Transcripts. Die TUI fasst Tool Aufrufe und Gedanken zu einer Zeile zusammen.
- Jump to message. In der Desktop App springt ihr direkt zu einem früheren Prompt.
- Robustere Shell Befehle. Sie überstehen Übergaben im Server und behalten ihre Ausgabe beim Abbruch.
- Mutual TLS für Provider. OpenCode kann sich bei Gateways mit einem Client Zertifikat ausweisen.
- Bessere Suche nach lokalen Modellen. Ollama, LM Studio und vLLM bekommen mehr Zeit zum Antworten.
Wie Subagenten in OpenCode 2.3.0 im Hintergrund laufen
Ein Subagent ist eine eigene Session, die der Haupt Agent für eine Teilaufgabe startet. Seit OpenCode 2.0 konnte er im Hintergrund laufen, wenn ihr das so eingestellt hattet. Ab 2.3.0 ist das der Standard. Der Subagent gibt sofort seine Session ID zurück und läuft weiter. Wird er fertig, schickt er seinen Bericht an die Haupt Session. Ihr könnt also mehrere Subagenten gleichzeitig laufen lassen und dabei weiter mit dem Haupt Agenten sprechen.
Zwei Details machen das verlässlich:
- Kein halbes Ergebnis als fertig. Hat ein Subagent selbst noch Arbeit im Hintergrund laufen, sagt sein Bericht das. Der Haupt Agent wartet dann auf den finalen Bericht.
- Forks wissen, dass sie Forks sind. Agenten erfahren jetzt, wenn ihre Session ein Fork ist. Das hilft, wenn ihr einen Stand abzweigt und einen anderen Weg ausprobiert.
Dazu kommt ein Fix, der nach einem Neustart zählt. Direkt gesteuerte Child Sessions laufen danach wieder weiter. Was die Hintergrund Architektur seit Version 2 grundsätzlich bedeutet, beschreibt The New Stack in seinem Bericht zu OpenCode 2.0. Unsere eigene Einordnung zum Umstieg steht im Artikel zu OpenCode 2.0.
Ruhigere Transcripts in der TUI von OpenCode
Wer viel mit Tools arbeitet, kennt das Bild. Die Antwort des Agenten steht irgendwo zwischen Dutzenden Tool Aufrufen und Gedanken. Ab 2.3.0 steht die Verbosity der TUI auf low. Jede Folge von Tool Aufrufen und Gedanken wird zu einer aufklappbaren Aktivitätszeile. Die Antwort selbst rückt nach vorn.
Wer jeden Schritt sehen will, stellt Verbosity in den Einstellungen auf medium oder high. Alternativ setzt ihr session.verbosity in der Konfiguration der TUI. Habt ihr dort schon einen Wert gesetzt, bleibt er erhalten. Weitere kleine Verbesserungen in der TUI:
- Session IDs öffnen. Taucht eine Session ID in einer Nachricht auf, öffnet ihr sie direkt.
- Klickbare Tabs. Aktivitäts Tabs öffnen die richtige Ansicht.
- Eigene Farbe im Shell Modus. Der Prompt im Shell Modus hebt sich jetzt farblich ab.
- Entwurf bleibt erhalten. Wer in der Prompt Historie blättert, findet danach seinen angefangenen Text wieder.
- Keine Bilddaten im Transcript. Sind Bildvorschauen aus, landen keine Bilddaten mehr im Speicher des Transcripts.
Mit Jump to message zu früheren Prompts springen
Lange Sessions haben einen Haken. Der Prompt, mit dem ihr vor einer Stunde die Richtung vorgegeben habt, ist weit oben verschwunden. In der Desktop App öffnet ihr jetzt Jump to message über die Command Palette oder mit dem Shortcut. Ihr durchsucht die Prompts der aktuellen Session und springt direkt hin.
# macOS
Cmd+Alt+G
# Windows und Linux
Ctrl+Alt+G
Shell Befehle in OpenCode 2.3.0 werden robuster
Shell Befehle überstehen jetzt Übergaben im Server. Bricht ihr einen Befehl ab, bleibt seine Ausgabe erhalten. Das ist wichtig, wenn ein langer Testlauf abgebrochen wird und ihr trotzdem sehen wollt, wo er stand. Lokale Shell Befehle unter Windows laufen jetzt über den Prozess Daemon.
Neu und noch experimentell ist eine Option für lange Befehle. Läuft ein Befehl in sein Timeout, kann OpenCode ihn in den Hintergrund schieben, statt ihn zu beenden. Die Funktion steckt hinter einem eigenen Flag. Ist es an, stoppt ein ausdrücklich gesetztes Timeout einen Hintergrund Befehl. Ebenfalls experimentell und hinter einem Flag ist die Unterstützung für MCP Events. Für den produktiven Alltag lassen wir experimentelle Flags aus, bis die Funktion stabil ist.
Mutual TLS für Provider Gateways in OpenCode
Manche Gateways lassen nur Clients durch, die ein eigenes Zertifikat vorzeigen. Das nennt man Mutual TLS. Ab 2.3.0 kann OpenCode das. Ihr setzt beim Provider settings.tls mit cert, key und optional einer passphrase. Die Werte nehmen {file:} und {env:} an, genau wie der API Key. So landen Zertifikat und Schlüssel nicht im Klartext in der Konfiguration.
Für Teams mit gehosteter Inferenz in Deutschland oder der EU ist das ein echter Gewinn. Ein Gateway mit Client Zertifikat ist ein einfacher Weg, den Zugang zu Modellen auf bekannte Rechner zu begrenzen. Wie wir Coding aus der Cloud und Datenverarbeitung im eigenen Netz trennen, zeigt unser NCA Vibe Coding Consulting.
Lokale Modelle mit Ollama, LM Studio und vLLM
OpenCode sucht bei lokalen Endpunkten selbst nach den verfügbaren Modellen. Bisher bekam jeder Endpunkt dafür eine Sekunde. Das reichte für einen Rechner im selben Netz, aber nicht für einen entfernten oder getunnelten Server. Ab 2.3.0 wartet OpenCode bis zu 15 Sekunden pro Anfrage. Ein langsamer Endpunkt bremst dabei weder die anderen Endpunkte noch das Neuladen der Konfiguration.
- Gespeicherte API Keys zählen mit. Die Suche nach lokalen Modellen nutzt jetzt auch gespeicherte Keys.
- LM Studio. Modelle ohne Angabe zur Kontextlänge funktionieren, dazu werden Decision Modelle unterstützt.
- Freie Tool Eingaben. Passende Modelle können Tools jetzt mit freiem Text aufrufen.
Wir nutzen Ollama für kleine lokale Modelle wie Qwen3 Coder und Llama. Große Coding Modelle laufen bei uns gehostet. Welche Modelle wir wofür einordnen, steht in unserer Übersicht der Vibe Coding Modelle.
Code Mode und Werkzeuge des Agenten
Auch unter der Haube hat sich einiges getan. Diese Änderungen spart ihr euch im Alltag als Ärger:
- Gekürzte Ausgaben behalten den Anfang. Ist eine Tool Ausgabe zu lang, bleibt der Anfang erhalten. Kann die volle Ausgabe nicht gespeichert werden, gibt es trotzdem eine brauchbare Vorschau.
- Tail Reads ohne ganze Datei. Wer das Ende einer Datei liest, lädt nicht mehr die ganze Datei in den Speicher.
- Einfachere Ergebnisse in Code Mode.
writeundeditgeben ihre Bestätigung als Text zurück,patchein leeres Ergebnis,skillden Ordner und den Inhalt des Skills. - Bessere Hinweise in Code Mode. Ruft das Modell einen Namespace wie ein Tool auf, schlägt OpenCode bis zu drei echte Tools darunter vor.
Wie Skills und Commands zusammenspielen, erklären wir in OpenCode Skills vs Commands.
Wichtige Fixes in OpenCode 2.3.0
- Rate Limits stoppen die Arbeit nicht mehr. Ein erschöpftes Rate Limit gilt nicht mehr als endgültiger Fehler.
- Abgebrochene Streams verlieren keine Arbeit. Wird ein Stream unterbrochen, der wiederholt werden kann, bleibt erledigte Arbeit erhalten.
- Umbenennungen nur in der Schreibweise. Auf Dateisystemen ohne Unterscheidung von Groß und Kleinschreibung klappen solche Umbenennungen in Patches.
- MCP OAuth. Das Erneuern von Logins und Weiterleitungen auf localhost funktionieren wieder, auch wenn ein Server 127.0.0.1 umschreibt.
- Plugins. Scheitert das Aufräumen eines alten Plugins, wird das neue trotzdem geladen.
OpenCode 2.3.0 Neuerungen im Überblick
| Neuerung | Wo ihr sie findet | Nutzen im Team |
|---|---|---|
| Subagenten im Hintergrund | Standard für alle Subagenten | Weiterarbeiten, während Teilaufgaben laufen |
| Ehrliche Zwischenberichte | Bericht an die Haupt Session | Kein halbes Ergebnis gilt als fertig |
| Ruhige Transcripts | Verbosity low in der TUI | Die Antwort ist schneller zu finden |
| Jump to message | Cmd+Alt+G oder Ctrl+Alt+G | Alte Prompts in langen Sessions finden |
| Robuste Shell Befehle | Ausgabe bleibt beim Abbruch | Abgebrochene Testläufe bleiben lesbar |
| Mutual TLS | settings.tls beim Provider | Zugang zu Gateways mit Client Zertifikat |
| Längere Modellsuche | Ollama, LM Studio, vLLM | Entfernte Endpunkte zeigen ihre Modelle |
| Rate Limits | Provider Anfragen | Arbeit bricht nicht mehr endgültig ab |
OpenCode auf 2.3.0 aktualisieren
Das Update stoßt ihr selbst an, im Terminal oder in der laufenden TUI.
# Update im Terminal
opencode upgrade
# Alternativ in der laufenden TUI
/update
# Version prüfen
opencode --version
Nach dem Update sehen eure Transcripts anders aus. Wer gewohnt ist, jeden Tool Aufruf zu lesen, stellt die Verbosity gleich wieder hoch. In Pipelines haltet ihr die Version fest, damit ein neues Release nicht unbemerkt in einen Lauf rutscht. Wie das in GitHub Actions aussieht, zeigt OpenCode GitHub Action einrichten.
Unsere Einordnung
Subagenten im Hintergrund machen den Agenten schneller. Sie machen auch mehr Arbeit, die geprüft werden muss. Drei Subagenten liefern drei Diffs in der Zeit, in der vorher einer kam. Das geht nur gut, wenn jede Änderung durch Tests und statische Analyse läuft. Der Agent schreibt Code, die Quality Gates entscheiden, ob er gut genug ist.
Prüft vor dem Update, was eure Subagenten dürfen. Was vorher vor euren Augen passierte, läuft jetzt nebenher. Wie ihr den Rahmen setzt, steht in OpenCode Permissions richtig einstellen. Alle Details zu Modellen, Installation und Einordnung findet ihr auf unserer Übersichtsseite zu OpenCode als Open Source Coding Agent.
OpenCode mit Subagenten sicher im Team einsetzen
Wir richten OpenCode mit Open Weight Modellen ein, setzen Permissions für Haupt Agent und Subagenten und koppeln alles an eure Quality Gates. Im kostenlosen Kennenlernen schätzen wir den Aufwand, abgerechnet wird transparent auf die Minute.
