실전 개발환경 구성
이 챕터는 awesome-claude-code의 리소스를 실제 프로젝트에 적용하는 방법을 단계별로 안내한다. 초보자부터 팀 리드까지, 상황별로 필요한 것만 골라서 세팅할 수 있도록 구성했다.
Step 1: Claude Code 설치 및 기본 세팅
모든 것의 시작. Claude Code가 설치되어 있지 않다면 여기서부터.
# Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 프로젝트 디렉토리에서 실행
cd my-project
claude설치 후 가장 먼저 해야 할 것은 CLAUDE.md 생성이다. 이 파일이 Claude Code의 모든 동작을 결정한다.
# 프로젝트 루트에 CLAUDE.md 생성
touch CLAUDE.mdStep 2: CLAUDE.md 작성 — 프로젝트 맞춤 설정
07장에서 소개한 28개의 실제 CLAUDE.md 예시 중 자신의 프로젝트 스택에 맞는 것을 참고한다.
스택별 추천 레퍼런스
| 스택 | 참고할 CLAUDE.md | 핵심 포인트 |
|---|---|---|
| TypeScript + React | Inkline | Vue 3 Composition API, TypeScript strict, Vitest |
| TypeScript + Monorepo | LangGraphJS | yarn workspaces, 모노레포 구조 |
| Python | EDSL | Black/mypy 강제, 빌드/테스트 커맨드 |
| Go | TPL | table-driven 테스트, 에러 핸들링 패턴 |
| Kotlin Multiplatform | DroidconKotlin | Gradle, KMP 설정 |
| Clojure | Metabase | REPL-driven 개발 |
| Rust | HASH | Rust docs, 리포지토리 구조 |
CLAUDE.md 기본 템플릿
아래 템플릿을 복사해서 프로젝트에 맞게 수정한다:
# CLAUDE.md
## 프로젝트 개요
[한 줄로 프로젝트 설명]
## 기술 스택
- Framework: [Next.js 14+ / FastAPI / etc.]
- Language: [TypeScript strict / Python 3.12+]
- Package Manager: [npm / pnpm / yarn / bun]
- Test Runner: [vitest / pytest / go test]
## 빌드 & 테스트
- 빌드: `npm run build`
- 테스트: `npm test`
- 린트: `npm run lint`
## 코딩 규칙
- [프로젝트 고유 규칙]
- [Claude가 추측할 수 없는 규칙만 작성]
## 절대 하지 말 것
- [네거티브 규칙 + 대안 제시]핵심 원칙: 200줄 이내. Claude가 코드를 보면 알 수 있는 건 적지 않는다.
Step 3: Skills 설치 — 프로젝트에 전문 능력 추가
02장의 Agent Skills 중 프로젝트에 맞는 것을 골라 설치한다.
설치 방법
Skills는 .claude/skills/<name>/SKILL.md 구조로 프로젝트에 추가한다:
# 프로젝트 디렉토리에 skills 폴더 생성
mkdir -p .claude/skills추천 스킬 조합
풀스택 웹 개발자
# 1. Fullstack Dev Skills — 65개 전문 스킬
git clone https://github.com/pimpmyspec/fullstack-dev-skills .claude/skills/fullstack
# 2. Superpowers — 계획부터 디버깅까지 핵심 SDLC
git clone https://github.com/NicolasMB3/Claude-Superpowers .claude/skills/superpowers보안 감사
# Trail of Bits Security Skills — 10개 이상의 보안 전문 스킬
git clone https://github.com/nicepkg/security-skills .claude/skills/security과학/연구
# Claude Scientific Skills — 연구, 분석, 금융, 기술 문서
git clone https://github.com/kaixinrongzi/claude-scientific-skills .claude/skills/scientific컨텍스트 최적화
# Context Engineering Kit — 최소 토큰으로 최대 효과
git clone https://github.com/maks-io/context-engineering-kit .claude/skills/context-kit직접 만들기
기존 스킬이 없는 도메인이면 직접 만든다:
# .claude/skills/my-domain/SKILL.md
---
name: my-domain-skill
description: "[프로젝트] 도메인 전문 스킬"
user-invocable: false
---
## 규칙
- [도메인 전문 지식]
- [자주 하는 실수 교정]Step 4: Slash Commands 추가 — 반복 작업 자동화
06장의 59개 커맨드 중 필요한 것을 선택해 설치한다.
설치 방법
커맨드는 .claude/commands/<name>.md 파일이다:
mkdir -p .claude/commands필수 커맨드 5선
1. /commit — 커밋 메시지 자동화
# 다운로드
curl -o .claude/commands/commit.md \
https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands/commit/commit.md사용법: 코드 변경 후 /commit 입력하면 conventional commit 형식으로 자동 커밋.
2. /create-pr — PR 생성
curl -o .claude/commands/create-pr.md \
https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands/create-pr/create-pr.md사용법: /create-pr → 변경사항 분석 → PR 제목/본문 자동 생성 → GitHub PR 생성.
3. /fix-github-issue — 이슈 해결
curl -o .claude/commands/fix-github-issue.md \
https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands/fix-github-issue/fix-github-issue.md사용법: /fix-github-issue 123 → 이슈 분석 → 코드 수정 → 테스트 → 커밋.
4. /context-prime — 컨텍스트 준비
curl -o .claude/commands/context-prime.md \
https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands/context-prime/context-prime.md사용법: 새 세션 시작 시 /context-prime → 프로젝트 구조와 핵심 파일을 자동 로드.
5. /update-docs — 문서 업데이트
curl -o .claude/commands/update-docs.md \
https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands/update-docs/update-docs.md사용법: 코드 변경 후 /update-docs → 관련 문서 자동 업데이트.
한번에 설치 스크립트
#!/bin/bash
# install-commands.sh — 필수 커맨드 일괄 설치
COMMANDS=(commit create-pr fix-github-issue context-prime update-docs)
BASE_URL="https://raw.githubusercontent.com/nicepkg/awesome-claude-code/main/resources/slash-commands"
mkdir -p .claude/commands
for cmd in "$\{COMMANDS[@]\}"; do
echo "Installing /$cmd..."
curl -sL "$BASE_URL/$cmd/$cmd.md" -o ".claude/commands/$cmd.md"
done
echo "Done! $\{#COMMANDS[@]\} commands installed."Step 5: Hooks 설정 — 이벤트 기반 자동화
05장의 Hooks 중 개발 생산성을 높이는 것들을 설정한다.
Hooks 설정 파일
.claude/settings.json에 hooks를 추가한다:
\{
"hooks": \{
"PostToolUse": [
\{
"matcher": "Write|Edit",
"command": "npx prettier --write $TOOL_INPUT_PATH"
\}
],
"PreToolUse": [
\{
"matcher": "Bash(git commit)",
"command": "npx lint-staged"
\}
]
\}
\}추천 Hook 조합
| Hook | 용도 | 설치 소스 |
|---|---|---|
| PostToolUse (포매팅) | 파일 저장 시 자동 Prettier/Black | 직접 설정 |
| CC Notify | 작업 완료 알림 | CCNotify |
| cchooks | Python SDK로 커스텀 훅 작성 | cchooks |
| Dippy | 안전한 bash 명령 자동 승인 | Dippy |
| parry | 프롬프트 인젝션 방어 | parry |
Dippy 설치 (자동 승인 훅)
안전한 bash 명령(ls, cat, grep 등)을 자동 승인해서 작업 속도를 높인다:
# 설치
npm install -g dippy-approve
# .claude/settings.json에 추가
# Dippy가 AST 기반으로 명령을 분석하여 안전한 것만 자동 승인Step 6: Tooling 설치 — 개발 도구 확장
04장의 Tooling 중 상황에 맞는 것을 선택한다.
Usage Monitor (토큰 사용량 모니터링)
Claude Code 사용 시 토큰 비용을 추적하는 건 필수다:
| 도구 | 특징 |
|---|---|
| ccusage | CLI 기반, 세션별 토큰 사용량 추적 |
| Claude Code Usage Tracker | VS Code 확장, 실시간 비용 표시 |
| claude-token-counter | 단순 토큰 카운터 |
# ccusage 설치 예시
npm install -g ccusage
ccusage --todayOrchestrator (멀티 에이전트)
대규모 작업이나 팀 협업에 유용:
| 도구 | 특징 |
|---|---|
| sudocode | 경량 에이전트 오케스트레이션 |
| claude-tmux | tmux 기반 멀티 세션 관리 |
| crystal | 데스크톱 앱, 에이전트 오케스트레이션 |
Step 7: Workflow 적용 — 체계적인 개발 프로세스
03장의 Workflows 중 팀/개인에 맞는 워크플로우를 선택한다.
개인 개발자 추천 워크플로우
- Claude Code Tips — 35개 이상의 실전 팁 (음성 입력, 시스템 프롬프트 패칭 등)
- Claude Code Handbook — 베스트 프랙티스, 팁, 테크닉 모음
- Context Engineering — 컨텍스트 윈도우 최적화 전략
팀 리드 추천 워크플로우
- Claude Code PM — 프로젝트 관리 워크플로우 (에이전트/커맨드 포함)
- AB Method — 스펙 기반 점진적 미션 워크플로우
- Agentic Workflow Patterns — Mermaid 다이어그램으로 시각화된 에이전틱 패턴
Design Review 워크플로우 적용 예시
# .claude/commands/design-review.md
---
description: "디자인 리뷰 실행"
---
현재 변경사항을 분석하고 디자인 리뷰를 수행하세요:
1. 아키텍처 변경 영향도 분석
2. SOLID 원칙 준수 여부 확인
3. 테스트 커버리지 체크
4. 성능 영향 예측
5. 리뷰 결과를 마크다운 리포트로 출력Step 8: 최종 프로젝트 구조
모든 세팅이 끝나면 프로젝트의 .claude/ 디렉토리는 이렇게 된다:
my-project/
├── CLAUDE.md # 프로젝트 설정 (200줄 이내)
├── .claude/
│ ├── settings.json # hooks, 권한 설정
│ ├── commands/ # 슬래시 커맨드
│ │ ├── commit.md
│ │ ├── create-pr.md
│ │ ├── fix-github-issue.md
│ │ ├── context-prime.md
│ │ └── update-docs.md
│ ├── skills/ # 전문 스킬
│ │ ├── fullstack/
│ │ │ └── SKILL.md
│ │ └── context-kit/
│ │ └── SKILL.md
│ └── rules/ # 파일별 규칙
│ ├── testing.md # Glob: **/*.test.ts
│ └── api.md # Glob: src/api/**
└── ...
단계별 체크리스트
작업을 빠뜨리지 않도록 체크리스트로 정리한다:
| # | 단계 | 완료 기준 |
|---|---|---|
| 1 | Claude Code 설치 | claude --version 출력 확인 |
| 2 | CLAUDE.md 작성 | 200줄 이내, 빌드/테스트 명령 포함 |
| 3 | Skills 설치 | .claude/skills/ 에 최소 1개 스킬 |
| 4 | Commands 추가 | /commit, /create-pr 최소 동작 확인 |
| 5 | Hooks 설정 | PostToolUse 포매팅 훅 동작 확인 |
| 6 | Tooling 설치 | 토큰 사용량 모니터링 가능 |
| 7 | Workflow 적용 | 팀 규모에 맞는 워크플로우 1개 선택 |
| 8 | 구조 확인 | .claude/ 디렉토리 구조 정리 완료 |
자주 하는 실수
- CLAUDE.md를 너무 길게 작성: 200줄 넘으면 Claude가 규칙을 무시하기 시작한다. Rules 시스템으로 분리하라
- 모든 스킬을 한번에 설치: 필요한 것만 설치하라. 스킬이 많으면 컨텍스트가 팽창한다
- Hooks를 과도하게 설정: 모든 이벤트에 훅을 걸면 Claude가 느려진다. 포매팅과 알림 정도만
- 커맨드를 커스터마이징하지 않음: 다운로드한 커맨드를 프로젝트에 맞게 수정해야 효과적이다
- 컨텍스트 관리 무시: 50% 시점에서
/compact실행. Plan 모드로 복잡한 작업 시작
다음 단계
기본 세팅이 끝났다면:
- Compounding Engineering 실천: Claude가 실수할 때마다 CLAUDE.md에 교정 규칙을 추가한다. 시간이 지날수록 정확도가 복리처럼 증가한다
- 팀 공유:
.claude/디렉토리를 git에 커밋해서 팀 전체가 같은 환경을 사용한다 - 커스텀 에이전트 구축: 반복되는 복잡한 작업이 있다면
.claude/agents/에 전용 서브에이전트를 만든다 - 커뮤니티 기여: 만든 스킬/커맨드/훅이 유용하다면 awesome-claude-code에 제출한다
# Comments
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.