ECC(Everything Claude Code) 설치 및 사용법: Claude Code 실전 가이드

Claude Code를 쓰다 보면 비슷한 지시를 반복하게 됩니다.

“먼저 계획을 세워줘.”
“테스트부터 작성해줘.”
“코드를 수정한 뒤 리뷰해줘.”
“보안 문제도 확인해줘.”

프로젝트가 바뀔 때마다 이 과정을 다시 설명하는 것도 번거롭습니다. **ECC(Everything Claude Code)**는 이런 반복 작업을 스킬, 에이전트, 훅, 규칙으로 묶어둔 오픈소스 도구 모음입니다.

쉽게 말하면 Claude Code에 계획 담당자, 테스트 담당자, 코드 리뷰어, 보안 담당자를 추가하는 것과 비슷합니다.

하지만 처음부터 모든 기능을 넣는 것이 항상 좋은 선택은 아닙니다. 플러그인과 수동 설치를 겹치면 기능이 중복될 수도 있습니다. 이 글에서는 가장 쉬운 설치법부터 가볍게 시작하는 방법, 설치 후 바로 사용할 프롬프트까지 차례대로 알아봅니다.

ECC 설치 방법, 먼저 짧게 답하면

ECC를 가장 쉽게 설치하려면 Claude Code에서 공식 ECC 마켓플레이스를 추가한 뒤 ecc@ecc 플러그인을 설치하면 됩니다. 컨텍스트와 훅을 가볍게 관리하고 싶다면 플러그인 대신 minimal 프로필을 선택하세요.

ECC란 무엇인가요?

Claude Code는 기본 상태에서도 코드를 읽고 수정하고 테스트할 수 있습니다. 하지만 실제 개발은 코드 생성만으로 끝나지 않습니다.

구현하기 전에 요구사항을 정리해야 합니다. 기존 기능에 미치는 영향도 확인해야 합니다. 테스트를 작성하고, 예외 상황과 보안 문제를 검토하고, 작업이 끝나면 변경된 코드를 다시 리뷰해야 합니다.

ECC는 이 과정을 매번 긴 프롬프트로 설명하지 않아도 일정한 작업 방식으로 실행할 수 있게 도와줍니다.

• 스킬은 계획, 테스트, 리팩터링처럼 정해진 절차로 작업하게 합니다.
• 에이전트는 코드 리뷰나 보안 감사처럼 특정 역할을 담당합니다.
• 훅은 파일 수정이나 명령 실행 전후에 검증 작업을 연결합니다.
• 규칙은 프로젝트에서 지켜야 할 코딩 원칙을 Claude Code에 전달합니다.
• MCP 설정은 필요한 외부 도구와 데이터를 연결합니다.

ECC의 핵심 저장소는 MIT 라이선스로 공개돼 있습니다. ECC Pro 같은 별도 유료 서비스가 있지만, 오픈소스 저장소와는 구분해야 합니다.

이런 분에게 추천합니다

• Claude Code에 비슷한 개발 지시를 반복하고 있습니다.
• 계획 없이 구현부터 시작해 나중에 문제를 자주 발견합니다.
• 테스트나 코드 리뷰를 빠뜨리는 일이 많습니다.
• 여러 프로젝트에서 비슷한 개발 방식을 유지하고 싶습니다.
• AI가 작성한 코드를 더 체계적으로 검증하고 싶습니다.

Claude Code를 간단한 코드 질문에만 가끔 사용한다면 전체 기능은 필요하지 않을 수 있습니다. 이 경우에는 minimal 프로필이나 필요한 기능만 선택하는 편이 낫습니다.

설치 전 준비하기

먼저 터미널에서 Claude Code가 정상적으로 설치돼 있는지 확인합니다.

claude --version
claude doctor

Claude Code가 없다면 macOS, Linux, WSL에서 다음 명령어로 설치할 수 있습니다.

curl -fsSL https://claude.ai/install.sh | bash

Homebrew를 사용한다면 다음 명령어를 사용할 수도 있습니다.

brew install --cask claude-code

설치가 끝나면 작업할 프로젝트 폴더로 이동해 Claude Code를 실행합니다.

