Everything Claude Code（ECC）完整教程：安装、使用与避坑指南（2026 最新）

Everything Claude Code（ECC）是一个开源的 Claude Code 工程化配置系统，由 Anthropic 黑客松冠军 Affaan Mustafa 创建，目前在 GitHub 收获超过 24 万 Star。它不是又一个 AI 编程工具，而是给 Claude Code 这类 AI 编程助手装上一套完整的工程流程：先计划再写代码、用测试验证改动、换一个全新上下文审查自己的产出、把经验沉淀成可复用的技能。

一句话理解：Claude Code 负责写代码，ECC 负责让它像一支有流程的工程团队一样干活。这篇教程基于官方仓库 2026 年 8 月的最新文档，讲清它是什么、怎么装、怎么用、怎么避坑。

ECC 是什么？

Everything Claude Code（简称 ECC）是一个 MIT 协议的开源项目，仓库地址为 affaan-m/ECC（早期仓库名就是 everything-claude-code，后来正式更名为 ECC）。它的定位官方定义为「agent harness 性能优化系统」——harness 指的是 Claude Code、Codex、Cursor 这类承载 AI 编程助手的工具外壳。

ECC 的核心思路可以用官方的一句话概括：优化上下文窗口，其他一切持久化（Optimize the context window. Persist everything else.）。AI 编程助手最大的瓶颈不是写代码的能力，而是上下文有限、记不住历史、缺乏流程约束。ECC 把「计划、测试、实现、审查、验证、记忆、改进」这套工程流程固化成配置，装一次，之后每个项目都自动生效：

plan -> test -> implement -> review -> verify -> remember -> improve

截至 2026 年 8 月，ECC 包含的组件规模：

项目从 2026 年 1 月开源后增长极快——官方 Star 历史图显示，仅 2026 年 1 月 18 日到 2 月 7 日的三周内就收获了前 4 万颗 Star，目前已超过 24 万，是 2026 年 GitHub 增长最快的开源项目之一。

它解决什么问题：没有系统 vs 有 ECC

很多团队用 AI 编程助手的真实体验是：单个任务很惊艳，完整项目靠不住。ECC 官方用一张对比表说清了原因——问题不在模型，而在缺乏系统：

对非技术读者来说，可以这么类比：原生 Claude Code 像一个能力很强但没有工作规范的新员工，你每次都要口头交代流程；装了 ECC 之后，相当于给这位新员工发了一本岗位手册和一套质检制度，而且有人（Hooks）在旁边盯着他必须照着做。

工作原理：六类组件怎么协作

ECC 用六类组件分工协作，关键在于上下文管理——不是把所有东西都塞进模型，而是各司其职：

举个完整例子：你在 Claude Code 里说「给系统加一个基于用量的计费告警」。

1. /ecc:plan 触发 planner 代理：先产出实现蓝图，你确认或修改后才进入下一步；
2. tdd-workflow 技能接管实现：先写一个失败的测试（RED 留证），再写实现代码直到测试通过（GREEN），再重构；
3. /code-review 换一个全新上下文的审查代理：用没被「实现思路」污染的视角找回归和盲区；
4. Hooks 在后台执行：类型检查、lint 等确定性检查，不占用模型注意力；
5. /save-session 收尾：把这次会话蒸馏成摘要和经验，下次 /resume-session 直接接上。

最终交付的不只是代码，而是一串证据链：计划文档、失败的测试、通过的测试、审查发现的问题、最终验证结果。

安装：官方插件市场一条命令

ECC 支持多个 AI 编程工具，但每个工具只用一种安装方式，这是最重要的规则（下面避坑一节会展开）。

Claude Code（推荐方式）：在 Claude Code 里直接执行两条命令：

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

这一步会装好 ECC 的 skills、agents、commands 和插件管理的 hooks。装完后可以用 /plugin list ecc@ecc 查看安装了哪些组件。

Codex：使用 Codex 的原生插件市场：

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc

其他工具（Cursor、OpenCode、Gemini CLI、Zed、Kimi Code 等）：克隆仓库后用安装脚本指定目标，例如：

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile minimal --target cursor

不同工具的适配程度不同，选型前先看下面的支持矩阵。

补装 Rules：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/   # 换成你用的语言

官方建议从 rules/common 加一个实际在用的语言包开始，不要全装——rules 是常驻上下文的，装多了会挤占模型的有效注意力。

安装避坑：三件必须注意的事

ECC 官方 README 用醒目的警告框反复强调这几条，但多数中文教程要么没写、要么写的是旧版本流程：

