Claude Code 플랜 모드 사용법, 수정 전에 계획부터 확인하기

플랜 모드란 무엇인가, 바로 고치지 않고 계획부터 세우는 기능

Claude Code를 처음 쓰다 보면 당황스러운 순간이 있습니다. 간단한 수정을 부탁했는데, 파일 여러 개가 한꺼번에 바뀌어 있는 경우입니다. 분명 한 줄만 고쳐 달라고 했는데 말이죠. AI가 나름대로 "이왕 하는 김에" 주변 코드까지 정리해 버린 겁니다. 결과가 좋으면 다행이지만, 내가 이해하지 못한 변경이 쌓이면 프로젝트 전체가 불안해집니다. 이런 상황을 막아주는 기능이 바로 플랜 모드(Plan Mode)입니다.

플랜 모드는 이름 그대로 계획을 먼저 세우는 모드입니다. 이 모드를 켜면 Claude Code는 파일을 수정하거나 명령어를 실행하지 않습니다. 대신 코드를 읽고 분석만 합니다. 그리고 어떤 파일을 어떻게 바꿀지 계획서를 먼저 보여줍니다. 사용자가 그 계획을 읽고 승인해야만 실제 작업이 시작됩니다. 즉 "분석은 자유롭게, 수정은 허락 후에"라는 원칙이 시스템 차원에서 강제되는 셈입니다. 내가 깜빡하고 확인을 안 해도, 도구 자체가 멈춰서 기다려 준다는 점이 핵심입니다.

비유하자면 이렇습니다. 인테리어 업자에게 집수리를 맡길 때, 바로 벽을 부수는 업자보다 견적서와 시공 계획을 먼저 보여주는 업자가 믿음직합니다. 견적서를 보면 어디를 얼마나 고칠지, 예상 못 한 공사가 끼어 있는지 미리 알 수 있으니까요. 플랜 모드는 그 견적서 단계를 강제로 만들어주는 장치인 셈이네요.

제가 직접 써보니, 플랜 모드는 특히 초보자에게 안전벨트 같은 기능이었습니다. 무엇이 바뀔지 미리 알 수 있으니 결과물을 확인하는 부담이 확 줄었습니다. AI가 코드를 어떻게 이해했는지도 계획서를 통해 미리 드러나기 때문에, 오해가 있으면 실행 전에 바로잡을 수 있었습니다. 다만 간단한 오타 수정까지 계획을 승인하는 건 번거로웠구요. 작업 크기에 따라 켜고 끄는 요령이 필요합니다. 이 글에서는 켜는 방법부터 승인 과정, 그리고 언제 쓰면 좋은지까지 순서대로 정리해 보겠습니다.

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

플랜 모드를 켜는 방법은 아주 간단합니다. Claude Code 실행 중에 키보드에서 Shift+Tab을 누르면 됩니다. 별도의 설치나 설정 파일 수정이 필요 없습니다. 요청을 입력하기 전이라면 언제든 누를 수 있고, 대화 중간에 모드를 바꿔도 문제없이 동작합니다.

Shift+Tab을 누를 때마다 모드가 순서대로 바뀝니다. 기본 모드에서 한 번 누르면 자동 승인 모드(auto-accept)가 되고, 한 번 더 누르면 플랜 모드가 됩니다. 한 번 더 누르면 다시 기본 모드로 돌아오는 순환 구조입니다. 입력창 근처에 현재 모드가 표시되니, "plan mode"라는 문구가 보이는지 확인하면 됩니다. 지금 어떤 모드인지 헷갈릴 때는 이 표시만 보면 되니 외울 것도 없습니다.

 

 

모드가 켜졌다면 평소처럼 요청을 입력하면 됩니다. 예를 들어 "로그인 페이지의 버튼 색상을 바꾸고 관련 스타일을 정리해줘"라고 입력해 봅니다. 플랜 모드에서는 Claude Code가 곧바로 파일을 고치지 않습니다. 관련 파일을 읽고, 수정 대상을 파악하고, 단계별 계획을 정리해서 보여줍니다. 이 과정에서 파일 읽기나 검색 같은 조회 작업은 자유롭게 이뤄지지만, 쓰기 작업은 전부 차단됩니다. 그래서 "혹시 뭔가 바뀌지 않았을까" 하는 걱정 없이 마음 편히 요청을 던질 수 있습니다.

참고로 처음 실행할 때부터 플랜 모드로 시작하는 방법도 있습니다. 터미널에서 claude --permission-mode plan 명령으로 실행하면 됩니다. 매번 Shift+Tab을 누르기 귀찮다면 이 방법이 편하네요. 중요한 프로젝트에서는 아예 이 명령을 기본 실행 습관으로 삼는 것도 좋은 선택입니다.

제 경험상 이 단축키는 손에 익히는 게 중요했습니다. 처음에는 존재 자체를 잊고 기본 모드로만 썼는데, 익숙해진 뒤로는 큰 작업 전에 반사적으로 Shift+Tab을 누르게 됐습니다. 켜는 비용이 1초도 안 되니 부담이 없다는 점이 가장 큰 장점입니다.

계획 승인 과정, 계획서를 읽고 실행을 결정하는 단계

