클로드 코드 플랜 모드(Plan Mode) 활용하기: 실행 전 검토 단계
Claude Code에서 파일을 바꾸기 전에 자료를 살피고 변경 계획을 검토하는 모드입니다. 계획을 승인해 실행으로 전환한 뒤 실제 결과를 확인합니다.
같은 말:Plan Mode플랜 모드검토 모드
🤔 바꾸기 전에 무엇을 할지 보고 싶다면
‘메모를 보기 좋게 정리해 줘’라고 요청했는데 원본을 고칠지 새 파일을 만들지 정하지 않았다면 결과가 예상과 다를 수 있습니다. Plan Mode, 계획 모드는 실행 전에 자료를 살피고 어떤 파일을 어떻게 바꿀지 검토하는 기능입니다.
작업을 요청하기 전에 계획 모드에 들어갑니다. 실행을 이미 시작한 뒤 모드를 바꾼다고 이전 변경이 되돌아가지는 않습니다.
🔑 계획 모드가 하는 일
보통 자료를 읽고 필요한 조사를 한 뒤 계획을 제안합니다. 이때 일반 소스 파일 편집은 제한되지만 계획 파일 작성과 허용된 조사 명령 실행은 가능합니다. ‘컴퓨터의 어떤 파일도 절대 바꾸지 않는 격리 환경’이라는 뜻은 아닙니다. 권한 우회가 활성화된 특수 설정에서는 편집 제한에도 예외가 있으므로 초보 연습에는 그런 설정을 사용하지 않습니다.
흐름은 계획 모드 진입 → 작업 요청 → 계획 수정과 검토 → 승인 후 실행 → 실제 결과 확인입니다. 계획이 그럴듯한 것과 결과가 맞는 것은 별개입니다.
📝 메모 하나로 계획과 실행 구분하기
설치 수업에서 만든 claude-practice 폴더와 notes.txt를 사용합니다. 텍스트 편집기로 연습 메모를 아래 내용에 맞춰 저장합니다. 회사의 실제 문서는 사용하지 않습니다.
10월 12일 오후 2시에 모입니다.
장소는 아직 정하지 않았습니다.
준비물은 책 한 권입니다.1. 먼저 계획 모드에 들어갑니다
터미널에서 같은 폴더로 이동한 뒤 아래 명령으로 시작할 수 있습니다. 이미 Claude Code가 실행 중이면 대화 입력창에 /plan을 넣습니다.
claude --permission-mode plan화면에 계획 모드가 표시되는지 확인하고 다음 요청을 보냅니다. Shift+Tab도 모드를 순서대로 전환하는 단축키이지만 한 번 누르면 언제나 계획 모드가 되는 것은 아닙니다. 현재 표시를 보고 확인합니다.
notes.txt를 읽고 summary-plan.txt라는 새 파일에 날짜와 시각, 장소, 준비물을 세 줄로 정리하고 싶어.
아직 실행하지 말고 계획을 보여 줘.
원본 notes.txt는 그대로 두고 다른 파일은 바꾸지 마.
결과 파일이 이미 있으면 덮어쓰지 말고 알려 줘.
바꿀 파일 경로와 실행 뒤 확인할 항목을 한국어로 적어 줘.2. 계획에서 세 가지를 확인합니다
| 확인할 것 | 이 연습에서 맞는 계획 |
|---|---|
| 읽을 자료 | 현재 연습 폴더의 notes.txt |
| 바꿀 대상 | 새 summary-plan.txt 하나이며 원본 보존 |
| 확인 방법 | 날짜와 시각, 장소 미정, 책 한 권을 원문과 대조 |
새 프로그램 설치, 폴더 전체 정리, 외부 서비스 연결은 이 작업에 필요하지 않습니다. 그런 단계가 있으면 승인하지 않고 ‘메모 하나만 읽고 새 파일 하나를 만드는 계획으로 줄여 줘’라고 요청합니다.
3. 검토한 계획을 승인합니다
승인 화면에서 실행으로 넘어갈지 계속 계획할지 선택합니다. 영어 화면의 Yes는 실행 승인이고 No, keep planning은 계속 계획한다는 뜻입니다. 처음에는 manually approve edits처럼 편집을 직접 승인하는 선택지가 있으면 그것을 사용해 대상 파일을 확인합니다. 화면 문구는 버전에 따라 달라질 수 있습니다. ‘계속 계획하기’는 실행 승인이 아닙니다.
계획을 승인하면 계획 모드를 나와 작업을 시작합니다. 승인 이후의 도구 사용은 선택한 권한 모드와 설정에 따릅니다. 항상 파일마다 다시 물어본다고 가정하지 않습니다. 모드 전환 자체와 계획 승인은 구분합니다.
4. 실제 파일을 열어 봅니다
Finder나 파일 탐색기에서 summary-plan.txt를 열어 10월 12일 오후 2시 / 장소 미정 / 책 한 권이 있는지 봅니다. notes.txt도 열어 원문이 그대로인지 확인합니다.
답변에 ‘완료’라고만 나오고 파일이 없으면 저장 경로를 확인합니다. 다른 내용이 있으면 원문의 해당 줄을 짚고 결과 파일만 고치도록 요청합니다. 예상하지 못한 변경이 진행 중이면 Esc로 중단하고 이미 바뀐 파일부터 확인합니다. 중단은 이전 변경의 자동 복원이 아닙니다. 계획 승인까지 했다고 검증이 끝난 것은 아닙니다.
💼 어떤 작업에서 특히 도움이 되나요?
파일 수만으로 결정하지 않습니다. 여러 파일의 관계를 모르거나 기존 데이터를 옮기거나 설정을 바꿀 때 영향 범위를 먼저 확인하는 데 유용합니다. 한 파일의 작은 수정도 중요한 계산이나 권한을 바꾸면 계획이 필요할 수 있습니다.
단순 오타처럼 범위와 확인 방법을 이미 아는 작은 수정은 긴 계획서가 필요하지 않을 수 있습니다. 모르는 용어가 있으면 ‘이 단계가 어떤 파일에 어떤 영향을 주는지 설명해 줘’라고 물어봅니다.
📚 여러 문서로 넓히면 무엇을 보나요?
아래 그림은 블로그 문서 47개의 형식을 바꾸려는 예입니다. H1과 H2는 마크다운에서 # 제목과 ## 제목으로 쓰는 제목 단계입니다. 최상위 제목을 모두 내리는 것이 실제 사이트의 구조에 맞는지 먼저 확인해야 합니다.
47개는 예시의 문서 수입니다. 먼저 사본 한 개에서 제목 구조와 화면을 확인하고 나머지를 처리할 범위를 정합니다.
‘모두 알아서 정리’ 대신 적용할 형식, 제외할 파일과 확인 기준을 적습니다. 일괄 변경은 일부 결과를 검토한 뒤 나누어 진행할 수 있습니다. 특정 파일 수나 짧은 예상 시간만으로 안전성과 성공을 판단하지 않습니다.
외부 도구나 데이터베이스에 영향을 주는 단계가 있으면 대상과 권한을 확인합니다. 계획 모드는 백업이나 되돌리기 절차를 대신하지 않습니다.
🔁 조건을 바꿔 다시 계획하기
연습 메모의 장소를 도서관 2층으로 바꾸고 저장합니다. /plan으로 다시 계획 모드에 들어간 뒤 같은 작업을 요청하되 결과 이름을 summary-plan-v2.txt로 지정합니다.
이번 계획에 기존 결과 덮어쓰기가 없는지 확인하고 승인합니다. 새 파일의 장소는 도서관 2층이어야 하며 날짜와 준비물은 그대로여야 합니다. 두 결과를 열어 비교하고 ‘계획에서 확인한 것’과 ‘실행 뒤 확인한 것’을 각각 설명해 봅니다.
📋 3줄 요약
-
계획 모드는 작업을 요청하기 전에 들어가 읽을 자료와 바꿀 파일 및 확인 방법을 검토하는 기능입니다.
-
작은 메모를 새 파일로 정리하는 계획부터 확인하고 원본 보존과 작업 범위가 맞을 때 실행을 승인합니다.
-
실행 뒤 실제 파일을 원문과 비교하며 계획 모드만으로 모든 변경과 외부 영향을 막는다고 가정하지 않습니다.
📚 참고 자료
2026년 10월 3일 공식 자료를 확인했습니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
모임 메모를 별도 파일로 정리하려는데 계획에 원본 삭제가 포함돼 있습니다. 어떻게 하나요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.
