메인 콘텐츠로 건너뛰기
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 사용

​
스키마

​
필수 필드

FieldTypeDescription
versionnumber구성 스키마 버전(현재: 1)
editor.vimModebooleanVim 키바인딩 사용(기본값: false)
permissions.allowstring[]허용되는 작업(자세한 내용: Permissions)
permissions.denystring[]금지되는 작업(자세한 내용: Permissions)

​
선택 필드

FieldTypeDescription
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