권한 모드 (Permission Mode)
권한 모드는 AI 코딩 도구가 파일 수정이나 명령 실행을 어디까지 물어보지 않고 진행할지 정하는 설정으로, 매번 승인하는 안전한 모드부터 전부 자동으로 실행하는 모드까지 단계별로 전환하며 씁니다.
권한 모드는 AI에게 주는 열쇠의 개수입니다. AI가 코드를 "제안"하는 데서 그치지 않고 직접 파일을 고치고 터미널 명령을 실행하게 되면서 생긴 개념이에요.
바이브코딩이 답답하게 느껴지는 이유의 절반은 여기 있습니다. 매 파일마다 "수정할까요?"를 눌러야 하면 흐름이 끊기거든요. 반대로 전부 열어두면 편한데, 편한 만큼 사고도 자동으로 납니다.
어떤 단계들이 있나요?
도구마다 이름은 다르지만 대체로 이 네 층으로 정리됩니다.
| 모드 | 동작 | 쓰는 때 |
|---|---|---|
| 물어보기 | 파일 수정·명령 실행 전 매번 승인 | 처음 배울 때, 낯선 코드베이스 |
| 수정 자동 승인 | 파일은 알아서 고치고, 명령은 물어봄 | 익숙해진 뒤 대부분의 작업 |
| 계획 | 아무것도 안 고치고 계획만 세움 | 큰 작업 전에 방향 확인 |
| 전체 허용 | 아무것도 안 물어봄 | 격리된 환경에서만 |
안전 ◀──────────────────────────────────▶ 빠름
물어보기 → 수정만 자동 → (계획) → 전체 허용
▲ ▲
처음엔 여기 여기는 위험실무에서는 수정 자동 승인에 대부분 머물고, 큰 작업 앞에서만 계획으로 잠깐 올라갑니다. 클로드 코드는 Shift + Tab 을 누를 때마다 모드가 순서대로 바뀌고, 지금 어떤 모드인지는 입력창 아래에 표시됩니다.
- 파일 고치기login.tsx 수정물어봄
- 터미널 명령npm install물어봄
모든 동작 앞에서 멈춰 섭니다. 느리지만 AI가 뭘 하려는지 읽는 연습이 돼요. 처음에는 이걸로 시작하세요.
계획 모드가 왜 따로 있나요?
가장 저평가된 모드입니다. AI가 30분 동안 엉뚱한 방향으로 작업했다면, 그걸 되돌리는 데 또 30분이 듭니다.
계획 모드는 아무것도 안 고치고 "이렇게 하겠습니다"만 내놓게 합니다. 읽어보고 방향이 틀렸으면 그 자리에서 바로잡고, 맞으면 승인해서 실행시켜요. 파일 열 개를 건드리는 작업이라면 계획을 먼저 보는 쪽이 거의 항상 빠릅니다.
AI에게 시키기
권한을 여는 것보다 자주 쓰는 안전한 명령만 골라서 미리 허용하는 게 실속 있습니다.
승인 요청이 너무 자주 떠서 흐름이 끊겨. 설정을 정리하자.
- 내가 쓰는 도구에서 명령별 권한 규칙을 어디에 어떻게 쓰는지 공식 문서로 확인해
- 읽기 전용이라 안전한 것(상태 확인, 로그 보기, 테스트 실행)만 자동 승인으로 제안해줘
- 파일 삭제, 인터넷에 올려 팀에 반영하는 것, 실제 서비스에 배포하는 것, 컴퓨터 전체에 프로그램을 까는 것은 반드시 물어보게 남겨
- 각 항목이 왜 안전한지/위험한지 한 줄씩 붙여줘마지막 줄을 넣어야 내가 뭘 열어주는지 알고 승인하게 됩니다.
혼동 주의
- 파일 접근 범위와 다릅니다. 권한 모드는 "물어보느냐 마느냐"이고, 접근 범위는 "어느 폴더까지 볼 수 있느냐"예요. 둘 다 열어두면 프로젝트 밖 파일까지 조용히 바뀔 수 있습니다
- MCP 도구는 별개로 봐야 합니다. MCP로 붙인 서버 중에는 DB 행을 지우거나 외부 서비스에 글을 올리는 것도 있어요. 파일 수정 권한만 신경 쓰다 보면 이쪽이 빈틈이 됩니다
- 권한을 닫아도 AI가 읽는 건 막지 못합니다. 고치는 권한과 읽는 것은 다른 문제라, 비밀값이 담긴 파일은 애초에 환경변수로 빼두는 게 맞습니다
- 자동 승인은 검토 면제가 아닙니다. 물어보지 않았을 뿐 바뀐 건 바뀐 거예요. 확정하기 전에 뭐가 바뀌었는지 눈으로 훑는 습관은 어느 모드에서든 그대로 가야 합니다
관련 용어
- 체크포인트 · 되감기 (Checkpoint · Rewind)체크포인트는 AI 코딩 도구가 작업 도중 자동으로 저장해 두는 복구 지점이고, 되감기는 그 지점으로 코드와 대화를 되돌리는 기능으로, AI가 파일을 잘못 고쳤을 때 손으로 복구하지 않게 해줍니다.
- 에이전트 메모리 파일 (CLAUDE.md · AGENTS.md)에이전트 메모리 파일은 프로젝트 루트에 두는 마크다운 문서로, AI 코딩 도구가 매 대화를 시작할 때 자동으로 읽어 들여 기술 스택·규칙·금지사항을 매번 설명하지 않아도 되게 만듭니다.
- MCP (Model Context Protocol)MCP(Model Context Protocol)는 AI가 파일·데이터베이스·외부 서비스 같은 도구에 붙는 방식을 통일한 개방형 표준으로, 도구를 한 번 만들어 두면 이를 지원하는 어떤 AI 앱에서도 그대로 쓸 수 있게 합니다.
Ears