플랜 모드에서 요청을 보내면 Claude Code가 분석을 마친 뒤 계획서를 출력합니다. 계획서에는 보통 수정할 파일 목록, 변경 내용 요약, 작업 순서가 담깁니다. 코드를 잘 모르는 입장이라도 "어떤 파일이 몇 개나 바뀌는지" 정도는 쉽게 파악할 수 있습니다. 전문 용어가 섞여 있어도 파일 이름과 작업 개수만 세어 보면 규모 감각은 충분히 잡힙니다.

계획서 아래에는 선택지가 나타납니다. 계획대로 진행할지, 아니면 계획만 받고 실행은 보류할지 고르는 화면입니다. 여기서 승인하면 Claude Code가 플랜 모드를 벗어나 실제 수정을 시작합니다. 반대로 보류를 선택하면 아무 파일도 바뀌지 않은 상태 그대로 대화를 이어갈 수 있습니다.

 

 

중요한 건 승인 전에 계획을 실제로 읽는 습관입니다. 계획서에서 확인할 포인트는 세 가지입니다. 첫째, 수정 파일 개수가 예상과 비슷한지 봅니다. 한 줄 수정을 부탁했는데 파일 10개가 목록에 있다면 뭔가 잘못 이해한 겁니다. 둘째, 내가 언급하지 않은 파일이 포함됐는지 확인합니다. 셋째, 삭제 작업이 계획에 있는지 살핍니다. 삭제는 되돌리기 어려우니 특히 주의해야 합니다. 이 세 가지만 봐도 큰 사고의 대부분은 걸러집니다.

계획이 마음에 들지 않으면 승인하지 않고 다시 요청하면 됩니다. "3번 단계는 빼고 진행해줘"처럼 계획 자체를 수정시킬 수도 있습니다. 계획을 몇 번이고 다듬은 뒤에 실행하는 것도 가능하니, 처음부터 완벽한 요청을 만들어야 한다는 부담을 가질 필요가 없습니다. 이 과정이 플랜 모드의 핵심입니다.

솔직히 말하면, 계획서를 매번 꼼꼼히 읽는 건 귀찮습니다. 저도 가끔 대충 훑고 승인 버튼을 누르곤 했습니다. 그런데 딱 한 번, 계획서에서 의도하지 않은 파일 삭제를 발견하고 막은 적이 있습니다. 그 한 번의 경험으로 플랜 모드가 왜 필요한지 몸으로 이해하게 됐습니다. 그 뒤로는 파일 목록만큼은 반드시 확인하게 됐네요.

플랜 모드 활용 팁, 언제 켜고 언제 꺼야 할까

플랜 모드가 항상 정답은 아닙니다. 상황에 따라 켜고 끄는 판단이 필요합니다. 제 기준은 작업의 범위와 위험도입니다. 바뀌는 파일이 많거나, 잘못됐을 때 복구가 어려운 작업일수록 플랜 모드의 가치가 커집니다.

플랜 모드를 켜면 좋은 상황은 이렇습니다. 여러 파일에 걸친 큰 수정을 맡길 때, 처음 보는 프로젝트를 다룰 때, 그리고 삭제나 구조 변경처럼 되돌리기 어려운 작업을 시킬 때입니다. 특히 남이 만든 코드를 건드릴 때는 플랜 모드가 거의 필수입니다. Claude Code가 코드를 어떻게 이해했는지 계획서로 먼저 검증할 수 있기 때문입니다. 팀 과제나 공유 프로젝트처럼 내 실수가 다른 사람에게 영향을 주는 상황에서도 큰 안심이 됩니다.

반대로 꺼도 되는 상황도 있습니다. 오타 수정, 문구 변경, 파일 하나짜리 간단한 작업이 그렇습니다. 이런 작업까지 승인 단계를 거치면 오히려 속도만 느려집니다. 결과가 잘못돼도 금방 알아챌 수 있고 되돌리기도 쉬운 작업이라면, 기본 모드로 빠르게 처리하는 편이 효율적입니다.

플랜 모드의 또 다른 활용법은 학습 도구로 쓰는 겁니다. 실행할 생각 없이 계획서만 받아보는 방식입니다. "이 프로젝트에 다크 모드를 추가하려면 뭘 해야 해?"라고 물으면, 파일을 건드리지 않고 작업 설계도만 얻을 수 있습니다. 어떤 파일이 어떤 역할을 하는지, 기능 하나가 코드 몇 군데에 걸쳐 있는지가 계획서에 자연스럽게 드러납니다. 코드 공부를 시작한 입장에서는 이 설계도 자체가 훌륭한 교재가 되네요.

 

 

 

제가 직접 써보니, 플랜 모드는 "속도를 조금 내주고 안전을 크게 얻는" 거래였습니다. 승인 단계가 하나 늘어나는 만큼 작업은 확실히 느려집니다. 하지만 잘못된 수정을 되돌리는 시간과 비교하면 훨씬 이득입니다. 무엇보다 AI에게 일을 맡기면서도 통제권은 내 손에 있다는 감각을 만들어 준다는 점이 가장 큰 수확이었습니다. 아직 Claude Code의 판단을 100% 믿기 어려운 입문 단계라면, 기본값처럼 켜두고 쓰는 걸 추천할 겁니다.