ECC: 계획, 테스트, 리뷰, 기억 절차를 Claude Code와 Codex 등 코딩 에이전트에 설치하는 도구 (이전 Everything Claude Code)

핵심 요약

  • ECC는 PyTorchKR이 2026년 1월에 소개한 Everything Claude Code의 새 이름입니다. 1월 18일 커밋에는 에이전트 9개, 스킬 7개, 명령 9개가 있었습니다. 지금 main 브랜치에는 에이전트 72개, 스킬 327개, 명령 98개와 훅, 규칙, 메모리, 보안 스캐너가 있고, 이를 설치기로 배포합니다.
  • npx ecc-universal@2.2.3 setup 명령 한 줄로 Claude Code 플러그인을 설치하고, install --guided로 Codex와 Kimi Code까지 함께 설정합니다. main 기준으로 Codex와 Qoder는 네이티브 플러그인을 지원하고, Cursor와 OpenCode 등은 베타 또는 실험 단계의 어댑터이며 Claude Code와 같은 기능을 보장하지 않습니다.
  • 기본 훅 프로필(standard)에서 켜지는 GateGuard는 파일마다 첫 수정을 막고 사실 확인을 요구합니다. 프로젝트가 main의 개편된 GateGuard로 사전 등록해 실행한 확인 실험에서 효과는 통계적으로 확인되지 않았고(통과율 52% 대 38%, p = 0.210), 턴 수는 약 37%, 비용은 약 40% 늘었습니다.
  • 저장소의 스킬과 훅은 무료로 쓸 수 있고, ecc.tools의 GitHub App은 공개 저장소 분석이 무료, 비공개 저장소는 활성 개발자당 월 19달러입니다.
  • Claude Code 플러그인은 main 브랜치를 그대로 설치하고(버전 표기는 2.2.3), npm 패키지는 10월 1일의 2.2.3 스냅샷이라 두 경로의 내용이 다릅니다. main은 2.2.3보다 1,944커밋 앞서 있고, 한국어 README는 v1.8.0(2026년 3월) 내용에 머물러 있습니다.

ECC 소개

코딩 에이전트에게 계획 수립, 테스트 우선 작성, 리뷰 같은 작업 절차를 지키게 하려면 보통 매 프롬프트에 그 절차를 다시 적거나 설정 파일에 옮겨 적어야 합니다. 이 설정 파일은 도구마다 형식이 다릅니다. Claude Code는 CLAUDE.md와 .claude/ 폴더를, Codex는 AGENTS.md와 .codex/ 폴더를, Cursor는 .cursor/ 아래 규칙 파일을 읽습니다. 그래서 프롬프트로 요청한 절차는 긴 세션에서 잊히기 쉽고, 여러 코딩 에이전트를 함께 쓰면 같은 내용의 설정이 도구 수만큼 생깁니다. 이번에 소개하는 ECC는 이런 작업 절차를 스킬, 에이전트, 훅, 규칙으로 한 저장소에 모은 프로젝트입니다. ECC의 설치기는 이 파일들을 Claude Code, Codex, Kimi Code 같은 여러 코딩 에이전트 실행 환경(하네스, Harness)에 배포합니다.

ECC는 plan -> test -> implement -> review -> verify -> remember -> improve 순서의 작업 흐름을 기본으로 둡니다. 먼저 계획을 세우고 테스트로 변경을 검증합니다. 그다음 새 컨텍스트의 리뷰어가 결과를 다시 보고, 쓸 만한 패턴은 다음 세션에 남깁니다. 이 흐름을 구성 요소별로 나눈 이유는 컨텍스트 사용 방식이 다르기 때문입니다. 스킬은 작업에 필요할 때만 읽히고, 규칙은 항상 읽히며, 훅은 모델 컨텍스트 밖에서 스크립트로 실행됩니다. 저장소 루트가 유일한 원본이고, 하네스별 어댑터는 같은 파일을 각 도구의 형식으로 옮겨 설치합니다.

