[Claude] Claude Code 'Plan Mode': 생각은 깊게, 코딩은 가볍게

안녕하세요-! 오늘은 Claude code plan Mode에 대해 알아보려 합니다.

 

코딩할 때 가장 위험한 순간은 "일단 코드부터 치고 볼까?"라고 생각할 때입니다. 특히 복잡한 아키텍처나 Harness 같은 배포 파이프라인을 건드릴 때는 더더욱 그렇습니다. Anthropic은 이런 '깊은 고민'의 시간을 위해 Plan Mode라는 강력한 안전장치를 공식적으로 제공합니다.

 

1. Plan Mode란 무엇인가? 

공식 문서에 따르면, Plan Mode는 Claude가 파일을 수정하거나 명령어를 실행하지 않고 오직 '분석'과 '설계'만 수행하는 읽기 전용(Read-only) 모드입니다.

• 핵심 철학: "실행하기 전에 동의부터 구하라."
• 작동 방식: 전체 코드베이스를 훑고, 의존성을 파악한 뒤, 마크다운(Markdown) 형식의 이행 계획서를 먼저 작성합니다.
• 좋은 점: 실수로 파일을 날려 먹거나, 잘못된 인프라 명령어를 실행할 위험이 0%입니다.

 

2. 왜 'Plan Mode'를 써야 하는가?

사용자님이 강조하신 "뭐라도 1개씩 가져오기" 전략을 Plan Mode에 적용하면 다음과 같은 실질적인 이득이 있습니다.

상황	Plan Mode의 역할	얻어갈 1개 (Takeaway)
기존 코드 분석	"이 프로젝트 구조 좀 파악해줘."	전체 시스템의 시각적 구조도
복잡한 기능 추가	"Harness 배포 단계를 5개로 늘릴 거야."	수정해야 할 파일 리스트와 시나리오
보안 점검	"내 설정 파일에 API 키 노출된 거 없어?"	보안 취약점 체크리스트

 

3. [실전] Plan Mode 진입 및 활용법 (Step-by-Step)

공식 문서에서 제안하는 가장 빠른 활용 방법입니다.

• 방법 A: 터미널 단축키 (가장 빠름)
  • Claude CLI 실행 중 Shift + Tab을 두 번 누르세요.
  • 하단에 아래 이미지처럼 ⏸ plan mode on이라는 표시가 뜨면 성공입니다.

plan node on

• 방법 B: 시작 옵션
  • claude --permission-mode plan 명령어로 처음부터 설계 모드로 시작할 수 있습니다.
• 활용 팁: 설계가 맘에 든다면 Ctrl + G를 눌러 계획서를 에디터로 열어보고 수정할 수 있습니다.
• 확신이 생겼을 때 다시 Normal 모드로 돌아가 실행(Act)하면 됩니다.

 

4. " Accept edit Mode " vs " Plan Mode ": 언제 무엇을 쓸까?

• Accept edit Mode: 오타 수정, 간단한 함수 추가, 블로그 포스팅 초안 작성.
• Plan Mode: 새로운 프레임워크 도입(Harness 연동 등), 대규모 리팩토링, 보안 관련 작업.

 

클로드의 플랜모드에 대해 알아보았는데요 모두 한 번씩 사용해 보시면 좋을 것 같습니다!

오늘도 긴 글 읽어주셔서 감사합니다~!