everything-claude-code — 10개월 에이전트 노하우를 Claude Code에 이식하는 법

AI 에이전트를 쓸수록 드는 이상한 느낌

프로젝트를 새로 시작할 때마다 Claude Code가 같은 실수를 반복한다.
지난 세션에서 배운 게 없다. 토큰은 생각보다 빨리 닳는다. 훅 설정은 매번 손으로 짜야 한다.

'AI가 점점 똑똑해진다'는데, 정작 내 에이전트는 왜 매번 신입처럼 행동할까?

그 답이 everything-claude-code(이하 ECC)다.

---

ECC가 푸는 문제: 에이전트 하네스의 성능 공백

Claude Code 자체는 모델이다. 모델이 똑똑해도 그걸 둘러싼 '하네스'가 허술하면 성능은 새어나간다.

하네스란 Claude Code가 실제로 작동하는 환경 전체다. 훅, 스킬, 규칙, 메모리 지속성, 병렬화 전략, 보안 스캔까지.

ECC는 이 하네스를 10개월 이상 실제 프로덕트를 만들며 다듬은 결과물이다. Anthropic 해커톤 우승작이기도 하다.
140K+ 스타, 21K+ 포크, 170+ 기여자. 숫자보다 중요한 건 — 이게 실제 배포 환경에서 쌓인 패턴이라는 점이다.

기존 방식의 한계는 명확하다:

• 세션이 끝나면 컨텍스트가 사라진다 (메모리 지속성 없음)
• 토큰 최적화를 수동으로 해야 한다
• 에이전트 보안 스캔이 별도 도구로 분리되어 있다
• 새 프로젝트마다 스킬/훅을 처음부터 세팅한다

---

핵심 동작 원리: 하네스 성능 시스템

ECC는 단순한 설정 모음이 아니다. 다섯 개 레이어가 맞물려 동작한다.

1. 스킬 + 에이전트 레이어
48개 에이전트, 182개 스킬이 Claude Code 안에 설치된다. TypeScript, Python, Go, Java, Kotlin, Rust, C++, PHP, Perl 등 12개 언어 생태계를 커버한다.

2. 훅 런타임 레이어
세션 시작/종료 시 자동으로 컨텍스트를 저장하고 불러온다. ECC_HOOK_PROFILE=minimal|standard|strict로 런타임에 제어 가능하다.

3. 메모리 지속성 레이어
세션 간 패턴을 자동 추출해 재사용 가능한 스킬로 저장한다. '연속 학습'이 설계 요건에 포함돼 있다.

4. 검증 루프 레이어
체크포인트 이벌, pass@k 메트릭, 그레이더 타입 선택까지. 에이전트 결과물을 자동으로 검증한다.

5. 보안 레이어 (AgentShield)
AgentShield가 통합되어 있다. /security-scan 스킬 하나로 Claude Code 안에서 직접 보안 스캔을 실행한다. 1282개 테스트, 102개 규칙.

---

설치 가이드: 두 줄로 시작

가장 권장되는 경로는 Claude Code 플러그인 설치다.

# 마켓플레이스 추가
/plugin marketplace add https://github.com/affaan-m/everything-claude-code

# 플러그인 설치
/plugin install everything-claude-code@everything-claude-code

훅이 너무 전역적으로 느껴지거나 규칙/에이전트/스킬만 원하는 경우 — 플러그인 없이 미니멀 프로파일로 설치할 수 있다:

./install.sh --profile minimal --target claude

훅은 제외하되 코어 프로파일을 원한다면:

./install.sh --profile core --without baseline:hooks --target claude

어떤 컴포넌트가 필요한지 모르겠다면 패키지 어드바이저를 먼저 실행한다:

npx ecc consult "security reviews" --target claude

⚠️ 설치 방법을 중복해서 쓰지 말 것. /plugin install 후 install.sh --profile full을 추가로 실행하는 게 가장 흔한 깨진 세팅이다.

---

실전 예시

시나리오 1: 보안 스캔이 필요한 프로젝트

ECC 설치 후 Claude Code 안에서 바로 실행:

/security-scan

AgentShield가 프로젝트 전체를 스캔한다. 별도 CLI 도구 없이 Claude Code 세션 안에서 완결된다.

시나리오 2: 멀티 에이전트 워크플로우

PM2 기반 멀티 에이전트 관리:

/multi-plan
/multi-execute
/multi-backend

/pm2, /multi-frontend, /multi-workflow 커맨드로 복잡한 멀티 서비스 워크플로우를 Claude Code 안에서 오케스트레이션한다.

---

언제 쓰면 안 되는가 / 트레이드오프

ECC가 맞지 않는 경우:

• Claude Code를 간헐적으로만 쓰는 경우 — 48개 에이전트와 182개 스킬의 규모가 오히려 인지 부담이 된다.
• 단일 언어/단일 프레임워크만 쓰는 소규모 프로젝트 — 미니멀 프로파일로도 과할 수 있다.
• 플러그인 설치 후 수동 인스톨러를 추가로 실행한 경우 — 중복 설치로 파일이 꼬인다. README에서 Reset/Uninstall 가이드를 먼저 보자.

실질적 트레이드오프:

• 훅 런타임이 전역 동작이라 세밀한 제어가 필요하면 ECC_DISABLED_HOOKS 환경변수로 끄거나 ECC_HOOK_PROFILE=minimal로 낮춰야 한다.
• v2.0.0-rc.1의 Rust 컨트롤플레인(ecc2/)은 아직 알파다. 일반 릴리즈가 아니다.
• 140K 스타의 큰 커뮤니티지만, 빠른 릴리즈 사이클(v1.2~v2.0을 3개월 안에)이 안정성보다 속도를 우선했다.

---

같은 카테고리 대안 비교

dotfiles 방식 (수동 관리)
- 장점: 완전한 통제권, 의존성 없음
- 단점: 메모리 지속성·연속 학습·보안 스캔을 직접 구현해야 한다. ECC가 10개월 동안 해결한 문제를 처음부터 다시 푼다.

Cursor Rules / .cursorrules
- 장점: Cursor 사용자라면 이미 친숙한 경로
- 단점: Claude Code 특화 기능(훅, 서브에이전트 오케스트레이션, AgentShield)은 없다. ECC는 Cursor도 지원하지만, Claude Code를 기본 타깃으로 설계됐다.

결론: Claude Code를 메인 에이전트 하네스로 쓰고, 실제 프로덕트를 만들고 있다면 ECC는 경쟁 도구가 아닌 레이어다.

---

마무리: 에이전트 하네스의 성능은 설계된다

Claude Code의 모델 성능은 Anthropic이 올린다. 하네스 성능은 우리가 올린다.

ECC가 주는 인사이트는 단순히 '좋은 설정 파일 모음'이 아니다. 에이전트가 세션을 넘어 학습하고, 토큰을 아끼고, 보안을 검증하고, 병렬로 확장하는 — 이 모든 게 설계 가능한 레이어라는 관점이다.

다음 단계로는 ECC 설치 후 /harness-audit로 현재 하네스 점수를 진단하고, npx ecc consult로 내 프로젝트에 맞는 컴포넌트를 골라보는 것을 권한다. everything-claude-code + AgentShield 조합이 지금으로선 Claude Code 보안 강화의 가장 통합된 경로다.

---

🐦 X에서 더 빠르게: @baegseungh7061
📚 이 시리즈 더 보기: AI 인사이트
💌 새 글 알림: X 팔로우 또는 블로그 RSS 구독