아래는 저장소 README 상단의 배너입니다. v2.0.0(2026년 6월) 시점의 배너라서 그림 속 스킬, 에이전트, 명령 개수는 현재보다 적습니다:

ECC는 Affaan Mustafa가 만든 프로젝트입니다. 저자는 2025년 9월 Anthropic x Forum Ventures 해커톤에서 우승한 뒤, 2026년 1월 18일에 자신의 Claude Code 설정을 everything-claude-code 저장소로 공개했습니다. PyTorchKR도 다음 날 Everything Claude Code 소개 글에서 이 저장소를 다뤘습니다. 이후 저장소 이름이 ECC로 바뀌었고(옛 주소는 새 주소로 리다이렉트됩니다), 2026년 6월 v2.0.0을 거쳐 10월 1일에 나온 2.2.3이 최신 릴리스입니다. 저자는 혼자 유지보수하면서 매주 배포한다고 밝힙니다. 다만 태그를 단 릴리스는 10월 1일의 2.2.3 이후 나오지 않았고, 그동안의 변경은 main 브랜치에 쌓이고 있습니다. 그 비용은 GitHub 후원과 ecc.tools의 유료 GitHub App 구독으로 충당합니다.

ECC vs. Everything Claude Code 초기 버전

PyTorchKR이 1월에 소개한 시점의 저장소와 현재 main 브랜치를 항목별로 비교하면 다음과 같습니다. Claude Code 플러그인으로 설치하면 받게 되는 것이 main입니다:

항목 Everything Claude Code (2026년 1월 18일 커밋) ECC (main 브랜치, 2026년 11월 17일 커밋)
대상 하네스 Claude Code Claude Code(기준), Codex와 Qoder 네이티브 플러그인, Cursor, OpenCode, Gemini CLI, GitHub Copilot 등의 어댑터
구성 규모 에이전트 9개, 스킬 7개, 명령 9개, 규칙 8개 에이전트 72개, 스킬 327개, 명령 98개, 언어별 규칙 묶음
저장소 파일 수 42개 4,878개
설치 방식 필요한 파일을 ~/.claude/에 직접 복사 npx ecc-universal 대화형 설치기, 설치 상태 기록과 doctor, repair, uninstall 명령
기본 MCP 서버 mcp-configs/mcp-servers.json 예시 설정 기본 연결은 chrome-devtools 1개, 이전 기본 6개를 포함한 나머지는 선택 항목
보안 검사 보안 리뷰 에이전트, 스킬, 규칙 (스캐너 없음) AgentShield 스캐너, 수정 전에 사실 확인을 요구하는 GateGuard 훅
상용 서비스 없음 ecc.tools GitHub App (Free, Pro, Enterprise 플랜)

초기 버전은 저자의 개인 설정을 독자가 골라 복사하는 형태였습니다. 지금의 ECC는 설치기가 자신이 쓴 파일을 설치 상태(install-state)에 기록하고, 제거할 때 그 기록에 있는 파일만 지웁니다. 같은 하네스에 설치 방식을 두 번 겹치지 말라는 경고도 README 곳곳에 있습니다. 예를 들어 Claude Code 플러그인을 설치한 뒤 수동 설치(./install.sh --profile full)를 다시 실행하면 스킬과 훅이 중복되어 훅이 두 번 실행됩니다. 기본 MCP 서버를 1개로 줄인 것은 2026년 6월 점검의 결과입니다. MCP 연결 정책 문서에 따르면 github, context7, exa, memory, playwright, sequential-thinking 여섯 개의 역할은 CLI나 REST API를 감싼 스킬과 하네스 자체 기능이 대신합니다.

이름도 세 가지로 갈라졌습니다. GitHub 저장소는 affaan-m/ECC, Claude Code 플러그인 식별자는 ecc@ecc, npm 패키지는 ecc-universal이며 서로 바꿔 쓸 수 없습니다. 설치 명령을 따라 할 때 이 세 이름을 구분해야 합니다.

ECC를 사용하면 좋을 사용자

