使用 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

架构模式

必填字段

字段	类型	描述
version	number	配置模式版本（当前：1）
editor.vimMode	boolean	启用 Vim 按键绑定（默认：false）
permissions.allow	string[]	允许的操作（参见 Permissions）
permissions.deny	string[]	禁止的操作（参见 Permissions）

可选字段

字段	类型	描述
model	object	选定的模型配置
hasChangedDefaultModel	boolean	命令行界面管理的模型覆盖标记
network.useHttp1ForAgent	boolean	对 agent 连接使用 HTTP/1.1 而不是 HTTP/2（默认：false）
attribution.attributeCommitsToAgent	boolean	在 Agent 提交中添加 "Made with Cursor" 尾注（默认：true）
attribution.attributePRsToAgent	boolean	在 Agent 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 并重新生成
• 权限条目需为精确匹配的字符串（详见 Permissions）

模型

你可以使用 /model 命令为命令行界面（CLI）选择模型。

/model auto/model gpt-5.2/model sonnet-4.5-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.pem

HTTP/1.1 回退

某些企业代理（例如 Zscaler）不支持 HTTP/2 的双向流式传输。请在配置中启用 HTTP/1.1 模式：

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

这会将 Agent 连接改为通过 HTTP/1.1 与 Server-Sent Events (SSE) 通信，从而能够与大多数企业代理正常配合使用。

有关代理测试命令和故障排查，请参见 网络配置。

《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章，前6章涵盖深度学习基础，包括张量运算、神经网络原理、数据预处理及卷积神经网络等；后5章进阶探讨图像、文本、音频建模技术，并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法，每章附有动手练习题，帮助读者巩固实战能力。内容兼顾数学原理与工程实现，适配PyTorch框架最新技术发展趋势。