Claude Code는 이제 개발자들에게 없어서는 안 될 필수 AI 프로그래밍 도구가 되었습니다. 하지만 대부분의 사용자는 단순히 대화로 코드를 작성하는 등, 그 능력의 30% 정도만 활용하고 있죠.
everything-claude-code는 GitHub에서 약 5만 개의 스타를 받은 Claude Code 설정 및 플러그인 모음집으로, Anthropic 해커톤 우승자인 Affaan Mustafa가 오픈 소스로 공개했습니다. 이 프로젝트는 13개의 전문 에이전트, 40개 이상의 온디맨드 스킬, 32개의 단축 명령어, 그리고 완벽한 지속적 학습 시스템을 제공하여 Claude Code의 개발 효율성을 새로운 차원으로 끌어올려 줍니다.
이 프로젝트의 핵심 이념은 이렇습니다. "Claude Code는 단순한 채팅 도구가 아니라, 고도로 커스터마이징이 가능한 AI 에이전트 오케스트레이션 플랫폼이다."
| 프로젝트 지표 | 데이터 |
|---|---|
| GitHub Stars | 약 49,900 (5만 돌파 임박) |
| Forks | 약 6,200 |
| 전문 에이전트 | 13개 |
| 온디맨드 스킬 | 40개 이상 |
| 단축 명령어 | 32개 |
| 지원 언어 | TypeScript, Python, Go, Java, C++ |
| 현재 버전 | v1.5.0 (2026년 2월 기준) |
| 라이선스 | MIT 오픈 소스 |
🚀 빠른 시작: Claude Code를 호출하려면 Claude 모델의 지원이 필요합니다. **APIYI(apiyi.com)**를 이용하면 Claude 4 Sonnet, Claude 4 Opus 등 최신 모델의 API 인터페이스를 빠르게 확보하여 everything-claude-code 플러그인과 즉시 연동해 사용할 수 있습니다.
everything-claude-code는 무엇인가요: 해커톤 우승작에서 별 5만 개의 오픈 소스 프로젝트까지
everything-claude-code의 탄생 배경
2025년 9월, Affaan Mustafa와 팀 동료 @DRodriguezFX는 Anthropic과 Forum Ventures가 공동 주최한 뉴욕 해커톤에 참가했습니다. 그들은 단 8시간 만에 Claude Code만을 사용하여 zenith.chat 제품을 구축했고, 100개 이상의 참가 팀을 제치고 1위와 15,000달러의 API 크레딧 상금을 거머쥐었습니다.
이 우승 뒤에 숨겨진 비밀 병기는 바로 Affaan이 10개월간 일상적으로 사용하며 다듬어온 Claude Code 설정 방안이었습니다. 해커톤 이후 그는 이 설정들을 오픈 소스로 공개했는데, 그것이 바로 everything-claude-code입니다.
everything-claude-code의 핵심 포지셔닝
everything-claude-code는 독립적인 소프트웨어가 아니라 Claude Code의 설정 강화 레이어입니다. 다음과 같은 방식으로 Claude Code의 능력을 확장합니다.
| 강화 차원 | 순정 Claude Code | everything-claude-code 설치 후 |
|---|---|---|
| 작업 계획 | 수동 설명 필요 | /plan 명령으로 작업 자동 분해 |
| 코드 리뷰 | 수동 요청 필요 | 전문 에이전트가 자동 리뷰 |
| 테스트 주도 | 직접 테스트 작성 | TDD 에이전트가 전체 프로세스 가이드 |
| 보안 스캔 | 내장 스캔 없음 | AgentShield 912개 규칙으로 스캔 |
| 지식 축적 | 세션별 독립적 | 지속적 학습 시스템으로 세션 간 기억 공유 |
| 다국어 지원 | 일반적인 처리 | 언어별 전용 규칙 및 베스트 프랙티스 적용 |
GitHub 프로젝트 주소: github.com/affaan-m/everything-claude-code
everything-claude-code의 4계층 아키텍처 분석
everything-claude-code는 정교하게 설계된 4계층 아키텍처를 채택하여 각 계층에서 서로 다른 문제를 해결합니다.
제1계층: 사용자 상호작용 계층 (Commands + Rules)
32개의 단축 명령은 everything-claude-code와 상호작용하는 입구입니다. 기능에 따라 6가지 카테고리로 나뉩니다.
| 명령 카테고리 | 대표 명령 | 역할 |
|---|---|---|
| 핵심 워크플로우 | /plan, /tdd, /e2e |
작업 계획, 테스트 주도 개발, 엔드투엔드 테스트 |
| 코드 품질 | /code-review, /build-fix, /refactor-clean |
코드 리뷰, 빌드 수정, 리팩토링 및 정리 |
| 멀티 에이전트 협업 | /multi-plan, /multi-execute |
여러 에이전트가 병렬로 협업하여 복잡한 작업 수행 |
| 학습 시스템 | /learn-eval, /evolve |
학습 효과 평가, 경험을 스킬로 진화 |
| 언어 전용 | /go-review, /python-review |
특정 언어 맞춤형 코드 리뷰 |
| 세션 관리 | /sessions, /checkpoint |
세션 추적 및 체크포인트 저장 |
**규칙(Rules)**은 컨텍스트에 항상 로드되는 기본 설정으로, 공통 코딩 표준, Git 워크플로우 규격, 테스트 커버리지 요구 사항(80% TDD), 보안 규칙 등을 포함합니다. 규칙은 TypeScript, Python, Go 등 언어별 전용 설정으로 나뉩니다.
제2계층: 지능형 계층 (Agents + Skills)
13개의 전문 에이전트는 everything-claude-code의 핵심 능력입니다. 각 에이전트는 명확한 책임 범위와 제한된 도구 권한을 가집니다.
| 에이전트 이름 | 역할 | 도구 권한 |
|---|---|---|
| Planner | 상위 작업 분해 및 계획 | 광범위 (오케스트레이션형) |
| Architect | 시스템 설계 및 아키텍처 결정 | 광범위 (오케스트레이션형) |
| TDD Guide | 테스트 주도 개발 프로세스 안내 | 코드 + 테스트 도구 |
| Code Reviewer | 범용 코드 리뷰 | 읽기 전용 분석 |
| Security Reviewer | 보안 전용 리뷰 | 읽기 전용 분석 |
| Build Error Resolver | 빌드 오류 진단 및 수정 | 빌드 + 디버깅 도구 |
| E2E Runner | 엔드투엔드 테스트 실행 | 테스트 실행 도구 |
| Refactor Cleaner | 코드 리팩토링 및 정리 | 코드 편집 도구 |
| Doc Updater | 문서 자동 유지보수 | 문서 편집 도구 |
| Go Reviewer | Go 언어 전용 리뷰 | 읽기 전용 분석 |
| Go Build Resolver | Go 빌드 오류 수정 | Go 빌드 도구 |
| Python Reviewer | Python 전용 리뷰 (PEP 8) | 읽기 전용 분석 |
| Database Reviewer | SQL/ORM/마이그레이션 리뷰 | 데이터베이스 읽기 전용 |
에이전트 간에는 계층적 위임 모델을 사용합니다. 오케스트레이션형 에이전트(Planner, Architect)는 광범위한 도구 접근 권한을 가지며 전문 에이전트를 스케줄링할 수 있습니다. 반면 전문 에이전트는 자신의 책임과 관련된 도구에만 접근할 수 있어 권한 남용을 방지합니다.
**40개 이상의 스킬(Skills)**은 필요에 따라 로드되는 도메인 지식 모듈입니다. 규칙(Rules)과 달리 스킬은 필요할 때만 로드되므로 상주 컨텍스트 윈도우를 점유하지 않습니다. 주요 커버리지 영역은 다음과 같습니다.
- 백엔드 개발: API 디자인 패턴, 데이터베이스 캐싱, 마이그레이션 전략, 성능 최적화
- 프런트엔드 개발: React, Next.js, E2E 테스트, Page Object Model
- 언어 전용: TypeScript, Python, Go, Java, C++, Django, Spring Boot
- DevOps: Docker 컨테이너화, 배포 패턴, PM2 프로세스 관리
- 고급 기능: 토큰 최적화, 비용 인식 LLM 파이프라인, 보안 스캔
🎯 기술 제언: everything-claude-code의 에이전트 및 스킬 시스템은 Claude 모델의 강력한 추론 능력에 의존합니다. APIYI apiyi.com 플랫폼을 통해 Claude 4 시리즈 모델의 API 인터페이스를 확보하여 everything-claude-code와 함께 사용하면 멀티 에이전트 협업 능력을 최대한으로 발휘할 수 있습니다.
제3계층: 자동화 계층 (Hooks + Scripts)
훅(Hooks)은 이벤트 기반의 자동화 메커니즘으로, Claude Code의 다양한 생명주기 단계에서 자동으로 트리거됩니다.
| 훅(Hook) 유형 | 트리거 시점 | 기능 |
|---|---|---|
| PreToolUse | 도구 실행 전 | 품질 게이트 체크 |
| PostToolUse | 도구 실행 후 | 결과 검증 |
| SessionStart | 세션 시작 시 | 컨텍스트 및 메모리 로드 |
| SessionEnd | 세션 종료 시 | 패턴 및 영구 메모리 저장 |
| PreCompact | 컨텍스트 압축 전 | 전략적 압축 제안 |
| Stop | 세션 중단 시 | 패턴 추출 및 경험 축적 |
제4계층: 학습 계층 (Continuous Learning v1 + v2)
이것은 everything-claude-code만의 가장 독특한 기능으로, Claude Code가 세션을 넘나들며 경험을 축적할 수 있게 해줍니다.
v1 학습 시스템 (스킬 기반):
- 세션 종료 시 Stop 훅을 통해 코딩 패턴 추출
- 추출된 패턴을
~/.claude/skills/learned/디렉토리에 저장 - 약 50~80%의 커버리지 관찰
v2 학습 시스템 (본능 기반):
- PreToolUse/PostToolUse 훅을 통해 100% 커버리지 실현
- 각 학습 단위는 0.3~0.9의 신뢰도 점수를 가진 '본능(Instinct)'으로 관리
/evolve명령을 사용하여 3개 이상의 관련 본능을 재사용 가능한 스킬 모듈로 통합
everything-claude-code 설치 및 Claude Code API 설정 튜토리얼
everything-claude-code 설치
사전 요구 사항: Claude Code CLI v2.1.0 이상 버전.
1단계: 플러그인 설치
# Claude Code 플러그인 마켓플레이스를 통해 설치
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code
2단계: 규칙 파일 설치
# 저장소 복제
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
# 주요 개발 언어에 맞춰 규칙 세트를 선택하세요
./install.sh typescript # TypeScript 프로젝트
./install.sh python # Python 프로젝트
./install.sh golang # Go 프로젝트
3단계: 설치 확인
# Claude Code에서 테스트
/plan "Add user authentication"
Planner Agent가 자동으로 작업을 분해하고 다른 Agent에게 위임하는 모습이 보인다면 설치가 성공적으로 완료된 것입니다.
Claude Code API 연동 설정
Claude Code를 실행하려면 Claude 모델의 API 지원이 필요합니다. 다음은 APIYI 플랫폼을 통한 설정 단계입니다.
# API 엔드포인트 주소 설정
export ANTHROPIC_BASE_URL=https://api.apiyi.com
# API 키 설정
export ANTHROPIC_API_KEY=사용자의_API_키
💡 팁: APIYI(apiyi.com) 플랫폼은 Claude 4 Opus, Claude 4 Sonnet 등 모든 시리즈의 모델을 지원합니다. everything-claude-code의 멀티 Agent 협업은 많은 API 호출을 발생시키는데, APIYI의 유연한 요금제를 활용하면 비용을 효과적으로 관리할 수 있습니다.
설정이 완료되면 Claude Code가 자동으로 APIYI의 인터페이스를 사용하여 Claude 모델을 호출하며, everything-claude-code의 모든 Agent와 Skill이 정상적으로 작동하게 됩니다.
