ECC(Everything Claude Code) — 무엇이며 쓸 만한가?

2026년 봄, GitHub에서 affaan-m/ECC(Everything Claude Code, 이하 ECC)가 급부상했습니다. 단순한 「Claude 프롬프트 모음」이 아니라 Agent Harness(Claude Code, Cursor, Codex, OpenCode 등)를 겨냥한 스킬 + 훅 + 규칙 + 보안 스캔 + 메모리 최적화 묶음입니다. 이름에는 Claude Code가 들어가지만, 유지보수자는 여러 하네스를 명시적으로 지원합니다.

이 글은 질문 하나만 다룹니다: 매일 코드를 쓰는 사람으로서 ECC를 프로젝트나 전역 환경에 깔 가치가 있는가? 이미 Claude Code나 Cursor를 쓰고 있다면 아래 「적합 / 보류」 목록과 대조해 보세요. 중국어 설명은 저장소의 README.zh-CN.md도 참고할 수 있습니다.

3분 결론:

ECC = Harness 레이어의 「OS」

모델을 대체하지 않고, Agent에 스킬·세션 메모리·품질 게이트·보안 감사를 얹는 런타임 패키지입니다.

MIT 오픈소스
쓸 만함: Agent 헤비 유저

매일 AI가 여러 파일을 고치고 테스트·PR까지 하는 팀은 규칙을 반복 가르치는 비용이 줄어듭니다.

Skills + Hooks
관망: 가끔 한 줄만 묻는 경우

단일 라인 보완만 쓰면 전량 설치는 컨텍스트 노이즈와 유지 부담만 커집니다.

선택 설치

1. ECC란 무엇인가: 설정 파일 더미가 아님

공식 정의는 harness-native operator system(Agent 하네스용 운영체제)입니다. 유지보수자는 10개월 이상 매일 고강도 Agent로 실제 제품을 만든 경험을 담았고, Anthropic 해커톤식 워크플로에서 검증했다고 합니다(저장소의 Shorthand Guide·Longform Guide 참고).

저장소를 열면 규모가 압도적입니다. 수십 개의 Agents, 200개 이상 Skills, 다수의 Hooks(세션 시작/종료 메모리 기록, Stop 단계 요약 등), 언어별 Rules, AgentShield 보안 스캔, continuous learning(세션에서 패턴을 뽑아 재사용 스킬로) 등이 있습니다. v2.0 방향에는 Hermes 오퍼레이터 워크플로, 크로스 하네스 설치기, 실험적 Rust 제어 평면 ecc2/도 포함됩니다.

쉽게 말하면, Claude Code만 쓰면 「모델 + 터미널」이고 ECC를 얹으면 「모델 + 터미널 + 작성된 SOP + 자동 메모리 + 안전 가드레일」입니다. 컴파일러만 있는 것과 DevOps 템플릿이 있는 것의 차이와 비슷합니다. 누구나 후자가 필요한 것은 아니지만, 팀이 커지면 차이가 드러납니다.

ECC는 쓰는 하네스와 모델 사이에 있으며, Hooks로 로컬·클라우드 Runner에 연결할 수 있음

2. Claude Code / Cursor 단독 사용과의 차이

ECC를 처음 clone하면 「마크다운과 스크립트 무더기 아닌가?」라고 느끼기 쉽습니다. 가치는 한 줄짜리 프롬프트가 아니라 오케스트레이션과 기본 모범 사례에 있습니다.

하네스 단독 vs ECC 오버레이(팀 일상 개발)
차원	IDE Agent 단독 즉시 사용	ECC 적용 설치·트리밍 필요
규칙 일관성	CLAUDE.md를 직접 기억해 작성	언어·프레임워크별 Rules, TypeScript+Python만 설치 가능
세션 간 메모리	컨텍스트 유실, 수동 붙여넣기	Hooks가 세션 요약·스킬 진화를 자동 저장/로드
품질 게이트	테스트 실행을 스스로 기억	`/quality-gate`, 검증 루프, 벤치마크형 Skills
보안	의존성·샌드박스를 놓치기 쉬움	AgentShield, `/security-scan` 등(Security Guide)
온보딩 비용	낮음	중~높음: Guide 읽기, 선택 설치
Token 부담	비교적 통제 가능	스킬 과다 시 컨텍스트 팽창, `ECC_HOOK_PROFILE` 등으로 트리밍

팀에 이미 성숙한 AGENTS.md, CI, 리뷰 봇이 있다면 ECC는 기존 규범과 겹칠 수 있습니다. 통째로 덮어쓰지 말고 병합하세요. Agent 사용법이 아직 정리 중인 소규모 팀·솔로 풀스택에게 ECC는 「거인의 어깨」 역할을 하기 좋습니다.

3. 설치할 사람, 미룰 사람

진지히 시험할 가치: 매일 Agent에게 여러 저장소를 고치고 테스트·PR까지 맡기는 개발자; TypeScript / Python / Go / Java 리뷰 습관을 통일하려는 테크 리드; Cursor와 Claude Code를 오가며 규칙을 한 벌로 쓰고 싶은 사람.

건너뛰거나 최소 설치: 저장소를 건드리지 않고 Q&A만 하는 경우; 미감사 스크립트 자동 실행을 막는 엄격한 컴플라이언스 환경(보안 검토 선행); 수백 개 Skill 유지보수를 싫어하는 경우.

ECC는 manifest 기반 install-plan / install-apply와 configure-ecc 마법사로 선택 설치를 지원합니다. 246개 Skills를 한꺼번에 삼킬 필요는 없습니다. npm 패키지 ecc-universal로 일부만 가져오는 것도 가능합니다.

