Everything Claude Code(ECC) 완벽 가이드 - 혼자서 팀처럼 개발하는 에이전트 하네스 셋업

들어가며

Claude Code를 쓰면서 이런 생각을 해본 적 있는가?

• "매번 같은 설명을 반복하고 있어..."
• "코드 리뷰를 자동으로 할 수는 없을까?"
• "보안 체크를 빼먹지 않으려면?"

Everything Claude Code(ECC)는 이 문제를 해결하기 위해 만들어진 에이전트 하네스 성능 최적화 시스템이다. GitHub 스타 140K+를 기록하며, 2026년 가장 주목받는 AI 개발 도구 중 하나가 되었다.

47개의 전문 에이전트, 180개 이상의 워크플로우 스킬, 자동화 훅, 보안 스캐너까지. 이 글에서는 ECC의 핵심 구성요소와 실전 셋업 방법을 정리한다.

1. ECC란 무엇인가?

정의

ECC는 AI 코딩 에이전트의 입력, 출력, 도구 접근을 체계적으로 관리하는 외부 프레임워크다. 테스트 하네스가 테스트 환경을 제어하듯, 에이전트 하네스는 AI 에이전트가 작동하는 전체 환경을 제어한다.

왜 필요한가?

Claude Code만 단독으로 사용하면 200K 컨텍스트 윈도우를 가지고 있지만, MCP 서버 설정이 과도하면 실제 사용 가능한 컨텍스트가 70K까지 줄어들 수 있다. ECC는 이런 컨텍스트 낭비를 방지하고, 에이전트가 체계적으로 작업하도록 가이드한다.

크로스 플랫폼 지원

플랫폼	지원 수준
Claude Code	Full (Primary)
Cursor IDE	Full (Feature Parity)
OpenCode	Full (31+ 슬래시 명령)
OpenAI Codex	Full (codex.md 생성)
Gemini CLI	Experimental

2. 설치 방법

Step 1: 플러그인 설치

# Claude Code에서 실행
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install ecc@ecc

Step 2: 규칙(Rules) 설치

# 리포 클론
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code && npm install

# 전체 설치 (macOS/Linux)
./install.sh --profile full

# 특정 언어만 선택 설치 (권장)
./install.sh typescript python golang
./install.sh java kotlin  # Java/Kotlin 개발자라면

# Windows
.\install.ps1 --profile full

Step 3: 사용 시작

# 계획 수립
/ecc:plan "사용자 인증 기능 추가"

# 설치된 컴포넌트 확인
/plugin list ecc@ecc

# 하네스 상태 점검
/harness-audit

팁: 모든 기능을 한 번에 설치하지 말고, 자신의 기술 스택에 맞는 것만 선택적으로 설치하는 것이 권장된다.

3. 핵심 구성요소

3-1. 47개 전문 에이전트

ECC의 가장 강력한 기능은 역할별로 특화된 서브에이전트다.

카테고리	에이전트	역할
기획	planner, architect, chief-of-staff	프로젝트 설계 및 태스크 분해
코드 리뷰	code-reviewer, security-reviewer	품질/보안 자동 리뷰
언어별 리뷰	java-reviewer, typescript-reviewer, python-reviewer, kotlin-reviewer 등	언어별 전문 리뷰
빌드 해결	build-error-resolver, java-build-resolver, go-build-resolver 등	빌드 에러 자동 분석/해결
테스트	tdd-guide, e2e-runner	TDD 가이드 및 E2E 테스트
운영	doc-updater, refactor-cleaner, harness-optimizer	문서화, 리팩토링, 하네스 최적화

# 에이전트 사용 예시
/code-reviewer    # 현재 변경사항 리뷰
/security-reviewer # 보안 취약점 분석
/tdd-guide         # TDD 워크플로우 시작
/architect         # 아키텍처 설계 도움

3-2. 180+ 워크플로우 스킬

스킬은 특정 작업 패턴을 정의한 마크다운 기반 워크플로우다.

Spring Boot 개발자를 위한 스킬

# Java/Spring 관련 스킬
springboot-patterns      # Spring Boot 패턴 가이드
springboot-security      # 보안 설정 자동화
springboot-tdd           # Spring 테스트 전략
springboot-verification  # 검증 워크플로우
jpa-patterns             # JPA 패턴 가이드
java-coding-standards    # Java 코딩 표준
postgres-patterns        # PostgreSQL 패턴

인프라/DevOps 관련 스킬

docker-patterns          # Docker 최적화
deployment-patterns      # 배포 패턴
e2e-testing              # E2E 테스트 자동화
api-design               # API 설계 가이드
database-migrations      # DB 마이그레이션

3-3. 자동화 훅 시스템

훅은 에이전트의 특정 이벤트에 자동으로 실행되는 동작이다.

# 훅 이벤트 타입
- SessionStart    # 세션 시작 시
- Edit            # 파일 수정 시
- FileCreate      # 파일 생성 시
- CommandRun      # 명령 실행 시
- Stop            # 세션 종료 시 (요약 자동 생성)

# 훅 프로필 설정
export ECC_HOOK_PROFILE=standard  # minimal | standard | strict

# 특정 훅 비활성화
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

예를 들어, 파일을 수정할 때마다 자동으로 타입체크를 실행하거나, 세션 종료 시 자동으로 진행 상황을 기록하는 훅을 설정할 수 있다.

4. Instinct 시스템 - 자가 학습

