Claude Code Manual 권한 모드: 2.1.200 이후 팀 설정 점검법 | DAKER 커뮤니티
Claude Code Manual 권한 모드란, 도구 실행을 자동으로 넘기지 않고 사람이 승인 경계를 확인하는 기본 권한 흐름입니다. 2026년 7월 3일 공개된 Claude Code 2.1.200부터 default permission mode는 CLI, VS Code, JetBrains에서 Manual로 표시되고, AskUserQuestion dialog도 기본 자동 진행을 하지 않습니다. 팀에서 자동화가 갑자기 멈춘 것처럼 보인다면 먼저 /config와 defaultMode를 확인하세요.
클로드 코드 디렉터리 - Manual 권한 모드와 AskUserQuestion 변경을 팀 설정에서 확인하는 NotebookLM 카드.
문제 상황: 왜 Claude Code가 예전처럼 자동으로 이어가지 않을까요?
한 줄 요약: 2.1.200 이후에는 질문 팝업과 기본 권한 모드를 “자동 진행”이 아니라 “명시적 선택”으로 보는 편이 안전합니다.
당신이 어제까지 쓰던 자동화 프롬프트가 오늘은 사용자 입력을 기다릴 수 있습니다. 이것은 오류라기보다 권한 경계가 더 분명해진 신호일 수 있습니다. 특히 DAKER의 auto mode git 안전장치 글을 보고 자동 승인 범위를 넓혔다면, 이번 변경은 그 반대편인 “기본값과 질문 대기”를 점검하는 글입니다.
핵심 개념: Manual, default, AskUserQuestion은 어떻게 연결되나요?
핵심 포인트: 2.1.200에서 default 권한 모드는 사용자에게 Manual로 보이고, --permission-mode manual과 "defaultMode": "manual"도 허용됩니다.
공식 changelog 기준 AskUserQuestion dialog는 더 이상 기본으로 자동 계속 진행하지 않습니다. idle timeout이 필요하면 /config에서 명시적으로 켜야 합니다. settings 문서도 defaultMode의 manual alias는 Claude Code v2.1.200 이상에서 필요하다고 설명합니다.
| 확인 항목 | 실무 의미 | 바로 할 일 |
|---|---|---|
claude --version | 적용 버전 확인 | 2.1.200 이상인지 본다 |
/config | 세션 설정 확인 | 권한 모드와 질문 timeout을 본다 |
defaultMode | 팀 설정 파일 확인 | manual, auto, acceptEdits를 구분한다 |
| AskUserQuestion | 자동화 대기 지점 확인 | timeout을 켤지 팀 기준을 정한다 |
단계별 사용법: 팀 설정은 어떤 순서로 점검하나요?
- 로컬과 CI에서
claude --version을 확인합니다. - Claude Code에서
/config를 열어 현재 permission mode를 확인합니다. ~/.claude/settings.json과 프로젝트 설정의defaultMode를 비교합니다.- 질문 팝업이 필요한 자동화는 AskUserQuestion idle timeout을 켤지 정합니다.
- 위험한 명령은 allow보다 ask 또는 deny로 먼저 분리합니다.
- 변경 뒤 첫 세션에서 “왜 멈췄는지”를 로그로 남깁니다.
짧은 예시는 이렇게 남길 수 있습니다.
우리 팀 Claude Code 설정에서 defaultMode가 manual인지 확인하고, AskUserQuestion timeout은 PR 생성 자동화에만 켜도 되는지 근거와 함께 정리해줘.
클로드 코드 디렉터리 - 버전 확인, config 점검, 팀 규칙 기록으로 이어지는 Manual 권한 모드 워크플로 카드.
짧은 예시: 자동화가 멈췄을 때 무엇을 먼저 봐야 하나요?
먼저 “Claude가 실패했는가”와 “사람의 선택을 기다리는가”를 나눠야 합니다. 권한 프롬프트나 질문 dialog가 원인이라면 설정 문제이고, hook이 막았다면 이벤트 로그 문제입니다. hook 쪽은 DAKER의 hook events stream-json 글처럼 별도 로그로 확인하는 편이 좋습니다.
팀 적용 체크리스트: Manual 기본값을 운영 규칙으로 바꾸려면?
- 팀 문서에 사용 중인 Claude Code 버전 기준일을 적었는가
manual,auto,acceptEdits,bypassPermissions를 같은 의미로 섞지 않았는가- AskUserQuestion idle timeout을 켜는 자동화와 끄는 자동화를 구분했는가
- 프로젝트 설정이 사용자 설정보다 넓은 권한을 강제하지 않는지 확인했는가
- 민감 파일과 배포 명령은
ask또는deny로 먼저 분리했는가 - 권한 정책은 settings permissions 글과 함께 팀 온보딩에 연결했는가
공식 출처: 어디를 기준으로 확인했나요?
이 글은 2026년 7월 5일 기준 Claude Code 공식 changelog 2.1.200과 settings 문서를 확인해 작성했습니다. 공개 본문에는 DAKER 운영 정책에 맞춰 외부 공식 URL을 직접 노출하지 않고, 문서명과 기준일만 남깁니다.
자주 묻는 질문
Manual은 예전 default와 완전히 다른 모드인가요?
공식 문서 기준 manual은 default의 alias로 받아들여집니다. 다만 UI와 설명에서는 사람이 권한을 확인하는 Manual 흐름으로 이해하는 편이 명확합니다.
AskUserQuestion timeout은 항상 켜야 하나요?
아닙니다. 사람이 꼭 선택해야 하는 배포, 권한 변경, 외부 전송 작업에서는 timeout을 끄는 편이 안전합니다.
auto mode를 프로젝트 설정에 넣어도 되나요?
settings 문서는 project 또는 local settings의 auto가 무시된다고 설명합니다. 저장소가 스스로 auto mode를 강제하지 못하게 하기 위한 경계입니다.
팀 문서에는 무엇을 남기면 좋나요?
버전 기준일, 기본 권한 모드, 질문 timeout 정책, ask/deny 예시, 실패 시 확인할 로그 위치를 짧게 남기면 됩니다.
오늘 팀 설정에서 defaultMode와 AskUserQuestion 기준을 한 번만 확인해 두면, 다음 자동화 중단을 “오류”가 아니라 “의도된 승인 대기”로 빠르게 구분할 수 있습니다.