4. 설치 방법: clone부터 유지보수까지

침습성이 낮은 순서로 세 가지 경로가 일반적입니다.

읽고 골라 쓰기: Shorthand Guide와 중국어 README를 먼저 읽고, 필요한 Skills만 .cursor/rules나 Claude Code 설정 디렉터리로 복사.
선택 설치: 공식 설치 스크립트/플래너로 「언어 규칙 + 자주 쓰는 Hooks」만 설치해 컨텍스트 폭발 방지.
전량 동기화: 개인 dotfiles에는 적합; 팀은 monorepo에 버전 고정 후 ECC 회귀 테스트를 업그레이드 전에 실행(저장소는 대규모 테스트 하네스를 갖춘다고 명시).

설치 후 반드시: ECC_HOOK_PROFILE=minimal|standard|strict로 Hook 비용 조절; ECC_DISABLED_HOOKS로 당장 안 쓰는 자동화 비활성화. v2.0부터 ecc status --markdown으로 세션·준비 상태를 보내 동료에게 Agent 작업을 넘기기도 쉽습니다.

오픈소스와 상용 라인을 혼동하지 마세요

저장소는 MIT 오픈소스입니다. ECC Pro(GitHub App, 비공개 저장소 감사)와 Sponsor는 별도 제품 라인입니다. 「쓸 만한가」를 판단할 때는 OSS 기능을 먼저 충분히 써 본 뒤 Pro 결제를 검토하세요.

5. 클라우드 Mac / CI: Agent의 「손」은 어디에?

ECC는 「뇌 옆 SOP」를 다루지만, Agent는 여전히 git, xcodebuild, npm test를 어떤 머신에서든 실행해야 합니다. iOS / macOS 팀은 흔히 로컬 IDE + Agent 오케스트레이션과 원격 Mac Runner의 무거운 빌드를 짝짓습니다.

Hashvps 고객 시나리오와도 맞닿습니다. 예: GitHub Actions 자체 호스팅 macOS Runner를 클라우드 Mac에 두고 서명·Archive를 돌리거나, 같은 머신에서 무헤드 OpenClaw CI로 Agent가 Channel을 24/7 감시하게 하는 방식입니다. ECC 병렬화 문서(git worktree, cascade)는 안정적이고 SSH 가능한 macOS를 전제합니다. 노트북 뚜껑을 닫으면 병렬 Runner는 기대하기 어렵습니다.

실무 팁: ECC 규칙에 「무거운 명령은 Runner에서만」을 명시하고, Runner에는 전용 IP를 부여해 API·인증서 환경의 이상 징후를 줄이세요(사이트 머신당 IP 1개 참고).

6. 리스크와 거버넌스: 설치만 하고 방치 금지

컨텍스트 팽창: 스킬·Rules가 많으면 요청이 느려지고 비용이 커집니다. 주기적 skill-stocktake 유지(관련 Skill 포함).
자동 Hook 부작용: 세션 메모리 디스크 기록에 민감 정보가 섞일 수 있으니, 비공개 저장소도 기밀로 취급.
공급망: 공식 affaan-m/ECC 저장소와 npm 릴리스만 추적; fork는 code review 후.
OpenClaw와 역할 분담: OpenClaw는 7×24 개인 분신·Channels; ECC는 IDE 코딩 Harness. 공존은 가능하나 권한 모델을 섞지 마세요.

7. 쓸 만한가? 결정 체크리스트

아래에 대부분 해당하면 이번 주 2시간 ECC 시험을 권합니다. 아니면 Agent 단독 + 소수 Rules가 더 단순합니다.

주 3회 이상 Agent에게 여러 파일 수정·테스트 실행
팀 2명 이상, 리뷰 기준 통일 필요
Claude Code 또는 Cursor Agent 모드에서 「매번 규칙을 다시 가르침」
Shorthand Guide를 읽고 선택 설치할 의지
macOS Runner 또는 클라우드 Mac으로 무거운 작업(선택 가산)

8. 자주 묻는 질문

Q1. 이름에 Claude Code가 있는데 Anthropic 전용인가요?

아닙니다. 공식적으로 Cursor, Codex, OpenCode, Gemini CLI 등 다중 하네스를 지원합니다. Claude Code는 기원 시나리오일 뿐입니다. Cursor 사용자는 크로스 하네스 아키텍처 문서와 Cursor 전용 Rules 부분집합을 보세요.

Q2. 오픈소스는 무료인가요? ECC Pro와 관계는?

핵심 저장소는 MIT로 영구 무료입니다. ECC Pro는 GitHub App 등 호스팅 부가 서비스이며, 비공개 저장소 PR 감사·과금은 Pro 쪽입니다. public 학습용으로는 OSS만으로 충분한 경우가 많습니다.

Q3. Cursor 기본 Rules와 충돌하나요?

겹칠 수 있으니 병합 전략이 필요합니다. ECC는 프로세스·품질 게이트, Cursor Rules는 이 저장소 디렉터리 구조를 담당하게 하고, 서로 모순되는 금지 항목을 두 벌 두지 마세요.

Q4. Token을 더 많이 쓰나요?

전부 켜면 그렇습니다. minimal Hook, 필요한 Skills만, Longform Guide의 token 최적화 장을 활용하세요. 긴 문서는 시스템 프롬프트가 아니라 RAG·저장소 검색에 두는 편이 낫습니다.

Q5. OpenClaw 디지털 분신과 같은 종류인가요?

아닙니다. ECC는 IDE 코딩 Agent 강화, OpenClaw는 Gateway + Channels 7×24 개인 서비스입니다. OpenClaw 디지털 분신 글로 시나리오를 구분하세요.