01-개념

01. 개념 — Plan Mode는 “강한 프롬프트 + UX”

Armin Ronacher가 Claude Code의 Plan Mode 내부를 뜯어본 글이 가장 정확한 사실 진술이다.

“It is just prompt reinforcement that changes the behavior of the tools and also which tools are available. It is in fact just a rather short predefined prompt that enters plan mode.”
의역: “도구가 진짜로 read-only가 되는 게 아니다. 그저 프롬프트 강화로 도구 동작과 가용성이 바뀐다. 사실상 plan mode 진입은 짧은 사전 정의 프롬프트 한 덩어리다.”
— Armin Ronacher, What Actually Is Claude Code’s Plan Mode?

핵심 메시지: Plan Mode는 도구를 잠그는 OS-level lock이 아니다. 모델에게 “지금은 read-only 모드이고, 플랜 파일 외에는 아무것도 편집하지 말 것”이라고 강하게 속삭이는 것이다. 그래서 안 듣는 모델은 안 듣는다 — 이게 안전 가드(권한)가 별도로 필요한 이유.

그럼에도 가치가 있는 두 가지

1. 플랜 파일이 디스크에 떨어진다 — 모델이 자기 플랜을 마크다운 파일로 쓰고, 사용자는 그걸 검토·수정한 뒤에야 실행 단계로 넘어간다.
2. 승인 UX — 사용자가 명시적으로 “OK 실행해” 라고 말하는 게이트.

Ronacher는 (1)에 대해 자기 손으로 마크다운을 만드는 흐름을 더 선호하지만, (2)는 hook이나 슬래시로 흉내내기 어렵다고 인정한다.

Plan 서브에이전트와의 분리

공식 문서:

“When you’re in plan mode and Claude needs to understand your codebase, it delegates research to the Plan subagent. This prevents infinite nesting (subagents cannot spawn other subagents) while still gathering necessary context.”
의역: “Plan 모드에서 코드베이스 이해가 필요하면 Claude는 Plan 서브에이전트에 위임한다. 서브에이전트가 또 서브에이전트를 띄울 수 없어 무한 중첩을 막으면서도 필요한 컨텍스트를 모은다.”

즉, Plan 모드에서는 메인의 컨텍스트가 더 잘 보호된다. 이게 큰 작업의 시작에 plan 모드를 토글하는 실용적 이유다.

”릴리스 노트가 알려주는 신뢰도”

2026-04-02 릴리스 노트는 “plan mode losing track of plan file after container restart” 버그를 수정했다. 즉, 컨테이너 환경에서 플랜 파일이 사라지는 회귀가 최근까지 있었다. 도구는 계속 진화 중이다 — 자기 워크플로우가 plan 파일에 강하게 의존한다면 changelog를 주기적으로 본다.