Claude Code 제대로 쓰기 — CLAUDE.md·권한 모드·계획 모드

기초약 20분5단계Claude Code 제대로 쓰기 코스 2/4

설치만 하고 쓰면 매번 같은 설명을 반복하고, 큰 수정이 한 번에 엉켜요. 공식 문서가 권하는 세 가지 — 프로젝트 설명서(CLAUDE.md), 권한 모드, 계획 모드 — 만 익혀도 결과가 확 달라집니다.

따라 하기

1단계 / 5

프로젝트 설명서 CLAUDE.md 만들기

  1. 1프로젝트 폴더에서 claude를 실행하고 /init을 입력하면 Claude Code가 프로젝트를 살펴보고 CLAUDE.md 초안을 만들어요.
  2. 2여기엔 매 대화마다 알아야 할 사실 — 빌드·테스트 명령, 코딩 규칙, 폴더 구조, 항상 이렇게 하라는 규칙 — 을 적습니다.
  3. Claude Code는 대화를 시작할 때마다 이 파일을 읽어요.
Claude Code 열기
한눈에 정리
# CLAUDE.md 명령과 위치
/init — CLAUDE.md 초안 만들기
/memory — CLAUDE.md 열어서 고치기

# CLAUDE.md 위치 (공식 문서)
./CLAUDE.md — 팀과 공유하는 프로젝트 규칙
~/.claude/CLAUDE.md — 나만의 규칙, 모든 프로젝트에 적용
./CLAUDE.local.md — 이 프로젝트에서 나만 쓰는 규칙

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

claude.ai/download
claude
Claude Desktop
Anthropic
여기를 클릭!
무료 · v1.x

팁 공식 문서(2026-09-15 확인)의 기준: Claude가 같은 실수를 두 번 하거나, 지난번에 한 설명을 또 하게 되면 CLAUDE.md에 적을 때예요. 여러 단계짜리 절차는 CLAUDE.md보다 스킬로 빼는 게 좋아요.

막히면 볼 것

자주 하는 실수 3가지
  1. 1같은 규칙을 대화마다 다시 설명함 — 두 번 말했으면 CLAUDE.md에 적으세요(공식 문서의 기준)
  2. 2큰 기능을 바로 '만들어줘'로 시작함 — Plan 모드에서 계획부터 받고 고친 뒤 진행하면 되돌릴 일이 줄어요
  3. 3대화 하나에 여러 작업을 계속 이어감 — 주제가 바뀌면 /clear로 새로 시작하세요. 앞 대화는 /resume으로 다시 열 수 있어요