coding-agent.dev
Awesome Claude Code 생태계 완전 가이드 · 13 min read

실전 개발환경 구성

이 챕터는 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.md

Step 2: CLAUDE.md 작성 — 프로젝트 맞춤 설정

07장에서 소개한 28개의 실제 CLAUDE.md 예시 중 자신의 프로젝트 스택에 맞는 것을 참고한다.

스택별 추천 레퍼런스

스택참고할 CLAUDE.md핵심 포인트
TypeScript + ReactInklineVue 3 Composition API, TypeScript strict, Vitest
TypeScript + MonorepoLangGraphJSyarn workspaces, 모노레포 구조
PythonEDSLBlack/mypy 강제, 빌드/테스트 커맨드
GoTPLtable-driven 테스트, 에러 핸들링 패턴
Kotlin MultiplatformDroidconKotlinGradle, KMP 설정
ClojureMetabaseREPL-driven 개발
RustHASHRust 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
cchooksPython 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 사용 시 토큰 비용을 추적하는 건 필수다:

도구특징
ccusageCLI 기반, 세션별 토큰 사용량 추적
Claude Code Usage TrackerVS Code 확장, 실시간 비용 표시
claude-token-counter단순 토큰 카운터
# ccusage 설치 예시
npm install -g ccusage
ccusage --today

Orchestrator (멀티 에이전트)

대규모 작업이나 팀 협업에 유용:

도구특징
sudocode경량 에이전트 오케스트레이션
claude-tmuxtmux 기반 멀티 세션 관리
crystal데스크톱 앱, 에이전트 오케스트레이션

Step 7: Workflow 적용 — 체계적인 개발 프로세스

03장의 Workflows 중 팀/개인에 맞는 워크플로우를 선택한다.

개인 개발자 추천 워크플로우

  1. Claude Code Tips — 35개 이상의 실전 팁 (음성 입력, 시스템 프롬프트 패칭 등)
  2. Claude Code Handbook — 베스트 프랙티스, 팁, 테크닉 모음
  3. Context Engineering — 컨텍스트 윈도우 최적화 전략

팀 리드 추천 워크플로우

  1. Claude Code PM — 프로젝트 관리 워크플로우 (에이전트/커맨드 포함)
  2. AB Method — 스펙 기반 점진적 미션 워크플로우
  3. 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/**
└── ...

단계별 체크리스트

작업을 빠뜨리지 않도록 체크리스트로 정리한다:

#단계완료 기준
1Claude Code 설치claude --version 출력 확인
2CLAUDE.md 작성200줄 이내, 빌드/테스트 명령 포함
3Skills 설치.claude/skills/ 에 최소 1개 스킬
4Commands 추가/commit, /create-pr 최소 동작 확인
5Hooks 설정PostToolUse 포매팅 훅 동작 확인
6Tooling 설치토큰 사용량 모니터링 가능
7Workflow 적용팀 규모에 맞는 워크플로우 1개 선택
8구조 확인.claude/ 디렉토리 구조 정리 완료

자주 하는 실수

  1. CLAUDE.md를 너무 길게 작성: 200줄 넘으면 Claude가 규칙을 무시하기 시작한다. Rules 시스템으로 분리하라
  2. 모든 스킬을 한번에 설치: 필요한 것만 설치하라. 스킬이 많으면 컨텍스트가 팽창한다
  3. Hooks를 과도하게 설정: 모든 이벤트에 훅을 걸면 Claude가 느려진다. 포매팅과 알림 정도만
  4. 커맨드를 커스터마이징하지 않음: 다운로드한 커맨드를 프로젝트에 맞게 수정해야 효과적이다
  5. 컨텍스트 관리 무시: 50% 시점에서 /compact 실행. Plan 모드로 복잡한 작업 시작

다음 단계

기본 세팅이 끝났다면:

  1. Compounding Engineering 실천: Claude가 실수할 때마다 CLAUDE.md에 교정 규칙을 추가한다. 시간이 지날수록 정확도가 복리처럼 증가한다
  2. 팀 공유: .claude/ 디렉토리를 git에 커밋해서 팀 전체가 같은 환경을 사용한다
  3. 커스텀 에이전트 구축: 반복되는 복잡한 작업이 있다면 .claude/agents/에 전용 서브에이전트를 만든다
  4. 커뮤니티 기여: 만든 스킬/커맨드/훅이 유용하다면 awesome-claude-code에 제출한다

# Comments

0/2000

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.