Zurück zum Blog
2026-03-27Aktualisiert am 2026-11-15
Toolsify Editorial Team
Developer Tools

OpenCode: Einen KI-Coding-Agenten für das Repository konfigurieren

AI CodingOpen SourceDeveloper ToolsCode AssistantOpenCodeopencode the open source ai coding agent
Sponsored

OpenCode ist ein quelloffener Coding-Agent mit Terminal-, Desktop- und Weboberfläche. Sein Nutzen hängt vom verbundenen Modell und dem bereitgestellten Repository-Kontext ab. Dieser Leitfaden folgt der am 15. November 2026 geprüften v2-Dokumentation; ältere Anleitungen verwenden möglicherweise andere Konfigurationsfelder. Die Installationsanleitung beschreibt unterstützte Pakete und den Anbieterbefehl /connect.

Repository und Anbieter verbinden

Installieren Sie eine passende Version, öffnen Sie das Projektverzeichnis und starten Sie opencode. Über /connect richten Sie einen für Ihr Konto verfügbaren Anbieter ein. Ein funktionierender Client bedeutet keine kostenlose Modellnutzung: Abrechnung und Datenverarbeitung des Anbieters gelten weiterhin.

Erstellen Sie opencode.jsonc im Repository mit dem folgenden Schema. Die Konfigurationsreferenz erläutert projektbezogene, globale und verwaltete Einstellungen. Prüfen Sie diese Ebenen bei scheinbar wirkungslosen Optionen; verwaltete Einstellungen können Projektentscheidungen überschreiben. Zugangsdaten gehören nicht in eingecheckte Dateien.

Befehle ausdrücklich begrenzen

Dieses v2-Beispiel verlangt eine Bestätigung für Shell-Befehle, blockiert Pushes und fragt vor Zugriffen außerhalb des Projekts:

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "git push *", "effect": "deny" },
    { "action": "external_directory", "resource": "*", "effect": "ask" }
  ]
}

Die letzte passende Berechtigungsregel gewinnt. Prüfen Sie auch agentenspezifische Überschreibungen. Diese Werkzeugrechte sind keine Betriebssystem-Sandbox. Die Berechtigungsreferenz erklärt Aktionen und Musterabgleich.

Einen konkreten Fehler untersuchen

Bei einem doppelt gesendeten Formular beginnen Sie mit Plan: „Verfolge Submit-Handler und Netzwerkanfrage. Erkläre, weshalb ein Klick zwei Anfragen auslöst, und schlage die kleinste Korrektur vor.“ Plan vermeidet Änderungen an normalen Projektdateien; Shell-Befehle unterliegen weiterhin den Berechtigungen. Build übernimmt die Implementierung, wie die Agentenreferenz beschreibt.

Übergeben Sie Build die betroffenen Dateien und Abnahmekriterien: eine Anfrage pro Klick, unveränderte Validierung und eine Regressionsprüfung für wiederholtes Absenden. Verlangen Sie das vorhandene Testframework und tatsächliche Befehlsausgaben. Eine plausible Erklärung beweist keine Korrektheit.

Ergebnis vor der Übernahme prüfen

Prüfen Sie git diff, den relevanten Test und die vorgeschriebenen Repository-Prüfungen sowie unerwartete Änderungen an Abhängigkeiten oder generierten Dateien. Bewahren Sie einen sauberen Git-Ausgangspunkt: Dateisystem-Rücknahmen machen weder entfernte Aktionen noch Datenbankänderungen rückgängig. Vergleichen Sie Anbieter anhand desselben Fehlers und erfassen Sie Prüfzeit, verbleibende Fehler und tatsächliche Nutzungskosten. So entsteht eine brauchbare Entscheidungsgrundlage ohne erfundene Benchmarkwerte oder die Annahme identischen Modellverhaltens.

Sponsored