ECC는 Claude Code를 주로 쓰는 개발자 중 계획, 테스트 우선 작성, 새 컨텍스트 리뷰 같은 절차를 직접 만들지 않고 바로 쓰려는 사람에게 맞습니다. Claude Code와 Codex를 함께 쓰는 팀이라면 같은 스킬을 두 하네스에 설치하고, 메모리 볼트로 한쪽 에이전트의 작업 메모를 다른 쪽에 넘기는 기능도 쓸 수 있습니다. 직접 만든 스킬이 이미 있는 사용자라면 전체를 설치하기보다 consult 명령으로 맞는 구성 요소를 추천받은 뒤 --skills나 --with 옵션으로 필요한 것만 설치할 수 있습니다.

컨텍스트 사용량에 민감한 사용자는 설치 범위를 먼저 정해야 합니다. 저자는 Claude Code 플러그인이 설치된 카탈로그 전체를 모델에 알린다고 밝히고, 컨텍스트 사용량이 중요하면 선택 설치나 minimal 프로필을 쓰라고 권장합니다. 스킬 품질도 고르지 않습니다. 저장소 이슈 #3783에 따르면 311개 스킬을 Anthropic의 스킬 작성 지침과 대조한 결과 34개가 권장 길이인 500줄을 넘었고, 이 이슈는 아직 열려 있습니다.

GateGuard 훅의 효과도 아직 확인되지 않았습니다. 기본 설정에서 이 훅이 파일마다 첫 수정을 막기 때문에 작업 턴과 토큰 비용이 늘어납니다. 그런데 프로젝트의 자체 실험에서도 통과율 향상은 통계적으로 확인되지 않았습니다(아래 GateGuard 절 참고). 버전 관리도 따져 봐야 합니다. Claude Code 플러그인은 릴리스 태그가 아니라 main 브랜치를 그대로 설치하는데, 2026년 10월 20일부터 26일 사이의 main에는 Windows 네이티브 환경에서 모든 훅이 실패하는 회귀 버그가 들어 있었습니다. 검토를 마친 고정 버전만 팀에 배포해야 하는 조직에게는 Claude Code 플러그인 경로의 ECC가 아직 적절한 선택지가 아닙니다. 이런 경우에는 버전을 고정한 npm 수동 설치로 2.2.3을 쓰거나, 검토한 커밋을 직접 클론해 설치해야 합니다.

ECC의 구성 요소와 컨텍스트 사용 방식

ECC는 구성 요소마다 맡는 일과 컨텍스트에 들어가는 방식을 나눠 두었습니다. 저장소가 설명하는 구분은 다음과 같습니다:

구성 요소 하는 일 컨텍스트 사용 방식
스킬(Skills) 테스트 주도 개발(TDD, Test-Driven Development), 보안 리뷰, 심층 조사 같은 재사용 가능한 작업 절차 작업에 필요할 때만 읽힘
에이전트(Agents) 자기 컨텍스트와 도구 권한을 가진 하위 작업자 계획, 구현, 리뷰를 서로 다른 컨텍스트로 분리
규칙(Rules) 프로젝트와 언어별 코딩 기준 항상 읽히므로 필요한 묶음만 설치
훅(Hooks) 하네스 이벤트(도구 실행 전후, 세션 시작과 종료)에 실행되는 스크립트 모델 컨텍스트 밖에서 실행
직관(Instincts) 실제 세션에서 추출한 패턴과 신뢰도 점수 세션 시작 시 신뢰도와 관련도 순으로 일부만 주입

스킬이 기본 작업 단위이고, 슬래시 명령은 스킬로 옮겨 가는 동안 유지하는 호환용 진입점입니다. /tdd 같은 예전 짧은 이름의 명령은 legacy-command-shims/ 폴더로 옮겨져 직접 복사해야 쓸 수 있습니다. 직관은 세션 기록에서 반복되는 패턴을 추출해 신뢰도 점수를 매긴 것으로, 기본값은 신뢰도 0.7 이상인 직관을 세션 시작 때 최대 6개까지 넣는 것입니다. 관련된 직관이 쌓이면 /evolve 명령으로 묶어 스킬로 만들 수 있습니다.

규칙은 Claude Code 플러그인으로 배포할 수 없어서 따로 복사해야 합니다. 저자는 언어 공통 규칙인 rules/common과 실제로 쓰는 언어 하나의 묶음만 먼저 설치하라고 권장합니다. 규칙은 매 세션 컨텍스트에 항상 들어가기 때문입니다.

ECC의 하네스별 지원 범위

ECC는 여러 하네스를 지원하지만 기능 수준은 하네스마다 다르고, 저장소는 각 상태를 마케팅 등급이 아니라 실제 기능 범위로 읽으라고 적어 두었습니다. main 브랜치 README 기준으로 주요 하네스의 지원 상태는 다음과 같습니다:

하네스 상태 주요 제약
Claude Code 기준 하네스 (안정) 플러그인이 설치된 카탈로그 전체를 모델에 알림. 일부 셸 기반 스킬은 OS에 따라 동작하지 않음
Codex 네이티브 플러그인 지원 훅은 사용자의 명시적 신뢰 승인이 필요하고 Claude Code의 훅 프로필을 쓰지 않음
Qoder 네이티브 플러그인 지원 (2.2.3 이후 추가) 검토를 거친 SessionStart 훅 하나만 켜짐. 클론한 저장소에서 설치
Antigravity 실험 단계 네이티브 플러그인 (2.2.3에서는 최소 어댑터) 인증된 환경에서의 도구 실행은 아직 검증되지 않음
Cursor 베타 프로젝트 어댑터 Cursor 빌드에 따라 에이전트 인식이 다르고, Claude Code와 같은 기능은 주장하지 않음
OpenCode 베타 플러그인 카탈로그의 일부만 제공
GitHub Copilot Chat 지시문만 제공 ECC 훅을 옮기지 않음
GitHub Copilot CLI 베타 프로젝트 어댑터 (2.2.3 이후 추가) 훅과 명령은 설치하지 않음
Gemini, Zed, Qwen, Hermes, OpenClaw, Kimi, Mistral Vibe, CodeBuddy, JoyCode 실험 단계의 최소 어댑터 파일 배치와 지시문 이식만 테스트됨

대화형 설치기(install --guided)가 한 번에 설정하는 하네스는 Claude Code, Codex, Kimi Code 세 가지입니다. Kimi Code는 프로젝트 폴더의 .kimi-code/ 아래에 지시문, 스킬, MCP 설정을 설치하고, 훅과 모델 제공자 설정은 건드리지 않습니다. 참고로 Kimi를 만든 Moonshot AI는 ECC의 후원사이고, README의 Kimi 가입 링크에는 제휴 코드(aff=ecc)가 포함되어 있습니다.

운영체제 지원도 같은 방식으로 적혀 있습니다. 핵심 Node.js CLI와 설치기는 Windows, macOS, Linux에서 동작하지만, 일부 지속 학습과 오케스트레이션 기능은 Bash나 Python이 필요합니다. 저자는 Windows 네이티브 환경에서 지속 학습 관찰 데몬과 메모리 볼트 쓰기에 아직 해결되지 않은 결함이 있다고 밝힙니다.

플러그인이 main을 그대로 설치하는 구조 때문에 생긴 사고도 있었습니다. 이슈 #3746에 따르면 10월 20일 main에 들어간 변경 이후 Claude Code가 Git Bash로 훅을 실행할 때 명령 안의 백슬래시가 사라져 모든 ECC 훅이 SyntaxError로 실패했습니다. 사용자 화면에는 SessionStart 오류만 보이고 나머지 훅은 조용히 실패했습니다. main에서는 10월 26일에 고쳐졌으므로, 그 기간에 Windows에서 플러그인을 설치했다면 플러그인을 갱신해야 합니다. npm의 2.2.3 패키지에는 이 문제가 없습니다.

