Agent CLI’yi cli-config.json dosyasını kullanarak yapılandır.

​
Dosya konumu

TürPlatformYol
GenelmacOS/Linux~/.cursor/cli-config.json
GenelWindows$env:USERPROFILE\.cursor\cli-config.json
ProjeTümü<project>/.cursor/cli.json
Yalnızca izinler proje düzeyinde yapılandırılabilir. Diğer tüm CLI ayarları genel olarak ayarlanmalıdır.
Ortam değişkenleriyle geçersiz kılma:
  • CURSOR_CONFIG_DIR: özel dizin yolu
  • XDG_CONFIG_HOME (Linux/BSD): $XDG_CONFIG_HOME/cursor/cli-config.json kullanır

​
Şema

​
Zorunlu alanlar

AlanTürAçıklama
versionnumberYapılandırma şema sürümü (güncel: 1)
editor.vimModebooleanVim tuş bağlarını etkinleştir (varsayılan: false)
permissions.allowstring[]İzin verilen işlemler (bkz. Permissions)
permissions.denystring[]Yasaklanan işlemler (bkz. Permissions)

​
İsteğe bağlı alanlar

AlanTürAçıklama
modelobjectSeçilen model yapılandırması
hasChangedDefaultModelbooleanCLI tarafından yönetilen varsayılan modeli geçersiz kılma bayrağı

​
Örnekler

​
Minimal konfigürasyon

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

​
Vim modunu etkinleştir

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

​
İzinleri yapılandır

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Mevcut izin türleri ve örnekler için Permissions sayfasına bak.

​
Sorun Giderme

Yapılandırma hataları: Dosyayı bir kenara al ve yeniden başlat: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Değişiklikler kalıcı değil: JSON’un geçerli olduğundan ve yazma izinlerinin bulunduğundan emin ol. Bazı alanlar CLI tarafından yönetilir ve üzerlerine yazılabilir.

​
Notlar

  • Yalın JSON biçimi (yorum yok)
  • CLI, eksik alanları otomatik olarak onarır
  • Bozulmuş dosyalar .bad olarak yedeklenir ve yeniden oluşturulur
  • İzin girdileri birebir eşleşen dizgelerdir (ayrıntılar için bkz. Permissions)