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 を参照）