OpenCode Quickstart: Installation, Konfiguration und Nutzung des AI-Coding-Agenten in der Terminal

So installieren, konfigurieren und nutzen Sie OpenCode

Inhaltsverzeichnis

OpenCode ist ein quelloffener KI-Coding-Agent, den Sie im Terminal (TUI + CLI) ausführen können, mit optionalen Desktop- und IDE-Oberflächen. Dies ist der OpenCode-Einstiegsleitfaden: Installation, Überprüfung, Verbindung mit einem Modell/Anbieter und Ausführung realer Workflows (CLI + API).

Versionshinweis: OpenCode wird schnell aktualisiert. Die „neuesten“ Befehle hier sind stabil, aber Ausgaben und Standardwerte können sich ändern – prüfen Sie immer die offiziellen CLI-Dokumentationen und das Änderungsprotokoll (unten verlinkt) gegeneinander.

Dieser Artikel ist ein Teil von KI-Entwicklerwerkzeuge: Der vollständige Leitfaden für KI-gestützte Entwicklung. Wenn Sie auch einen selbst gehosteten Assistenten wie Nous Hermes pflegen, zeigt der Hermes Agent CLI-Spickzettel das hermes-Befehlsspektrum neben diesem OpenCode-Einstiegsleitfaden.

Was OpenCode ist (und wo es einzuordnen ist)

OpenCode ist für terminal-zentriertes, agentisches Coden konzipiert und bleibt dabei flexibel in Bezug auf Anbieter/Modelle. In der Praxis ist es eine Workflow-Ebene, die:

  • eine Terminalschnittstelle startet, wenn Sie opencode ausführen
  • nicht interaktive „One-Shot“-Prompts über opencode run ausführt (Skripte/Automatisierung)
  • einen kopflosen HTTP-Server über opencode serve bereitstellt (und eine Weboberfläche über opencode web)
  • programmgesteuert über das offizielle JS/TS-SDK @opencode-ai/sdk gesteuert werden kann

Wenn Sie es mit einem anderen quelloffenen Agenten-Assistenten vergleichen möchten, der mehrstufige Pläne in einer sandboxed Umgebung ausführen kann, siehe OpenHands CLI QuickStart.

Für Anthropics terminal-zentrierten Agenten mit der gleichen „lokales Modell über HTTP“-Geschichte (Ollama oder llama.cpp, Berechtigungen, Preise), siehe Claude Code Installation und Konfiguration für Ollama, llama.cpp, Preise.

Für eine bewusst minimale Variante der gleichen Terminal-Agenten-Idee – vier Standardwerkzeuge, keine eingebaute Sandbox, alles andere über Erweiterungen – siehe die Pi Coding Agent Rezension.

opencode mit selbst gehostetem qwen3.5 27b LLM

Voraussetzungen

Sie benötigen:

  • Einen modernen Terminal-Emulator (wichtig für die TUI-Erfahrung).
  • Zugriff auf mindestens ein Modell/einen Anbieter (API-Keys oder Abonnements-Authentifizierung, je nach Anbieter). Lokale Optionen wie Ollama oder llama.cpp funktionieren ohne API-Keys, wenn Sie einen kompatiblen Server lokal ausführen.

OpenCode installieren (Kopieren-Einfügen)

Offizielles Installationsskript (Linux/macOS/WSL):

curl -fsSL https://opencode.ai/install | bash

Paketmanager-Optionen (offizielle Beispiele):

# Node.js globale Installation
npm install -g opencode-ai

# Homebrew (von OpenCode für die aktuellsten Releases empfohlen)
brew install anomalyco/tap/opencode

# Arch Linux (stabil)
sudo pacman -S opencode

# Arch Linux (neueste Version aus dem AUR)
paru -S opencode-bin

Windows-Hinweise (die offiziellen Richtlinien empfehlen häufig WSL für die beste Kompatibilität). Alternativen sind Scoop/Chocolatey oder npm.

# chocolatey (Windows)
choco install opencode

# scoop (Windows)
scoop install opencode

Docker (nützlich für einen schnellen Test):

docker run -it --rm ghcr.io/anomalyco/opencode

Installation überprüfen

opencode --version
opencode --help

Erwartete Ausgabeform (variiert je nach Version):

# Beispiel:
# <druckt eine Versionsnummer, z. B. vX.Y.Z>
# <druckt Hilfe mit verfügbaren Befehlen/Unterbefehlen>

Einen Anbieter verbinden (zwei praktische Wege)

