Claude Code configuration template - copy .claude settings to your project
npm install jun-claude-codeClaude Code 설정 템플릿 CLI입니다. 미리 정의된 .claude 설정을 ~/.claude로 복사하여 새 프로젝트에서 빠르게 Claude Code 환경을 구축할 수 있습니다.
``bashnpx로 바로 실행
npx jun-claude-code
사용법
`bash
기본 실행 (기존 파일이 있으면 덮어쓰기 확인)
jun-claude-code미리보기 (실제 복사 없이 복사될 파일 목록 확인)
jun-claude-code --dry-run강제 덮어쓰기 (확인 없이 모든 파일 복사)
jun-claude-code --force
`포함된 설정
$3
| Agent | 설명 |
|-------|------|
|
explore | 빠른 코드베이스 탐색 |
| task-planner | 작업 계획 수립 |
| code-writer | 코드 작성 |
| code-reviewer | 셀프 코드 리뷰 |
| git-manager | Git 작업 (커밋, PR) |
| impact-analyzer | 사이드이펙트 분석 |
| qa-tester | 테스트/빌드 검증 |
| architect | 아키텍처 설계 |
| designer | UI/UX 스타일링 |
| context-collector | Context 수집 |
| context-manager | Context 문서 관리 |$3
| Skill | 설명 |
|-------|------|
|
Coding | 공통 코딩 원칙 (SRP, 응집도, 가독성) |
| Git | Git 커밋/PR 규칙 |
| Backend | 백엔드 개발 원칙 (레이어, TypeORM) |$3
- 워크플로우 순서 강제 프로토콜
- Skill/Agent 평가 프로토콜
커스터마이징
설치 후
~/.claude/ 디렉토리에서 필요에 맞게 수정하세요.`
~/.claude/
├── CLAUDE.md # 작업 가이드
├── agents/ # Agent 정의 수정/추가
├── skills/ # Skill 가이드 수정/추가
├── hooks/ # 자동 실행 스크립트
└── context/ # 프로젝트별 Context (직접 추가)
`$3
프로젝트 루트에
.claude/ 폴더를 만들어 프로젝트별 설정을 추가할 수 있습니다.`
your-project/
├── .claude/
│ ├── context/ # 프로젝트 아키텍처, 도메인 지식
│ └── skills/ # 프로젝트 전용 스킬
└── CLAUDE.md # 프로젝트 설명
`$3
init-project 커맨드로 GitHub Project 태스크 관리를 프로젝트에 연동할 수 있습니다.`bash
프로젝트 루트에서 실행
jun-claude-code init-project
`실행하면 다음을 인터랙티브로 설정합니다:
1. GitHub Owner (org 또는 user)
2. Project Number
3. Repository (owner/repo 형식)
설정 완료 후 프로젝트에 생성되는 파일:
`
your-project/
├── .claude/
│ ├── project.env # GitHub Project 설정 (GITHUB_PROJECT_OWNER 등)
│ ├── settings.json # StartSession hook (세션 시작 시 태스크 표시)
│ ├── hooks/
│ │ └── task-loader.sh # 태스크 조회 스크립트
│ └── agents/
│ └── project-task-manager.md # 태스크 관리 Agent
`#### 수동 설정
init-project 대신 직접 .claude/project.env를 생성할 수도 있습니다:`bash
.claude/project.env
GITHUB_PROJECT_OWNER=your-org
GITHUB_PROJECT_NUMBER=1
GITHUB_PROJECT_REPO=your-org/your-repo
`#### 필요 권한
GitHub Project 접근에
read:project 스코프가 필요합니다:`bash
gh auth refresh -s read:project,project
`핵심 원칙
이 템플릿의 핵심 원칙:
1. Context 절약: Main Agent의 Context Window 보존을 위해 Subagent에 작업 위임
2. 워크플로우 준수: Planning → Validation → Implementation → Review
3. Git 작업 위임: 모든 Git 작업은
git-manager` Agent 사용MIT