Claude Code 플러그인 큐레이션 시리즈 · 2편 ECC
이 글에서 다루는 내용
Everything Claude Code(이하 ECC)는 GitHub 별 12만 개 이상을 받은 Claude Code 강화 플러그인입니다. 30개 에이전트와 135개 스킬을 묶어 두는 데서 그치지 않고, AgentShield 보안 스캐너(테스트 1,282개·정적 분석 102개)와 인스팅트 기반 자가 학습 시스템까지 한 묶음으로 제공합니다. 같은 설치로 Cursor·Codex·OpenCode 환경까지 함께 강화되는 점이 다른 플러그인과 구별되는 지점입니다. 이 글은 설치 명령, 핵심 기능 네 축(에이전트·스킬·보안·학습), 활용 시나리오, 1편 OMC와의 차이까지 정리합니다. 라이선스는 오픈소스이고 기준 시점은 2026년 4월입니다.
1. ECC가 정확히 무엇인가
공식 README는 ECC를 다음과 같이 소개합니다.
"The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond."
핵심 포인트 세 가지입니다.
- 퍼포먼스 최적화 시스템으로 자리잡고자 한다는 점. 단순 명령 모음이 아니라 토큰 사용량과 컨텍스트 관리 자체를 다시 짠 통합 셋업입니다.
- 한 설치로 멀티 도구 커버. Claude Code 8종 hook, Cursor 15종 hook, Codex(
config.toml), OpenCode 11종 hook을 동시에 지원합니다. - 학습하는 도구. 사용자의 작업 패턴을 관찰해 자체적으로 스킬을 늘려 갑니다.
2. 설치 - 두 단계
2-1. 마켓플레이스 등록과 플러그인 설치
Claude Code 세션 안에서 다음 두 명령을 차례로 실행합니다.
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code
두 번째 명령에서 @everything-claude-code가 한 번 더 붙는 형태가 어색해 보일 수 있는데, 공식 마켓플레이스 식별자가 그렇게 정해져 있습니다. 그대로 입력해야 합니다.
2-2. 룰 모듈 설치 - 추가 한 단계
Claude Code 플러그인은 ~/.claude/rules/ 영역에 직접 파일을 배포할 수 없습니다. ECC가 룰 모듈을 별도로 가지고 있기 때문에, 마켓플레이스 설치 후 다음 명령을 한 번 더 돌려 룰을 골라 깔아야 완전 동작합니다.
/ecc:configure-ecc
대화형 설정 스킬이 떠서 어떤 룰 모듈을 설치할지 묻습니다. 처음 설치할 땐 기본값으로 진행해도 충분하고, 나중에 필요한 모듈만 추가로 활성화해 가는 흐름이 안전합니다.
⚠️
/ecc:configure-ecc를 건너뛴 채로 첫 작업을 돌리면 "스킬은 보이는데 동작이 어딘가 어긋나는" 상태가 되기 쉽습니다. 룰 모듈이 있어야 보안·메모리·자가 학습이 정상 작동합니다.
3. 핵심 기능 네 축
ECC가 한 번에 풀어 내는 기능은 크게 네 카테고리로 묶입니다.
| 축 | 규모 | 대표 구성 |
|---|---|---|
| 에이전트 | 30개 | planner, architect, TDD guide, security reviewer, build-error resolver, 언어별 reviewer (TS·Python·Go·Java·Kotlin·Rust·C++) |
| 스킬 | 135개 | 테스트 작성, 코드 리뷰, 리팩터, 디버깅, 시그널 분석 등 |
| 보안 (AgentShield) | 테스트 1,282개 · 정적 분석 102개 | red-team / blue-team / auditor 3종 Opus 에이전트 파이프라인 |
| 자가 학습 | /evolve 명령 |
세션 패턴 → 인스팅트(원자 단위 신뢰도 부여) → 스킬·명령·에이전트로 진화 |
3-1. AgentShield - 보안 스캐너
ECC의 차별 포인트입니다. 일반 코드 보안 스캐너와 달리 AI 에이전트 시스템 자체를 점검합니다.
| 검사 대상 | 무엇을 보는가 |
|---|---|
| CLAUDE.md, settings.json | 시크릿 노출 (14개 패턴), 위험 권한 |
| MCP 서버 설정 | 신뢰할 수 없는 출처, 권한 과다 |
| hook 정의 | hook 인젝션 공격 가능성 |
| 에이전트·스킬 정의 | 설정 누락, 권한 비대칭 |
3종 Opus 에이전트(red-team이 공격 시나리오를 만들고, blue-team이 방어, auditor가 최종 평가)가 한 파이프라인을 돈 결과를 리포트로 받습니다. 사내 도구를 운영하기 시작하면 가장 먼저 켜 두면 좋은 기능입니다.
3-2. 인스팅트와 /evolve - 자가 학습 루프
ECC는 hook을 통해 사용자의 세션을 관찰하면서 작은 행동 패턴을 인스팅트(instinct)라는 원자 단위로 저장합니다. 각 인스팅트는 신뢰도 점수를 가집니다. /evolve 명령을 실행하면 모인 인스팅트가 클러스터링되어 재사용 가능한 스킬·명령·에이전트로 승격됩니다.
/evolve
v2.1부터는 프로젝트 단위 인스팅트가 들어가서 한 프로젝트의 패턴이 다른 프로젝트로 흘러 들어가는 오염을 막아 줍니다. 사이드 프로젝트와 본업 코드를 같은 노트북에서 다루는 사용자에게 중요한 변화입니다.
3-3. 토큰 최적화 디폴트
모델 라우팅과 컨텍스트 관리도 ECC가 자체적으로 깔아 둡니다. 사용자가 별도 설정을 만지지 않아도 다음 디폴트가 적용됩니다.
- 일반 작업의 약 80%는 Sonnet으로 라우팅
- 깊은 추론이 필요한 분기는 Opus로 자동 승격
- 오토 컴팩션 임계점이 95%가 아니라 50%로 당겨져 있어 컨텍스트가 가벼운 상태로 유지됨
4. 활용 시나리오 세 가지
4-1. 보안 점검을 첫 단계에 박는다
운영 환경에 들어가는 코드를 다루기 시작했다면, ECC를 켠 직후 한 번 AgentShield를 돌려 두는 흐름이 안전합니다. 사용자가 의식하지 않은 채로 CLAUDE.md나 MCP 설정에 시크릿이 흘러 들어간 경우가 의외로 잦습니다.
> AgentShield로 이 프로젝트의 에이전트·hook·MCP 설정·CLAUDE.md를 시크릿 노출, 권한 과다, hook 인젝션 관점에서 점검해줘.
4-2. 한 달 작업을 스킬로 압축한다
ECC를 한 달쯤 사용한 시점에 /evolve를 한 번 돌려 보면, 그동안 반복했던 패턴들이 신뢰도 순으로 정리되어 어떤 것이 스킬로 승격되는지 보입니다. "내가 매번 같은 형태로 테스트를 짜고 있었다" 같은 자기 인지가 명시적으로 드러나는 순간입니다. 사용자는 그 결과를 보고 어떤 인스팅트를 살리고 어떤 걸 버릴지만 결정하면 됩니다.
4-3. 다중 도구 환경을 한 번에 강화한다
Claude Code와 Cursor를 함께 쓰거나, Codex·OpenCode를 부분적으로 쓰는 팀이라면 ECC 한 번 설치로 네 환경 모두에 일관된 hook과 스킬이 적용됩니다. 도구별 설정을 따로 관리하지 않아도 되는 게 의외로 큰 이점입니다.
5. 1편 OMC와의 차이
같은 "다중 에이전트 강화" 카테고리지만 두 플러그인의 결이 분명히 갈립니다.
| 관점 | OMC | ECC |
|---|---|---|
| 지향점 | 학습 곡선 제거 (자연어 인터페이스) | 하네스 자체 성능 최적화 |
| 대표 명령 | /autopilot, /ultrawork |
/evolve, AgentShield, /ecc:configure-ecc |
| 에이전트 수 | 29개 카테고리 | 30개 + 스킬 135개 |
| 고유 강점 | 병렬 실행, 알림 연동(Telegram·Discord), HUD | 보안 스캐너, 자가 학습, 멀티 도구 동시 강화 |
| 잘 맞는 사용처 | 사이드 프로젝트, 빠른 프로토타입 | 사내 도구, 운영 진입 직전 단계 |
둘은 동시에 설치할 수도 있지만 스킬·hook이 겹쳐 충돌할 가능성이 있습니다. 한 환경에선 한쪽으로 정하고, 프로젝트 단위로 갈라 쓰는 편이 안정적입니다.
트러블슈팅
문제 1: 명령은 보이는데 동작이 어딘가 비어 있다
/ecc:configure-ecc를 건너뛴 경우입니다. 룰 모듈이 ~/.claude/rules/에 깔리지 않으면 보안·메모리·자가 학습이 작동하지 않습니다. 한 번 더 실행하고 룰 모듈을 선택하면 해결됩니다.
문제 2: 컨텍스트가 너무 자주 압축된다
ECC의 오토 컴팩션 임계점이 50%로 당겨져 있어 디폴트 환경보다 압축이 일찍 일어납니다. 작업이 길게 이어지는 워크플로우에서 갑자기 정보가 사라진 것처럼 느껴진다면 임계점을 본인 환경에 맞게 조정하면 됩니다. /ecc:configure-ecc의 토큰 옵션 섹션에서 바꿀 수 있습니다.
문제 3: 다른 플러그인과 hook이 충돌한다
OMC, Superpowers 같은 다른 강화 플러그인을 함께 쓰면 hook이 겹쳐 같은 이벤트가 두 번 처리되는 경우가 있습니다. /plugins 목록과 ~/.claude/settings.json의 hook 정의를 한 번 점검하고, 한 환경에 한 강화 플러그인만 두는 쪽이 가장 안전합니다.
문제 4: /evolve 결과가 빈약하다
설치 직후엔 인스팅트가 거의 모이지 않아 결과가 약합니다. 1~2주 정도 일상 작업을 하고 나서 돌리면 의미 있는 클러스터가 잡힙니다. 또 v2.1 이전 버전에서는 프로젝트가 섞인 인스팅트가 잡힐 수 있어, 한 프로젝트 안에서만 패턴을 학습시키고 싶다면 최신 버전인지 먼저 확인합니다.
마무리
OMC가 "Claude Code를 외우지 않아도 된다"는 인터페이스 개선이라면, ECC는 "Claude Code의 엔진 자체를 한 단계 다시 짠다"는 결입니다. 30개 에이전트·135개 스킬이 화려한 카드처럼 보이지만 진짜 가치는 보안 스캐너와 자가 학습 루프, 그리고 멀티 도구 동시 강화에 있습니다. 사이드 프로젝트에서 시작해 사내 도구나 본 제품으로 넘어가는 시점에 한 번 도입을 검토해 둘 만한 도구입니다.
다음 편에서는 Anthropic 공식 마켓플레이스에서 가장 잘 검증된 플러그인 중 하나인 Superpowers를 다룰 예정입니다. ECC가 풀 스택 강화 도구라면, Superpowers는 일하는 방식 자체를 잡아 주는 결이 다른 도구입니다.
- ECC GitHub: github.com/affaan-m/everything-claude-code
- ECC DeepWiki: deepwiki.com/affaan-m/everything-claude-code
- 이전 편: 1편 OMC - Claude Code를 자연어로 다루는 다중 에이전트 플러그인
- 다음 편: 3편 Superpowers - 일하는 방식을 강제하는 14개 스킬
- 시리즈 인덱스: Claude Code 플러그인 큐레이션 시리즈
- 관련 글: Claude Code 플러그인 가이드
- 관련 글: Claude Code 활용 매뉴얼 - 8가지 원칙
'AI & LLM' 카테고리의 다른 글
| Ralph Loop - Claude Code가 완료될 때까지 자동으로 도는 루프 (0) | 2026.05.03 |
|---|---|
| Superpowers - Claude Code에 일하는 방식을 강제하는 14개 스킬 (1) | 2026.05.03 |
| OMC(oh-my-claudecode) - Claude Code를 자연어로 다루는 다중 에이전트 플러그인 (0) | 2026.05.01 |
| Claude Code 플러그인 큐레이션 시리즈 - 카테고리별로 정리한 6가지 필수템 (0) | 2026.05.01 |
| OpenRouter 입문 - AI 모델 게이트웨이 한 번에 이해하기 (0) | 2026.04.30 |
