고급 설정
기본 사용에 익숙해졌다면, 이 설정들로 Claude Code를 나만의 도구로 만들 수 있습니다.
CLAUDE.md — 나만의 규칙 파일
CLAUDE.md는 Claude Code에게 "항상 이렇게 해줘"를 미리 알려두는 설정 파일입니다. 매번 같은 말을 반복하지 않아도 됩니다.
- 전역 설정 (
~/.claude/CLAUDE.md): 모든 작업에 항상 적용 - 프로젝트 설정 (
./CLAUDE.md): 특정 폴더에서만 적용
일반 사용자 예시
# 내 작업 규칙
## 기본 설정
- 항상 한국어로 답해줘
- 존댓말 사용
- 파일 삭제하기 전에 꼭 먼저 물어봐줘
- 작업 시작 전에 무엇을 할 건지 한 줄로 알려줘
## 글쓰기 스타일
- 문장은 간결하게, 한 문장에 하나의 내용만
- 블로그 글은 감성적인 톤으로
- 보고서는 항목별 목록 형식으로
## 금지 사항
- 영어로 답하지 말 것 (코드 제외)
- 확인 없이 중요한 파일 덮어쓰기 금지개발자 프로젝트 예시
# 프로젝트 규칙
## 기술 스택
- 언어: TypeScript
- 프레임워크: Next.js
- 테스트: Jest
## 작업 규칙
- 커밋 전 반드시 테스트 실행
- 함수 주석은 한국어로
- 외부 라이브러리 추가 전에 먼저 알려줘권한(Permissions) 설정
Claude Code가 실행할 때마다 확인을 받는 수준을 조절합니다.
| 모드 | 설명 | 언제 쓰나요? |
|---|---|---|
default | 도구를 처음 쓸 때마다 확인 | 처음 사용할 때, 중요한 파일 다룰 때 |
acceptEdits | 파일 수정과 일반 파일 명령(mkdir, mv 등)은 자동 승인 | 글쓰기·편집 작업에 집중할 때 |
plan | Plan Mode — 분석만 하고 파일 변경·명령 실행은 금지 | 큰 작업의 방향을 먼저 검토할 때 |
auto | 안전성 검사를 거쳐 자동 승인 (리서치 프리뷰) | 신뢰된 환경에서 빠르게 반복 |
bypassPermissions | 모든 확인 생략 (보호 경로 제외) | 컨테이너·VM 같은 격리 환경 |
권한 모드는 Shift+Tab으로 순환 전환합니다. 현재 허용·차단 규칙을 보거나 바꾸려면 /permissions로 UI를 엽니다. 기본 모드는 settings.json의 defaultMode로 고정할 수 있습니다.
/permissions # 허용/차단 규칙 UI 열기
# Shift+Tab # 모드 순환 (입력창에서)Skills — 자주 쓰는 작업을 명령어로
반복되는 작업 절차를 슬래시 명령어 하나로 실행할 수 있게 만드는 기능입니다.
예를 들어 /writing이라는 스킬을 만들면:
/writing 여행 블로그 써줘한 줄로 글쓰기 전체 프로세스(주제 분석 → 구조 잡기 → 초안 작성 → 파일 저장)가 실행됩니다.
스킬은 ~/.claude/skills/ 폴더에 Markdown 파일로 만듭니다. 설치 가이드의 스킬 설치하기 섹션을 참고하세요.
이 가이드에서 제공하는 스킬
/claude-guide를 설치하면 3단계 온보딩이 시작됩니다 — 첫 결과물 → 샌드박스 → 나만의 스킬. 익숙해지면 다음 크리에이티브 스킬을 직접 만들어 확장할 수 있습니다.
| 스킬 | 역할 |
|---|---|
/drawing | AI 이미지 생성 프롬프트·로컬 생성 |
/writing | 글쓰기 세션, 문체 교정, 블로그 발행 |
/music | 음악 프롬프트 생성 |
/creative | 그림·글·음악 통합 허브 |
스킬 작성 가이드: 공식 문서 Skills.
Hooks — 자동 실행 규칙 (고급)
특정 시점에 자동으로 추가 작업이 실행되도록 설정하는 기능입니다.
- 파일 저장할 때마다 자동으로 git에 기록
- 위험한 명령어 실행 전 자동 경고
- 작업 완료 후 알림 발송
~/.claude/settings.json에서 설정합니다. 처음에는 건드리지 않아도 무방합니다.
MCP — 외부 서비스 연결 (고급)
MCP(Model Context Protocol)는 Claude Code가 외부 서비스나 도구와 대화하는 표준입니다. MCP 서버를 연결하면 Claude가 새 도구를 얻은 것처럼 동작합니다.
예시로 많이 쓰는 MCP 서버:
- Notion — 페이지 검색·생성, 데이터베이스 조회
- Obsidian — 개인 vault 노트 읽기·쓰기
- Figma — 디자인 파일 구조·자산 가져오기
- GitHub — 이슈·PR 조회 (gh CLI 대안)
/mcp # 연결된 MCP 서버 목록·OAuth 관리설정은 ~/.claude/settings.json의 mcpServers 블록 또는 .claude/mcp.json에서 합니다. 자세한 설정법은 공식 MCP 문서 참고.
Sub-agents — 복잡한 작업 병렬 처리 (고급)
Claude Code가 큰 작업을 여러 개의 독립적인 하위 작업으로 나눠 동시에 처리하는 방식입니다.
예를 들어 "웹사이트 5페이지 만들어줘"라는 요청을 받으면, 각 페이지를 별도 에이전트가 동시에 작업해서 시간을 단축합니다.
사용자가 직접 설정하는 기능은 아니며, Claude Code가 적절하다고 판단할 때 자동으로 활용합니다.
더 읽기
- CLAUDE.md·메모리 시스템: code.claude.com/docs/en/memory
- 권한 시스템: code.claude.com/docs/en/permissions
- Skills 만들기: code.claude.com/docs/en/skills
- Hooks 설정: code.claude.com/docs/en/hooks
- Subagents: code.claude.com/docs/en/sub-agents
- MCP 서버: code.claude.com/docs/en/mcp