Installer ECC sur Mac mini 2026 : guide Everything Claude Code

Pourquoi installer ECC sur un Mac mini ?

Claude Code fonctionne particulièrement bien sur macOS avec un SSH stable, du NVMe rapide et une disponibilité continue. Beaucoup d’équipes louent un Mac mini M4 dédié plutôt que d’ancrer ECC sur un portable qui dort.

• État ~/.claude persistant — compétences, hooks et règles survivent aux redémarrages de votre machine locale lorsque le harnais vit sur le serveur
• Faible latence vers l’API Anthropic — RTT d’environ ~24 ms depuis un nœud bien aligné contre 180 ms+ si la région est mal choisie (matrice des régions). Pages tarifs et aide KuzCloud pour planifier la région.
• 16 Go suffisent pour ECC + CLI Claude Code ; prévoyez 24 Go si vous exécutez aussi OpenClaw ou des sidecars Docker lourds

ECC ne remplace pas Claude Code — c’est une couche de configuration et de flux au-dessus. Si vous n’avez besoin que d’un agent terminal minimal sans 246 compétences, consultez d’abord les alternatives gratuites à Claude Code.

Architecture ECC : ce qui est installé

ECC (dépôt affaan-m/ECC, npm : ecc-universal) s’installe dans des répertoires propres à chaque harnais. Pour Claude Code sur macOS :

Trois identifiants publics (à ne pas confondre) :

1. GitHub : affaan-m/ECC
2. Plugin marketplace Claude : ecc@ecc
3. CLI npm : ecc-universal / npx ecc-install

L’amont avertit explicitement : /plugin install + ./install.sh --profile full = compétences dupliquées et hooks cassés. Choisissez un seul chemin ci-dessous.

Référence externe : Documentation Anthropic Claude Code.

Prérequis sur le Mac mini

Avant installation, vérifiez :

# macOS 14+ recommandé (Sequoia testé sur M4) sw_vers # Node.js 20 LTS (18+ minimum pour les scripts ECC) node -v # attendez v20.x ou v22.x npm -v # Git git --version # CLI Claude Code (à installer séparément si absent) claude --version

Sur un nœud KuzCloud vierge, installez Node via Homebrew :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install node git

Prévoyez ~2 Go disque pour le clone ECC + node_modules, ~500 Mo RAM au repos pour les hooks, plus l’empreinte de Claude Code. Pour la fenêtre de location, une rafale 3–7 jours couvre souvent la première mise en place et l’évaluation d’ECC.

Installer ECC sur Mac mini : guide en 8 étapes

Étape 1 — SSH sur le Mac mini et création d’un workspace

ssh -i ~/.ssh/kuzcloud.pem user@YOUR_NODE_IP mkdir -p ~/ecc-lab && cd ~/ecc-lab

Les identifiants arrivent en général sous ~5 minutes après commande — même flux que les autres guides Mac distant.

Étape 2 — Cloner le dépôt ECC

git clone https://github.com/affaan-m/ECC.git cd ECC git checkout main # ou épinglez un tag, ex. v2.0.0-rc.1

Étape 3 — Installer les dépendances Node

npm install # Alternatives : pnpm install | yarn install | bun install

Cette étape télécharge les adaptateurs de hooks et les scripts d’installation. Comptez 3 à 8 minutes au premier lancement selon la bande passante.

Étape 4 — Choisir un seul chemin d’installation

Chemin A — Plugin Claude Code (recommandé pour la plupart)

Dans une session Claude Code interactive sur le Mac mini :

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

Puis copiez uniquement les paquets de règles nécessaires (le plugin ne distribue pas les règles automatiquement) :

mkdir -p ~/.claude/rules/ecc cp -R rules/common ~/.claude/rules/ecc/ cp -R rules/typescript ~/.claude/rules/ecc/ # omettez si pas de TS

Ne lancez pas ./install.sh --profile full après le chemin A.

Chemin B — Profil minimal manuel (sans hooks, charge minimale)

./install.sh --profile minimal --target claude

Équivalent :

npx ecc-install --profile minimal --target claude

Utilisez le chemin B sur les nœuds 16 Go si les hooks sont trop agressifs ou si vous voulez seulement règles + agents.

Chemin C — Installation manuelle complète (utilisateurs avancés)

./install.sh --profile full --target claude

Ne lancez pas aussi /plugin install ecc@ecc si vous choisissez le chemin C.

Étape 5 — (Optionnel) Consulter avant modules supplémentaires

npx ecc consult "security reviews typescript" --target claude

Relisez le plan prévisualisé, puis installez des capacités ciblées :

npx ecc install --profile minimal --target claude --with capability:machine-learning

Étape 6 — Vérifier la santé de l’installation

node scripts/ecc.js list-installed node scripts/ecc.js doctor node scripts/ecc.js repair # premier passage de réparation sûr si doctor signale des problèmes

Attendu : doctor liste les profils installés sans double enregistrement des hooks.

Étape 7 — Configurer le profil de hooks (chemin A ou install full uniquement)

export ECC_HOOK_PROFILE=standard # ou minimal | strict export ECC_DISABLED_HOOKS= # liste séparée par virgules pour désactiver certains hooks

Ajoutez ces lignes au ~/.zshrc du Mac mini pour les conserver entre sessions SSH.

Étape 8 — Test fumée de Claude Code avec ECC

cd ~/ecc-lab/sample-project # votre dépôt claude

En session, exécutez une commande packagée (exemple) :

/harness-audit

Ou demandez : « Utilise les compétences ECC pour relire ce README sur les sections trop coûteuses en tokens. »

Tableau comparatif des chemins

Recommandation : si vous louez un Mac mini KuzCloud uniquement pour ECC + Claude Code, commencez par chemin A + rules/common seulement, puis ajoutez les paquets langage progressivement. Activez les hooks avec ECC_HOOK_PROFILE=minimal d’abord ; passez à standard seulement après une semaine stable.

Dépannage

Erreur : compétences dupliquées / commandes déclenchées deux fois

Symptôme : la même commande slash apparaît deux fois ; les logs de hook montrent un double SessionStart.

Cause : cumul installation plugin + install.sh full.

Correctif :

node scripts/ecc.js doctor # Suivez la section README ECC "Reset / Uninstall ECC" # Puis réinstallez avec un seul chemin

Erreur : claude: command not found sur le Mac distant

Symptôme : échec des commandes plugin ; claude --version introuvable.

Correctif :

npm install -g @anthropic-ai/claude-code # Ou https://docs.anthropic.com/en/docs/claude-code/setup export ANTHROPIC_API_KEY=sk-ant-...

Reconnectez-vous en SSH puis refaites l’étape 4.

Erreur : plugin marketplace ecc@ecc introuvable

Symptôme : échec de /plugin install ecc@ecc lors de la résolution marketplace.

Correctif : ignorez le chemin A ; utilisez le chemin B :

cd ~/ecc-lab/ECC && ./install.sh --profile minimal --target claude

Erreur : OOM Node pendant npm install

Symptôme : Killed: 9 pendant l’installation sur un Mac mini 16 Go.

Correctif : ajoutez temporairement du swap ou passez à un nœud 24 Go ; alternativement npm install --omit=dev si l’amont le documente.

ECC sur Mac mini : louer ou acheter

ECC n’exige pas le GPU Apple Silicon : un Mac mini M4 avec Node 20 et ~10 Go de disque libre suffit. Si vous utilisez ECC moins de 22 jours pleins par mois, la location bat souvent un achat 599 $+ (guide louer vs acheter). Pour les offres et le support, voir tarifs et aide.

FAQ

ECC est-il la même chose que Claude Code ?

Non. Claude Code est la CLI de codage agentique d’Anthropic. ECC est un pack d’extension maintenu par la communauté (compétences, règles, hooks) sur github.com/affaan-m/ECC. Vous devez d’abord installer Claude Code (ou un autre harnais pris en charge).

Puis-je installer ECC sur Cursor sans Claude Code ?

Oui. ECC prend en charge Cursor, Codex, OpenCode et d’autres via --target cursor (ou des installeurs spécifiques). Ce guide se concentre sur Claude Code sur Mac mini, le cas d’usage KuzCloud le plus fréquent.

ECC envoie-t-il mon code à des tiers supplémentaires ?

ECC ajoute des règles, hooks et compétences locales. Les appels LLM passent toujours par le fournisseur utilisé par votre harnais (Anthropic, OpenAI, etc.). Consultez le Security Guide d’ECC et lancez /security-scan (AgentShield) avant les dépôts de production.

Comment désinstaller ECC complètement ?

Suivez la section amont Reset / Uninstall ECC : commandes repair/list de node scripts/ecc.js, suppression de ~/.claude/rules/ecc/, désinstallation du plugin dans Claude Code, suppression des dossiers de compétences dupliqués signalés par doctor.

ECC fonctionne-t-il en SSH depuis mon portable ?

Oui. Installez ECC sur le Mac mini distant, lancez claude dans tmux ou screen, connectez-vous en SSH depuis le portable. Utilisez le port forwarding seulement si vous avez besoin d’une GUI locale pour le tableau de bord Tk ECC (npm run dashboard).