ECC 설치법: 클로드 코드에 스킬 311개, 깔기 전 주의할 점

ecc.tools 공식 사이트 그림 위에 'ECC, 클로드 코드에 스킬 311개 한 번에' 제목

깃허브 오늘의 급상승 목록을 보다가 숫자에서 한 번 멈췄어요. 별 28만 2천 개. 하루에만 1,145개가 더 붙었더라고요. 저장소 이름은 ECC, 클로드 코드에 에이전트 71개와 스킬 311개를 한 번에 얹어 주는 오픈소스입니다.

이런 “한 방에 다 깔아 주는” 묶음은 편한 만큼 조심할 것도 많아요. 제작자도 README 맨 위에 경고문을 따로 달아 놨고요. 그래서 무엇이 들어 있는지, 어떻게 까는지, 깔기 전에 뭘 확인해야 하는지 순서대로 짚어 봤습니다.

ECC 깃허브 저장소 affaan-m/ECC 첫 화면
별 약 28만 3천 개, 포크 4만 2천 개 (10월 18일) · 출처: ECC 깃허브

ECC가 뭐길래 별이 28만 개?

ECC는 Affaan Mustafa(affaan-m)라는 개발자가 2026년 1월에 올린 저장소예요. README 첫 줄 설명은 “에이전트 하네스(AI 코딩 도구가 일하는 틀) 운영 체계”입니다. 말이 어렵지만 뜻은 단순해요. 클로드 코드가 코드를 바로 짜기 전에 계획부터 세우고, 테스트로 확인하고, 다른 눈으로 다시 검토하고, 배운 걸 기억하게 만드는 규칙과 도구를 미리 깔아 두자는 거예요.

README에 적힌 흐름도 딱 한 줄입니다. plan → test → implement → review → verify → remember → improve. 매번 프롬프트로 “테스트 먼저 써 줘”라고 부탁하는 대신, 그 습관 자체를 설치해 버리자는 발상이죠.

ECC 공식 사이트 ecc.tools 첫 화면
공식 사이트 첫 화면 — 지원 도구와 설치 수 · 출처: ecc.tools

라이선스는 MIT라 무료이고, 가장 잘 맞는 건 클로드 코드라고 README에 명시돼 있어요. 코덱스와 큐더(Qoder)는 전용 플러그인이 있고, 커서·오픈코드·제미나이·깃허브 코파일럿 같은 도구는 “기능이 제한된 어댑터”로 지원합니다. 참고로 Anthropic이 만든 공식 제품이 아니라 개인이 운영하는 프로젝트예요. Anthropic 공식 플러그인이 궁금하다면 지난번에 쓴 클로드 코드 공식 플러그인 모음 글을 먼저 보시는 게 낫습니다.

ECC 기본 정보 요약표
ECC 한눈에 · 출처: ECC 깃허브

안에 든 것: 에이전트 71 · 스킬 311 · 명령 97

README 구성표를 보면 크게 여섯 덩어리예요. 에이전트(계획·코드 리뷰·빌드 수리·보안 같은 일을 맡는 보조 AI), 스킬(TDD·리서치·문서·프론트엔드·데이터 등 필요할 때 불러 쓰는 작업 설명서), 명령(슬래시로 부르는 바로가기), 훅(특정 시점에 자동으로 도는 스크립트)과 메모리, 언어별 규칙, 그리고 AgentShield라는 보안 검사기입니다.

ECC README 구성표 에이전트 71개 스킬 311개 명령 97개
README 구성표: 에이전트·스킬·명령·훅·규칙·AgentShield · 출처: ECC 깃허브

숫자가 너무 커서 정말인지 궁금했어요. 그래서 이 블로그를 돌리는 라즈베리파이에서 저장소만 받아(git clone --depth 1) 폴더 수를 세어 봤습니다. agents 71개, skills 311개, commands 97개로 README와 똑같았어요. 설치나 실행은 하지 않았고, 파일 개수만 확인한 거예요. 저장소 전체 크기는 110MB 정도였습니다.

라즈베리파이에서 ECC 저장소 폴더 수를 센 터미널 화면
저장소만 받아 세어 보니 71·311·97 그대로 · 출처: 부컴 라즈베리파이 직접 실행

