Claude Code Plan Mode 사용법: 계획 수정부터 권한 설정까지

계획 검토의 가치는 승인 직전에 드러납니다. 빠뜨린 호출부를 발견하고, 기존 계약을 지키거나, 불필요한 데이터베이스 변경을 제외하는 순간입니다. 상세한 계획은 실제 결정을 바꿀 수 있을 때 제 역할을 합니다.

Claude Code Plan Mode가 하는 일

Plan Mode에서는 Claude가 코드베이스를 조사하고 변경안을 제시합니다. 파일을 읽고, 구조를 파악하기 위한 명령을 실행하고, 계획을 작성할 수 있습니다. 일반적으로는 사용자가 승인할 때까지 소스 코드 수정이 차단됩니다. 시공자가 벽을 옮기기 전에 리모델링 도면부터 검토하는 과정이라고 생각하면 됩니다. Anthropic의 계획 수립 워크플로 문서.

다만 공식 문서에 명시된 중요한 예외가 있습니다. 권한 검사 우회 기능을 사용할 수 있는 대화형 터미널 세션에서는 Plan Mode의 차단 규칙이 적용되지 않습니다. Claude에는 여전히 계획을 세우라는 지시가 주어지지만, 수정을 시도하면 실행될 수 있습니다. --allow-dangerously-skip-permissions로 우회 기능을 사용 가능하게 해 둔 경우도 포함되며, 우회 모드를 현재 모드로 선택하지 않았더라도 마찬가지입니다. 승인 전 소스 수정을 막으려는 목적이라면 우회 기능을 활성화하지 않고 시작해야 합니다. Anthropic의 권한 모드 규칙.

계획 수립 워크플로와 권한 시스템은 함께 작동합니다. 계획은 Claude가 무엇을 바꾸려는지 설명하고, 권한 모드는 어떤 작업을 사용자에게 묻지 않고 진행할 수 있는지 결정합니다.

Claude Code 플랜 모드 시작과 종료 방법

터미널에서 처음부터 Plan Mode로 시작하려면 다음 명령을 사용합니다.

claude --permission-mode plan

이미 실행 중인 세션에서는 아래 조작 방법을 사용합니다. 키를 몇 번 누르는지 외우기보다 모드 표시를 확인하는 편이 좋습니다.

auto에서 모드를 순환하면 default(수동), acceptEdits, plan 순서로 이동합니다. 이후 사용할 수 있는 선택적 모드가 이어지며, 권한 검사 우회가 먼저이고 auto가 마지막입니다. Windows에서 Node 또는 Bun 런타임이 VT 입력 모드를 활성화하지 않는 경우에는 Alt+M을 대신 사용할 수 있다고 Anthropic 문서에 안내되어 있습니다. 모드 전환, 키보드 단축키 문서, 명령어 문서.

Claude가 계획을 제시하면 승인 화면에서 다음과 같이 선택할 수 있습니다.

• No, keep planning(승인하지 않고 계획 계속)을 선택하고 구체적인 수정 사항을 전달합니다.
• Yes, manually approve edits(승인 후 수정 사항을 수동 승인)를 선택하면 접근 방식은 승인하되 개별 수정은 직접 검토합니다.
• auto 모드를 사용할 수 있다면 Yes, and use auto mode(승인 후 auto 모드 사용)를 선택해 이어서 진행합니다.

auto 모드를 사용할 수 없으면 자동 진행 옵션은 대신 수정 사항을 자동으로 승인합니다. 세션을 시작할 때 우회 기능을 활성화했다면 해당 옵션은 권한 검사 우회 모드로 전환합니다. 선택하기 전에 화면에 제시된 모드를 확인해야 합니다. 계획을 승인하면 Plan Mode가 종료되고 선택한 권한에 따라 구현이 시작됩니다. Shift+Tab으로 모드를 바꿔도 계획 모드에서 나오지만, 제안된 계획을 승인하는 것은 아닙니다. 계획 승인 시 동작.

에디터에서 사용 중이라면 다음 위치를 확인합니다. VS Code에서는 프롬프트 아래의 모드 표시를 클릭하고 Plan을 선택합니다. Desktop의 Code 탭에서는 Send 옆의 모드 선택기를 사용합니다. JetBrains에서는 내장 터미널에서 CLI 조작 방법을 사용합니다. 변경 이력에는 VS Code에서 /plan을 직접 입력하는 기능이 v2.1.280부터 지원된다고 명시되어 있습니다. 인터페이스별 조작 방법, 공식 변경 이력.

