권한 모드

여섯 가지 권한 모드

전체 목록은 다음과 같습니다. 각 모드는 자유롭게 실행되는 것과 승인이 필요한 것 사이에 서로 다른 경계를 긋습니다.

• 수동(Manual)은 묻지 않고 읽기만 수행합니다. 그 외 모든 작업은 먼저 묻습니다.
• 편집 수락(Accept edits)은 묻지 않고 읽기, 파일 편집, 일반적인 파일 시스템 bash 명령을 실행합니다. 이는 사후에 검토할 코드를 반복 작업할 때 사용합니다.
• 계획(Plan)은 아무것도 편집하지 않고 조사하고 변경 사항을 제안합니다. 읽기는 자유롭게 실행되며, 자동 모드를 사용할 수 있는 경우 자동 모드의 분류기(classifier)가 Claude가 탐색을 위해 실행하는 명령을 검토하여 승인된 명령은 묻지 않고 실행되도록 합니다.
• 자동(Auto)은 모든 것을 수락하며, 별도의 분류기 모델이 대부분의 작업이 실행되기 전에 검토합니다.
• 묻지 않기(Don't ask)는 작업 디렉터리 내 파일 읽기와 사전 승인된 도구를 허용합니다. 묻게 될 작업은 모두 자동으로 거부됩니다.
• 권한 우회(Bypass permissions)는 모든 검사를 건너뜁니다. 이는 dangerously-skip-permissions 플래그와 동일합니다. 격리된 컨테이너나 가상 머신 내에서만 실행하세요.

shift-tab으로 순환하기

각 모드마다 명령을 외울 필요는 없습니다. shift-tab을 눌러 일상적으로 사용하는 모드인 수동, 편집 수락, 계획, 자동을 순환하세요. 하단의 상태 표시줄에는 항상 현재 어떤 모드에 있는지 표시되므로, 아래를 보기만 해도 Claude가 무엇을 할 수 있는지 정확히 알 수 있습니다.

자동 모드의 작동 방식

자동은 손을 떼고 맡기는 모드입니다. Claude는 독자적으로 실행되지만, 대부분의 작업이 실행되기 전에 별도의 분류기 모델이 이를 검토합니다. 분류기는 의도를 지킵니다. 실제로 요청한 범위를 벗어나 확대되는 동작을 감시합니다.

분류기가 차단하도록 설계된 작업의 예는 다음과 같습니다:

• 프로덕션 배포 및 마이그레이션
• 강제 푸시(force push), 또는 다운로드한 코드를 셸로 직접 파이프하는 작업
• 민감한 데이터를 외부 엔드포인트로 전송하는 작업
• 세션 이전에 존재했던 파일을 되돌릴 수 없이 삭제하는 작업

그리고 일상적인 작업은 그대로 통과시킵니다. 프로젝트 내 로컬 편집, 락 파일에서 종속성 설치, 읽기 전용 요청, 그리고 기본 브랜치를 포함하여 작업 중인 저장소의 모든 브랜치로의 푸시가 여기에 해당합니다. 예외는 production이나 gh-pages처럼 이름 자체가 배포 대상임을 나타내는 다른 브랜치입니다. 분류기는 그곳으로의 푸시를 자체 기준으로 판단합니다.

분류기가 할 수 없는 것

분류기는 정확성이 아니라 의도를 확인합니다. 코드가 실제로 동작하는지는 파악하지 못합니다. 그래서 Claude에게 인증 기능을 리팩터링하도록 요청했을 때 Claude가 망가진 인증 코드를 작성하더라도, 분류기는 이를 그대로 통과시킵니다. 망가진 것이 위험한 것은 아니기 때문입니다.

그렇기 때문에 자동 모드를 테스트를 실행하는 stop hook과 함께 사용해야 합니다. 이 둘은 함께 작동합니다:

• 자동 모드는 Claude가 실행되는 동안 무엇을 하려고 하는지 감시합니다.
• stop hook은 Claude가 마친 후 코드가 실제로 동작하는지 확인합니다.

하나는 대부분의 작업 전에 의도를 지키고, 다른 하나는 그 이후에 정확성을 지킵니다. 자동 모드의 가드레일은 아직 계속 발전하고 있으므로, 최신 차단 목록과 허용 목록은 문서를 확인하세요.

무인 실행을 위한 묻지 않기

묻지 않기는 프롬프트를 승인할 사람이 주변에 없을 때 적합한 선택입니다. CI 파이프라인, 예약된 작업, 야간 배치 작업이 그 예입니다. Claude는 수동 모드에서 승인이 필요 없는 작업, 즉 작업 디렉터리 내 파일 읽기와 사전 승인된 도구를 여전히 실행합니다. 그 외에 묻게 될 작업은 모두 자동으로 거부됩니다. 바로 이것이 핵심입니다. 아무도 승인해 줄 사람이 없는 상황에서 승인을 기다리며 멈춰 있지 않고, 파이프라인이 계속 진행됩니다.

작업에 맞는 모드 선택하기

권한 모드는 여러 가지가 있으며, shift-tab을 순환하여 일상적으로 사용하는 모드에 도달할 수 있습니다. 요약하면 다음과 같습니다:

• 자동(Auto)은 손을 떼고 맡기는 모드입니다. 분류기는 대부분의 작업 전에 의도를 확인하고, stop hook은 그 이후 정확성을 확인합니다.
• 묻지 않기(Don't ask)는 승인할 사람이 없는 무인 파이프라인을 다룹니다.
• 권한 우회(Bypass permissions)는 격리된 컨테이너와 VM 내에서만 사용합니다.

하고 있는 작업에 맞는 모드를 선택하고, 그 수준에서 Claude가 실행되도록 하세요.