MacLogin 클라우드 Mac에서 ECC(Everything Claude Code) 완전 가이드 (2026)

MacLogin 클라우드 Mac mini(Apple Silicon)에서 Everything Claude Code(ECC)를 돌리면 61개의 에이전트, 246개의 스킬, 레거시 호환용 76개의 커맨드 shim, 훅, 규칙, 메모리 도구를 노트북 절전이 아니라 항상 켜진 네이티브 macOS에 안정적으로 올릴 수 있습니다. ECC는 커뮤니티가 유지하는 오픈소스 «운영 레이어»이며 affaan-m/ECC(MIT) 저장소가 권위입니다. Anthropic의 Claude Code CLI를 대체하지 않으며 Claude Code 공식 문서와 함께 쓰입니다. 이 글은 임대 호스트에 Claude Code를 깐 뒤 ECC 플러그인 또는 수동 설치, 필요한 rules/ 복사, ssh -t와 tmux 워크플로, 계약 종료 시 오프보딩까지 한 흐름으로 정리합니다.

함께 읽으면 좋은 글: Claude Code SSH PTY 가이드, 첫 SSH와 호스트 키 신뢰, SSH keepalive·끊김 트러블슈팅, 클라우드 Mac에서 Multica 셀프호스트, Mac mini 임대 vs 구매, 계약 종료·키 회수 런북.

노트북 대신 MacLogin 클라우드 Mac에서 ECC를 쓰는 이유

ECC는 «Claude Code가 로드하는 하네스 표면»과 «저장소 안의 제품 코드»를 분리합니다. 전자는 ~/.claude, 마켓플레이스 캐시, 선택적 SQLite 상태에 있고 후자는 ~/projects/...에 남습니다. 팀이 Mac mini M4를 MacLogin에서 빌리는 이유는 네이티브 macOS(키체인, launchd 훅, Apple 툴체인 일관성), 상시 SSH(ECC 긴 루프와 훅이 덮개 닫힘으로 끊기지 않음), 데이터센터 출구 대역(홍콩, 도쿄, 서울, 싱가포르, 미 동부에서 api.anthropic.com·npm에 안정적으로 닿기)입니다. 한국 팀은 서울 노드를 1순위로 두고 RTT와 체감 대역을 재측정하십시오. 메모리는 16GB 통합에서 시작해 무거운 에이전트 세션을 동시에 2개 정도로 제한하고, 홈에는 20GB 이상 여유를 남깁니다.

ECC 저장소는 스킬 때문에 클론 크기가 수백 MB에 달할 수 있습니다. «골든» 클론은 임대기 한 대에만 두고 노트북마다 반복 npm install을 줄입니다. /multi-* 병렬 워크플로가 많으면 스왑을 보며 24GB 이상 확장을 검토합니다.

클라우드 Mac에서의 ECC 아키텍처

아래 표는 ECC와 Claude Code가 임대 디스크에서 차지하는 주요 표면입니다(5행 이상). 공개 식별자는 혼동할 수 없습니다. GitHub affaan-m/ECC, 마켓플레이스 플러그인 ecc@ecc, npm ecc-universal / ecc-install입니다.

MacLogin 임대기 사전 점검

ECC 전에 Node v20+(설치기가 npm 사용)과 호스트 키 신뢰 완료를 확인합니다. 비밀을 쓰기 전에 첫 SSH 체크리스트를 마칩니다.

9단계 롤아웃(1–9)

아래 9단계를 순서대로 실행합니다. 이후 네 절에서 2·4–6·5·7단계를 확장합니다.

1단계 — 리전 선택과 SSH 로그인

엔지니어 위치에 맞춰 MacLogin 리전을 고릅니다. 한국 조직은 서울 노드를 우선 검토합니다. 키 로그인과 클라이언트 ServerAliveInterval 60을 설정하고 keepalive 글을 따릅니다.

2단계 — Claude Code CLI 설치

Anthropic 최신 macOS 절차를 따릅니다. 임대기에서 claude --version을 확인합니다. 구독 흐름의 claude auth login은 대화형 TTY에서만 실행합니다. API 자동화와 OAuth를 한 셸에 섞지 마십시오(SSH PTY 가이드).

npm install -g @anthropic-ai/claude-code
claude --version

3단계 — ECC 클론

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

용량이 큽니다. 임대기에 단일 «골든» 클론을 둡니다.

4단계 — ECC 설치 경로 하나만

경로 A(다수 팀 권장)—플러그인:

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

경로 B—최소 수동(훅 없음):

./install.sh --profile minimal --target claude
# 또는: npx ecc-install --profile minimal --target claude

경로 C—core에서 훅 제외 후 필요 시 추가:

./install.sh --profile core --without baseline:hooks --target claude
./install.sh --target claude --modules hooks-runtime

npx ecc consult "security reviews" --target claude

5단계 — 규칙 디렉터리만 복사(플러그인 사용자)

플러그인은 완전한 rules/를 실어 나르지 않습니다. 필요한 언어 팩을 디렉터리 단위로 ~/.claude/rules/ecc/에 복사합니다.

6단계 — 설치 건강 검증

cd ~/ECC
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair

자동화에는 ecc status --markdown --write status.md(ECC v2.0+)를 쓸 수 있습니다.

7단계 — SSH 대화 워크플로

ssh -t user@your-maclogin-host "cd ~/ECC && claude"
tmux new -As ecc
# 분리: Ctrl-b d

8단계 — ECC 커맨드 스모크 테스트

임대기 claude 안에서 /harness-audit, 조건부 /security-scan, /sessions 등을 시험합니다. 응답이 느리면 이중 설치를 의심합니다.

9단계 — 오프보딩과 로테이션

계약 종료 시 Anthropic 키·OAuth를 폐기하고 정책에 따라 ~/.claude ECC 오버레이와 ~/ECC를 삭제하거나 보관합니다. 오프보딩·임대 비교를 따릅니다.

임대기의 Claude Code 설치(심화)

Node v20+ 전역 npm 접두사를 고정해 nvm 다중 버전과 launchd 서비스 불일치를 줄입니다. ANTHROPIC_API_KEY는 데몬(launchd) 환경에만 넣고 사람 로그인 셸에서는 claude auth login만 씁니다. 16GB 통합 메모리에서는 무거운 추론 세션을 동시에 세 개 이상 열지 않습니다.

ECC 플러그인·인스톨러(심화)

플러그인은 마켓으로 스킬을 배포하려는 팀에 맞습니다. install.sh/npx ecc-install은 모듈 분할·오프라인 감사에 적합합니다. 설치 후 node scripts/ecc.js doctor를 돌리고 Reset / Uninstall로 드리프트를 정리합니다. Multica를 병행하면 셀프호스트 글에서 포트·토큰 경계를 확인하십시오.

규칙 팩과 프로파일(심화)

rules/common과 rules/typescript처럼 하위 디렉터리 전체를 복사해 상대 참조를 유지합니다. monorepo는 루트 .claude 정책을 먼저 맞춥니다.

SSH와 tmux(심화)

비 TTY ssh host claude는 Input must be provided… when using --print류로 종료됩니다. ssh -t를 표준으로 하고 긴 루프는 tmux에 올립니다. keepalive는 해당 문서, PTY는 Claude SSH 가이드를 보십시오.

문제 해결

시나리오 1 — 스킬이 두 번 실행됨

증상: 동일 스킬이 중복 호출되고 훅 로그가 쌍을 이룸.
원인: 플러그인 후 full 프로파일 설치.
조치: ECC README의 Reset/Uninstall 후 한 경로만 재설치. 재설치 전 doctor 실행.

시나리오 2 — 한 줄 SSH에서 즉시 종료

증상: PTY 없이 claude가 바로 끝남.
원인: 의사터미널 부재.
조치: ssh -t user@host "claude" 또는 먼저 tmux.

시나리오 3 — 임대기 npm install 실패

증상: EACCES, 레지스트리 타임아웃, TLS 오류.
원인: 낮은 Node 버전, 출구 필터, 레지스트리 불가.
조치: Node v20+로 올리고 VLAN에서 443 확인 후 npm install --prefer-offline 재시도.

시나리오 4 — API 키 설정 뒤 OAuth 깨짐

증상: Remote Control·로그인 실패, 셸에 ANTHROPIC_API_KEY 존재.
원인: 인증 경로 충돌.
조치: unset ANTHROPIC_API_KEY 후 대화형 ssh -t에서 재로그인.

자주 묻는 질문