Modi

Unterschiedliche Modi fr verschiedene Anwendungsfälle.

Modi in opencode ermglichen es Ihnen, das Verhalten, die Tools und die Prompts fr verschiedene Anwendungsflle anzupassen.

Es wird mit zwei integrierten Modi geliefert: build und plan. Sie knnen diese anpassen oder Ihre eigenen ber die opencode-Konfiguration konfigurieren.

Sie knnen whrend einer Sitzung zwischen Modi wechseln oder sie in Ihrer Konfigurationsdatei konfigurieren.

Integriert

opencode wird mit zwei integrierten Modi geliefert.

Build

Build ist der Standard-Modus mit allen aktivierten Tools. Dies ist der Standardmodus fr Entwicklungsarbeiten, bei denen Sie vollstndigen Zugriff auf Dateioperationen und Systembefehle bentigen.

Plan

Ein eingeschrnkter Modus, der fr Planung und Analyse konzipiert ist. Im Plan-Modus sind die folgenden Tools standardmig deaktiviert:

write - Kann keine neuen Dateien erstellen
edit - Kann vorhandene Dateien nicht ndern
patch - Kann keine Patches anwenden
bash - Kann keine Shell-Befehle ausfhren

Dieser Modus ist ntzlich, wenn Sie mchten, dass die KI Code analysiert, nderungen vorschlgt oder Plne erstellt, ohne nderungen an Ihrer Code-Basis vorzunehmen.

Wechseln

Sie knnen whrend einer Sitzung zwischen Modi wechseln, indem Sie die Tab-Taste drcken. Oder Ihr konfiguriertes switch_mode-Keybinding.

Siehe auch: Formatierer fr Informationen zur Code-Formatierungskonfiguration.

Konfigurieren

Sie knnen die integrierten Modi anpassen oder Ihre eigenen ber die Konfiguration erstellen. Modi knnen auf zwei Arten konfiguriert werden:

JSON-Konfiguration

Konfigurieren Sie Modi in Ihrer opencode.json-Konfigurationsdatei:

{
  "$schema": "https://opencode.ai/config.json",
  "mode": {
    "build": {
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "{file:./prompts/build.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    }
  }
}

Markdown-Konfiguration

Sie knnen Modi auch mit Markdown-Dateien definieren. Platzieren Sie sie in:

Global: ~/.config/opencode/mode/
Projekt: .opencode/mode/

---
model: anthropic/claude-sonnet-4-20250514
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
---

Sie befinden sich im Code-Review-Modus. Konzentrieren Sie sich auf:

- Code-Qualitt und Best Practices
- Mgliche Bugs und Randflle
| Leistungsimplikationen
- Sicherheitsberlegungen

Geben Sie konstruktives Feedback, ohne direkte nderungen vorzunehmen.

Der Markdown-Dateiname wird zum Modusnamen (z. B. erstellt review.md einen review-Modus).

Sehen wir uns diese Konfigurationsoptionen im Detail an.

Verwenden Sie die Konfiguration model, um das Standardmodell fr diesen Modus zu berschreiben. Ntzlich, um verschiedene Modelle zu verwenden, die fr verschiedene Aufgaben optimiert sind. Zum Beispiel ein schnelleres Modell fr die Planung, ein fhigeres Modell fr die Implementierung.

{
  "mode": {
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514"
    }
  }
}

Temperatur

Steuern Sie die Zuflligkeit und Kreativitt der KI-Antworten mit der Konfiguration temperature. Niedrigere Werte machen die Antworten fokussierter und deterministischer, whrend hhere Werte die Kreativitt und Variabilitt erhhen.

{
  "mode": {
    "plan": {
      "temperature": 0.1
    },
    "creative": {
      "temperature": 0.8
    }
  }
}

Temperaturwerte reichen normalerweise von 0,0 bis 1,0:

0,0-0,2: Sehr fokussierte und deterministische Antworten, ideal fr Code-Analyse und Planung
0,3-0,5: Ausgewogene Antworten mit etwas Kreativitt, gut fr allgemeine Entwicklungsaufgaben
0,6-1,0: Kreativere und abwechslungsreichere Antworten, ntzlich fr Brainstorming und Erkundung

{
  "mode": {
    "analyze": {
      "temperature": 0.1,
      "prompt": "{file:./prompts/analysis.txt}"
    },
    "build": {
      "temperature": 0.3
    },
    "brainstorm": {
      "temperature": 0.7,
      "prompt": "{file:./prompts/creative.txt}"
    }
  }
}