cd /path/to/your/project
claude

처음 여는 프로젝트라면 Claude Code 안에서 다음 명령어를 실행해 프로젝트 지침 초안을 만들 수 있습니다.

/init

생성된 지침은 그대로 믿기보다 실제 프로젝트 규칙과 맞는지 검토한 뒤 사용하세요.

Node.js와 Git은 언제 필요한가요?

플러그인 설치만 사용할 때 Node.js가 반드시 필요한 것은 아닙니다. 하지만 아래 작업에는 Node.js와 npm이 필요합니다.

• npx ecc consult로 필요한 구성 요소를 찾을 때
• npx ecc-agentshield scan으로 보안 검사를 실행할 때
• Node 기반 훅이나 수동 설치 도구를 사용할 때

수동 설치에서는 ECC 저장소를 내려받기 위한 Git도 필요합니다.

git --version
node --version
npm --version

플러그인만 먼저 체험한다면 Node.js 관련 기능은 나중에 추가해도 됩니다.

ECC 설치 방법은 하나만 선택하세요

ECC 설치 방식은 크게 두 가지입니다.

1. Claude Code 플러그인으로 한 번에 설치합니다.
2. 필요한 구성만 선택해 수동으로 설치합니다.

처음 사용하는 사람이라면 플러그인 설치가 가장 간단합니다. 컨텍스트 비용을 줄이고 싶거나 세부 구성을 직접 선택하고 싶다면 minimal 설치가 적합합니다.

방법 1. 플러그인으로 빠르게 설치하기

프로젝트 폴더에서 Claude Code를 실행한 뒤 아래 명령어를 Claude Code 세션 안에서 순서대로 입력합니다.

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

설치 목록에 ecc@ecc가 표시되고 활성화돼 있다면 기본 설치가 끝난 것입니다.

설치 직후 확인할 프롬프트

현재 설치된 ECC 플러그인에서 사용할 수 있는 기능을 확인해줘.

다음 기준으로 정리해줘.
1. 구현 계획에 사용할 기능
2. 테스트 주도 개발에 사용할 기능
3. 코드 리뷰에 사용할 기능
4. 보안 검사에 사용할 기능
5. 컨텍스트와 메모리 관리에 사용할 기능

실제로 설치된 명령어나 스킬 이름만 보여줘.
현재 환경에서 확인되지 않은 이름은 추측하지 마.

플러그인 설치 후 규칙은 따로 확인하세요

현재 ECC 공식 안내에 따르면 Claude Code 플러그인은 ECC의 rules 폴더를 자동으로 배포하지 않습니다. 필요한 경우 공통 규칙과 실제 사용하는 언어 규칙만 따로 복사합니다.

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/

Python 프로젝트라면 다음 규칙을 선택합니다.

cp -R rules/python ~/.claude/rules/ecc/

Go 프로젝트라면 다음과 같이 복사합니다.

cp -R rules/golang ~/.claude/rules/ecc/

모든 언어 규칙을 한꺼번에 추가하지 마세요. 사용하지 않는 규칙도 컨텍스트를 차지하고 서로 다른 지침이 판단을 방해할 수 있습니다. 처음에는 공통 규칙과 현재 사용하는 언어 규칙 하나면 충분합니다.

방법 2. minimal 프로필로 가볍게 설치하기

전체 플러그인이 부담스럽다면 수동 설치만 선택할 수 있습니다.

git clone https://github.com/affaan-m/ECC.git
cd ECC

바로 설치하지 말고 --dry-run으로 설치 계획을 먼저 확인합니다.

./install.sh --profile minimal --target claude --dry-run

설치 대상이 맞다면 실제 설치를 진행합니다.

./install.sh --profile minimal --target claude

Windows PowerShell에서는 다음 명령어를 사용합니다.

git clone https://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1 --profile minimal --target claude --dry-run
.\install.ps1 --profile minimal --target claude

이 방식을 선택했다면 ecc@ecc 플러그인을 추가로 설치하지 마세요.

필요한 ECC 기능만 찾는 방법

