Tech / AI / 자동차 최신 정보

  • Home
  • IT | AI
  • 클로드 코드(Claude Code) 완전 초보 가이드 2부 — Plan Mode·CLAUDE.md·실전 프롬프트 총정리

클로드 코드(Claude Code) 완전 초보 가이드 2부 — Plan Mode·CLAUDE.md·실전 프롬프트 총정리

1부에서 설치와 첫 실행까지 마치셨나요? 수고하셨습니다. 이제 진짜 클로드 코드의 힘을 쓸 차례입니다.

2부에서는 처음엔 잘 모르고 지나치기 쉬운데, 알고 나면 완전히 달라지는 핵심 기능들을 집중적으로 다룹니다. Plan Mode, CLAUDE.md, 실전 프롬프트 모음, Cursor와의 비교까지 — 이것만 알아도 클로드 코드 입문은 완성입니다.

👈 1부(클로드 코드(Claude Code) 완전 초보 가이드 1부 — 설치부터 첫 실행까지)를 먼저 읽고 오시면 더 좋습니다.


🛡️ Plan Mode — 초보자에게 가장 중요한 기능

클로드 코드를 처음 쓸 때 가장 무서운 게 뭔지 아세요? “AI가 내 파일을 맘대로 바꾸면 어떡하지?”입니다. 그 걱정을 해결해주는 게 Plan Mode(계획 모드)예요.

Plan Mode를 켜면 클로드의 행동 방식이 완전히 바뀝니다. 명령을 받으면 바로 실행하는 게 아니라, 먼저 이렇게 동작합니다.

  1. 관련 파일을 전부 읽고 상황을 파악합니다
  2. 무엇을, 어떤 순서로, 왜 바꿀지 단계별 계획을 보여줍니다
  3. 여러분의 승인을 기다립니다
  4. OK 하면 그때 실행합니다

즉, 클로드가 무슨 짓을 할지 미리 보고 허락하는 구조예요. 실수로 중요한 파일을 날릴 걱정이 없어집니다.

Plan Mode 켜는 법은 간단합니다. 클로드 코드 실행 중에 Shift + Tab을 누르면 모드가 순환합니다.

  • 일반 모드(Normal): 작업마다 허가 요청. 기본값
  • 계획 모드(Plan): 계획 먼저 보여주고 승인 후 실행
  • 자동 수락 모드(Auto Accept): 모든 작업 자동 허가. 경험자용

초보자라면 반드시 계획 모드로 시작하세요. 익숙해지기 전에는 클로드가 무슨 생각을 하는지 먼저 보는 습관을 들이는 게 중요합니다.


📝 CLAUDE.md — 클로드에게 나만의 지침 주기

클로드 코드는 세션을 새로 시작하면 이전 대화를 기억하지 못합니다. 매번 “나는 이런 스타일로 코드를 짜줘, 이건 절대 하지 마” 같은 말을 반복하기 귀찮죠. 이걸 해결하는 게 CLAUDE.md 파일입니다.

프로젝트 폴더 안에 CLAUDE.md라는 파일을 만들어두면, 클로드 코드가 실행될 때마다 이 파일을 자동으로 읽어서 지침으로 삼습니다. 일종의 클로드에게 보내는 ‘상시 메모’예요.

CLAUDE.md 예시


# 프로젝트 규칙

## 코딩 스타일
- 주석은 모두 한국어로 작성할 것
- 함수명은 영어, 변수명은 카멜케이스 사용
- 파일 하나에 200줄 넘으면 분리할 것

## 절대 하지 말 것
- .env 파일 절대 수정 금지
- package.json 임의로 변경하지 말 것
- 테스트 파일 삭제 금지

## 이 프로젝트 소개
- Next.js 14 기반 블로그 프로젝트
- 데이터베이스는 Supabase 사용
- 배포는 Vercel




이 파일 하나로 매번 같은 설명을 반복하는 수고를 덜 수 있어요. 팀으로 개발한다면 이 파일을 Git에 올려서 팀원 전체가 동일한 지침을 공유하는 방식으로도 활용합니다.


💬 실전 프롬프트 모음 — 이렇게 시켜보세요

클로드 코드를 처음 쓰면 “뭘 어떻게 말해야 하지?”가 막막합니다. 실제로 바로 써먹을 수 있는 프롬프트를 상황별로 모아봤어요. 그냥 복붙해서 써도 됩니다.

📂 프로젝트 파악할 때

이 프로젝트 전체 구조를 파악하고 어떤 기술을 쓰는지, 어떻게 구성되어 있는지 한국어로 설명해줘
이 프로젝트에서 가장 중요한 파일 5개를 골라서 각각 어떤 역할을 하는지 설명해줘

🐛 버그 잡을 때

로그인할 때 아래 에러가 나는데 원인 찾아서 고쳐줘: [에러 메시지 붙여넣기]
이 기능이 작동을 안 하는데 왜 그런지 찾아서 수정해줘. 수정 전에 계획 먼저 보여줘

✨ 새 기능 만들 때

회원가입 폼에 이메일 형식 검사 기능 추가해줘. 이메일 형식이 아니면 빨간 글씨로 경고 메시지 보여줘
현재 영어로 된 에러 메시지들을 전부 한국어로 바꿔줘

🧹 코드 정리할 때

