Plan Mode: 두 번 생각하고, 한 번 실행

Source: Dev.to

행동에 옮기기 전에 전쟁 안개를 걷어내라

“빠르게 움직이고 부수라”는 말도 나름의 자리다. 하지만 복잡한 코드베이스에서는 빠르게 움직이는 것이 종종 존재조차 몰랐던 것들을 깨뜨리는 것을 의미한다. 지금 리팩터링 중인 그 API 엔드포인트? 3개월 전 잊어버렸던 웹훅을 포함해 47곳에서 호출되고 있다.

플랜 모드란?

Plan Mode는 Claude가 전체 코드베이스를 변경 없이 읽고, 검색하고, 분석하고, 추론할 수 있게 합니다. 이는 수정 작업을 실행하기 전에 완전한 정신 모델을 제공하는 정찰 단계입니다.

• 읽기 전용 접근 – Claude는 파일을 탐색하고, 의존성을 추적하며, 분석을 실행할 수 있지만 상태를 변경하는 쓰기나 명령은 실행할 수 없습니다.

• 켜기/끄기 토글

  Shift+Tab, Shift+Tab → Activate Plan Mode
  Shift+Tab          → Return to Normal (Act) Mode

Plan Mode가 활성화되면 다음 표시가 나타납니다:

🔍 PLAN MODE

이제 다음과 같은 개방형 질문을 할 수 있습니다:

• “REST에서 GraphQL로 마이그레이션할 경우 어떤 영향을 미칠까요?”
• “우리 인증 시스템을 통한 데이터 흐름을 분석해 주세요.”
• “결제 처리를 하는 모든 위치를 찾아 각각의 오류 처리 방식을 설명해 주세요.”

Claude는 파일을 전혀 건드리지 않고 상세한 분석을 반환합니다.

실행으로 전환

필요한 인사이트를 모두 수집했으면, Normal Mode(또는 Act Mode)로 다시 전환하세요:

Shift+Tab → Normal Mode (or Act Mode)

Claude가 쓰기 권한을 다시 얻으며, 자신 있게 구체적인 변경 요청을 할 수 있습니다.

플랜 모드 기본 사용의 장점

1. 불안 감소 및 과도한 사양 방지

플랜 모드는 의도치 않은 부작용에 대한 두려움을 없애고, 알고 싶은 것에 집중하게 하며 하지 말아야 할 것에 대한 고민을 줄여줍니다.

2. 빠른 의사결정

플랜 모드에서 10~15분 정도 시간을 투자해 의존성, 호출 지점, 잠재적 충돌을 파악하면, 나중에 디버깅에 소요되는 수시간을 절약할 수 있습니다.

3. 더 안전한 코드 리뷰

“이 PR이 무엇을 변경했는지 설명하고 잠재적인 문제를 식별하세요.”

완벽한 플랜 모드 작업—전체 분석, 우발적인 수정 위험이 전혀 없습니다.

4. 탐색 및 온보딩

플랜 모드를 사용해 자유로운 탐색, 새로운 팀원 교육, 혹은 “what‑if” 분석(예: “이 폐기된 모듈을 제거하면 어떻게 될까?”)을 수행할 수 있으며, 코드베이스를 손상시킬 위험이 전혀 없습니다.

실제 사용 사례

“나는 약 90 %의 경우에 Plan Mode를 기본으로 사용합니다. 제 업무는 가능한 많은 코드를 작성하는 것이 아니라 올바른 결정을 내리는 것입니다. Claude의 Plan Mode는 제 사고 파트너입니다.” — 리드 엔지니어, 중간 규모 스타트업

일반적인 세션

Phase 1 – Reconnaissance (Plan Mode)

• 우리 시스템에서 알림이 어떻게 작동하는지 보여줘.
• 사용자가 알림을 트리거할 수 있는 모든 방법은 무엇인가?
• 알림에 속도 제한(rate limiting)을 추가하고 싶다면 무엇이 바뀔까?
• 알림 서비스와 사용자 서비스 간의 의존성을 식별해줘.

Phase 2 – Decision
(답변을 분석하고 접근 방식을 결정한다.)

Phase 3 – Execution (Normal Mode)

• 알림 속도 제한을 구현해. 사용자당 시간당 100건을 추가해.
• Redis INCR와 EXPIRE를 사용해 레이스 컨디션을 처리해.

“실행 단계는 계획 단계가 철저했기 때문에 집중적이고 정밀합니다. 결과는 흩어진 수정이 아니라 깔끔하고 의도적인 변경입니다.”

Analogy: Scouting in a Strategy Game

• Without scouting: Send units into unknown territory and hope for the best.
• With scouting: Reveal the map, identify threats and opportunities, then make informed moves.

Complex codebases have their own “fog of war.” Plan Mode clears it, turning speed without direction into purposeful action.

팁 및 모범 사례

• Plan 모드를 기본으로 설정 – 세션 대부분을 읽기 전용 모드로 운영합니다.
• 구체적인 구현 세부 사항으로 좁히기 전에 먼저 폭넓고 탐색적인 질문을 하세요.
• 결과를 문서화 (예: Claude의 분석을 디자인 문서에 복사)하여 팀 전체의 사고 모델을 보존합니다.
• 계획이 구체적일 때만 Normal 모드로 전환하고 명확하고 제한된 변경 요청이 있을 때 전환합니다.

향후 로드맵

• Day 30: 즉시 진단, 정의로 이동, 타입 정보 등을 위한 LSP 통합 — Claude는 여러분의 편집기가 보는 것을 정확히 볼 수 있습니다.
• Upcoming: 실제 IDE 수준의 코드 인텔리전스, 더 풍부한 분석과 빠른 피드백 루프를 가능하게 합니다.

두 번 생각하고, 한 번 실행하세요.

다음에 큰 변화를 요청하려 할 때는 먼저 Shift+Tab 두 번을 시도해 보세요. 실행하기 전에 탐색하세요 — 발견하게 될 것이 놀라울 수도 있습니다.