Cmd. /plan
프롬프트에서 바로 plan mode(계획 모드)로 진입하고, 설명을 넘기면 해당 작업으로 즉시 시작하는 명령
핵심 요약
/plan은 프롬프트에서 곧바로 plan mode(계획 모드)로 진입하는 단축 명령으로, 대규모 변경 전 목표·범위·단계·영향 파일을 먼저 구조화한다.- 선택적 설명 인자를 넘기면(
/plan fix the auth bug) 계획 모드로 들어가면서 그 작업을 즉시 시작하며, 이 인자는 v2.1.72부터 지원된다. - 명령 단축키 자체는 v2.1.0에서 추가됐고 별칭은 없으며, 메시지 맨 앞에서만 인식된다.
- v2.1.77부터 플랜을 수락하면 플랜 콘텐츠로 세션 이름이 자동 생성되고, v2.1.111부터 플랜 파일이 프롬프트 기반 이름으로 저장된다.
- 계획만 길어지지 않도록 단계 수를 제한하고 계획과 실행의 완료 기준 경계를 명확히 한다.
명령어 원본 선언
/plan [description]공식 설명 요약
공식 문서(Commands 레퍼런스)의 설명은 다음과 같습니다.
Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example
/plan fix the auth bug.
/plan은 프롬프트에서 곧바로 plan mode(계획 모드) 로 전환하는 단축 명령입니다. 선택적 설명(description) 인자를 넘기면 계획 모드로 진입하면서 그 작업을 즉시 시작합니다. 대규모 변경을 실제로 적용하기 전에, 목표와 범위, 단계, 영향 파일을 먼저 구조화해 검토할 수 있습니다.
복잡한 요청에서 실행 전에 설계를 고정하거나, 큰 변경에 들어가기 전 계획을 먼저 세울 때 유용합니다.
최소 지원 버전
v2.1.0에서/plan명령 단축키가 추가되어 프롬프트에서 바로 계획 모드로 진입할 수 있게 되었습니다.- 선택적 설명 인자(
/plan fix the auth bug)는v2.1.72부터 지원됩니다.
사용법
/plan/plan fix the auth bug- 인자 없이
/plan만 입력하면 계획 모드로 진입합니다. - 설명을 함께 넘기면(
/plan <description>) 계획 모드로 진입하면서 그 작업을 곧바로 시작합니다. 위 예시처럼/plan fix the auth bug로 쓰면 됩니다. - 별칭(alias)은 없습니다. 명령은 메시지 맨 앞에서만 인식되며, 명령어 뒤의 텍스트는 인자로 전달됩니다.
좋은 사용 예
- 대규모 변경 전에 단계별 계획 고정
- 요구사항이 불확실한 작업에서 의사결정 정리
- 팀 리뷰용 실행 계획 초안 생성
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/plan | 프롬프트에서 계획 모드 직접 진입 | 실행 전 설계가 필요할 때 |
/ultraplan | 클라우드 ultraplan 세션에서 계획 초안 작성 후 브라우저 검토·원격 실행 | 더 깊은 계획·원격 실행이 필요할 때 |
/effort | 추론 비용(노력 수준) 조정 | 계획·실행에 들이는 추론량을 조절할 때 |
/model | 사용 모델 전환 | 계획 단계 모델을 바꾸고 싶을 때 |
활용 사례
- 릴리즈 단위 작업 분해
- 리스크 기반 우선순위 설계
- 인증 버그처럼 범위가 모호한 작업을
/plan fix the auth bug로 시작해 계획부터 잡기
주의사항
- 계획과 실행 경계(완료 기준)를 명확히 해야 합니다.
- 계획만 길어지지 않도록 단계 수를 제한합니다.
- 계획 모드 관련 동작은 버전에 따라 계속 다듬어졌습니다(아래 버전 이력 참고).
관련 버전 이력
| 버전 | 변경 내용 |
|---|---|
v2.1.0 | /plan 명령 단축키 추가 — 프롬프트에서 바로 계획 모드 진입 |
v2.1.69 | 계획 모드 피드백 입력이 multi-line(여러 줄)을 지원하도록 수정(백슬래시+Enter, Shift+Enter) |
v2.1.72 | /plan에 선택적 설명 인자 추가, 진입 즉시 작업 시작 / 계획 모드 권한 프롬프트에서 숫자 키가 메뉴 선택 대신 정상 입력되도록 수정 |
v2.1.77 | 플랜을 수락하면 플랜 콘텐츠에서 세션 이름이 자동 생성됨 |
v2.1.81 | 계획 모드의 "clear context" 옵션이 기본 숨김 처리(showClearContextOnPlanAccept로 복원) |
v2.1.111 | 플랜 파일이 순수 랜덤 단어 대신 프롬프트 기반 이름으로 생성(예: fix-auth-race-snug-otter.md) |
v2.1.119 | /plan 및 /plan open이 계획 모드 진입 시 기존 플랜을 반영하지 않던 문제 수정 |
출처
- Commands(공식 명령어 레퍼런스): https://code.claude.com/docs/en/commands
- Changelog: https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md