Claude Code /auto-mode-setup 사용법: 프로젝트에 맞는 자동 권한 설정

/auto-mode-setup은 현재 프로젝트와 최근 세션을 분석해 자동 권한 판단에 쓸 환경 설정을 제안하는 명령입니다. Anthropic 공식 문서에 따르면 초안을 수락하면 사용자 설정인 ~/.claude/settings.json에 저장됩니다. 프로젝트에 맞춰 만들지만, 그 프로젝트에서만 적용되는 설정은 아니라는 점부터 기억하면 됩니다.

먼저 구분할 용어

설정 생성과 권한 모드 전환은 별도 작업입니다.

용어의미

auto 모드	별도 분류 모델이 행동을 검토하는 권한 모드
/auto-mode-setup	프로젝트 정보를 바탕으로 설정 초안을 만드는 명령
autoMode.environment	프로젝트와 최근 세션을 바탕으로 제안하는 환경 설정

설정하는 순서

아래 명령은 공식 문서 기반의 미실행 예제입니다. 실제 계정에서의 실행 결과나 생성 화면을 검증한 사용 후기는 아닙니다.

1. 프로젝트의 대화형 터미널에서 실행하기

설정하려는 프로젝트에서 Claude Code 대화형 세션을 열고 입력합니다.

/auto-mode-setup

사용 목적에 답하고 선택 조사 범위를 결정합니다. 클라우드 세션에서는 이 명령을 사용할 수 없습니다.

2. 읽는 정보와 초안 확인하기

명령은 프로젝트의 CLAUDE.md, README, 설정, Git 원격 저장소와 기존 권한 설정을 살펴봅니다. 최근 세션에서는 실행 명령에 등장한 호스트·버킷·명령명을 조사하며, 사용자 메시지는 해당 세션 조사 대상에 포함하지 않습니다.

셸 이력에 있는 명령의 첫 단어와 홈 디렉터리 아래 저장소 정보는 선택 조사입니다. 필요한 범위를 정한 뒤 제안된 환경 정보와 규칙을 읽으세요. 팀 저장소나 개발용 버킷이 의도한 대상인지, 운영 환경까지 신뢰 범위에 들어가지는 않았는지 검토하는 것이 좋습니다.

3. 수락 후 저장된 설정 확인하기

생성 초안은 전체를 수락하거나 폐기합니다. 개별 항목은 저장 후 수정할 수 있습니다. 수락했다면 터미널에서 다음 명령으로 유효 설정을 확인합니다.

claude auto-mode config

autoMode는 프로젝트의 .claude/settings.json이나 .claude/settings.local.json에서 읽지 않습니다. 개인 설정에 추가한 환경 정보는 다른 프로젝트에도 영향을 줄 수 있으므로, 신뢰 대상을 구체적으로 적어야 합니다.

자동 모드로 전환하려면

설정 초안을 만드는 명령과 세션을 auto 모드로 실행하는 명령을 구분하세요. 새 세션을 auto 모드로 시작하는 예제는 다음과 같습니다.

claude --permission-mode auto

실행 중에는 CLI의 Shift+Tab으로 권한 모드를 전환할 수 있습니다. 지원 모델이나 조직 정책에 따라 사용이 제한될 수 있습니다.

auto 모드는 모든 작업을 무조건 승인하거나 안전을 보장하는 기능이 아닙니다. Anthropic의 Configure permissions 문서에 따르면 권한 규칙은 deny → ask → allow 순서로 평가합니다. 사람이 확인해야 하는 작업은 해당 권한 규칙을 유지하고, 실제 명령이 규칙에 매칭되는지도 검토하세요.

Unknown command가 나오면

먼저 설치 버전과 사용 환경을 확인한 뒤 새 세션에서 다시 시도합니다. 공식 설정 문서가 제시하는 버전 조건은 다음과 같습니다.

사용 환경필요한 버전

Pro·Max·Team	v2.1.228 이상, 네이티브 Windows는 v2.1.233 이상
Enterprise·Console API 키	v2.1.283 이상
텔레메트리 비활성·타사 공급자·Claude apps gateway	v2.1.304 이상

여러 조건에 해당하면 더 높은 버전 조건을 적용하세요. 버전을 충족해도 지원 모델과 조직 정책은 별도로 확인해야 합니다.

처음 적용할 때는 개발용 프로젝트에서 초안을 생성하고 저장 대상을 검토하세요. 수락한 뒤 claude auto-mode config로 다른 프로젝트에도 적용될 환경 정보가 의도대로 들어갔는지 확인하는 순서가 좋습니다.

참고 링크

• Anthropic — Configure auto mode
• Anthropic — Choose a permission mode