플랜 모드

초급

What you'll learn

플랜 모드가 무엇을 하며 왜 읽기 전용인지 설명한다
먼저 계획할 때와 건너뛸 수 있을 때를 판단한다
조사-제안-승인-실행 루프를 짚어본다
플랜 모드와 권한을 구분하고 함께 쓴다

핵심 아이디어

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

플랜 모드는 Claude Code를 읽기 전용으로 만듭니다: 코드베이스를 탐색하고, 검색하고, 추론할 수 있지만 — 파일을 편집하거나 상태를 바꾸는 명령을 실행하지 않습니다. 대신 계획을 만들고 당신의 승인을 기다립니다.

Pro tip

읽기 전용은 Claude가 생각은 하되 행동은 하지 않음을 뜻합니다 — 당신이 진행하라고 할 때까지 파일 편집도, 상태 변경 명령도 없습니다.

왜 가장 안전한 시작인가

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

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

언제 쓰나

Pro tip

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

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

실전에서 작동하는 법

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

Guided walkthrough1 of 4

읽기 전용 모드로 전환한 뒤, 무엇을 이루고 싶은지 설명합니다.

직접 해보기

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

계획 세션 시작하기

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.

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

플랜 모드 vs 권한

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

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

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

Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.

1 / 4

Key takeaways

플랜 모드는 읽기 전용입니다: Claude가 탐색하고 제안하지만 당신이 승인할 때까지 절대 편집하거나 상태 변경 명령을 실행하지 않습니다
크거나 위험하거나 낯선 작업에는 기본으로 쓰고; 작고 뻔한 편집만 건너뛰세요
루프는 조사 → 제안 → 승인/다듬기 → 실행입니다
플랜 모드는 지금 행동할지를, 권한은 일단 행동하면 어떤 동작이 허용되는지를 다스립니다

스스로 점검하기

0/4

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

핵심 아이디어​

왜 가장 안전한 시작인가​

언제 쓰나​

실전에서 작동하는 법​

직접 해보기​