Claude Code + ECC 환경 설정 정리 (2026-04-29)

개요

Windows 11 환경에서 Claude Code + ECC(Everything Claude Code) 플러그인 설치 및 설정한 내용 정리.

작업 일자: 2026-04-29 | 작업 경로: C:\\Users\\사용자

---

1. 설치 과정 요약

Git 설치 (사전 필수)

ECC 마켓플레이스 클론에 git이 필요한데 PATH 미등록 상태였음.

# winget으로 Git 설치
winget install Git.Git

# SSH known_hosts 등록 (GitHub)
mkdir -p ~/.ssh
ssh-keyscan github.com >> ~/.ssh/known_hosts

• 설치 경로: C:\\Program Files\\Git\\cmd\\
• Claude Code 재시작 필요 (새 PATH 반영)

ECC 마켓플레이스 & 플러그인 설치

# SSH 오류 발생 시 → HTTPS URL 사용
/plugin marketplace add <https://github.com/affaan-m/everything-claude-code>

# 플러그인 설치
/plugin install everything-claude-code@everything-claude-code

# 적용
/reload-plugins

---

2. 글로벌 settings.json 설정

경로: C:\\Users\\사용자명\\.claude\\settings.json

항목 값 설명

autoUpdatesChannel	latest	최신 버전 자동 업데이트
theme	dark	다크 모드
model	sonnet	기본 모델: Claude Sonnet
MAX_THINKING_TOKENS	10000	사고 토큰 최대값
CLAUDE_CODE_SUBAGENT_MODEL	haiku	서브에이전트 모델
permissions.allow	Bash(git *)	git 명령어 자동 허용

---

3. 활성화한 ECC 스킬 3종(프로젝트별 필요시 스킬추가)

스킬 역할

search-first	코드 작성 전 기존 라이브러리/도구 검색 우선
tdd-workflow	RED→GREEN→REFACTOR TDD 사이클, 80%+ 커버리지 강제
strategic-compact	컨텍스트 50 tool call 초과 시 /compact 권고

strategic-compact 훅 (settings.json)

"hooks": {
  "PreToolUse": [{
    "matcher": "Edit|Write",
    "hooks": [{
      "type": "command",
      "command": "node \\"C:/Users/사용자명/.claude/plugins/cache/everything-claude-code/everything-claude-code/2.0.0-rc.1/scripts/hooks/suggest-compact.js\\"",
      "statusMessage": "Checking context budget..."
    }]
  }]
}

• threshold: 50 tool call → 첫 알림, 이후 25회마다 반복
• COMPACT_THRESHOLD 환경변수로 임계값 조정 가능

---

4. ECC 핵심 구성 요소

구성요소 경로 역할

Skills	~/.claude/skills/	재사용 가능한 워크플로우 번들
Agents	~/.claude/agents/	위임용 서브에이전트
Hooks	settings.json > hooks	이벤트 기반 자동화
Rules	~/.claude/rules/	항상 따르는 코딩 가이드라인
Commands	~/.claude/commands/	슬래시 커맨드 진입점

---

5. ECC 주요 스킬 카테고리

코어 워크플로우

• tdd-workflow — TDD 강제 (unit + integration + E2E)
• verification-loop — 빌드 → 테스트 → 린트 → 보안 검증
• strategic-compact — 컨텍스트 예산 관리
• search-first — 구현 전 기존 도구 검색 우선
• security-review — 보안 체크리스트
• continuous-learning-v2 — 세션 패턴 자동 추출 → 스킬 진화

프레임워크별

• Python: python-patterns, python-testing, django-*
• Go: golang-patterns, golang-testing
• Java: java-coding-standards, springboot-*
• Frontend: frontend-patterns, frontend-slides

비즈니스/콘텐츠

• deep-research, market-research, article-writing, content-engine

---

6. MCP 관리 원칙

• 200k 컨텍스트 중 MCP 과다 활성화 시 실효 컨텍스트 70k로 감소
• 권장: MCP 20~30개 설정, 실제 활성화는 10개 미만, 활성 도구 80개 미만
• 확인 명령어: /mcp 또는 /plugins

---

7. 키보드 단축키

단축키 기능

Ctrl+U	입력 줄 전체 삭제
!	빠른 bash 명령어 실행
@	파일 검색
/	슬래시 커맨드
Shift+Enter	멀티라인 입력
Tab	thinking 표시 토글
Esc Esc	Claude 중단 / 코드 복원

---

8. 트러블슈팅 기록

문제 원인 해결

git not found	Git PATH 미등록	winget 설치 후 재시작
SSH host key 오류	known_hosts 없음	ssh-keyscan github.com >> ~/.ssh/known_hosts
Plugin ecc not found	플러그인 이름 오류	everything-claude-code@everything-claude-code 사용

---

9. 관련 파일 경로

• 글로벌 설정: C:\\Users\\사용자명\\.claude\\settings.json
• ECC 플러그인 캐시: C:\\Users\\사용자명\\.claude\\plugins\\cache\\everything-claude-code\\
• 프로젝트 설정: C:\\Users\\사용자명\\Desktop\\클로드설정\\260429md\\.claude\\settings.json
• SSH known_hosts: C:\\Users\\사용자명\\.ssh\\known_hosts
• ECC 스크립트(훅): .../2.0.0-rc.1/scripts/hooks/suggest-compact.js