이 파일에서 중복되거나 쓰지 않는 코드를 찾아서 정리해줘. 기능은 그대로 유지해야 해
코드 전체에서 주석이 없는 함수에 한국어 주석 달아줘

📄 문서 만들 때

이 프로젝트의 README.md 파일을 한국어로 새로 써줘. 설치 방법, 사용법, 환경 변수 설명 포함해서
API 엔드포인트 목록을 정리해서 API.md 파일로 만들어줘

🔒 보안 점검할 때

이 코드에서 보안 취약점이 있는 부분을 찾아서 위험도 순서로 정리해줘. 수정은 내가 확인 후 진행할게
.env 파일 없이 API 키가 코드 안에 하드코딩된 부분이 있으면 찾아줘

🆚 클로드 코드 vs Cursor — 뭐가 다른가요?

클로드 코드와 함께 자주 비교되는 도구가 Cursor입니다. 둘 다 AI 코딩 도구인데 어떻게 다른지 정리해드릴게요.

구분클로드 코드Cursor
인터페이스터미널(CLI)VS Code 기반 GUI
진입 장벽조금 있음 (터미널)낮음 (에디터처럼 사용)
자율성높음 (에이전트처럼 동작)중간 (보조 도구에 가까움)
대규모 작업매우 강함중간
코드 자동완성제한적강력함
월 비용$20~$200$20 (Pro)
AI 모델Claude 전용GPT-4, Claude 등 선택 가능

쉽게 말하면, Cursor는 코드 작성을 도와주는 스마트한 에디터이고, 클로드 코드는 프로젝트 전체를 스스로 파악하고 움직이는 에이전트입니다. 둘은 경쟁 관계라기보다 용도가 조금 다릅니다. 많은 개발자들이 두 가지를 상황에 맞게 병행해서 씁니다.

코딩 경험이 없는 비개발자라면 처음엔 클로드 코드로 시작하는 걸 추천합니다. 파일을 직접 편집하는 에디터보다 터미널에서 말로 시키는 방식이 더 직관적으로 느껴지는 경우가 많거든요.


🧠 조금 더 잘 쓰는 꿀팁 3가지

① 큰 작업은 작게 쪼개서 시키세요

“이 앱 전체 리팩토링해줘”보다 “로그인 모듈만 먼저 리팩토링해줘”가 훨씬 잘 됩니다. 범위가 넓을수록 클로드도 방향을 잃기 쉽거든요. 작업을 잘게 나눠서 하나씩 확인하면서 진행하는 게 훨씬 안전하고 품질도 좋습니다.

② 민감한 정보 파일은 명시적으로 알려주세요

.env 파일이나 API 키가 담긴 설정 파일이 있다면, CLAUDE.md에 “이 파일들은 절대 수정하지 마”라고 명시해두세요. 클로드가 실수로 접근하는 걸 방지할 수 있습니다.

③ 결과를 꼭 확인하세요

클로드 코드는 아주 훌륭하지만 완벽하지는 않습니다. 특히 큰 변경 후에는 꼭 직접 테스트해보는 습관이 필요해요. 클로드가 수정을 제안할 때 diff(변경 내용 비교)를 꼼꼼히 읽는 습관도 중요합니다. “AI가 했으니까 맞겠지”는 가장 위험한 생각입니다.


✍️ 마치며 — 코딩, 이제 말로 하세요

1부와 2부를 모두 읽으셨다면, 클로드 코드를 시작하는 데 필요한 건 다 갖추셨습니다.

처음에는 터미널이 낯설고, 어떻게 말해야 할지 막막할 수도 있어요. 하지만 결국은 그냥 대화입니다. “이거 해줘”, “왜 이렇게 됐어”, “다른 방법은 없어?” — 이게 전부예요. 생각보다 훨씬 빠르게 손에 익습니다.

클로드 코드를 한 달만 써보면, 쓰기 전으로는 돌아가기 싫어질 거예요. 직접 경험해보세요.


Releated Posts

구글 제미나이, 맥 네이티브 앱 출시 — Option+Space로 어디서든 바로

📌 핵심 요약: 구글이 2026년 4월 15일 제미나이 앱을 맥OS 네이티브 데스크톱 경험으로 출시했습니다. Google AI 어시스턴트 중…

ByByderella sohn 4월 19, 2026

Ollama의 한계와 로컬 LLM 생태계 대안 완전 정리

📌 핵심 요약: Ollama는 로컬 LLM 입문의 표준으로 자리 잡았지만, 성능 병목, 보안 취약점, 텔레메트리 불투명성, 그리고 클라우드…

ByByderella sohn 4월 19, 2026

앤트로픽, ‘Claude Design’ 출시 — 피그마 주가 즉시 하락

📌 핵심 요약: 앤트로픽이 2026년 4월 17일, 프로토타입, 슬라이드, 원페이저 등 시각적 결과물을 Claude로 만들 수 있는 새로운…

ByByderella sohn 4월 18, 2026

클로드 코드 데스크톱 앱 전면 개편 — 여러 작업을 동시에

앤트로픽이 2026년 4월 14일, 동시에 더 많은 클로드 코드 작업을 실행할 수 있도록 설계된 클로드 코드 데스크톱 앱…

ByByderella sohn 4월 18, 2026
1 Comments Text

댓글 남기기

Sohnderella에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기