Claude Code 자동 모드 사용법: 완벽한 단계별 튜토리얼

사전 준비 사항

Claude Code 자동 모드를 사용하기 전에 다음 항목을 확인하세요:

• Claude 구독: 팀 플랜(연구 프리뷰 시 필요) 또는 엔터프라이즈 플랜(곧 출시 예정). 자동 모드는 프로, 맥스 또는 무료 계정에서는 사용할 수 없습니다.
• Claude 모델: Claude Sonnet 4.6 또는 Opus 4.6(자동 모드 필요).
• Claude Code 설치: CLI, 데스크톱 앱 또는 VS Code 확장의 최신 버전.
• 프로젝트 디렉토리: 작업하려는 로컬 코드베이스.
• 터미널 접근: CLI 사용 시(완전한 제어 권한을 위해 권장).

참고: 자동 모드는 현재 연구 프리뷰 단계입니다. 관리자는 관리 설정을 통해 조직 전체에서 비활성화할 수 있습니다.

1단계: Claude Code 설치

1. 터미널을 엽니다.

2. 운영체제에 맞는 설치 명령어를 실행하세요:

   macOS / Linux / WSL

   Copy

   curl -fsSL https://claude.ai/install.sh | bash
   

   Windows (PowerShell)

   Copy

   irm https://claude.ai/install.ps1 | iex
   

3. 설치 확인:

   Copy

   claude --version
   

4. (선택 사항) macOS의 Homebrew 사용 시:

   Copy

   brew install --cask claude-code
   

설치 후 Claude Code는 백그라운드에서 자동으로 업데이트됩니다.

2단계: Claude Code 로그인

1. 인터랙티브 세션 시작:
   Copy

   claude
   

2. 화면에 나타나는 로그인 프롬프트를 따르세요(최초 사용 시만).
3. 팀 또는 엔터프라이즈 계정을 사용하세요.

로그인 후 자격 증명은 안전하게 저장됩니다.

3단계: 자동 모드 활성화

자동 모드는 모드 사이클에 나타나기 전에 명시적으로 잠금 해제해야 합니다.

CLI 방법 (권장)

활성화 플래그와 함께 실행:

claude --enable-auto-mode

또는 자동 모드로 직접 시작:

claude --enable-auto-mode --permission-mode auto

설정 파일 방법

~/.claude/settings.json(사용자 수준) 또는 .claude/settings.local.json(프로젝트 수준) 생성 또는 편집:

{
  "defaultMode": "auto"
}

중요: --enable-auto-mode 플래그는 시작 시 모드가 Shift+Tab 사이클에 나타나도록 하기 위해 여전히 필요합니다.

데스크톱 / VS Code 확장

• Claude Code 설정을 엽니다.
• 자동 모드 토글을 켭니다(CLI 플래그 또는 관리자 설정을 통해 활성화한 후에만 나타남).

4단계: 자동 모드 분류기 구성하기 (권장)

자동 모드는 안전한 작업을 승인하기 위해 백그라운드 분류기를 사용합니다. 사용자 환경에 맞게 구성하세요.

1. 내장 규칙 확인하기:

   Copy

   claude auto-mode defaults
   

2. 출력 결과를 복사하여 신뢰할 수 있는 인프라 정보와 함께 설정 파일을 생성/편집하세요:

   Copy

   {
     "autoMode": {
       "environment": [
         "조직: Acme Corp. 주요 용도: 소프트웨어 개발",
         "소스 컨트롤: github.com/acme-corp 및 모든 저장소",
         "클라우드 버킷: s3://acme-build-artifacts"
       ],
       "allow": [
         "스테이징 환경에 배포 허용: 격리된 환경"
       ],
       "soft_deny": [
         "공식 CLI 외부에서는 데이터베이스 마이그레이션을 절대 실행하지 않음"
       ]
     }
   }
   

3. 구성 검증하기:

   Copy

   claude auto-mode config
   

4. 사용자 정의 규칙에 대한 AI 피드백 받기:

   Copy

   claude auto-mode critique
   

