클로드 코드 계획 모드 사용법, 코드 전에 물어볼 것

코드를 건드리지 않고 프로젝트부터 읽게 할 수 있습니다.

낯선 파일을 고치려는데 어디부터 손대야 할지 막막했다면, 먼저 계획만 받는 편이 훨씬 편할 수 있습니다. 연휴에 개인 프로젝트의 다음 작업을 정리할 때도 써먹기 좋죠.

핵심 내용

Plan Mode에서는 Claude Code가 파일을 읽고 질문에 답하지만, 파일을 바꾸지는 않습니다.
Shift+Tab으로 Plan Mode에 들어간 뒤 구현 계획을 요청하고, Ctrl+G로 계획 문서를 직접 고칠 수 있습니다.
작은 오타 수정이나 변수 이름 변경처럼 범위가 뚜렷한 일은 계획 단계를 건너뛰고 바로 요청해도 됩니다.
계획이 필요한 작업이라면 완료 여부를 확인할 방법도 함께 알려 주는 편이 좋습니다. 테스트나 실행 결과처럼 확인할 기준을 주면 됩니다.

왜 코드부터 맡기면 불안할까

낯선 프로젝트에서 “이 기능을 고쳐 주세요”라고 곧바로 요청했다가, 생각지 못한 파일까지 바뀔까 걱정한 적 있으시죠? 여러 파일이 얽힌 수정은 첫 방향부터 어긋나면 되돌리는 데도 시간이 걸립니다. 코딩에 익숙하지 않은 기획자나 1인 개발자라면 변경 내용을 읽고 판단하는 일 자체가 부담스럽고요.

Claude Code의 Plan Mode는 실행과 검토를 나눠 주는 장치입니다. 이 모드에서는 파일을 읽고 구조를 파악하거나 질문에 답할 수 있지만, 실제 파일을 바꾸지는 않습니다. 현재 코드가 어떻게 연결돼 있는지, 어느 파일을 손봐야 할지 먼저 확인한 뒤 사람이 계획을 승인하고 구현으로 넘어가는 방식입니다.

접근 방법이 아직 확실하지 않을 때 특히 잘 맞습니다. 한 기능이 여러 파일에 걸쳐 있거나 처음 보는 코드라면, 계획부터 받아 보세요. 어떤 파일을 왜 바꿀지, 어떤 순서로 처리할지가 계획에 담기니 단순히 결과만 받는 것보다 검토할 재료가 생깁니다.

반대로 모든 일에 Plan Mode가 필요한 건 아닙니다. 오타 하나를 고치거나 로그 한 줄을 추가하는 일, 변수 이름만 바꾸는 정도라면 바로 수정해 달라고 해도 됩니다. 바뀔 내용을 한 문장으로 또렷하게 말할 수 있다면 계획 단계는 건너뛰는 편이 낫습니다. 작은 일을 굳이 크게 만들 필요는 없거든요.

💡 꿀팁 · 변경 내용을 한 문장으로 설명하기 어렵다면, 바로 수정시키기보다 Plan Mode부터 켜세요.

클로드 코드 계획 모드 사용법

먼저 Claude Code를 열고 작업할 프로젝트에서 Shift+Tab을 누릅니다. 상태 표시줄에 “plan mode on”이 보이면 계획 모드에 들어간 상태입니다. 터미널에서 처음 시작한다면 `claude --permission-mode plan` 명령으로 계획 모드 세션을 열 수도 있습니다.

그다음에는 작업을 짧게 던지기보다 목표와 범위를 함께 적어 주세요. 화면에서 보이는 문제라면 관련 파일을 지정하고, 원하는 동작과 건드리지 말아야 할 부분을 적는 식입니다. Claude Code는 파일을 살핀 뒤 질문에 답하거나 실행 계획을 제안합니다. 이 단계에서는 파일이 수정되지 않으니 부담 없이 구조를 확인할 수 있습니다.

계획을 받았다면 구현 계획을 조금 더 자세히 써 달라고 요청하세요. 화면에 계획이 나왔을 때 Ctrl+G를 누르면 텍스트 편집기에서 그 계획을 열어 직접 손볼 수 있습니다. 순서를 바꾸고, 제외할 파일을 적고, 확인 방법도 덧붙일 수 있죠. 사람에게 줄 업무 지시서를 다듬는다고 생각하면 쉽습니다.

내용이 맞다고 판단하면 계획을 승인하거나 Shift+Tab을 다시 눌러 Plan Mode를 끝냅니다. 이후 Claude Code에 계획대로 구현해 달라고 요청하면 됩니다. 수정이 끝났다는 말만 듣기보다, 어떤 확인을 실행했고 결과가 무엇이었는지 보여 달라고 하세요. 확인 기준이 있어야 Claude Code도 작업을 마칠 시점을 더 분명히 판단합니다.

💡 꿀팁 · 계획을 받은 직후 Ctrl+G를 눌러, 구현 전에 제외할 파일과 확인 방법을 계획에 직접 넣어 두세요.

계획 요청은 이렇게 쓰세요

계획 모드는 막연한 부탁보다 구체적인 배경을 줄수록 쓸모가 커집니다. Claude Code가 마음을 읽는 것은 아니니, 목표 파일과 제한 조건을 알려 주는 편이 좋습니다. 파일 위치를 안다면 `@`를 붙여 파일을 가리킬 수 있습니다. 파일 내용을 길게 옮겨 적는 대신 해당 파일을 참조하게 하는 방식입니다.

