
用 Claude Code 久了,很多人都有同一种感受:顺手的时候一个下午能推进好几天的活,不顺的时候上下文一满,它开始改坏前面写好的功能,新开一个会话又得把项目背景从头交代一遍。
工具本身没多大问题,差的是一套成型的用法。ECC(原名 Everything Claude Code)就是把这套用法打包好的开源项目,作者 Affaan 曾在 Anthropic 与 Forum Ventures 合办的黑客松上获胜,他把自己用 Claude Code 做真实产品的经验整理成了一个插件:子 Agent、Skill、Hooks、规则和持续学习都在里面,装上就能用。
这篇讲清楚 ECC 里有什么、怎么安装、哪几个模块最值得先用,以及它和 Superpowers 这类项目的区别。适合已经在用 Claude Code、想把日常工作流理顺的开发者。

Everything Claude Code 改名 ECC 后包含哪些内容
项目仓库现在叫 affaan-m/ECC,GitHub 上的 star 已经超过 29 万(2026 年 11 月数据),采用 MIT 协议。按官方 README 的统计,当前版本包含:
| 组成 | 数量 | 用途 |
|---|---|---|
| Agents | 71 个 | 规划、代码审查、修构建错误、安全、架构和各领域工作 |
| Skills | 314 个 | TDD、调研、安全、文档、前端、数据、运维等 |
| Commands | 98 个 | 兼容旧版的斜杠命令入口,项目正在转向以 Skill 为主 |
| Hooks 与记忆 | 运行时 | 会话摘要、持续学习、instinct、上下文控制 |
| Rules | 按需选择 | 按语言或项目挑选、常驻加载的编码规范 |
数量很多,按功能拆开看会清楚一些:
- Token 优化:模型分级使用、精简系统提示词、管理后台进程,目的都是把有限的上下文窗口用在刀刃上。
- 记忆持久化:用 Hooks 在会话开始时加载上次的上下文,结束时保存状态,减少每次重新交代背景的麻烦。
- 持续学习:从会话里提取编码模式,存成带置信度的 instinct,之后再整理成可复用的 Skill。
- 验证循环:先规划、再用测试验证改动,并从新的上下文里审查自己的代码。
- 并行化:借助 Git worktree 同时跑多个 Claude Code 实例,互不干扰。
- 子 Agent 编排:规划、审查、测试、安全扫描交给不同的专业 Agent。
ECC 安装教程:两条插件命令装进 Claude Code
ECC 现在的插件标识是 ecc@ecc。不少旧文章里写的还是以前的长名字 everything-claude-code@everything-claude-code,官方说明旧名只作为兼容别名保留,新装请用新名字。
在 Claude Code 里直接运行两条原生插件命令:
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
装好后新开一个会话,运行 /plugin list,能看到 ecc@ecc 已启用就说明装上了。之后想调整配置,可以用插件自带的 /ecc:configure-ecc。
官方 README 还提供了一个引导式安装器(npm 包名 ecc-universal),可以同时给 Claude Code、Codex 和 Kimi Code 装。两种方式装出来的是同一个插件,选一种就行,不要叠加安装,否则 Skill、命令和 Hooks 会重复。
规则文件需要手动复制
Claude Code 的插件系统目前不能分发 rules,所以规则要自己复制。先把仓库克隆到本地,再按需复制通用规则和你用的语言规则:
git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/
上面的 typescript 换成你实际用的技术栈即可。官方建议从 rules/common 加一个语言包起步,不要一次全装;用插件方式安装后,也不要再跑完整的手动安装脚本。
如果还不清楚 ~/.claude/rules 这些目录各自管什么,可以先看 Claude Code 的 .claude 文件夹怎么配?CLAUDE.md、rules、skills 与权限逐个讲清。
最值得先用的三个模块
记忆持久化:不用每次重新交代背景
每开一个新会话,Claude Code 都不记得项目结构、技术选型和你的习惯。ECC 用 Hooks 把这件事自动化了:
- 会话开始时,自动加载上次保存的项目上下文;
- 会话结束时,自动保存当前状态;
- 上下文快被压缩时,先把关键信息存下来。
长会话收尾时,也可以手动运行 /save-session 或 /learn-eval 保存这一轮的要点。

