Zum Inhalt springen
Documentation

Berechtigungen und Sicherheit des KI-Agenten

Der Agent schlägt lediglich Aktionen vor. Jede Dateibearbeitung und jeder Befehl durchläuft eine Berechtigungsprüfung auf Ihrem Rechner, bevor etwas geschieht, und nichts kann diese Prüfung deaktivieren.

Schreibgeschützte Tools können innerhalb des Arbeitsbereichs uneingeschränkt ausgeführt werden: Dateien lesen, Verzeichnisse auflisten, suchen sowie schreibgeschützte git Befehle wie status, diff, und log. Der Arbeitsbereich ist das Verzeichnis, in dem Sie den Agenten gestartet haben, sowie alle Verzeichnisse, die mit --add-dir oder /add-dir. Pfade außerhalb davon, .. Escape-Zeichen und Links, die nach außen führen, werden abgelehnt.

Drücken Sie Shift+Tab um den Modus zu wechseln. Der aktuelle Modus wird in der Statuszeile angezeigt.

ModusDateiänderungenBefehle
ask (Standard)Jedes Mal nachfragenJedes Mal nachfragen
accept-editsOhne Rückfrage innerhalb des Arbeitsbereichs ausführenTrotzdem fragen
planAbgelehntAbgelehnt

Im plan Im Modus recherchiert und beschreibt der Agent Änderungen, anstatt sie vorzunehmen. /plan Wechselt bei einer Planungsanfrage in den Planungsmodus.

Legen Sie den Startmodus fest mit --permission-mode, mit /permissions mode MODE, oder mit defaultMode in einer Einstellungsdatei. Es gibt keinen Modus, der jede Berechtigungsprüfung überspringt.

Eine Abfrage zeigt genau an, was geschehen wird: den Diff bei einer Bearbeitung, die vollständige Befehlszeile und das Arbeitsverzeichnis bei einem Befehl oder den Server und die Argumente bei einem MCP-Tool. Sie haben folgende Auswahlmöglichkeiten:

  • Ja um den Vorgang einmal auszuführen.
  • Ja, und nicht erneut fragen für dieses Befehlspräfix oder Dateimuster in diesem Projekt. Die Regel wird in Ihren eigenen Einstellungen für dieses Projekt gespeichert, unter $CONFIG/ai/projects/, niemals im Repository.
  • Nein, und teilen Sie der KI den Grund mit, damit sich der Agent anpassen kann.

Bestimmte Aufrufe werden immer abgefragt, und keine Regel kann sie zulassen: Befehle, die auf geheime Dateien oder Anmeldedaten-Speicher verweisen, Änderungen an .champrep/ oder .git/ interne Funktionen und Befehle, die zu komplex sind, um sicher analysiert zu werden.

Regeln haben die Form Tool oder Tool(pattern):

