《Cursor文档》-配置

通过 cli-config.json 文件配置智能体 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	配置 schema 版本 (当前为 `1`)
`editor.vimMode`	boolean	启用 Vim 快捷键绑定 (默认值为 `false`)
`permissions.allow`	string[]	允许的操作 (参见权限)
`permissions.deny`	string[]	禁止的操作 (参见权限)

可选字段¶

字段	类型	描述
`channel`	string	CLI 更新使用的发布渠道
`model`	对象	所选模型的配置
`maxMode`	布尔值	模型选择器中 Max Mode 的持久化偏好设置
`hasChangedDefaultModel`	布尔值	CLI 管理的模型覆盖标志
`notifications`	布尔值	智能体完成任务或需要输入时发送终端通知
`hints`	布尔值	智能体工作时显示 CLI 提示
`rewind`	布尔值	启用 `/rewind`，以恢复会话中较早的消息
`suggestNextPrompt`	布尔值	在每轮结束时建议后续提示词
`display.showLineNumbers`	布尔值	在渲染后的代码块中显示行号
`display.showThinkingBlocks`	布尔值	可用时渲染模型思考块
`display.showStatusIndicators`	布尔值	启用终端标题中的状态指示器
`display.showStatusLineRunningTime`	布尔值	在状态行中显示已运行时间
`approvalMode`	string	批准模式：`allowlist`、`auto-review` 或 `unrestricted`
`sandbox.mode`	string	沙箱模式覆盖
`sandbox.networkAccess`	string	沙箱模式的网络访问设置
`network.useHttp1ForAgent`	布尔值	智能体连接使用 HTTP/1.1 而非 HTTP/2 (默认值：`false`)
`attribution.attributeCommitsToAgent`	布尔值	为智能体提交添加“Made with Cursor”尾注 (默认值：`true`)
`attribution.attributePRsToAgent`	布尔值	为智能体 PR 添加“Made with Cursor”页脚 (默认值：`true`)

示例¶

最简配置¶

{
  "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)"]
  }
}

有关可用的权限类型和示例，请参阅权限。

疑难排查¶

配置错误：将该文件移开，然后重新启动：

mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad

更改未保存：请确保 JSON 格式有效且拥有写入权限。部分字段由 CLI 管理，可能会被覆盖。

注意事项¶

仅支持纯 JSON 格式 (不含注释)
CLI 会自动修复缺失字段
损坏的文件将备份为 .bad，然后重新创建
权限条目必须是精确字符串 (详见权限)

模型¶

你可以使用 /model 斜杠命令为命令行界面选择模型。

/model auto
/model gpt-5
/model sonnet-4-thinking

有关其他命令，请参阅斜杠命令文档。

代理配置¶

如果你的网络流量需经由代理服务器，请使用环境变量和配置文件配置 CLI。

环境变量¶

运行 CLI 前，请设置以下环境变量：

export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port
export NODE_USE_ENV_PROXY=1

如果您的代理执行 SSL 检查 (中间人拦截) ，还需信任您所在组织的 CA 证书：

export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-cert.pem

HTTP/1.1 回退¶

某些企业代理 (如 Zscaler) 不支持 HTTP/2 双向流式传输。请在 config 中启用 HTTP/1.1 模式：

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": { "allow": [], "deny": [] },
  "network": {
    "useHttp1ForAgent": true
  }
}

这会将智能体连接切换为使用 Server-Sent Events (SSE) 的 HTTP/1.1，适用于大多数企业代理。

有关代理测试命令和疑难排查，请参阅网络配置。