ECC의 상담 명령을 이용하면 목적에 맞는 구성 요소와 설치 방법을 찾을 수 있습니다. 이 명령은 Node.js와 npm이 설치된 환경에서 실행하세요.

npx ecc consult "security reviews" --target claude

TDD 기능을 찾고 싶다면 검색 목적을 바꿉니다.

npx ecc consult "test driven development" --target claude

추천 결과가 나오더라도 곧바로 설치하지 말고 안내된 미리보기 명령으로 설치 범위를 먼저 확인하세요.

설치 후 바로 써보는 실전 프롬프트

ECC는 설치보다 사용 순서가 더 중요합니다. 아래 프롬프트는 특정 명령어 이름을 외우지 않아도 현재 설치된 스킬을 찾아 사용하도록 구성했습니다.

1. 구현 전에 계획부터 세우기

현재 설치된 ECC 기능 중 구현 계획에 적합한 스킬을 사용해줘.

요청할 기능:
[여기에 구현할 기능을 입력]

먼저 현재 코드베이스를 분석하고 다음 내용을 정리해줘.
1. 수정해야 할 파일
2. 기존 기능에 미치는 영향
3. 예상되는 예외 상황
4. 필요한 테스트
5. 구현 순서
6. 보안 또는 데이터 손실 위험

아직 코드를 수정하지 말고 계획을 보여준 뒤 내 승인을 기다려.

블로그 북마크 기능을 만든다면 다음처럼 입력할 수 있습니다.

현재 설치된 ECC 기능 중 구현 계획에 적합한 스킬을 사용해줘.

블로그 게시글에 북마크 기능을 추가하고 싶어.
로그인한 사용자는 게시글을 저장하고 북마크 목록에서 다시 볼 수 있어야 해.

먼저 현재 코드베이스를 분석하고 수정 파일, 데이터 구조,
예외 상황, 테스트 항목, 구현 순서를 정리해줘.
아직 코드를 수정하지 말고 내 승인을 기다려.

2. TDD 방식으로 구현하기

현재 설치된 ECC의 TDD 관련 스킬을 사용해서 승인한 계획을 구현해줘.

반드시 다음 순서로 진행해줘.
1. 실패하는 테스트를 먼저 작성한다.
2. 테스트가 예상한 이유로 실패하는지 확인한다.
3. 테스트를 통과하는 최소한의 코드를 작성한다.
4. 전체 테스트를 실행한다.
5. 중복과 복잡도를 정리한다.
6. 테스트를 다시 실행한다.

각 단계가 끝날 때 실행한 테스트와 결과를 보여줘.
테스트 증거 없이 완료됐다고 말하지 마.

3. 변경된 코드 리뷰하기

현재 설치된 ECC의 코드 리뷰 기능을 사용해서
이번 작업에서 변경된 코드만 검토해줘.

다음 우선순위로 문제를 찾아줘.
1. 실제 오류가 발생할 수 있는 코드
2. 보안과 권한 문제
3. 데이터 손실 가능성
4. 테스트가 빠진 동작
5. 유지보수를 어렵게 만드는 구조

취향 차이 수준의 의견은 제외해줘.
문제를 발견하면 파일명과 위치, 발생 조건, 수정 방향을 함께 알려줘.
직접 수정하지 말고 먼저 리뷰 결과만 보여줘.

리뷰 결과는 다음 프롬프트로 다시 검증할 수 있습니다.

방금 발견한 각 문제를 실제 코드 흐름과 테스트를 기준으로 다시 검증해줘.

각 항목을 다음 중 하나로 분류해줘.
- 반드시 수정해야 하는 실제 문제
- 특정 조건에서만 발생하는 문제
- 개선 제안
- 잘못된 지적

추측만으로 판단하지 말고 근거가 있는 항목만 남겨줘.

4. 보안 검사하기

현재 설치된 ECC의 보안 검사 기능을 사용해줘.

이번 변경 사항을 중심으로 다음 항목을 확인해줘.
1. 인증과 권한 우회 가능성
2. 사용자 입력값 검증
3. 비밀키 또는 개인정보 노출
4. SQL 인젝션과 명령어 인젝션
5. XSS와 CSRF
6. 의존성 또는 설정 파일의 위험
7. 로그에 민감한 정보가 남는지 여부

