使用 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 | 由 CLI 管理的預設模型覆寫旗標 |
{
"version": 1,
"editor": { "vimMode": false },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"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)