Zum Inhalt

OpenCode Operator Quickstart

Stand: 2026-05-27

Ziel

Dieser Quickstart richtet sich an interne Operatoren. Nach der Einrichtung nutzt OpenCode ausschliesslich zentrale HTTPS-Endpunkte:

  • LiteLLM: https://litellm.lanstyle.de/v1
  • Lanstyle Remote MCP: https://mcphub.lanstyle.de/lanstyle-mcp

Es werden keine direkten 10.x-, VLAN70-, GB10- oder Ollama-Ziele im Client eingetragen.

Voraussetzungen

Du brauchst von einem Administrator:

  • deinen persoenlichen LiteLLM API-Key
  • deinen persoenlichen MCP Bearer Token
  • optional einen Context7 API-Key
  • die Operator-Konfiguration opencode.operator.jsonc

Tokenwerte kommen aus Vaultwarden. Sie werden nicht per Chat, Ticket, Screenshot oder Git geteilt.

Schnellstart

  1. OpenCode installieren.
  2. Config-Verzeichnis anlegen.

macOS:

mkdir -p ~/.config/opencode

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\\.config\\opencode" | Out-Null
  1. Operator-Profil als opencode.jsonc ablegen.
  2. secrets.env lokal anlegen.
  3. OpenCode neu starten.
  4. Modellliste pruefen.
  5. MCP Tool Listing pruefen.
  6. Einen read-only Tool Call ausfuehren.
  7. Einen Preflight/Plan-only Tool Call ausfuehren.

secrets.env

Beispiel ohne echte Werte:

LITELLM_API_KEY="PASTE_LITELLM_USER_KEY_HERE"
LANSTYLE_MCPHUB_TOKEN="PASTE_MCP_USER_TOKEN_HERE"
CONTEXT7_API_KEY="OPTIONAL_CONTEXT7_KEY_HERE"

macOS:

chmod 600 ~/.config/opencode/secrets.env

Windows:

icacls "$env:USERPROFILE\\.config\\opencode\\secrets.env" /inheritance:r
icacls "$env:USERPROFILE\\.config\\opencode\\secrets.env" /grant:r "$($env:USERNAME):(R,W)"

Erste Tests

In OpenCode:

  1. Frage: Welche Modelle sind verfuegbar?
  2. Frage: Antworte mit kurzem JSON {"ok":true}.
  3. MCP Tool Listing oeffnen.
  4. Read-only Tool: netbox_get_status
  5. Preflight Tool: proxmox_plan_guest_change

Erwartung:

  • Default-Modell ist lanstyle/agent-stable.
  • lanstyle/agent und entfernt sind im Operator-Profil nicht sichtbar.
  • MCP ist gruen und nutzt keinen OAuth-Browserlogin.
  • Es werden keine lokalen bash- oder edit-Aktionen erlaubt.

Wann welches Tool?

Tool Nutzung
OpenCode Operator-Profil lokale Operator-Arbeit, Read-only, Preflight, Approval Preview
OpenCode Admin-Profil Admins mit lokaler Datei-/Shell-Arbeit im Projektkontext
Open WebUI Chat, Team-Nutzung, Wissenssuche, einfache Tools

Normale Benutzer starten mit dem Operator-Profil.