Permission Modes(승인 모드)

1. English names and meanings

Manual과 default는 서로 다른 모드가 아닙니다. 화면 이름은 Manual이고 설정값은 default입니다. manual 별칭은 v2.1.200부터 지원됩니다. 여기서는 예시를 default로 통일합니다. 이름에 default가 있어도 현재 제품이 반드시 그 모드로 시작한다는 뜻은 아닙니다. 공식 CLI: 승인 모드 값과 별칭

2. Manual — 사람이 승인하는 방식

예를 들어 Claude가 파일을 수정하거나 명령을 실행하려 할 때, 기존 규칙으로 허용되지 않은 동작이면 무엇을 하려는지 보여 주고 승인을 요청합니다. 작업 폴더 안의 파일 읽기나 기본 허용된 읽기 전용 명령처럼 확인 없이 진행하는 동작도 있으므로, 모든 도구 사용마다 반드시 묻는다는 뜻은 아닙니다.

승인창에서는 대상 파일·명령·접속 대상을 보고 판단합니다. 한 번 허용과 앞으로 같은 범위에 허용은 적용 범위가 다릅니다. 선택지에 적힌 범위를 읽은 뒤 결정합니다. 공식 문서: 도구별 승인과 허용 범위

학습 중에 ‘무엇을 실행하려는지 먼저 보고 싶다’면 이 모드로 시작하여 승인 과정을 익힐 수 있습니다.

3. Auto — 별도 분류기가 심사하는 방식

Auto는 단순히 모든 질문에 예라고 답하는 모드가 아닙니다. 분류기 심사가 필요한 행동을 실행 전에 평가하여 진행하거나 막습니다. 읽기 등 모든 동작이 매번 분류기를 통과하는 것은 아닙니다. 명시적으로 확인하도록 지정한 규칙은 여전히 질문을 만들 수 있습니다. 공식 문서: 규칙과 모드의 판단 순서

지원 조건: 지원 모델과 연결 제공자, 설치 버전, 조직의 허용 여부를 확인해야 합니다. 현재 공식 문서상 모든 요금제가 대상이지만, 사용할 수 없는 모델이나 관리자 설정·서버 상태에 따라 Auto가 나타나지 않거나 Manual로 시작할 수 있습니다. 정확한 모델 목록은 공식 Auto 지원 조건에서 확인합니다.

v2.1.283 이상에서는 대화형 터미널과 VS Code의 기본 시작 모드가 Auto일 수 있습니다. 설치 버전과 계정 조건을 확인하지 않고 ‘아무 옵션 없이 실행하면 반드시 Manual’이라고 가정하지 않습니다.

차단 메시지가 나오면 요청 범위·대상·이유를 먼저 확인합니다. 차단을 없애려고 다른 모드로 바꾸는 절차로 이해하지 않습니다. 자동 심사 결과와 최종 작업 결과의 정확성도 별개입니다.

4. Bypass permissions — 일반 확인을 건너뛰는 방식

이 모드는 Auto처럼 행동을 분류기로 심사해서 허용하는 방식이 아닙니다. 일반적인 승인 질문과 점검을 생략하므로 파일 변경·명령 실행이 곧바로 진행될 수 있습니다. 공식 문서는 영향을 제한한 컨테이너·가상 머신 등의 격리 환경에서만 사용하도록 안내합니다. 공식 영어 설명: Bypass permissions

운영체제의 파일 권한·관리자 정책·서비스 인증을 새로 얻는 기능은 아닙니다. 명시적인 거부 규칙이나 일부 필수 확인은 남으므로 ‘시스템의 모든 제한이 사라진다’는 뜻도 아닙니다. 승인 규칙과 운영체제 격리는 서로 다른 층입니다. 공식 문서: 권한 규칙과 격리의 차이 · 명시적 거부·확인 규칙의 적용

--dangerously-skip-permissions는 같은 모드를 시작하는 다른 표기입니다. 반면 --allow-dangerously-skip-permissions는 모드를 선택 가능하게 추가할 뿐 즉시 켜는 옵션이 아닙니다. 이 페이지에서는 두 옵션을 섞지 않고 명시적인 --permission-mode 예시를 사용합니다. 공식 CLI 옵션

5. macOS — Terminal의 zsh에서 시작하기