하나 덧붙이면, README 맨 위 대표 그림에는 스킬 261·에이전트 64·명령 84라고 적혀 있어요. 6월 v2.0 때 숫자가 그대로 남은 거라 지금 수치와는 다릅니다. 블로그나 영상에서 이 그림을 보고 숫자를 옮긴 글은 예전 기준이라고 보면 돼요.

설치 전에 이 경고부터

README 맨 위, 설치 방법보다 먼저 나오는 게 “공식 경로에서만 설치하라”는 경고예요. 공식으로 인정하는 경로는 다섯 곳뿐입니다.

  • 깃허브 저장소 github.com/affaan-m/ECC
  • npm 패키지 ecc-universal, ecc-agentshield
  • 깃허브 앱 ECC Tools
  • 클로드 코드 플러그인 이름 ecc@ecc
  • 공식 사이트 ecc.tools
ECC README 공식 경로에서만 설치하라는 경고
비공식 재업로드·미러는 악성코드 위험 · 출처: ECC 깃허브

이 밖의 재업로드나 미러는 프로젝트가 관리하지 않으며 악성코드가 들어 있을 수 있다고 분명히 적혀 있어요. 별이 수십만 개 붙은 저장소는 이름만 비슷하게 베낀 가짜가 꼭 생깁니다. 훅은 내 컴퓨터에서 셸 명령을 실행할 수 있고, MCP 서버는 API 키 같은 비밀값을 쥘 수 있으니 가짜를 깔면 피해가 바로 와요. README 보안 항목도 “훅·MCP·프로젝트 지침은 실행 가능한 설정으로 취급하라”고 강조합니다.

그리고 npx ecc-install처럼 비슷한 이름을 치지 말라는 안내도 있어요. ecc-install은 ecc-universal 안의 실행 파일 이름일 뿐, 따로 올라간 npm 패키지가 아니라고 합니다. 이름 한 글자 차이로 엉뚱한 패키지를 받는 일이 실제로 흔하니 복사해서 붙이는 게 안전해요.

설치는 두 가지 중 하나만

필요한 건 Node.js 18 이상, Git, 클로드 코드 2.1 이상이에요. 권장 방법은 안내형 설치 마법사입니다.

npx [email protected] setup

윈도우라면 README에 초보자용 순서가 따로 있어요. PowerShell을 열고 node --version, git --version, claude --version으로 세 가지가 깔려 있는지 확인한 뒤 위 명령을 실행합니다. 개인용이면 Global user, 훅은 Standard를 고르라고 권하고, 끝나면 클로드 코드를 새로 열어 /plugin list에서 ecc@ecc가 켜졌는지 보면 돼요.

ECC 권장 설치 방법과 윈도우 첫 설치 순서
npx [email protected] setup 과 윈도우 따라 하기 · 출처: ECC 깃허브

두 번째 방법은 클로드 코드 안에서 플러그인 명령 두 줄로 까는 거예요. 결과는 마법사와 같은 ecc@ecc 플러그인입니다.

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
클로드 코드 안에서 ECC 플러그인 설치 명령
/plugin marketplace add → /plugin install ecc@ecc · 출처: ECC 깃허브

여기서 중요한 건 방법을 겹쳐 쓰지 않는 것이에요. 플러그인으로 깔고 나서 ./install.sh --profile full 같은 수동 설치를 또 하면 스킬·명령·훅이 두 번 들어가 같은 훅이 두 번 돈다고 합니다. 이미 겹쳐 깔았다면 플러그인 제거 → npx [email protected] uninstall → 직접 복사한 규칙 폴더 정리 → 한 가지 방법으로 다시 설치, 순서로 정리하라고 README에 나와 있어요. 지울 때는 ECC가 설치 기록에 남긴 파일만 지운다고 하니 다른 설정이 날아갈 걱정은 덜어도 될 것 같습니다.

규칙(rules)은 플러그인으로 배포가 안 돼서 원하는 언어 것만 직접 복사해야 해요. README는 공통 규칙 하나와 실제로 쓰는 언어 하나만 먼저 넣으라고 권합니다.

깔고 나서는 뭐부터 쓰나

