클로드 코드 플랜 모드 — 들어가는 법과 계획 승인까지

클로드 코드 플랜 모드는 고치기 전에 먼저 읽고 계획만 세우는 모드입니다. 파일 읽기와 탐색은 그대로 되지만 소스 편집은 내가 계획을 승인할 때까지 막혀 있습니다. 들어가는 방법은 세 가지입니다 — 세션 중에는 Shift+Tab, 이번 프롬프트만이라면 /plan, 처음부터 그 모드로 켜려면 claude --permission-mode plan. 아래에 무엇이 막히고 무엇이 되는지, 계획 승인 화면의 선택지 세 개가 각각 어떤 모드로 빠져나가는지 정리했습니다. (Claude Code 2.1.202 실행 확인 · 2026년 8월 5일 공식 문서 확인)

1. 플랜 모드에서 되는 것과 막히는 것

플랜 모드는 클로드에게 조사하고 제안만 하라고 지시하는 모드입니다. 공식 문서 표현대로 클로드는 파일을 읽고, 탐색용 셸 명령을 돌리고, 계획을 쓰지만 소스는 편집하지 않습니다.

동작	플랜 모드에서
파일 읽기·검색	확인 없이 그대로 실행
읽기 전용 셸 명령	확인 없이 실행 (내장 목록에 든 것)
그 밖의 셸 명령	승인을 묻거나, 자동 검사에 넘긴다
파일 생성·수정	계획을 승인하기 전까지 차단

여기서 "읽기 전용 명령"은 클로드 코드가 내장으로 들고 있는 목록입니다. 문서에 적힌 것은 ls, cat, echo, pwd, head, tail, grep, find, wc, which, diff, stat, du, cd, 그리고 읽기 전용 형태의 git 명령입니다. 이 목록은 설정으로 바꿀 수 없고, 굳이 확인을 받고 싶다면 그 명령에 ask나 deny 규칙을 따로 걸어야 합니다.

목록 밖의 명령(예: npm install)은 계획을 세우는 중이라도 승인을 묻습니다. 다만 계정에서 auto 모드를 쓸 수 있고 useAutoModeDuringPlan 설정이 켜져 있으면(기본값이 켜짐) 분류 모델이 대신 검토해서 통과시키거나 막습니다.

2. 플랜 모드 들어가는 법 3가지

① 세션 중에 — Shift+Tab
누를 때마다 default → acceptEdits → plan 순서로 순환합니다. 지금 어느 모드인지는 상태바 배지로 보입니다.

상태바 표시	모드
⏸ manual mode on (회색)	매번 확인 (설정값은 default)
⏵⏵ accept edits on	acceptEdits
⏸ plan mode on	plan

계획을 승인하지 않고 그냥 빠져나오려면 Shift+Tab을 한 번 더 누르면 됩니다.

② 이번 프롬프트만 — /plan
프롬프트 앞에 /plan을 붙이면 플랜 모드로 들어갑니다. 뒤에 설명을 같이 적으면 그 작업으로 바로 시작합니다.

/plan fix the auth bug

③ 시작할 때 — --permission-mode plan

claude --permission-mode plan

이 인자가 받는 값은 정확히 여섯 개입니다. 오타를 내면 이렇게 알려 줍니다.

$ claude --permission-mode bogus -p "hi"
error: option '--permission-mode <mode>' argument 'bogus' is invalid.
Allowed choices are acceptEdits, auto, bypassPermissions, manual, dontAsk, plan.

같은 인자를 -p(비대화형 실행)에도 그대로 쓸 수 있습니다. 여섯 가지 모드가 각각 무엇을 자동 승인하는지는 클로드 코드 권한 설정 글에 모드별로 정리해 두었습니다.

3. 계획 승인 화면 — 선택지 3개의 차이

계획이 다 나오면 클로드가 어떻게 진행할지 묻습니다. 여기서 고르는 값이 빠져나간 뒤의 권한 모드를 정합니다.

선택지	고르면
Yes, and use auto mode	승인하고 auto 모드로 시작. auto를 못 쓰는 계정에서는 이 항목이 Yes, auto-accept edits로 뜬다
Yes, manually approve edits	승인하되 편집마다 하나씩 확인
No, keep planning	플랜 모드에 남아서 계획을 고친다

즉 승인은 곧 플랜 모드 종료입니다. 다시 계획을 세우고 싶으면 Shift+Tab으로 돌아오거나 다음 프롬프트에 /plan을 붙이면 됩니다.

💡 계획 자체를 손으로 고치고 싶다면 Ctrl+G. 제안된 계획이 기본 텍스트 편집기에서 열리고, 고친 내용으로 진행합니다. "설명이 거의 맞는데 한 줄만 틀렸다" 싶을 때 다시 지시하는 것보다 빠릅니다.

