everything-claude-code/docs/ko-KR/examples/user-CLAUDE.md

사용자 수준 CLAUDE.md 예제

사용자 수준 CLAUDE.md 파일 예제입니다. ~/.claude/CLAUDE.md에 배치하세요.

사용자 수준 설정은 모든 프로젝트에 전역으로 적용됩니다. 다음 용도로 사용하세요:

• 개인 코딩 선호 설정
• 항상 적용하고 싶은 범용 규칙
• 모듈식 규칙 파일 링크

---

핵심 철학

당신은 Claude Code입니다. 저는 복잡한 작업에 특화된 agent와 skill을 사용합니다.

핵심 원칙:

1. Agent 우선: 복잡한 작업은 특화된 agent에 위임
2. 병렬 실행: 가능할 때 Task tool을 사용하여 여러 agent를 동시에 실행
3. 실행 전 계획: 복잡한 작업에는 Plan Mode 사용
4. 테스트 주도: 구현 전에 테스트 작성
5. 보안 우선: 보안에 대해 절대 타협하지 않음

---

모듈식 규칙

상세 가이드라인은 ~/.claude/rules/에 있습니다:

규칙 파일	내용
security.md	보안 점검, 시크릿 관리
coding-style.md	불변성, 파일 구성, 에러 처리
testing.md	TDD 워크플로우, 80% 커버리지 요구사항
git-workflow.md	커밋 형식, PR 워크플로우
agents.md	Agent 오케스트레이션, 상황별 agent 선택
patterns.md	API 응답, repository 패턴
performance.md	모델 선택, 컨텍스트 관리
hooks.md	Hooks 시스템

---

사용 가능한 Agent

~/.claude/agents/에 위치합니다:

Agent	용도
planner	기능 구현 계획 수립
architect	시스템 설계 및 아키텍처
tdd-guide	테스트 주도 개발
code-reviewer	품질/보안 코드 리뷰
security-reviewer	보안 취약점 분석
build-error-resolver	빌드 에러 해결
e2e-runner	Playwright E2E 테스트
refactor-cleaner	불필요한 코드 정리
doc-updater	문서 업데이트

---

개인 선호 설정

개인정보 보호

• 항상 로그를 삭제하고, 시크릿(API 키/토큰/비밀번호/JWT)을 절대 붙여넣지 않음
• 공유 전 출력 내용을 검토하여 민감한 데이터 제거

코드 스타일

• 코드, 주석, 문서에 이모지 사용 금지
• 불변성 선호 - 객체나 배열을 직접 변경하지 않음
• 큰 파일 소수보다 작은 파일 다수를 선호
• 일반적으로 200-400줄, 파일당 최대 800줄

Git

• Conventional commits: feat:, fix:, refactor:, docs:, test:
• 커밋 전 항상 로컬에서 테스트
• 작고 집중된 커밋

테스트

• TDD: 테스트를 먼저 작성
• 최소 80% 커버리지
• 핵심 흐름에 대해 단위 + 통합 + E2E 테스트

지식 축적

• 개인 디버깅 메모, 선호 설정, 임시 컨텍스트 → auto memory
• 팀/프로젝트 지식(아키텍처 결정, API 변경, 구현 런북) → 프로젝트의 기존 문서 구조를 따름
• 현재 작업에서 이미 관련 문서, 주석, 예제를 생성하는 경우 동일한 지식을 다른 곳에 중복하지 않음
• 적절한 프로젝트 문서 위치가 없는 경우 새로운 최상위 문서를 만들기 전에 먼저 질문

---

에디터 연동

저는 Zed을 기본 에디터로 사용합니다:

• 파일 추적을 위한 Agent Panel
• CMD+Shift+R로 명령 팔레트 사용
• Vim 모드 활성화

---

성공 기준

다음 조건을 충족하면 성공입니다:

• 모든 테스트 통과 (80% 이상 커버리지)
• 보안 취약점 없음
• 코드가 읽기 쉽고 유지보수 가능
• 사용자 요구사항 충족

---

철학: Agent 우선 설계, 병렬 실행, 실행 전 계획, 코드 전 테스트, 항상 보안 우선.