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

Claude Code 자동 모드를 활성화하고 안전하게 사용하는 방법을 배워보세요. 설치, 설정, 모드 전환, 문제 해결을 포함한 Team/Enterprise 사용자를 위한 완벽 튜토리얼입니다.

Canonical URL: https://a2a-mcp.org/blog/how-to-use-claude-code-auto-mode-ko

Language: ko

Published: 2026-03-25

Updated: 2026-03-25

## 사전 준비 사항

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**
   ```bash
   curl -fsSL https://claude.ai/install.sh | bash
   ```

   **Windows (PowerShell)**
   ```powershell
   irm https://claude.ai/install.ps1 | iex
   ```

3. 설치 확인:
   ```bash
   claude --version
   ```

4. (선택 사항) macOS의 Homebrew 사용 시:
   ```bash
   brew install --cask claude-code
   ```

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

## 2단계: Claude Code 로그인

1. 인터랙티브 세션 시작:
   ```bash
   claude
   ```
2. 화면에 나타나는 로그인 프롬프트를 따르세요(최초 사용 시만).
3. 팀 또는 엔터프라이즈 계정을 사용하세요.

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

## 3단계: 자동 모드 활성화

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

### CLI 방법 (권장)

활성화 플래그와 함께 실행:
```bash
claude --enable-auto-mode
```

또는 자동 모드로 직접 시작:
```bash
claude --enable-auto-mode --permission-mode auto
```

### 설정 파일 방법

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

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

### 데스크톱 / VS Code 확장

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

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

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

1. 내장 규칙 확인하기:
   ```bash
   claude auto-mode defaults
   ```

2. 출력 결과를 복사하여 신뢰할 수 있는 인프라 정보와 함께 설정 파일을 생성/편집하세요:
   ```json
   {
     "autoMode": {
       "environment": [
         "조직: Acme Corp. 주요 용도: 소프트웨어 개발",
         "소스 컨트롤: github.com/acme-corp 및 모든 저장소",
         "클라우드 버킷: s3://acme-build-artifacts"
       ],
       "allow": [
         "스테이징 환경에 배포 허용: 격리된 환경"
       ],
       "soft_deny": [
         "공식 CLI 외부에서는 데이터베이스 마이그레이션을 절대 실행하지 않음"
       ]
     }
   }
   ```

3. 구성 검증하기:
   ```bash
   claude auto-mode config
   ```

4. 사용자 정의 규칙에 대한 AI 피드백 받기:
   ```bash
   claude auto-mode critique
   ```

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

1. 프로젝트로 이동하기:
   ```bash
   cd /path/to/your-project
   ```

2. 자동 모드가 활성화된 Claude Code 실행하기:
   ```bash
   claude --enable-auto-mode
   ```

3. **세션 중 모드 전환하기**:
   - **Shift + Tab** (또는 Alt + M)을 반복해서 눌러 순환: `default` → `acceptEdits` → `plan` → `auto`.
   - 현재 모드는 상태 표시줄에 표시됩니다.

4. Claude에 작업 지시하기. 예시:
   ```text
   인증 모듈 리팩터링, 단위 테스트 추가, 전체 테스트 스위트 실행하기.
   ```

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

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