311개를 다 외울 필요는 없어요. README도 “전체 목록 말고 지금 필요한 작업부터 시작하라”며 표를 하나 줍니다. 새 기능을 만들 땐 /ecc:plan "만들 기능 설명"으로 계획을 세우고 tdd-workflow 스킬로 테스트부터 쓰고, 코드를 다 짰으면 /code-review, 빌드가 깨지면 /build-fix, 긴 작업을 끝낼 땐 /save-session, 다음 날 이어서 할 땐 /resume-session을 쓰는 식이에요.

ECC 작업별 시작 명령 표
하고 싶은 일별로 어디서 시작하는지 · 출처: ECC 깃허브

토큰 비용 이야기도 꽤 길게 들어 있어요. 기본 모델을 소네트로, 보조 에이전트는 하이쿠로 돌리고, 대화 압축을 50%에서 일찍 하라는 설정을 권합니다. MCP 서버를 한꺼번에 다 켜면 도구 설명만으로 컨텍스트(AI가 한 번에 기억하는 분량) 20만 토큰이 7만 정도까지 줄어들 수 있으니 프로젝트당 10개 아래로 쓰라는 조언도 있고요. 클로드 코드를 구독제로 쓰는 분이 많을 텐데, 스킬 묶음이 커질수록 이 부분은 꼭 챙겨 봐야 합니다.

윈도우는 제한이 있고, 유료는 깃허브 앱만

운영체제 지원표를 보면 리눅스·맥·윈도우 WSL은 “핵심 지원”이고, 윈도우에서 바로 쓰는 경우는 “제한 있는 지원”이에요. 지속 학습 기능의 감시 프로그램과 메모리 저장에 윈도우 전용 버그가 아직 열려 있고, 셸 스크립트가 필요한 일부 기능은 Git Bash나 WSL이 없으면 못 쓴다고 적혀 있습니다. 윈도우 PC에서 바로 쓰려는 분이라면 이 부분을 먼저 확인하세요.

ECC 운영체제별 지원 상태 표
윈도우 직접 실행은 일부 기능 제한 · 출처: ECC 깃허브

돈 내야 하냐는 질문도 나올 텐데, 오픈소스 자체는 계속 무료라고 README와 공식 사이트 둘 다 밝히고 있어요. 유료는 깃허브에 붙이는 ECC Tools 앱입니다. 공개 저장소는 무료(월 10회 분석), 비공개 저장소 분석과 PR 자동 검사는 Pro 요금제로 개발자 1명당 월 19달러예요.

ECC 깃허브 앱 가격표 Free Pro Enterprise
오픈소스는 무료, 비공개 저장소 분석만 Pro 월 19달러 · 출처: ecc.tools 가격

함께 들어 있는 AgentShield는 내 에이전트 설정 자체를 검사하는 도구예요. 비밀값 노출, 지나치게 넓은 권한, 위험한 훅이나 MCP 설정을 찾아 줍니다. 위험한 삭제 명령을 실행 전에 막는 GateGuard라는 장치도 들어 있다고 하고요.

ECC AgentShield 보안 검사 소개 화면
에이전트 설정을 검사하는 AgentShield · 출처: ecc.tools 보안

제 생각엔 ECC는 “클로드 코드를 매일 몇 시간씩 쓰는데 매번 같은 부탁을 반복하는 게 지겨운 사람”에게 맞는 도구예요. 클로드 코드를 이제 막 시작했다면 311개짜리 묶음보다 공식 플러그인 몇 개로 감부터 잡는 게 덜 헷갈릴 거고요. 저는 다음에 격리된 폴더에서 최소 설치(--profile minimal, 훅 없이)부터 직접 깔아 보고, 실제로 뭐가 달라지는지 후기로 정리해 볼 생각입니다. 여러분은 이런 대형 스킬 묶음, 통째로 까는 편인가요 아니면 필요한 것만 골라 쓰는 편인가요? 클로드 코드 관련 다른 글은 클로드 코드 모음에서 볼 수 있어요.


출처
· ECC 깃허브 저장소 README (affaan-m/ECC)
· ECC v2.2.3 릴리스 노트
· ECC 공식 사이트 ecc.tools
· ECC Tools 깃허브 앱 가격
(2026년 10월 18일 확인)

컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.

함께 보면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다