Everything Claude Code로 Claude Code 환경 업그레이드하기
핵심 요약
Everything Claude Code는 Claude Code를 "개발용 작업환경" 수준으로 확장해 주는 설정 모음으로, 에이전트·스킬·훅·명령어·MCP 구성을 한 번에 제공하는 패키지다.
실제 프로덕션 개발에 쓰이며 검증된 구조를 그대로 가져와, 설치만으로 계획·테스트·코드리뷰·메모리 관리·검증 루프까지 통합된 워크플로를 만들 수 있다.
프로젝트 개요와 철학
Everything Claude Code는 단순한 예제가 아니라, 실제 제품을 만들면서 10개월 이상 매일 다듬어 온 "Claude Code용 운영체제"에 가깝다.
목표는 Claude를 일회성 도우미가 아니라, 계획을 세우고 기억을 쌓고 검증까지 수행하는 개발 파트너로 만드는 것이다.
이를 위해 작업을 역할 단위(에이전트), 절차 단위(스킬·워크플로), 자동 실행(훅), 명시적 호출(슬래시 명령어)로 나누어 재사용 가능하게 설계되어 있다.
가이드: 코드만으로는 알 수 없는 사용법
저장소에는 순수 설정과 코드만 들어 있고, 실제로 어떻게 쓰는지에 대한 설명은 별도의 "쇼트핸드 가이드"와 "롱폼 가이드"에 담겨 있다.
쇼트핸드는 빠르게 써보고 싶은 사람을 위한 요약본이고, 롱폼은 토큰 최적화, 메모리 지속, 지속적 학습, 검증 루프, 서브에이전트 오케스트레이션 등 고급 개념을 깊게 다룬다.
실제 사용성은 이 가이드와 설정을 함께 볼 때 극대화되므로, 설치 후 바로 가이드를 읽어 워크플로 전체 그림을 잡는 것이 좋다.
크로스 플랫폼과 패키지 매니저 자동 감지
이 설정은 Windows, macOS, Linux에서 모두 동작하도록 훅과 스크립트가 Node.js 기반으로 다시 작성되었다.
프로젝트에서 어떤 패키지 매니저를 쓸지 자동으로 감지하는 기능이 있고, 환경 변수 → 프로젝트 설정 → package.json → 락 파일 → 글로벌 설정 → 시스템에 설치된 도구 순으로 우선순위를 둔다.
예를 들어 CLAUDE_PACKAGE_MANAGER=pnpm 을 지정하거나, node scripts/setup-package-manager.js --project bun 과 같이 스크립트로 프로젝트별 기본 패키지 매니저를 설정할 수 있으며, /setup-pm 명령으로 Claude 안에서 바로 설정할 수도 있다.
디렉터리 구조로 보는 구성 요소 지도
저장소 구조는 "Claude를 확장하는 패키지" 자체다.
.claude-plugin 폴더에는 마켓플레이스와 플러그인 메타데이터가 있어, /plugin 명령으로 바로 설치할 수 있게 해준다.
agents, skills, commands, rules, hooks, contexts, mcp-configs 등은 각각 역할이 분명한 설정 단위로 나뉘어 있고, scripts와 tests는 훅과 유틸을 실제로 실행·검증하는 코드와 테스트를 담고 있다.
이 구조를 이해하면, 필요한 부분만 골라서 내 환경에 옮기거나 커스터마이즈하기 쉬워진다.
에이전트: 역할 기반 서브봇 설계
에이전트는 "특정 역할에 특화된 Claude 프로필"에 가깝다.
예를 들어 planner.md는 기능 구현 계획을 세우는 역할, architect.md는 시스템 설계를, code-reviewer.md는 품질·보안·유지보수성을 검토하는 역할을 맡는다.
각 에이전트는 사용할 도구(파일 읽기, 검색, 쉘 실행 등)와 모델(예: opus)을 명시하고, "너는 시니어 코드 리뷰어다"와 같은 역할 지시를 포함해, 범위를 좁힌 상태에서 깊이 있는 작업을 수행하게 돕는다.
프로젝트 규모가 커질수록 '한 명의 Claude' 대신, 역할별 에이전트 팀으로 분업시키는 전략이 유용해진다.
스킬: 재사용 가능한 작업 절차 정의
스킬은 주제별·도메인별 "워크플로 설명서"다.
예를 들어 tdd-workflow는 "인터페이스 먼저 정의 → 실패하는 테스트 작성 → 최소 구현 → 리팩터링 → 80% 이상 커버리지 확인"과 같은 절차를 정의해, TDD를 일관되게 실천하게 만든다.
coding-standards, backend-patterns, frontend-patterns 등은 언어나 프레임워크에 맞는 모범 사례를 담고 있고, continuous-learning, verification-loop, eval-harness 등은 세션에서 배운 패턴을 추출하고, 자동 검증 루프를 돌리는 고급 워크플로를 정의한다.
이 스킬들은 명령어 또는 에이전트를 통해 호출되어, "이 프로젝트에서 항상 같은 방식으로 일하게 만드는 규범" 역할을 한다.
명령어: /tdd, /plan 같은 단축키
commands 폴더에는 Claude Code에서 바로 입력할 수 있는 슬래시 명령어 정의가 들어 있다.
/plan으로 구현 계획을 세우고, /tdd로 TDD 모드로 전환하며, /code-review로 코드 리뷰를 요청하고, /build-fix로 빌드 에러 해결을 지시하는 식이다.
또 /learn은 세션 도중 패턴을 추출해 지식으로 쌓고, /checkpoint와 /verify는 검증 상태를 저장·재실행해 "검증 루프"를 구성한다.
이 명령어들은 사람이 매번 긴 지시를 타이핑하지 않아도, 정해진 워크플로를 버튼처럼 재사용하게 해 준다.
훅과 스크립트: 자동화와 세션 메모리 관리
훅은 "특정 도구 사용/이벤트가 발생했을 때 자동으로 실행되는 트리거"다.
예를 들어 코드 편집 도구가 JS/TS 파일을 수정할 때 console.log가 있는지 grep으로 검사하고, 발견 시 "console.log 제거" 경고를 띄우는 식의 훅을 설정할 수 있다.
memory-persistence 관련 훅과 scripts/hooks/의 Node.js 스크립트들은 세션 시작 시 이전 맥락을 자동으로 불러오고, 세션 종료 시 상태를 저장하며, 압축 전/후 상태 관리, 세션에서 학습한 패턴 평가 등을 수행한다.
이 덕분에 Claude와의 대화가 "한 번 쓰고 사라지는 대화"가 아니라, 시간이 지날수록 지식과 패턴이 누적되는 개발 환경으로 변한다.
룰과 컨텍스트: 항상 지켜야 할 원칙과 모드 전환
rules 폴더의 파일들은 "항상 지켜야 할 규칙"을 역할과 주제별로 잘게 쪼개어 둔다.
예를 들어 security.md는 하드코딩된 비밀 정보 금지, testing.md는 TDD와 80% 이상의 테스트 커버리지 요구, git-workflow.md는 커밋 메시지·PR 규칙을 정해 둔다.
contexts는 상황별 모드 전환을 위한 시스템 프롬프트 조각으로, 개발 모드, 리뷰 모드, 리서치 모드 등에서 서로 다른 기준과 태도를 가지도록 Claude를 전환시킨다.
규칙과 컨텍스트를 분리해 두면, 프로젝트나 개인 스타일에 맞게 필요한 것만 선택·수정하기가 수월하다.
설치와 사용 방법: 플러그인 vs 수동 구성
가장 간단한 방식은 Claude Code 내에서 플러그인으로 바로 설치하는 것이다.
/plugin marketplace add affaan-m/everything-claude-code 후 /plugin install everything-claude-code@everything-claude-code를 실행하면, 한 번에 모든 명령어·에이전트·훅을 사용할 수 있다.
반대로 세부 구성을 직접 통제하고 싶다면 저장소를 클론한 뒤, agents, rules, commands, skills를 각각 ~/.claude 아래로 복사하고, hooks/hooks.json 내용을 settings.json에 합치고, mcp-configs에서 필요한 MCP 서버 설정만 골라서 ~/.claude.json에 추가하면 된다.
이때 MCP 설정의 API 키 자리(YOUR_*_HERE)를 실제 키로 채우는 것을 반드시 잊지 말아야 한다.
MCP와 컨텍스트 창 관리 전략
MCP는 GitHub, Supabase, Vercel, Railway 등 외부 리소스를 Claude가 다루게 해주는 플러그인 같은 존재다.
하지만 MCP를 과하게 켜두면 도구 정의와 메타데이터만으로도 컨텍스트를 많이 잡아먹어, 200k 컨텍스트 창이 체감상 70k 수준으로 줄어들 수 있다.
권장 전략은 MCP 서버는 넉넉히 20–30개까지 설정해 두되, 실제 프로젝트별로는 10개 이하, 전체 툴 수는 80개 이하로 유지하고, 사용하지 않는 MCP는 프로젝트 설정의 disabledMcpServers를 통해 과감히 비활성화하는 것이다.
테스트와 기여 문화
이 설정 자체도 tests/run-all.js로 돌릴 수 있는 테스트 스위트를 갖추고 있으며, 유틸 함수와 훅 로직을 별도 테스트 파일로 검증한다.
저장소는 커뮤니티 기여를 적극적으로 권장하며, 언어별·프레임워크별 스킬, DevOps 에이전트, 도메인 특화 지식 등 다양한 확장을 환영한다.
즉 이 프로젝트는 "완제품"이라기보다, 많은 개발자가 함께 진화시켜 나가는 Claude Code 생태계의 기반으로 설계되어 있다.
인사이트
Everything Claude Code는 "Claude 설정 모음"이 아니라, 계획–구현–테스트–리뷰–배포 전후의 학습까지 이어지는 개발 라이프사이클을 통째로 설계해 놓은 템플릿에 가깝다.
실용적으로는 ① 플러그인으로 먼저 설치해 기본 워크플로를 직접 경험해 보고, ② 그중 자주 쓰는 에이전트·명령어·룰만 골라 내 로컬 설정으로 옮겨오며, ③ 내 기술 스택과 팀 문화에 맞게 스킬과 룰을 점진적으로 수정·추가하는 방식이 가장 효율적이다.
중요한 것은 "모든 기능을 다 켜는 것"이 아니라, 토큰·도구·룰·에이전트를 최소한으로 유지하면서, 반복되는 작업을 점점 스킬·훅·명령어로 끌어올려 자동화하는 방향으로 발전시키는 것이다.