Claude Code Auto Mode: AI 에이전트의 안전한 자율 실행을 위한 새로운 권한 모드

Claude Code는 파일 편집, 셸 명령 실행, 웹 페칭을 할 때마다 “허용하시겠습니까?” 프롬프트를 띄웁니다. 복잡한 리팩토링이나 긴 디버깅 세션에서는 승인이 수십 번 필요합니다. 승인이 반복되면 사용자는 내용을 읽지 않고 전부 허용하게 됩니다.

bypassPermissions 모드는 프롬프트를 모두 없애지만, 격리되지 않은 환경에서는 위험합니다. Auto Mode는 승인 피로를 줄이면서 안전성을 유지하려고 추가된 모드입니다.

이 글에서는 Auto Mode의 동작 원리, 기존 모드와의 차이, 사용법, 주의할 점을 정리합니다.

Auto Mode란

Auto Mode는 2026년 3월 Claude Code에 추가된 권한 모드입니다. Team 플랜에서 연구 미리보기(research preview)로 시작했고, Claude Sonnet 4.6 또는 Opus 4.6 이상이 필요합니다.

Auto Mode는 “기본 모드보다 적은 중단, 권한 스킵보다 낮은 위험”을 목표로 합니다. 사용자가 매번 도구 호출을 승인하는 대신, AI 기반 분류기(classifier)가 각 도구 호출의 위험도를 평가합니다. 분류기가 안전하다고 판단하면 자동 실행하고, 위험하다고 판단하면 사용자에게 확인을 요청합니다.

이중 계층 방어 체계: 입력과 출력을 따로 검사

Auto Mode는 이중 계층 방어 체계(Dual-Layer Defense)로 입력과 출력 양쪽에서 위험을 감지합니다.

입력 계층: 프롬프트 인젝션 탐지

서버 측 탐지기가 Claude Code가 읽는 모든 외부 데이터를 스캔합니다. 파일 내용, 웹 페이지 응답, 셸 출력에 삽입된 악성 지시를 감지하면 경고를 추가합니다. 경고를 받은 에이전트는 해당 콘텐츠를 의심하고 사용자의 원래 요청을 따릅니다.

출력 계층: 도구 호출 분류기

Sonnet 4.6 기반 분류기가 모든 도구 호출을 실행 전에 검토합니다. 이 분류기는 2단계 파이프라인으로 동작합니다.

1. 1단계 — 빠른 필터: 1토큰으로 즉시 허용/차단/플래그를 결정합니다. 대부분의 안전한 호출은 이 단계에서 통과합니다.
2. 2단계 — 심층 검토: 1단계에서 플래그된 항목만 사슬형 추론(chain-of-thought reasoning)으로 재검토합니다.

flowchart TD
    A["도구 호출 발생"] --> B{"입력 계층<br/>프롬프트 인젝션<br/>탐지"}
    B -->|"인젝션 감지"| C["경고 추가 ⚠️<br/>의심 콘텐츠로 표시"]
    C --> D
    B -->|"통과"| D{"출력 계층 — 1단계<br/>빠른 필터<br/>(1토큰 결정)"}
    D -->|"허용"| E["자동 실행 ✅"]
    D -->|"차단"| H["차단 🚫"]
    D -->|"플래그"| F{"출력 계층 — 2단계<br/>심층 검토<br/>(사슬형 추론)"}
    F -->|"허용"| E
    F -->|"차단"| H
    F -->|"불확실"| G["사용자에게<br/>권한 요청 🙋"]

권한 결정 순서

Auto Mode는 도구 호출이 발생하면 다음 순서로 권한을 결정합니다.

사용자가 CLAUDE.md나 설정에서 정의한 allow/deny 규칙이 가장 먼저 적용됩니다. 그다음 읽기 전용 도구와 파일 편집은 자동 승인되고, 외부 도구만 분류기가 검증합니다. 일상 작업 대부분은 분류기를 거치지 않으므로 지연이 거의 생기지 않습니다.

권한 모드 비교

Claude Code는 권한 모드 6가지를 제공합니다. Auto Mode는 편의성과 안전성 사이의 중간에 있습니다.

graph TD
    A["높은 안전성<br/>낮은 편의성"] --- B["default"]
    B --- C["acceptEdits"]
    C --- D["plan"]
    D --- E["🔹 auto"]
    E --- F["dontAsk"]
    F --- G["bypassPermissions"]
    G --- H["낮은 안전성<br/>높은 편의성"]

    style E fill:#4A90D9,color:#fff,stroke:#2171B5,stroke-width:2px

