使用 cli-config.json 文件配置 Agent CLI。
| 类型 | 平台 | 路径 | 
|---|
| 全局 | 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)"]
  }
}
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
- 仅支持纯 JSON 格式(不含注释)
- CLI 会自动修复缺失字段
- 损坏的文件会备份为 .bad并重新生成
- 权限项必须为精确匹配的字符串(详见 Permissions)