Claude Code 제대로 쓰기 — CLAUDE.md·권한 모드·계획 모드
설치만 하고 쓰면 매번 같은 설명을 반복하고, 큰 수정이 한 번에 엉켜요. 공식 문서가 권하는 세 가지 — 프로젝트 설명서(CLAUDE.md), 권한 모드, 계획 모드 — 만 익혀도 결과가 확 달라집니다.
따라 하기
1단계
프로젝트 설명서 CLAUDE.md 만들기
- 1프로젝트 폴더에서 claude를 실행하고 /init을 입력하면 Claude Code가 프로젝트를 살펴보고 CLAUDE.md 초안을 만들어요.
- 2여기엔 매 대화마다 알아야 할 사실 — 빌드·테스트 명령, 코딩 규칙, 폴더 구조, 항상 이렇게 하라는 규칙 — 을 적습니다.
- Claude Code는 대화를 시작할 때마다 이 파일을 읽어요.
# CLAUDE.md 명령과 위치 /init — CLAUDE.md 초안 만들기 /memory — CLAUDE.md 열어서 고치기 # CLAUDE.md 위치 (공식 문서) ./CLAUDE.md — 팀과 공유하는 프로젝트 규칙 ~/.claude/CLAUDE.md — 나만의 규칙, 모든 프로젝트에 적용 ./CLAUDE.local.md — 이 프로젝트에서 나만 쓰는 규칙
claude.ai/download
팁 공식 문서(2026-09-15 확인)의 기준: Claude가 같은 실수를 두 번 하거나, 지난번에 한 설명을 또 하게 되면 CLAUDE.md에 적을 때예요. 여러 단계짜리 절차는 CLAUDE.md보다 스킬로 빼는 게 좋아요.
막히면 볼 것
자주 하는 실수 3가지
- 같은 규칙을 대화마다 다시 설명함 — 두 번 말했으면 CLAUDE.md에 적으세요(공식 문서의 기준)
- 큰 기능을 바로 '만들어줘'로 시작함 — Plan 모드에서 계획부터 받고 고친 뒤 진행하면 되돌릴 일이 줄어요
- 대화 하나에 여러 작업을 계속 이어감 — 주제가 바뀌면 /clear로 새로 시작하세요. 앞 대화는 /resume으로 다시 열 수 있어요