ECC

调教你的 AI 编程搭子，让它越用越顺手

开源 🏷️定价信息待确认 ✅ 目前可打开开源模型 🍴 复刻 44274 🐛 待处理 244 👀 关注 1473

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 299718

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类开源模型

开发团队affaan-m

官网地址https://ecc.tools

GitHubhttps://github.com/affaan-m/ECC

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai-agents,anthropic,claude,claude-code,developer-tools,llm,mcp,productivity

GitHub 星标★ 299718

上线时间2026-01-18 00:00:00

代码更新2026-11-06

仓库体积61.2 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数48

项目介绍

面向 Claude Code、Codex、Opencode、Cursor 等 AI 编程工具的性能优化系统，通过技能、本能、记忆与安全机制，以研究优先的开发理念全面提升 agent 工作流的效率与稳定性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 299718

技术标签

ai-agents anthropic claude claude-code developer-tools

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

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

安装与启动步骤

1检查环境

先确认本机 Node.js 版本不低于 18；若走 Claude 插件方式，还需 Git 与 Claude Code 2.1+ 可用。
```
node -v
```
2运行引导安装

官方推荐方式，会先盘点 marketplace 与各安装范围，再把 ecc@ecc 插件装到所选范围。
```
npx ecc-universal@2.2.1 setup
```
3多工具向导安装

需要同时配置 Claude Code、Codex、Kimi Code 时使用，首次写入前会预检并请求最终确认。
```
npx ecc-universal@2.2.1 install --guided
```

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试运行预演

加 --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诊断安装状态

对指定目标运行 doctor，检查已安装配置是否正常。
```
npx ecc-universal@2.2.1 doctor --target kimi
```
7手动技能安装

低上下文、无 hook 运行时的方式：在仓库检出目录下把技能复制到 Claude 技能目录。
```
mkdir -p ~/.claude/skills
cp -r .agents/skills/* ~/.claude/skills/
cp -r skills/search-first ~/.claude/skills/
```

关键配置

配置项	必填	说明	示例
`--harness`	否	选择要配置的工具，可重复传入 claude、codex、kimi	`--harness claude --harness codex`
`--claude-scope`	否	Claude Code 插件安装范围，取 user、project 或 local	`--claude-scope local`
`--claude-hooks`	否	Claude Code 的 ECC hook 配置档案	`--claude-hooks standard`
`--profile`	否	安装配置档案，如 core 或 minimal	`--profile core`
`--target`	否	指定安装目标，配合 profile 使用	`--target kimi`
`--yes`	否	跳过最终确认，适合自动化执行	`--yes`

如何确认成功

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

常见问题

Q：npm 报版本或缓存错误怎么办？

A：先用 npm view ecc-universal version 确认 registry 上的版本，再重新执行命令。

Q：可以用 Yarn Classic 吗？

A：Yarn 1 不提供 yarn dlx，请改用 npx、把包装到全局，或升级 Yarn 后再临时运行。

Q：能直接运行 npx ecc-install 吗？

A：不能。ecc-install 是 ecc-universal 包内的二进制名，并非单独发布的 npm 包。

Q：之后怎么更新 ECC？

A：重新运行同一条 setup 命令即可更新、切换安装范围或更换 hook 配置档案。

Q：可以同时用向导安装和手动安装吗？

A：不要叠加。两种方式装的是同一个 ecc@ecc 插件，手动安装也不应嵌套在 ~/.claude/skills/ecc/ 下。

注意事项

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