Claude Code를 업데이트했더니 갑자기 명령 하나하나마다 승인을 물어보고, 설정 어딘가에 "Manual"이라는 낯선 모드 이름이 떠 있다면 — 지금 검색해서 들어오신 이유가 바로 그거일 겁니다. 2026년 7월 3일 릴리스된 v2.1.200 이후 커뮤니티에서 가장 많이 나오는 질문이에요. 근데 검색해 보면 "기본값이 Auto에서 Manual로 바뀌었다"는 글과 "아무것도 안 바뀌었다"는 글이 섞여 있어서 더 헷갈립니다.
이 글에서 그 사실 관계를 공식 릴리스 노트 기준으로 정확히 가르고, Auto 모드로 되돌리는 설정까지 순서대로 정리합니다.
v2.1.200에서 실제로 바뀐 것은 딱 두 가지
GitHub 릴리스 노트 원문 기준으로 권한 관련 변경은 두 줄입니다.
- 모드 이름 변경: 기존에
default라고 표기되던 권한 모드가 CLI,--help, VS Code, JetBrains 전반에서 "Manual"로 표기됩니다.--permission-mode manual과"defaultMode": "manual"이 기존default와 나란히 허용되는 별칭(alias)으로 추가됐어요. - AskUserQuestion 자동 진행 제거: Claude가 사용자에게 선택지를 묻는 대화상자가 이제 기본적으로 사람이 답할 때까지 무한 대기합니다. 이전에는 약 60초 뒤 알아서 진행됐습니다.
후속 버전 v2.1.203에서는 Manual 모드가 켜져 있을 때 푸터에 회색 일시정지 배지가 추가돼서, 현재 모드가 항상 눈에 보이게 됐고요.
"Auto가 기본이었는데 Manual로 바뀌었다"는 말, 사실일까
여기가 이 글의 핵심입니다. TechTimes 같은 일부 매체는 "기본 권한 모드가 Auto에서 Manual로 변경됐다"고 썼습니다. 하지만 공식 릴리스 노트의 문구는 "Changed the 'default' permission mode to 'Manual'" — 즉 default라는 모드의 명칭을 Manual로 바꿨다는 뜻입니다.
공식 문서 기준으로 정리하면 이렇습니다.
- 매 행동마다 승인을 요청하는 모드(
default)는 원래부터 기본값이었습니다. Anthropic 엔지니어링 블로그도 2026년 3월에 이미 "기본적으로 Claude Code는 명령 실행·파일 수정 전에 승인을 요청한다"고 기술하고 있어요. - Auto가 기본이었던 적은 공식 소스 어디에도 없습니다. 기능은 그대로고, "default"라는 애매한 이름이 "Manual"이라는 정직한 이름으로 바뀐 겁니다.
Medium의 Automation Labs 글은 이 변경을 "commands needed approval, but the name said nothing"(승인은 원래 필요했지만, 이름이 아무것도 말해주지 않았다)라고 요약했습니다. 정확한 표현이라고 봅니다.
그럼 왜 다들 "갑자기 승인이 늘었다"고 느낄까요? 그 체감에는 실체가 있습니다. 다음 섹션에서 봅니다.
갑자기 매번 물어보는 것처럼 느껴지는 진짜 원인 두 가지
원인 1 — AskUserQuestion이 더 이상 알아서 진행하지 않는다. v2.1.198 무렵부터 질문 대화상자에 60초쯤 답하지 않으면 "사용자가 자리를 비운 것 같으니 알아서 진행하라"는 합성 응답이 주입되는 동작이 있었습니다. GitHub 이슈 #73408과 #73772에서 "침묵을 승인으로 취급한다", "동의 없는 행동"이라는 비판이 쏟아졌고, v2.1.200이 이 자동 진행을 기본 해제했어요. 그 결과 자동 진행에 (알게 모르게) 의존하던 무인 파이프라인이나 백그라운드 실행은 이제 질문 지점에서 사람이 답할 때까지 멈춥니다. "전엔 알아서 넘어가던 게 이젠 매번 기다린다"는 체감이 여기서 나옵니다.
원인 2 — 프로젝트 설정의 defaultMode: "auto"는 무시된다. v2.1.142 이후, 프로젝트의 .claude/settings.json이나 .claude/settings.local.json에 넣어둔 "auto"는 조용히 무시됩니다. 저장소가 스스로에게 auto 권한을 부여하지 못하게 막는 보안 조치예요. 에러 메시지도 없이 그냥 Manual로 시작하기 때문에, 설정을 분명히 했는데 안 먹는다면 십중팔구 설정 파일 위치 문제입니다.
여기에 모드 표기가 "default"에서 "Manual"로 바뀐 게 겹치면서, 업데이트 직후 "설정이 Manual로 바뀌었고 매번 승인을 요구한다"는 인식이 만들어진 거죠.
Auto 모드로 되돌리는 방법
세 가지 층위가 있습니다. 상황에 맞는 걸 골라 쓰면 됩니다.
세션 중 전환: 터미널에서 Shift+Tab을 누르면 모드가 사이클로 돌아갑니다. 계정이 auto 요건을 충족하면 사이클 마지막에 auto가 나타나요. Claude Code Plan Mode 활용법에서 다뤘던 plan 모드도 같은 사이클 안에 있습니다. VS Code에서는 프롬프트 박스 하단의 모드 인디케이터를 클릭하면 됩니다.
시작 시 플래그:
claude --permission-mode auto영구 기본값 — 반드시 사용자 설정에: ~/.claude/settings.json에 아래를 추가합니다.
{
"permissions": {
"defaultMode": "auto"
}
}다시 강조하지만 프로젝트 폴더의 .claude/settings.json에 넣으면 무시됩니다. 반드시 홈 디렉터리의 사용자 설정이어야 해요. VS Code의 claudeCode.initialPermissionMode 설정도 auto 값을 받지 않으니 같은 방식으로 사용자 설정에 지정합니다.
Auto 모드 표시 요건도 확인하세요. 공식 문서 기준으로 Claude Code v2.1.83 이상, 모델은 Anthropic API에서 Opus 4.6 또는 Sonnet 4.6 이상이어야 하고, Team/Enterprise 플랜은 Owner가 관리자 설정에서 먼저 활성화해야 합니다. Bedrock 같은 외부 프로바이더에서는 CLAUDE_CODE_ENABLE_AUTO_MODE=1 환경변수가 별도로 필요합니다.
그리고 무인 실행 때문에 AskUserQuestion 자동 진행이 필요하다면, /config에서 유휴 타임아웃(idle timeout)을 옵트인할 수 있습니다. 서브에이전트를 여러 개 굴리는 파이프라인처럼 사람이 자리를 지키기 어려운 구성에서 유용한데, 이 60초 자동 진행이 바로 이슈 #73408에서 비판받았던 그 동작이라는 점은 기억해 두세요.
Auto로 돌리기 전에 알아둘 트레이드오프
Anthropic이 왜 이름까지 바꿔가며 승인 절차를 강조했는지 수치를 보면 이해가 됩니다. Anthropic 엔지니어링 블로그에 따르면 사용자는 권한 프롬프트의 93%를 승인합니다. 승인이 의사결정이 아니라 반사행동이 된다는 거예요. 그래서 만든 게 auto 모드의 분류기(classifier)인데, 이 분류기도 완벽하지 않습니다. 실제 과잉 행동 52건 중 17%를 놓쳤다는 게 Anthropic 자체 측정치입니다. 잘못 해석된 지시로 원격 git 브랜치를 삭제하거나 프로덕션 DB에 마이그레이션을 시도한 사례도 문서화돼 있고요.
auto 모드에서 알아둘 세부 사항도 있습니다.
Bash(*)같은 광범위 allow 규칙은 auto 진입 시 자동 해제되고,Bash(npm test)같은 좁은 규칙만 유지됩니다.- 대화 중 "푸시하지 마" 같은 선언은 컨텍스트 압축으로 유실될 수 있으니, 확실한 차단은 deny 규칙으로 걸어야 합니다. 이런 규칙을 어디에 어떻게 쓰는지는 CLAUDE.md 가이드에서 정리한 설정 계층 구조를 참고하세요.
- 차단이 3회 연속이거나 세션 누적 20회면 auto가 일시 중지되고 프롬프트 모드로 돌아갑니다.
bypassPermissions로 아예 우회하는 방법도 있긴 한데, 공식 문서가 "프롬프트 인젝션이나 의도치 않은 행동에 대한 보호가 전혀 없다"며 인터넷이 차단된 컨테이너/VM 전용으로 못 박습니다. 굳이 이 모드를 쓸 거라면 로컬 머신이 아니라 격리된 클라우드 VM에서 돌리는 게 그나마 안전한 구성인데, Vultr 같은 시간 단위 과금 VPS라면 실험용 격리 VM을 만들었다 지우는 식으로 부담 없이 시험해 볼 수 있습니다. → Vultr 시작하기
자주 묻는 질문
Q. Manual 모드로 바뀌면서 기능도 달라졌나요?
아니요. 기능은 기존 default 모드와 동일하고 이름만 바뀌었습니다. config 값도 여전히 default가 유효하고, hooks나 SDK 통합은 계속 default를 씁니다. manual은 v2.1.200 이상에서만 인식되는 별칭이에요.
Q. .claude/settings.json에 auto를 넣었는데 왜 안 되죠?
v2.1.142 이후 프로젝트·로컬 설정 파일의 auto는 에러 없이 무시됩니다. ~/.claude/settings.json(사용자 설정)으로 옮기세요.
Q. 승인 프롬프트만 줄이고 auto는 부담스러운데요?/permissions에서 자주 쓰는 도구·명령에 allow 규칙을 추가하는 방법이 있습니다. 모드와 별개 레이어라 Manual 모드에서도 동작해요. 특정 시점에 자동으로 검사를 끼워 넣고 싶다면 Claude Code Hooks로 승인 흐름 자체를 커스텀하는 방법도 있습니다.
업데이트 직후 확인할 두 가지
정리 대신 체크 포인트만 남깁니다. 첫째, 무인 실행 파이프라인이 있다면 AskUserQuestion 지점에서 멈추지 않는지 지금 확인하세요. 둘째, auto를 쓰고 싶다면 설정이 ~/.claude/settings.json에 있는지부터 보세요. 이 두 가지만 확인해도 "갑자기 매번 물어보는" 문제의 대부분은 풀립니다. 권한 모드를 손봤다면, 그다음은 계획 단계와 실행 단계를 나누는 Plan Mode 활용법까지 같이 잡아두는 걸 권합니다.
'Error & Trouble Shooting' 카테고리의 다른 글
| Cursor Internal error 해결법 — 원인별 체크리스트 4가지 (2026년 7월) (0) | 2026.07.13 |
|---|---|
| Claude Code API 연결 안 될 때 체크리스트 — SSL 인증서·프록시·QUIC까지 (0) | 2026.07.12 |
| Autocompact is thrashing 해결법 — Claude Code 컨텍스트 압축 루프 대처 (0) | 2026.07.10 |
| GitHub Copilot AI Credits 요금 폭탄, 크레딧 다 썼을 때 대처법 (0) | 2026.07.08 |
| Claude Code EACCES 오류 해결법, npm 전역 설치 실패 체크리스트 (0) | 2026.07.08 |