OpenCode installieren und nutzen: CLI, TUI, API-Schlüssel, erste Repo-Aufgabe

OpenCode-CLI/TUI installieren, einen Schlüssel verbinden, dann die erste Aufgabe im echten Repo.

Gewünscht ist ein Open-Source-Agent im Terminal, der ein Repo liest und Dateien ändert — ohne weiteren Browser-Chat.

Dieser Durchgang behandelt Installation und Nutzung von OpenCode: CLI/TUI installieren, mit /connect oder opencode auth login anmelden oder einen API-Schlüssel einfügen, dann die erste Aufgabe im echten Repo. Schritte nach Intro, Providers und CLI auf opencode.ai/docs.

Für wen es taugt

OpenCode ist ein quelloffener Terminal-Agent: opencode ohne Argumente startet die TUI, die CLI existiert parallel. Desktop und IDE stehen in der Doku; dieser Text bleibt im Terminal. Für den ersten Lauf: moderner Emulator plus ein funktionierender Modellschlüssel.

Installieren, authentifizieren, erste Aufgabe

1. 1

   CLI installieren und TUI öffnen

   Unter macOS/Linux/WSL curl -fsSL https://opencode.ai/install | bash, npm install -g opencode-ai oder brew install anomalyco/tap/opencode (der anomalyco-Tap ist die dokumentiert aktuellere Formel). Natives Windows: Chocolatey, Scoop oder npm; volle Kompatibilität laut Doku über WSL. Prüfen mit opencode --version, starten mit opencode.

2. 2

   Anmelden oder API-Schlüssel setzen

   In der TUI /connect. Neue Nutzer wählen OpenCode Zen, melden sich auf opencode.ai/auth an, hinterlegen Abrechnung und fügen den Schlüssel ein — oder OpenAI, Anthropic, andere. CLI: opencode auth login. Prüfen: opencode auth list. Auch Umgebung oder Projekt-.env.

3. 3

   Erste Aufgabe im Repo

   Ins Projekt cd, opencode, dann /init für AGENTS.md. Erstes Prompt: „Repo-Aufbau in drei Punkten, plus ein kleiner Test.“ Kleiner Edit: ein Zeilenkommentar, gleiches Verhalten. Diff lesen. /undo möglich. Skripte: opencode run.

curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
# or: brew install anomalyco/tap/opencode

opencode --version

# Auth (pick one):
# In the TUI:  /connect   → provider or OpenCode Zen → paste API key
# CLI:         opencode auth login
# Check:       opencode auth list
# Keys live in ~/.local/share/opencode/auth.json  (do not commit)

cd /path/to/your/repo
opencode
# In the TUI:  /init     → writes AGENTS.md (ok to commit)
# First task:  Explain the repo layout in three bullets and name one small test I can add
# Small edit:  Add a one-line comment to the main entry file; do not change behavior
# Undo:        /undo

# Non-interactive alternative:
# opencode run "Explain README.md in three bullets and suggest one small test"

Was den ersten Lauf stoppt

Kaputte TUI oder tote Shortcuts

Die Doku will einen modernen Emulator: WezTerm, Alacritty, Ghostty, Kitty. Schlechte System-Terminals zuerst tauschen.

auth.json wie ein Passwortbuch

Standard: ~/.local/share/opencode/auth.json. Nicht ins öffentliche Repo. Schlüssel schon in Git: in der Konsole rotieren.

Windows wirkt unvollständig

Offiziell für volle Kompatibilität: WSL. Chocolatey / Scoop / npm installieren ein natives Binary. Windows-Abschnitt lesen.

Offizielle Erinnerung: API zu Anbieter- oder Zen-Tarifen. /init und /undo mit günstigem Modell lernen, dann das Modell, für das Sie zahlen wollen.

Wenn der Diff gesprochen werden muss

Oft fehlt ein Bild. Kurzen Raum auf tidemeet oder Raum erstellen. Canvas: Whiteboard. Weitere Guides: Aider, Codex CLI.

Fragen