Claude Code 플랜 모드: 작동 방식과 언제 쓰면 좋은지

플랜 모드 vs auto 모드 vs accept edits vs manual

플랜 모드는 Claude Code의 권한 모드 중 하나예요. 모드마다 편리함과 통제 사이의 균형이 달라요. 아래 표는 각 모드에서 Claude가 묻지 않고 할 수 있는 일을 정리한 거예요.

Claude Code에서 플랜 모드 쓰는 법

1. 플랜 모드로 들어가기

   터미널에서 Shift+Tab을 눌러 모드를 순환하다가 상태 표시줄에 ⏸ plan mode on이 보이면 멈춰요. Manual에서 시작하면 accept edits, 그다음 plan 순서예요. 프롬프트 하나만 계획하려면 앞에 /plan을 붙이면 돼요. VS Code에서는 프롬프트 입력창 아래의 모드 표시를 클릭해 Plan을 고르고, 데스크톱 앱에서는 모드 선택기를 쓰세요.

   # 플랜 모드로 세션 시작하기
   claude --permission-mode plan
   
   # 또는 세션 안에서 이 프롬프트만 계획하기
   /plan 공개 API에 rate limiting 추가하기

2. 변경 사항을 설명하고 Claude가 탐색하게 두기

   만들거나 고치고 싶은 걸 말해요. Claude는 코드를 읽고 명령을 실행해 조사한 다음 계획을 작성해요. auto 모드를 쓸 수 있으면 나에게 묻는 대신 분류기가 그 명령들을 검토하고, 그렇지 않으면 기본 제공 읽기 전용 명령 외에는 먼저 물어봐요.

3. 계획을 검토하고 수정하기

   Claude의 질문에 답하거나, 반대 의견을 내거나, Ctrl+G를 눌러 텍스트 편집기에서 계획을 열고 직접 고쳐요. 계획은 ~/.claude/plans/ 또는 plansDirectory 설정에 지정한 폴더에 파일로 저장돼요.

4. 승인하거나 계속 계획하기

   Claude가 구현하게 하려면 Yes, and use auto mode(승인하고 auto 모드 사용. auto 모드를 쓸 수 없으면 Yes, auto-accept edits, 즉 편집 자동 수락)를 고르세요. 편집을 하나씩 검토하려면 Yes, manually approve edits(편집을 직접 승인), 더 다듬으려면 No, keep planning(계속 계획)을 고르면 돼요. 승인하면 플랜 모드를 벗어나고, 세션 이름이 계획에 맞춰 붙어요.

5. 승인하지 않고 나가기

   Shift+Tab을 한 번 더 누르면 계획 없이 플랜 모드에서 나가요. 다음 변경을 계획하려면 다시 순환해 돌아오거나 프롬프트 앞에 /plan을 붙이세요.

출처: Claude Code 문서, Choose a permission mode

플랜 모드를 기본값으로 만들기

세션 하나만이라면 claude --permission-mode plan으로 시작하세요. 한 프로젝트의 모든 터미널 세션에 적용하려면 .claude/settings.json에서 defaultMode를 plan으로 설정하고, 내 컴퓨터의 모든 프로젝트에 적용하려면 ~/.claude/settings.json에 넣으세요.

1. 설정에 추가하기

   VS Code 대화는 시작 모드를 프로젝트 설정에서 읽지 않아요. 대신 VS Code 사용자 설정에서 claudeCode.initialPermissionMode를 plan으로 설정하세요.

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

플랜 모드가 제값을 하는 경우

• 여러 파일에 걸친 변경이나, 첫 아이디어가 자주 빗나가는 변경: 마이그레이션, 리팩터링, 프런트엔드와 백엔드에 걸친 새 기능.
• 아직 잘 모르는 코드: 무언가 바꾸기 전에 Claude가 구조를 파악하고 접근 방식을 설명하게 하세요.
• 실수 비용이 큰 곳: 데이터베이스 스키마, 인증, 결제, 공개 API.
• 한 줄짜리 수정이나, 작업을 설명하는 말이 곧 계획인 경우엔 건너뛰세요. 그럴 땐 manual이나 accept edits 모드가 더 빨라요.
• 깨끗한 컨텍스트와 함께 쓰기: showClearContextOnPlanAccept를 켜면 승인할 때 계획 단계의 대화도 지울 수 있어서, 구현이 계획만 가지고 시작돼요.

주의할 점

• 플랜 모드가 막는 건 편집이지 모든 것이 아니에요. auto 모드를 쓸 수 있으면 승인된 셸 명령은 계획 중에도 실행되므로, 부작용이 있는 명령이 실행될 수 있어요.
• bypass permissions를 쓸 수 있는 상태로 시작한 대화형 터미널 세션에서는 플랜 모드의 차단이 강제되지 않아요. Claude는 편집하지 말라는 지시만 받아요.
• 헤드리스 실행(claude -p), Agent SDK 세션, VS Code 채팅 패널에서는 플랜 모드의 차단이 유지돼요.
• VS Code에서 Plan을 고르면 그 대화에만 적용돼요. 새 대화는 평소의 시작 모드로 돌아가요.
• deny 규칙은 플랜 모드를 포함한 모든 모드에서 적용돼요. /plan, /permissions 등의 명령어는 Claude Code 슬래시 명령어를 참고하세요.

플랜 모드는 Claude를 신중하게, Crewmark는 Claude가 계속 일하게 해요.

플랜 모드로 큰 변경의 주도권을 쥘 수 있지만, 세션은 여전히 내가 다음 일을 시작해 주길 기다려요. Crewmark는 Claude Code, Codex, DeepSeek Harness, OpenCode 세션을 직무, 목표, 근무 시간을 가진 AI 직원으로 바꾸고, 하트비트로 깨워서 보드의 다음 이슈를 가져가게 해요.

1. 이슈 댓글로 올라오는 계획

   직원은 위험한 변경 전에 이슈에 계획을 올리고 내 승인을 기다릴 수 있어요. 터미널 대신 보드에서 승인하면 돼요.

2. 하트비트가 일을 시작하게 하기

   근무 시간 동안 직원은 15분, 30분, 60분마다 같은 대화에서 깨어나 다음 이슈를 가져가요. Claude Code를 능동적으로 만드는 방법을 참고하세요.

3. 여러 직원, 하나의 저장소

   직원마다 자기 worktree와 직무를 주세요. AI 직원이란도 읽어 보세요.

Claude Code 플랜 모드 FAQ