Claude Code 플랜 모드 사용법, 코드 수정 전 계획서 받는 법

Claude Code 입문

Claude Code를 쓰다 보면 당황스러운 순간이 있습니다. 간단히 질문만 했는데, AI가 갑자기 파일을 수정해버리는 경우입니다. 이럴 때 필요한 것이 바로 코드를 고치기 전에 계획서부터 받아보는 플랜 모드(Plan Mode)입니다. 오늘은 플랜 모드가 왜 필요한지, 어떻게 켜고 활용하는지 차근차근 정리해봅니다.

📌 3줄 요약

1. 플랜 모드를 켜면 Claude Code는 코드를 한 줄도 수정하지 않고, 먼저 계획서부터 작성해서 보여줍니다.

2. 입력창에서 Shift+Tab 두 번이면 켜지고, 계획서는 승인 전까지 몇 번이든 수정 요청할 수 있습니다.

3. 되돌리기 어려운 작업일수록 플랜 모드, 오타 수정 같은 간단한 작업은 일반 모드로 골라 쓰는 것이 핵심입니다.

🗂 목차

1. 플랜 모드가 필요한 이유, AI가 먼저 코드를 고칠 때 생기는 문제

2. 플랜 모드 켜는 방법, Shift+Tab 단축키와 실행 순서

3. 계획서 검토와 승인, 수정 요청부터 실행까지

4. 플랜 모드 활용 팁, 실수 줄이는 상황별 사용법

플랜 모드가 필요한 이유, AI가 먼저 코드를 고칠 때 생기는 문제

Claude Code를 쓰다 보면 당황스러운 순간이 있습니다. 간단히 질문만 했는데, AI가 갑자기 파일을 수정해버리는 경우입니다.

"이 코드 어떻게 고치면 좋을까?"라고 물었을 뿐인데, 이미 여러 파일이 바뀌어 있네요. 어디가 어떻게 바뀌었는지 파악하는 데 오히려 시간이 더 걸립니다.

특히 코드에 익숙하지 않은 입문자라면 바뀐 부분을 찾는 것 자체가 큰 부담입니다. 되돌리는 방법을 몰라서 한참을 헤매다가 결국 백업 파일을 찾아 복원하는 일도 생깁니다.

이런 경험이 몇 번 반복되면 AI에게 질문 하나 던지는 것도 조심스러워지는구요.

이 문제를 해결하는 기능이 바로 플랜 모드(Plan Mode)입니다. 플랜 모드를 켜면 Claude Code는 코드를 한 줄도 수정하지 않고, 먼저 계획서부터 작성해서 보여줍니다.

🔍 비유로 이해하기

비유하자면 공사 전에 설계도를 받아보는 것과 같습니다. 설계도를 확인하고 도장을 찍어야만 공사가 시작되는 구조입니다.

인테리어 업체가 벽을 허물기 전에 도면을 먼저 보여주는 것처럼, AI도 작업 전에 무엇을 할지 문서로 제출하는 셈입니다. 도면 단계에서 "이 벽은 남겨주세요"라고 말하는 게, 이미 허문 벽을 다시 세우는 것보다 훨씬 쉽습니다.

플랜 모드에서 Claude Code는 파일을 읽고 검색하는 것만 할 수 있습니다. 파일 수정, 생성, 삭제 같은 위험한 작업은 전부 차단되는구요.

읽기 전용 권한만 남기 때문에 실수로라도 코드가 바뀔 일이 없습니다. AI가 아무리 적극적으로 나서도 시스템 차원에서 수정을 막아주니, 사용자 입장에서는 안심하고 대화에 집중할 수 있습니다.

특히 처음 보는 프로젝트나 중요한 파일을 다룰 때 이 안전장치가 빛을 발합니다.

💬 직접 써본 경험

제가 직접 써보니 초반에는 승인 단계가 번거롭게 느껴졌지만, 예상 밖의 수정 사고가 사라지니 결과적으로 시간이 절약되었습니다.

특히 비개발자 입장에서는 AI가 뭘 하려는지 미리 글로 읽을 수 있다는 점이 가장 큰 장점이네요.

플랜 모드 켜는 방법, Shift+Tab 단축키와 실행 순서

플랜 모드를 켜는 방법은 아주 간단합니다. Claude Code 입력창에서 Shift+Tab 키를 두 번 누르면 됩니다.

