跳转到主要内容
使用 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）
⌘I