Перейти к основному содержанию
Настрой Agent CLI с помощью файла cli-config.json.

​
Расположение файла

ТипПлатформаПуть
ГлобальныйmacOS/Linux~/.cursor/cli-config.json
ГлобальныйWindows$env:USERPROFILE\.cursor\cli-config.json
ПроектВсе<project>/.cursor/cli.json
На уровне проекта можно настроить только разрешения. Все остальные параметры CLI задаются глобально.
Переопределение через переменные окружения:
  • CURSOR_CONFIG_DIR: путь к пользовательскому каталогу
  • XDG_CONFIG_HOME (Linux/BSD): использует $XDG_CONFIG_HOME/cursor/cli-config.json

​
Схема

​
Обязательные поля

ПолеТипОписание
versionnumberВерсия схемы конфигурации (текущая: 1)
editor.vimModebooleanВключает хоткеи Vim (по умолчанию: false)
permissions.allowstring[]Разрешённые операции (см. Permissions)
permissions.denystring[]Запрещённые операции (см. Permissions)

​
Необязательные поля

ПолеТипОписание
modelobjectКонфигурация выбранной модели
hasChangedDefaultModelbooleanФлаг переопределения модели, управляемого через CLI

​
Примеры

​
Минимальная конфигурация

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

​
Включи режим Vim

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

​
Настройка прав доступа

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
См. Permissions для списка доступных типов разрешений и примеров.

​
Устранение неполадок

Ошибки конфигурации: Временно переименуй/перемести файл и перезапусти: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Изменения не сохраняются: проверь валидность JSON и права на запись. Некоторые поля управляются через CLI и могут быть перезаписаны.

​
Заметки

  • Чистый JSON-формат (без комментариев)
  • CLI автоматически восстанавливает отсутствующие поля
  • Повреждённые файлы сохраняются с расширением .bad и пересоздаются
  • Записи разрешений — это точные строковые значения (см. Permissions для подробностей)
⌘I