1

Shift+Tab을 한 번 누르면 자동 승인 모드(auto-accept)로 바뀝니다.

2

한 번 더 누르면 플랜 모드로 전환됩니다. 화면 하단에 plan mode on 표시가 나타나면 성공입니다.

3

플랜 모드에서 Shift+Tab을 한 번 더 누르면 다시 일반 모드로 돌아옵니다.

세 가지 모드가 순환하는 구조라서, 몇 번 눌러보면 금방 익숙해지는구요. 지금 어떤 모드인지 헷갈릴 때는 화면 하단 표시만 확인하면 됩니다.

 

시작할 때부터 플랜 모드로 실행하는 방법도 있습니다. 터미널에서 claude --permission-mode plan 명령어를 입력하면 처음부터 플랜 모드로 켜집니다.

대화 도중에 단축키를 누르는 것을 깜빡할까 걱정된다면 이 방식이 더 안전합니다. 명령어가 길어 보이지만 터미널의 위쪽 화살표 키로 이전 명령을 불러올 수 있어서 두 번째부터는 편합니다.

💡 설정 파일로 기본값 지정하기

매번 명령어를 치기 귀찮다면 설정 파일에 등록할 수도 있습니다. 프로젝트 폴더의 .claude/settings.json 파일에 기본 모드를 지정해두면, 그 프로젝트에서는 항상 플랜 모드로 시작되는구요.

회사 프로젝트처럼 실수가 허용되지 않는 폴더에만 걸어두는 식으로 프로젝트별로 다르게 운영할 수 있습니다.

플랜 모드가 켜진 상태에서 평소처럼 요청을 입력하면 됩니다. "로그인 버튼이 안 눌리는 문제를 고쳐줘"라고 입력하면, Claude Code는 관련 파일을 읽고 분석만 진행합니다.

요청하는 문장을 특별히 바꿀 필요는 없고, 모드가 알아서 행동 범위를 제한해줍니다. 분석이 끝나면 무엇을 어떻게 고칠지 정리된 계획서가 화면에 출력됩니다.

💬 직접 써본 경험

제가 써본 경험으로는 단축키 전환이 워낙 빨라서, 질문할 때는 일반 모드로 쓰다가 수정 작업 직전에만 플랜 모드로 바꾸는 식으로 오가게 되네요.

⚠️ 다만 Shift+Tab이 일부 터미널에서 다르게 동작하는 경우가 있으니, 안 되면 명령어 방식을 먼저 시도해보시기 바랍니다.

계획서 검토와 승인, 수정 요청부터 실행까지

계획서가 나오면 Claude Code는 실행 여부를 묻는 선택지를 보여줍니다. 보통 "계획대로 진행", "수동으로 승인하며 진행", "계획 수정 요청" 같은 옵션이 표시됩니다.

화살표 키로 원하는 항목을 고르고 엔터를 누르면 되니 조작 자체는 어렵지 않습니다. 처음이라면 "수동으로 승인하며 진행"을 골라서 한 단계씩 확인하며 가는 것도 좋은 방법입니다.

 

여기서 가장 중요한 것은 계획서를 실제로 읽는 습관입니다. 계획서에는 수정할 파일 목록과 변경 내용, 작업 순서가 단계별로 정리되어 있습니다.

💡 검토가 어렵게 느껴진다면

전문 용어가 섞여 있어도 겁먹을 필요는 없습니다. "어떤 파일을 건드리는지"와 "몇 단계로 나눠 작업하는지" 두 가지만 봐도 절반은 검토한 셈이네요.

이해가 안 되는 항목이 있으면 승인 전에 "3번 단계가 무슨 뜻인지 쉽게 설명해줘"라고 물어봐도 됩니다.

읽다가 이상한 부분이 보이면 승인하지 말고 바로 지적하면 됩니다. "3번 단계는 빼고, 설정 파일은 건드리지 마"처럼 구체적으로 말하면 계획서가 다시 작성됩니다.

이 수정 요청은 횟수 제한이 없습니다. 계획이 마음에 들 때까지 몇 번이든 다듬을 수 있는구요.

💬 직접 써본 경험

실제로 저는 한 계획서를 세 번 고친 적도 있는데, 그 과정에서 제가 원하는 결과가 무엇인지 스스로 더 명확해졌습니다. AI와 요구사항을 맞춰가는 회의라고 생각하면 편합니다.

