ECC 쓰는 법

ECC(affaan-m/ECC, 사이트 ecc.tools)는 코딩 에이전트용 에이전트 하네스(harness) 성능·운영 레이어다. Claude Code를 중심으로 Codex·Cursor·OpenCode 등에도 스킬·에이전트·훅·메모리·보안 스캔을 맞춰 넣는 오픈소스 툴킷이다. 이 글은 “ECC 쓰는 법”만 따라간다.

설치·명령은 공식 README와 npm만 근거로 적는다. README가 강조하듯 공식 채널만 쓰자: GitHub affaan-m/ECC, npm ecc-universal/ecc-agentshield, 플러그인 슬러그 ecc@ecc, ecc.tools. 비공식 미러는 쓰지 말 것.

핵심 요약 (TL;DR)

• 무엇인가: 코딩 에이전트에 계획·검증·리뷰·기억·보안 스캔을 붙이는 하네스/운영 레이어(README: agent harness performance optimization system).
• 규모(README 표 기준): 약 68 agents, 292 skills, 94 legacy command shims.
• 요구사항: Node.js >=18. Claude 플러그인 경로는 Git + Claude Code 2.1+ 가 PATH에 있어야 한다(README Install).
• 추천 설치(Claude): npx [email protected] setup
• 멀티 하네스: npx [email protected] install --guided
• Claude 네이티브: /plugin marketplace add https://github.com/affaan-m/ECC → /plugin install ecc@ecc — 플러그인 + 풀 수동 설치를 겹치지 말 것.
• 버전(작성 시점): npm ecc-universal 2.2.1 (npm view ecc-universal version). 라이선스 MIT.

할 수 있는 일

먼저 용어만 짧게 풀어 둔다.

• 코딩 에이전트: Claude Code, Codex, Cursor, OpenCode처럼 에디터·터미널 안에서 코드를 쓰고 명령을 실행하는 AI 조수.
• 하네스(harness): 그 에이전트가 도구·스킬·훅·설정을 붙잡고 작업을 돌리는 실행 틀. (이 블로그에서는 하네스로 통일한다.)
• 스킬(skill): 에이전트가 필요할 때 읽는 재사용 워크플로 지침. ECC는 스킬 우선(skills-first)으로 간다.
• 플러그인(plugin): Claude Code / Codex 같은 하네스에 한 번에 심는 패키지 단위. ECC의 슬러그는 ecc@ecc.
• AgentShield: 에이전트 설정·권한·훅·MCP 표면을 점검하는 보안 스캔 도구(별도 npm ecc-agentshield).

공식 README가 말하는 핵심 능력이다.

• 계획 → 구현 → 테스트 검증 → 새 컨텍스트에서 리뷰하는 엔지니어링 루프
• 프로젝트 맥락을 넘기는 메모리/핸드오프, 반복 성공을 스킬로 올리는 학습 흐름
• AgentShield로 설정·권한·시크릿 노출 표면 점검
• Plan Canvas·Control Pane 등 운영 UI(사이트/Pro·App과 구분; OSS 툴킷은 MIT)
• Claude Code 우선, Codex 네이티브 플러그인, Cursor 등 managed adapter

필요한 것

링크: GitHub · ecc.tools · npm ecc-universal.

단계

1) 추천 — Claude guided setup (버전 핀)

README Recommended 경로. 작성 시점에 확인한 npm 버전 2.2.1을 핀한다.

npm view ecc-universal version
npx [email protected] setup

이 위저드는 Claude Code 플러그인(ecc@ecc)의 설치·업데이트·스코프·훅 프로필을 다룬다. 같은 명령을 다시 돌려도 된다.

다른 러너(README 표):

pnpm dlx [email protected] setup
yarn dlx [email protected] setup
bunx [email protected] setup

2) 멀티 하네스 guided (Claude + Codex + Kimi 등)

npx [email protected] install --guided

자동화 예(README):

npx [email protected] install --guided \
  --harness claude --harness codex --harness kimi \
  --claude-scope local --claude-hooks standard \
  --profile core --yes

쓰기 전 확인:

npx [email protected] install --guided --harness codex --dry-run

3) Claude 네이티브 /plugin 경로 (택일)

Claude Code 안에서:

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

중요: guided setup과 네이티브 /plugin은 같은 ecc@ecc를 깐다. 하나만 고르고, 그 위에 ./install.sh --profile full 같은 풀 수동 Claude 설치를 겹치지 말 것. README: Do not stack install methods.

4) Codex (짧게)

Codex 네이티브 마켓플레이스(README):

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

이후 갱신 예: codex plugin marketplace upgrade ecc → codex plugin add ecc@ecc. Codex 안에서는 $configure-ecc로 가이디드 흐름을 탄다. 레거시 sync와 마켓플레이스 플러그인을 동시에 쓰지 말 것.

5) Cursor (클론 후 adapter)

레포를 클론한 뒤 README 표:

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile minimal --target cursor

프로젝트 로컬 .cursor/ adapter를 깐다. Cursor 네이티브 로딩은 빌드마다 다를 수 있다고 README가 적는다.

6) 설치 후 점검

npx [email protected] list-installed
npx [email protected] doctor

보안 스캔이 필요하면 README·사이트의 AgentShield 경로를 따른다. 스캔은 리뷰 보조이지 안전 보장이 아니다(사이트 FAQ).

막히는 지점

버전 확인

npm view ecc-universal version
npx [email protected] list-installed
npx [email protected] doctor

이 글을 쓰는 시점(2026-09-19, Asia/Seoul)에 npm view ecc-universal version으로 확인한 값: 2.2.1. README 카탈로그 표는 68 agents / 292 skills / 94 commands. engines·플래그·숫자는 설치본과 공식 README·npm이 최종 권위다.

마치며

ECC 쓰는 법은 “한 하네스에 설치 방법 하나”가 핵심이다. Claude면 npx [email protected] setup 또는 /plugin … ecc@ecc 중 하나만, 여러 도구면 install --guided, Cursor면 클론 후 ./install.sh --profile minimal --target cursor. 그다음 doctor로 상태를 보면 검색 가이드로는 충분하다.

더 볼 곳: affaan-m/ECC, ecc.tools, npm ecc-universal.

이 글은 AI가 작성하여 자동 발행된 콘텐츠입니다.