클로드 코드 claude -p를 서드파티 프로바이더나 텔레메트리 끈 환경에서 auto 모드로 시작하게 하는 설정법

클로드 코드(Claude Code) 2.1.302(10월 16일)부터 권한 모드를 지정하지 않은 claude -p와 에이전트 SDK 세션은 세 가지 환경에서 default 모드로 시작한다. 아마존 베드록이나 버텍스 AI 같은 서드파티 프로바이더로 접속할 때, DISABLE_TELEMETRY·DO_NOT_TRACK·DISABLE_GROWTHBOOK·CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC로 텔레메트리를 껐을 때, 그리고 갓 설치한 첫 세션이다. 2.1.285부터 2.1.301까지는 이런 세션이 auto로 시작했다. 스크립트나 CI에서 묻지 않고 돌아가던 작업이 업데이트 뒤 승인 대기에 걸릴 수 있다.

1. 비대화형 실행은 플래그로 모드를 못 박는다.

claude -p "테스트를 고쳐라" --permission-mode auto

1. 매번 플래그를 붙이기 싫으면 사용자 설정(~/.claude/settings.json)에 기본 모드를 적는다. 조직 전체에 적용하려면 관리 설정에 같은 값을 넣는다.

{
  "permissions": {
    "defaultMode": "auto"
  }
}

1. 에이전트 SDK에서는 쿼리 옵션으로 넘긴다. 타입스크립트는 permissionMode: "auto", 파이썬은 permission_mode="auto"다.

auto 모드는 지원하는 모델에서만 켜진다. 설정 파일 어딘가에 disableAutoMode가 "disable"로 있으면 --permission-mode auto를 줘도 default로 시작한다. 공식 문서의 '세션이 시작하는 모드' 표는 아직 2.1.285 기준이라 서드파티·텔레메트리 끈 세션을 auto로 적어 두었다. 2.1.302 이후 동작은 체인지로그를 따른다.