Anleitung

OpenCode installieren und einrichten

Der offiziell empfohlene Weg ist ein Zeilenbefehl: `curl -fsSL https://opencode.ai/install | bash`. Wer lieber über eine Paketverwaltung geht, nimmt `npm install -g opencode-ai` oder unter macOS `brew install anomalyco/tap/opencode`; die Dokumentation nennt außerdem Chocolatey, Scoop und Docker. Danach fehlt nur noch der Zugang zu einem Modell — OpenCode bringt keinen eigenen mit, sondern nutzt Ihren API-Schlüssel bei einem beliebigen Anbieter.

Deutsch · Zuletzt geprüft: 2026-09-05 · Englische Vollversion: English

Schritt 1: Installieren

# empfohlen (macOS, Linux, WSL)
curl -fsSL https://opencode.ai/install | bash

# npm, plattformübergreifend
npm install -g opencode-ai

# Homebrew
brew install anomalyco/tap/opencode
Befehle wörtlich aus der OpenCode-Dokumentation, abgerufen am 5. September 2026.

Unter Windows sind laut Dokumentation Chocolatey und Scoop die vorgesehenen Wege; wer bereits mit WSL arbeitet, nimmt dort einfach den Linux-Befehl. Der Docker-Weg ist für den Fall gedacht, dass der Agent in einer isolierten Umgebung laufen soll — was in Firmenumgebungen häufig genau die Bedingung ist, unter der eine Freigabe überhaupt erteilt wird.

Schritt 2: Anbieter verbinden

OpenCode ist anbieterunabhängig und funktioniert laut Dokumentation mit jedem LLM-Anbieter über dessen API-Schlüssel. Praktisch heißt das: Sie brauchen vor der ersten Sitzung einen gültigen Schlüssel. Wer nicht selbst auswählen möchte, welches Modell für welche Aufgabe taugt, kann laut Dokumentation „OpenCode Zen" verwenden — dort sind Modelle kuratiert und vorgetestet.

Kosten liegen bei Ihnen

Anders als bei einem Abo gibt es hier keine Obergrenze durch den Tarif. Der Schlüssel gehört Ihnen, die Rechnung auch. Setzen Sie beim Anbieter ein Ausgabenlimit, bevor Sie den Agenten das erste Mal auf eine große Codebasis loslassen — das ist der Fehler, der am häufigsten teuer wird.

Schritt 3: Erste Sitzung

Wechseln Sie in ein Projektverzeichnis und starten Sie OpenCode dort. Halten Sie die erste Aufgabe klein und überprüfbar: eine Datei erklären lassen, einen Test ergänzen, eine Funktion umbenennen. So sehen Sie an einem überschaubaren Diff, ob Modellwahl und Kontext stimmen, bevor Sie größere Änderungen anstoßen.

Wenn etwas nicht funktioniert

  • Der Befehl wird nach der Installation nicht gefunden: Das Installationsskript legt die Binärdatei in einem Verzeichnis ab, das in Ihrer PATH-Variable stehen muss. Terminal neu öffnen oder die Shell-Konfiguration neu laden.
  • Anmeldung schlägt fehl: Prüfen Sie, ob der Schlüssel beim richtigen Anbieter angelegt wurde und ob dort noch Guthaben vorhanden ist. OpenCode kann einen leeren Anbieter-Account nicht von einem falschen Schlüssel unterscheiden.
  • Antworten wirken kontextlos: Der Agent sieht nur, was er gelesen hat. Nennen Sie Dateien und Verzeichnisse explizit, statt zu erwarten, dass er das ganze Projekt kennt.
  • Zu hohe Kosten: kleineres Modell wählen und den Kontext begrenzen. Die teuersten Sitzungen sind fast immer die, die zu viel eingelesen haben.

Und danach?

Wenn die erste Sitzung läuft, lohnt sich der Blick auf zwei Dinge: die MCP-Anbindung, über die der Agent an externe Datenquellen und Werkzeuge kommt, und der direkte Vergleich mit Claude Code, falls Sie noch zwischen den beiden schwanken. Beides ist auf Deutsch verlinkt.

Häufige Fragen

Wie installiere ich OpenCode unter Windows?
Die Dokumentation nennt Chocolatey und Scoop als Windows-Paketverwaltungen; alternativ funktioniert `npm install -g opencode-ai`. Wer WSL nutzt, führt dort einfach den Linux-Befehl `curl -fsSL https://opencode.ai/install | bash` aus.
Brauche ich einen eigenen API-Schlüssel für OpenCode?
Ja. OpenCode bringt kein eigenes Modell und kein Abo mit; es arbeitet laut Dokumentation mit jedem LLM-Anbieter über dessen API-Schlüssel. Ohne gültigen Schlüssel bei mindestens einem Anbieter startet keine sinnvolle Sitzung.
Wie viel kostet der Betrieb von OpenCode?
Die Software selbst kostet nichts, sie ist quelloffen. Die laufenden Kosten sind ausschließlich die Modellkosten Ihres Anbieters und hängen davon ab, welches Modell Sie wählen und wie viel Kontext jede Sitzung einliest. Ein Ausgabenlimit beim Anbieter ist die einzige verlässliche Obergrenze.
Was ist OpenCode Zen?
Laut Dokumentation eine Auswahl kuratierter, vorgetesteter Modelle, die OpenCode empfiehlt, wenn man nicht selbst durch den Anbieterkatalog gehen möchte. Sie bleiben aber frei, stattdessen einen eigenen Anbieter zu konfigurieren.

Quellen