# 계획 모드로 먼저 계획하기
id: claude-code-plan-mode · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-plan-mode
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 10분
평가 점수: 32/100 (확인 없음 · 검수 대기)

큰 작업을 맡기기 전에 계획 모드에서 Claude Code가 코드를 읽고 계획만 세우게 하면, 방향이 틀린 수정을 되돌리는 수고를 미리 막을 수 있습니다.

설명: Shift+Tab이나 /plan으로 계획 모드에 들어가 요청을 줍니다. 나온 계획을 Ctrl+G로 직접 고친 뒤 승인하면 그때부터 편집이 시작되고, 프로젝트 기본 모드를 계획으로 둘 수도 있습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 계획 모드 켜기 — Shift+Tab을 눌러 상태 표시줄에 plan mode가 보일 때까지 돌립니다. /plan 뒤에 요청을 바로 적어도 됩니다.
   프롬프트:
   > /plan 로그인 실패 시 잠금 기능 추가
   기대 결과: plan mode 표시
   확인 방법: 상태 표시줄에 plan mode on이 보이는지 확인
2. [AI에게 · Claude Code] 계획 받기 — 계획 모드에서는 파일을 읽고 계획을 쓰지만 소스는 고치지 않습니다. 바꿀 파일, 순서, 확인 방법이 들어가게 요청합니다.
   프롬프트:
   > 바꿀 파일, 단계별 순서, 단계마다 확인할 테스트를 넣어서 계획을 세워 줘.
   기대 결과: 단계별 계획
   확인 방법: 계획에 바꿀 파일과 확인 방법이 들어 있는지 확인
3. [사람이 · Claude Code] 계획 고치기 — 승인 전에 Ctrl+G로 계획을 내 편집기에서 열어 직접 고칠 수 있습니다.
   기대 결과: 고친 계획
   확인 방법: 고친 부분이 계획에 반영됐는지 확인
4. [사람이 · Claude Code] 승인하고 진행 — 승인 화면에서 진행 방식을 고르면 계획 모드가 끝나고 편집이 시작됩니다. 계획을 더 다듬으려면 No, keep planning을 고릅니다. 승인 화면에서 Shift+Tab은 승인으로 처리되므로, 승인 없이 빠지려면 먼저 Esc를 누르세요.
   기대 결과: 계획대로 시작된 편집
   확인 방법: 첫 편집이 계획의 1단계와 맞는지 확인
5. [사람이 · Claude Code] 프로젝트 기본값으로 (선택) — 늘 계획부터 하고 싶은 프로젝트는 .claude/settings.json에 기본 모드를 계획으로 둡니다.
   프롬프트:
   > { "permissions": { "defaultMode": "plan" } }
   기대 결과: 계획 모드로 시작하는 세션
   확인 방법: 새 세션이 plan mode로 시작하는지 확인

주의:
- 계획이 맞아도 구현 중 새 사실이 나오면 계획과 달라질 수 있음. 단계마다 확인 기준을 두기
- /model opusplan은 계획에 opus, 실행에 sonnet을 써서 비용을 조절
- 작은 수정까지 계획 모드로 하면 오히려 느려짐

출처:
- Claude Code 문서: 권한 모드(계획 모드) https://code.claude.com/docs/en/permission-modes
- Claude Code 문서: 자주 쓰는 작업 https://code.claude.com/docs/en/common-workflows
- Claude Code 문서: 모델 설정 https://code.claude.com/docs/en/model-config