Guide complet ECC (Everything Claude Code) sur Mac cloud MacLogin (2026)

Sur un Mac mini Apple Silicon loué via MacLogin, exécuter Everything Claude Code (ECC) permet de placer 61 agents, 246 compétences, 76 shims de commandes héritées, hooks, règles et outils mémoire sur un macOS natif toujours allumé, plutôt que sur un portable qui dort. ECC est une couche d’exploitation open source maintenue dans affaan-m/ECC (MIT) ; elle ne remplace pas le CLI Claude Code d’Anthropic et se lit avec la documentation officielle Claude Code. Ce guide couvre l’installation de Claude Code sur l’hôte loué, l’ECC via plugin ou installeur manuel, la copie ciblée des paquets rules/, le flux ssh -t + tmux, puis l’offboarding de fin de bail.

Lecture complémentaire : Claude Code en SSH avec PTY, première connexion SSH et empreinte hôte, keepalive SSH et dépannage, Multica auto-hébergé sur Mac cloud, louer ou acheter un Mac mini, fin de bail et rotation des accès.

Pourquoi ECC sur un Mac cloud MacLogin plutôt que sur un portable

ECC sépare les surfaces harness que charge Claude Code du code produit vivant dans vos dépôts. Les premières résident dans ~/.claude, le cache marketplace et l’état SQLite optionnel ; le second reste sous ~/projects/.... Les équipes louent un Mac mini M4 chez MacLogin pour le macOS natif (Trousseau, hooks launchd, toolchain Apple), le SSH 24/7 (boucles ECC et hooks survivent à la mise en veille du portable) et la sortie datacenter vers api.anthropic.com et npm depuis Hong Kong, Tokyo, Séoul, Singapour ou US East. Prévoyez 16 Go de mémoire unifiée au départ, au plus deux sessions lourdes en parallèle, et ≥ 20 Go libres sur le volume personnel avant d’ajouter des worktrees.

Le dépôt ECC pèse des centaines de Mo à cause des compétences : gardez un clone « doré » sur l’hôte loué et évitez de répéter npm install sur chaque portable. Les flux /multi-* parallèles exigent de surveiller le swap et d’envisager 24 Go ou plus.

Architecture ECC sur Mac cloud

Le tableau suivant liste au moins cinq surfaces et leurs rôles. Identifiants publics : GitHub affaan-m/ECC, marketplace ecc@ecc, npm ecc-universal / ecc-install.

Prérequis sur le bail MacLogin

Avant ECC, imposez Node v20+ (l’installeur npm) et terminez la confiance de clé hôte avant d’écrire secrets ou OAuth.

Runbook en 9 étapes

Les 9 étapes ci-dessous sont séquentielles ; les sections suivantes approfondissent les étapes 2, 4–6, 5 et 7.

Étape 1 — Choisir la région et ouvrir SSH

Sélectionnez le nœud MacLogin le plus proche des ingénieurs. Authentifiez-vous par clé ; réglez ServerAliveInterval 60 côté client (guide keepalive) et validez l’empreinte (checklist trust).

Étape 2 — Installer Claude Code

Suivez la procédure macOS Anthropic. Sur l’hôte : claude --version. Pour l’abonnement, claude auth login dans un TTY interactif, pas via une ligne SSH sans PTY. Ne mélangez pas API et OAuth dans le même shell (guide PTY).

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

Étape 3 — Cloner ECC

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

Conservez un clone principal sur la machine louée.

Étape 4 — Un seul chemin d’installation ECC

Chemin A — Plugin (souvent recommandé) :

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

Chemin B — Profil minimal sans hooks :

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

Chemin C — Core sans hooks puis modules :

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

npx ecc consult "security reviews" --target claude

Étape 5 — Copier uniquement les dossiers de règles (utilisateurs plugin)

Le plugin n’embarque pas tout rules/. Copiez des dossiers entiers vers ~/.claude/rules/ecc/.

Étape 6 — Valider la santé

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

Pour l’automatisation : ecc status --markdown --write status.md (ECC v2.0+).

Étape 7 — Flux interactif via SSH

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

Étape 8 — Essais ECC

Dans claude sur l’hôte, testez /harness-audit, éventuellement /security-scan, /sessions. Une lenteur anormale suggère une double installation.

Étape 9 — Fin de bail

Révoquez clés et jetons Anthropic, puis supprimez ou archivez les couches ECC dans ~/.claude et ~/ECC selon la politique. Suivez l’offboarding et l’analyse louer/acheter.

Claude Code sur l’hôte loué (approfondissement)

Fixez un préfixe npm global cohérent avec Node v20+ pour éviter les collisions nvm/launchd. Injectez ANTHROPIC_API_KEY uniquement dans les daemons ; les shells humains restent sur OAuth. Avec 16 Go, limitez-vous à deux sessions lourdes sauf surveillance mémoire active.

Plugin ECC et installeurs (approfondissement)

Le plugin distribue compétences et commandes via marketplace ; install.sh / npx ecc-install servent aux profils modulaires et audits hors ligne. Après toute installation, exécutez node scripts/ecc.js doctor et consultez Reset / Uninstall. Avec Multica, lisez l’article self-host pour ports et jetons.

Règles et profils (approfondissement)

Copiez rules/common plus les paquets langage nécessaires (ex. rules/typescript) en conservant l’arborescence. Sur monorepo, harmonisez d’abord la politique .claude à la racine.

SSH et tmux (approfondissement)

Sans PTY, ssh host claude échoue avec Input must be provided… when using --print. Standardisez ssh -t et placez les boucles longues dans tmux. Keepalive : article dédié ; détails PTY : guide SSH.

Dépannage

Scénario 1 — Compétences dupliquées

Symptôme : même compétence invoquée deux fois ; logs de hooks doublés.
Cause : plugin + profil full.
Correctif : Reset / Uninstall, puis un seul chemin ; doctor avant réinstallation.

Scénario 2 — SSH one-liner sans TTY

Symptôme : sortie immédiate.
Cause : absence de PTY.
Correctif : ssh -t user@host "claude" ou tmux d’abord.

Scénario 3 — npm install échoue

Symptôme : EACCES, timeouts, TLS.
Cause : Node trop vieux, filtrage sortant, registre inaccessible.
Correctif : passer à Node v20+, vérifier le port 443, puis npm install --prefer-offline.

Scénario 4 — OAuth cassé avec clé API exportée

Symptôme : Remote Control ou login échoue si ANTHROPIC_API_KEY est présent.
Cause : conflit de chemins d’auth.
Correctif : unset ANTHROPIC_API_KEY, puis login dans un ssh -t interactif.

FAQ