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 참조)