계획 모드로 먼저 계획하기
큰 작업을 맡기기 전에 계획 모드에서 Claude Code가 코드를 읽고 계획만 세우게 하면, 방향이 틀린 수정을 되돌리는 수고를 미리 막을 수 있습니다.
Shift+Tab이나 /plan으로 계획 모드에 들어가 요청을 줍니다. 나온 계획을 Ctrl+G로 직접 고친 뒤 승인하면 그때부터 편집이 시작되고, 프로젝트 기본 모드를 계획으로 둘 수도 있습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 계획 모드 켜기
Shift+Tab을 눌러 상태 표시줄에 plan mode가 보일 때까지 돌립니다. /plan 뒤에 요청을 바로 적어도 됩니다.
/plan 로그인 실패 시 잠금 기능 추가결과: plan mode 표시
확인: 상태 표시줄에 plan mode on이 보이는지 확인
2. 계획 받기
계획 모드에서는 파일을 읽고 계획을 쓰지만 소스는 고치지 않습니다. 바꿀 파일, 순서, 확인 방법이 들어가게 요청합니다.
바꿀 파일, 단계별 순서, 단계마다 확인할 테스트를 넣어서 계획을 세워 줘.결과: 단계별 계획
확인: 계획에 바꿀 파일과 확인 방법이 들어 있는지 확인
3. 계획 고치기
승인 전에 Ctrl+G로 계획을 내 편집기에서 열어 직접 고칠 수 있습니다.
결과: 고친 계획
확인: 고친 부분이 계획에 반영됐는지 확인
4. 승인하고 진행
승인 화면에서 진행 방식을 고르면 계획 모드가 끝나고 편집이 시작됩니다. 계획을 더 다듬으려면 No, keep planning을 고릅니다. 승인 화면에서 Shift+Tab은 승인으로 처리되므로, 승인 없이 빠지려면 먼저 Esc를 누르세요.
결과: 계획대로 시작된 편집
확인: 첫 편집이 계획의 1단계와 맞는지 확인
5. 프로젝트 기본값으로 (선택)
늘 계획부터 하고 싶은 프로젝트는 .claude/settings.json에 기본 모드를 계획으로 둡니다.
{ "permissions": { "defaultMode": "plan" } }결과: 계획 모드로 시작하는 세션
확인: 새 세션이 plan mode로 시작하는지 확인
주의
- 계획이 맞아도 구현 중 새 사실이 나오면 계획과 달라질 수 있음. 단계마다 확인 기준을 두기
- /model opusplan은 계획에 opus, 실행에 sonnet을 써서 비용을 조절
- 작은 수정까지 계획 모드로 하면 오히려 느려짐
댓글