Weg A: TUI /connect (interaktiv)

Starten Sie OpenCode:

opencode

Führen Sie dann aus:

/connect

Folgen Sie den UI-Schritten, um einen Anbieter auszuwählen und sich zu authentifizieren (einige Abläufe öffnen einen Browser/Gerätelogin).

Weg B: CLI opencode auth login (Anbieter-Keys)

OpenCode unterstützt die Konfiguration von Anbietern über:

opencode auth login

Hinweise:

  • Anmeldeinformationen werden unter ~/.local/share/opencode/auth.json gespeichert.
  • OpenCode kann Keys auch aus Umgebungsvariablen oder einer .env-Datei in Ihrem Projekt laden.

LLM-Hosting lokal (Ollama, llama.cpp)

OpenCode funktioniert mit jeder OpenAI-kompatiblen API. Für lokale Entwicklung führen viele Benutzer Ollama aus und zeigen OpenCode darauf. Ich hatte kürzlich sehr gute Erfahrungen mit der Konfiguration und dem Ausführen von OpenCode mit llama.cpp – llama-server stellt OpenAI-kompatible Endpunkte bereit, sodass Sie GGUF-Modelle mit dem gleichen Workflow verwenden können. Wenn Sie eine feingranulare Steuerung über Speicher und Laufzeit bevorzugen oder einen leichteren Stack ohne Python möchten (übrigens ist ollama in Go implementiert), ist llama.cpp值得一 thử. Ich habe die Möglichkeit, offgeladene Ebenen zu konfigurieren, die Benutzerfreundlichkeit der Modelle im GGUF-Format und die viel bessere/schnellere implementierte Kompatibilität mit neuen Modellen wie Qwen3.5 sehr genossen. Wenn Sie herausfinden möchten, welche Modelle in OpenCode tatsächlich gut funktionieren – über Coding-Aufgaben und Strukturierte-Ausgabe-Genauigkeit hinweg – siehe mein praktischer LLM-Vergleich für OpenCode.

Ein Projekt korrekt starten (empfohlener erster Lauf)

Aus Ihrem Repository:

cd /path/to/your/repo
opencode

Initialisieren Sie dann:

/init

Dies analysiert Ihr Projekt und erstellt eine AGENTS.md-Datei im Projektstamm. Es ist in der Regel sinnvoll, diese Datei zu committen, damit OpenCode (und Teammitglieder) einen konsistenten Projektkontext teilen.

Kerne-CLI-Workflows (Kopieren-Einfügen-Beispiele)

OpenCode unterstützt nicht-interaktive Läufe:

opencode run "Explain how closures work in JavaScript"

Für Kommandozeilen-Workflow-Muster – Einrühren von Git-Ausgaben, Makefile- und CI-Ziele, Berechtigungsrichtlinien für unbeaufsichtigte Läufe – und die zu erwartenden Fehlermodi, siehe den OpenCode CLI Praxisleitfaden. Er baut auf diesem Einstiegsleitfaden auf, wiederholt ihn aber nicht.

Workflow: Code generieren (CLI)

Ziel: Generieren Sie eine kleine, testbare Funktion mit minimalem Kontext.

opencode run "Write a Go function ParsePort(envVar string, defaultPort int) (int, error). It should read the env var, parse an int, validate 1-65535, and return defaultPort if empty. Include 3 table-driven tests."

Erwartete Ausgabe:

  • Eine Erklärung plus Code-Blöcke (Funktion + Tests). Der exakte Code variiert je nach Modell/Anbieter und Prompt.

Workflow: Eine Datei sicher refactorisieren (CLI + Plan-Agent)

Ziel: Bestätigen Sie, dass der restriktivere plan-Agent läuft, bevor Sie sich darauf verlassen.

opencode run --agent plan --file ./src/auth.ts \
  "Refactor this file to reduce complexity. Output a short plan only. Do not run commands."

Erwartete Ausgabe: ein Plan-Abschnitt, keine Dateibearbeitungen, keine ausgeführten Befehle.

Workflow: Repository-Fragen stellen (CLI)

Ziel: Bestätigen Sie, dass der explore-Agent Implementierungsdetails lokalisieren kann.

opencode run --agent explore \
  "Where is authentication validated for API requests in this repository?"

Erwartete Ausgabe: eine kurze Karte der Dateipfade und eine Flowsbeschreibung.