ECC의 가장 혁신적인 기능 중 하나다. 세션 중 도구 사용 패턴을 자동으로 캡처하여 "Instinct"로 저장한다.

동작 방식

1. 세션 중 문제 해결 패턴이 감지됨
2. 프론트매터 메타데이터(제목, 도메인, 신뢰도 점수)와 함께 저장
3. /evolve 명령으로 고신뢰도 패턴을 재사용 가능한 스킬로 진화

# Instinct 예시
---
title: Spring Boot 3 ConfigurationProperties 마이그레이션
domain: spring-boot
confidence: 0.92
---

## Action
@ConfigurationProperties 클래스에서 @ConstructorBinding 제거
(Spring Boot 3.x에서는 생성자가 하나면 자동 감지)

## Evidence
빌드 에러: "@ConstructorBinding has no effect"
해결: 어노테이션 제거 후 빌드 성공

## Examples
- AS-IS: @ConstructorBinding @ConfigurationProperties("app")
- TO-BE: @ConfigurationProperties("app")

즉, 실수에서 자동으로 학습하고, 같은 실수를 반복하지 않는 시스템이다.

5. AgentShield - 보안 스캐너

AI 에이전트를 사용하면 보안 위험도 함께 온다. AgentShield는 이를 방지하는 통합 보안 감사 도구다.

스캔 범위

카테고리	점검 내용
시크릿 탐지	14개 패턴으로 API 키, 토큰, 비밀번호 노출 검사
권한 감사	과도한 도구 권한, 위험한 Bash 명령 허용 여부
훅 인젝션	악성 훅, 의심스러운 명령 체인 분석
MCP 서버 위험	MCP 서버 설정의 보안 취약점 프로파일링
에이전트 설정	에이전트 설정 파일의 보안 검토

# 보안 스캔 실행
/security-scan

# 또는 npm 패키지로 독립 실행
npx ecc-agentshield

102개 정적 분석 규칙과 1,282개 테스트가 내장되어 있으며, 외부 의존성 없이 Claude Code 안에서 바로 실행된다.

6. 실전 활용 패턴

패턴 1: Two-Instance Kickoff

새 프로젝트를 시작할 때 두 개의 Claude Code 인스턴스를 동시에 실행한다:

# 인스턴스 1: 스캐폴딩
"Spring Boot 프로젝트 구조를 생성해줘.
헥사고날 아키텍처, Java 26, Gradle"

# 인스턴스 2: 리서치
"이 프로젝트에 필요한 의존성과 설정을
조사해서 CLAUDE.md에 정리해줘"

패턴 2: 병렬 작업 제어

# 코드 변경 없는 작업은 /fork로 분리
/fork "API 문서 생성"  
# → 별도 브랜치에서 문서화 작업 진행

# Git Worktrees로 충돌 방지
/multi-backend   # 백엔드 작업
/multi-frontend   # 프론트엔드 작업 (동시)

패턴 3: 일일 루틴

# 매일 시작할 때
/harness-audit       # 하네스 설정 건강도 점검
/security-scan       # 보안 스캔

# 작업 중
/ecc:plan "오늘의 태스크"  # 계획 수립
/tdd                     # TDD 워크플로우
/code-reviewer           # 코드 리뷰

# 세션 종료 전
/compact-session         # 컨텍스트 압축 저장
/quality-gate            # 품질 게이트 통과 확인

7. Java/Spring 개발자를 위한 추천 설정

# 설치 (Java + Spring 스택만)
./install.sh java kotlin

# 활성화되는 주요 컴포넌트:
# 에이전트: java-reviewer, java-build-resolver,
#          kotlin-reviewer, code-reviewer
# 스킬:   springboot-patterns, springboot-security,
#         springboot-tdd, jpa-patterns,
#         java-coding-standards, postgres-patterns
# 규칙:   java/, kotlin/ 디렉토리의 언어별 규칙

8. 주의사항과 비판

과잉 설계 논란

ECC에 대한 가장 큰 비판은 "대부분의 팀에게 과도하다"는 것이다. 140K+ GitHub 스타에 비해 npm 주간 다운로드가 약 7,500건으로 전환율이 낮다는 지적도 있다.

권장 접근법

제작자 본인도 강조하는 핵심 철학:

"설정은 거대한 아키텍처 설계가 아니라, 미세 조정의 관점으로 접근하라."

• 처음부터 전체 설치하지 말 것: 필요한 언어/스킬만 선택
• 훅은 minimal 프로필로 시작: 점진적으로 strict로 올리기
• CLAUDE.md가 먼저: ECC 없이도 CLAUDE.md만 잘 작성하면 큰 효과

마치며

Everything Claude Code는 AI 코딩 에이전트를 "도구"에서 "팀원"으로 전환시키는 하네스 시스템이다. 47개 에이전트가 기획, 코딩, 리뷰, 테스트, 보안, 문서화를 각각 담당하고, Instinct 시스템으로 세션마다 학습하며 성장한다.

물론 모든 프로젝트에 ECC가 필요한 것은 아니다. 하지만 하네스 엔지니어링이라는 개념 자체는 AI 에이전트를 실무에 도입하는 모든 개발자가 이해해야 하는 패러다임이다.

당장 ECC를 설치하지 않더라도, 이 글에서 소개한 패턴들 - 에이전트 역할 분리, 자동 훅, 보안 스캔, 자가 학습 - 은 자신의 CLAUDE.md와 settings.json에 직접 적용할 수 있다. 작은 것부터 시작해보자.