5단계: 세션 시작 및 자동 모드로 전환하기

1. 프로젝트로 이동하기:

   Copy

   cd /path/to/your-project
   

2. 자동 모드가 활성화된 Claude Code 실행하기:

   Copy

   claude --enable-auto-mode
   

3. 세션 중 모드 전환하기:

   • Shift + Tab (또는 Alt + M)을 반복해서 눌러 순환: default → acceptEdits → plan → auto.
   • 현재 모드는 상태 표시줄에 표시됩니다.

4. Claude에 작업 지시하기. 예시:

   Copy

   인증 모듈 리팩터링, 단위 테스트 추가, 전체 테스트 스위트 실행하기.
   

이제 자동 모드는 낮은 위험도의 도구 호출(파일 읽기, 대상 수정, 표준 빌드/테스트)을 자동으로 승인하며, 위험한 작업은 분류기에 의해 차단됩니다.

6단계: 효과적인 사용을 위한 모범 사례

• 먼저 계획 모드로 시작하기: plan 모드로 전환(Shift+Tab 두 번)하여 Claude의 계획을 검토한 후 자동 모드로 전환하세요. -d 프로젝트 컨텍스트 추가하기: 루트 디렉토리에 코딩 표준, 빌드 명령어, 금지 작업을 담은 CLAUDE.md 파일을 생성하세요.
• 체크포인트 사용하기: Claude는 변경 전 상태를 자동으로 저장합니다. Esc 키 두 번 또는 /rewind으로 되돌리세요.
• 훅과 결합하기: 편집 후 자동 린팅 또는 테스트를 위해 .claude/settings.json을 구성하세요. (메모: 후속은 훅을 의미)
• 진행 상황 모니터링하기: 상세 모드(Ctrl + R)를 사용하여 전체 추론 과정을 확인하세요.

일반적인 문제와 해결 방법

• Auto Mode가 사이클에 나타나지 않음:

  • --enable-auto-mode로 시작했는지 확인하세요.
  • Sonnet 4.6 또는 Opus 4.6이 있는 Team/Enterprise 플랜인지 확인하세요.
  • 조직 내에 있다면 관리자 설정을 확인하세요.

• 분류기가 정당한 작업을 차단함:

  • autoMode.allow 또는 environment에 명시적인 규칙을 추가하세요.
  • 제안을 위해 claude auto-mode critique를 사용하세요.
  • 작업 지시를 더 명확히 하거나 일시적으로 acceptEdits로 전환하세요.

• 대기 시간 또는 토큰 사용량 증가:

  • 백그라운드 분류기로 인한 예상 현상입니다. 긴 세션에만 사용하세요.

where, context, or perform some file operations that require higher priveleges.

• 보호된 경로에서 권한 오류:

  • .git, .claude 등은 대부분의 모드에서 여전히 확인을 요청합니다. 완전한 자율성을 위해서는 격리된 환경(Docker/VM)을 사용하세요.

• 세션이 예기치 않게 종료됨:

  • 가장 최근 대화를 계속하려면 claude -c를 실행하세요.

다음 단계

: 실행

• Plan Mode를 사용하여 Auto Mode로 전환하기 전에 복잡한 리팩토링을 계획하세요.
• 사용자 정의 명령과 훅을 설정하여 반복 가능한 워크플로를 구성하세요.
• 병렬 작업(예: 프론트엔드 + 백엔드)을 위해 하위 에이전트를 사용해 보세요.
• 완전 자동화된 파이프라인을 위해 GitHub Actions를 통해 CI/CD와 통합하세요.
• 안전을 위해 폐기 가능한 Git 브랜치나 Docker 컨테이너에서 실험하세요.

Auto Mode가 활성화되고 적절히 구성되면, 강력한 안전 장치를 유지하면서 방해를 크게 줄인 채 시간 단위의 자율 코딩 세션을 실행할 수 있습니다. 오늘 간단한 작업으로 시작하고 점차 확신을 얻으며 신뢰할 수 있는 환경 규칙을 확장해 보세요.