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.vimModebooleanVimキーバインドを有効化（デフォルト: 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 を参照）