계획을 승인하면 플랜 모드가 해제되면서 실제 코드 수정이 시작됩니다. 이때부터는 승인한 계획서 범위 안에서만 작업이 진행됩니다.

승인 이후에는 계획서가 일종의 계약서 역할을 하기 때문에, AI가 갑자기 엉뚱한 파일을 건드릴 걱정을 덜 수 있습니다. 만약 실행 중에 계획에 없던 작업이 필요해지면, Claude Code가 다시 물어봅니다.

💬 직접 써본 경험

제가 직접 겪어보니 계획서 단계에서 걸러낸 문제가 생각보다 많았습니다. 특히 "이 파일도 같이 고치겠다"는 계획을 보고 미리 막은 적이 여러 번인데, 일반 모드였다면 그대로 수정되고 나서야 알았을 겁니다.

계획서 읽기가 귀찮아도 파일 목록만큼은 꼭 확인하시기 바랍니다.

플랜 모드 활용 팁, 실수 줄이는 상황별 사용법

플랜 모드는 언제 켜는 게 좋을까요. 기준은 간단합니다.

되돌리기 어려운 작업일수록 플랜 모드가 필수입니다. 여러 파일을 한 번에 수정하는 작업, 데이터베이스 관련 코드, 설정 파일 변경이 대표적입니다. 이런 작업은 한 번 잘못되면 원인을 찾는 데만 몇 시간이 걸릴 수 있습니다. 계획서 검토에 드는 1~2분이 복구 작업 몇 시간을 막아준다고 생각하면 계산이 쉽네요.

반대로 오타 수정이나 간단한 질문은 일반 모드가 빠릅니다. 모든 작업에 플랜 모드를 쓰면 승인 단계 때문에 오히려 답답해지네요.

상황	추천 모드	이유
여러 파일 동시 수정, DB 코드, 설정 파일 변경	플랜 모드	한 번 잘못되면 원인 찾기에 몇 시간 소요
오타 수정, 간단한 질문	일반 모드	승인 단계가 오히려 답답해짐
처음 보는 프로젝트 분석·탐색	플랜 모드	수정 걱정 없이 질문 가능

작업의 크기와 위험도에 따라 모드를 골라 쓰는 것이 핵심입니다.

처음 보는 프로젝트를 분석할 때도 플랜 모드가 유용합니다. 수정 기능이 잠겨 있으니, "이 프로젝트 구조를 설명해줘" 같은 탐색 요청을 마음 놓고 던질 수 있습니다.

💬 직접 써본 경험

다른 사람이 만든 코드를 받아서 파악해야 할 때, 실수로 뭔가 바꿀 걱정 없이 질문을 쏟아낼 수 있다는 뜻입니다. 저는 새 프로젝트를 열면 일단 플랜 모드부터 켜고 구조 파악 질문을 던지는 습관이 생겼습니다.

 

💡 무료 설계 상담처럼 쓰는 법

계획서를 받은 뒤 실행하지 않고 대화를 끝내는 활용법도 있습니다. 계획서 내용을 복사해두었다가 나중에 참고 자료로 쓰는 방식인데, 일종의 무료 설계 상담처럼 쓸 수 있는구요.

당장 수정할 시간이 없을 때 계획서만 받아두고, 나중에 그 내용을 붙여넣으며 작업을 이어가면 시간이 절약됩니다.

⚠️ 한 가지 주의할 점

플랜 모드를 해제한 다음 세션에서는 다시 일반 모드로 돌아가므로, 중요한 작업 전에는 하단 표시를 확인하는 습관이 필요합니다.

항상 플랜 모드로 시작하고 싶다면 앞에서 소개한 설정 파일 방식을 활용하는 것이 가장 확실합니다.

✍️ 마치며

제가 한 달 넘게 써본 결론은 이렇습니다. 플랜 모드는 AI를 못 믿어서 쓰는 기능이 아니라, AI와 소통하는 창구에 가깝습니다.

계획서를 읽고 고치는 과정에서 제 요구사항도 명확해지고, 결과물 품질도 눈에 띄게 좋아졌습니다.

Claude Code가 마음대로 움직여서 불안했던 분이라면, 오늘 Shift+Tab 두 번부터 눌러보시기 바랍니다.