ECC의 GateGuard 훅과 프로젝트 자체 검증 결과

GateGuard는 에이전트가 파일을 고치기 전에 조사를 먼저 하게 만드는 훅입니다. 에이전트가 어떤 파일을 처음 수정하려고 하면 GateGuard가 그 시도를 막습니다. 그리고 그 모듈을 import하는 파일 목록, 데이터 스키마, 사용자의 원래 지시 같은 구체적인 사실을 먼저 제시하라고 요구합니다. 에이전트가 사실을 제시하면 같은 수정을 다시 허용합니다. rm -rf, 강제 git checkout 같은 파괴적인 셸 명령도 실행 전에 확인을 거칩니다. 이 훅은 기본 프로필인 standard와 strict에서 켜지므로, 별도 설정 없이 설치하면 GateGuard가 동작합니다.

GateGuard 스킬 문서는 두 개 과제의 A/B 테스트에서 평균 2.25점(10점 만점) 품질이 올랐다고 소개합니다. 이후 프로젝트는 main에서 질문을 대상별로 고르도록 개편한 GateGuard로 효과를 다시 측정했습니다. 실험 설계와 집계 결과는 main 브랜치의 효과 측정 문서에 있습니다(실행별 원자료와 대화 기록은 저장소에 없습니다). 측정 과정은 다음과 같습니다:

  1. 첫 시험 실행(6개 과제, 4개 조건, 72개 세션)에서는 모든 조건이 모든 과제를 통과해 효과를 측정할 수 없었습니다. 이 실행에서 측정된 것은 비용뿐으로, GateGuard를 켜면 턴이 약 45%, 토큰이 약 28% 늘었습니다.
  2. 결정에 필요한 사실을 저장소가 아니라 가상 사용자의 숨은 의도에 두도록 과제를 다시 만들었습니다. 질문을 유도하는 문구를 넣은 프롬프트에서는 통과 수가 GateGuard 쪽 15/24, 끈 쪽 16/24로 차이가 없었습니다. 그 문구를 뺀 탐색 실행에서는 63% 대 33%로 차이가 났지만 p = 0.065로 통상 기준(0.05)을 넘지 못했습니다.
  3. 표본 수를 미리 정한 확인 실행(96회)에서 통과율은 GateGuard 쪽 52%(48회 중 25회), 끈 쪽 38%(48회 중 18회)였고 p = 0.210이었습니다. 프로젝트는 이 결과를 가설이 확인되지 않은 것으로 보고했습니다.
  4. 외부 계약을 묻는 질문을 추가한 탐색 실행에서는 p = 0.021이 나왔지만, 문서는 GateGuard 쪽이 오른 것이 아니라 끈 쪽 통과율이 떨어져 생긴 차이라며 효과의 근거로 보지 않았습니다. 문서의 종합 결론은 유료 실행 336회 전체에서 GateGuard의 이점이 입증되지 않았다는 것입니다.

반면 비용은 모든 실행에서 늘었습니다(턴 37~50%, 비용 40~61%). 확인 실행에서 GateGuard를 켠 쪽은 과제당 평균 8.2턴, 0.151달러를 썼고, 끈 쪽은 6.0턴, 0.108달러를 썼습니다. 턴은 약 37%, 비용은 약 40% 늘어난 셈입니다. 문서는 현재 추정치(15%p 차이)를 확인하려면 약 177쌍의 실험이 필요하다고 덧붙였습니다. 정리하면 GateGuard가 성공률을 높인다는 근거는 아직 약하고, 비용이 늘어난다는 근거는 일관됩니다.

GateGuard를 끄거나 범위를 좁히려면 다음 환경 변수를 씁니다:

# GateGuard 전체 끄기
export ECC_GATEGUARD=off

# 수정(Edit/Write) 게이트만 끄기
export ECC_DISABLED_HOOKS="pre:edit-write:gateguard-fact-force"