알아 두면 유용한 설정

특정 프로젝트의 터미널 세션을 Plan Mode로 시작하려면 .claude/settings.json에 다음 설정을 병합합니다.

{
  "permissions": {
    "defaultMode": "plan"
  }
}

사용자 전체의 터미널 기본값으로 지정하려면 ~/.claude/settings.json을 사용합니다. 실행 시 전달한 플래그는 설정 파일보다 우선하며, 프로젝트 설정이나 관리 설정이 사용자 기본값을 덮어쓸 수 있습니다. VS Code에는 별도의 시작 설정이 있습니다. VS Code 사용자 설정에서 "claudeCode.initialPermissionMode": "plan"을 지정합니다. 확장 프로그램은 시작 시 적용할 권한 모드를 정할 때 프로젝트 설정을 읽지 않습니다. 시작 모드 설정.

아래 설정 키는 Claude Code 설정의 최상위에 넣습니다. permissions 내부에 넣는 항목이 아닙니다.

계획을 어디에 저장할지, 계획 중 명령을 어떻게 검토할지, 승인 시 대화를 비우는 옵션을 표시할지는 각각 별개의 설정입니다. 설정 레퍼런스, 계획 저장 위치, 컨텍스트 초기화 옵션.

컨텍스트를 비우기로 했다면 제약 조건, 아직 결정하지 못한 사항, 완료 판정 기준을 계획 자체에 기록해야 합니다. 그렇지 않으면 구현 단계에서는 더 이상 볼 수 없는 대화에 의존하게 됩니다.

계획 모드와 auto 모드는 어떻게 함께 작동합니까?

Plan Mode는 구현 여부를 검토할 수 있도록 결정을 보류합니다. auto 모드는 별도의 분류 모델이 작업을 평가하게 해 반복적인 권한 승인 요청을 줄입니다. 분류 모델은 권한 측면에서 작업을 확인하고, 사용자는 계획을 검토하면서 제안된 설계가 실제로 풀어야 할 문제를 해결하는지 판단합니다.

auto 모드를 사용할 수 있고 useAutoModeDuringPlan이 활성화되어 있으면, 계획 단계의 셸 명령도 이 분류 모델이 검토합니다. 승인된 명령은 실행되고 거부된 명령은 차단됩니다. auto 모드를 사용할 수 없거나 해당 설정을 끄면, 기본 제공 읽기 전용 명령 집합 밖의 명령은 대신 승인을 요청합니다. 중요 경로 삭제에는 별도 처리가 적용되며, 대화형 터미널의 권한 검사 우회 예외가 우선합니다. 계획 단계라고 해서 모든 셸 명령이 읽기 전용인 것은 아닙니다. 계획 단계의 명령 실행.

구현 단계에서 default는 수동 검토를 의미합니다. acceptEdits는 문서에 명시된 예외를 제외하고 허용 범위 내의 수정과 일반적인 파일시스템 명령을 자동으로 허용하며, auto는 백그라운드에서 작업을 검토하는 기능을 더합니다. 어느 모드도 아키텍처가 적절한지는 판단해 주지 않습니다. 권한 모드 선택은 Claude Code Auto Mode 가이드에서 더 자세히 다룹니다.

현재 문서에 따르면 v2.1.283부터 대화형 터미널과 VS Code 세션의 내장 시작 모드는 auto입니다. 다만 설정, 조직 정책, 사용 가능 여부에 관한 규칙이 적용됩니다. 따라서 Plan Mode를 시작 모드로 명시하는 설정은 여전히 의미가 있습니다. 현재 시작 모드 규칙.

오래된 사용 안내에는 중요한 변경 사항이 빠져 있을 수 있습니다. Anthropic의 변경 이력에 따르면 /plan에 설명 인수를 전달하는 기능은 v2.1.72에 추가되었고, 컨텍스트 초기화 옵션은 v2.1.81부터 기본적으로 숨겨졌습니다. auto를 사용하는 계획 단계에서 읽기 전용 여부가 불확실한 Bash 명령을 분류 모델이 처리하는 기능은 v2.1.218에 기록되어 있습니다. 공식 변경 이력.

리팩토링 예제: 청구 금액을 유지하면서 가격 계산 로직 공유하기

