03-Plan-Mode-운영판

03. Plan-Mode — CoT의 운영판

Plan-Mode란

Claude Code의 Plan-Mode는 코드 실행 권한을 가진 에이전트가 먼저 계획을 세우고 사용자에게 승인을 받은 뒤에만 변경을 수행하도록 강제하는 운영 모드다. 본질적으로는 다음 두 단계의 명시적 분리다.

1. Plan: 모델이 무엇을 할지 단계별로 출력. 파일은 건드리지 않음.
2. Execute: 사용자가 승인하면 그 계획을 그대로 실행.

이 분리는 CoT의 운영적 형태다. “사고를 먼저 보여라(Plan), 그 다음 행동하라(Execute).”

왜 Plan-Mode가 필요한가

LLM 에이전트의 가장 큰 위험은 잘못된 추론을 곧바로 파괴적 행동으로 옮기는 것이다. 예: “리팩터링하라” → 모델이 디렉토리 구조를 잘못 이해 → rm -rf 실행. Plan-Mode는 그 사이에 사람의 게이트를 박는다.

Plan-Mode의 패턴

패턴 1 — 단순 승인 게이트

[Plan-Mode 활성]
사용자: "auth 모듈 리팩터링해 줘"

Claude 출력:
1. src/auth/login.ts에서 token 검증 로직을 분리
2. src/auth/token.ts 신규 생성
3. login.ts → token.ts import 추가
4. 기존 테스트 실행, 실패 시 중단
5. 영향 파일: 3개

승인하시겠습니까? (y/n)

패턴 2 — 비용 예측

계획 단계에서 영향 받을 파일 수, 예상 토큰, 위험 등급을 함께 출력. 사용자는 비용/위험을 보고 결정.

패턴 3 — 단계별 체크포인트

긴 작업은 한 번에 다 승인받지 않고, 단계마다 다시 멈춘다. ToT의 백트래킹을 사람이 한다.

CoT와 Plan-Mode의 관계

구분	CoT	Plan-Mode
출력 형태	자연어 사고 사슬	구조화된 계획
검증자	모델 자신(Self-Consistency) 또는 없음	사람
부작용	없음(텍스트)	있음(파일·명령)
비용	토큰	토큰 + 사람 시간
적합 영역	추론·분류·요약	코드 변경·시스템 명령·환불 같은 거래

Plan-Mode는 본질적으로 부작용이 있는 환경에서 사고와 행동을 강제로 분리하는 ReAct의 안전 변형이다.

OMC 패턴과의 연결

본 위키가 가르치는 OMC(oh-my-claudecode)의 writer → reviewer → critic → verifier 분리 패스도 같은 원리다. 한 모델이 한 호출로 결정·실행을 모두 하게 두지 않는다. 사고의 단계마다 다른 컨텍스트·다른 권한을 부여한다.

이는 학술적으로는 Self-Consistency(다중 사고 경로) + ToT(평가·가지치기) + ReAct(도구 호출)의 운영 합성이다.

언제 Plan-Mode를 끄는가

• 읽기 전용 작업 (검색, 요약, 설명) — 계획 단계가 오버헤드
• 사용자가 모델의 도메인 지식을 신뢰 + 작업이 작음
• 회귀 테스트로 보호되는 작업 — 잘못되어도 자동 롤백 가능

원칙: 부작용의 비가역성에 비례해 Plan-Mode를 강제하라. rm은 항상 Plan-Mode, cat은 절대 필요 없음.