Beides sind One-Shot-Smoke-Tests. Für die eingeschränkte, produktionsreife Version der gleichen Aufgaben – explizite Risiko/Randfall-Ausgaben, Unified-Diff-Patches, berechtigungsbewusste Explorations-Prompts und was zu tun ist, wenn das Modell nicht konform handelt – siehe den Abschnitt “Beste OpenCode CLI Anwendungsfälle” im OpenCode CLI Praxisleitfaden.

Workflow: Wiederholte CLI-Läufe mit einem persistenten Server beschleunigen

Wenn Sie Skripte schreiben oder mehrere opencode run-Aufrufe ausführen, können Sie einen kopflosen Server einmal starten:

Terminal 1:

opencode serve --port 4096 --hostname 127.0.0.1

Terminal 2:

opencode run --attach http://localhost:4096 "Summarize the repo structure and main entrypoints."
opencode run --attach http://localhost:4096 "Now propose 3 high-impact refactors and why."

Erwartete Ausgabe:

  • Gleich wie opencode run, aber in der Regel mit weniger wiederholtem Start-Overhead.

Programmativer Gebrauch (offizielles JS/TS-SDK)

OpenCode stellt einen HTTP-Server (OpenAPI) bereit und bietet einen typsicheren JS/TS-Client.

Installation:

npm install @opencode-ai/sdk

Beispiel: Server + Client starten, dann Prompt senden

Erstellen Sie scripts/opencode-sdk-demo.mjs:

import { createOpencode } from "@opencode-ai/sdk";

const opencode = await createOpencode({
  hostname: "127.0.0.1",
  port: 4096,
  config: {
    // Modellzeichenkettenformat ist provider/model (nur Beispiel)
    // model: "anthropic/claude-3-5-sonnet-20241022",
  },
});

console.log(`Server läuft auf: ${opencode.server.url}`);

// Grundlegende Gesundheits-/Versionsprüfung
const health = await opencode.client.global.health();
console.log("Gesund:", health.data.healthy, "Version:", health.data.version);

// Sitzung erstellen und Prompt senden
const session = await opencode.client.session.create({ body: { title: "SDK quickstart demo" } });

const result = await opencode.client.session.prompt({
  path: { id: session.data.id },
  body: {
    parts: [{ type: "text", text: "Generate a small README section describing this repo." }],
  },
});

console.log(result.data);

// Server nach Abschluss schließen
opencode.server.close();

Ausführen:

node scripts/opencode-sdk-demo.mjs

Erwartete Ausgabeform:

  • „Server läuft auf …“
  • Eine Gesundheitsantwort, die einen Versionsstring enthält
  • Eine Sitzungs-Prompt-Antwortobjekt (exakte Struktur hängt von responseStyle und SDK-Version ab)

Minimale OpenCode-Konfiguration, die Sie kopieren können

OpenCode unterstützt JSON- und JSONC-Konfiguration. Dies ist ein sinnvoller Startpunkt für eine projektlokale Konfiguration.

Erstellen Sie opencode.jsonc im Stammverzeichnis Ihres Repositories:

{
  "$schema": "https://opencode.ai/config.json",

  // Wählen Sie ein Standardmodell (provider/model). Passen Sie dies an, was `opencode models` anzeigt, an.
  "model": "provider/model",

  // Optional: ein billigeres „kleines Modell“ für leichte Aufgaben (Titel, etc.)
  "small_model": "provider/small-model",

  // Optional: OpenCode-Server-Standardwerte (verwendet von serve/web)
  "server": {
    "port": 4096,
    "hostname": "127.0.0.1"
  },

  // Optionale Sicherheit: Bestätigung vor Bearbeitungen/Befehlen verlangen
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Für eine vollständigere Berechtigungsrichtlinie, die auf unbeaufsichtigte opencode run-Jobs abzielt, siehe den OpenCode CLI Praxisleitfaden.

Projektgedächtnis über Sitzungen hinweg ist eine separate Installation. Hindsight Memory für OpenCode, Cursor und andere Coding-Agenten fügt das Plugin zur benutzerbezogenen ~/.config/opencode/opencode.json hinzu, einer anderen Datei als der obigen Projektkonfiguration opencode.jsonc.

Kurzer Spickzettel (Schnellreferenz)

Befehle, die Sie täglich verwenden werden

opencode                       # TUI starten
opencode run "..."             # nicht-interaktiver Lauf (Automatisierung)
opencode run --file path "..." # Dateien an Prompt anhängen
opencode models --refresh      # Modellliste aktualisieren
opencode auth login            # Anbieter-Anmeldeinformationen konfigurieren
opencode serve                 # kopfloser HTTP-Server (OpenAPI)
opencode web                   # kopfloser Server + Weboberfläche
opencode session list          # Sitzungen auflisten
opencode stats                 # Token/Kostenstatistiken

TUI-Befehle, die es sich lohnt, zu merken

/connect   # Anbieter verbinden
/init      # Repository analysieren, AGENTS.md generieren
/share     # Sitzung teilen (falls aktiviert)
/undo      # Änderung rückgängig machen
/redo      # Änderung wiederherstellen
/help      # Hilfe/Shortcuts

Standard-„Leader-Key“-Konzept (TUI)

OpenCode verwendet eine konfigurierbare „Leader“-Taste (häufig ctrl+x), um Terminalkonflikte zu vermeiden. Viele Shortcuts sind „Leader + Taste“.

Einseitige druckbare OpenCode-Spickzettel-Tabelle

Diese Version ist absichtlich dicht und „druckfreundlich“. (Sie können sie später in eine dedizierte /ai-devtools/opencode/cheatsheet/-Seite einfügen.)

Aufgabe Befehl / Shortcut Hinweise
TUI starten opencode Standardverhalten ist das Starten der Terminalschnittstelle
One-Shot-Prompt ausführen opencode run "..." Nicht-interaktiver Modus für Scripting/Automatisierung
Datei(en) an Prompt anhängen opencode run --file path/to/file "..." Verwenden Sie mehrere --file-Flags für mehrere Dateien
Modell für einen Lauf wählen opencode run --model provider/model "..." Modellstrings sind provider/model
Agenten wählen opencode run --agent plan "..." Plan ist für sicherere „keine Änderungen“-Arbeiten konzipiert (berechtigungsbeschränkt)
Modelle auflisten opencode models [provider] Verwenden Sie --refresh, um die zwischengespeicherte Liste zu aktualisieren
Anbieter-Anmeldeinformationen konfigurieren opencode auth login Speichert Anmeldeinformationen in ~/.local/share/opencode/auth.json
Authentifizierte Anbieter auflisten opencode auth list / opencode auth ls Bestätigt, was OpenCode sieht
Kopflosen Server starten opencode serve --port 4096 --hostname 127.0.0.1 OpenAPI-Spezifikation unter http://host:port/doc
Läufe an Server anhängen opencode run --attach http://localhost:4096 "..." Nützlich, um wiederholte Kaltstarts zu vermeiden
Basis-Authentifizierung aktivieren OPENCODE_SERVER_PASSWORD=... opencode serve Benutzername ist standardmäßig opencode, es sei denn, überschrieben
Weboberflächen-Modus opencode web Startet Server + öffnet Browser
Sitzung exportieren opencode export [sessionID] Nützlich für Archivierung oder Kontextteilen
Sitzung importieren opencode import session.json Kann auch aus einer Share-URL importieren
Globale CLI-Flags anzeigen opencode --help / opencode --version --print-logs + --log-level für Debugging
TUI Leader-Key-Konzept Standard-Leader-Key oft ctrl+x In tui.json anpassbar

Oh My Opencode – OpenCode mit Multi-Agenten-Orchestrierung weiterführen

Sobald OpenCode läuft, ist der natürliche nächste Schritt Oh My Opencode – ein Community-Plugin, das OpenCode in einem Multi-Agenten-Harness einwickelt. Die Hauptidee: Geben Sie in einer Sitzung ultrawork (oder ulw) ein, und ein Orchestrierer (Sisyphus) übernimmt und delegiert Unteraufgaben an Spezialisten-Agenten, die parallel laufen, jeder auf der Modellfamilie, für die seine Prompts optimiert sind.

Drei Artikel behandeln dies im Detail:

OpenCode war eines der ersten Werkzeuge, das von Anthropics Politik betroffen war, die den Zugriff auf Claude-Abonnements durch Dritte blockierte – ein Schritt, der im Januar 2026 unternommen wurde, einen Monat bevor dieselbe Einschränkung OpenClaw traf. Die Zeitleiste des Aufstiegs und Falls von OpenClaw dokumentiert beide Ereignisse und das breitere Muster, das sie für Agenten-Werkzeuge darstellen, die auf Abonnement-Compute aufgebaut sind.

Quellen (offiziell zuerst)

Offiziell:

Autoritative Integrationsreferenz:

Renommierte Vergleiche/Tutorials:

Abonnieren

Neue Beiträge zu Systemen, Infrastruktur und KI-Engineering.