포스트

해커톤 우승자의 Claude Code 설정, 이제 당신 것입니다

해커톤 우승자의 Claude Code 설정, 이제 당신 것입니다

“고민할 시간에 일단 git clone부터.” - 10개월간 갈고닦은 production-ready 설정이 전부 공개됐습니다.


프롤로그: 8시간 만에 만든 우승작

2025년 9월 12일, 뉴욕. Anthropic과 Forum Ventures가 주최한 해커톤이 열렸습니다. 100명이 넘는 참가자들이 모였습니다. 미션은 명확했습니다: 하루 만에 AI 에이전트를 구축해 0에서 1로 가는 스타트업 여정을 자동화하라.

오전 10시 30분, 첫 번째 빌드 스프린트가 시작됐습니다. 점심 시간을 지나 오후 미드데이 유저 테스팅, 그리고 두 번째 스프린트. 오후 6시, 최종 데모와 심사가 시작됐습니다.

오후 7시, 우승자가 발표됐습니다. Affaan Mustafa와 David Rodriguez팀. 그들이 만든 것은 Zenith - AI 기반 고객 발견 플랫폼이었습니다. 특별한 점이 하나 있었습니다.

전체를 Claude Code만으로 구축했습니다.

스택도, 프레임워크도, 다른 코딩 도구도 사용하지 않았습니다. 오직 Claude Code. 그리고 Affaan은 그때 사용한 설정을, 10개월간 매일 사용하며 갈고닦은 agents, skills, hooks, commands를 전부 공개했습니다.

상금? 1만 5천 달러 상당의 Anthropic 크레딧. 하지만 진짜 가치는 그 설정 파일들에 있습니다.


왜 지금 당장 clone해야 하는가

1. 이것은 단순한 프롬프트 모음집이 아닙니다

많은 개발자들이 “Claude Code 팁”이라는 이름으로 프롬프트 몇 개를 공유합니다. 유용할 수 있습니다. 하지만 Affaan의 저장소는 다릅니다.

이것은 production-ready 시스템입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
everything-claude-code/
├── agents/           # 9개의 전문 서브에이전트
│   ├── planner.md
│   ├── architect.md
│   ├── code-reviewer.md
│   ├── security-reviewer.md
│   └── ...
├── skills/           # 검증된 워크플로우 정의
│   ├── coding-standards.md
│   ├── tdd-workflow/
│   └── security-review/
├── commands/         # 즉시 실행 가능한 슬래시 명령
│   ├── tdd.md
│   ├── refactor-clean.md
│   └── ...
├── hooks/            # 자동 실행 규칙
│   └── hooks.json
├── rules/            # 프로젝트 가이드라인
└── mcp-configs/      # MCP 서버 설정

각 파일은 실전에서 검증됐습니다. 해커톤에서, 실제 프로덕션 애플리케이션에서, 10개월간의 매일 사용에서.

2. 적용하면 Claude가 변신합니다

Before:

1
2
3
4
5
6
7
8
개발자: "이 코드 리팩토링해줘"
Claude: [코드 수정]
개발자: "테스트도 작성해줘"
Claude: [테스트 작성]
개발자: "포맷팅 맞춰줘"
Claude: [포맷팅]
개발자: "타입 체크해줘"
Claude: [타입 체크]

매번 요청해야 합니다. Claude는 시키는 대로 합니다.

After (Affaan 설정 적용):

1
2
3
4
5
6
7
8
9
10
11
12
개발자: "/tdd 결제 시스템 구현해줘"

Claude: 
1. TDD Skill 자동 활성화
2. 테스트 먼저 작성
3. 구현
4. [PostToolUse Hook] 자동 포맷팅
5. [PostToolUse Hook] 자동 타입 체크
6. [PostToolUse Hook] console.log 경고
7. Code Reviewer Subagent 자동 실행
8. Security Reviewer Subagent 보안 분석
9. 완료 보고

한 번의 명령으로 전체 워크플로우가 자동 실행됩니다. Claude는 시니어 엔지니어처럼 행동합니다.

3. 시간이 곧 돈입니다

Affaan의 트위터에서:

“10개월간 매일 사용했습니다. 이 설정들은 수백 시간의 시행착오 끝에 살아남은 것들입니다.”

당신이 같은 시행착오를 반복할 필요가 있을까요?

