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