box-archi 님의 블로그

개요

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

항목 값 설명

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

스킬 역할

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 핵심 구성 요소

구성요소 경로 역할

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. 키보드 단축키

단축키 기능

8. 트러블슈팅 기록

문제 원인 해결

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

슬라이드

전체적인 내용은 유지하되 아래 가이드에 따라 애니메이션 슬라이드로 개선해줘 -배경 : webgl 세이더 -폰트 : 현재사용유지 -컬러 : 현재사용유지

• 그래픽과 텍스트 영역분리 - 텍스트 가독성 최우선, 그라디언트 텍스트 금지
• 장면마다 맥락에 맞는 추상 도형(원/링/선)또는 의미있는 상징적 그래픽 사용
• animations.jsx 스타터 컴포넌트 기반 (stage/sprite/usetime)

디자인.md(**awesome-design-md)←대기업들의 디자인 UI 참조**

디자인 기본안을 통한 슬라이드 작성

https://youtu.be/NnIuDXt-KKI?si=fWQ7rnsvUZq9kUnY

클로드 디자인으로 제작한 애플스타일 결과물(토큰이 너무많이들어 영상까지는 ㅠ)

오늘 한 일 요약

ecc-agentshield로 Claude Code 환경 보안 감사를 진행하고, 발견된 Critical 이슈들을 수동으로 수정했습니다.

1. AgentShield 보안 스캔 실행

npx ecc-agentshield scan

초기 결과 (수정 전)

항목 점수

• 전체 발견: 968개 (Critical 24, High 162, Medium 260, Low 513, Info 9)
• 자동 수정 가능: 69개
• 발견된 스킬: 243개 (계측 없음)

2. 수정 내용

~/.claude/mcp-configs/mcp-servers.json

YOUR_*_HERE 형태의 하드코딩 플레이스홀더를 환경변수 참조 형식으로 변경:

서버 변경 전 변경 후

~/.claude/settings.json

기본 permissions 블록 추가:

"permissions": {
  "allow": [
    "Read",
    "Glob",
    "Grep",
    "Bash(git *)",
    "Bash(npm run *)",
    "Bash(npx *)"
  ],
  "deny": []
}

3. 수정 후 결과

npx ecc-agentshield scan

항목 수정 전 수정 후

→ Secrets 항목 완전 해결

4. 남은 이슈

• Hooks (0/100): PostToolUse 훅 미설정 → /hookify로 개선 가능
• MCP Servers (0/100): 일부 플레이스홀더 잔존 (supabase project-ref 등)
• Permissions (26/100): 더 세밀한 권한 설정 필요
• Agents (0/100): 에이전트 계측(instrumentation) 미설정
• Skill Health: 243개 스킬 모두 미계측 (versioned/rollback-ready 0개)

관련 명령어

# 보안 스캔
npx ecc-agentshield scan

# 자동 수정 시도
npx ecc-agentshield scan --fix

# 훅 설정
/hookify