Claude Code 플랜 모드 사용법, 코드 수정 전 설계 승인받기

플랜 모드가 필요한 이유, 바로 수정부터 하면 생기는 문제

Claude Code에 작업을 시키면 기본적으로 바로 파일을 수정하기 시작합니다. 간단한 요청이라면 문제가 없습니다. 하지만 파일 여러 개가 얽힌 작업을 시키면 얘기가 달라집니다. 어디를 어떻게 고칠지 모른 채 화면에 수정 내역이 쏟아지는 경험을 하게 됩니다. 수정이 다 끝난 뒤에야 "이게 내가 원한 방향이 맞나?" 하는 의문이 드는 경우도 적지 않습니다. 이미 바뀐 코드를 하나하나 확인하면서 되돌릴지 말지 판단하는 건 생각보다 피곤한 일입니다.
저도 처음에는 이게 편하다고 생각했습니다. 그런데 어느 날 "로그인 부분 정리해줘"라고 시켰더니 예상보다 훨씬 많은 파일이 바뀌어 있었습니다. 되돌리는 데 시간이 더 걸렸구요. 문제는 제가 요청을 잘못한 게 아니라, 요청이 모호할 때 Claude가 나름의 해석으로 범위를 넓혀서 작업했다는 점이었습니다. 사람에게 일을 시킬 때도 방향을 먼저 맞추고 시작하는 게 당연한 것처럼, AI에게도 같은 절차가 필요했던 겁니다. 이런 상황을 막아주는 기능이 바로 플랜 모드(Plan Mode)입니다.
플랜 모드를 켜면 Claude Code는 파일을 수정하지 않습니다. 대신 코드를 읽고 분석해서 "이런 순서로, 이 파일들을, 이렇게 고치겠습니다"라는 계획(plan)을 먼저 보여줍니다. 사용자가 그 계획을 승인해야만 실제 수정이 시작됩니다. 회사에서 일을 시작하기 전에 기획안부터 결재받는 구조와 똑같습니다. 결재 전에는 아무 일도 벌어지지 않으니, 계획이 마음에 들지 않으면 얼마든지 반려하고 다시 받을 수 있습니다. 이 "실행 전 확인" 단계 하나가 작업 전체의 안정감을 크게 바꿔줍니다.
특히 비개발자 입장에서는 코드 수정 내역을 봐도 판단이 어렵습니다. 반면 한글로 정리된 계획은 읽고 판단할 수 있습니다. 제가 직접 써보니 플랜 모드는 코딩 실력보다 판단력이 필요한 기능이었습니다. 계획서를 읽는 건 누구나 할 수 있으니, 오히려 입문자에게 더 유용하다고 느꼈습니다. 코드 diff는 못 읽어도 "회원가입 폼 파일과 검증 파일 두 개를 수정하겠습니다"라는 문장은 읽을 수 있으니까요. 판단할 수 있는 형태로 정보를 받는다는 것, 이게 플랜 모드의 핵심 가치입니다.

플랜 모드 켜는 방법, Shift+Tab 한 번이면 충분

플랜 모드를 켜는 방법은 아주 간단합니다. Claude Code 입력창에서 Shift+Tab 키를 누르면 됩니다. Shift+Tab을 누를 때마다 모드가 순서대로 바뀝니다. 기본 모드에서 한 번 누르면 자동 승인 모드(auto-accept), 한 번 더 누르면 플랜 모드로 전환됩니다. 즉 기본 모드 기준으로 두 번 누르면 플랜 모드가 되는 구조입니다. 순환 방식이라 한 번 더 누르면 다시 기본 모드로 돌아옵니다.
플랜 모드가 켜지면 입력창 아래에 "plan mode on"이라는 표시가 나타납니다. 이 상태에서 입력하는 모든 요청은 계획 수립 단계에서 멈춥니다. 별도의 설정 파일을 건드리거나 명령어를 외울 필요가 없다는 점이 입문자에게 특히 좋습니다.
 

 

명령어로 켜는 방법도 있습니다. 터미널에서 Claude Code를 시작할 때 claude --permission-mode plan이라고 입력하면 처음부터 플랜 모드로 시작됩니다. 매번 Shift+Tab을 누르기 번거롭다면 이 방법이 낫습니다. 중요한 프로젝트를 다룰 때는 아예 이 옵션으로 시작해서, 세션 내내 "일단 계획부터"라는 원칙을 강제하는 것도 좋은 습관입니다.

플랜 모드 상태에서는 Claude가 파일 읽기, 검색 같은 조사 작업만 수행합니다. 수정, 생성, 삭제는 전부 차단됩니다. 실수로 뭔가 바뀔 걱정 없이 마음껏 질문할 수 있다는 뜻이기도 합니다. 그래서 저는 코드를 고칠 생각이 없을 때도 플랜 모드를 켭니다. "이 프로젝트 구조 설명해줘" 같은 탐색성 질문을 던질 때, 혹시라도 Claude가 뭔가를 수정해버릴 가능성을 원천 차단할 수 있기 때문입니다. 읽기 전용 모드라고 생각하면 활용 폭이 훨씬 넓어집니다.
제 경험상 처음에는 모드 전환 자체를 잊어버리는 경우가 많았습니다. 입력창 아래 표시를 확인하는 습관을 들이는 게 중요하네요. 단축키 하나로 켜고 끌 수 있다는 점은 확실히 편했지만, 지금 어떤 모드인지 인지하지 못하면 의미가 없다는 점도 함께 말씀드리고 싶습니다.

계획 검토와 승인, 실제 진행 순서 따라하기

