《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，適用於大多數企業代理。

有關代理測試命令和疑難排查，請參閱網絡配置。