第一，不要叠加安装。 同一个工具里，插件方式和手动安装只能二选一。同时装会导致 skills、commands、hooks 重复出现。官方明确列出的组合：Claude Code 插件 + Codex 插件可以，Claude Code 插件 + Claude 手动安装不行。如果已经装乱了，用 node scripts/ecc.js doctor 诊断，node scripts/ecc.js repair 修复，或参考官方文档干净卸载后重装。

第二，只从官方渠道安装。 ECC 增长太快，出现了大量第三方转传和镜像，官方警告这些副本不受维护和审查，可能包含恶意软件。可信渠道只有五个：GitHub 仓库 affaan-m/ECC、npm 包 ecc-universal 和 ecc-agentshield、GitHub App「ECC Tools」、插件标识 ecc@ecc、官网 ecc.tools。

第三，装完先用 doctor 体检。 遇到组件缺失或行为异常，先跑 node scripts/ecc.js list-installed 和 node scripts/ecc.js doctor，多数问题可以自动修复，不必删掉重装。

实战：三个最常用的工作流

装好之后不需要背 286 个技能，从官方推荐的三条路径开始：

开发新功能（最经典的一条）：

/ecc:plan "加一个 OAuth 用户登录"     -> planner 产出实现蓝图，等你确认
tdd-workflow                         -> tdd-guide 强制先写失败测试再实现
/code-review                         -> code-reviewer 用新上下文审查改动

修 Bug： 先让 tdd-workflow 写一个能复现 Bug 的失败测试，再修到测试通过，最后 /code-review 兜底防回归。测试复现本身就是修复说明。

上线前检查：

/security-scan                       -> security-reviewer 按 OWASP Top 10 审计
e2e-testing 技能                     -> e2e-runner 跑关键用户流程
/test-coverage                       -> 验证 80% 以上覆盖率

其他高频入口：/build-fix 修挂掉的构建、/refactor-clean 清理死代码、/update-docs 同步文档、/context-budget 检查上下文压力。长会话结束前 /save-session，下次 /resume-session 继续之前的状态。

进阶：跨工具共享记忆

2026 年 6 月的 2.0 版本之后，ECC 提供了 Memory Vault（统一记忆库）：把 Claude Code、Codex、Kimi 等不同工具的工作记忆放进同一个本地 Markdown 库，方便跨工具交接：

npm install -g ecc-universal
ecc memory init --scope project
ecc memory search "认证迁移" --target-harness codex
ecc memory doctor

在 Claude Code 里做了一半的活，写一份交接记录，Codex 接手时直接检索到——对同时用多个 AI 工具的团队很实用。注意官方也明确了边界：记忆是「未经审查的上下文」，不是可执行的策略，重要结论仍要对照权威来源核实。

安全：AgentShield 扫描

装了越来越多 skills 和 hooks 之后，谁来保证这些配置本身是安全的？ECC 内置的 AgentShield 把 Agent 配置当作攻击面来扫描，覆盖提示词、hooks、MCP 配置、权限、密钥和 agent 文件。不需要安装 ECC 也能单独使用：

npx -y ecc-agentshield scan --path .

对从社区安装各种配置合集的用户来说，这个独立扫描器本身就是装 ECC 的理由之一。

支持哪些 AI 编程工具

选择建议：主力工具是 Claude Code 就放心全功能使用；用 Codex 走官方插件路径；其他工具建议先在单个项目里试用 --profile minimal 再决定推广。

商业版与开源协议

开源部分永久免费（MIT 协议）。商业化部分叫 ECC Pro，是一个托管 GitHub App，面向私有仓库的自动化场景，付费档从每席位每月 19 美元起；开源仓库的 CI 集成可以免费用。个人开发者用开源版完全够。

适合谁用

合适：每天用 Claude Code / Codex 做真实项目开发的工程师；想让 AI 编程助手输出更稳定、可审查、可交接的团队；同时使用多个 AI 编程工具、需要统一工作流和记忆的人。

暂不着急：只用网页版 ChatGPT 偶尔生成代码片段的轻度用户（ECC 依赖本地命令行环境）；只想装一个「更好用的提示词」的用户——ECC 是一套工程系统，需要花一点学习成本。

想先补基础的读者，可以配合这几篇入门：Claude Code 怎么安装 Skill、AGENTS.md 完全指南、MCP 和 Skill 的区别。

相关阅读

• Claude Code 怎么安装 Skill：从 GitHub 下载、启用到更新排错
• Codex Skill 怎么安装：目录结构与不生效排查
• Claude Code 充值订阅全攻略 2026
• Dashi PPT Skill 完全教程：让 AI Agent 做出可编辑 PPT
• 去AI味 Skill 实测全指南：中英文 7 个开源项目怎么选
• 官方仓库：https://github.com/affaan-m/ECC（中文 README：README.zh-CN.md）
• 官网：https://ecc.tools