발견한 문제는 심각도 순으로 정리하고,
공격이 가능한 조건과 수정 방법을 함께 설명해줘.
자동 수정은 하지 말고 먼저 결과만 보여줘.

AgentShield를 직접 실행하려면 Node.js와 npm이 필요할 수 있습니다.

node --version
npm --version
npx ecc-agentshield scan

5. 완료 전에 최종 검증하기

이번 작업이 정말 완료됐는지 검증해줘.

다음 항목을 실제 실행 결과를 근거로 확인해줘.
1. 요청한 기능이 모두 구현됐는가?
2. 관련 테스트가 통과하는가?
3. 전체 테스트에서 회귀 오류가 없는가?
4. 빌드와 타입 검사가 통과하는가?
5. 코드 리뷰에서 남은 치명적인 문제가 없는가?
6. 문서나 환경 변수 안내가 필요한가?

실행하지 못한 검증은 통과했다고 표현하지 마.
완료된 항목과 확인하지 못한 항목을 구분해서 보고해줘.

한 번에 사용하는 통합 프롬프트

현재 설치된 ECC 기능을 활용해서 아래 작업을 진행해줘.

작업:
[구현하고 싶은 내용을 입력]

진행 원칙:
1. 먼저 코드베이스와 요구사항을 분석한다.
2. 구현 계획을 작성하고 내 승인을 기다린다.
3. 승인 후 실패하는 테스트부터 작성한다.
4. 최소한의 코드로 테스트를 통과시킨다.
5. 전체 테스트와 빌드를 실행한다.
6. 변경된 코드만 리뷰한다.
7. 보안과 예외 상황을 검사한다.
8. 실제 검증 결과를 근거로 완료 여부를 보고한다.

각 단계에 적합한 ECC 스킬이 설치돼 있다면 사용해줘.
현재 설치된 목록에서 확인되지 않은 스킬이나 명령어는 추측하지 마.

함께 보면 좋은 Claude Code 글

Q&A: 자주 묻는 질문

삭제하기 전에 범위부터 확인하세요

플러그인 방식이라면 Claude Code 안에서 제거할 수 있습니다.

/plugin uninstall ecc@ecc

수동 설치를 제거해야 한다면 삭제 범위를 먼저 확인합니다.

node scripts/uninstall.js --dry-run

삭제 대상이 맞을 때만 실제 제거를 실행합니다.

node scripts/uninstall.js

~/.claude 폴더 전체를 지우면 다른 설정까지 사라질 수 있습니다. 본인이 추가한 ECC 관련 폴더만 정확히 확인하세요.

마무리

ECC는 Claude Code의 성능을 무조건 높여주는 단일 명령어가 아닙니다. 계획, 테스트, 리뷰, 보안 검사를 반복 가능한 개발 방식으로 만드는 도구 모음입니다.

편리함이 우선이라면 플러그인으로 시작하세요. 컨텍스트 비용과 세부 설정이 중요하다면 minimal 프로필이나 선택 설치가 더 적합합니다.

처음부터 모든 기능을 사용할 필요는 없습니다. 작은 프로젝트에서 아래 흐름만 먼저 경험해보세요.

요구사항 정리
→ 구현 계획
→ 계획 승인
→ 실패하는 테스트
→ 최소 구현
→ 전체 테스트
→ 코드 리뷰
→ 보안 검사
→ 최종 검증

처음 설치했다면 아래 프롬프트 하나만 실행해도 충분합니다.

현재 설치된 ECC 기능을 확인한 뒤,
이 프로젝트에 작은 기능 하나를 추가하기 위한 계획을 세워줘.

아직 코드는 수정하지 말고
수정할 파일, 위험 요소, 테스트 항목, 구현 순서를 정리한 뒤
내 승인을 기다려.

바로 코드를 작성시키는 방식과 계획부터 검증하는 방식의 차이를 가장 빠르게 확인할 수 있을 것입니다.