이제 실제로 어떻게 진행되는지 순서대로 보겠습니다. 플랜 모드를 켠 상태에서 작업을 요청합니다. 예를 들어 "회원가입 폼에 이메일 중복 확인 기능을 추가해줘"라고 입력해 보겠습니다. 평소와 똑같이 요청하면 되고, 플랜 모드라고 해서 특별한 문법이 필요하지는 않습니다.
Claude는 먼저 관련 파일들을 읽기 시작합니다. 폼 파일이 어디 있는지, 기존 검증 로직은 어떻게 되어 있는지 조사합니다. 조사가 끝나면 계획을 제시합니다. 계획에는 보통 수정할 파일 목록, 각 파일에서 바꿀 내용, 작업 순서가 담깁니다. 조사 과정이 화면에 그대로 보이기 때문에, Claude가 어떤 파일을 참고해서 판단했는지도 함께 확인할 수 있습니다. 엉뚱한 파일만 읽고 계획을 세웠다면 그 시점에서 바로 방향을 잡아줄 수 있습니다.
 

 
계획이 나오면 화면 하단에 선택지가 표시됩니다. 승인하고 실행할지, 계획을 거부하고 다시 짜게 할지 고를 수 있습니다.
 

 
여기서 중요한 건 거부를 두려워하지 않는 것입니다. "No"를 선택하고 "3번 단계는 빼고, 파일은 하나만 수정하는 방향으로 다시 짜줘"라고 요청하면 계획을 다시 세워줍니다. 계획 단계에서는 아무것도 바뀌지 않았기 때문에 몇 번을 다시 시켜도 부담이 없습니다. 승인 선택지도 두 가지로 나뉜다는 점을 기억해 두시면 좋습니다. auto-accept를 고르면 이후 수정을 일일이 확인하지 않고 진행하고, manually approve를 고르면 수정 하나하나를 다시 확인하면서 진행합니다. 계획을 충분히 다듬었다면 전자를, 아직 조금 불안하다면 후자를 선택하는 식으로 나눠 쓰면 됩니다.
승인하면 플랜 모드가 해제되고 실제 수정이 시작됩니다. 이때 승인한 계획이 컨텍스트(context)에 남아 있어서, Claude가 계획에서 벗어나지 않고 작업을 진행합니다. 제가 직접 써보니 계획을 두세 번 다듬은 뒤에 승인한 작업은 결과물의 완성도가 눈에 띄게 달랐습니다. 다만 계획 수립에 시간이 추가로 들기 때문에, 한 줄짜리 수정에까지 플랜 모드를 쓰는 건 오히려 비효율적이었습니다.

플랜 모드 활용 팁, 언제 켜고 언제 끌 것인가

플랜 모드를 언제 쓸지 기준을 세워두면 좋습니다. 제 기준은 세 가지입니다. 첫째, 수정 대상 파일이 3개 이상일 것 같을 때입니다. 둘째, 기존 코드 구조를 잘 모르는 프로젝트를 다룰 때입니다. 셋째, 되돌리기 어려운 작업일 때입니다. 이 세 경우에는 무조건 플랜 모드부터 켭니다. 특히 두 번째 경우가 중요한데, 남이 만든 프로젝트나 오래된 코드를 다룰 때는 Claude의 조사 결과 자체가 훌륭한 구조 설명서가 되어주기 때문입니다. 계획을 받아보는 것만으로 프로젝트 이해도가 올라가는 부수 효과도 있습니다.
반대로 오타 수정, 문구 변경, 단일 파일의 간단한 수정은 기본 모드로 바로 처리하는 편이 빠릅니다. 계획서 받고 승인하는 시간이 작업 시간보다 길어지면 배보다 배꼽이 큰 상황이 되네요. 작업 규모에 따라 모드를 골라 쓰는 감각은 몇 번 써보면 자연스럽게 생기니, 처음에는 "애매하면 플랜 모드"라는 기준 하나만 가져가셔도 충분합니다.
계획을 검토할 때 확인할 포인트도 정리해 드리겠습니다. 수정 파일 목록에 예상 밖의 파일이 있는지 먼저 봅니다. 요청하지 않은 작업이 계획에 슬쩍 들어가 있는 경우가 있기 때문입니다. 그리고 작업 순서가 논리적인지 봅니다. 테스트나 확인 단계가 계획에 포함되어 있으면 더 좋습니다. 반대로 계획이 지나치게 짧거나 뭉뚱그려져 있다면, 승인하기 전에 "각 단계에서 어떤 파일을 어떻게 바꾸는지 더 구체적으로 써줘"라고 요청하는 게 안전합니다. 구체적인 계획일수록 실행 결과도 예측 가능해집니다.
한 가지 팁을 더 드리면, 계획 자체를 저장해두는 방법이 있습니다. 계획이 마음에 들면 "이 계획을 plan.md 파일로 저장해줘"라고 요청한 뒤 승인하면 됩니다. 나중에 비슷한 작업을 할 때 이 파일을 보여주면 같은 방식으로 진행해 줍니다. 팀원이나 미래의 나에게 "이 작업은 이런 설계로 진행했다"는 기록을 남기는 효과도 있어서, 저는 규모가 있는 작업은 습관적으로 계획을 파일로 남기고 있습니다.
제가 한 달 넘게 써본 결론은 이렇습니다. 플랜 모드는 Claude Code의 속도를 늦추는 기능이 아니라, 실패한 작업을 되돌리는 시간을 없애주는 기능이었습니다. 특히 코드를 읽는 게 익숙하지 않은 분일수록, 수정 결과 대신 계획을 검토하는 방식이 훨씬 안전합니다. 처음에는 번거롭게 느껴져도 큰 작업 전에 Shift+Tab 두 번 누르는 습관, 꼭 들여보시길 권합니다.