Häufige Probleme Fehlerbehebung

Dieser Artikel fasst die häufigsten Probleme und Lösungen bei der Verwendung von Opencode zusammen.

Installations- und Startprobleme

Problem 1: Kann nach Installation nicht starten

Symptome:

  • Doppelklick auf Symbol hat keine Reaktion
  • Befehlszeilenausführung meldet Fehler
  • Stürzt sofort nach dem Start ab

Lösungen:

macOS:

# Prüfen, ob vom System blockiert
xattr -d com.apple.quarantine /Applications/Opencode.app

# Neu installieren
brew uninstall opencode
brew install anomalyco/tap/opencode

# Version prüfen
opencode --version

Windows:

# Als Administrator ausführen
choco uninstall opencode
choco install opencode

Linux:

# Abhängigkeiten prüfen
ldd /usr/bin/opencode

# Fehlende Abhängigkeiten installieren
sudo apt-get install -f

# Berechtigungen prüfen
chmod +x /usr/bin/opencode

Problem 2: Langsamer Start oder Verzögerung

Symptome:

  • Start dauert lange
  • Hohe CPU-Auslastung nach Öffnen des Ordners
  • Langsame Schnittstellenreaktion

Lösung:

~/.config/opencode/opencode.json bearbeiten:

{
  "watcher": {
    "ignore": [
      "node_modules/**",
      "dist/**",
      "build/**",
      ".git/**",
      "*.log"
    ]
  }
}

Opencode neu starten, damit Änderungen wirksam werden.

Problem 3: Version zu alt

Version prüfen:

opencode --version

Anforderung: Version muss >= 1.0.150 sein

Aktualisierungsmethoden:

macOS:

brew upgrade opencode

Windows:

choco upgrade opencode

Linux:

curl -fsSL https://opencode.ai/install | bash

Konfigurationsprobleme

Problem 4: JSON-Konfigurationsanalyse fehlgeschlagen

Symptome:

  • Konfiguration wird nicht wirksam
  • Startfehler: JSON parse error

Mögliche Ursachen:

  1. JSON-Syntaxfehler
  2. Kommentare in .json-Datei geschrieben

Lösungen:

Methode 1: JSONC-Format verwenden

Datei in .jsonc umbenennen:

mv ~/.config/opencode/opencode.json ~/.config/opencode/opencode.jsonc

Methode 2: JSON-Syntax validieren

Online-Tool verwenden: jsonlint.com

❌ Falsch:

{
  "model": "claude-sonnet-4-5",  // Kommentare nicht erlaubt
  "theme": "dark",               // Letztes Element hat Komma
}

✅ Richtig:

{
  "model": "claude-sonnet-4-5",
  "theme": "dark"
}

Problem 5: Konfigurationsänderungen werden nicht wirksam

Fehlerbehebungsschritte:

1. Konfigurationsdateispeicherort bestätigen:

# macOS/Linux
ls -la ~/.config/opencode/

# Windows
dir %USERPROFILE%\.config\opencode\

2. Konfigurationspriorität prüfen:

Priorität (niedrig bis hoch):

  1. Globale Konfiguration
  2. Projektkonfiguration
  3. Projektverzeichniskonfiguration

3. Konfiguration validieren:

opencode config list

4. Opencode neu starten

Provider- und Authentifizierungsprobleme

Problem 6: Ungültiger API-Schlüssel

Lösungen:

1. API-Schlüssel prüfen:

cat ~/.config/opencode/auth.json

2. Neu authentifizieren:

opencode auth login

3. Netzwerkverbindung prüfen:

curl https://api.anthropic.com/v1/messages

Problem 7: Ollama-Verbindung fehlgeschlagen

Lösungen:

1. Bestätigen, dass Ollama läuft:

# Ollama-Prozess prüfen
ps aux | grep ollama

# Ollama starten
ollama serve

2. Port prüfen:

curl http://localhost:11434/api/tags

3. Konfiguration prüfen:

{
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      }
    }
  }
}

4. Bestätigen, dass Modell heruntergeladen ist:

ollama list
ollama pull llama3

Leistungsprobleme

Problem 8: Token-Limit überschritten

Lösungen:

Methode 1: Manuelle Komprimierung

/compact

Methode 2: Auto-Komprimierung aktivieren

{
  "compaction": {
    "auto": true,
    "prune": true
  }
}

Methode 3: Größeres Modell verwenden

Methode 4: Neue Sitzung starten

/new

Problem 9: Langsame Antwortgeschwindigkeit

Lösungen:

1. Netzwerk prüfen:

ping api.anthropic.com

2. Zu schnellerem Modell wechseln:

{
  "small_model": "anthropic/claude-haiku-4-5"
}

3. Lokales Modell verwenden:

{
  "model": "ollama/deepseek-coder"
}

Berechtigungsprobleme

Problem 10: Kann Dateien nicht lesen/ändern

Lösungen:

1. Berechtigungskonfiguration prüfen:

opencode config get permission

2. Berechtigungen vorübergehend erhöhen:

In Konversation explizit angeben:

Ich bestätige diese Operation, bitte Berechtigungsbeschränkungen ignorieren

3. Berechtigungskonfiguration ändern:

{
  "permission": {
    "read": {"*": "allow"},
    "edit": "ask",
    "bash": "ask"
  }
}

Diagnosetools

Gesundheitscheck

Diagnosebefehle ausführen:

opencode config validate
opencode provider list
opencode agent list

Debug-Modus

Ausführliche Protokollierung aktivieren:

{
  "logging": {
    "level": "debug"
  }
}

Hilfe erhalten

Wenn keine der oben genannten Methoden das Problem löst:

  1. Offizielle Dokumentation ansehen: opencode.ai/docs
  2. Community durchsuchen: OpenCodex Community
  3. Fragen stellen: In GitHub Issues oder Community-Forum fragen
  4. Support kontaktieren: E-Mail an offiziellen Support senden

Nächste Schritte

Zusammengestellt von der OpenCodex-Community.

Zuletzt aktualisiert: