Cmd. /plan
프롬프트에서 바로 plan mode(계획 모드)로 진입하고, 설명을 넘기면 해당 작업으로 즉시 시작하는 명령
핵심 요약
- plan mode 진입 후 선택 작업 시작
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
plan mode 진입 후 선택 작업 시작
/plan [description]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/plan investigate the failing authentication test/plan/plan fix the auth bug- 인자 없이
/plan만 입력하면 계획 모드로 진입합니다. - 설명을 함께 넘기면(
/plan <description>) 계획 모드로 진입하면서 그 작업을 곧바로 시작합니다. 위 예시처럼/plan fix the auth bug로 쓰면 됩니다. - 별칭(alias)은 없습니다. 명령은 메시지 맨 앞에서만 인식되며, 명령어 뒤의 텍스트는 인자로 전달됩니다.
선택 시점
- 대규모 변경 전에 단계별 계획 고정
- 요구사항이 불확실한 작업에서 의사결정 정리
- 팀 리뷰용 실행 계획 초안 생성
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/plan | 프롬프트에서 계획 모드 직접 진입 | 실행 전 설계가 필요할 때 |
/ultraplan | 클라우드 ultraplan 세션에서 계획 초안 작성 후 브라우저 검토·원격 실행 | 더 깊은 계획·원격 실행이 필요할 때 |
/effort | 추론 비용(노력 수준) 조정 | 계획·실행에 들이는 추론량을 조절할 때 |
/model | 사용 모델 전환 | 계획 단계 모델을 바꾸고 싶을 때 |
실행 결과와 유지 범위
계획 중심의 작업 흐름으로 전환합니다. 구현을 시작하기 전에 계획과 적용 범위를 확인합니다.
공식 문서(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 명령 단축키 추가 — 프롬프트에서 바로 계획 모드 진입 |
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이 계획 모드 진입 시 기존 플랜을 반영하지 않던 문제 수정 |
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록