# 훅 프로필을 minimal로 바꾸기 (GateGuard 포함 여러 검사가 빠짐)
export ECC_HOOK_PROFILE=minimal

ECC의 Plan Canvas와 메모리 볼트

2.1.0에서 추가된 Plan Canvas는 에이전트가 만든 계획 문서를 브라우저에서 검토하는 도구입니다. Plan Canvas를 쓰지 않으면 /ecc:plan 명령은 터미널에 계획을 출력하고 사용자의 확인을 기다립니다. Plan Canvas를 쓰면 계획의 특정 부분에 주석을 달아 수정을 요청하고, 고친 계획을 같은 화면에서 승인할 수 있습니다. 아래는 저장소가 공개한 Plan Canvas 시연 화면입니다:

ECC Plan Canvas에서 계획 문서에 주석을 달고 승인하는 시연 화면

메모리 볼트(Memory Vault)는 하네스 사이에서 작업 메모를 넘기는 기능입니다. 각 하네스의 대화 기록을 복사하는 대신 ecc.memory.v1 형식의 마크다운 문서를 프로젝트의 .ecc/memory/ 폴더나 사용자의 ~/.ecc/memory/ 폴더에 저장합니다. 예를 들어 Codex에서 하던 작업의 인계 메모를 저장해 두면 Claude Code 세션에서 검색해 읽을 수 있습니다. 저자는 볼트에서 불러온 메모를 검토되지 않은 컨텍스트로 다루고, 실행할 지시나 정책으로 취급하지 말라고 명시합니다. Claude Code 플러그인 설치만으로는 ecc CLI가 설치되지 않으므로, 메모리 볼트를 쓰려면 npm 패키지를 따로 설치해야 합니다:

npm install -g ecc-universal@2.2.3
ecc memory init --scope project
ecc memory handoff --from codex --target claude --title "Continue the rollout" --body-file handoff.md
ecc memory search "rollout" --target-harness claude

같은 기능을 MCP로 쓰고 싶으면 ecc-memory-mcp 서버를 하네스마다 직접 등록합니다. 이 서버는 저장, 검색, 읽기, 점검 네 가지 도구만 제공하고 기본으로 켜지지 않습니다. 이 밖에 세션과 Git 워크트리 상태를 로컬 브라우저에서 보여 주는 Control Pane도 있습니다. 다만 ecc.tools에 실린 Control Pane 화면은 시연용 데이터로 만든 캡처입니다.

ECC의 AgentShield 보안 검사

AgentShield는 에이전트 설정 자체를 공격 표면으로 보고 검사하는 스캐너로, 2026년 2월 Cerebral Valley x Anthropic Claude Code 해커톤에서 만들어졌습니다. AgentShield는 CLAUDE.md, settings.json, MCP 설정, 훅, 에이전트 정의, 스킬을 읽습니다. 검사 대상은 비밀 정보 노출, 권한 설정, 훅 인젝션, MCP 서버 위험도, 에이전트 설정 등입니다. AgentShield 저장소는 현재 15개 모듈에 걸친 268개 규칙을 갖췄다고 밝힙니다(ECC README에는 해커톤 당시의 102개로 남아 있습니다). 결과는 터미널(A~F 등급), JSON, 마크다운, HTML로 출력되고, 심각한 문제가 있으면 종료 코드 2를 돌려주어 CI에서 빌드를 멈출 수 있습니다. 사용 예시는 다음과 같습니다:

# 현재 프로젝트 폴더만 검사
agentshield scan --path .

# 안전하게 고칠 수 있는 문제 자동 수정
agentshield scan --path . --fix

# Claude Opus 에이전트 3개로 공격, 방어, 감사 역할을 나눠 분석
agentshield scan --path . --opus --stream

--opus 옵션은 공격자 에이전트가 악용 경로를 찾고, 방어자 에이전트가 보호 장치를 평가하고, 감사자 에이전트가 둘을 종합해 위험 순위를 매기는 방식입니다. AgentShield README에 따르면 기본 모델은 claude-opus-5이고, 실행하려면 ANTHROPIC_API_KEY가 있어야 합니다.