持续学习:把会话经验变成 Skill
完成一轮开发后,ECC 会分析这次会话,比如你怎么处理错误、怎么组织文件、怎么写测试,把这些模式记成 instinct,下次在相关场景自动调用。相关命令:
/learn # 从当前会话提取模式
/instinct-status # 查看已经学到的 instinct
/instinct-export # 导出 instinct,方便分享
/instinct-import # 导入别人的 instinct
/evolve # 把零散的 instinct 整理成完整 Skill
这在团队里很有用:新同事导入老成员导出的 instinct,就能直接继承团队积累下来的编码习惯和规范,少走一段磨合期。

专业子 Agent:复杂任务分给不同角色
ECC 没有让一个 Agent 包揽所有事,而是按职责拆开。常用的几个:
| Agent | 负责什么 |
|---|---|
| planner | 拿到需求先出实现方案 |
| architect | 系统架构决策 |
| tdd-guide | 测试驱动开发 |
| code-reviewer | 审查代码质量和安全 |
| security-reviewer | 专门找安全漏洞 |
| build-error-resolver | 处理构建报错 |
| e2e-runner | 用 Playwright 写端到端测试 |
| refactor-cleaner | 清理死代码 |
| doc-updater | 同步更新文档 |
在 Claude Code 里用斜杠命令调用即可,例如 /plan 先出方案、/tdd 进入测试驱动模式、/code-review 审查代码、/build-fix 修构建错误。
想了解 Claude Code 官方自带的插件能做什么,可以对照 Claude Code 官方插件使用教程:code-review、hookify 等 13 个插件怎么装、怎么选,再决定哪些交给 ECC。
除了 Claude Code,还能在哪些工具里用
ECC 在 Claude Code 上效果最好,同时提供了 Codex 和 Qoder 的原生插件路径。Codex 用户可以这样装:
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
Cursor、OpenCode、Gemini、Zed、GitHub Copilot 等工具也有适配,但官方说明这些是能力受限的适配器,Hooks 等功能不一定都能用,使用前先看仓库里的平台支持矩阵,别默认功能完全一样。
ECC 和 Superpowers 怎么选
Superpowers 也是一个很受欢迎的 Claude Code 配置项目,两者侧重点不同:
| 对比项 | Superpowers | ECC |
|---|---|---|
| 侧重点 | 方法论:强制 TDD、规范工作流、任务编排 | 工具箱:记忆、持续学习、省 token、安全扫描 |
| 更像 | 一套做事的规矩 | 一套随身装备 |
| 适合 | 想先把流程立起来的人 | 想补齐能力、减少重复操作的人 |
两者并不冲突,可以搭配使用,但要注意别让两边的规则互相打架。

使用前的注意事项
- 只选一种安装方式:插件命令和引导式安装器二选一,同一个工具里装两次会出现重复的 Skill 和 Hooks。
- 规则按需加:rules 会常驻上下文,装太多反而占窗口,先从通用规则加一个语言包开始。
- Hooks 要看清楚再启用:Hooks 会在会话的各个节点自动执行脚本,启用前看一下它会做什么,尤其是在公司项目里。
- 数量不等于效果:71 个 Agent、314 个 Skill 不需要都用上,先挑记忆、持续学习和代码审查这几个最常用的。
总结
ECC 的价值不在某个单独的功能,而是给了一种思路:主动定义 AI 的工作方式,而不是被动接受它的默认行为。记忆持久化解决了每次重新交代背景的问题,持续学习让它慢慢适应你的项目,子 Agent 分工让复杂任务不再混成一团。
如果你还没有稳定的 Claude Code 使用环境,可以先在 AIGoCode 上创建 API Key 接入 Claude Code,再按上面的两条命令装上 ECC,从一个小项目开始试。
参考链接
- ECC GitHub 仓库:https://github.com/affaan-m/ECC