작업할 프로젝트의 일반 셸에서 원하는 모드의 명령 하나만 실행합니다. 아래 명령은 Claude Code의 채팅 입력창에 넣는 문장이 아닙니다. 시작 모드를 이번 실행에 지정하며 기본 시작 모드 설정을 영구 변경하지 않습니다.

입력 위치: macOS Terminal의 zsh 셸. Manual로 새 세션을 시작합니다.

claude --permission-mode default

입력 위치: macOS Terminal의 zsh 셸. 지원 조건을 충족하는 환경에서 Auto로 새 세션을 시작합니다.

claude --permission-mode auto

입력 위치: macOS Terminal의 zsh 셸. Bypass permissions 사용 조건을 갖춘 격리된 연습 환경에서만 선택합니다.

claude --permission-mode bypassPermissions

진행 중인 세션을 이 명령으로 바꾸려고 같은 터미널에 중첩 실행하지 않습니다. 실행 중인 모드 변경은 아래의 Shift+Tab 설명을 봅니다.

6. Windows — PowerShell에서 시작하기

Windows Terminal에서 PowerShell 탭을 열고 작업할 프로젝트 폴더로 이동한 뒤 원하는 명령 하나를 실행합니다. WSL 셸과 구별합니다. 이 세 명령의 모드 옵션은 macOS와 같지만, 입력하는 셸과 프로젝트 경로 형식은 다릅니다.

입력 위치: Windows의 로컬 PowerShell. Manual로 새 세션을 시작합니다.

claude --permission-mode default

입력 위치: Windows의 로컬 PowerShell. 지원 조건을 충족하는 환경에서 Auto로 새 세션을 시작합니다.

claude --permission-mode auto

입력 위치: Windows의 로컬 PowerShell. Bypass permissions 사용 조건을 갖춘 격리된 연습 환경에서만 선택합니다.

claude --permission-mode bypassPermissions

이 옵션은 Windows 관리자 권한을 부여하지 않습니다. 조직에서 금지한 모드를 실행 옵션으로 해제하는 방법도 아닙니다.

7. 실행 중 현재 모드 확인과 변경

1. 입력창 하단의 모드 문구를 먼저 읽습니다. 모드 표시 읽는 법에서 예시를 확인합니다.
2. CLI에서는 Shift+Tab으로 현재 세션의 지원 모드를 순환합니다. macOS와 Windows에서 같은 조합입니다.
3. 각 변경 뒤 표시를 다시 확인합니다. 선택 가능한 모드와 순서는 환경에 따라 달라집니다.

Auto는 사용 가능한 환경에서 나타나고, Bypass permissions는 시작할 때 사용 가능하게 켠 세션에서 선택합니다. 한 번 Shift+Tab을 누르면 어느 컴퓨터에서나 같은 모드가 된다고 외우지 않습니다. VS Code나 데스크톱 앱에서는 입력창의 모드 선택기를 사용합니다. 공식 전환 방법 · 공식 FAQ: Shift+Tab

‘확인 없이 진행해’라는 자연어 요청과 실제 모드 변경은 구별합니다. 기존 허용·거부 규칙을 보고 싶으면 다음 명령을 사용합니다. 규칙을 열어 보는 것과 모드를 바꾸는 것도 다른 작업입니다. 공식 문서: /permissions

입력 위치: macOS에서 실행 중인 Claude Code의 요청창. 일반 zsh 셸이 아닙니다.

/permissions

입력 위치: Windows에서 실행 중인 Claude Code의 요청창. 일반 PowerShell이 아닙니다.

/permissions

설치 버전과 지원 옵션을 확인할 때는 별도의 일반 셸에서 아래 명령을 실행합니다. 버전 확인은 업그레이드 명령이 아닙니다.

입력 위치: macOS Terminal의 zsh 셸.

claude --version
claude --help

입력 위치: Windows PowerShell.

claude --version
claude --help

명령을 지정했는데 예상 모드가 아니면 하단 표시와 시작 메시지, 버전·모델·조직 정책을 확인합니다. 최초 Bypass 동의 과정은 동의 사실을 기록할 수 있으므로 ‘세션별 시작 모드 지정’과 ‘어떤 설정 기록도 남기지 않음’은 같은 뜻이 아닙니다.