🚨 그 "네, 진행해주세요", 정말 눌러도 괜찮을까요? 많은 사람들이 놓치고 있는 Claude Code의 분기점
Claude Code에서 플랜(계획)을 세운 뒤 화면에 선택지가 표시되는 순간이 있습니다.
많은 분들이 이 단계에서 별생각 없이 가장 위에 있는 선택지를 고르곤 합니다. 혹은 반대로 매번 모든 항목을 수동으로 확인하느라 정작 효율화의 이점을 제대로 살리지 못하기도 합니다.
사실 이 '승인 방식' 하나에 따라 작업 속도와 리스크의 크기가 완전히 달라집니다. 무분별하게 자동화를 선택하면 의도하지 않은 변경이 발생할 수 있고, 반대로 모든 것을 수동 확인으로 처리하면 Claude Code를 사용하는 의미 자체가 퇴색됩니다.
이 글에서는 Claude Code의 'Plan Mode(플랜 모드)'에서 표시되는 승인 선택지에 대해 각각의 의미와 어떤 상황에서 무엇을 선택해야 하는지에 대한 판단 기준을 하나하나 꼼꼼하게 설명해 드리겠습니다. 글을 다 읽고 나면 지금까지 막연하게 골라 눌렀던 승인 버튼을 명확한 근거를 가지고 선택할 수 있게 될 것입니다.
🔍 애초에 Plan Mode란 무엇인가
Plan Mode(플랜 모드)는 Claude Code가 파일을 실제로 편집하거나 명령어를 실행하기 전에 먼저 '무엇을 어떻게 변경할 예정인지'에 대한 계획만을 제시해 주는 기능입니다.
일반 모드에서는 Claude가 편집할 때마다 확인을 요청하지만, Plan Mode에서는 그에 앞서 '계획을 세우는' 단계와 '실행하는' 단계가 명확히 구분됩니다. Claude는 파일을 읽거나 조사를 위한 명령을 실행할 수는 있지만, 코드 자체에 대한 변경은 계획이 승인될 때까지 보류됩니다.
큰 기능 추가나 복잡한 리팩터링을 의뢰할 때일수록, 이 '먼저 계획을 확인한 뒤에 움직인다'는 흐름이 안심 재료가 됩니다. 곧바로 작업에 들어가는 것이 아니라 방향성을 먼저 보여주기 때문에, 나중에 '생각했던 것과 다른 변경이 되어버렸다'는 엇갈림을 방지하기 쉬워집니다.
Plan Mode로 전환하려면 CLI에서 Shift+Tab 키로 순환하거나 프롬프트 맨 앞에 "/plan"을 입력하면 됩니다. 설정 파일에서 미리 Plan Mode를 기본값으로 설정해 두는 것도 가능합니다.
여기서 초보자가 헷갈리기 쉬운 포인트를 하나 보충해 두겠습니다. Claude Code에는 Plan Mode 외에도 여러 개의 '권한 모드(퍼미션 모드)'가 존재합니다. 읽기만 수행하고 모든 변경에 대해 확인을 요청하는 기본 모드, 파일 편집은 자동으로 승인하되 위험도가 높은 명령어에 대해서만 확인을 요청하는 모드, 확인 없이 거의 모든 것을 실행해 버리는 모드 등 용도에 따라 여러 단계의 '신뢰 수준'이 마련되어 있습니다. Plan Mode는 그중에서도 '실행 전에 먼저 계획만 보여 달라'는, 이른바 준비 운동에 해당하는 모드라고 생각하면 이해하기 쉽습니다.
🧭 계획이 확정되었을 때 나타나는 '승인의 분기점'
출처: note 원문
번역: Gemma 3(.44) 초벌 + 교정 8청크
원문 보기 | 출처: note.com