Wenn keine Temperatur angegeben ist, verwendet opencode modellspezifische Standardwerte (normalerweise 0 fr die meisten Modelle, 0,55 fr Qwen-Modelle).

Prompt

Geben Sie eine benutzerdefinierte System-Prompt-Datei fr diesen Modus mit der Konfiguration prompt an. Die Prompt-Datei sollte anweisungen enthalten, die spezifisch fr den Zweck des Modus sind.

{
  "mode": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

Dieser Pfad ist relativ zum Speicherort der Konfigurationsdatei. Dies funktioniert sowohl fr die globale opencode-Konfiguration als auch fr die projektspezifische Konfiguration.

Tools

Steuern Sie, welche Tools in diesem Modus verfgbar sind, mit der Konfiguration tools. Sie knnen spezifische Tools aktivieren oder deaktivieren, indem Sie sie auf true oder false setzen.

{
  "mode": {
    "readonly": {
      "tools": {
        "write": false,
        "edit": false,
        "bash": false,
        "read": true,
        "grep": true,
        "glob": true
      }
    }
  }
}

Wenn keine Tools angegeben sind, sind standardmig alle Tools aktiviert.

Verfgbare Tools

Hier sind alle Tools, die ber die Modus-Konfiguration gesteuert werden knnen.

Tool	Description
`bash`	Shell-Befehle ausfhren
`edit`	Vorhandene Dateien bearbeiten
`write`	Neue Dateien erstellen
`read`	Dateiinhalte lesen
`grep`	Dateiinhalte durchsuchen
`glob`	Dateien nach Muster finden
`list`	Verzeichnisinhalt auflisten
`patch`	Patches auf Dateien anwenden
`todowrite`	Todo-Listen verwalten
`todoread`	Todo-Listen lesen
`webfetch`	Web-Inhalte abrufen

Benutzerdefinierte Modi

Sie knnen Ihre eigenen benutzerdefinierten Modi erstellen, indem Sie sie zur Konfiguration hinzufgen. Hier sind Beispiele mit beiden Anstzen:

Verwendung der JSON-Konfiguration

{
  "$schema": "https://opencode.ai/config.json",
  "mode": {
    "docs": {
      "prompt": "{file:./prompts/documentation.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": false,
        "read": true,
        "grep": true,
        "glob": true
      }
    }
  }
}

Verwendung von Markdown-Dateien

Erstellen Sie Modus-Dateien in .opencode/mode/ fr projektspezifische Modi oder ~/.config/opencode/mode/ fr globale Modi:

---
temperature: 0.1
tools:
  bash: true
  read: true
  grep: true
  write: false
  edit: false
---

Sie befinden sich im Debug-Modus. Ihr Hauptziel ist es, bei der Untersuchung und Diagnose von Problemen zu helfen.

Konzentrieren Sie sich auf:

- Das Problem durch sorgfltige Analyse verstehen
| Bash-Befehle verwenden, um den Systemstatus zu berprfen
- Relevante Dateien und Protokolle lesen
- Nach Mustern und Anomalien suchen
- Klare Erklrungen der Ergebnisse bereitstellen

Nehmen Sie keine nderungen an Dateien vor. Untersuchen Sie und berichten Sie nur.

---
model: anthropic/claude-sonnet-4-20250514
temperature: 0.2
tools:
  edit: true
  read: true
  grep: true
  glob: true
---

Sie befinden sich im Refactoring-Modus. Konzentrieren Sie sich auf die Verbesserung der Code-Qualitt ohne nderung der Funktionalitt.

Prioritten:

- Code-Lesbarkeit und Wartbarkeit verbessern
- Konsistente Namenskonventionen anwenden
- Code-Duplizierung reduzieren
| Leistung bei Bedarf optimieren
- Sicherstellen, dass alle Tests weiterhin bestanden werden

Anwendungsfälle

Hier sind einige hufige Anwendungsflle fr verschiedene Modi.

Build-Modus: Vollstndige Entwicklungsarbeit mit allen aktivierten Tools
Plan-Modus: Analyse und Planung ohne nderungen
Review-Modus: Code-Review mit Lesezugriff plus Dokumentations-Tools
Debug-Modus: Fokussiert auf Untersuchung mit bash- und read-Tools aktiviert
Docs-Modus: Dokumentations-Schreiben mit Dateioperationen aber ohne Systembefehle

Sie knnen auch feststellen, dass verschiedene Modelle gut fr verschiedene Anwendungsflle sind.