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

OpenAI Codex 대규모 업데이트 — 코딩 툴을 넘어 맥 전체를 제어

📌 핵심 요약: OpenAI가 2026년 4월 16일 Codex의 대규모 업데이트를 공개했습니다. 매주 300만 명 이상의 개발자가 사용하는 Codex가…

ByByderella sohn 4월 21, 2026

크롬이 AI 브라우저로 완전히 바뀌고 있다 — 오토 브라우즈부터 Skills까지

📌 핵심 요약: 구글이 2026년 들어 크롬에 AI 기능을 집중적으로 쏟아붓고 있습니다. 1월 제미나이 사이드패널과 오토 브라우즈, 3월…

ByByderella sohn 4월 21, 2026

금융권 망분리 규제 완화 — SaaS 허용부터 3단계 전환 총정리

금융위원회·금융감독원이 2026년 1월 20일, 금융회사가 내부 업무망에서 클라우드 기반 응용소프트웨어(SaaS)를 활용할 경우 일정한 보안 규율을 준수하는 전제로 망분리…

ByByderella sohn 4월 20, 2026

Vercel 보안 사고 발생 — 써드파티 AI 툴 통해 내부 시스템 침투

이 글은 2026년 4월 20일 기준으로 작성됐습니다. Vercel의 보안 조사가 현재 진행 중이며 상황이 빠르게 변하고 있습니다. 최신…

ByByderella sohn 4월 20, 2026
1 Comments Text

댓글 남기기

Sohnderella에서 더 알아보기

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

계속 읽기