고급 설정

기본 사용에 익숙해졌다면, 이 설정들로 Claude Code를 나만의 도구로 만들 수 있습니다.

CLAUDE.md — 나만의 규칙 파일

CLAUDE.md는 Claude Code에게 "항상 이렇게 해줘"를 미리 알려두는 설정 파일입니다. 매번 같은 말을 반복하지 않아도 됩니다.

전역 설정 (~/.claude/CLAUDE.md): 모든 작업에 항상 적용
프로젝트 설정 (./CLAUDE.md): 특정 폴더에서만 적용

일반 사용자 예시

markdown

# 내 작업 규칙

## 기본 설정
- 항상 한국어로 답해줘
- 존댓말 사용
- 파일 삭제하기 전에 꼭 먼저 물어봐줘
- 작업 시작 전에 무엇을 할 건지 한 줄로 알려줘

## 글쓰기 스타일
- 문장은 간결하게, 한 문장에 하나의 내용만
- 블로그 글은 감성적인 톤으로
- 보고서는 항목별 목록 형식으로

## 금지 사항
- 영어로 답하지 말 것 (코드 제외)
- 확인 없이 중요한 파일 덮어쓰기 금지

개발자 프로젝트 예시

markdown

# 프로젝트 규칙

## 기술 스택
- 언어: TypeScript
- 프레임워크: Next.js
- 테스트: Jest

## 작업 규칙
- 커밋 전 반드시 테스트 실행
- 함수 주석은 한국어로
- 외부 라이브러리 추가 전에 먼저 알려줘

권한(Permissions) 설정

Claude Code가 실행할 때마다 확인을 받는 수준을 조절합니다.

모드	설명	언제 쓰나요?
`default`	모든 작업 전에 확인	처음 사용할 때, 중요한 파일 다룰 때
`acceptEdits`	파일 수정은 자동, 명령 실행은 확인	글쓰기·편집 작업에 집중할 때
`bypassPermissions`	모든 작업 자동 실행, 확인 없음	믿을 수 있는 반복 작업
`plan`	계획만 세우고 실행은 직접 승인	큰 작업의 방향을 먼저 검토할 때

권한 모드는 Shift+Tab으로 빠르게 전환하거나 아래 명령어로 바꿀 수 있습니다.

bash

/permissions set acceptEdits
/permissions set default

Skills — 자주 쓰는 작업을 명령어로

반복되는 작업 절차를 슬래시 명령어 하나로 실행할 수 있게 만드는 기능입니다.

예를 들어 /writing이라는 스킬을 만들면:

bash

/writing 여행 블로그 써줘

한 줄로 글쓰기 전체 프로세스(주제 분석 → 구조 잡기 → 초안 작성 → 파일 저장)가 실행됩니다.

스킬은 ~/.claude/skills/ 폴더에 Markdown 파일로 만듭니다. 설치 가이드의 스킬 설치하기 섹션을 참고하세요.

Hooks — 자동 실행 규칙 (고급)

특정 시점에 자동으로 추가 작업이 실행되도록 설정하는 기능입니다.

파일 저장할 때마다 자동으로 git에 기록
위험한 명령어 실행 전 자동 경고
작업 완료 후 알림 발송

~/.claude/settings.json에서 설정합니다. 처음에는 건드리지 않아도 무방합니다.

Sub-agents — 복잡한 작업 병렬 처리 (고급)

Claude Code가 큰 작업을 여러 개의 독립적인 하위 작업으로 나눠 동시에 처리하는 방식입니다.

예를 들어 "웹사이트 5페이지 만들어줘"라는 요청을 받으면, 각 페이지를 별도 에이전트가 동시에 작업해서 시간을 단축합니다.

사용자가 직접 설정하는 기능은 아니며, Claude Code가 적절하다고 판단할 때 자동으로 활용합니다.