跳转至

Everything Claude Code 设置

在当前执行框架内运行交互式向导。首先检查清单，仅收集对应选项，在预览后仅确认一次，然后以非交互方式应用并验证。仅在成功后显示欢迎信息。 不要将 ECC 克隆到临时目录，也不要手动复制插件。

用户自行操作的终端的规范入口是 ecc setup 和 npx ecc-universal setup。 在执行框架内，请改用以下明确的非交互式命令。

根据当前执行框架分支

  • 对于 Claude Code，使用以下完整的作用域/钩子向导。
  • 对于 Codex，使用 Codex 原生插件生命周期。不要提示 Claude 的作用域， 也不要将 Claude 的 ECC 钩子 4 个阶段映射到 Codex。
  • 对于 Kimi，将项目表面安装到 ./.kimi-code。Kimi 不支持 ECC 的 Claude 生命周期 钩子配置。
  • 如果无法确定执行框架，请说明检测依据，并在运行变更命令前询问目标。

此技能是安装后的重新配置路径。它不能劫持或替代提供商内置的首次安装 UI。

Claude Code：完整交互式向导

1. 在不更改的情况下检查清单

运行两个命令，并总结 ECC 的安装作用域、启用状态和 marketplace 源。

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

如果仅存在一个 ecc@ecc，则将其视为重新配置。不要将 Claude 拥有的 “Open home page” 控件作为安装依据。如果 setup 报告多个 ECC 作用域、 旧版/手动安装、无效配置或 marketplace 冲突，请停止并显示返回的恢复方法。 不要猜测要删除的对象。

2. 仅收集两个选择

仅询问一次作用域，并必须选择一个值。

  • user | project | local
  • user 可用于该用户的所有项目。
  • project 在仓库设置中共享。
  • local 仅对当前项目私有。

已选择或正在安装的显示仅针对实际选择的一个作用域。如果选择了与唯一现有作用域不同 的值，请说明这是作用域迁移，并在以下命令中包含 --move-scope。

仅询问一次钩子模式，并必须选择一个值。

  • off | minimal | standard | strict
  • off 保留技能和命令，并禁用 ECC 钩子自动化。
  • minimal 仅启用最轻量的生命周期和安全自动化。
  • standard 在质量和安全之间取得平衡。
  • strict 启用最强的检查和提醒。

钩子设置是个人 Claude 插件设置，不跟随安装作用域。

3. 预览并确认一次

优先使用插件内置 setup 脚本。代入两个选择值，仅在作用域迁移时 包含 --move-scope。

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

如果没有 $CLAUDE_PLUGIN_ROOT，请使用公开 npm 包。

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

仅显示一次确认摘要。包括计划操作、一个作用域、一个钩子模式、marketplace 操作， 以及从迁移源到迁移目标，仅询问一次 yes/no。由于执行框架的 Shell 通常是非 TTY， 因此不要在那里直接运行交互式 ecc setup。

4. 应用明确选择

确认后，不带 --dry-run 重新运行相同路径。明确所有选择，并通过 JSON 判定成功。

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

回退：

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

5. 验证后显示欢迎信息

要求退出代码为 0，并且 setup 结果中的 scope 和 hooks 与所选值一致。 然后独立运行：

claude plugin list --json

仅当所选作用域中恰好有一个启用的 ecc@ecc 时继续。如果存在 $CLAUDE_PLUGIN_ROOT， 请将成功 setup 的 action（installed、updated、migrated、resumed、 already-migrated）传递给内置渲染器。

在调用前，确认提供商报告的版本与 scripts/lib/terminal-welcome.js 中的 ECC_VERSION_PATTERN 匹配。 请拒绝意外值，不要将其插入 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>"

仅显示一次欢迎信息。在失败、dry-run、取消、作用域/钩子不匹配或无法验证的情况下 不要显示，而是报告错误和恢复步骤。验证后，引导使用 /reload-plugins 或重启 Claude Code。

Codex：原生插件生命周期

使用 codex plugin marketplace list --json 和 codex plugin list --available --json 进行确认。 Codex 原生插件命令没有 Claude 式的 user | project | local 选择。 不要询问 Claude 的作用域/钩子 4 个阶段。Codex 原生插件支持提供商特定钩子， 但 Codex 要求明确信任。让 Codex 显示该信任判断，不要表述为 Claude 的 4 个配置对应 Codex。

如果没有 ECC marketplace，请添加；如果已存在，请更新快照。

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

仅确认一次，执行安装或已安装缓存的可复现更新，并验证。

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

仅当 JSON 报告已安装 ECC 并提供 installedPath 时继续，并从已验证的捆绑包显示欢迎信息。

installedPath 仅使用 Codex JSON 返回的绝对路径本身，并拒绝 控制字符。使用 ECC_VERSION_PATTERN 验证版本。请使用下一个 参数数组直接调用 node。这不是 shell 命令，而是工具 API 调用。

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

如果当前执行框架无法分别传递可执行文件和参数数组，请跳过欢迎信息显示。 不要根据 Codex JSON 的值组装 shell 命令。

不要表述为 Claude 的 off | minimal | standard | strict 已应用于 Codex。

Kimi：项目表面

在确认前显示功能摘要。安装目标是 ./.kimi-code，ECC 生命周期钩子是 hooks=unsupported。不要询问 Claude 的作用域/钩子模式。首先预览。

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

仅针对此项目安装目标确认一次，并应用除 --dry-run 外的相同命令。 验证命令：

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

仅在 doctor 成功，并确认已安装的指令和技能保留在 ./.kimi-code 内后运行。

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

不要表述为 Kimi 已安装或配置了 ECC 生命周期钩子。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC