Konfiguriere die Agent-CLI über die Datei cli-config.json.

​
Speicherort der Dateien

TypPlattformPfad
GlobalmacOS/Linux~/.cursor/cli-config.json
GlobalWindows$env:USERPROFILE\.cursor\cli-config.json
ProjektAlle<project>/.cursor/cli.json
Auf Projektebene lassen sich nur Berechtigungen konfigurieren. Alle anderen CLI-Einstellungen müssen global festgelegt werden.
Per Umgebungsvariablen überschreiben:
  • CURSOR_CONFIG_DIR: benutzerdefinierter Verzeichnispfad
  • XDG_CONFIG_HOME (Linux/BSD): verwendet $XDG_CONFIG_HOME/cursor/cli-config.json

​
Schema

​
Pflichtfelder

FeldTypBeschreibung
versionnumberVersion des Konfigurationsschemas (aktuell: 1)
editor.vimModebooleanVim-Keybindings aktivieren (Standard: false)
permissions.allowstring[]Zulässige Operationen (siehe Berechtigungen)
permissions.denystring[]Unzulässige Operationen (siehe Berechtigungen)

​
Optionale Felder

FeldTypBeschreibung
modelobjectAusgewählte Modello-Konfiguration
hasChangedDefaultModelbooleanVon der CLI gesetztes Flag zur Überschreibung des Standardmodells

​
Beispiele

​
Minimale Konfiguration

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Vim-Modus aktivieren

{
  "version": 1,
  "editor": { "vimMode": true },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Berechtigungen konfigurieren

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Sieh dir Permissions für verfügbare Berechtigungstypen und Beispiele an.

​
Fehlerbehebung

Konfig-Fehler: Leg die Datei beiseite und starte neu: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Änderungen bleiben nicht erhalten: Stell sicher, dass das JSON gültig ist und du Schreibrechte hast. Einige Felder werden vom CLI verwaltet und können überschrieben werden.

​
Hinweise

  • Reines JSON-Format (keine Kommentare)
  • Die CLI repariert fehlende Felder automatisch
  • Beschädigte Dateien werden als .bad gesichert und neu erstellt
  • Berechtigungseinträge sind exakte Zeichenketten (siehe Permissions für Details)