Claude Code 사용법 실전 키트: 설정·템플릿·지시 패턴 정리

목차

1. 1. 시작하며: 이 키트 사용법

   Claude Code를 설치해 보긴 했는데 "지시와 다르게 움직인다", "매번 같은 설명을 반복한다", "확인 대화상자가 너무 많다". 이 책은 그런 상태에서 벗어나기 위한 부탁하는 법과 설정을, 복사해서 바로 쓸 수 있는 형태로 정리했습니다.

   읽기링크 복사
   절 4개 보기

   • 이 책에서 얻을 수 있는 것
   • 무료 공개분과 겹치는 부분
   • 추천하는 읽는 순서
   • 주의 사항

2. 2. 맡기기 위한 7원칙

   Claude Code는 "질문에 답하는 챗봇"이 아니라 "직접 손을 움직이는 동료"입니다. 동료에게 일을 부탁할 때와 마찬가지로 목표·제약·완료 조건을 건네면 결과물이 안정됩니다.

   읽기링크 복사
   절 8개 보기

   • 원칙 1: 목표는 "무엇을 하고 싶은가"가 아니라 "어떤 상태가 되면 완료인가"로 쓴다
   • 원칙 2: 검증 수단을 반드시 건넨다
   • 원칙 3: CLAUDE.md는 "신입용 인수인계 메모"로 쓴다
   • 원칙 4: 큰 작업은 "계획 → 승인 → 구현"으로 나눈다
   • 원칙 5: 컨텍스트는 유한하다. 주제가 바뀌면 리셋
   • 원칙 6: 권한은 "자주 쓰는 안전한 것"만 미리 허용한다
   • 원칙 7: 반복하는 지시는 "스킬"이나 "커맨드"로 만든다
   • 정리: 부탁하는 법 체크리스트

3. 3. 지시 패턴 12가지

   그대로 복사해서 【】 안을 채워 쓰세요.

   읽기링크 복사
   절 12개 보기

   • 1. 버그 수정
   • 2. 기능 추가(소)
   • 3. 기능 추가(대) ── 계획부터
   • 4. 리팩터링
   • 5. 코드베이스 조사
   • 6. 코드 리뷰
   • 7. 테스트 추가
   • 8. 에러 로그 분석
   • 9. 의존성 업데이트
   • 10. 문서 작성
   • 11. 커밋·PR 작성
   • 12. 작업을 끝까지 맡기기(긴 자율 작업)

4. 4. CLAUDE.md 템플릿 4종

   templates/CLAUDE.md.web

   읽기링크 복사
   절 4개 보기

   • Web 앱용
   • Python용
   • 모바일 앱용
   • 프로그래밍 외 잡무용

5. 5. 권한 설정(settings.json) 기본형

   templates/settings.json

   읽기링크 복사
   절 1개 보기

   • 두는 위치와 사고방식

6. 6. 훅 설정 예시 3종

   훅은 "Claude가 특정 조작을 했을 때 정해진 처리를 자동으로 실행하는" 장치입니다. 지시(부탁)가 아니라 장치로 강제할 수 있으므로 반드시 지키게 하고 싶은 것에 씁니다.

   읽기링크 복사
   절 7개 보기

   • 동작 원리 요점
   • 한계(반드시 읽어 주세요)
   • 주의
   • 자동 포맷(auto-format.json)
   • 위험 명령 차단(block-dangerous.json)
   • 막히는 예·막히지 않는 예(실측)
   • 완료 알림(notify-done.json, macOS)

7. 7. 스킬(절차서) 샘플 3종

   스킬은 "특정 작업의 절차서"를 담은 파일입니다. .claude/skills//SKILL.md에 두면 Claude가 작업 내용에 맞춰 자동으로 읽어 들입니다(/스킬이름으로 명시적으로 호출할 수도 있습니다).

   읽기링크 복사
   절 4개 보기

   • 수록 샘플
   • release-check
   • pr-description
   • weekly-report

8. 8. 자주 겪는 실패와 대처법

   2026년 10월 기준 공식 문서에는 "#"로 시작하는 메시지로 CLAUDE.md에 추가하는 방법이 안내되어 있지 않습니다. 문서가 안내하는 방법은 Claude에게 "이걸 CLAUDE.md에 추가해줘"라고 직접 요청하거나, /memory로 파일을 열어 직접 편집하는 것입니다.

   읽기링크 복사
   절 1개 보기

   • 막혔을 때의 기본 동작