구체적인 리팩토링을 생각해 보겠습니다. 어떤 애플리케이션은 API에서 결제 가격을 계산하고, 백그라운드 워커에서 갱신 가격을 계산합니다. 목표는 각 호출부의 기존 반올림 및 할인 동작을 유지하면서 가격 계산 규칙을 공유하는 것입니다. 아래 내용은 계획을 설명하기 위한 예시이며, 실제 저장소에서 테스트한 결과나 Claude가 반드시 내놓는 응답은 아닙니다.

Plan Mode로 들어가 실제로 지켜야 할 제약을 전달합니다.

관련 프로젝트 파일이 다음과 같다고 가정합니다.

첫 초안은 공통 계산기를 추출하고, 두 호출부를 전환하고, 기존 헬퍼를 삭제한 뒤 테스트를 수정하자고 제안할 수 있습니다. 깔끔해 보이지만 빠진 부분이 있습니다. 결제와 갱신에서 반올림하는 시점이 서로 다르면 어떻게 처리할지 정하지 않았습니다.

승인하기 전에 계획을 수정합니다. 검토 화면에서 Ctrl+G를 누르고, 기존 코드를 일찍 삭제하는 단계를 다음 내용으로 교체합니다.

계획을 저장하고 돌아옵니다. 아직 수정할 부분이 있다면 계획 계속 옵션을 선택하고, Claude에 이 수정 사항과 전체 계획이 일치하도록 정리해 달라고 요청합니다. 핵심은 모순되는 삭제 단계를 없애는 것입니다. 그 아래에 주의 문구만 덧붙여서는 안 됩니다. 직접 편집과 계획 논의의 지속은 모두 공식 문서에 안내된 워크플로입니다. Anthropic의 탐색·계획·코딩 가이드.

수정된 계획은 이제 실제로 구현할 수 있는 순서가 되어야 합니다.

1. 기존 동작을 테스트로 기록합니다. 현재 결제 및 갱신 금액에 대한 사례를 추가합니다. 반올림 경계, 할인, 잘못된 입력도 포함합니다. 기대 결과가 불분명한 사례는 다음 단계로 넘어가기 전에 확정합니다.
2. 어댑터 뒤에 공통 정책을 도입합니다. 기존 함수 각각의 입력, 출력, 오류 동작을 유지합니다. 호출부 간 차이를 명시적으로 표현합니다.
3. 호출부를 나누어 전환합니다. 먼저 결제를 변경하고 검증한 다음 갱신을 변경합니다. 관련 없는 코드 정리는 이번 변경에 섞지 않습니다.
4. 결과를 검증합니다. 프로젝트에서 실제로 사용하는 가격 계산, API, 워커 검증을 실행한 뒤 평소의 타입 검사와 통합 검증을 진행합니다. diff를 검토해 외부에 공개되는 응답이나 청구 의미가 달라졌는지 확인합니다.
5. 롤백 경로를 유지합니다. 검증이 성공할 때까지 호환성 경계를 유지합니다. 더 이상 쓰지 않는 코드는 별도로 검토할 수 있는 단계에서 제거합니다.

이 예제에서는 수정 사항을 수동으로 검토하는 옵션으로 계획을 승인합니다. 구현이 끝나면 실제 변경 사항과 테스트 결과가 계획에 부합하는지 확인합니다. 테스트를 언급한 계획도 실제 검증이 실행되기 전까지는 제안일 뿐입니다.

여기서 얻는 비용 절감 효과는 구체적입니다. 두 호출부와 해당 테스트를 모두 다시 작성하기 전에 동작 변경을 발견한다는 점입니다. 근거 없는 토큰 절감률을 덧붙일 필요는 없습니다.

먼저 계획할수록 이득이 큰 작업

초기의 설계 실수가 다른 부분으로 번지기 쉬운 작업부터 계획하는 것이 좋습니다. 제가 계획을 먼저 검토할 상황을 기대 가치가 높은 순서로 정리하면 다음과 같습니다.

이 목록은 측정 결과가 아니라 워크플로 제안입니다. 접근 방식이 불확실하거나, 여러 파일에 걸친 변경이거나, 코드가 낯설 때 계획부터 세우라는 Anthropic의 권고를 따릅니다. 오타 수정, 추가할 내용이 정해진 로그 문구, 범위가 명확한 이름 변경이라면 바로 수정을 요청하면 됩니다. Anthropic이 계획을 권장하는 상황.