사용법

CLI에서 시작하기

# 플래그로 직접 지정
claude --permission-mode auto

# auto를 Shift+Tab 순환에 포함하려면 --enable-auto-mode 필요
claude --enable-auto-mode
# 이후 Shift+Tab: default → acceptEdits → plan → auto → ...

Team 플랜 관리자가 먼저 Auto Mode를 활성화해야 합니다.

설정으로 기본 모드 지정

settings.json에서 Auto Mode를 기본값으로 설정할 수 있습니다.

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

VS Code / JetBrains IDE

IDE 확장에서도 같은 방식으로 씁니다. 하단 상태바에서 현재 권한 모드를 확인하고, 클릭해 변경합니다.

기본 규칙: 무엇이 허용되고 차단되나

Auto Mode에는 미리 정의된 규칙 세트가 있습니다.

기본 허용 항목

• 프로젝트 디렉토리 내 로컬 파일 읽기/쓰기
• 선언된 의존성 설치 (npm install, pip install 등)
• .env 파일 읽기
• 읽기 전용 HTTP 요청
• 세션 시작 시의 브랜치 또는 Claude가 생성한 브랜치로의 git push

기본 차단 항목

• curl | bash 패턴 (원격 스크립트 실행)
• 외부로 민감 데이터 전송
• 프로덕션 배포 명령
• 클라우드 스토리지 대량 삭제
• IAM 권한 부여/변경
• git push --force

주의사항과 한계

분류기 정확도: FNR 17%

Auto Mode 분류기의 성능 지표는 다음과 같습니다.

• FPR (False Positive Rate): 0.4% — 안전한 명령을 위험하다고 잘못 판단하는 비율
• FNR (False Negative Rate): 17% — 위험한 명령을 안전하다고 잘못 판단하는 비율

FPR이 0.4%이므로 일상 작업은 거의 중단되지 않습니다. 반면 FNR 17%는 위험한 명령 100개 중 약 17개가 분류기를 통과할 수 있다는 뜻입니다.

그래서 Auto Mode는 bypassPermissions보다 안전하지만, 모든 위험한 명령을 막지는 못합니다.

폴백 메커니즘

분류기가 반복적으로 작업을 차단하면, Auto Mode가 일시 정지되고 수동 승인 모드로 전환됩니다.

• 3회 연속 차단 또는 세션 내 총 20회 차단 시 전환
• 사용자가 프롬프트된 작업을 승인하면 거부 카운터가 리셋되어 Auto Mode를 이어갈 수 있습니다
• 이 임계값은 사용자가 변경할 수 없습니다

분류기가 판단하기 어려운 상황이 이어지면 이 폴백이 사용자 승인으로 되돌립니다.

권장 사용 환경

작업 종류에 따라 Auto Mode를 쓸지 정합니다.

• 적합: 로컬 개발, 프로토타이핑, 리팩토링, 디버깅
• 부적합: 프로덕션 서버 관리, 민감 데이터 처리, 인프라 변경

민감한 작업이라면 default 모드를 유지합니다. 장시간 반복 작업에서만 Auto Mode를 켭니다.

마무리

Auto Mode는 권한 승인 피로를 줄이고, AI 기반 이중 계층 방어로 위험한 호출을 걸러냅니다.

정리하면 다음과 같습니다.

1. 이중 계층 방어: 입력(프롬프트 인젝션 탐지) + 출력(도구 호출 분류기)으로 안전성 확보
2. 3단계 권한 구조: 읽기 전용 → 파일 편집 → 외부 도구 순으로 분류기 개입 최소화
3. FNR 17%: 완벽하지 않으므로, 민감한 작업에서는 여전히 default 모드 권장
4. 폴백 메커니즘: 분류기 불확실 시 자동으로 수동 승인 전환

Auto Mode는 아직 연구 미리보기 단계입니다. --enable-auto-mode로 실행한 뒤 Shift+Tab으로 모드를 전환하면 바로 써 볼 수 있습니다.

관련 글

• Claude Code /btw 가이드 — 메인 세션을 오염시키지 않는 사이드 질문
• Claude Code Ultra Plan 살펴보기 — 계획과 실행을 나누는 워크플로

참고 자료

• Auto Mode 공식 블로그 포스트 ↗
• Auto Mode 기술 상세 (Engineering Blog) ↗
• Claude Code 권한 모드 문서 ↗