Zum Inhalt

OpenCode Troubleshooting

Stand: 2026-05-27

MCP ist rot

Wahrscheinliche Ursachen:

  • LANSTYLE_MCPHUB_TOKEN fehlt.
  • Token ist abgelaufen oder deaktiviert.
  • OpenCode wurde gestartet, bevor die ENV geladen war.
  • Falscher MCP-Pfad: richtig ist https://mcphub.lanstyle.de/lanstyle-mcp.
  • OAuth-Pfad statt Remote-MCP-Pfad genutzt.

Sicherer Check:

OpenCode neu starten, ENV erneut laden, Tool Listing pruefen.

Nicht tun:

  • keinen Token in Chat oder Ticket posten
  • nicht auf /mcp oder OAuth-Login ausweichen
  • keine internen 10.x-Ziele eintragen

invalid_token / 401

Der Token ist falsch, abgelaufen, deaktiviert oder nicht geladen.

Naechste Aktion:

  1. ENV laden.
  2. OpenCode neu starten.
  3. Falls weiterhin 401: neuen Token ueber Admin/Vaultwarden anfordern.

403

Der Token ist gueltig, darf diese Aktion oder dieses Modell aber nicht nutzen.

Beispiele:

  • Operator-Key darf entfernt nicht sehen.
  • Operator darf keine scoped writes ausfuehren.
  • Tool braucht Approval oder andere Rolle.

Naechste Aktion:

  • Pruefen, ob die Aktion wirklich zum Operator-Profil gehoert.
  • Bei Bedarf Approval Preview erstellen, nicht improvisieren.

OAuth Popup

Falscher MCP-Endpunkt oder falsche Config.

Richtig:

"url": "https://mcphub.lanstyle.de/lanstyle-mcp",
"oauth": false

Keine Modelle sichtbar

Pruefen:

  • LITELLM_API_KEY geladen?
  • OpenCode neu gestartet?
  • Provider ist lanstyle-litellm?
  • Base URL ist https://litellm.lanstyle.de/v1?

OpenCode startet ohne ENV

macOS:

  • launchctl getenv LITELLM_API_KEY
  • launchctl getenv LANSTYLE_MCPHUB_TOKEN
  • danach OpenCode komplett beenden und neu starten

Windows:

  • PowerShell-Session pruefen
  • User-ENV pruefen
  • abmelden/anmelden oder OpenCode aus neuer Sitzung starten

Streaming leer / finish=length

Normale Operatoren nutzen lanstyle/agent-stable. Wenn Streaming leer ist:

  • pruefen, ob versehentlich lanstyle/agent genutzt wurde
  • Prompt kuerzer machen
  • strukturiertes JSON oder kurze Operator Summary anfordern
  • keine langen Architekturaufgaben mit Fast-/Operator-Modell erzwingen

lanstyle/agent ist experimentell. entfernt ist admin-only und kein Operator-Default.

PTY session not found

Das betrifft meist Open Terminal Sessions.

Naechste Aktion:

  • neue Session starten
  • nicht denselben alten Session-Key wiederverwenden
  • bei Wiederholung Open Terminal Healthcheck melden

LaunchAgent nicht geladen

macOS:

launchctl list | grep -i opencode
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.lanstyle.opencodeenv.plist
launchctl kickstart -k gui/$(id -u)/com.lanstyle.opencodeenv

Windows ENV fehlt

PowerShell:

[Environment]::GetEnvironmentVariable('LITELLM_API_KEY', 'User')
[Environment]::GetEnvironmentVariable('LANSTYLE_MCPHUB_TOKEN', 'User')

Wenn leer: Setup-Skript erneut ausfuehren, danach neue PowerShell/OpenCode-Sitzung starten.