用 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

​
架构

​
必填字段

字段类型说明
versionnumber配置架构版本（当前：1）
editor.vimModeboolean启用 Vim 键位绑定（默认：false）
permissions.allowstring[]允许的操作（参见 Permissions）
permissions.denystring[]禁止的操作（参见 Permissions）

​
可选字段

字段类型说明
modelobject选定的模型配置
hasChangedDefaultModelbooleanCLI 管理的默认模型覆盖标志

​
示例

​
最简配置

{
  "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）