Ch8. Plan 모드 활용

Plan 모드는 Claude Code를 읽기 전용 상태로 전환하여 코드 수정 없이 분석·계획만 수행하는 모드입니다.

왜 Plan 모드인가

복잡한 작업에서 바로 코드를 수정하면 방향이 틀어질 위험이 큽니다. Plan 모드에서 먼저 계획을 세운 뒤 승인하면 재작업이 줄어듭니다.

모드 전환

CLI 플래그

# Plan 모드로 시작
claude --permission-mode plan

# 헤드리스 + Plan 모드
claude --permission-mode plan -p "아키텍처를 분석해줘"

/plan 명령으로 진입 (v2.1.72)

세션 중 /plan [description] 형태로 설명 인자를 전달하면, 플랜 모드 진입과 동시에 작업을 시작할 수 있습니다.

/plan src/auth 모듈의 인증 흐름을 분석하고 개선안을 정리해줘

기본값 설정

.claude/settings.json:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

/permissions로 변경

/permissions

Plan 모드에서 가능한 일

• 코드/문서 읽기
• 구조/아키텍처 분석
• 계획 수립 및 리뷰

Plan 모드에서는 파일 수정과 실행 명령이 제한됩니다.

플랜 모드 UX 개선

multi-line 피드백 입력 (v2.1.69)

플랜 모드 피드백 입력에서 여러 줄을 입력할 수 있습니다. backslash+Enter 또는 Shift+Enter로 줄바꿈합니다.

숫자 키 동작 변경 (v2.1.72)

플랜 모드에서 숫자 키가 메뉴 선택 대신 텍스트 입력으로 동작합니다. 피드백을 작성할 때 숫자가 포함된 내용을 자연스럽게 입력할 수 있습니다.

컨텍스트 compaction 후 모드 유지 (v2.1.47)

기존에는 컨텍스트 compaction이 발생하면 플랜 모드가 해제되었지만, 이제 compaction 이후에도 플랜 모드가 유지됩니다.

VS Code 플랜 프리뷰 개선 (v2.1.47)

• 플랜이 자동 업데이트됩니다
• 리뷰 준비가 완료된 시점에서만 코멘트를 달 수 있습니다
• 플랜 거부 시에도 프리뷰가 유지되어 참고할 수 있습니다

"clear context" 옵션 기본 숨김 (v2.1.81)

Plan 모드에서 "clear context" 옵션이 기본으로 숨겨집니다. 불필요한 컨텍스트 초기화를 방지하여 플랜 워크플로우의 안정성이 향상됩니다.

실전 워크플로우

리팩토링 프로세스

참고 문서

• settings.json에서 기본 모드 설정: https://code.claude.com/docs/ko/settings (한국어)

• /permissions 명령: https://code.claude.com/docs/ko/slash-commands (한국어)

• 퍼미션 모드(Plan 포함): https://docs.claude.com/en/docs/claude-code/team (영어)