Настрой 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
| Поле | Тип | Описание |
|---|
version | number | Версия схемы конфигурации (текущая: 1) |
editor.vimMode | boolean | Включает хоткеи Vim (по умолчанию: false) |
permissions.allow | string[] | Разрешённые операции (см. Permissions) |
permissions.deny | string[] | Запрещённые операции (см. Permissions) |
| Поле | Тип | Описание |
|---|
model | object | Конфигурация выбранной модели |
hasChangedDefaultModel | boolean | Флаг переопределения модели, управляемого через CLI |
{
"version": 1,
"editor": { "vimMode": false },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"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 для подробностей)