CLI 配置

Cursor CLI 使用 cli-config.json 配置。全局配置管用户默认行为；项目配置只允许配置 permissions，不能把所有 CLI 设置都塞进仓库。

1. 配置文件位置

官方限制：只有 permissions 可以配置在 project level。其他 CLI settings 必须放 global config。

环境变量覆盖：

2. 必填字段

最小配置：

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

配置文件是纯 JSON，不支持 comments。不要按 JSONC 写注释。

3. 可选字段

一些字段是 CLI-managed，可能被 CLI 覆盖。需要团队统一的内容，优先写进 rules、permissions 或 CI workflow，而不是依赖用户全局配置。

4. Vim mode 和 permissions

启用 Vim mode：

{
  "version": 1,
  "editor": { "vimMode": true },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

配置 permissions：

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}

权限细节回到 Permissions 章节。这里要记住：项目级 <project>/.cursor/cli.json 只适合放 permissions。

5. 模型选择

官方说明 CLI 模型可用 /model slash command 选择。

/model auto
/model gpt-5.2
/model sonnet-4.5-thinking

模型可用性、团队限制和价格都会变化。教程里不要把某个模型写成永久默认，实际以当前 Cursor Models & Pricing 和团队后台为准。

6. Proxy 和企业网络

如果网络需要代理，先设置环境变量：

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

如果代理做 SSL inspection，还要信任组织 CA：

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

部分企业代理不支持 HTTP/2 bidirectional streaming。此时可以启用 HTTP/1.1 fallback：

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

官方说明该模式会把 agent connections 切到 HTTP/1.1 with Server-Sent Events，适配多数企业代理。

7. 配置排障

配置报错：

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

然后重启 CLI，让它重新生成配置。

修改不生效：

• 检查 JSON 是否有效。
• 检查文件写权限。
• 区分 global config 和 project permissions。
• 记住某些字段由 CLI 管理，可能被覆盖。

配置损坏：

• 官方说明 corrupted files 会备份为 .bad 并重新创建。
• 缺失字段 CLI 会尝试 self-repair。

本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. 哪些配置能放 <project>/.cursor/cli.json？
2. 为什么企业代理环境可能需要 network.useHttp1ForAgent？
3. 配置损坏时为什么先移动文件而不是手动乱改？

通过标准：你能定位当前机器的 CLI config，写出最小 JSON 配置，并解释 global 与 project config 的职责边界。

官方来源

• Cursor CLI Configuration —— 官方配置路径、schema、示例、排障、模型和 proxy 配置。
• Cursor CLI Permissions —— 官方 project-level permissions 背景。
• Cursor Slash Commands —— 官方 /model 等会话命令。
• Cursor Network Configuration —— 官方 proxy testing 和 troubleshooting。

接下来去哪