Claude Code Plan Mode 완벽 설치 가이드: 초보자도 30분 만에 터미널 AI 코딩 시작하기 (2026)

작성자:

우선 설명하기에 앞서 플랜모드(Plan Mode)는 일반 대화보다 토큰을 더 많이 사용하는 경향이 있다고 한다.
그 이유는 아래에도 설명하지만, 짤막하게 요약한다면 일반 대화와의 차이 일반 대화는 질문에 바로 답하지만, 플랜 모드는 “계획 수립 → 실행 → 검증”의 과정을 거치기 때문에 같은 작업이라도 더 많은 토큰이 필요

[요약]
– 복잡한 작업을 단계별로 나누어 계획을 먼저 세움
– 각 단계를 실행하면서 중간 결과를 확인
– 필요시 계획을 수정하거나 조정
– 이 모든 과정이 토큰으로 처리됨

토큰은 더 들지만, 복잡한 코딩, 여러 파일 작업, 단계적 분석이 필요한 작업에서는 더 정확하고 체계적인 결과를 얻을 수 있다.

그래도, 사용해보고 싶어서 일단 플랜모드 세팅에 도전하기로 마음을 먹었다

Claude Code의 Plan Mode를 처음부터 끝까지 설치하고 실행하는 완벽 가이드를 AI와 대화하면서 나눈 내용을 요약 정리했다.
macOS 사용자 기준으로 PATH 문제, 인증 오류 등 모든 함정을 피하는 방법까지 AI가 기입해줬고, 매 순간마다 맞는지 아닌지 아직 코드를 분석 할 줄 몰라서 캡쳐해서 현재 상황이 맞는지 재확인을 했다.

Claude Code Plan Mode가 뭔가요?

Claude Code는 Anthropic의 Claude AI를 터미널에서 실행하는 CLI 도구이다.
Plan Mode는 코드 수정 없이 코드베이스 분석 → 개발 계획 수립만 하는 읽기 전용 모드로, 시니어 개발자의 사전 설계 과정을 자동화한다. ​

주요 장점:

  • 코드 작성 전 전체 구조 파악
  • 오류 발생률 70% 감소
  • 대형 리팩토링 계획 수립에 최적

1. 사전 준비사항 (Node.js 확인)

먼저 Node.js가 설치되어 있는지 확인이 필요하다.

bashnode --version
npm --version

없다면 nodejs.org에서 LTS 버전 다운로드. 설치 후 터미널 재시작 필수이다.

2. Claude Code 설치 (curl 한 방)

bashcurl -fsSL https://claude.ai/install.sh | bash

– 버전 2.25/3.25 표시되면 성공!​

PATH 오류 해결 (가장 흔한 문제)

textecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
which claude  # /Users/사용자/.local/bin/claude 출력 확인 [file:70]

PATH 확인 명령어:

bashclaude --help  # 도움말 나오면 완벽

3. 테스트 프로젝트 생성

bashmkdir claude-test
cd claude-test
echo "console.log('Hello Claude!');" > hello.js

간단한 hello.js 파일로 Plan Mode 테스트 준비 완료.​

4. Claude Code 실행 및 초기 설정

bashclaude

실행 성공 화면:​

  • 환영 메시지 “Welcome to Claude Code v2.25”
  • 테마 선택 (1번 Dark mode 추천)
  • Shift+Tab으로 Plan Mode 전환 가능

클로드 코드 모드가 일단 너무 귀여워서, 옛날 DOS 게임 감성이 샘솟았다…!

회사에서 pro계정을 줘서, 이번해는 클로드 구독을 하지 않았는데,,, 아뿔사!
개인 계정이 마지막에 되어있어서, 처음에 로그인에 실패해서 당황 했었다. 그러나 AI와 함께 차근차근 문제를 풀어나갔다.

5. Anthropic 인증 과정 (Pro 계정 필수)

인증 선택 화면:​

text1. Anthropic Console 계정 (추천)
3. Amazon Bedrock 등 파티

1번 선택 → 긴 URL 복사:​

  1. 전체 URL 복사 (Cmd+A → Cmd+C)
  2. 새 브라우저 탭 → Pro 계정 로그인
  3. “Success” 페이지 단축 코드 복사
  4. 터미널 붙여넣기 Enter

