---
name: opencurrent-code-plan-mode
description: "큰 작업을 맡기기 전에 계획 모드에서 Claude Code가 코드를 읽고 계획만 세우게 하면, 방향이 틀린 수정을 되돌리는 수고를 미리 막을 수 있습니다. 이럴 때 사용: Shift+Tab이나 /plan으로 계획 모드에 들어가 요청을 줍니다. 나온 계획을 Ctrl+G로 직접 고친 뒤 승인하면 그때부터 편집이 시작되고, 프로젝트 기본 모드를 계획으로 둘 수도 있습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-plan-mode"
  opencurrent-id: "claude-code-plan-mode"
  verification: "pending"
  exported-at: "2026-11-21T11:06:05.306Z"
---

# 계획 모드로 먼저 계획하기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-plan-mode
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-plan-mode")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 계획 모드 켜기 (명령 실행 · Claude Code)

Shift+Tab을 눌러 상태 표시줄에 plan mode가 보일 때까지 돌립니다. /plan 뒤에 요청을 바로 적어도 됩니다.

프롬프트:

```text
/plan 로그인 실패 시 잠금 기능 추가
```

기대 결과: plan mode 표시

확인 방법: 상태 표시줄에 plan mode on이 보이는지 확인

### 2. 계획 받기 (AI에게 · Claude Code)

계획 모드에서는 파일을 읽고 계획을 쓰지만 소스는 고치지 않습니다. 바꿀 파일, 순서, 확인 방법이 들어가게 요청합니다.

프롬프트:

```text
바꿀 파일, 단계별 순서, 단계마다 확인할 테스트를 넣어서 계획을 세워 줘.
```

기대 결과: 단계별 계획

확인 방법: 계획에 바꿀 파일과 확인 방법이 들어 있는지 확인

### 3. 계획 고치기 (사람이 · Claude Code)

승인 전에 Ctrl+G로 계획을 내 편집기에서 열어 직접 고칠 수 있습니다.

기대 결과: 고친 계획

확인 방법: 고친 부분이 계획에 반영됐는지 확인

### 4. 승인하고 진행 (사람이 · Claude Code)

승인 화면에서 진행 방식을 고르면 계획 모드가 끝나고 편집이 시작됩니다. 계획을 더 다듬으려면 No, keep planning을 고릅니다. 승인 화면에서 Shift+Tab은 승인으로 처리되므로, 승인 없이 빠지려면 먼저 Esc를 누르세요.

기대 결과: 계획대로 시작된 편집

확인 방법: 첫 편집이 계획의 1단계와 맞는지 확인

### 5. 프로젝트 기본값으로 (선택) (사람이 · Claude Code)

늘 계획부터 하고 싶은 프로젝트는 .claude/settings.json에 기본 모드를 계획으로 둡니다.

프롬프트:

```text
{ "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)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-plan-mode 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
