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.
Was immer ohne Rückfrage geschieht
Abschnitt betitelt „Was immer ohne Rückfrage geschieht“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.
Berechtigungsmodi
Abschnitt betitelt „Berechtigungsmodi“Drücken Sie Shift+Tab um den Modus zu wechseln. Der aktuelle Modus wird in der Statuszeile angezeigt.
| Modus | Dateiänderungen | Befehle |
|---|---|---|
ask (Standard) | Jedes Mal nachfragen | Jedes Mal nachfragen |
accept-edits | Ohne Rückfrage innerhalb des Arbeitsbereichs ausführen | Trotzdem fragen |
plan | Abgelehnt | Abgelehnt |
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.
Beantwortung einer Berechtigungsabfrage
Abschnitt betitelt „Beantwortung einer Berechtigungsabfrage“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.
Zulassungs- und Ablehnungsregeln
Abschnitt betitelt „Zulassungs- und Ablehnungsregeln“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 Beispiellocal_mcp__github__*für jedes Tool eines lokalen MCP-Servers. - A
local_read_file(...)Sperrregel oder einedeny_readListe 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.
Einstellungsdateien und Priorität
Abschnitt betitelt „Einstellungsdateien und Priorität“| Datei | Gültigkeitsbereich |
|---|---|
--allowed-tools Flag | Nur bei diesem Durchlauf |
$CONFIG/ai/projects/<id>.json | Ihre gespeicherten Antworten für dieses Projekt („Nicht erneut fragen“, /permissions) |
.champrep/settings.local.json | Sie, in diesem Projekt (hinzugefügt zu .gitignore automatisch) |
.champrep/settings.json | Alle Teilnehmer dieses Projekts (bitte per Commit freigeben) |
$CONFIG/ai/settings.json | Sie, 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.
Schutz vertraulicher Daten
Abschnitt betitelt „Schutz vertraulicher Daten“Diese werden vom System selbstCLI durchgesetzt, nicht durch das Modell:
- Blockierte Dateien. Der Agent liest, listet den Inhalt auf oder sendet niemals
.envDateien (mit Ausnahme von.env.example), private Schlüssel und Zertifikate wie*.pem,*.key,*.p12, undid_rsa*,.npmrc,.pypirc,.netrc, Ihr~/.aws,~/.ssh, und~/.gnupgOrdner, 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 registerund MCP- Anmeldedaten mit/mcpstattdessen. - 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.
Repository-Vertrauen
Abschnitt betitelt „Repository-Vertrauen“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.
/trustzeigt den aktuellen Status an;/trust approveund/trust revokees ändern.
Genehmigungen werden gespeichert in $CONFIG/ai/trusted-projects.json.
Checkpoints, diff und undo
Abschnitt betitelt „Checkpoints, diff und undo“Vor jeder Bearbeitung speichert der Agent den vorherigen Zustand der Datei auf Ihrem Rechner.
| Befehl | Wirkung |
|---|---|
/diff | Zeigen Sie alle in dieser Sitzung vorgenommenen Dateiänderungen an. |
/undo | Die zuletzt vorgenommenen Änderungen rückgängig machen. |
/rewind | Eine 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 in DienstenCHAMPREP
Abschnitt betitelt „Aktionen in DienstenCHAMPREP“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.