인증 오류 해결:​

text"Invalid code" → Enter → 재시도
코드 복사 시 공백/줄바꿈 제거 필수

클로드 pro 계정을 로그인 후, 해당 영역의 링크를 붙여넣기 하면 code가 노출 되는데, 그 코드를 입력 하고 나면

pro 계정의 팀과 회사 이름, 그리고 내 이름이 노출 되면서 세팅이 완료 되었다.
그리고 AI는 잘 동작하는지 테스트 해보라고 테스트 예제를 주었다

그리고, 이 캡쳐화면을 보니 토큰이 녹는다는 Opus 4.5로 기본으로 세팅 되어있어다…!

6. 보안 설정 및 프로젝트 신뢰

폴더 신뢰 확인:​

text1. Yes, trust this folder (Enter)

이 단계에서 Claude가 hello.js를 인식합니다.

7. Plan Mode 활성화 방법

핵심 단축키: Shift+Tab 두 번 누으면 위의 이미지의 영역에 모드가 바뀐다​

활성화 확인:

text[Plan Mode] 표시
파일 수정 불가 → 계획 수립만 가능

8. Plan Mode 실전 테스트

입력창에서:

text/init  # 프로젝트 스캔 [file:92]

테스트 프롬프트:

text"hello.js 분석 후 Express 웹 서버 추가 계획 세워줘"

기대 결과:

  1. 현재 파일 구조 분석
  2. 의존성 설치 계획 (npm init, express 등)
  3. 파일 구조 제안
  4. 구현 순서 roadmap

9. Plan Mode → 기본 모드 전환

textShift+Tab 두 번 더  # 또는 /normal

이제 코드 실제 수정 가능:

text"계획대로 Express 서버 구현해줘"

10. 자주 발생하는 오류와 해결책

오류해결책스크린샷
claude: command not foundPATH 재설정 + 터미널 재시작 ​
Invalid code전체 코드 복사, 새 브라우저 탭 ​
다른 계정 로그인claude.ai 로그아웃 → Pro 계정 재로그인
PATH 경고 반복~/.local/bin/claude 직접 실행 ​

11. 고급 Plan Mode 활용법

구조화된 프롬프트 템플릿

text1. 현재 코드베이스 분석
2. 제약사항: [Node 18, ESM only]
3. 목표 기능: [사용자 인증 REST API]
4. 구현 계획을 단계별로 작성해줘

메타 프롬프트

text"최적의 Plan Mode 프롬프트를 자동 생성해줘"

12. VS Code, Cursor와 비교

도구장점단점
Claude Code Plan Mode계획 수립 정확도 최고, 터미널 가볍다학습 곡선 있음
Cursor직관적 UI로컬 실행 불가
VS Code Copilot익숙함컨텍스트 이해 부족

13. 한국어 사용자 팁

  • 프롬프트 한국어 100% 지원
  • /ko 명령어로 한국어 모드 고정
  • velog, tistory 등 한국 블로그 가이드 참고​

14. 성능 최적화 설정

~/.claude/config.json:

json{
  "model": "claude-3.5-sonnet",
  "maxTokens": 128000,
  "planModeDefault": true
}

15. 왜 Plan Mode일까?

코드베이스를 수정하지 않고 분석·계획만 세우는 읽기 전용 모드로, 즉시 코딩의 함정을 피합니다. 이는 개발 생산성을 2-3배 높이고 버그를 60-70% 줄이는 효과가 있다.

계획 중심 개발

Plan Mode는 “생각 → 계획 → 구현” 워크플로를 강제해 코드베이스 전체를 먼저 이해하게 합니다. 일반 AI 코딩(직접 작성 → 수정 반복)과 달리 구조적 리스크를 사전 차단합니다.​

오류 감소 효과

– 계획 문서 생성: 팀 공유 용이
– 파일 읽기만 가능: 실수 수정 방지
– 전체 프로젝트 분석: 숨겨진 버그 발견

​

상황Plan Mode 추천 이유
대형 리팩토링전체 구조 파악 필수 claude-ai​
신규 기능 추가의존성 충돌 예측
코드 리뷰객관적 분석 보고서

댓글 남기기