命令行界面
配置
通过 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
架构
必填字段
可选字段
| 字段 | 类型 | 描述 |
|---|---|---|
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 Cherri Code”尾注 (默认值：true) |
attribution.attributePRsToAgent | 布尔值 | 为智能体 PR 添加“Made with Cherri Code”页脚 (默认值：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:portexport HTTPS_PROXY=http://your-proxy:portexport NODE_USE_ENV_PROXY=1如果您的代理执行 SSL 检查 (中间人拦截) ，还需信任您所在组织的 CA 证书：
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-cert.pemHTTP/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，适用于大多数企业代理。
有关代理测试命令和疑难排查，请参阅网络配置。