Claude Code 자동 모드 기본 설정 변경 및 권한 모드 가이드
Claude Code v2.1.283 버전부터 터미널과 VS Code에서 자동 모드가 기본값으로 적용됩니다. 각 권한 모드의 차이점과 원격 서버 환경에서 보안을 유지하며 모드를 설정하는 방법을 상세히 설명합니다. 기존 설정 유지 여부와 HIPAA 구성 등 예외 상황을 확인하십시오.
2026년 8월 14일에 auto mode에서 변경된 사항
Claude Code의 auto mode는 일반적인 권한 확인 프롬프트 없이 도구 호출을 실행하며, 별도의 분류기 모델을 사용해 작업을 검토합니다. 보호된 경로 외부에서 파일을 읽거나 작업 디렉터리를 수정하는 작업은 분류기 검토를 건너뜁니다. 2026년 8월 14일부터 Pro, Max, Team 플랜에서는 새 세션이 시작되는 기본 모드가 auto mode가 되었습니다. 2026년 10월 27일 기준으로 문서의 설명은 더 확대되었습니다. Claude Code v2.1.283 이상에서는 모든 플랜과 provider의 대화형 터미널 및 VS Code 세션에서 auto mode가 기본 시작 모드입니다. 언제든지 모드를 전환할 수 있으며, 이미 직접 설정한 기본값은 덮어쓰지 않습니다.
현재 문서에는 변경 사항이 다음과 같이 설명되어 있습니다.
Claude Code v2.1.283 이상에서는 대화형 터미널 및 VS Code 세션의 기본 권한 시작 모드가 auto mode입니다. 이전 버전에서는 Pro, Max, Ultra, Team 플랜에서만 기본 권한 시작 모드가 auto mode입니다.
같은 페이지의 두 가지 규칙은 버전 번호보다 중요합니다. 직접 설정한 defaultMode는 사용자의 ~/.claude/settings.json에 설정되어 있어도 변경 후에도 유지됩니다. Claude Code가 auto mode로 전환할지 한 번 물을 수 있지만, 거부하면 기존 설정을 유지합니다. 조직이 managed settings를 통해 배포한 기본값도 유지됩니다. 공지 게시물에서는 처음에는 Enterprise 플랜과 Claude API에서 auto mode를 opt-in 방식으로 유지한다고 설명했습니다. 2026년 10월 22일에 게시물을 업데이트하면서, Enterprise 관리자는 auto mode가 조직의 기본값이 되기 전에 이메일을 받게 된다고 밝혔습니다. v2.1.283부터 문서에서는 터미널 및 VS Code 세션에 대해 더 이상 이 예외를 두지 않습니다. 단, v2.1.285 이상에서는 HIPAA 구성이 적용된 조직의 세션이 여전히 Manual mode로 시작합니다.
VPS(virtual private server)에서 Claude Code를 실행한다면 이 변경은 노트북에서 실행할 때보다 더 중요합니다. 권한 프롬프트는 키보드 앞에 있는 사람이 처리해야 하는 확인 지점입니다. 원격 서버에서는 그 자리에 없는 경우가 많으므로 세션이 시작되는 모드가 몇 시간 동안 그대로 유지되는 모드가 됩니다. 비대화형 claude -p 실행은 다른 규칙을 따릅니다. v2.1.302 이상에서는 모드를 지정하지 않으면 third-party provider를 사용하거나 telemetry를 끈 경우에도 default로 시작합니다. 2026년 10월 31일 기준 최신 릴리스는 v2.1.316이며, permission-modes 페이지에 이 동작이 설명되어 있습니다. v2.1.302 이전에는 이 두 경우가 auto으로 시작할 수 있었으므로, 아직 이전 릴리스일 가능성이 있다면 서버에서 claude --version을 실행하십시오.
Claude Code 권한 모드: 감독 수준이 높은 순서
모드는 6가지다. 각 줄의 시작 부분에 있는 이름은 설정에 입력하거나 --permission-mode에 전달하는 값이다. 도구 호출의 실행 가능 여부를 결정하는 작업은 모델을 둘러싼 하네스의 역할이므로, 6가지 모드 모두 모델이 아니라 Claude Code 자체가 적용한다.
default: Claude는 파일 편집, 셸 명령 실행 또는 네트워크 접근과 관련된 대부분의 작업 전에 확인을 요청한다. 작업 디렉터리 내부의 읽기 작업은 계속 확인 없이 실행된다. CLI (명령줄 인터페이스)는 이 모드를 Manual로 표시하며manual를 별칭으로 허용한다.plan: Claude는 탐색을 위해 파일을 읽고 명령을 실행하지만 소스는 편집하지 않는다. 계획을 승인할 때까지 편집은 차단된다. 단, 우회 권한을 사용할 수 있는 대화형 터미널 세션에서는 예외다. 이 경우 계획 명령에는 분류기와 확인 요청이 모두 적용되지 않는다.acceptEdits: 파일 편집이 확인 없이 실행된다. 파일 시스템 명령mkdir,touch,rm,rmdir,mv,cp및sed도 마찬가지다. 이 동작은 작업 디렉터리 내부의 경로 또는additionalDirectories내부의 경로에만 적용된다. 보호된 경로에 쓰거나 인식된 중요 경로를 제거하는 작업은 계속 확인을 요청한다.touch는 일반 파일 경로를 사용할 때만 자동 승인된다. 그 밖의 셸 명령에는 일반 권한 규칙이 적용된다.auto: 일반적인 권한 확인 요청 대신 분류기 검사가 실행된다. 명시적인ask규칙은 여전히 확인을 요청한다.dontAsk: 일반적인 권한 확인이 필요한 작업은 Claude Code가 자동으로 거부한다. 설치한 모드가 승인할 수 있는 호출, 작업 디렉터리 내부의 파일 읽기, 사용자가 정의한allow규칙, 기본 제공 읽기 전용 Bash 명령, 사전 승인된 문서 가져오기, 그리고PreToolUse후크가 승인하는 호출만 실행된다. 세션은 입력을 기다리지 않는다.bypassPermissions:.git및.claude과 같은 보호된 경로에 대한 쓰기를 포함해 확인 요청과 안전 검사를 건너뛴다.
세션 중 Shift+Tab를 눌러 default, acceptEdits, plan 순서로 전환할 수 있다. auto에서 처음 누르면 default로 내려간다. 상태 표시줄에는 현재 모드가 표시된다. 예를 들어 ⏵⏵ auto mode on 또는 회색 ⏸ manual mode on으로 표시된다. 기본적으로 다른 모드는 이 전환 목록에 포함되지 않는다. 계정이 요구 사항을 충족하면 auto도 목록에 포함된다. 세션을 --permission-mode bypassPermissions, --dangerously-skip-permissions 또는 --allow-dangerously-skip-permissions과 함께 시작했거나, 사용자, --settings 또는 관리 설정에서 defaultMode: "bypassPermissions"을 사용한 경우에만 bypassPermissions이 목록에 포함된다. dontAsk은 목록에 나타나지 않으므로 claude --permission-mode dontAsk으로 설정해야 한다.
Auto 모드에는 최신 모델도 필요하다. 이 요구 사항이 충족되지 않는 것이 Auto 모드가 아예 표시되지 않는 일반적인 원인이다. 2026년 10월 27일 기준으로 문서에는 Anthropic API에서 Claude Opus 4.6 이상, Sonnet 4.6 이상, Haiku 5.5 또는 Fable 모델을 지원한다고 나와 있다. Amazon Bedrock, Google Cloud 및 Microsoft Foundry에서는 지원 목록이 더 짧다. 또한 Sonnet 4.5와 같은 이전 모델은 모든 공급자에서 지원되지 않는다고 설명한다. Claude Code에서 Auto 모드를 사용할 수 없다고 보고하면 먼저 이러한 요구 사항과 disableAutoMode 설정을 확인한다. Anthropic이 서버 측에서 Auto 모드를 비활성화할 수도 있다. 이 응답을 받은 세션은 종료될 때까지 Auto 모드가 비활성화된 상태로 유지된다. 따라서 기존 세션에서 기다리지 말고 나중에 새 세션을 시작해야 한다.
bypassPermissions을 포함한 모든 모드에서 적용되는 제어 항목은 2가지다. deny 규칙과 명시적인 ask 규칙이다. 다른 도구를 계속 사용할 수 있는 동안에는 어느 규칙도 EndConversation에 적용되지 않는다. 세션이 어떤 모드로 시작하든 이 제어 항목을 사용할 수 있다.
auto mode classifier가 차단하는 항목
classifier는 실행 대기 중인 작업을 읽고, 해당 작업이 사용자가 요청한 범위에 맞는지 판단하는 두 번째 모델입니다. 문서에서는 역할을 다음 한 문장으로 설명합니다.
별도의 classifier model이 작업 실행 전에 이를 검토하여, 요청 범위를 벗어나 권한을 확대하거나, 인식되지 않은 인프라를 대상으로 하거나, Claude가 읽은 악성 콘텐츠의 영향을 받은 것으로 보이는 작업을 차단합니다.
서버 운영자가 가장 자주 접하는 범주에서는 다음 작업이 기본적으로 차단됩니다.
curl | bash와 같은 코드 다운로드 및 실행- 프로덕션 배포 및 마이그레이션
- 강제 push
- 공유 인프라 수정
- 로컬 서비스를 public internet에서 접근할 수 있게 만드는 터널 또는 reverse shell 열기
- 현재 유효한 credential 또는 token을 transcript나 파일에 출력하기
다음 작업은 기본적으로 허용됩니다.
- 작업 디렉터리의 로컬 파일 작업
- lock file 또는 manifest에 선언된 dependency 설치
- 읽기 전용 HTTP 요청
- 현재 작업 중인 repository의 branch로 push. default branch도 포함하지만, 이름이 배포 또는 publication 대상임을 나타내는 non-default branch는 제외합니다. push하는 콘텐츠에는 여전히 classifier의 다른 규칙이 적용됩니다.
위 요약만 기준으로 작업하지 마십시오. claude auto-mode defaults을 실행하여 전체 규칙 목록을 JSON으로 출력하고, 설치된 version에 함께 제공된 규칙을 확인하십시오. /auto-mode-setup은 별도의 command입니다. 이 command는 project와 최근 session에서 autoMode.environment 항목의 초안을 만들고, 초안을 수락하면 ~/.claude/settings.json에 기록합니다. version 요구 사항은 claude auto-mode defaults이 아니라 이 command에 적용됩니다. Pro, Max, Ultra 및 Team plan에서는 /auto-mode-setup에 v2.1.228 이상이 필요합니다. native Windows에서는 v2.1.233 이상이 필요합니다. Enterprise plan 또는 Claude Console API key를 사용하는 경우에는 v2.1.283 이상이 필요합니다. v2.1.304 이전에는 telemetry가 꺼진 시스템이나 third-party provider를 사용하는 시스템처럼 feature flag를 가져오지 않는 session에서 /auto-mode-setup이 누락됩니다. 해당 조건이라면 먼저 update하십시오.
이 기능에 의존하기 전에 두 가지 문서화된 제한을 알아야 합니다. 첫째, Claude Code가 자체적으로 전송하는 classifier request에서 classifier는 사용자의 message, file read와 search 같은 읽기 전용 lookup을 제외한 tool call, 그리고 사용자의 CLAUDE.md content를 확인합니다. tool result는 제거됩니다. 따라서 Claude가 읽은 파일이나 web page 안의 텍스트로 classifier에 직접 지시할 수 없습니다. 둘째, classifier가 한 session에서 연속 3회 또는 총 20회 action을 차단하면 auto mode가 일시 중지되고 Claude Code는 다시 사용자에게 확인을 요청합니다. 확인을 요청받은 action을 승인하면 auto mode가 재개됩니다. 이 threshold는 설정할 수 없습니다. -p flag를 사용하고 --permission-prompt-tool이 없는 non-interactive 실행에는 확인을 요청할 사람이 없습니다. 문서에는 Claude Code가 이 경우 실행을 중지하지 않는다고 명시되어 있습니다. 차단된 action은 실행되지 않지만 Claude는 계속 작업합니다.
두 번째 동작은 remote box에서 두 가지 방식으로 문제를 일으킵니다. 실행 중인 interactive session이 제한에 걸리면 prompt에서 멈추고, terminal을 보고 있지 않은 사람이 응답하기를 기다립니다. -p 실행은 대기하지 않으므로 job이 차단된 단계가 완료되지 않은 상태로 끝날 수 있습니다. 같은 box에서 실행하는 두 번째 Claude Code session은 그 사람을 대신할 수 없습니다. 한 session에서 다른 session으로 전송된 텍스트는 사용자의 동의로 간주되지 않으며 대기 중인 permission prompt에 답할 수도 없습니다. 따라서 한 session이 일시 중지된 경우에도 human의 응답이 필요합니다. agent가 수행하려는 작업의 범위를 줄이는 것도 해결책의 일부입니다. agent가 작동하는 데 필요한 최소 변경으로 향하도록 하는 skill을 사용하면 session이 classifier가 차단하는 광범위한 작업으로 벗어나지 않게 할 수 있습니다. skill은 하나의 작업을 특정 방향으로 유도합니다. 반면 output style은 system prompt 자체를 편집합니다. 따라서 작고 제한적인 변경을 요청하는 style은 호출한 하나의 job이 아니라 session의 모든 turn에 적용됩니다.
settings.json에서 모드가 정의되는 위치
앞의 모든 내용은 settings 파일에 있는 하나의 객체입니다.
{
"permissions": {
"defaultMode": "auto",
"allow": [
"Bash(npm run test *)",
"Bash(git status)"
],
"ask": [
"Bash(git push *)",
"Bash(docker compose up *)"
],
"deny": [
"Read(./.env)",
"Read(./secrets/**)",
"Bash(curl *)"
]
}
}규칙은 deny, ask, allow 순서로 평가됩니다. 이 순서에서 처음 일치하는 규칙이 결과를 결정하며, 더 좁은 규칙이 앞에 있는 더 넓은 규칙보다 우선하지 않습니다. Bash(aws *)에 대한 deny 규칙은 동일한 명령을 허용한 경우에도 aws s3 ls를 차단합니다. 따라서 allow 규칙으로 deny 규칙의 예외를 만들 수 없습니다. Read 및 Edit의 deny 또는 ask 규칙에서는 gitignore 부정 패턴도 지원합니다. 하나의 settings 파일에 있는 deny 목록에서 Read(*.env) 뒤에 Read(!sample.env)를 배치하면, 앞의 규칙에서 sample.env이라는 이름의 파일이 제외됩니다. 이 예외는 동일한 settings 소스에 있는 앞선 상대 경로 규칙에만 적용됩니다. 다른 소스의 deny 규칙을 덮어쓸 수 없으며, 디렉터리 전체가 차단된 경우 그 안의 파일을 다시 허용할 수도 없습니다.
ask는 auto 모드에서 특히 유용한 규칙 유형입니다. Auto 모드는 반복적인 확인 메시지를 제거하지만, ask 규칙을 사용하면 사용자의 확인이 필요한 특정 명령에 다시 확인 절차를 적용할 수 있습니다. 배포 명령을 여기에 넣으면 됩니다. 코드가 시스템 외부로 나가기 전에 확인 지점을 두려는 경우에는 Bash(git push *)도 여기에 넣습니다. 자격 증명 파일을 deny에 보관하는 것은 이 구성의 다른 한 축이며, 애초에 자격 증명을 에이전트가 접근할 수 없는 곳에 보관하는 방법과 함께 사용합니다.
settings 파일 자체는 우선순위가 낮은 것부터 다음과 같습니다.
~/.claude/settings.json: 사용자의 설정이며 모든 프로젝트에 적용됩니다..claude/settings.json: 프로젝트 설정이며 저장소에 커밋됩니다..claude/settings.local.json: 하나의 저장소에만 적용되는 사용자의 설정입니다. Claude Code가 이 파일을 만들면 git에서 무시되며, 직접 만들 경우.gitignore에 추가해야 합니다.- 관리 설정: 관리자가 배포하는 설정입니다. Linux에서는 이 파일이
/etc/claude-code/managed-settings.json입니다. 명령줄 플래그를 포함해 어떤 설정도 관리되는 권한 규칙을 덮어쓸 수 없습니다.
여기에는 문서화된 원인이 있는 함정이 하나 있습니다. defaultMode: "auto"가 .claude/settings.json 또는 .claude/settings.local.json에서 제공되면 적용되지 않습니다. 저장소가 settings 파일을 배포해 스스로 auto 모드를 활성화할 수 없도록 하기 위해서입니다. bypassPermissions도 이 두 파일에서는 무시됩니다. 해당 파일에서 auto을 설정하면 Claude Code는 기본 제공 기본값으로 돌아갑니다. 이때 ~/.claude/settings.json의 defaultMode은 건너뛰며, 어디에도 오류가 출력되지 않습니다. 해당 버전 또는 플랜에서 기본 제공 기본값이 Manual이면 세션은 조용히 default 모드로 시작합니다. 해당 줄을 ~/.claude/settings.json로 옮기십시오. /permissions를 실행하면 현재 활성화된 모든 규칙과 각 규칙의 출처 파일을 함께 확인할 수 있습니다.
모드를 비활성화하는 두 스위치
관리자는 2개의 kill switch를 사용할 수 있으며, 두 설정 모두 boolean이 아니라 "disable" 문자열을 사용합니다.
{
"permissions": {
"disableAutoMode": "disable",
"disableBypassPermissionsMode": "disable"
}
}문서에 따르면 두 설정은 모든 설정 파일에서 "disable" 문자열을 허용합니다. 재정의할 수 없는 관리형 설정에서 특히 유용합니다.
disableAutoMode는 Shift+Tab 주기에서 auto을 제거하므로, --permission-mode auto으로 시작한 세션은 대신 Manual 모드로 시작합니다. disableBypassPermissionsMode는 bypass 모드에서 같은 역할을 하며 모든 scope에서 작동합니다. 따라서 실행 중인 서버에서 새벽 2시에 진입하고 싶지 않은 모드에 자신이 접근하지 못하도록 개인 ~/.claude/settings.json에 설정할 수 있습니다. 다른 사람도 사용하는 서버라면 두 설정을 대신 /etc/claude-code/managed-settings.json에 넣어야 합니다. 사용자 설정 파일은 사용자에게 속하지만 관리형 설정 파일은 그렇지 않기 때문입니다.
VPS에서 자동 모드에 격리 경계가 필요한 이유
분류기는 한 번에 하나의 동작을 검토합니다. 승인된 동작이 이후에 무엇을 수행하는지는 포함하지 않습니다. 문서는 다음과 같이 명확하게 선을 긋습니다.
분류기는 동작별 제어 장치이지 격리 경계가 아닙니다. 따라서 무인 실행 시 심층 방어를 위해 격리 경계가 여전히 유효하며, --dangerously-skip-permissions와 같은 방식처럼 필수적인 것은 아닙니다.
그러므로 원격 서버를 위한 조합은 자동 모드와 손실을 감수할 수 있는 환경이지, bypassPermissions와 요행을 바라는 것이 아닙니다. 우회 모드는 컨테이너, 가상 머신, 인터넷 연결이 차단된 개발 컨테이너와 같이 Claude Code가 호스트 시스템을 손상시킬 수 없는 격리된 환경에서만 사용하도록 문서화되어 있습니다. 데이터베이스와 리버스 프록시를 실행 중인 VPS는 이러한 환경에 해당하지 않습니다.
서버에서는 세 가지 요소가 가장 중요합니다. Claude Code는 절대 root가 아닌 일반 사용자로 실행하십시오. 해당 사용자에게는 작업 디렉터리 외에 읽을 가치가 있는 어떠한 데이터도 제공하지 마십시오. 서버를 수리하기보다는 재구축하십시오. 이것이 바로 작업 후 폐기하는 일회용 VM을 사용하는 이유입니다. 사용자 생성부터 방화벽 규칙까지, 이러한 보안 강화의 세부 사항은 VPS에서 Claude Code를 실행하기 위한 전체 안전 가이드에서 다루고 있으므로 여기서는 반복하지 않습니다.
Claude Code는 root 실행 제한 규칙을 자체적으로 강제합니다. Linux 및 macOS에서 sudo 권한으로 실행하거나 root 계정으로 실행할 경우 우회 모드 시작을 거부합니다.
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons이 검사는 인식된 샌드박스 내부에서는 건너뜁니다. 이것이 바로 자율 컨테이너 작업을 위한 문서화된 답변이 non-root 사용자로 Claude Code를 실행하는 개발 컨테이너인 이유입니다. 휴대폰이나 노트북에서 SSH를 통해 에이전트를 구동하는 경우, tmux에서 장시간 유지되는 Claude Code 세션에도 동일한 논리가 적용됩니다. 세션이 실행되는 동안 프롬프트를 지켜보는 사람은 아무도 없습니다. 로그인 자체가 성공해야 모든 것이 시작되므로, 서버가 Permission denied (publickey) 오류로 접속을 거부한다면 상세 SSH 출력 메시지를 통해 실제 발생한 5가지 오류 중 무엇인지 확인하십시오.
Ubuntu VPS에서 Bash sandbox 설정
기본 제공 sandbox는 Claude가 실행하는 sandbox 처리된 Bash 명령의 파일 시스템 및 네트워크 접근을 제한하며, 운영 체제는 자식 프로세스에도 이 제한을 적용한다. 제외된 명령과 승인된 sandbox 외부 재시도는 sandbox 밖에서 실행된다. Linux에서는 2개의 패키지가 필요하다.
sudo apt-get install bubblewrap socatClaude Code를 시작하고 /sandbox를 실행한다. Mode, Overrides, Config 탭이 있는 패널이 열린다. 필요한 패키지가 없으면 Dependencies 탭만 표시되며, 설치해야 할 항목이 나열된다. 종속성 검사는 시작할 때 실행되므로 패키지를 설치한 뒤 Claude Code를 다시 시작해야 한다. 그렇지 않으면 패널에 해당 패키지가 여전히 없는 것으로 표시된다.
Ubuntu 24.04 이상에서는 기본 AppArmor 정책이 bubblewrap이 필요한 user namespace를 생성하지 못하게 하므로 sandbox를 시작할 수 없다. 해당 문제가 서버에 적용되는지 확인한다.
sysctl kernel.apparmor_restrict_unprivileged_userns0이 출력되거나 key가 존재하지 않는다는 오류가 표시되면 추가 작업이 필요하지 않다. 1가 출력되면 bwrap에 자체 프로필이 필요하다.
sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>
profile bwrap /usr/bin/bwrap flags=(unconfined) {
userns,
include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmor이 프로필은 bwrap 자체에 적용되며, sandbox 내부에서 bwrap이 실행하는 명령에는 적용되지 않는다. 그런 다음 설정에서 경계를 더 좁힌다.
{
"sandbox": {
"enabled": true,
"filesystem": {
"denyRead": ["~/"],
"allowRead": ["."]
},
"network": {
"allowedDomains": ["github.com", "*.npmjs.org"]
}
}
}이 블록은 프로젝트의 .claude/settings.json에 있어야 한다. .은 프로젝트 설정에서만 프로젝트 루트로 확인되기 때문이다. 같은 줄을 ~/.claude/settings.json에 넣으면 .은 대신 ~/.claude로 확인된다. 그러면 denyRead 규칙이 프로젝트 파일을 차단하므로 모든 명령이 편집해야 하는 코드를 읽지 못한다.
이 설정으로 제한되지 않는 항목도 알아 두어야 한다. sandbox는 Bash와 그 자식 프로세스를 제한한다. 기본 제공 파일 도구는 Claude Code 프로세스 내부에서 실행된다. MCP (model context protocol) 서버와 hooks는 호스트에서 제한 없이 실행되는 별도의 프로세스다. 이들을 모두 하나의 경계 안에 두려면 전체 Claude Code 프로세스를 컨테이너, 가상 머신 또는 @anthropic-ai/sandbox-runtime 패키지 내부에서 실행해야 한다. 이 패키지는 이 글을 작성하는 시점에 beta 연구용 미리보기다.
각 설정에는 어떤 모드가 적합합니까?
개인 노트북의 단일 저장소
auto을 사용하고, 실행을 확인하려는 작업에는 ask 규칙을 적용하십시오. 사용자가 직접 키보드 앞에 있고 분류기(classifier)의 폴백(fallback)이 사용자에게 도달할 수 있으며, 피해 범위가 제어 가능한 단일 장비로 제한됩니다. 8월 14일 기본값은 바로 이 경우를 위해 작성되었습니다.
공유 VPS
사용자별로 auto를 사용하고, 각 사용자의 ~/.claude/settings.json에 설정하십시오. 이때 Claude Code를 실행하는 계정은 root가 아니어야 하며 다른 사용자의 작업을 읽을 수 없어야 합니다. 공유 경로를 보호하는 거부 규칙과 함께 disableBypassPermissionsMode을 /etc/claude-code/managed-settings.json 내의 "disable"로 배포하십시오. 공유 장비는 bypassPermissions이 부적절한 가장 명확한 사례입니다. 해당 모드가 가정하는 격리 경계가 존재하지 않으며, 다른 사용자들이 그 경계 내부에 있기 때문입니다.
CI 및 무인 세션
작업에 필요한 명령을 명시한 allow 목록과 함께 dontAsk을 사용하십시오. 프롬프트를 확인할 사람이 없는 경우 자동 거부(auto-deny)가 올바른 실패 모드입니다. Auto 모드도 비대화형으로 실행되지만, 분류기 차단이 반복되는 -p 실행은 중단되지 않습니다. 차단된 작업은 건너뛰고 Claude는 계속 작업을 수행하므로, 일부 단계가 완료되지 않은 채로 작업이 종료될 수 있습니다. bypassPermissions는 이미지에서 다시 빌드하는 컨테이너나 가상 머신에만 사용하고, 중요한 작업이 실행 중인 호스트에서는 사용하지 마십시오.
FAQ
Claude Code에서 auto mode가 기본값이 되는 시점은 언제입니까?
Pro, Max, Team 요금제의 새 세션에서는 14 August 2026에 기본값이 되었습니다. 27 October 2026 현재 문서에 따르면 Claude Code v2.1.283 이상에서는 모든 요금제와 provider의 대화형 터미널 및 VS Code 세션에서 auto mode가 기본 시작 모드입니다. 단, HIPAA 구성이 적용된 조직에서는 예외적으로 v2.1.285 이상에서 Manual mode로 시작합니다. 비대화형 claude -p 실행은 모드를 지정하지 않으면 default에서 시작합니다. v2.1.302 이전에는 third-party provider를 사용하거나 telemetry를 끈 실행이 auto에서 시작할 수 있었습니다. v2.1.302부터는 이러한 실행도 default에서 시작합니다. 직접 설정한 기본값은 일회성 전환 프롬프트를 수락하지 않는 한 유지됩니다. 조직에서 관리하는 기본값은 변경되지 않습니다. 세션의 실제 모드는 상태 표시줄에서 확인할 수 있습니다. auto mode에서는 ⏵⏵ auto mode on로 표시됩니다.
VPS에서 auto mode와 bypassPermissions 중 무엇을 사용해야 합니까?
격리 경계와 함께 auto mode를 사용합니다. classifier는 작업이 실행되기 전에 해당 작업을 검토합니다. 보호된 경로 밖에서 수행하는 읽기와 작업 디렉터리 수정은 검토를 건너뜁니다. 그러나 문서에는 auto mode가 작업별 제어 기능일 뿐 격리 경계가 아니라고 명시되어 있습니다. 따라서 unattended 실행에는 container, virtual machine 또는 필요할 때 재구축할 수 있는 서버를 사용해야 합니다. bypassPermissions는 검사를 완전히 건너뛰며, 격리된 환경에서만 사용하도록 문서화되어 있습니다. Claude Code는 Linux에서 root로 해당 모드에서 시작하는 것을 거부하고 --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons을 출력합니다.
서버에서 누구도 auto mode 또는 bypass mode를 사용하지 못하게 하려면 어떻게 해야 합니까?
/etc/claude-code/managed-settings.json에서 permissions.disableAutoMode과 permissions.disableBypassPermissionsMode를 문자열 "disable"로 설정합니다. 관리되는 설정은 다른 모든 범위보다 우선하므로 사용자 설정 파일이나 명령줄 flag로 이를 재정의할 수 없습니다. disableAutoMode는 auto을 Shift+Tab 순환에서 제거합니다. 또한 --permission-mode auto으로 시작한 세션은 Manual mode로 시작합니다. disableBypassPermissionsMode도 모든 범위에서 작동하므로 사용자가 자신의 ~/.claude/settings.json에 설정할 수 있습니다.
defaultMode: "auto" 설정이 무시되는 이유는 무엇입니까?
잘못된 파일에 설정했기 때문입니다. defaultMode: "auto"은 .claude/settings.json 또는 .claude/settings.local.json에서 제공될 때 적용되지 않습니다. 따라서 repository가 settings file을 포함하는 것만으로 auto mode를 활성화할 수 없습니다. Claude Code는 대신 내장 기본값으로 되돌아갑니다. 이때 사용자 설정의 defaultMode은 건너뛰며 오류도 출력하지 않습니다. 내장 기본값이 Manual인 경우 세션은 default mode로 시작합니다. 설정을 ~/.claude/settings.json로 옮긴 다음 /permissions을 실행하여 각 활성 규칙의 출처인 파일을 확인합니다. auto mode를 계속 사용할 수 없다면 model 요구 사항을 확인합니다. Sonnet 4.5와 같은 이전 model은 어떤 provider에서도 지원되지 않습니다.