Claude Code에 큰 작업을 바로 시키면 파일 수십 개가 엉뚱하게 바뀌고, 결국 처음부터 다시 시작해야 할 때가 있습니다. 플랜 모드를 활용하면 실행 전에 설계부터 마치고, 안전하게 코드를 수정할 수 있습니다.
📌 3줄 요약
- 플랜 모드는 코드를 수정하기 전에 작업 계획을 먼저 세우는 기능으로,
Shift+Tab으로 진입합니다. - 파일 간 의존성을 분석하고 수정 순서를 정리해주기 때문에, 여러 파일에 걸친 작업에서 실수를 크게 줄여줍니다.
- 플랜을 단계별로 나눠 실행하고, 중간에 방향을 수정할 수 있어 대규모 작업에서도 안전합니다.
플랜 모드가 필요한 이유와 기본 개념
Claude Code에 큰 작업을 바로 시키면 어떤 일이 벌어질까요. 파일 수십 개를 한꺼번에 수정하다가, 의도와 다른 방향으로 코드가 바뀌는 경우가 생깁니다.
⚠️ 특히 서로 연결된 파일들이 많을수록 한 곳을 잘못 건드리면 다른 곳에서 에러가 연쇄적으로 터집니다. 이런 상황을 겪고 나면 결국 git checkout으로 전부 되돌리고 처음부터 다시 시작해야 합니다.
플랜 모드(Plan Mode)는 코드를 수정하기 전에 작업 계획을 먼저 세우는 기능입니다. 실행은 잠시 멈추고, "어떤 파일을 어떤 순서로 바꿀 것인지" 설계만 하는 단계라고 보면 됩니다.
Claude Code가 프로젝트 전체를 분석해서 영향받는 파일을 파악하고, 수정 순서까지 정리해주는 것이 핵심입니다.
🔍 일반 모드에서는 Claude Code가 질문을 받자마자 파일을 읽고, 수정하고, 저장까지 한 번에 진행합니다. 반면 플랜 모드에서는 파일을 읽고 분석하되, 실제 편집 도구는 사용하지 않습니다.
쉽게 말해 "눈으로만 보고 손은 대지 않는" 상태입니다. 이 차이가 작아 보이지만, 실수를 방지하는 데 큰 효과를 발휘합니다.
비유하자면 건물을 짓기 전에 설계도를 먼저 그리는 것과 같습니다. 설계도 없이 바로 벽돌을 쌓으면 나중에 벽을 허물고 다시 쌓아야 하는 상황이 생기겠죠. 소프트웨어 개발에서도 마찬가지입니다.
전체 구조를 먼저 파악하고 작업 순서를 정해야 불필요한 재작업을 줄일 수 있습니다.
특히 리팩터링(refactoring)처럼 여러 파일에 걸친 작업에서 플랜 모드가 빛을 발합니다. 어떤 함수를 옮기고, 어떤 import를 수정해야 하는지 전체 그림을 먼저 파악할 수 있습니다.
새로운 기능을 추가할 때도 기존 코드와 충돌하는 부분을 미리 확인할 수 있어서, 작업 중간에 방향을 급하게 바꾸는 일이 줄어듭니다.
💬 제가 직접 써보니, 플랜 없이 바로 실행했을 때보다 수정 후 되돌리는 횟수가 눈에 띄게 줄었습니다. 다만 간단한 작업까지 플랜 모드를 쓰면 오히려 시간만 더 걸리니, 파일 3개 이상 수정이 예상되는 작업에서 사용하는 것을 추천합니다.
플랜 모드 진입 방법과 설계 요청하기
플랜 모드에 진입하는 방법은 간단합니다. Claude Code 입력창에서 Shift+Tab 키를 누르면 모드가 전환됩니다.
별도의 명령어를 입력할 필요 없이 단축키 한 번이면 됩니다. 전환할 때마다 일반 모드(Act Mode)와 플랜 모드(Plan Mode)가 번갈아 바뀝니다.
입력창 왼쪽에 표시되는 모드 아이콘이 바뀌는 것을 확인할 수 있습니다. 일반 모드에서는 연필 아이콘이, 플랜 모드에서는 돋보기 아이콘이 나타납니다.
현재 어떤 모드인지 항상 시각적으로 확인할 수 있으니, 모르고 잘못된 모드에서 작업하는 실수를 방지할 수 있습니다.
모드를 전환한 뒤에는 작업 내용을 구체적으로 설명하면 됩니다. 예를 들어 "사용자 인증 모듈을 JWT 방식으로 리팩터링해줘"라고 입력합니다.
💡 단순히 "리팩터링해줘"보다는 어떤 방식으로 바꾸고 싶은지 명시하는 것이 좋습니다. 구체적으로 요청할수록 Claude Code가 더 정확한 계획을 세워줍니다.
그러면 Claude Code가 프로젝트 구조를 분석하고, 수정이 필요한 파일 목록과 변경 순서를 정리해서 보여줍니다. 이 단계에서는 파일을 읽기만 할 뿐, 실제로 코드를 수정하지는 않습니다.
각 파일에서 어떤 부분을 어떻게 바꿀 것인지 구체적인 설명이 포함되어 있어서, 실행 전에 방향이 맞는지 검토할 수 있습니다.
설계 결과가 마음에 들지 않으면 추가 질문을 할 수 있습니다. "이 방식 대신 미들웨어 패턴으로 바꿔줘"처럼 방향을 수정하면, Claude Code가 플랜을 다시 작성합니다.
플랜을 여러 번 수정해도 실제 코드에는 영향이 없으니, 마음껏 방향을 조정해보세요. 설계 단계에서 충분히 고민하는 것이 결국 시간을 절약하는 길입니다.
💬 제가 직접 써보니, 처음 요청할 때 "파일별로 변경 사항을 정리해줘"라고 한 줄 추가하면 훨씬 체계적인 플랜이 나옵니다. 반대로 모호하게 요청하면 플랜도 모호해지니, 입력을 구체적으로 작성하는 것이 핵심입니다.
설계한 플랜을 실제 코드에 적용하기
플랜이 만족스럽다면 이제 실행 단계로 넘어갑니다. 다시 Shift+Tab을 눌러 일반 모드(Act Mode)로 전환합니다.
모드 아이콘이 돋보기에서 연필로 바뀌면 실행 준비가 완료된 것입니다.
모드를 전환한 뒤 "위 플랜대로 실행해줘"라고 입력하면 됩니다. Claude Code가 아까 세운 계획을 그대로 따라가며 파일을 수정합니다.
플랜에서 정한 순서대로 진행되기 때문에, 파일 간 의존성 문제가 발생할 가능성이 낮습니다. 만약 플랜에 없던 파일을 수정하려고 하면 그때 별도로 알려주니, 계획 범위를 벗어나는 변경도 사전에 감지할 수 있습니다.
실행 중에도 각 파일 수정 전에 승인을 요청하기 때문에, 원치 않는 변경을 중간에 거부할 수 있습니다. 한 파일씩 diff를 확인하며 진행하는 방식이라 안전합니다. diff 화면에서 초록색은 추가된 코드, 빨간색은 삭제된 코드를 나타내니, 변경 내용을 한눈에 파악할 수 있습니다. 예상과 다른 변경이 보이면 바로 거부하고 플랜을 수정하면 됩니다.
만약 실행 도중 계획을 수정하고 싶다면, 다시 플랜 모드로 돌아가면 됩니다. 이미 수정한 파일은 그대로 유지되고, 남은 작업에 대한 플랜만 다시 세울 수 있습니다.
이 방식 덕분에 중간에 방향을 틀어도 처음부터 다시 시작할 필요가 없습니다.
🔍 대규모 작업에서는 플랜을 단계별로 나눠서 실행하는 것도 좋은 방법입니다. 예를 들어 "1단계: 데이터베이스 스키마 변경"까지만 실행하고, 결과를 확인한 뒤 "2단계: API 엔드포인트 수정"으로 넘어가는 식입니다.
각 단계가 끝날 때마다 테스트를 돌려보면 문제를 조기에 발견할 수 있습니다. 한꺼번에 모든 것을 바꾸고 나서 에러를 추적하는 것보다 훨씬 효율적입니다.
💬 제가 직접 써보니, 플랜 전체를 한 번에 실행하는 것보다 단계별로 끊어서 실행하는 것이 실수를 줄이는 데 효과적이었습니다. 특히 파일이 10개 이상인 작업에서는 중간 점검이 필수입니다.
플랜 모드 실전 활용 팁과 주의사항
플랜 모드가 특히 유용한 작업 유형이 있습니다. 폴더 구조 변경, 함수 이름 일괄 수정, 새로운 기능 추가처럼 여러 파일이 연쇄적으로 영향받는 작업에서 효과가 큽니다.
테스트 코드를 새로 작성하거나 기존 테스트를 리팩터링할 때도 플랜 모드로 전체 구조를 먼저 잡으면 누락 없이 진행할 수 있습니다.
반대로 오타 수정이나 한 줄짜리 버그 픽스에는 플랜 모드가 오히려 번거롭습니다. 바로 일반 모드에서 처리하는 것이 빠릅니다.
변경 범위가 파일 1~2개에 한정된 작업이라면 굳이 플랜을 세울 필요가 없습니다. 작업의 규모와 복잡도를 먼저 판단하고, 플랜 모드 사용 여부를 결정하세요.
| 플랜 모드 추천 | 일반 모드로 충분 |
|---|---|
| 리팩터링 (파일 3개 이상) | 오타 수정 |
| 폴더 구조 변경 | 한 줄 버그 픽스 |
| 새로운 기능 추가 | 파일 1~2개 수정 |
| 함수 이름 일괄 수정 | 간단한 스타일 변경 |
💡 플랜을 요청할 때는 제약 조건을 함께 알려주면 좋습니다. "기존 API 인터페이스는 유지하면서 내부 구현만 바꿔줘"처럼 경계를 명확히 하면, Claude Code가 더 정확한 계획을 세웁니다.
"성능 최적화가 목적이야", "하위 호환성을 깨지 마" 같은 조건을 추가하면 플랜의 품질이 확실히 올라갑니다. 제약 조건 없이 요청하면 Claude Code가 스스로 판단해야 하는 영역이 넓어져서, 의도와 다른 방향의 플랜이 나올 수 있습니다.
⚠️ 한 가지 주의할 점은, 플랜 모드에서 세운 계획이 항상 완벽하지는 않다는 것입니다. 실행 단계에서 예상치 못한 의존성이 발견될 수 있으니, diff를 꼼꼼히 확인하는 습관이 중요합니다.
플랜이 길어질수록 후반부의 정확도가 떨어질 수 있으므로, 앞서 설명한 단계별 실행 방식을 적극 활용하세요.
/compact 명령어와 함께 사용하면 더 효율적입니다. 플랜 작성 후 컨텍스트(context)가 길어졌다면, /compact로 대화를 압축한 뒤 실행 단계로 넘어가면 토큰(token)을 절약할 수 있습니다.
토큰이 부족해지면 Claude Code의 응답 품질이 떨어질 수 있기 때문에, 대규모 작업일수록 /compact를 중간중간 사용하는 것이 좋습니다.
💬 제가 직접 써보니, 플랜 모드의 가장 큰 장점은 "되돌리기 횟수 감소"였습니다. 설계 없이 바로 실행했을 때 평균 2~3번 git checkout으로 되돌리던 작업이, 플랜을 세운 뒤에는 대부분 한 번에 완료되었습니다.
처음에는 플랜 작성이 번거롭게 느껴질 수 있지만, 한두 번 경험하면 오히려 플랜 없이는 불안해질 정도로 유용한 기능입니다.
✍️ 마치며
Claude Code의 플랜 모드는 "먼저 설계하고, 그다음 실행하는" 안전한 작업 방식을 제공합니다. Shift+Tab으로 진입해서 계획을 세우고, 만족스러우면 다시 일반 모드로 돌아와 실행하면 됩니다. 파일 3개 이상 수정이 필요한 작업이라면 플랜 모드를 적극 활용해보세요. 되돌리기 없는 깔끔한 작업 경험을 할 수 있을 것입니다.
'Claude Code 시작하기' 카테고리의 다른 글
| Claude Code MCP 서버 연결로 외부 데이터 가져오는 법 (0) | 2026.07.25 |
|---|---|
| Claude Code 서브에이전트로 병렬 작업 시작하기 (0) | 2026.07.23 |
| 서브에이전트 병렬 실행으로 조사 시간 절반 줄이기 (0) | 2026.07.22 |
| Claude Code MCP로 노션·구글 시트 연결하는 가장 쉬운 방법 (0) | 2026.07.21 |
| Claude Code 메모리 기능, AI가 내 프로젝트를 기억하게 만드는 법 (0) | 2026.07.21 |
