본문으로 건너뛰기

Bypass 모드

v1
작성 2026-04-12읽는 시간 2분

Shift+Tab 하나로 AI의 자율성을 조절해요

이건 뭐예요?​

Claude Code(클로드 코드)를 처음 켜고 일을 시켜보면, 파일 하나를 고칠 때마다 "이거 수정해도 돼요?" 하고 계속 물어볼 거예요.

마치 아주 꼼꼼한 신입사원이 "사장님, 이 문서 제가 고쳐도 될까요?" 하고 매번 허락을 구하는 거죠. 처음엔 안심이 되지만, 바이브 코딩(AI에게 방향만 지시하고 코드를 짜게 하는 방식)에 푹 빠져서 속도를 내고 싶을 때는 이 질문 창이 흐름을 끊어먹곤 해요.

이럴 때 권한 모드(Permission Mode) 를 바꿔주면, AI가 얼마나 자유롭게 일할 수 있는지를 조절할 수 있어요.

우리는 이렇게 쓰고 있어요​

AI//STUDY 사이트에 올라오는 글들은 대부분 Bypass 모드로 작성하고 있어요. 이유는 간단해요 — 어차피 AI가 만든 글은 제가 직접 검수하고 수정해야 하거든요. 그러니 작성 단계에서는 AI에게 전권을 주고 최대한 빠르게 초안을 뽑아내는 게 훨씬 효율적이에요. 덕분에 글 작성 속도가 비약적으로 빨라졌어요.

단, 처음 새 프로젝트를 시작할 때는 Plan 모드를 활용해요. "이 프로젝트 구조를 어떻게 잡을까?", "어떤 파일이 필요할까?" 같은 기획 단계에서는 AI가 바로 코드를 짜는 것보다 계획서를 먼저 보여주는 게 훨씬 유용하거든요. 방향이 잡히면 그때 Bypass 모드로 전환해서 속도를 내는 식이에요.

Shift+Tab으로 순환하는 기본 3가지 모드​

Claude Code 터미널(검은색 명령창)에서 Shift + Tab 을 동시에 누르면, 아래 3가지 모드가 빙글빙글 순환해요.

1. Default (기본 모드)

  • 파일 읽기만 자동이고, 수정이나 명령어 실행은 매번 물어봐요.
  • "사장님, 이거 해도 될까요?" 매번 묻는 신입사원이에요.
  • 처음 시작할 때, 또는 중요한 파일을 다룰 때 쓰면 좋아요.

2. acceptEdits (파일 수정 자동 모드)

  • 파일 생성/수정은 알아서 하고, 터미널 명령어(컴퓨터 시스템에 직접 내리는 지시)를 실행할 때만 물어봐요.
  • "문서 작업은 제가 알아서 할게요. 시스템 명령은 여쭤볼게요!"
  • 코딩 흐름이 끊기지 않으면서도 위험한 작업은 막을 수 있어서, 가장 많이 쓰는 모드예요.

3. Plan (계획 모드)

  • 파일을 읽고 분석만 하고, 실제 수정은 하지 않아요. 어떤 작업을 할지 계획서만 작성해요.
  • "이렇게 고치면 어떨까요?" 제안서를 먼저 보여주는 컨설턴트예요.
  • 코드베이스(프로젝트의 전체 코드 묶음)를 파악하거나, 큰 작업 전에 방향을 잡을 때 유용해요.
이것만 기억하세요

Shift+Tab을 누를 때마다: Default -> acceptEdits -> Plan -> 다시 Default... 이렇게 돌아요. 현재 모드는 화면 하단 상태 표시줄에 나타나요.

더 강력한 모드도 있어요​

위 3개 외에도 특수한 상황에서 쓰는 모드가 있어요. 이 모드들은 Shift+Tab 순환에 기본으로 포함되지 않고, 별도 옵션을 켜야 사용할 수 있어요.

bypassPermissions (전체 자동 모드)

  • 모든 작업을 묻지 않고 실행해요. 화면에 빨간 경고가 떠요.
  • "사장님은 쉬세요, 제가 다 해놓겠습니다!" 전권을 위임받은 베테랑 직원이에요.
  • 속도가 가장 빠르고, 어느 정도 익숙해지면 무조건 켜고 쓰는 게 업무 속도에 유리해요.
  • AI가 실수한 코드도 바로 저장되니, Git 커밋을 자주 해두는 습관이 중요해요.

bypass 모드 활성화 화면

이 모드를 켜려면 Claude Code를 시작할 때 옵션을 붙여야 해요.

# 전체 자동 모드로 Claude Code 시작하기
claude --dangerously-skip-permissions

클로드 코드 터미널에서는 이렇게​

Claude Code가 이미 실행 중인 상태에서 해볼 수 있는 것들이에요.

클로드 코드 대화창에서 ! 를 맨 앞에 붙이면 터미널 명령어를 바로 실행할 수 있어요.

# 현재 내 권한 설정을 확인하는 명령어예요
! claude config list

모드 전환은 키보드로 바로 할 수 있어요. 대화창에 아무것도 입력하지 않은 상태에서:

  1. Shift+Tab 을 한 번 누르면 -> acceptEdits 모드로 전환
  2. Shift+Tab 을 또 누르면 -> plan 모드로 전환
  3. Shift+Tab 을 한 번 더 누르면 -> 다시 default 모드로 돌아와요

화면 하단에 현재 모드가 표시되니, 바뀌는 걸 눈으로 확인하면서 눌러보세요.

이런 분께 추천해요​

권한 모드는 여러분의 익숙함 정도에 따라 바꿔가며 쓰는 걸 추천해요.

  • 완전 초보자: Default 모드로 시작하세요. AI가 어떤 파일을 건드리고 어떤 명령을 내리는지 하나하나 관찰하며 배우기 좋아요.
  • 조금 익숙해진 분: acceptEdits 모드로 올려보세요. 코드가 자동으로 작성되는 진짜 바이브 코딩의 속도를 체감할 수 있어요.
  • 실전 바이브 코더: bypassPermissions 모드를 기본으로 켜세요. 어차피 결과는 직접 확인해야 하니, 작성 속도를 최대한 끌어올리는 게 이득이에요. Git 커밋(코드의 특정 순간을 사진 찍듯 백업해두는 기능)만 자주 해주면 돼요.

참고 링크​

▸개정 이력1건
  • v12026-04-12초판

이 글이 도움이 되었나요?