한 줄 요약: 도구 리뷰에서 설치가 됐다는 말은 시작일 뿐입니다. 실제 작업에 넣으려면 권한 범위, 결과 확인, 오류 표기, 사용 중단 기준을 먼저 정해야 합니다.
공식 출처: Anthropic Claude Code 문서
먼저 볼 핵심
- 어떤 권한이 필요한지와 실제 실행 범위를 분리합니다.
- 결과가 보인다고 데이터가 최신이라는 뜻은 아닙니다.
- 오류가 난 상태를 성공 수치로 덮어쓰지 않는지 봅니다.
왜 이 기준이 필요한가
이 글은 특정 도구를 추천하기보다, 공개 문서와 실제 사용 화면을 함께 검토할 때 쓸 수 있는 기준을 정리한 글입니다.
읽고 나서 확인할 것
이 글의 정보는 게시 시점의 공개 범위와 확인된 기준을 나눠 정리한 것입니다. 제품·서비스의 실제 이용 가능 여부는 공식 안내와 현재 화면을 함께 확인하세요.
Claude Code 공식 문서가 설명하는 권한 구조
위 기준을 실제 도구에 대입해 보면 Anthropic의 Claude Code 보안 문서(2026년 10월 18일 기준)가 좋은 예입니다. 이 문서는 권한 모드가 “묻지 않고 할 수 있는 동작”의 범위를 정한다고 설명합니다. 터미널과 VS Code의 대화형 세션은 자동(Auto) 모드로 시작하며, 별도의 분류 모델이 안전하지 않다고 판단한 동작을 막습니다. 사용자가 정한 허용·거부 규칙은 이 모드에서도 그대로 적용되고, 조직이 자동 모드를 끌 수도 있습니다.
수동(Manual) 모드는 읽기 전용 권한으로 시작합니다. 파일을 고치거나 테스트를 돌리거나 명령을 실행하려면 먼저 묻고, 사용자는 한 번만 승인할지 이후에도 허용할지 고릅니다. ls, cat, git status처럼 읽기 전용인 기본 명령은 묻지 않고 실행합니다. 이 문서가 짚는 경계는 다음과 같습니다.
| 확인할 경계 | 공식 문서의 설명 | 이 글의 기준과 연결 |
|---|---|---|
| 작업 폴더 | 수동 모드에서는 시작한 폴더 밖의 파일을 읽거나 쓰기 전에 묻습니다. 다만 승인한 Bash 명령은 사용자 계정이 쓸 수 있는 어느 곳에든 쓸 수 있습니다. | 권한 경계와 실제 실행 범위를 분리해서 본다 |
| 파일 편집 자동 승인 | Accept Edits 모드는 작업 폴더 안의 편집과 mkdir, touch, rm, mv, cp, sed를 자동 승인하고 나머지 명령은 계속 묻습니다. | 자동 승인이 걸리는 범위를 먼저 적어 둔다 |
| 네트워크 명령 | curl, wget은 기본적으로 자동 승인되지 않으며 permissions.deny 규칙으로 막을 수 있습니다. | 외부로 나가는 동작의 기본값을 확인한다 |
| 분석할 수 없는 명령 | 수동 모드는 완전히 분석하지 못한 Bash 명령과 규칙에 맞지 않는 명령을 승인 대상으로 둡니다. | 애매한 동작은 멈추고 확인한다 |
| 사용자 책임 | 제안된 코드와 명령을 승인하기 전에 사용자가 검토해야 합니다. | 결과를 확인할 사람을 정해 둔다 |
같은 문서는 신뢰할 수 없는 내용을 다룰 때의 권장 사항으로 제안된 명령 검토, 신뢰하지 않는 내용을 그대로 Claude에 넘기지 않기, 중요한 파일의 변경 확인, 외부 서비스와 상호작용할 때 가상 머신 활용을 듭니다. 권한 설정은 /permissions로 정기적으로 점검하라고 안내하며, 이런 보호 장치가 위험을 크게 줄이지만 어떤 시스템도 모든 공격에서 자유롭지 않다고 분명히 밝힙니다. 모드 이름과 기본값은 버전과 실행 환경에 따라 달라질 수 있으므로, 사용하는 환경의 현재 문서를 함께 보세요.
정리하면 이 문서가 권하는 사용 방식은 읽기 전용으로 시작해 필요한 동작만 단계적으로 허용하고, 승인 전에 내용을 직접 검토하며, 허용 범위를 주기적으로 되짚는 것입니다. 앞의 체크리스트에서 권한, 되돌리기, 중단 기준을 따로 적어 두라고 한 이유도 같습니다. 승인 한 번이 어디까지 영향을 주는지 알지 못하면 편의를 누릴수록 위험도 같이 커지기 때문입니다.
업데이트
이 글의 원문 발행 뒤에도 제품 기능·정책·측정 조건은 달라질 수 있습니다. 2026년 9월 14일 기준 공식 공개 자료를 바탕으로 하며, 이 글은 확인 가능한 발표 내용과 그 한계를 설명하는 데 범위를 둡니다. 새 공지에서 제공 범위·제한·수치가 달라졌다면 그 최신 공지가 우선합니다.
확인 자료
확인 날짜: 2026-09-14