처음 맡기는 일이라면 현재 구조를 묻는 질문부터 시작해도 좋습니다. 답을 받은 뒤 설명이 맞는지 확인하고 다음 요청으로 넘어가면 됩니다. 프로젝트 구조 파악과 실제 구현을 한 번에 섞지 않는 게 핵심입니다. 계획이 엉뚱하다면 구현 전에 멈추고 방향을 바꾸면 되니까요.

아래 문장은 필요한 부분만 바꿔 바로 써도 됩니다. 첫 문장은 변경 범위를 확인할 때, 둘째 문장은 계획에서 빠진 조건을 찾을 때, 셋째 문장은 구현 뒤 확인 절차까지 묶고 싶을 때 알맞습니다.

“@src 파일을 읽고 로그인 오류 문구를 바꾸려면 어떤 파일을 수정해야 하는지, 아직 코드는 바꾸지 말고 계획으로 설명해 주세요.”

“이 기능을 추가하는 계획을 작성해 주세요. 기존 동작은 유지하고, 바뀌는 파일과 각 파일의 변경 이유를 먼저 알려 주세요.”

“계획을 승인한 뒤 구현해 주세요. 작업 후에는 실행한 확인 명령과 그 결과를 보여 주세요.”

💡 꿀팁 · 파일 위치를 안다면 요청문에 `@파일경로`를 넣어, 설명 대신 Claude Code가 그 파일을 먼저 읽게 하세요.

계획이 길어지거나 빗나갈 때

계획을 세웠는데 Claude Code가 원하지 않는 방향으로 읽거나 수정하려 한다면 끝까지 기다릴 필요는 없습니다. Esc를 누르면 진행 중인 작업을 멈출 수 있고, 이미 쌓인 대화 내용은 남아 있으니 곧바로 방향을 다시 줄 수 있습니다. 변경 자체를 되돌리고 싶다면 “Undo that”이라고 요청하는 방법도 있습니다.

여러 번 수정을 요청하다 보면 대화가 복잡해집니다. Claude Code의 대화 공간에는 메시지뿐 아니라 읽은 파일과 명령 결과도 쌓입니다. 내용이 많아질수록 이전 지시를 놓치거나 실수할 가능성이 있으므로, 관련 없는 작업으로 넘어갈 때는 `/clear`로 새 대화를 시작하는 편이 좋습니다. 이전 시행착오를 반영해 더 구체적인 요청을 새로 쓰는 쪽이 낫습니다.

긴 작업에서 핵심만 남기고 싶다면 `/compact` 뒤에 남길 주제를 적을 수 있습니다. 예를 들어 API 변경 내용에만 집중하게 만들 수 있습니다. 아주 짧은 확인 질문은 `/btw`로 물으면 대화 기록에 들어가지 않아 대화 공간을 늘리지 않습니다. 계획을 받는 세션에서도 불필요한 탐색을 줄이는 데 도움이 됩니다.

계획은 승인 문서일 뿐, 결과 보증서는 아닙니다. 구현 단계에서는 테스트, 빌드 결과, 출력 비교, 화면 확인처럼 통과와 실패를 구분할 방법을 함께 요청하세요. Claude Code가 성공했다고 말하는 것보다 실행한 명령과 결과를 보여 주게 하는 편이 검토하기 쉽습니다.

💡 꿀팁 · 같은 문제를 두 번 이상 고쳐 달라고 했다면 `/clear` 후, 배운 조건을 넣은 새 요청으로 다시 시작하세요.

그래서 나에게 무엇이 달라질까

계획 모드를 쓰면 코드를 직접 작성하지 않아도 변경 범위와 이유를 먼저 읽고 결정할 수 있습니다. 낯선 프로젝트에서 무작정 수정하는 불안을 줄이고, 검토와 구현을 분리하는 업무 습관도 만들 수 있죠. 작은 수정은 빠르게 처리하고 큰 수정은 계획으로 통제하는 기준이 생깁니다.

내일 바로 써먹기

Claude Code에서 Shift+Tab을 눌러 “plan mode on” 상태를 만든 뒤, 현재 프로젝트의 작은 개선 하나를 코드 변경 없이 설명해 달라고 요청하세요.
계획을 받은 뒤 Ctrl+G로 열어 바꾸면 안 되는 파일과 작업 완료를 확인할 방법을 한 줄씩 추가하세요.
구현을 맡길 때는 “작업 후 실행한 확인 명령과 결과를 보여 주세요”라는 문장을 함께 넣으세요.

용어사전

Plan Mode · Claude Code가 프로젝트를 읽고 계획을 세우되 파일 변경은 하지 않도록 하는 작업 방식입니다.
context window · Claude Code가 현재 대화에서 함께 참고하는 메시지, 파일 내용, 명령 결과의 범위입니다. 너무 많이 쌓이면 앞선 지시를 놓칠 수 있습니다.
/clear · 현재 대화에 쌓인 내용을 비우고 새 작업 맥락으로 시작하는 명령입니다.
/compact · 긴 대화에서 필요한 내용만 요약해 남기는 명령입니다.
@ · 요청문에서 특정 파일을 가리키는 표시입니다. Claude Code가 답하기 전에 그 파일을 읽도록 할 수 있습니다.

출처

원문: Claude Code 공식 도움말 · https://code.claude.com/docs/ko/best-practices

함께 읽으면 좋은 글

오늘 글이 재미있으셨다면, 제 공간에도 한 번 놀러 와 주세요 🙂

제 인포크 링크 둘러보기