使用 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已选模型配置
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）