권한 모드란? Claude Code가 파일을 수정하기 전 승인받는 이유
AI에게 “내 웹사이트의 버튼이 작동하지 않으니 고쳐 줘”라고 부탁했습니다. 잠시 후 화면에 “이 명령을 실행해도 될까요?”, “파일을 수정하도록 허용할까요?” 같은 질문이 나타납니다. 코딩을 모르면 이런 질문이 귀찮아 보일 수 있습니다. 하지만 승인창은 AI가 실제 컴퓨터에서 무엇을 할 수 있는지 구분해 주는 중요한 안전장치입니다. 오늘 배울 권한 모드(Permission Mode)는 AI 코딩 도구가 파일을 읽거나 수정하고, 터미널 명령을 실행하는 등 도구를 사용할 때 언제 허락을 받아야 하는지 결정하는 작동 방식입니다. 쉽게 말해 AI에게 얼마만큼의 자율성을 줄 것인지 정하는 설정입니다. 예를 들어 AI에게 문서 내용을 읽고 분석하도록 할 수는 있지만, 파일을 삭제하거나 프로그램을 설치하는 일은 별도의 승인을 받도록 운영할 수 있습니다. 이번 글은 Claude Code를 예로 들어 권한 모드의 뜻 → 승인 메시지 읽는 법 → 각 모드의 차이 → 안전하게 시작하는 방법 → 실제 실수 방지 순서로 설명합니다. 2026년 10월 16일 Anthropic 공식 문서를 기준으로 정리했습니다. 메뉴 이름과 지원 모드는 실행 환경·버전·계정·관리자 정책에 따라 달라질 수 있습니다.
이 글의 순서
- 1. 권한 모드는 왜 필요한가요?
- 2. 초보자가 이해할 수 있는 권한 세 가지
- 3. '허용', '매번 묻기', '거부'의 차이
- 4. Claude Code에는 어떤 권한 모드가 있나요?
- 5. 처음에는 Ask permissions 방식이 좋은 이유
- 6. Auto accept edits는 언제 쓸까요?
- 7. Plan mode는 파일을 수정하는 모드인가요?
- 8. '자동으로 묻지 않기'와 '무조건 허용'은 다릅니다
- 9. 모드를 바꾸는 방법은?
- 10. 프로젝트 설정 파일에는 무엇을 적나요?
- 11. AI에게 권한을 요청받을 때 읽는 방법
- 12. 권한이 없는데 작업을 성공했다고 말하면요?
- 13. 권한 모드와 샌드박스는 같은 뜻인가요?
- 14. 실제 작업에서는 이렇게 운영하세요
- 15. AI에게 권한 검토를 요청하는 복사 프롬프트
- 자주 묻는 질문
- 마무리
1. 권한 모드는 왜 필요한가요?
일반적인 AI 채팅에서는 답변을 읽고 끝나는 경우가 많습니다. 그러나 Claude Code 같은 AI 코딩 도구는 사용자가 허용하면 작업 폴더의 파일을 읽고, 내용을 수정하거나 명령어를 실행할 수 있습니다. 예를 들어 다음 요청을 생각해 보겠습니다. “할 일 목록 웹앱의 디자인을 바꿔 줘.” AI는 요청을 해결하기 위해 여러 행동을 시도할 수 있습니다.
- HTML 파일을 읽기
- CSS 파일을 수정하기
- 테스트 명령을 실행하기
- 필요한 경우 새 파일을 생성하기 이 중 파일 읽기는 비교적 작은 영향을 줄 수 있지만, 파일 삭제·설정 변경·외부 전송은 결과가 더 클 수 있습니다. 따라서 AI가 “이 명령이 필요해 보인다”고 판단하는 것과, 실제 컴퓨터가 그 행동을 허용하는 것은 분리해야 합니다. 권한 모드는 이 두 단계를 연결하는 승인 규칙입니다.
2. 초보자가 이해할 수 있는 권한 세 가지
처음에는 복잡한 이름보다 읽기·수정·실행 세 가지만 구별해 보세요. 읽기(Read)는 기존 파일의 내용을 살펴보는 행동입니다. 작업 폴더 안에서 일반 파일을 읽는 것은 도구 기본 정책상 승인 없이 허용되는 경우가 있습니다. 수정(Edit/Write)은 파일 내용을 바꾸거나 새로 만드는 행동입니다. 코드와 설정이 달라질 수 있으므로 승인 여부를 확인해야 합니다. 명령 실행(Bash 또는 터미널 명령)은 컴퓨터에 명령을 내리는 행동입니다. 단순히 목록을 확인하는 읽기 전용 명령도 있지만, 설치·삭제·업로드처럼 실제 상태를 바꾸는 명령도 있습니다. 예를 들어 아래처럼 비교할 수 있습니다.
| AI가 하려는 행동 | 의미 | 확인할 사항 |
|---|---|---|
| 파일 목록 보기 | 어떤 파일이 있는지 확인 | 읽을 위치와 민감 파일 여부 |
| 디자인 파일 수정 | 글자 색·여백·배치 변경 | 변경 대상과 원본 백업 |
| 테스트 명령 실행 | 앱이 제대로 동작하는지 검사 | 테스트의 부작용·설치 여부 |
| 파일 삭제 | 기존 자료 제거 | 반드시 필요한 삭제인지 |
| 원격 서버에 업로드 | 외부 시스템 상태 변경 | 전송 대상·인증·자료 권리 |
중요: '읽기'라도 비밀키·고객 정보처럼 민감한 데이터를 읽어 AI 서비스로 보내는 상황이라면 별도 주의가 필요합니다. 읽기 전용이라는 말이 개인정보 처리까지 자동으로 안전하다는 뜻은 아닙니다.
3. '허용', '매번 묻기', '거부'의 차이
Claude Code 공식 문서는 개별 도구에 대해 크게 세 가지 규칙을 설명합니다. Allow(허용): 지정한 도구나 명령을 조건에 맞으면 따로 묻지 않고 사용할 수 있습니다. Ask(확인): 해당 작업을 하려고 할 때 사용자의 승인을 요청합니다. Deny(거부): 지정된 도구 사용을 막습니다. 예를 들어 “파일은 읽되 배포 명령은 매번 확인해야 한다”고 정할 수 있습니다. 여기서 특히 중요한 규칙은 거부(Deny) → 확인(Ask) → 허용(Allow)의 우선순위입니다. Claude Code 공식 문서는 동일한 도구 사용이 여러 규칙과 일치할 때 이러한 우선순위로 평가한다고 설명합니다. 즉 넓은 허용 규칙이 있다고 해서 명시적으로 거부한 도구까지 자동으로 승인되는 것은 아닙니다. 반대로 프롬프트에 “절대 파일을 삭제하지 마”라고 적는 것만으로 실제 도구의 접근권을 강제로 제한하는 것은 아닙니다. 확실하게 막고 싶은 행동은 도구의 권한 설정·운영체제 권한·격리 기능에서 제한해야 합니다.
4. Claude Code에는 어떤 권한 모드가 있나요?
Anthropic 공식 문서가 설명하는 주요 모드를 초보자가 이해할 수 있는 수준으로 정리해 보겠습니다.
| 권한 모드 | 핵심 동작 | 처음 사용할 때의 판단 |
|---|---|---|
default / Manual / Ask permissions |
일반적인 승인 흐름으로 필요한 도구 사용을 확인 | 초보자에게 적합 |
acceptEdits / Auto accept edits |
작업 범위 안의 파일 편집과 일부 파일 작업을 자동 수락 | 변경 내용을 꾸준히 확인할 때 |
plan / Plan mode |
코드와 구조를 주로 조사하고 변경 계획을 제안 | 수정 전에 검토하고 싶을 때 |
dontAsk |
사전 허용되지 않은 요청은 확인 대신 거부 | 사람이 지켜보지 않는 제한적 작업 |
auto |
자동 안전 검토를 사용해 일부 도구 실행을 승인·거부 | 이용 가능 여부와 정책 확인 필요 |
bypassPermissions |
일반적인 권한 확인을 대부분 건너뜀 | 초보자 사용 비권장 |
표의 이름은 공식 설정의 예시입니다. 실제 CLI·데스크톱 앱에서 보이는 라벨과 사용 가능 범위는 버전·구독·조직의 관리 설정에 따라 다릅니다. 또한 모드가 같아도 특정 파일·명령에 대한 Deny 또는 Ask 규칙이 추가로 적용될 수 있습니다. 가장 높은 자유도처럼 보이는 모드가 모든 상황에서 좋은 것은 아닙니다. AI가 실수했을 때 되돌리기 어려운 변경이 가능한지가 더 중요합니다.
5. 처음에는 Ask permissions 방식이 좋은 이유
코딩에 익숙하지 않다면 AI가 요청하는 동작을 하나씩 읽어 볼 수 있는 설정이 유용합니다.
예를 들어 이런 요청이 나왔다고 가정해 보겠습니다.
“홈페이지의 색상을 파란색으로 바꾸려면 style.css 파일을 수정해야 합니다. 허용하시겠습니까?”
이때 확인할 것은 네 가지입니다.
첫째, 요청한 일과 실제 행동이 연결되나요? 색상을 바꾸려는데 관계없는 개인정보 폴더를 수정하겠다고 하면 멈춰야 합니다.
둘째, 변경 범위가 작나요? 한두 파일의 CSS 수정과 저장소 전체 삭제는 영향이 완전히 다릅니다.
셋째, 변경 전 내용으로 돌아갈 수 있나요? 작업 전 복사본·Git 변경 기록·백업을 확인합니다.
넷째, 허용 후 무엇을 검수하나요? 실제로 변경된 파일의 차이(diff), 프로그램 실행 결과와 모바일 화면을 봅니다.
'허용'을 눌렀다는 사실은 'AI가 정답을 만들었다'는 뜻이 아닙니다. 안전한 파일 경로라 해도 버그가 생길 수 있으므로 결과를 확인해야 합니다.
6. Auto accept edits는 언제 쓸까요?
acceptEdits 모드는 이름처럼 파일 편집을 자동으로 받아들이는 방식입니다.
Anthropic 공식 문서에 따르면 작업 폴더 등 허용된 범위 안의 파일 수정과 mkdir, mv, cp 같은 일반적인 파일 시스템 작업을 자동으로 허용할 수 있습니다.
예를 들어 직접 만든 작은 연습 프로젝트라면 색상·문구·배치 수정을 반복할 때 편리할 수 있습니다.
그러나 다음 두 가지를 기억하세요.
자동 편집 허용 = 모든 명령 자동 허용이 아닙니다. 다른 터미널 명령은 여전히 확인이 필요할 수 있습니다.
자동 편집 허용 = 원본 안전 보장이 아닙니다. AI가 허용된 파일을 잘못 덮어쓸 수 있으므로 변경 내역과 복구 방법이 필요합니다.
따라서 회사 핵심 저장소·민감 고객 자료·실제 서버 환경에서는 익숙하지 않은 상태로 권한을 크게 열지 않는 편이 좋습니다.
7. Plan mode는 파일을 수정하는 모드인가요?
plan은 일반적으로 AI가 현재 프로젝트를 조사하고 어떤 순서로 고칠지 계획을 제시하도록 제한하는 모드입니다.
예를 들어 “우리 웹사이트의 모바일 메뉴가 왜 느린지 먼저 분석해 줘. 파일은 아직 고치지 마” 같은 요청에 어울립니다.
이 모드의 목적은 변경 작업 이전에 구조·위험·예상 수정 파일을 검토할 기회를 얻는 것입니다.
다만 Plan mode를 쓴다고 해서 자동으로 테스트를 통과하거나, 이후 작업이 영원히 잠금 상태가 되는 것은 아닙니다.
최신 Claude Code 버전은 Plan mode와 추가 자동 승인 기능의 조합에 따른 차이가 있을 수 있습니다. 따라서 현재 화면의 실제 권한 상태를 확인해야 합니다.
여기서는 권한 모드들과의 차이만 설명합니다. Plan mode의 별도 기능·설정 심화는 AI-GLOSS-081 전용 글에서 다룰 수 있도록 남겨 둡니다.
8. '자동으로 묻지 않기'와 '무조건 허용'은 다릅니다
처음 보면 dontAsk와 bypassPermissions가 비슷하게 느껴질 수 있습니다.
하지만 동작은 반대에 가깝습니다.
dontAsk: 사전에 허용되지 않은 도구 사용은 확인 질문 없이 거부합니다.
bypassPermissions: 일반적인 승인 질문을 대부분 생략하고 작업을 진행합니다.
예를 들어 작업을 밤새 실행하는 자동화가 있다고 해 봅시다.
dontAsk는 권한이 없는 작업을 거부하고 기록하도록 설정하는 데 도움이 될 수 있습니다.
반대로 bypassPermissions는 승인 질문이 없으므로 사람이 개입할 기회를 잃을 수 있습니다.
Anthropic은 Bypass를 격리된 컨테이너나 가상머신과 같은 통제된 환경에서만 사용하도록 경고합니다.
또한 공식 문서에서 설명하는 auto 모드는 별도 자동 안전 검토 기능을 사용합니다. 모든 계정에서 기본으로 제공되는 기능으로 가정하거나, 자동 검토가 완벽하다고 설명하면 안 됩니다.
9. 모드를 바꾸는 방법은?
Claude Code에는 권한을 확인하고 조정하는 /permissions 기능이 있습니다.
공식 문서에 따르면 이 화면에서는 Allow·Ask·Deny 규칙을 검토하고 어떤 설정 파일에서 왔는지도 확인할 수 있습니다.
대략적인 사용 흐름은 다음과 같습니다.
① 현재 프로젝트의 Claude Code 세션을 엽니다.
② /permissions를 입력하고 현재 허용·확인·거부 규칙을 살펴봅니다.
③ 변경하려는 작업의 실제 행동이 파일 읽기·수정·명령 실행 중 어디에 속하는지 정합니다.
④ 필요한 도구에만 최소한의 권한을 주고, 다른 작업은 승인 요청이나 거부로 남겨 둡니다.
⑤ 사용 중인 CLI/데스크톱 앱의 모드 선택 화면 또는 공식 설정 문서에 따라 기본 모드를 조정합니다.
⑥ 변경 후 테스트용 작은 프로젝트에서 어떤 메시지가 뜨는지 확인합니다.
주의: Claude Desktop, Claude Code CLI, IDE 확장, 원격 세션, 조직 관리 환경은 메뉴 라벨이 다를 수 있습니다. 이 글은 실제 계정에서 메뉴를 클릭해 검증한 화면 설명이 아니므로 현재 Claude Code 공식 사용법을 함께 확인하세요.
10. 프로젝트 설정 파일에는 무엇을 적나요?
Claude Code는 설정 파일에서 권한 모드와 규칙을 지정할 수 있습니다. 예를 들어 정식 승인 모드를 유지하고, Git 푸시를 기본적으로 막아 놓는 교육용 설정은 다음과 같은 모양일 수 있습니다.
{
"permissions": {
"defaultMode": "default",
"deny": [
"Bash(git push *)"
],
"ask": [
"Bash(npm install *)"
]
}
}
이 설정 예시는 정확히 어떤 일을 허용할지 고민하도록 돕는 형태입니다. 실제 프로젝트에 바로 적용했다는 뜻은 아닙니다.
문장의 의미는 이렇습니다.
defaultMode: 일반적인 승인 동작을 사용합니다.
deny: 패턴에 일치하는 git push 명령을 차단합니다.
ask: npm install을 포함하는 패턴에 일치하면 별도 승인을 요청합니다.
하지만 이 설정이 모든 가능한 원격 배포·삭제·네트워크 전송을 막는 보안 방화벽은 아닙니다. 외부 명령이나 다른 실행 방식·도구를 통한 영향은 별도로 검토해야 합니다.
또한 조직 관리자 설정·사용자 설정·프로젝트 설정이 겹칠 수 있습니다. 코드를 복사하기 전에 공식 설정 우선순위와 현재 버전의 문법을 확인하세요.
11. AI에게 권한을 요청받을 때 읽는 방법
많은 초보자는 “영어 명령을 모르니 그냥 Allow를 누른다”고 말합니다. 그러나 전부 이해하지 못해도 확인할 수 있는 항목이 있습니다. 도구 이름: 어떤 도구를 사용하려 하나요? Read, Edit, Bash처럼 표시될 수 있습니다. 대상 경로: 내가 승인한 작업 폴더인가요? 다른 위치에 접근하려 하나요? 명령의 목적: 웹사이트 색상을 고치기 위해 왜 새 패키지를 설치하는지 설명됐나요? 결과의 영향: 파일이 바뀌거나 삭제되나요? 외부 네트워크로 무엇을 보내나요? 지속 시간: 이번 한 번만 허용하는지, 앞으로 같은 패턴을 반복 허용할지 확인합니다. 이해하지 못한 명령이라면 거부하고 “무엇을 바꾸며 왜 필요한지 한국어로 먼저 설명해 줘”라고 질문할 수 있습니다. 특히 “앞으로 묻지 않기”는 실수로 더 넓은 허용 규칙을 남길 수 있습니다. 처음에는 이번 한 번만 승인하는 방식을 우선 검토하세요.
12. 권한이 없는데 작업을 성공했다고 말하면요?
권한 모드는 작업의 시도와 실제 결과를 구분하는 데도 중요합니다. 예를 들어 AI가 테스트를 실행하고 싶었지만 권한 거부로 실행하지 못했다면, 올바른 결과 보고는 다음과 같아야 합니다. 정확한 보고: “테스트 실행 권한이 없어 결과를 검증하지 못했습니다.” 부정확한 보고: “테스트를 실행했고 모두 통과했습니다.” 같은 원칙은 파일 수정에도 적용됩니다. AI가 코드를 제안한 상태인지, 사용자의 컴퓨터 파일을 실제로 변경했는지, 수정 뒤 동작 검증까지 마쳤는지를 따로 확인해야 합니다. 실제 프로젝트를 진행할 때는 다음처럼 정리할 수 있습니다.
| 항목 | 구분해서 확인할 내용 |
|---|---|
| 조사 | 어떤 파일과 정보에 접근했나 |
| 계획 | 무엇을 변경하려 했나 |
| 승인 | 사용자가 어떤 행동을 허용했나 |
| 실행 | 어떤 도구 호출이 실제 성공했나 |
| 검증 | 테스트·미리보기로 무엇을 확인했나 |
| 남은 문제 | 차단되거나 실패한 작업은 무엇인가 |
이런 기록이 있으면 여러 AI 작업을 병행할 때도 허용한 범위를 확인하기 쉽습니다.
13. 권한 모드와 샌드박스는 같은 뜻인가요?
아닙니다. 권한 모드는 Claude Code가 어떤 도구 사용을 승인·거부할지 판단하는 체계입니다. 반면 샌드박스는 일반적으로 프로그램이 접근할 수 있는 파일·네트워크·프로세스 범위 자체를 기술적으로 제한하는 격리 환경을 뜻합니다. 쉽게 말해 다음과 같이 다릅니다. 권한 모드: “이 작업을 허용할까요?”라는 문지기. 샌드박스: “설령 실행되더라도 어디까지 접근할 수 있나요?”라는 울타리. 둘 중 하나만 있으면 다른 하나의 보호 기능까지 자동으로 생긴다는 뜻은 아닙니다. 특히 AI 도구가 웹페이지·이메일·외부 저장소의 내용을 읽을 때 그 안의 악성 지시문이 사용자 명령인 것처럼 섞여 들어오는 프롬프트 인젝션 위험도 고려해야 합니다. 신뢰하지 않는 프로젝트나 파일을 열었을 때는 권한을 최소화하고, 외부 전송·설치·중요 파일 삭제를 별도로 확인하는 것이 중요합니다.
14. 실제 작업에서는 이렇게 운영하세요
간단한 웹앱을 고친다는 상황을 가정해 봅시다.
1단계. 별도 연습 폴더를 만듭니다.
중요한 개인 파일·회사 프로젝트와 무관한 작은 폴더를 선택합니다. 임의 삭제되면 곤란한 자료는 포함하지 않습니다.
2단계. 기본 승인 모드에서 시작합니다.
무엇을 읽고 어떤 파일을 바꿀지 확인하는 데 익숙해집니다.
3단계. AI에게 계획을 먼저 요청합니다.
“어떤 파일을 읽고 어떤 기능을 바꿀지 먼저 설명하라”고 요청합니다. 필요하면 Plan mode를 검토합니다.
4단계. 실제 수정 요청을 꼼꼼히 읽습니다.
변경할 파일 목록이 처음 요청과 맞는지 확인하고, 낯선 설치·네트워크 전송이 나오면 이유를 묻습니다.
5단계. 한두 파일만 변경하게 합니다.
원하는 기능을 작게 나누어 승인하면 실패했을 때 원인을 좁힐 수 있습니다.
6단계. 변경사항과 동작을 확인합니다.
수정 전후 차이를 확인하고, 실제 브라우저에서 버튼과 메뉴가 정상적으로 작동하는지 검사합니다.
7단계. 문제를 기록하고 복구합니다.
테스트 실패·권한 거부·실제 수정 내역을 기록하고 필요하면 변경 전으로 되돌립니다.
8단계. 익숙해진 뒤에만 자동화 수준을 조절합니다.
반복해서 수정하는 작은 연습용 프로젝트라면 acceptEdits를 검토할 수 있습니다. 중요한 운영 시스템에서는 더 엄격한 정책을 유지하는 편이 좋습니다.
이 과정은 예시이며, 실제 컴퓨터나 저장소에서 어떤 모드로 실행해 성공했는지 실험한 결과는 아닙니다.
15. AI에게 권한 검토를 요청하는 복사 프롬프트
승인창의 영어 명령을 이해하기 어렵다면 다음 문장을 이용해 보세요.
나는 Claude Code를 처음 사용하는 비전공자야.
작업 목적:
- 할 일 웹앱의 모바일 메뉴 오류만 수정하고 싶어.
권한 관련 규칙:
1. 파일을 수정하거나 명령을 실행하기 전에
정확한 파일 이름·명령·기대 결과를 설명해 줘.
2. 삭제·설치·외부 전송·Git push 같은 큰 변경은
별도로 위험과 대안을 알려 줘.
3. 내가 허용하지 않은 작업을 성공했다고 말하지 마.
4. 파일 수정·테스트 실행·테스트 통과를
각각 별도로 보고해 줘.
5. 불필요한 비밀번호·API 키·개인 파일은 읽지 마.
6. 우선 수정 계획만 보여 주고 실행은 내 확인 뒤 진행해.
마지막에 다음 표로 정리해 줘.
[요청 목적][예정 작업][승인 필요 여부]
[실제로 실행했는지][실제 결과][남은 위험]
실제 실행을 하지 않았다면 ‘미실행’이라고 적어 줘.
이 프롬프트는 AI가 무슨 일을 하려는지 설명하도록 요청하는 안내문입니다. 실제 도구의 권한 규칙을 자동으로 잠그는 보안 설정이 아니므로, /permissions와 계정·운영체제의 접근권을 함께 관리해야 합니다.
자주 묻는 질문
Q1. Permission Mode란 무엇인가요?
AI 코딩 도구가 실제 파일·명령 등 도구를 사용하려 할 때 자동 허용할지, 사용자에게 확인할지, 거부할지 정하는 모드입니다.
Q2. Claude Code가 “Allow?”라고 묻는 이유가 무엇인가요?
수정이나 명령 실행 같은 작업이 실제 컴퓨터 상태를 바꿀 수 있으므로, 설정에 따라 사용자 승인이 필요한 도구 호출을 구분하기 위해서입니다.
Q3. 기본 모드에서는 모든 파일을 읽을 때마다 묻나요?
그렇지는 않습니다. Anthropic 공식 문서는 작업 디렉터리 내 일반적인 읽기 전용 파일 조회는 승인 없이 가능한 경우가 있다고 설명합니다. 민감 파일이나 별도 정책이 있다면 예외가 적용될 수 있습니다.
Q4. Auto accept edits는 파일을 마음대로 삭제해도 된다는 뜻인가요?
정확히는 허용된 작업 범위의 파일 편집과 일부 파일 시스템 작업을 자동 승인할 수 있는 모드입니다. 수정 실수나 데이터 손실이 사라지는 것은 아닙니다.
Q5. Plan mode는 자동으로 코드를 고쳐 주나요?
일반적으로 변경 전에 조사하고 계획을 제시하기 위한 모드입니다. 실제 모드·버전의 추가 기능에 따라 제한이 다를 수 있으므로 현재 권한 상태를 확인하세요.
Q6. dontAsk와 bypassPermissions는 같은 뜻인가요?
아닙니다. dontAsk는 허용하지 않은 작업을 질문 없이 거부하는 쪽이고, bypassPermissions는 일반적인 승인 질문을 대부분 건너뛰는 방식입니다.
Q7. bypassPermissions를 켜면 모든 작업이 완전히 안전하게 실행되나요?
아닙니다. 높은 위험이 있으므로 Anthropic은 격리된 컨테이너·가상머신처럼 통제된 환경에서만 사용하도록 안내합니다.
Q8. /permissions에서 무엇을 바꿀 수 있나요?
도구별 Allow·Ask·Deny 권한 규칙을 확인·관리할 수 있습니다. 실제 UI는 사용 중인 앱과 버전에 따라 다를 수 있습니다.
Q9. 명령이 무엇인지 모르겠는데 허용해도 될까요?
이해하지 못한 삭제·설치·외부 전송·Git 변경 명령이라면 먼저 거부하고 목적과 영향 범위를 설명받는 것을 권장합니다.
Q10. Claude Code와 일반 Claude 웹채팅에서 같은 권한 모드를 쓰나요?
같은 방식이라고 볼 수 없습니다. 이 글은 Claude Code의 도구 실행 권한 체계를 설명합니다. 웹채팅·데스크톱·원격 세션에는 서로 다른 도구와 설정이 적용될 수 있습니다.
Q11. 프롬프트에 “절대 삭제하지 마”라고 쓰면 실제 파일 삭제가 불가능해지나요?
아닙니다. 지시는 AI의 행동을 안내하지만 도구 권한 또는 운영체제 격리를 강제로 바꾸는 기능은 아닙니다. 중요한 제한은 실제 권한 정책으로 설정해야 합니다.
Q12. 권한 모드가 잘 설정됐는지 어떻게 확인하나요?
중요한 자료가 없는 작은 테스트 폴더에서 읽기·수정·명령 실행 시 실제 승인 질문과 결과를 확인하세요. 확인하지 않은 작업을 성공이라고 기록하지 마세요.
마무리
권한 모드는 AI에게 얼마나 많은 일을 맡길 것인지 정하는 자율성의 경계입니다. 처음 Claude Code를 쓴다면 속도보다 내가 무엇을 허용했는지 이해하는 것이 먼저입니다. 읽을 파일과 수정할 파일, 실행할 명령을 구분하고, 중요한 변경은 확인을 받은 뒤 진행하세요. 자동 편집이 편리한 경우도 있지만, 승인창을 생략하면 작업 실수를 발견할 기회가 줄어들 수 있습니다. 특히 실제 업무 자료·개인정보·서버 배포가 관련된 프로젝트에서는 명시적인 권한 제한과 별도 테스트를 고려하세요. 가장 좋은 권한 모드는 '언제나 가장 자동화된 모드'가 아니라, 내 작업의 위험과 검수 능력에 맞게 필요한 권한만 허용하는 모드입니다.
함께 읽으면 좋은 글
- 코덱스(Codex)란? 코딩 몰라도 AI에게 홈페이지 제작을 맡길 수 있을까? — 관련 개념과 실전 점검 방법을 함께 확인합니다.