비용을 판단하려면 계획 단계를 넣기 전후의 워크플로를 비교합니다. 바로 실행하면 접근 방식이 틀렸다는 사실을 발견하기 전에 구현과 검토에 시간을 쓰게 됩니다. 계획부터 세우면 조사와 계획 검토 시간이 앞에 추가되지만, 그만큼 재작업을 피할 가능성이 생깁니다.

계획에 드는 인건비와 추가 모델 사용 비용의 합이, 계획으로 예방할 수 있는 예상 재작업 비용보다 작을 때 계획은 이득입니다. 이는 판단 기준이지 Anthropic의 비용 절감 벤치마크가 아닙니다. 팀의 개발 비용과 실제 사용량을 기준으로 계산해야 합니다. 이미 정확히 명세할 수 있는 변경을 계획이 그대로 되풀이할 뿐이라면 생략합니다.

이 기능을 활용해 어떤 제품을 만들 수 있습니까?

가장 가능성이 큰 아이디어는 팀을 위한 리팩토링 검토 패키지입니다. 제안된 변경을 검토자가 바로 살펴볼 수 있는 파일 구성도, 유지해야 할 계약, 완료 판정 항목, 롤백 메모로 정리하는 제품입니다. 특히 공통 비즈니스 로직을 다루는 팀이라면 개발자마다 검토 품질을 일정하게 유지하기 위해 개발 리더가 비용을 지불할 수 있습니다.

2026년 10월 12일에 조회한 DataForSEO의 미국 키워드 추정치에서 “code refactoring tools”의 월간 검색량은 170회입니다. 이 작업에 어느 정도 관심이 있다는 신호이지만, 검색자가 계획 검토 제품을 구매할 것이라는 근거는 아닙니다. 최소한의 유용한 제품은 내보낸 계획과 저장소의 파일 구성도를 입력받아, 누락된 호출부나 근거 없는 가정을 점검하고 풀 리퀘스트용 개요를 작성하는 형태일 수 있습니다. 과제도 있습니다. 일반적인 계획 생성은 이미 Claude Code에 포함되어 있습니다. 별도 제품으로서 가치를 가지려면 팀에 맞춘 점검과 유용한 검토 산출물이 필요합니다.

더 좁은 분야의 기회는 에이전시를 위한 마이그레이션 사전 점검 패키지입니다. 업그레이드 견적을 내기 전에 영향받는 구성 요소 목록, 단계별 배포 체크리스트, 미결정 사항 목록을 만드는 제품입니다. 같은 DataForSEO 조회에서 “code migration tools”의 미국 월간 검색량은 20회로 추정됩니다. 구매 의도가 있는 검색어라도 수요 규모가 작으므로, 범용 제품을 만들기 전에 기존 고객을 대상으로 검증하는 편이 좋습니다.

최소 버전은 특정 마이그레이션 유형에 집중하고, 변경 사항마다 해당 공급업체 문서 링크를 첨부하도록 할 수 있습니다. 과제는 유지 관리입니다. 버전별 마이그레이션 규칙은 빠르게 낡습니다. Plan Mode가 조사를 도울 수는 있어도 검증된 마이그레이션 규칙집을 제공하지는 않습니다. 이 아이디어들은 검색 수요에 근거한 제품 가설이며 매출 전망이 아닙니다.

Ultraplan은 더 이상 제공되지 않습니다

Anthropic은 Ultraplan 리서치 프리뷰를 제거했습니다. /ultraplan, 키워드 트리거, 웹의 Ultraplan으로 계획을 다듬는 승인 옵션도 함께 제거되었습니다. 해당 페이지는 리서치 프리뷰가 실험적 기능이며 피드백에 따라 변경되거나 제거될 수 있다고 설명합니다. 계획 수립 워크플로를 위해서는 로컬 Plan Mode와 Claude Code 클라우드 세션을 안내합니다. Anthropic의 현재 Ultraplan 페이지.

다음 작업 전에 확인할 질문

월요일에는 여러 호출부가 로직을 공유하는 다음 리팩토링을 골라 Plan Mode로 시작해 보시기 바랍니다. 유지할 동작, 영향받는 파일, 검증 방법, 롤백 방안을 요청합니다. 승인하기 전에 가장 취약한 가정을 수정합니다. Claude Code 모범 사례에서 다루는 전반적인 검토 습관도 함께 적용하면 좋습니다.

팀에 반복해서 사용할 수 있는 계획 수립 및 검토 워크플로가 필요하다면, 개발 프로세스에 맞게 구축해 드릴 수 있습니다.