ECC

环境要求

• Node.js 18 或更高版本
• npm/npx（或用 pnpm dlx、yarn dlx、bunx 替代）
• Claude Code 插件方式还需 Git
• Claude Code 插件方式还需 Claude Code 2.1 或更高版本且在 PATH 中

安装与启动步骤

1. 1检查环境

   先确认本机 Node.js 版本不低于 18；若走 Claude 插件方式，还需 Git 与 Claude Code 2.1+ 可用。

   node -v

   复制

2. 2运行引导安装

   官方推荐方式，会先盘点 marketplace 与各安装范围，再把 ecc@ecc 插件装到所选范围。

   npx ecc-universal@2.2.1 setup

   复制

3. 3多工具向导安装

   需要同时配置 Claude Code、Codex、Kimi Code 时使用，首次写入前会预检并请求最终确认。

   npx ecc-universal@2.2.1 install --guided

   复制

4. 4非交互安装

   自动化场景把各选项显式写全，避免交互提问；可按需增删 --harness。

   npx ecc-universal@2.2.1 install --guided 
     --harness claude --harness codex --harness kimi 
     --claude-scope local --claude-hooks standard 
     --profile core --yes

   复制

5. 5试运行预演

   加 --dry-run 只预演流程不写入文件，可先确认目标与通道是否正确。

   npx ecc-universal@2.2.1 install --guided --harness codex --dry-run
   npx ecc-universal@2.2.1 install --profile core --target kimi --dry-run

   复制

6. 6诊断安装状态

   对指定目标运行 doctor，检查已安装配置是否正常。

   npx ecc-universal@2.2.1 doctor --target kimi

   复制

7. 7手动技能安装

   低上下文、无 hook 运行时的方式：在仓库检出目录下把技能复制到 Claude 技能目录。

   mkdir -p ~/.claude/skills
   cp -r .agents/skills/* ~/.claude/skills/
   cp -r skills/search-first ~/.claude/skills/

   复制

关键配置

如何确认成功

运行 npx ecc-universal@2.2.1 doctor --target <目标> 无报错，或在 Claude Code 中确认 ecc@ecc 插件已按所选范围安装。

常见问题

注意事项

• 命令中的版本号 2.2.1 只是选定已发布版本，版本固定不等于安全审计或完整性校验，运行前请审查发布源码与 registry 完整性。
• 不要把仓库原始的 hooks/hooks.json 直接复制进 ~/.claude/settings.json 或 ~/.claude/hooks/hooks.json。
• 两个向导都不会静默安装到所有检测到的工具，只会安装你明确选择的目标。
• cursor、antigravity、gemini、opencode 等高级适配器目前仍走各自的 ecc install --target ... 路径。