用 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

​
結構定義

​
必填欄位

欄位型別說明
versionnumber設定結構版本（目前：1）
editor.vimModeboolean啟用 Vim 鍵綁定（預設：false）
permissions.allowstring[]允許的操作（請參見 Permissions）
permissions.denystring[]禁止的操作（請參見 Permissions）

​
選填欄位

欄位型別說明
modelobject已選的模型組態
hasChangedDefaultModelboolean由 CLI 管理的模型覆寫旗標

​
範例

​
最小化設定

{
  "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)"]
  }
}
請參考 Permissions 以了解可用的權限類型與範例。

​
疑難排解

設定錯誤：把檔案先移開再重新啟動： 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
變更沒有持久化：確認 JSON 有效且具有寫入權限。某些欄位由 CLI 管理，可能會被覆寫。

​
備註

  • 純 JSON 格式（不含註解）
  • CLI 會自動修復缺漏欄位
  • 損毀的檔案會先備份為 .bad，再重新建立
  • 權限條目需為完整相符的字串（詳見 Permissions）