승인하면 세션 이름이 계획 내용에서 자동으로 붙습니다. 단 --name이나 /rename으로 이미 이름을 정해 뒀다면 그대로 둡니다.

승인 화면에 "컨텍스트 비우기" 항목을 하나 더 띄우고 싶다면 설정에서 켤 수 있습니다. showClearContextOnPlanAccept는 기본값이 false이고, true로 두면 계획을 승인하면서 조사하느라 쌓인 대화를 함께 비웁니다. 이때 컨텍스트가 왜 문제가 되는지는 클로드 코드 컨텍스트 관리 글에서 /compact·/clear 차이로 다뤘습니다.

4. 프로젝트 기본값으로 고정하기

특정 저장소에서는 항상 계획부터 세우게 하고 싶다면 .claude/settings.json에 넣습니다.

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

참고로 플랜 모드에서는 프롬프트 제안(다음에 칠 말 자동 추천)이 꺼집니다. 대화 첫 턴에서와 마찬가지로 건너뜁니다.

5. VS Code·데스크탑·웹에서는

터미널이 아니면 Shift+Tab 대신 모드 선택 UI를 씁니다.

환경	바꾸는 곳
VS Code	입력창 아래 모드 표시를 클릭 (라벨 Plan = plan). 시작 모드는 claudeCode.initialPermissionMode
JetBrains	IDE 터미널에서 돌아가므로 CLI와 동일 (Shift+Tab)
데스크탑 앱	전송 버튼 옆 모드 선택기. Plan만은 그 세션에만 적용되고 폴더 기본값으로 기억되지 않는다
웹·모바일	프롬프트 옆 드롭다운. 클라우드 세션·리모트 컨트롤 세션 모두 Plan을 고를 수 있다

VS Code 확장은 2.1.205 이전 버전에서 plan을 "Plan mode"로 표기했습니다. 지금 라벨이 다르게 보인다면 확장 버전 차이입니다.

자주 묻는 질문 (FAQ)

Q. "계획 모드로 들어가"라고 말로 시키면 되나요?
공식 문서는 권한 모드를 모드 컨트롤로 설정하는 것이지 채팅으로 요청해 바꾸는 것이 아니라고 못 박고 있습니다. 도구 목록에는 EnterPlanMode(플랜 모드로 전환)와 ExitPlanMode(계획을 제시하고 플랜 모드를 빠져나옴)가 있긴 하지만, 확실하게 켜려면 Shift+Tab·/plan·--permission-mode plan 셋 중 하나를 쓰는 편이 낫습니다.

Q. 플랜 모드면 절대 파일이 안 바뀌나요?
승인 전까지 편집이 막히는 것은 맞지만 예외가 있습니다. bypass permissions를 쓸 수 있는 상태로 띄운 세션은 이 차단을 건너뜁니다. 또 저장소 상태와 클로드 코드 자체 설정을 지키는 보호 경로는 반대로 bypassPermissions가 아니면 어떤 모드에서도 자동 승인되지 않습니다.

Q. Shift+Tab을 눌러도 plan이 안 나옵니다.
기본 순환은 default → acceptEdits → plan 셋입니다. 여기에 auto나 bypassPermissions가 켜져 있으면 plan 뒤에 끼어들어 순환이 길어지므로, 한 바퀴를 다 돌려 보세요. dontAsk는 순환에 아예 나오지 않고 --permission-mode dontAsk로만 켭니다.

Q. auto 모드가 없으면 플랜 모드가 불편한가요?
탐색용 명령이 읽기 전용 목록 밖이면 그때마다 승인을 물어봅니다. useAutoModeDuringPlan은 기본으로 켜져 있지만 auto 모드를 쓸 수 있는 계정에서만 의미가 있고, 공유되는 프로젝트 설정에서는 읽지 않는 값이라 개인 설정에 둬야 합니다.

마무리

정리하면 플랜 모드는 읽고 계획만 세우는 모드이고, 들어가는 길은 Shift+Tab·/plan·--permission-mode plan 세 가지입니다. 계획 승인 화면에서 고른 항목이 곧 다음 권한 모드가 되므로, 큰 변경이라면 "Yes, manually approve edits"로 받아 두는 편이 안전합니다. 저장소마다 항상 계획부터 세우게 하려면 defaultMode를 plan으로 고정하면 됩니다.

---

📚 참고 출처 (2026년 8월 5일 확인 · Claude Code 2.1.202)
· Claude Code Docs — Choose a permission mode
· Claude Code Docs — Slash commands
· Claude Code Docs — Permissions
· Claude Code Docs — Settings