Fehlerbehebung

Hufige Probleme und wie man sie lst.

Um Probleme mit OpenCode zu debuggen, knnen Sie die Protokolle oder die Sitzungsdaten berprfen, die lokal gespeichert werden.

Protokolle

Protokolldateien werden geschrieben in:

macOS/Linux: ~/.local/share/opencode/log/
Windows: %USERPROFILE%\.local\share\opencode\log\

Protokolldateien werden mit Zeitstempeln benannt (z. B. 2025-01-09T123456.log) und die neuesten 10 Protokolldateien werden gespeichert.

Sie knnen die Protokollebene mit der Befehlszeilenoption --log-level festlegen, um detailliertere Debug-Informationen zu erhalten. Zum Beispiel opencode --log-level DEBUG.

Speicher

opencode speichert Sitzungsdaten und andere Anwendungsdaten auf der Festplatte unter:

macOS/Linux: ~/.local/share/opencode/
Windows: %USERPROFILE%\.local\share\opencode

Dieses Verzeichnis enthlt:

auth.json - Authentifizierungsdaten wie API-Schlssel, OAuth-Tokens
log/ - Anwendungsprotokolle
project/ - Projektspezifische Daten wie Sitzungs- und Nachrichtendaten
- Wenn sich das Projekt in einem Git-Repository befindet, wird es in ./<project-slug>/storage/ gespeichert
- Wenn es kein Git-Repository ist, wird es in ./global/storage/ gespeichert

Hilfe erhalten

Wenn Sie Probleme mit OpenCode haben:

Probleme auf GitHub melden

Der beste Weg, um Fehler zu melden oder Funktionen zu fordern, ist ber unser GitHub-Repository:

github.com/anomalyco/opencode/issues

Suchen Sie vor dem Erstellen eines neuen Problems nach bestehenden Problemen, um zu sehen, ob Ihr Problem bereits gemeldet wurde.
Treten Sie unserem Discord bei

Fr Echtzeit-Hilfe und Gemeinschaftsdiskussionen treten Sie unserem Discord-Server bei:

opencode.ai/discord

Hufige Probleme

Hier sind einige hufige Probleme und wie man sie lst.

OpenCode startet nicht

berprfen Sie die Protokolle auf Fehlermeldungen
Versuchen Sie, mit --print-logs auszufhren, um die Ausgabe im Terminal zu sehen
Stellen Sie sicher, dass Sie die neueste Version mit opencode upgrade haben

Authentifizierungsprobleme

Versuchen Sie, sich mit dem /connect-Befehl im TUI erneut zu authentifizieren
berprfen Sie, ob Ihre API-Schlssel gltig sind
Stellen Sie sicher, dass Ihr Netzwerk Verbindungen zur API des Anbieters zulsst

Modell nicht verfgbar

berprfen Sie, ob Sie beim Anbieter authentifiziert sind
berprfen Sie, ob der Modellname in Ihrer Konfiguration korrekt ist
Einige Modelle bentigen mglicherweise spezifischen Zugang oder Abonnements

Wenn Sie auf ProviderModelNotFoundError stoßen, referenzieren Sie wahrscheinlich falsch ein Modell. Modelle sollten wie folgt referenziert werden: <providerId>/<modelId>

Beispiele:

openai/gpt-4.1
openrouter/google/gemini-2.5-flash
opencode/kimi-k2

Um herauszufinden, auf welche Modelle Sie Zugriff haben, fhren Sie opencode models aus

ProviderInitError

Wenn Sie auf einen ProviderInitError stoßen, haben Sie wahrscheinlich eine ungltige oder beschdigte Konfiguration.

Um dies zu beheben:

berprfen Sie zuerst, ob Ihr Anbieter korrekt eingerichtet ist, indem Sie dem Anbieter-Leitfaden folgen
Wenn das Problem besteht, versuchen Sie, Ihre gespeicherte Konfiguration zu lschen:
Terminal-Fenster
```
rm -rf ~/.local/share/opencode
```
Authentifizieren Sie sich erneut mit Ihrem Anbieter, indem Sie den /connect-Befehl im TUI verwenden.

AI_APICallError und Anbieter-Paket-Probleme

Wenn Sie API-Aufruffehler erhalten, kann dies an veralteten Anbieter-Paketen liegen. opencode installiert Anbieter-Pakete (OpenAI, Anthropic, Google, usw.) dynamisch nach Bedarf und speichert sie lokal zwischen.

Um Anbieter-Paket-Probleme zu beheben:

Leeren Sie den Anbieter-Paket-Cache:
Terminal-Fenster
```
rm -rf ~/.cache/opencode
```
Starten Sie opencode neu, um die neuesten Anbieter-Pakete neu zu installieren

Dies zwingt opencode, die neuesten Versionen der Anbieter-Pakete herunterzuladen, was hufig Kompatibilittsprobleme mit Modellparametern und API-nderungen lst.

Kopieren/Einfgen funktioniert nicht unter Linux

Linux-Benutzer mssen eines der folgenden Zwischenablage-Tools installiert haben, damit die Kopier-/Einfgen-Funktionalitt funktioniert:

Fr X11-Systeme:

apt install -y xclip
# oder
apt install -y xsel

Fr Wayland-Systeme:

apt install -y wl-clipboard

Fr headless-Umgebungen:

apt install -y xvfb
# und fhren Sie aus:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

opencode erkennt, ob Sie Wayland verwenden, und bevorzugt wl-clipboard, andernfalls versucht es, Zwischenablage-Tools in der Reihenfolge zu finden: xclip und xsel.