본문으로 건너뛰기

플랜 모드

초급
What you'll learn
  • 플랜 모드가 무엇을 차단하는지 — 그리고 Claude가 여전히 실행할 수 있는 것은 무엇인지 설명한다
  • 플랜 모드에 진입하고 벗어나는 세 가지 방법을 익힌다
  • 조사-제안-승인-실행 루프를 짚어본다
  • 플랜 모드와 권한을 구분하고 함께 쓴다

핵심 아이디어​

계약자에게 집 열쇠를 넘기는 것과, 먼저 둘러보고 무엇을 바꿀지 적어달라고 하는 것을 상상해 보세요. 플랜 모드는 그 둘러보기입니다.

플랜 모드는 Claude에게 변경을 실행하지 않고 조사하고 제안하라고 지시합니다: 파일을 읽고, 탐색을 위해 셸 명령을 실행하고, 계획을 작성하지만 — 당신의 소스를 편집하지는 않습니다. 당신이 계획을 승인할 때까지 편집은 차단된 상태로 남습니다.

Pro tip
  • 플랜 모드는 Claude가 조사는 하되 당신의 소스를 변경하지는 않는다는 뜻입니다 — 계획을 만들어 당신의 신호를 기다립니다.

엄격한 읽기 전용은 아니다​

탐색에는 때때로 명령이 필요하므로, 플랜 모드의 핵심은 실행하지 않는 것이 아니라 편집하지 않는 것입니다. 계획 중에 셸 명령이 어떻게 처리되는지는 세션에 따라 달라집니다 — 아래에서 먼저 들어맞는 경우가 적용됩니다:

Guided walkthrough1 of 3
  1. 분류기가 당신에게 묻는 대신 셸 명령을 검토합니다. 핵심 경로를 삭제하는 명령만 예외입니다. 승인된 명령은 실행되고, 거부된 명령은 차단됩니다.
Watch out
  • --allow-dangerously-skip-permissions로 실행했다면, 플랜 모드는 단단한 가드레일이 아니라 강한 지시에 가깝습니다. 샌드박스가 아니라 계획 관례로 취급하세요.

왜 가장 안전한 시작인가​

크거나, 위험하거나, 낯선 무엇이든, Claude가 리포지토리를 건드리기 전에 무엇을 의도하는지 보고 싶을 것입니다. 플랜 모드는 생각과 행동을 분리합니다:

대가: 잘못된 가정이 잘못된 코드가 되기 전에 잡아냅니다.

언제 쓰나​

Pro tip
  • 크거나 다중 파일 변경, 마이그레이션, 리팩터링에는 항상
  • 아직 완전히 모르는 코드베이스에서 작업할 때
  • 팀원과 공유할 검토 가능한 계획을 원할 때

작고 뻔한 편집에는 건너뛸 수 있지만 — 의심스러우면 먼저 계획하세요.

실전에서 작동하는 법​

루프를 따르세요. 각 단계가 다음 단계를 얻습니다 — Claude는 당신이 승인한 뒤에야 편집으로 전환합니다.

Guided walkthrough1 of 4
  1. Shift+Tab을 눌러 권한 모드를 순환하다가 상태 바에 'plan mode on'이 표시되면 멈추거나, 프롬프트 하나에 /plan을 접두사로 붙이세요. 처음부터 플랜 모드로 시작하려면 claude --permission-mode plan으로 실행하세요. 그런 다음 무엇을 이루고 싶은지 설명하세요.

계획을 승인하지 않고 플랜 모드를 벗어나려면 Shift+Tab을 다시 누르세요. 프로젝트의 터미널 세션에서 기본값으로 만들려면 .claude/settings.json에서 defaultMode를 plan으로 설정하세요 — 설정을 참고하세요.

직접 해보기​

이것을 실제 계획 세션에 붙여넣고 루프가 펼쳐지는 것을 지켜보세요:

계획 세션 시작하기

I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.
CLAUDE.md와 짝지으세요

좋은 CLAUDE.md는 계획을 더 날카롭게 만듭니다 — Claude가 당신의 관례와 가드레일을 이미 염두에 두고 계획합니다.

플랜 모드 vs 권한​

전형적인 혼동. 둘은 다른 문제를 풀고 함께 작동합니다:

  • 플랜 모드 = "조사하고 제안하되, 아직 편집하지 마." (이 페이지.)
  • 권한 = 일단 행동하면, 어떤 동작이 묻지 않고 허용되는가.

지금 행동할지 여부(플랜 모드) 대 일단 행동하면 어떤 동작이 허용되는가(권한)로 생각하세요.

Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.
1 / 5
Key takeaways
  • 플랜 모드는 조사하고 제안하는 모드입니다: Claude가 파일을 읽고 탐색용 명령을 실행하지만, 당신이 계획을 승인할 때까지 당신의 소스를 편집하지 않습니다
  • 엄격한 읽기 전용은 아닙니다 — 계획 중의 명령은 분류기 검토를 받거나, 승인을 묻거나, (대화형 터미널에서 bypass permissions를 쓸 수 있으면) 아예 차단되지 않습니다
  • Shift+Tab, /plan 접두사, 또는 --permission-mode plan으로 진입하고; 승인하면 세션이 그 승인 옵션이 가리키는 모드로 전환됩니다
  • 크거나 위험하거나 낯선 작업에는 기본으로 쓰고; 작고 뻔한 편집만 건너뛰세요
  • 플랜 모드는 지금 행동할지를, 권한은 일단 행동하면 어떤 동작이 허용되는지를 다스립니다

스스로 점검하기

0/4
  1. 플랜 모드에 있는 동안 Claude Code는 무엇을 할 수 있나요?
  2. 언제 플랜 모드를 써야 하나요?
  3. 플랜 모드 루프의 올바른 순서는 무엇인가요?
  4. 플랜 모드와 권한은 어떻게 다른가요?

다음​