Source: https://aiprimetech.io/ko/blog/claude-code-plan-mode/

2026년 8월 14일 · 8분 · 개발자 가이드 

# Claude Code 계획 모드: 사용 방법 및 시간과 토큰을 절약하는 경우 

 A  작성자 [AI Prime Tech](https://aiprimetech.io/ko/)  · AI 활용    

Claude Code 계획 모드에서는 구현을 시작하기 전에 접근 방식을 검토할 수 있습니다. 이 가이드에서는 다음 모드로 들어가고 나오는 방법을 설명합니다: Claude Code 계획 모드, 이를 기본값으로 설정하는 방법과, 계획 수립을 통해 불필요한 검색과 수정 반복을 줄여 시간과 토큰을 절약할 수 있는 시점을 판단하는 방법도 설명합니다. 

## Claude Code 계획 모드의 기능 

계획 모드는 변경 제안과 구현을 분리합니다. Claude는 작업을 조사하고 접근 방식을 제안한 뒤 승인을 기다리므로, 진행하기 전에 계획을 검토하고 조정할 수 있습니다. 

이 [Claude Code 사용자 FAQ](https://support.claude.com/en/articles/14554922-claude-code-user-faq)는 2026년 7월에 작성되었으며, 다음을 설명합니다: plan 승인을 기다리는 읽기 전용 계획 수립 방식입니다. 따라서 구현을 허용하기 전에 Claude가 작업을 어떻게 이해했는지 확인하고 싶을 때 유용합니다. 

읽기 전용이라고 해서 도구를 사용하지 않는다는 뜻은 아닙니다. Claude는 계획을 세우는 동안 파일을 읽고 읽기 전용 도구를 사용할 수 있습니다. 2026년 14월까지 확인 가능한 릴리스 이력에는 Plan Mode로 시작한 세션에서 읽기 전용 도구 호출과 관련된 문제를 수정한 내용이 포함되어 있습니다. 따라서 계획 수립 중에는 모든 명령이나 모든 저장소 검토가 차단된다고 말하면 오해를 불러일으킬 수 있습니다. 

### Plan Mode와 기타 권한 모드 

계획 수립은 Claude가 작업을 제안하는 단계인지, 실제로 수행하는 단계인지를 결정합니다. 구현에 사용하는 권한 모드는 어떤 작업에 승인이 필요한지를 결정합니다. 

  | 모드  | 문서에 명시된 동작  | 고려할 사항    

  | plan  | 읽기 전용으로 계획 수립, 승인 대기  | 구현 전에 접근 방식을 검토할 때 사용하세요.  

  | 수동  | 위험한 편집이나 명령 실행 전에 승인 요청  | 구현 중 이러한 작업에 대한 승인 요청이 표시될 수 있습니다.  

  | acceptEdits  | 파일 편집은 자동으로 승인하지만, 명령 실행에는 여전히 승인이 필요할 수 있음  | 파일 편집 권한과 명령 실행 권한은 별개입니다.  

  | auto  | 백그라운드 안전성 검사를 통해 작업을 자동으로 승인  | 사용 가능 여부는 지원되는 모델과 조직 설정에 따라 달라집니다.    

게시일 기준으로, 이전에 사용되던 default 권한 모드의 표시 이름은 수동입니다. 버전 2.1.200에서 이 표시 이름 변경이 도입되었으며, manual 와 함께 default 도 관련 구성 및 명령줄 설정에서 허용되었습니다. 

## Plan Mode에 진입하고 종료하는 방법 

유용한 진입 방법은 세 가지입니다. 세션 중 권한 모드를 순환하거나, 다음을 사용하거나 /plan, Plan Mode 플래그로 Claude Code를 시작할 수 있습니다. 

### 세션 중 Shift+Tab 사용 

누르세요: Shift+Tab 을 눌러 Plan Mode가 선택될 때까지 권한 모드를 순환하세요. Anthropic의 15년 4월 가이드에 설명된 일반적인 시작 상태에서는 처음 누르면 다음 모드로 진입하고 acceptEdits 두 번째로 누르면 Plan Mode로 진입합니다. 

“두 번 누르기”는 모든 상황에 적용되는 규칙이 아니라 해당 시작 상태에 대한 설명으로 이해하세요. 세션이 이미 다른 모드에 있을 수 있으므로, 모드를 순환하면서 선택된 모드를 확인하세요. 

Plan Mode를 종료하려면 Shift+Tab을 눌러 구현에 사용할 권한 모드로 전환하세요. 먼저 계획을 검토한 다음, 해당 모드에서 합의한 작업을 진행하세요. 

### 다음 명령으로 바로 진입 /plan 

세션 내에서 다음을 사용하세요. 

```
/plan

```

작업을 바로 포함할 수도 있습니다. 

```
/plan fix the auth bug

```

설명 인수는 2026년 10월에 출시된 v2.1.72에 추가되었습니다. 이 인수는 Plan Mode로 진입해 해당 작업의 계획 수립을 시작하므로, 하나의 명령으로 모드와 작업을 모두 지정할 수 있습니다. 

### 새 세션을 Plan Mode로 시작 

계획 수립 모드가 선택된 상태로 시작하려면 다음을 실행하세요. 

```
claude --permission-mode plan

```

구현 전에 조사와 검토가 필요한 작업임을 이미 알고 있을 때 유용합니다. 관련 명령줄 사용법은 다음을 참고하세요. [Claude Code CLI 참조](/ko/claude-code/cli/). 

이 진입 방법들은 모두 동일한 계획 수립 워크플로로 이어집니다. 진행 중인 대화에서는 단축키를 선택하고, /plan 명시적인 명령을 사용하려면 해당 명령을 선택하세요. 계획 수립을 세션의 초기 모드로 설정하려면 시작 플래그를 선택하세요. 

## 바로 구현할 수 있는 계획 수립 

유용한 Claude Code 계획은 제안된 변경 사항을 쉽게 평가할 수 있어야 합니다. Claude가 관련 코드를 식별할 수 있도록 충분한 맥락을 제공하고, 성공적인 구현의 의미를 이해할 수 있도록 충분한 인수 기준을 제공하세요. 

이 [맥락과 더 나은 프롬프트에 관한 가이드](https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts) 에서는 관련 파일 참조를 제공하고, 모드를 전환해 단계를 구현하기 전에 대화에서 계획을 검토할 것을 권장합니다. 

### 알고 있는 경로와 인수 기준 제공 

다음을 사용해 파일을 참조하세요. @path/to/file 관련 코드의 위치를 이미 알고 있을 때 사용하세요. 가이드에 따르면 이러한 참조를 제공하는 것이 Claude가 파일을 찾게 하는 것보다 빠르고 토큰도 적게 사용합니다. 

이러한 경로와 함께 성공의 구체적인 기준을 제시하세요. 예를 들어 인증 버그의 경우, 문제가 발생하는 동작을 설명하고 관련 파일을 지정한 뒤 수정 후 기대하는 동작을 명시할 수 있습니다. 이는 작업을 설명하는 권장 방식이며, 특정 저장소에 대한 주장은 아닙니다. 

포함하면 유용한 정보:  
- 변경해야 하는 동작. 
- 이미 알고 있는 관련 파일. 
- 변경 범위에 대한 제약 조건. 
- 완료된 작업의 인수 기준.  

목적은 구현 전에 불확실성을 줄이는 것입니다. 변경으로 무엇을 달성해야 하는지 설명하지 않고 계획을 요청하는 것보다 원하는 결과를 자세히 설명하는 편이 더 유용합니다. 

### 승인 전에 계획 검토 

제안된 접근 방식이 요청한 동작을 해결하고 의도한 범위 안에 있는지 확인하세요. 여러 파일에 걸친 작업이라면 변경을 진행하도록 허용하기 전에 각 단계가 어떻게 연결되는지 검토하세요. 

계획에 잘못된 이해가 반영되어 있다면 대화에서 바로잡으세요. Anthropic의 지침은 모드를 전환해 단계를 구현하기 전에 계획을 검토하고 조정하는 방식을 명시적으로 지원합니다. 

승인은 접근 방식 검토에서 구현 진행으로 전환하는 시점입니다. 선택한 구현 권한 모드는 여전히 중요합니다. 계획을 승인한다고 해서 Manual과 acceptEdits및 auto 이 동일해지는 것은 아닙니다. 

## 계획 수립이 시간과 토큰을 절약하는 경우 

Claude Code의 계획 모드는 불확실성을 조기에 해소해 불필요한 구현 작업을 방지할 수 있을 때 가장 유용합니다. 잘못된 가정이 제안된 변경의 여러 부분에 영향을 줄 수 있으므로, 여러 파일에 걸친 변경은 계획 수립에 적합한 작업입니다. 

근거가 있는 절약 방식은 구체적입니다. 오해가 큰 규모의 diff로 이어지기 전에 발견하고, 성공 기준을 미리 정의해 수정 횟수를 줄이며, 알고 있는 경로를 제공해 불필요한 파일 검색을 피하는 것입니다. 

### 범위 검토가 필요할 때 계획 수립 활용 

작업이 여러 파일에 걸쳐 있거나 편집을 시작하기 전에 접근 방식을 확인해야 한다면 Plan Mode를 고려하세요. 계획을 검토하면 범위를 좁히거나, 가정을 바로잡거나, 작업 순서를 바꿀 수 있습니다. 

작고 명확하게 정의된 변경이라면 별도의 계획 수립 단계가 의미 있는 불확실성을 해소할지 생각해 보세요. 영향을 받는 파일과 필요한 동작이 이미 명확하다면 긴 계획 수립 대화에서 얻는 이점이 적을 수 있습니다. 

이는 워크플로에 관한 판단이지 벤치마크가 아닙니다. 조사 요약 자료에는 계획 수립이 더 빨라지는 시점을 판단할 수 있는 측정된 임계값이 제시되어 있지 않습니다. 

### 토큰 관련 주장을 정확하게 유지 

계획 수립은 구현 전에 작업 단계를 하나 추가합니다. 잠재적인 이점은 그렇지 않았다면 반복하거나 폐기했을 작업을 피하는 데서 나옵니다. 

토큰 사용량을 평가할 때는 이 차이가 중요합니다. 알고 있는 파일 경로를 제공하면 검색 토큰을 절약할 수 있다는 점은 문서로 뒷받침됩니다. 계획 검토도 오해와 수정 횟수를 줄이는 데 도움이 될 수 있지만, 현재 확인 가능한 근거는 Plan Mode의 순절감량을 정량화하지 않습니다. 

시간이나 토큰이 일정 비율로 감소한다는 주장을 뒷받침하는, 기준일 이전의 공식 벤치마크는 확인되지 않았습니다. 제공된 근거에서도 별도의 Plan Mode 가격이나 사용 한도는 확인되지 않았습니다. 

계획 수립을 활용해 다음 구현 단계의 품질을 높이고, 피할 수 있었던 검색과 수정 작업을 기준으로 절약 효과를 평가하세요. 이 목표에 관한 더 폭넓은 논의는 다음을 참고하세요. [Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/). 

## Plan Mode, opusplan, 그리고 컨텍스트 지우기 

권한 모드와 모델 선택은 별개의 선택 사항입니다. Plan Mode에 진입하면 계획 수립 동작이 선택되고, Opus 계획 수립 구성은 해당 작업을 처리할 모델을 결정합니다. 

### 다음 항목의 opusplan 의미 

버전 1.0.77에는 다음 항목이 도입되었습니다. Opus Plan Mode 에서 /model, 계획 수립에는 Opus를, 그 외에는 Sonnet을 사용합니다. [2026년 14월 기준일의 변경 로그](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.233/CHANGELOG.md) 에도 다음 opusplan 별칭이 문서화되어 있습니다. 

다음을 opusplan 다음 권한 모드와 같은 의미로 취급하지 마세요. plan 권한 모드입니다. 하나는 계획 수립과 기타 작업에 걸친 모델 선택에 관한 것이고, 다른 하나는 읽기 전용 계획 수립과 승인에 관한 것입니다. 

정확한 모델 버전과 그에 따른 절약 효과는 구성에 따라 달라집니다. 제공된 근거는 이 구성에서 일정한 절감 비율이 보장된다고 입증하지 않습니다. [Claude Code 모델 가이드](/ko/claude-code/models/) 에서 권한 설정과 별개로 모델 선택을 살펴볼 수 있습니다. 

### 구현 전에 컨텍스트를 지워야 할까요? 

컨텍스트 지우기는 선택 사항입니다. 2026년 20월에 출시된 버전 2.1.81에서는 계획 승인 시 표시되는 “컨텍스트 지우기” 옵션이 기본적으로 숨겨졌습니다. 

해당 옵션을 복원하려면 다음 설정을 사용하세요. 

```
{
  "showClearContextOnPlanAccept": true
}

```

이 [v2.1.81 릴리스 노트](https://github.com/anthropics/claude-code/releases/tag/v2.1.81) 에 이 변경 사항이 문서화되어 있습니다. 옵션을 복원하면 계획 승인 시 사용할 수 있게 됩니다. 다만 컨텍스트를 지우는 것이 항상 토큰을 절약하거나 구현을 개선한다는 점은 근거로 입증되지 않았습니다. 

## 계획 수립을 기본값으로 설정 

구현 전에 접근 방식을 검토하는 것을 일상적으로 원한다면 Plan Mode를 기본값으로 구성할 수 있습니다. 

```
{
  "permissions": {
    "defaultMode": "plan"
  }
}

```

A [2025년 28월의 저장소 토론](https://github.com/anthropics/claude-code/issues/2798) 에서는 이 구성을 다음 위치에 둡니다. ~/.claude/settings.json. 

여기에는 출처에 관한 단서가 있습니다. 날짜가 명시된 예시는 Anthropic의 공식 저장소에 게시된 커뮤니티 댓글입니다. 현재의 공식 권한 모드 문서도 이 구성을 뒷받침하지만, 과거 수정 날짜는 확실하지 않습니다. 

개별 세션에서 계획 수립을 사용하려면 시작 플래그를 사용하세요. 먼저 계획을 검토하는 것이 일상적인 워크플로라면 기본 설정을 고려하세요. 어느 경우든 제안된 접근 방식을 검토하고 조정한 다음, 구현을 위해 모드를 전환할 수 있습니다. 

## 핵심 요점  
- 계획 모드는 승인 단계를 포함하는 읽기 전용 계획 수립 모드입니다. 접근 방식을 준비하는 동안 파일을 살펴보고 읽기 전용 도구를 사용할 수 있습니다. 
- 진입하려면 다음을 사용하세요 Shift+Tab, /plan, 또는 claude --permission-mode plan; 필요한 단축키 입력 횟수는 시작 모드에 따라 달라집니다. 
- 검색과 수정 반복을 줄이려면 알고 있는 파일 경로와 수용 기준을 제공하세요. 
- 계획 수립은 여러 파일에 걸친 변경 사항을 검토할 때 특히 유용하지만, 시간이나 토큰을 일정 비율로 절감한다는 근거는 확립되어 있지 않습니다. 
- opusplan 는 모델 선택에 관한 것이며, 컨텍스트 초기화는 계획 승인 시 선택할 수 있는 설정입니다.  

## 자주 묻는 질문 

### Shift+Tab으로 계획 모드에 진입하고 종료하려면 어떻게 하나요? 

계획 모드가 선택될 때까지 Shift+Tab을 눌러 권한 모드를 전환하세요. 종료하려면 구현에 사용할 모드로 전환하세요. 필요한 입력 횟수는 세션의 현재 모드에 따라 달라집니다. 

### 계획 모드에서 파일을 읽거나 셸 명령을 실행할 수 있나요? 

계획 모드는 계획을 준비하는 동안 파일을 읽고 읽기 전용 도구를 사용할 수 있습니다. 모든 명령을 차단한다고 말하는 것은 부정확하지만, 문서에 명시된 동작은 구현 전에 승인을 기다리는 읽기 전용 계획 수립입니다. 

### 모든 세션을 계획 모드로 시작하려면 어떻게 하나요? 

설정할 항목: permissions.defaultMode 다음으로 변경되었습니다. "plan" 에서 ~/.claude/settings.json. 이는 날짜가 명시된 저장소 토론에 나와 있습니다. 단일 세션에서는 다음 명령으로 Claude Code를 시작하세요 claude --permission-mode plan. 

### 계획 모드는 토큰을 절약하나요? 

알고 있는 파일 경로를 제공하면 검색에 필요한 토큰을 절약할 수 있고, 수용 기준을 정의하면 수정 반복을 줄일 수 있습니다. 계획 수립 자체도 작업을 추가하므로 순절감 효과는 어떤 작업을 피할 수 있게 해 주는지에 따라 달라집니다. 제공된 근거로는 고정된 절감 비율이나 공식적인 순절감 벤치마크를 확인할 수 없습니다. 

[Claude](/ko/blog/tag/claude/)[코딩](/ko/blog/tag/coding/)[에이전트](/ko/blog/tag/agents/) 

A

[AI Prime Tech](https://aiprimetech.io/ko/)

이 블로그는 AI Prime Tech가 발행합니다. 기사는 AI의 도움을 받아 초안을 작성합니다. 모델 ID, 가격, 한도 등 버전별 세부 정보는 활용하기 전에 공식 문서와 대조해 확인하세요. 

 더 저렴하게 Claude API 이용하기 

API 키 하나로 Claude Opus 5.5, Sonnet 5, Haiku 4.5, Fable 5.1 및 GPT-6개 모델을 이용하세요. 구독 없이 사용한 만큼만 결제합니다. [API 키 받기 →](/register)  

AI Prime Tech는 독립적인 타사 API 게이트웨이입니다. Claude™ 및 Anthropic®는 Anthropic, PBC의 상표입니다. 제휴 또는 보증 관계를 의미하지 않습니다.