使用 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選用的模型設定
hasChangedDefaultModelbooleanCLI 管理的模型覆寫標記

​
範例

​
最小設定

{
  "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）