AgentShield의 실행 방법은 문서마다 다르게 안내합니다. ECC README는 검토한 버전을 미리 설치한 agentshield 바이너리를 쓰고, 버전을 지정하지 않은 일회성 다운로드로 대신하지 말라고 합니다. 반면 ecc.tools의 보안 페이지와 AgentShield README는 npx ecc-agentshield scan을 바로 실행하는 방법을 안내합니다. ECC README는 검토된 고정 버전을 따로 제시하지 않으므로, 버전을 고정하려면 사용자가 npm 패키지 ecc-agentshield의 버전을 직접 골라 설치해야 합니다. ecc.tools도 AgentShield의 검사 결과는 검토를 돕는 자료일 뿐 저장소나 에이전트가 안전하다는 보증이 아니라고 밝히고 있습니다. MCP 서버나 스킬만 따로 검사하려면 MCP-Scan이나 SkillSpector 같은 도구도 있습니다.

ECC를 설치할 때는 출처도 확인해야 합니다. 저자는 공식 배포 경로를 GitHub 저장소, npm 패키지 ecc-universal과 ecc-agentshield, GitHub App, 플러그인 식별자 ecc@ecc, ecc.tools로 한정합니다. 제3자가 다시 올린 사본과 비공식 미러에는 악성 코드가 들어 있을 수 있다는 경고도 README 맨 위에 있습니다.

ECC 오픈소스와 ecc.tools GitHub App의 범위

ecc.tools의 GitHub App은 연결한 저장소의 커밋 기록을 분석해 그 팀의 작업 방식을 담은 SKILL.md 파일을 PR로 만들어 주는 호스팅 서비스입니다. 이슈에 /ecc-tools analyze 댓글을 달면 분석이 시작됩니다. 플랜은 이 App에 적용되고, 저장소의 스킬, 에이전트, 훅, 메모리 기능은 플랜과 관계없이 무료입니다. 플랜별 차이는 다음과 같습니다:

항목 Free Pro Enterprise
가격 무료 활성 개발자당 월 19달러 (연 190달러) 별도 협의
분석 대상 공개 저장소 공개와 비공개 저장소 공개와 비공개 저장소
월 분석 횟수 10회 활성 개발자당 50회 (설치 단위로 합산) 제한 없음
분석당 커밋 수 200개 1,000개 5,000개
PR 기반 설정 감사, 자동 실행 없음 있음 있음
AgentShield 기반 검사 없음 있음 있음
보안, 리서치 설치 프로필과 doctor, repair, uninstall 없음 있음 있음
지원 커뮤니티 이메일과 Discord 우선 지원 우선 지원과 서비스 수준 계약(SLA)

표의 doctor, repair, uninstall 행은 App 쪽 기능을 가리키는 것으로 보입니다. 오픈소스 CLI에도 같은 이름의 명령이 있고 무료로 쓸 수 있습니다. ecc.tools는 분석 중에 커밋 기록과 일부 파일 내용을 메모리에서만 처리하고 코드를 영구 저장하지 않는다고 밝힙니다. 비공개 저장소를 연결하기 전에는 GitHub App이 요청하는 권한을 직접 확인해야 하며, ecc.tools도 설치 전에 권한을 검토하라고 안내합니다.

ECC 설치와 사용

ECC를 Claude Code에 설치하려면 Node.js 18 이상, Git, Claude Code 2.1 이상이 PATH에 있어야 합니다. 대화형 설치기를 쓰는 경우 저장소를 클론할 필요는 없습니다. 이 설치기는 npm의 2.2.3 패키지로 실행되지만, 실제로 설치하는 Claude Code 플러그인은 GitHub main 브랜치의 내용입니다. 설치 순서는 다음과 같습니다:

  1. 터미널에서 세 도구의 버전을 확인합니다.
  2. 대화형 설치기를 실행하고, 설치 범위(user, project, local)와 훅 프로필을 고릅니다. 개인용이면 전역 사용자 범위와 standard 훅이 README의 기본 예시입니다.
  3. Claude Code 세션을 새로 열고 /plugin list로 ecc@ecc가 켜져 있는지 확인합니다.