{
"permissions": {
"allow": ["local_bash(npm test*)", "local_bash(go test ./...)", "local_edit_file(src/**)"],
"deny": ["local_bash(git push*)", "local_bash(rm -rf*)", "local_read_file(secrets/**)"],
"defaultMode": "ask"
}
}
  • Befehlsregeln wie zum Beispiel local_bash(npm test*) entsprechen der Befehlszeile. Befehle, die mit ;, &&, ||, |oder Ersetzungen werden aufgeteilt, und jedes Teil muss zugelassen sein.
  • Pfadregeln wie zum Beispiel local_edit_file(src/**) entsprechen arbeitsbereichsrelativen Pfaden. * bleibt innerhalb eines Ordners; ** gilt über Ordner hinweg.
  • Tool-Namen können verwenden *, zum Beispiel local_mcp__github__* für jedes Tool eines lokalen MCP-Servers.
  • A local_read_file(...) Sperrregel oder eine deny_read Liste verbirgt diese Dateien zudem vor allen Lese- und Suchtools.

Regeln verwalten, ohne Dateien zu bearbeiten:

/permissions
/permissions allow local_bash(npm run lint*)
/permissions deny local_bash(git push*)
/permissions remove local_bash(npm run lint*)
/permissions mode accept-edits

/permissions allow, deny, und remove Bearbeiten Sie Ihre gespeicherten Antworten für dieses Projekt (unter $CONFIG/ai/projects/). Bearbeiten Sie die anderen Dateien direkt.

DateiGültigkeitsbereich
--allowed-tools FlagNur bei diesem Durchlauf
$CONFIG/ai/projects/<id>.jsonIhre gespeicherten Antworten für dieses Projekt („Nicht erneut fragen“, /permissions)
.champrep/settings.local.jsonSie, in diesem Projekt (hinzugefügt zu .gitignore automatisch)
.champrep/settings.jsonAlle Teilnehmer dieses Projekts (bitte per Commit freigeben)
$CONFIG/ai/settings.jsonSie, in jedem Projekt

Frühere Einträge haben Vorrang. Ablehnungsregeln aus beliebigen Dateien haben stets Vorrang. Ihre gespeicherten Antworten gelten sofort, da sie außerhalb des Repositorys liegen. „Erlauben“- Regeln und defaultMode in den beiden .champrep/ Dateien werden erst wirksam, nachdem Sie dem Projekt .champrep/ Konfiguration (siehe Repository-Vertrauen); darin enthaltene „Deny“-Regeln gelten immer. Fügen Sie gewünschte „Allow“-Regeln an beliebiger Stelle in Ihren Benutzereinstellungen ein. Die Limits Ihres Tarifs gelten zusätzlich für jede Datei, und lokale Einstellungen können diese nicht erhöhen.

Ausführen champrep ai paths um zu sehen, wo $CONFIG befindet sich auf Ihrem Rechner.

Diese werden vom System selbstCLI durchgesetzt, nicht durch das Modell:

  • Blockierte Dateien. Der Agent liest, listet den Inhalt auf oder sendet niemals .env Dateien (mit Ausnahme von .env.example), private Schlüssel und Zertifikate wie *.pem, *.key, *.p12, und id_rsa*, .npmrc, .pypirc, .netrc, Ihr ~/.aws, ~/.ssh, und ~/.gnupg Ordner, den Schlüsselbund des Betriebssystems und die eigene Konfiguration CLIdes Modells. Dem Modell wird mitgeteilt, dass die Datei blockiert ist; es sieht den Inhalt niemals.
  • Redaktion. Die Ausgabe von Tools wird gescannt, bevor sie Ihren Rechner verlässt. Vertrauliche Daten mit hohem Sicherheitsbedarf wie Cloud-Zugriffsschlüssel, Token für die Quellcodeverwaltung, Schlüssel von Zahlungsanbietern, Schlüssel von KI-Anbietern, Blöcke privater Schlüssel und Bearer- Token werden ersetzt durch [REDACTED:<kind>].
  • Eingefügte Schlüssel. Wenn eine Eingabeaufforderung etwas enthält, das wie ein Geheimnis aussieht, wird es nicht gesendet. Registrieren Sie Modellschlüssel bei /model register und MCP- Anmeldedaten mit /mcp stattdessen.
  • Keine Vererbung von Anmeldedaten. Befehle, die der Agent ausführt, Hooks und lokale MCP- Server erhalten niemals Ihre AnmeldedatenCHAMPREP oder CHAMPREP_* Variablen.

Fügen Sie Ihre eigenen gesperrten Pfade hinzu mit deny_read oder local_read_file(...) „deny“-Regeln. Die integrierte Liste kann erweitert, jedoch keinesfalls gelockert werden.

Ein Repository kann Agentenkonfigurationen in .champrep/: benutzerdefinierte Befehle, Skills, Agenten, Hooks, MCP-Server und Projekteinstellungen. Beim Öffnen eines unbekannten Repositorys darf keines dieser Elemente ausgeführt werden, sodass dieser Inhalt inaktiv bleibt, bis Sie ihn genehmigen.

  • Wenn ein Projekt solche Inhalte enthält, fragt der Agent einmalig ab, ob ihm vertraut werden soll, und zeigt an, was darin enthalten ist.
  • Sollten sich die Inhalte später ändern, werden Sie erneut dazu befragt.
  • /trust zeigt den aktuellen Status an; /trust approve und /trust revoke es ändern.

Genehmigungen werden gespeichert in $CONFIG/ai/trusted-projects.json.

Vor jeder Bearbeitung speichert der Agent den vorherigen Zustand der Datei auf Ihrem Rechner.

BefehlWirkung
/diffZeigen Sie alle in dieser Sitzung vorgenommenen Dateiänderungen an.
/undoDie zuletzt vorgenommenen Änderungen rückgängig machen.
/rewindEine frühere Nachricht auswählen und Dateien in den Zustand vor dieser Nachricht zurückversetzen. Esc „twice“ öffnet es ebenfalls.

/rewind stellt nur Dateien wieder her; die Konversation selbst bleibt unverändert. Checkpoints werden beim Beenden der Sitzung gelöscht, es sei denn, Sie beginnen mit --keep-checkpoints. Änderungen, die durch Shell-Befehle vorgenommen werden, beispielsweise durch einen Code-Generator, der über local_bash, werden nicht gezählt; verwenden Sie git für diese.

Aktionen, die Daten in Ihren DienstenCHAMPREP ändern, wie beispielsweise das Versenden einer E-Mail, unterliegen demselben Genehmigungsablauf wie die Web-App. Der Agent zeigt eine Genehmigungskarte an, und Sie wählen Genehmigen, Ablehnen, oder Später entscheiden. Diese Aktionen werden unabhängig vom lokalen Berechtigungsmodus niemals automatisch genehmigt. Bei „Headless“- Läufen bleiben sie so lange in der Warteschlange, bis Sie sie in der CHAMPREPWeb-App genehmigen.

/services zeigt an, welche DiensteCHAMPREP die KI nutzen darf. Ändern Sie diese Liste in Ihren EinstellungenCHAMPREP AI im Web.