メインコンテンツへスキップ
cli-config.json を使用して Agent CLI を構成する。

ファイルの場所

種別プラットフォームパス
グローバルmacOS/Linux~/.cursor/cli-config.json
グローバルWindows$env:USERPROFILE\.cursor\cli-config.json
プロジェクトAll<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 を参照)
I