1단계와 2단계의 명령은 다음과 같습니다:

node --version
git --version
claude --version

npx ecc-universal@2.2.3 setup

Claude Code 안에서 플러그인 명령으로 설치할 수도 있습니다. 이 방법을 썼다면 수동 설치를 다시 하지 않습니다:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Claude Code, Codex, Kimi Code를 함께 설정하려면 여러 하네스용 설치기를 씁니다. 이 설치기는 선택한 하네스마다 설치 위치를 보여 주고, 파일을 쓰기 전에 모든 항목을 점검한 뒤 마지막에 한 번 확인을 받습니다:

npx ecc-universal@2.2.3 install --guided

# 파일을 쓰지 않고 Codex 설치 계획만 확인
npx ecc-universal@2.2.3 install --guided --harness codex --dry-run

Codex에서는 Codex 자체의 플러그인 명령으로도 설치할 수 있습니다:

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc

플러그인을 썼다면 규칙은 따로 복사해야 합니다. 규칙은 플러그인으로 배포되지 않으므로, 저장소를 클론한 뒤 필요한 규칙 묶음만 복사합니다:

# 플러그인 사용자: 규칙 복사 (공통 규칙 + 사용하는 언어 하나)
git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/

플러그인 대신 훅 없이 규칙, 에이전트, 명령과 핵심 스킬만 쓰려면 minimal 프로필로 수동 설치합니다. 이 방법은 규칙까지 함께 설치하므로, 위의 플러그인 설치와 함께 쓰지 않습니다:

# 플러그인을 쓰지 않는 사용자: 훅 없는 최소 수동 설치 (npm 2.2.3 기준)
npx ecc-universal@2.2.3 install --profile minimal --target claude

설치 후에는 하려는 작업에 맞는 진입점부터 쓰면 됩니다. 저자가 README에서 안내하는 작업별 시작점은 다음과 같습니다:

하려는 작업 시작점
기능 개발 /ecc:plan "기능 설명" 다음에 tdd-workflow 스킬
버그 수정 실패하는 테스트로 재현한 뒤 tdd-workflow 스킬
방금 쓴 코드 리뷰 /code-review (새 컨텍스트의 리뷰어)
빌드 오류 수정 /build-fix
컨텍스트 사용량 점검 context-budget 스킬
긴 세션 정리와 재개 /save-session, /resume-session
에이전트 설정 보안 점검 /security-scan 또는 agentshield scan --path .

플러그인으로 설치했다면 명령은 /ecc:plan처럼 ecc: 접두사를 붙여 호출합니다. 짧은 이름은 수동 설치에서만 쓸 수 있습니다.

설치 상태를 점검하거나 제거할 때는 설치에 쓴 프로젝트 폴더에서 다음 명령을 실행합니다. 제거 명령은 ECC가 설치 상태에 기록한 파일만 지웁니다. 플러그인으로 설치했다면 Claude Code에서 플러그인을 먼저 제거해야 합니다:

npx ecc-universal@2.2.3 list-installed
npx ecc-universal@2.2.3 doctor
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstall

한국어 문서를 찾는 독자는 저장소의 한국어 README를 볼 수 있지만, 이 문서는 v1.8.0(2026년 3월) 기준으로 에이전트 16개, 스킬 65개, 명령 40개를 안내합니다. 대화형 설치기와 하네스별 지원 범위 같은 최신 내용은 영어 README를 기준으로 확인해야 합니다.

ECC의 라이선스

ECC는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

:house: ECC 홈페이지 (GitHub App 유료 플랜 안내 포함)

:github: ECC 프로젝트 GitHub 저장소

:github: AgentShield GitHub 저장소

더 읽어보기




이 글은 GPT 모델로 정리한 초안을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 댓글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. :smiley:

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: