configurer-ecc

Configurer Everything Claude Code

Exécutez un assistant conversationnel dans l'environnement actuel. Inventorier d'abord, collecter uniquement les choix pris en charge, prévisualiser, confirmer une fois, appliquer de manière non interactive, vérifier, et afficher le message de bienvenue uniquement après le succès. Ne clonez jamais ECC dans un répertoire temporaire et ne copiez pas manuellement des composants de plugin.

Pour un terminal opéré par un humain, les points d'entrée canoniques sont ecc setup et npx ecc-universal setup. Dans un environnement automatisé, utilisez plutôt les commandes explicites non interactives ci-dessous.

Router selon l'environnement actuel

• Dans Claude Code, utilisez l'assistant complet avec scope et hooks ci-dessous.
• Dans Codex, utilisez le cycle de vie natif des plugins de Codex. Ne proposez pas les scopes de Claude ni ne mappez les quatre profils de hooks de Claude sur Codex.
• Dans Kimi, installez la surface du projet sous ./.kimi-code. Kimi ne fournit pas les profils de hooks de cycle de vie de Claude d'ECC.
• Si l'environnement est incertain, indiquez les preuves détectées et demandez quel environnement configurer avant d'exécuter une commande modificatrice.

Cette compétence est un chemin de reconfiguration post-installation. Elle ne peut pas intercepter ni remplacer l'interface utilisateur d'installation initiale intégrée d'un fournisseur.

Claude Code : exécuter l'assistant conversationnel complet

1. Inventorier sans rien modifier

Exécutez les deux commandes et résumez le scope ECC installé, l'état activé et la source du marché :

claude plugin list --json
claude plugin marketplace list --json

Considérez une installation unique existante de ecc@ecc comme une reconfiguration. N'interprétez pas le contrôle "Ouvrir la page d'accueil" propriétaire de Claude comme une preuve d'installation. Arrêtez-vous et signalez la récupération renvoyée par la configuration pour plusieurs scopes ECC, une installation legacy/manuelle, des paramètres malformés ou une collision sur le marché ; ne devinez jamais quel état supprimer.

2. Collecter exactement deux choix

Posez exactement une question de scope et exigez une valeur :

• user | project | local
• user est global pour cet utilisateur.
• project est partagé via les paramètres du dépôt.
• local est privé pour le projet actuel.

Marquez visuellement uniquement le scope sélectionné comme sélectionné ou en cours d'installation. Si l'utilisateur choisit un scope différent d'une installation existante unique, décrivez-le comme une migration de scope et incluez --move-scope dans les commandes ci-dessous.

Posez exactement une question de mode de hooks et exigez une valeur :

• off | minimal | standard | strict
• off conserve les compétences et commandes mais désactive l'automatisation des hooks ECC.
• minimal active le cycle de vie le plus léger et l'automatisation de sécurité.
• standard équilibre qualité et automatisation de sécurité.
• strict active les vérifications et rappels les plus forts.

La préférence de hooks est une configuration personnelle du plugin Claude ; elle ne suit pas le scope d'installation sélectionné.

3. Prévisualiser et confirmer une fois

Préférez le script de configuration fourni avec le plugin. Substituez les deux valeurs sélectionnées et incluez --move-scope uniquement pour une migration de scope :

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Si $CLAUDE_PLUGIN_ROOT n'est pas disponible, utilisez le package npm publié :

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

Affichez exactement un résumé de confirmation contenant l'action prévue, un scope, un mode de hooks, une action sur le marché et toute migration source-à-destination. Posez une question oui/non. N'exécutez pas un ecc setup interactif nu via un outil de shell d'environnement automatisé car ce shell est généralement non-TTY.

4. Appliquer les choix explicites

Après confirmation, réexécutez la même route sans --dry-run. Gardez chaque choix explicite et demandez du JSON pour que le succès puisse être vérifié de manière déterministe :

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

Alternative :

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. Vérifier, puis afficher le message de bienvenue

Exigez un statut de sortie zéro et un résultat de configuration dont scope et hooks sont égaux aux valeurs sélectionnées. Exécutez ensuite indépendamment :

claude plugin list --json

Continuez uniquement lorsqu'une entrée unique activée ecc@ecc existe au niveau du scope sélectionné. Lorsque $CLAUDE_PLUGIN_ROOT est disponible, passez l'action (installed, updated, migrated, resumed ou already-migrated) de la configuration réussie au rendu intégré :

Avant de l'invoquer, exigez que la version rapportée par le fournisseur corresponde à ECC_VERSION_PATTERN de scripts/lib/terminal-welcome.js. Rejettez le texte de version inattendu au lieu de l'interpoler dans une commande shell.

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

Affichez le message de bienvenue exactement une fois. En cas d'échec, de simulation, d'annulation, de non-concordance de scope ou de hooks, ou d'état non vérifiable, ne l'affichez pas ; signalez l'erreur et la récupération à la place. Après des modifications vérifiées, dites à l'utilisateur d'exécuter /reload-plugins ou de redémarrer Claude Code.

Codex : utiliser le cycle de vie natif des plugins

Inventoriez avec codex plugin marketplace list --json et codex plugin list --available --json. La commande de plugin native de Codex n'a pas de sélecteur user | project | local à la Claude. Les plugins natifs de Codex prennent en charge les hooks spécifiques au fournisseur, mais Codex exige une confiance explicite pour ceux-ci. Laissez Codex prendre cette décision de confiance ; ne posez pas la question des quatre profils de hooks de Claude ni ne prétendez que ces profils correspondent à Codex.

Si le marché ECC est manquant, ajoutez-le. Sinon, rafraîchissez son instantané :

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

Demandez une confirmation, puis installez ou rafraîchissez de manière idempotente le cache installé et vérifiez-le :

codex plugin add ecc@ecc --json
codex plugin list --json

Continuez uniquement lorsque le JSON indique qu'ECC est installé et fournit son installedPath. Affichez ensuite le message de bienvenue du bundle vérifié :

Utilisez uniquement le chemin absolu exact installedPath renvoyé par le JSON de Codex. Rejetez les caractères de contrôle et exigez que la version installée corresponde à ECC_VERSION_PATTERN. Invoquez node directement avec ce tableau d'arguments ; c'est un appel d'API d'outil, pas une commande shell :

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

Si l'environnement actuel ne peut pas invoquer un exécutable avec un tableau d'arguments séparé, ignorez le message de bienvenue. Ne construisez jamais une commande shell à partir des valeurs JSON de Codex.

Ne prétendez jamais que les profils off | minimal | standard | strict de Claude ont été appliqués à Codex.

Kimi : installer la surface du projet

Résumez les capacités avant confirmation : destination ./.kimi-code ; hooks=unsupported pour les hooks de cycle de vie d'ECC. Ne posez pas les questions de scope ou de mode de hooks de Claude. Prévisualisez d'abord :

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

Affichez une confirmation pour cette destination de projet, puis appliquez la commande identique sans --dry-run. Vérifiez avec :

npx --yes --package ecc-universal ecc doctor --target kimi

Uniquement après la réussite de doctor et le maintien des instructions et compétences installées dans ./.kimi-code, affichez :

npx --yes --package ecc-universal ecc welcome --action configured

Ne prétendez pas que Kimi a installé ou configuré les hooks de cycle de vie d'ECC.