빠른 비교
| mode | 기본 성격 | 적합한 상황 |
|---|---|---|
| Plan Mode | 읽기와 계획 우선 | 큰 변경 전 탐색, 리뷰, 설계 |
| Normal Mode | 작업별 승인 | 일반 수정, 검증, Git 작업 |
| Auto-accept | 편집 자동 수락 | 신뢰된 작은 반복 수정 |
bash
claude --permission-mode plan
claude --permission-mode plan -p "analyze the auth module and propose a migration plan"모드 선택
Plan Mode는 수정 전 탐색 경계다
Plan Mode는 코드베이스를 읽고 분석해 계획을 만드는 데 초점을 둡니다. 여러 파일을 건드릴 가능성이 있거나, 아키텍처를 먼저 이해해야 하거나, 리뷰 의견을 정리해야 할 때 유용합니다.
text
> 인증 모듈을 OAuth2 기반으로 바꾸는 계획을 세워 주세요.
> 먼저 파일을 읽고 영향 범위와 테스트 전략만 정리해 주세요.계획이 필요한 작업을 바로 수정 모드로 시작하면 변경 범위가 빨리 넓어질 수 있습니다. 특히 레거시 코드, 결제, 인증, 마이그레이션처럼 영향이 큰 영역은 먼저 읽기 중심 계획으로 범위를 좁히는 편이 안전합니다.
Normal Mode는 승인과 실행을 균형 있게 둔다
Normal Mode는 Claude Code가 파일 수정이나 명령 실행을 제안하고, 사용자가 승인하면서 진행하는 기본 흐름입니다. 실제 구현과 검증을 함께 맡기되, 위험한 명령이나 넓은 파일 수정은 중간에서 확인할 수 있습니다.
text
> 계획의 1단계만 구현하고 테스트까지 실행해 주세요.
> auth/ 아래 파일만 수정하세요.승인 흐름은 속도를 늦추는 장치가 아니라 작업 범위를 유지하는 안전장치입니다. 변경이 예상보다 커지면 승인 지점에서 다시 범위를 조정할 수 있습니다.
운영 기준
| 상황 | 선택 |
|---|---|
| 코드베이스 구조를 먼저 이해 | Plan Mode |
| 큰 리팩터링 전 영향 범위 조사 | Plan Mode |
| 작은 버그 수정과 테스트 | Normal Mode |
| 반복되는 안전한 포맷 수정 | Auto-accept 제한 사용 |
| 민감 파일이나 배포 명령 포함 | Normal Mode와 좁은 permissions |
| 기본 모드를 고정하고 싶음 | settings의 permissions.defaultMode 검토 |
모드는 작업 성격에 맞춰 바꿔야 합니다. 한 세션 안에서도 탐색은 Plan Mode, 구현은 Normal Mode처럼 나눌 수 있습니다.
주의할 점
Auto-accept는 편하지만 변경 범위가 예상보다 커져도 중간 확인 없이 진행될 수 있습니다. 테스트 fixture, 문서 포맷, 기계적 rename처럼 위험이 낮은 작업부터 제한적으로 쓰는 편이 좋습니다.
Plan Mode에서 나온 계획은 실행 결과가 아닙니다. 실제 수정 단계로 넘어가면 다시 변경 범위, 검증 명령, 커밋 기준을 명확히 지정하세요.
참고 링크
2 sources