ECC安装与配置：把 Claude Code 装进一个能稳定发挥的 Harness

本地跑得挺顺的代码，一推到线上就报错。pip install装出来的版本和 lock 文件对不上，celery worker 启动报ImportError，邮件发送的 SMTP 凭据在.env.example里少了一行。前端那边更糟：登录页的 UI 调了三版，老陈总觉得差点味道——按钮圆角、字体、留白，单独看都没问题，搁一起就散。

他试过 GitHub Copilot，提示贴脸但不会动项目。试过 Cursor，能改但分不清当前项目的命名规范。试过把项目丢给网页版 Claude，让它看 README 后写代码——写是写了，第二次开窗口又得把背景从头讲一遍。

每次提 PR，老陈都在跟同一组问题搏斗：环境对不上、UI 没标准、跨会话丢上下文、命名风格飘。

问题不在他不会写。在他和 AI 助手之间，缺一套能稳定发挥的"运行环境"。

二、问题不在模型，在 Harness

这个词是跟 affaan 的推文学的：harness。原意是马具，引申到 AI 语境，就是"套在 agent 外面的那一整套基础设施"——skill、agent、hook、rule、memory、tool surface、verification loop。

模型再强，套在一团乱的 harness 上，跑出来的效果也飘。

老陈后来回想，撞上的每一类问题，几乎都能映射到 harness 的某个组件：

每一行都是工程问题，不是 prompt 问题。

三、ECC 是什么：Claude Code 的 Harness 框架

ECC 全称 Everything Claude Code。GitHub 仓库 affaan-m/everything-claude-code，目前 14 万 star、21k fork、170 多个贡献者。作者 affaanmustafa，Anthropic x Forum Ventures 黑客松的获胜者——他用 Claude Code 配合这套配置做了 zenith.chat，2025 年 9 月拿的奖。

官方 README 开头那句话很关键：

来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合。
不止是配置文件，而是一整套完整系统：技能体系、本能行为、记忆优化、持续学习、安全扫描，以及研究优先的开发模式。

它的定位很清晰：ECC 不是 Claude Code 的替代品，也不是某个 IDE 插件。它是Claude Code（以及 Codex、Cursor、OpenCode、Gemini）的 harness 框架——把"如何让 agent 在你的项目里稳定发挥"这件事，开箱即用地做成了一套可复用资产。

仓库里大致这些东西：

• 63 个 sub-agent（planner、architect、code-reviewer、python-reviewer、go-build-resolver……）
• 251 个 skill（按语言和领域分门别类）
• 79 个 slash command（含 multi-* 系列）
• 一套 hooks（PreToolUse、PostToolUse、Stop、SessionStart、PreCompact……）
• 12 个语言目录的 rules（common、typescript、python、golang、swift、php……）
• 跨平台 Node.js 脚本（Windows / macOS / Linux 都跑得动）

配套还有两个指南：Shorthand Guide 讲基础搭建，Longform Guide 讲 token 经济、内存持久化、验证循环、并行化策略。基础先读 Shorthand，进了门再看 Longform。

把 ECC 装上，相当于给 Claude Code 套上 affaan 那匹跑赢黑客松的马具。

四、ECC 怎么把那些"差口气"的场景一个个对号入座

老陈装了 ECC 之后，把自己的痛点挨个对了一遍官方文档，发现每一项都有现成方案。

环境对不上→rules/common/coding-style.md强制把依赖锁文件、pre-commit 配置写进项目规范；scripts/hooks/pre-compact.js之类的钩子会在写文件前检查 lock 状态；deployment-patternsskill 给的就是 Docker + 健康检查 + 回滚的标准做法。

UI 差口气→frontend-patterns和react-patterns两个 skill 内置了 design system 接入流程；frontend-slides、liquid-glass-design等 skill 让 UI 风格有据可依；frontend-a11y把无障碍硬指标也带上了。

跨会话丢上下文→SessionStart、PreCompact、Stop三个钩子形成闭环：会话开始自动从~/.claude/sessions/YYYY-MM-DD-topic.tmp加载上次的状态；上下文快撑爆时 PreCompact 把关键信息落盘；会话结束 Stop 钩子把今日决策、踩过的坑、未完成项写到当日 session 文件。continuous-learningskill 在 Stop 钩子里顺手把"这次调试的非平凡发现"提炼成可复用 skill，下回直接加载。

命名风格飘→rules/typescript、rules/python等语言目录里就是各语言的强制编码规范——命名、错误处理、不可变性、文件组织，全是明文写的。Claude Code 在你的项目里跑，自动加载这套规范。

改一处坏一处→verification-loop、eval-harness两个 skill 把"checkpoint-based eval"和"continuous eval"两种验证模式都内置了；e2e-testingskill 配套 Playwright 模式；tdd-workflow让 agent 写代码前先写测试。

不同 AI 助手效果差异→ ECC 兼容 Claude Code、Codex、Cursor、OpenCode、Gemini 一堆 harness。这意味着同一套配置，换模型不换规则，效果相对稳定。

安全问题→ 配套工具 AgentShield（npx ecc-agentshield scan）扫 CLAUDE.md、settings.json、MCP 配置、hooks、agent 定义，5 大类：密钥检测（14 种模式）、权限审计、钩子注入分析、MCP 服务风险评估、agent 配置审查。返回 A-F 等级，CI 退出码 2 直接挂门禁。

把官方文档翻完，老陈那张"问题—harness 组件"对照表每一行都有了对应。

五、安装：分两条路

5.1 推荐方式：作为插件

bash

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

装完即可使用 63 个 agent、251 个 skill、79 个 command。命名空间是ecc:，所以命令长这样：

bash

/ecc:plan "添加用户认证" /ecc:code-review

5.2 ⚠️ rules 不会自动装

这是新手最容易栽的坑。Claude Code 插件系统不支持通过插件分发 rules，是上游限制。所以装完插件后，要再手动复制 rules 目录：

bash

git clone https://github.com/affaan-m/everything-claude-code.git cd everything-claude-code mkdir -p ~/.claude/rules cp -R rules/common ~/.claude/rules/ cp -R rules/typescript ~/.claude/rules/ # 选你用的语言

Windows 下用 PowerShell：

powershell

New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules" | Out-Null Copy-Item -Recurse rules/common "$HOME/.claude/rules/" Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"

不要同时跑./install.sh --profile full或npx ecc-install --profile full。插件已经会自动加载 ECC 的 skills、commands 和 hooks；再执行完整安装会把同一批内容再次复制到用户目录，导致技能重复、运行时行为重复。

5.3 multi-* 命令还要再装一层