검증된 설정을 복사 → 5분 직접 시행착오하며 구축 → 수백 시간

답은 명확합니다.


5분 만에 적용하기

Step 1: Clone

터미널을 열고:

1
2
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

Step 2: 복사

Agents 복사:

1
cp agents/*.md ~/.claude/agents/

이제 9개의 전문 서브에이전트가 당신 것입니다:

  • planner.md - 기능 구현 계획 수립 전문가
  • architect.md - 시스템 설계 의사결정
  • code-reviewer.md - 코드 품질 및 보안 리뷰
  • security-reviewer.md - 취약점 분석 전담
  • tdd-guide.md - 테스트 주도 개발 가이드
  • build-error-resolver.md - 빌드 에러 해결사
  • e2e-runner.md - Playwright E2E 테스트 실행
  • refactor-cleaner.md - 죽은 코드 정리 전문가
  • doc-updater.md - 문서 동기화 담당

Skills 복사:

1
cp -r skills/* ~/.claude/skills/

이제 검증된 워크플로우 정의들이 활성화됩니다:

  • 프로그래밍 언어별 코딩 표준
  • 백엔드 패턴 (API, 데이터베이스, 캐싱)
  • 프론트엔드 패턴 (React, Next.js)
  • TDD 워크플로우
  • 보안 리뷰 체크리스트

Commands 복사:

1
cp commands/*.md ~/.claude/commands/

슬래시 명령이 활성화됩니다:

  • /tdd - 테스트 주도 개발 시작
  • /refactor-clean - 죽은 코드와 불필요한 파일 정리
  • /security-review - 보안 점검
  • /e2e - E2E 테스트 실행

Rules 복사:

1
cp rules/*.md ~/.claude/rules/

Hooks 설정:

hooks/hooks.json 파일을 열어서 내용을 ~/.claude/settings.jsonhooks 섹션에 복사합니다.

이제 자동 실행 규칙이 활성화됩니다:

  • 파일 수정 시 자동 포맷팅
  • 타입 체크 자동 실행
  • console.log 추가 시 경고
  • 장시간 명령 실행 시 tmux 권고

Step 3: MCP 설정 (선택사항)

mcp-configs/mcp-servers.json 파일에서 필요한 MCP 서버 설정을 ~/.claude.json에 복사합니다.

⚠️ 중요:

  • YOUR_*_HERE 플레이스홀더를 실제 API 키로 교체하세요
  • 모든 MCP를 한꺼번에 활성화하지 마세요 (아래 주의사항 참조)

Step 4: 즉시 테스트

1
claude

Claude Code를 시작하고:

1
> /tdd 간단한 계산기 함수 만들어줘

마법이 시작됩니다.


실전 활용: 해커톤 우승 재현하기

Affaan이 Zenith를 만들 때 사용한 정확한 워크플로우를 재현해봅시다.

시나리오: 사용자 인증 시스템 구축

전통적 방법 (예상 시간: 4-5시간):

1
2
3
4
5
6
7
1. 아키텍처 설계 (30분)
2. 테스트 작성 (1시간)
3. 구현 (2시간)
4. 코드 리뷰 (30분)
5. 보안 체크 (30분)
6. 리팩토링 (30분)
7. 문서 작성 (30분)

Affaan의 방법 (실제 시간: 45분):

1단계: 계획 수립 (5분)

1
2
3
4
claude
> @planner JWT 기반 사용자 인증 시스템을 구현하려고 합니다. 
> 로그인, 회원가입, 토큰 갱신, 로그아웃 기능이 필요합니다.
> 상세 구현 계획을 세워주세요.

Planner Subagent가 활성화되어 체계적인 구현 계획을 수립합니다.

2단계: TDD로 구현 시작 (20분)

1
> /tdd 위 계획대로 구현해주세요.

TDD Skill이 자동 활성화되고:

  1. 테스트 먼저 작성
  2. 구현
  3. 각 파일 수정 시 Hooks가 자동 실행:
    • Prettier 포맷팅
    • TypeScript 타입 체크
    • ESLint 검사

3단계: 병렬 리뷰 (10분)

1
2
> @code-reviewer @security-reviewer 
> 방금 구현한 인증 시스템을 리뷰해주세요.

두 Subagent가 동시에 작업:

  • Code Reviewer: 코드 품질, 가독성, 유지보수성
  • Security Reviewer: SQL 인젝션, XSS, 토큰 보안

4단계: E2E 테스트 (5분)

1
> /e2e 인증 시스템에 대한 E2E 테스트를 작성하고 실행해주세요.

5단계: 정리 및 문서화 (5분)

1
2
> /refactor-clean
> @doc-updater README에 인증 시스템 사용법을 추가해주세요.

결과:

  • 총 시간: 45분 (전통적 방법의 1/5)
  • 품질: 시니어 엔지니어 수준
  • 커버리지: 자동으로 80%+ 달성
  • 문서: 자동 생성 및 동기화

이것이 Affaan이 8시간 만에 완전한 제품을 만든 비결입니다.


주의사항: 함정 피하기

⚠️ 주의 1: 컨텍스트 윈도우 고갈

Affaan이 가장 강조하는 부분:

“절대로 모든 MCP를 한꺼번에 활성화하지 마세요. 200k 컨텍스트 윈도우가 70k로 줄어듭니다.”

문제:

1
2
3
4
5
모든 MCP 활성화 (14개)
→ 도구 정의: 67,000 토큰 소비
→ 실제 사용 가능: 133,000 토큰만 남음
→ Claude가 20분 전 결정을 잊어버림
→ 일관성 없는 코드 생성

해결책: “20-30-10-80” 규칙

1
2
3
설정 파일에 등록: 20-30개 MCP
실제 활성화: 10개 미만
총 도구 수: 80개 미만

프로젝트별 선택적 활성화:

웹 프로젝트 (.claude/config.json):

1
2
3
4
5
6
7
8
{
  "disabledMcpServers": [
    "docker",
    "kubernetes",
    "terraform",
    //  프로젝트에서 불필요
  ]
}

실제 활성화:

  • Supabase (데이터베이스)
  • GitHub (버전 관리)
  • Vercel (배포)
  • Playwright (테스트)

총 4개만. 필요할 때만 켜고, 끝나면 끕니다.

⚠️ 주의 2: 맹목적 복사 금지

Affaan의 경고:

“이 설정들은 내 워크플로우에 맞춰져 있습니다. 당신은:

  1. 그대로 복사하지 말고, 이해하세요
  2. 자신의 필요에 맞게 조정하세요
  3. 실험하고 개선하세요”

나쁜 예:

1
2
cp -r everything-claude-code/* ~/.claude/
# 전부 복사하고 이해 안 함

좋은 예:

1
2
3
4
5
6
7
8
9
10
11
12
13
# 1. 먼저 읽기
cat agents/code-reviewer.md

# 2. 이해하기
# "아, 이 Subagent는 Read, Grep, Glob만 사용하네"
# "수정 권한이 없어서 안전하구나"

# 3. 필요에 맞게 수정
vim agents/code-reviewer.md
# 내 프로젝트 코딩 표준에 맞게 조정

# 4. 복사
cp agents/code-reviewer.md ~/.claude/agents/

⚠️ 주의 3: API 키 필수 확인

MCP 서버 설정에는 YOUR_SUPABASE_URL_HERE 같은 플레이스홀더가 있습니다.

반드시 교체하세요:

1
2
3
4
5
6
{
  "supabase": {
    "url": "YOUR_SUPABASE_URL_HERE",  //  이대로 두지 마세요!
    "key": "YOUR_SUPABASE_KEY_HERE"
  }
}

1
2
3
4
5
6
{
  "supabase": {
    "url": "https://xxxx.supabase.co",  //  실제 값으로 교체
    "key": "eyJhbGciOiJIUzI1..."
  }
}

각 구성요소 상세 해설

Agents (Subagents): 전문가 팀

Planner (계획자)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
name: planner
description: 기능 구현 계획 수립
tools: Read, Grep, Glob
model: sonnet
---

당신은 시니어 소프트웨어 아키텍트입니다.
사용자의 요구사항을 받아 상세한 구현 계획을 수립합니다.

## 계획 수립 프로세스
1. 요구사항 분석
2. 기술 스택 선정
3. 모듈 분해
4. 단계별 구현 순서
5. 잠재적 문제점 식별

사용 예:

1
2
> @planner 실시간 채팅 기능을 추가하려고 합니다.
> WebSocket을 사용할 예정이고, 메시지 히스토리도 저장해야 합니다.

Planner가 즉시:

  • WebSocket 서버 설정
  • 메시지 스키마 설계
  • 데이터베이스 구조
  • 프론트엔드 상태 관리
  • 에러 처리 전략

체계적인 계획을 제시합니다.

Architect (설계자)

1
2
3
4
5
6
7
8
9
---
name: architect
description: 시스템 설계 결정
tools: Read, Grep, Glob
model: opus
---

당신은 시스템 아키텍트입니다.
높은 수준의 설계 결정을 내립니다.

Code Reviewer (코드 리뷰어)

1
2
3
4
5
6
7
8
9
10
11
12
13
---
name: code-reviewer
description: 품질, 보안, 유지보수성 검토
tools: Read, Grep, Glob, Bash
model: opus
---

## 리뷰 체크리스트
✅ 코드 품질 (가독성, 복잡도)
✅ 성능 (불필요한 루프, 메모리 누수)
✅ 보안 (입력 검증, 인증/인가)
✅ 테스트 커버리지
✅ 문서화

핵심: 읽기 전용 도구만 사용합니다. 코드를 수정하지 않고 분석만 합니다. 안전합니다.

Security Reviewer (보안 전문가)

1
2
3
4
5
6
7
8
9
10
11
12
13
---
name: security-reviewer
description: 취약점 분석 전담
tools: Read, Grep, Glob
model: opus
---

## 보안 체크리스트
🔒 SQL 인젝션
🔒 XSS (Cross-Site Scripting)
🔒 CSRF
🔒 인증/인가 우회
🔒 민감 정보 노출

Skills: 워크플로우 정의

TDD Workflow (tdd-workflow/)

1
2
3
4
5
6
7
8
9
# 테스트 주도 개발 워크플로우

## 원칙
1. 테스트 먼저 작성 (Red)
2. 최소한의 코드로 통과 (Green)
3. 리팩토링 (Refactor)

## 단계별 가이드
...

자동 활성화: Claude는 테스트 관련 대화를 감지하면 이 Skill을 자동으로 로드합니다.

Security Review (security-review/)

1
2
3
4
5
6
7
8
9
10
11
12
# 보안 리뷰 체크리스트

## 입력 검증
- [ ] 모든 사용자 입력 검증
- [ ] SQL 파라미터 바인딩
- [ ] HTML 이스케이핑

## 인증/인가
- [ ] 비밀번호 해싱 (bcrypt)
- [ ] JWT 시크릿 키 보안
- [ ] 세션 타임아웃
...

Commands: 즉시 실행

/tdd Command

1
2
3
4
5
6
7
8
9
10
11
12
---
argument-hint: 구현할 기능 설명
description: 테스트 주도 개발로 기능 구현
---

TDD 워크플로우를 시작합니다.

1. 먼저 테스트 작성
2. 테스트 실패 확인
3. 최소 구현
4. 테스트 통과 확인
5. 리팩토링

사용:

1
> /tdd 사용자가 이메일과 비밀번호로 로그인하는 기능

/refactor-clean Command

1
2
3
4
5
6
7
8
9
10
---
description: 죽은 코드와 불필요한 파일 제거
---

다음을 정리합니다:
- 미사용 함수/변수
- 죽은 코드
- 불필요한 마크다운 파일
- 중복 코드
- 불필요한 주석

Hooks: 자동 실행

PostToolUse Hook (TypeScript 파일)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "matcher": "tool == 'Edit' && tool_input.file_path matches '\\.(ts|tsx)$'",
  "hooks": [
    {
      "type": "command",
      "command": "prettier --write \"$file_path\"",
      "description": "자동 포맷팅"
    },
    {
      "type": "command",
      "command": "tsc --noEmit",
      "description": "타입 체크"
    },
    {
      "type": "command",
      "command": "eslint \"$file_path\"",
      "description": "린팅"
    }
  ]
}

작동 방식:

  1. Claude가 TypeScript 파일 수정
  2. Hook 자동 감지
  3. Prettier 포맷팅 실행
  4. TypeScript 타입 체크
  5. ESLint 검사
  6. 결과를 Claude에게 전달

개발자는 아무것도 하지 않습니다. 자동입니다.


실전 팁: Affaan처럼 작업하기

팁 1: Git Worktrees로 병렬 개발

Affaan은 해커톤에서 여러 기능을 동시에 개발했습니다. 비결은 Git Worktrees입니다.

시나리오: 인증 시스템 개발 중, 긴급 버그 수정 필요

전통적 방법:

1
2
3
4
5
6
7
git stash        # 현재 작업 저장
git checkout main
git checkout -b hotfix/urgent
# 버그 수정
git checkout feature/auth
git stash pop    # 작업 복원
# 컨텍스트 재설정...

Affaan의 방법:

1
2
3
4
5
6
7
8
9
10
# Worktree 생성
git worktree add ../myproject-hotfix hotfix/urgent

# 새 터미널
cd ../myproject-hotfix
claude
> 긴급 버그 수정해주세요

# 원래 터미널
# 인증 시스템 작업 계속

완전히 독립적입니다. 충돌 없습니다.

팁 2: Subagent 체이닝

복잡한 작업은 여러 Subagent를 체이닝합니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
> @planner 
> 전자상거래 장바구니 기능 구현 계획 세워주세요

[Planner가 계획 수립]

> @architect 
> 위 계획을 바탕으로 데이터베이스 스키마 설계해주세요

[Architect가 스키마 설계]

> /tdd 
> 위 설계대로 장바구니 CRUD 구현해주세요

[TDD Workflow 실행]

> @code-reviewer @security-reviewer
> 리뷰해주세요

[동시에 두 Subagent 실행]

> /e2e
> E2E 테스트 작성 및 실행

[E2E Runner 실행]

계획 → 설계 → 구현 → 리뷰 → 테스트

전체 엔지니어링 프로세스가 자동화됩니다.

팁 3: 프로젝트별 커스터마이징

각 프로젝트에 .claude/ 디렉토리 생성:

1
2
3
4
5
6
7
8
my-project/
├── .claude/
│   ├── config.json        # 프로젝트 설정
│   ├── rules/
│   │   └── project-specific.md
│   └── skills/
│       └── domain-knowledge.md
└── src/

config.json:

1
2
3
4
5
{
  "disabledMcpServers": ["docker", "kubernetes"],
  "enabledSkills": ["tdd-workflow", "react-patterns"],
  "defaultModel": "sonnet"
}

rules/project-specific.md:

1
2
3
4
5
6
7
8
9
10
11
12
# 이 프로젝트 규칙

## 기술 스택
- Next.js 14 (App Router)
- TypeScript (strict mode)
- Tailwind CSS
- Supabase

## 코딩 표준
- 컴포넌트는 `src/components/`- API 라우트는 `src/app/api/`- 모든 함수는 JSDoc 주석 필수

Claude는 프로젝트 진입 시 자동으로 이 규칙들을 로드합니다.


로드맵: 1주일부터 1개월까지

1일차: 기본 설치

목표: 작동하는 상태 만들기

1
2
3
4
5
6
7
8
9
10
11
# 1. Clone
git clone https://github.com/affaan-m/everything-claude-code.git

# 2. 핵심만 복사
cp agents/code-reviewer.md ~/.claude/agents/
cp commands/refactor-clean.md ~/.claude/commands/
cp -r skills/coding-standards.md ~/.claude/skills/

# 3. 테스트
claude
> /refactor-clean

결과: Claude가 자동으로 코드 정리를 시작합니다.

3일차: TDD 워크플로우

목표: 테스트 주도 개발 마스터

1
2
3
4
5
6
7
8
# TDD 관련 파일 복사
cp agents/tdd-guide.md ~/.claude/agents/
cp commands/tdd.md ~/.claude/commands/
cp -r skills/tdd-workflow/ ~/.claude/skills/

# 실전
claude
> /tdd 간단한 투두 리스트 CRUD API

학습:

  • 테스트가 먼저 작성되는 것 관찰
  • Red-Green-Refactor 사이클 체험

1주차: Hooks 활성화

목표: 자동화 경험

hooks/hooks.json~/.claude/settings.json

이제:

  • 파일 수정 시 자동 포맷팅
  • 타입 체크 자동 실행
  • console.log 추가 시 경고

체감 효과:

“이제 포맷팅 명령을 입력한 적이 없습니다.”

2주차: 전체 Subagents

목표: 전문가 팀 구축

1
cp agents/*.md ~/.claude/agents/

이제 9개 전문가가 대기 중:

  • Planner, Architect, Code Reviewer, Security Reviewer…

실전:

1
2
3
4
> @planner 블로그 플랫폼 MVP 계획
> @architect 데이터 모델 설계
> @code-reviewer 구현 코드 리뷰
> @security-reviewer 보안 체크

1개월차: 프로젝트 최적화

목표: 내 워크플로우에 완벽히 맞추기

  1. MCP 선택적 활성화
    • 프로젝트마다 필요한 것만
    • 컨텍스트 윈도우 최적화
  2. Custom Skills 추가
    • 회사 코딩 표준
    • 팀 워크플로우
    • 도메인 지식
  3. Custom Commands 작성
    • 반복 작업 자동화
    • 팀 공유

결과:

“Claude가 우리 팀의 시니어 엔지니어가 됐습니다.”


성공 사례: 누가 이걸 쓰고 있나

Affaan Mustafa - Zenith (해커톤 우승)

  • 프로젝트: AI 기반 고객 발견 플랫폼
  • 개발 시간: 8시간
  • 팀: 2명 (거의 혼자)
  • 사용 도구: Claude Code만

결과:

  • ✅ 100명+ 참가자 중 1등
  • ✅ $15,000 Anthropic 크레딧 수상
  • ✅ 완전히 작동하는 MVP
  • ✅ 깔끔한 코드베이스

Affaan의 코멘트:

“Claude Code 없이는 불가능했을 겁니다. 계획, 구현, 테스트, 리뷰 전부 자동화됐습니다.”

incident.io - 프로덕션 사용

incident.io팀은 이렇게 말합니다:

“4개월 전에는 Claude Code를 거의 안 썼습니다. 지금은 4-5개의 Claude 에이전트를 동시에 운영합니다.”

워크플로우:

1
2
3
4
5
6
7
# 4개의 터미널, 4개의 worktrees
Terminal 1: 새 기능 개발
Terminal 2: 버그 수정
Terminal 3: 리팩토링
Terminal 4: 문서 업데이트

# 각각 독립적인 Claude 세션

결과:

  • 빌드 시간 단축
  • 기능 개발 가속화
  • 창의적 작업에 더 많은 시간

커뮤니티 피드백

Reddit r/ClaudeCode:

“Affaan의 설정 적용 후 생산성이 3배 올랐습니다. 더 이상 린팅이나 포맷팅을 요청하지 않습니다.”

X (Twitter):

“10개월 배운 게 5분 만에 내 것이 됐습니다. 이게 오픈소스의 힘이네요.”

GitHub Issues:

“이 설정들이 Claude Code의 사실상 표준이 돼야 합니다.”


FAQ: 자주 묻는 질문

Q1: 초보자도 사용할 수 있나요?

A: 네! 오히려 초보자에게 더 좋습니다.

이유:

  • 시니어의 Best Practice가 내장됨
  • TDD, 코드 리뷰, 보안 체크 자동화
  • 좋은 습관이 자동으로 형성됨

추천 시작 단계:

  1. 기본 Commands만 복사
  2. /tdd, /refactor-clean 사용
  3. 익숙해지면 Subagents 추가

Q2: 기존 설정과 충돌하나요?

A: 충돌하지 않습니다.

1
2
3
4
5
6
7
~/.claude/
├── agents/
│   ├── my-custom-agent.md    # 기존
│   └── code-reviewer.md       # 새로 추가
├── skills/
│   ├── my-skill.md            # 기존
│   └── tdd-workflow/          # 새로 추가

파일 이름만 겹치지 않으면 됩니다. 선택적으로 복사하세요.

Q3: 비용이 많이 드나요?

A: Subagent 사용 시 토큰 소비가 늘어납니다.

하지만:

  • 시간 절약 효과가 훨씬 큼
  • 품질 향상으로 버그 수정 시간 감소
  • 전체적으로는 비용 대비 효율적

팁:

  • 중요한 작업에만 Subagent 사용
  • 간단한 작업은 메인 Claude로

Q4: 팀에서 사용하려면?

A: 팀 전체가 같은 설정을 공유하세요.

방법 1: Private Repository

1
2
3
4
5
6
7
# 팀 저장소 생성
git init team-claude-configs
cp -r ~/.claude/* team-claude-configs/

# 팀원들
git clone [팀 저장소 URL]
cp -r team-claude-configs/* ~/.claude/

방법 2: 회사 코딩 표준 추가

1
2
3
4
5
6
7
# skills/company-standards.md

## 우리 회사 규칙
- 변수명은 camelCase
- 함수명은 동사로 시작
- 모든 API는 /api/v1/ prefix
...

Q5: Windows에서도 되나요?

A: 네, 경로만 조정하세요.

Linux/Mac:

1
~/.claude/

Windows:

1
%USERPROFILE%\.claude\

복사 명령:

1
Copy-Item agents\*.md ~\.claude\agents\

결론: 지금 바로 시작하세요

핵심 요약

  1. 이것은 프롬프트 모음이 아닙니다
    • 10개월 실전 검증된 시스템
    • 해커톤 우승 설정
    • Production-ready
  2. 적용은 5분이면 충분합니다
    1
    2
    3
    
    git clone https://github.com/affaan-m/everything-claude-code.git
    cp agents/*.md ~/.claude/agents/
    cp -r skills/* ~/.claude/skills/
    
  3. 효과는 즉시 나타납니다
    • Claude가 시니어 엔지니어로 변신
    • 자동 포맷팅, 타입 체크, 보안 리뷰
    • 생산성 3-10배 증가

마지막 조언

Affaan이 README에 남긴 문구:

“Don’t overthink this. Start simple. Add what you need. Iterate.”

과도하게 복잡하게 만들지 마세요. 간단하게 시작하세요. 필요한 것만 추가하세요. 반복하세요.

당신의 다음 액션

지금 당장:

1
git clone https://github.com/affaan-m/everything-claude-code.git

5분 후:

1
2
3
cp agents/code-reviewer.md ~/.claude/agents/
claude
> @code-reviewer 내 코드 리뷰해줘

1주일 후:

1
2
> /tdd 새 기능 구현
# 자동으로 테스트, 구현, 리뷰, 정리

1개월 후:

“이제 예전으로 돌아갈 수 없습니다.”


리소스

필수 링크

GitHub 저장소: https://github.com/affaan-m/everything-claude-code

  • ⭐ 2,300+ stars
  • MIT License (자유롭게 사용, 수정, 배포)

Affaan의 원본 가이드: https://x.com/affaanmustafa/status/2012378465664745795

  • 90만 뷰
  • 1만+ 북마크
  • 상세 설명

Claude Code 공식 문서: https://code.claude.com/docs/

  • Skills, Hooks, Subagents 공식 가이드
  • MCP 통합 방법
  • 문제 해결

커뮤니티

Reddit: r/ClaudeCode - 활발한 커뮤니티, 팁 공유

Discord: Anthropic 공식 서버 - 직접 지원

GitHub Issues: https://github.com/affaan-m/everything-claude-code/issues

  • 질문, 버그 리포트
  • Affaan이 직접 답변

추가 학습

Git Worktrees 활용:

MCP 개발:

Advanced Patterns:

  • Multi-agent orchestration
  • Context window optimization
  • Enterprise deployment

에필로그: 개발의 미래

Affaan Mustafa는 21세입니다. 10개월 전 Claude Code 실험 버전을 받았을 때, 그는 매일 사용하며 설정을 갈고닦았습니다. 시행착오를 반복했습니다. 무엇이 작동하고 무엇이 작동하지 않는지 배웠습니다.

그리고 해커톤에서 100명을 이기고 우승했습니다. 8시간 만에 완전한 제품을 만들었습니다. 혼자서.

이제 그 설정이 당신 것입니다. 수백 시간의 시행착오가 5분의 git clone으로 압축됐습니다.

고민할 시간에 일단 git clone부터.

당신의 Claude도 시니어 엔지니어로 만들 시간입니다.


작성일자: 2026-01-20

저작권:

  • Affaan Mustafa의 설정: MIT License
  • 이 문서: CC BY 4.0 (출처 표기 후 자유 사용)

기여: 이 문서가 도움이 됐다면:

  1. Affaan의 저장소에 ⭐ Star
  2. 당신의 팀과 공유
  3. 개선 사항을 PR로 기여

마지막으로:

“The best time to start was 10 months ago. The second best time is now.”

— Affaan Mustafa의 정신으로

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.