Everything Claude Code 使用指南
Everything Claude Code 是一套跨 AI 编辑器的 agent 性能优化系统，由 Anthropic Hackathon 获奖者开发。它不只是配置文件的集合，而是一套完整的工作流体系，包含 Skills、记忆机制、安全扫描和 research-first 开发方法论，支持 Claude Code、Codex、Cursor、OpenCode、Gemini 等主流 AI 编辑器。
项目数据：145k+ Stars、22k+ Forks、170+ 贡献者、12+ 语言生态、Anthropic Hackathon 冠军
与现有工具体系的关系
如果你已经在用 superpowers（using-superpowers、tdd-workflow、systematic-debugging 等 Skills）或 GSD，它们和 ECC 并不冲突，但定位和覆盖范围不同：
| superpowers | GSD | ECC | |
|---|---|---|---|
| 定位 | 工作流 Skill 约束层 | 项目管理 + 上下文工程 | Agent Harness 性能优化系统 |
| 主要能力 | 规范 AI 在 Cursor/Claude Code 中的执行方式 | 规划、执行、验证的全流程编排 | Rules、Hooks、Agents、持续学习、安全扫描 |
| Skills 来源 | ~/.cursor/skills/ 安装的 SKILL.md | .planning/ 目录下的计划文件 | .agents/skills/ 下的 SKILL.md |
| 是否冲突 | 不冲突，可共存 | 不冲突，可共存 | — |
关键区别在于：
- superpowers 的 Skills（如
using-superpowers、systematic-debugging）是你在 Cursor/Claude Code 中直接使用的工作流规范，告诉 AI 怎么思考和执行任务。superpowers 本身实际上也是 ECC 生态中的一个插件。 - ECC 是在这之上更底层的 Harness 层，侧重 Rules 文件（始终生效的编码约束）、Hooks（文件保存时自动触发的检查）、跨平台配置同步，以及 Codex 等工具的 Agent 和 MCP 配置。
- 两者名字有重叠的 Skill（如
tdd-workflow），但来源不同：superpowers 版本在~/.cursor/skills/，ECC 版本在.agents/skills/。Codex 识别的是.agents/skills/，Cursor 识别的是~/.cursor/skills/，各走各的路径，不会互相覆盖。
实际使用建议： 已有 superpowers + GSD 的情况下，引入 ECC 主要是为了补充 Rules 文件（自动约束编码规范）和 Codex 的 Agent/Skills 配置，核心工作流继续用 superpowers 和 GSD 即可。
各平台支持完整度
ECC 以 Claude Code 为主战场，其他平台是后续适配的跨平台扩展，完整度依次递减：
| 功能 | Claude Code | Cursor | Codex | OpenCode |
|---|---|---|---|---|
| Agents | 65 个独立 .md 文件 | 共享（读 ~/.claude/agents/） | 3 个 .toml + AGENTS.md 描述 | 12 个 |
| Skills | 175 个 | 共享（读 ~/.claude/skills/） | 34 个（需 openai.yaml 适配） | 37 个 |
| Rules | 15 个语言目录，自动加载 | 34 个（YAML frontmatter 格式） | 无独立 Rules，合并进 AGENTS.md | 13 个指令 |
| Hooks | 8 种事件，全自动触发 | 15 种事件，全自动触发 | 不支持 | 11 种事件 |
| Commands | 79 个斜杠命令 | 共享 | 转换为 87 个 prompts | 31 个 |
| MCP | 完整支持 | 共享 | config.toml 配置 | 完整支持 |
Codex 的差距根本原因：
- 格式不兼容：Codex 的 Agent 用
.toml，Skills 需要额外的openai.yaml，Claude Code 的.md文件不能直接复用 - 不支持 Hooks：Codex 目前没有工具事件回调机制，文件保存自动 lint、自动格式化等功能无法实现，只能靠 AGENTS.md 里的指令约束来补偿
- 适配优先级：ECC 起源于 Claude Code，Codex 支持是后来加的，团队精力有限，只适配了核心子集
实际影响： Codex 下的 ECC 日常编码任务（TDD、安全检查、代码审查）够用，但缺少细分语言的专职 Agent（Go reviewer、Rust reviewer 等各自独立的角色），也缺少自动触发的质量门禁。如果对这些有需求，Claude Code 或 Cursor 是更完整的选择。
核心组成
Everything Claude Code（下称 ECC）由以下几个核心模块构成：
| 模块 | 数量 | 说明 |
|---|---|---|
| Agents | 47 个 | 专职子 agent，负责代码审查、架构设计、测试等 |
| Skills | 181 个 | 可复用的工作流定义和领域知识 |
| Rules | 34 个 | 编码规范文件，按语言分目录（Claude Code：默认全量加载，支持 paths: 按路径按需加载；Cursor：通过 alwaysApply + globs 控制；Codex：无此机制，内容合并进 AGENTS.md） |
| Hooks | 20+ 个 | 工具事件触发的自动化脚本 |
| Commands | 79 个 | 遗留斜杠命令入口（迁移到 Skills 中） |
从零开始：以 Codex 为例
这里用 Codex（OpenAI 的 AI 编程工具）作为示范，从零开始完整走一遍 ECC 的接入过程。
第一步：安装 Codex CLI
npm install -g @openai/codex
安装后验证可用：
codex --version
第二步：克隆 ECC 仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
第三步：同步 ECC 配置到 Codex
ECC 提供了一键同步脚本，将 AGENTS.md、Skills、MCP 服务器等配置合并到 ~/.codex：
bash scripts/sync-ecc-to-codex.sh
这个脚本采用 add-only 策略，不会删除或修改你已有的配置，只添加 ECC 提供的内容。
想预览会做什么改动，可以加 --dry-run：
bash scripts/sync-ecc-to-codex.sh --dry-run
如果你已有 Context7 等 MCP 服务器的旧配置，加 --update-mcp 同步到最新推荐版本：
bash scripts/sync-ecc-to-codex.sh --update-mcp
第四步：复制全局配置（可选）
# 将 ECC 的 Codex 配置复制为全局默认
cp .codex/config.toml ~/.codex/config.toml
config.toml 包含沙箱权限、审批模式、MCP 服务器列表等设置，不锁定具体模型，Codex 会使用自身当前的默认模型。
第五步：进入你的项目，启动 Codex
# 切换到你自己的项目目录
cd /path/to/your-project
# 启动 Codex
codex
Codex 会自动识别根目录的 AGENTS.md 和 .codex/ 目录，ECC 的 agent 定义、skills 和指令即刻生效。
第六步：验证 Skills 已加载
在 Codex 会话中输入，确认 ECC 提供的 Skills 可用：
列出可用的 Skills
你会看到 ECC 在 .agents/skills/ 下提供的 30 个 Skill，包括 tdd-workflow、security-review、api-design 等。
第七步：开始使用
以「写一个带测试的新功能」为例，直接描述任务，ECC 的 tdd-workflow Skill 会引导 Codex 按照 TDD 流程执行：
用 TDD 方式实现一个用户注册接口，要求：
- 接受 email 和 password
- 校验 email 格式
- 密码最少 8 位
ECC 的 Skill 会让 Codex 遵循：先写失败的测试 → 最小实现通过测试 → 重构 → 验证覆盖率 ≥ 80%。
Codex 下 ECC 完整安装清单
两个命令执行完毕后，以下文件和目录会被创建或修改：
bash scripts/sync-ecc-to-codex.sh 做的事
修改 ~/.codex/AGENTS.md（追加，不覆盖原有内容）：
- 在文件末尾插入
<!-- BEGIN ECC --> ... <!-- END ECC -->块 - 包含 ECC 的 5 条核心原则、26 个专职 Agent 速查表、编码规范、测试要求、Git 提交格式
- 包含 Codex 专属补充：Skills 列表、MCP 说明、与 Claude Code 的差异对比
- Codex 没有独立的 Rules 机制，这里就是 Rules 的等价替代
修改 ~/.codex/config.toml（add-only，不删除原有配置）：
- 顶部新增
notify（任务完成桌面通知）和persistent_instructions - 新增
[agents]多 Agent 线程配置（max_threads=6, max_depth=1） - 新增
[profiles.strict]（只读沙箱）和[profiles.yolo]（全自动审批）两个安全预设 - 新增
[agents.explorer/reviewer/docs_researcher]三个 Agent 角色定义 - 新增 4 个 MCP 服务器：
supabase、exa、github、memory - 已有的
playwright、context7、sequential-thinking保持不变（格式有差异但功能相同）
新建 ~/.codex/agents/：
~/.codex/agents/
explorer.toml # 只读探索 agent，在提出修改前先收集代码证据
reviewer.toml # 审查正确性、安全性、缺失测试
docs-researcher.toml # 验证 API、框架行为、Release Notes
新建 ~/.codex/prompts/（87 个提示文件）：
- 79 个命令提示（
ecc-tdd.md、ecc-code-review.md、ecc-plan.md等） - 8 个扩展提示（工具提示 + 语言规则包）
安装全局 Git Hooks 到 ~/.codex/git-hooks/：
pre-commit：提交前安全检查（防止硬编码密钥等）pre-push：推送前检查- 设置
git config --global core.hooksPath全局生效
备份：每次执行都会在 ~/.codex/backups/ecc-<时间戳>/ 保存修改前的快照
cp -r .agents/skills/* ~/.agents/skills/ 做的事
新建 ~/.agents/skills/（34 个 Codex 专用 Skills）：
| Skill | 用途 |
|---|---|
tdd-workflow | 测试驱动开发，强制 80%+ 覆盖率 |
security-review | 安全检查清单（OWASP Top 10） |
api-design | REST API 设计规范 |
backend-patterns | API、数据库、缓存模式 |
frontend-patterns | React/Next.js 模式 |
frontend-slides | HTML 演示文稿生成 |
e2e-testing | Playwright E2E 测试 |
verification-loop | 构建、测试、lint、类型检查全链路 |
coding-standards | 通用编码规范 |
deep-research | 多源研究与归纳 |
documentation-lookup | 通过 Context7 MCP 查询最新文档 |
exa-search | 通过 Exa MCP 神经搜索 |
eval-harness | 评估驱动开发 |
strategic-compact | 上下文压缩时机管理 |
claude-api | Anthropic Claude API 模式 |
x-api | X/Twitter API 集成 |
crosspost | 多平台内容分发 |
fal-ai-media | AI 图像/视频/音频生成 |
dmux-workflows | 多 Agent 编排 |
brand-voice | 品牌声调写作 |
content-engine | 多平台社交内容生产 |
article-writing | 长文写作 |
market-research | 市场与竞品研究 |
investor-materials | 融资材料（路演、备忘录） |
investor-outreach | 个性化融资外联 |
mcp-server-patterns | 构建 MCP 服务器 |
bun-runtime | Bun 运行时最佳实践 |
nextjs-turbopack | Next.js + Turbopack |
frontend-design | Figma 到代码实现 |
video-editing | AI 辅助视频编辑 |
product-capability | 产品能力定义 |
everything-claude-code | ECC 本身的开发规范 |
agent-introspection-debugging | Agent 自我调试 |
agent-sort | Agent 任务排序 |
每个 Skill 都包含 SKILL.md（内容）和 agents/openai.yaml（Codex 接口描述），这是 Codex 识别 Skill 的必要格式。
:::note Skills 路径说明
~/.agents/skills/ 是跨工具的通用路径（Codex、Claude Code、Cursor 都识别），而不是 ~/.codex/skills/，这样同一套 Skills 可以被多个工具复用。
:::
Codex 的限制说明
Codex 目前不支持 Hook 事件执行，这部分能力通过 AGENTS.md 的指令约束和沙箱/审批配置来补偿，效果等价但机制不同。
快速安装（其他平台）
Claude Code 插件安装
在 Claude Code 中执行：
# 添加 ECC 到插件市场
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
# 安装插件
/plugin install ecc@ecc
安装完成后即可访问所有 agent、skill 和 hook。
:::caution 注意
Claude Code 插件系统不支持通过插件分发 rules，需要手动安装规则文件。
:::
脚本安装（全平台通用）
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
# macOS/Linux：安装全部（推荐）
./install.sh --profile full
# 或只安装指定语言的规则
./install.sh typescript python golang
# 为 Cursor 安装
./install.sh --target cursor typescript
# Windows PowerShell
.\install.ps1 --profile full
核心概念
Skills（技能）
Skills 是 ECC 的主要工作流入口，每个 Skill 是一个 SKILL.md 文件，包含 YAML frontmatter 和操作步骤说明。
常用 Skill 示例：
# TDD 工作流
/tdd
# 代码审查
/code-review
# 修复构建错误
/build-fix
# 安全扫描
/security-scan
# 生成 E2E 测试
/e2e
ECC 提供的核心 Skill 分类：
| 分类 | 示例 Skills |
|---|---|
| 编码规范 | coding-standards、typescript-patterns |
| 测试工作流 | tdd-workflow、e2e-testing、eval-harness |
| 安全相关 | security-review、security-scan |
| 架构模式 | backend-patterns、frontend-patterns、api-design |
| 持续学习 | continuous-learning、continuous-learning-v2 |
| 部署运维 | deployment-patterns、docker-patterns |
| 内容创作 | article-writing、content-engine |
Agents（子 Agent）
Agents 是专职的子 AI，针对特定任务类型深度优化。当你发起某类任务时，ECC 会自动委托给对应 Agent：
| 我想做的事 | 使用命令 | 对应 Agent |
|---|---|---|
| 规划新功能 | /ecc:plan "功能描述" | planner |
| 系统架构设计 | /ecc:plan + architect | architect |
| 测试驱动开发 | /tdd | tdd-guide |
| 审查刚写的代码 | /code-review | code-reviewer |
| 修复构建失败 | /build-fix | build-error-resolver |
| 运行端到端测试 | /e2e | e2e-runner |
| 查找安全漏洞 | /security-scan | security-reviewer |
| 清理死代码 | /refactor-clean | refactor-cleaner |
| 审查 Go 代码 | /go-review | go-reviewer |
| 审查 Python 代码 | /python-review | python-reviewer |
Rules（规则）
Rules 是始终生效的编码规范文件，安装后会在每次对话中自动约束 AI 行为。规则按语言组织：
rules/
common/ # 语言无关的通用原则（必装）
coding-style.md # 不可变性、文件组织
git-workflow.md # 提交格式、PR 流程
testing.md # TDD、80% 覆盖率要求
performance.md # 模型选择、上下文管理
security.md # 必须执行的安全检查
typescript/ # TypeScript/JavaScript 专项
python/ # Python 专项
golang/ # Go 专项
swift/ # Swift 专项
php/ # PHP 专项
手动安装规则：
# 用户级规则（对所有项目生效）
mkdir -p ~/.claude/rules
cp -r rules/common ~/.claude/rules/
cp -r rules/typescript ~/.claude/rules/ # 按需选择语言
# 项目级规则（仅对当前项目生效）
mkdir -p .claude/rules
cp -r rules/common .claude/rules/
Hooks（钩子）
Hooks 在工具事件触发时自动执行，实现无感知的自动化。Cursor 支持 15 种 hook 事件，包括：
beforeShellExecution：阻止在 tmux 外启动开发服务器afterFileEdit：自动格式化 + TypeScript 检查 + console.log 警告beforeSubmitPrompt：检测提示词中的密钥（sk-、ghp_、AKIA等）beforeTabFileRead：阻止读取.env、.key、.pem文件
运行时控制 Hook 的严格程度：
# 设置 Hook 严格级别（minimal/standard/strict）
export ECC_HOOK_PROFILE=standard
# 临时禁用指定 Hook
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
跨平台支持
ECC 支持所有主流 AI 编辑器：
| 平台 | Agents | Skills | Hooks | Rules |
|---|---|---|---|---|
| Claude Code | 47 | 181 | 8 种事件 | 34 个 |
| Cursor IDE | 共享 | 共享 | 15 种事件 | 34 个 |
| Codex CLI | 共享 | 10（原生格式） | 暂无 | 指令式 |
| OpenCode | 12 | 37 | 11 种事件 | 13 个指令 |
| Gemini CLI | 实验性 | 共享 | - | - |
Cursor 安装
# 为 Cursor 安装 TypeScript 规则
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php
Codex 安装
# 同步 ECC 资产到 Codex
npm install && bash scripts/sync-ecc-to-codex.sh
# 或手动复制配置
cp .codex/config.toml ~/.codex/config.toml
Token 优化
ECC 提供了一套 Token 消耗控制策略，可以在不影响质量的前提下显著降低成本：
推荐设置
在 ~/.claude/settings.json 中添加：
{
"model": "sonnet",
"env": {
"MAX_THINKING_TOKENS": "10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
}
}
| 设置项 | 默认值 | 推荐值 | 效果 |
|---|---|---|---|
model | opus | sonnet | 降低约 60% 成本，处理 80%+ 编码任务 |
MAX_THINKING_TOKENS | 31999 | 10000 | 降低约 70% 隐式思考成本 |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 95 | 50 | 更早压缩，长会话质量更好 |
常用命令
| 命令 | 使用时机 |
|---|---|
/model sonnet | 默认场景 |
/model opus | 复杂架构、深度调试 |
/clear | 无关任务之间（免费、即时重置） |
/compact | 逻辑节点之间（研究完成后、里程碑完成后） |
/cost | 监控会话 Token 消耗 |
:::tip 何时使用 compact
- 研究/探索完成后、开始实现前
- 完成一个里程碑、开始下一个前
- 调试结束后、继续功能开发前
不要在实现过程中间 compact，否则会丢失变量名、文件路径等关键上下文。 :::
MCP 服务器数量控制
MCP 服务器越多，消耗的 Token 越多。每个 MCP 的工具描述都会占用上下文窗口：
// 在项目 .claude/settings.json 中禁用不需要的 MCP
{
"disabledMcpServers": ["supabase", "railway", "vercel"]
}
- 同时启用的 MCP 不超过 10 个
- 激活的工具不超过 80 个
持续学习系统
ECC 内置了 Instinct（本能）学习系统，自动从会话中提取你的编码模式：
# 查看已学到的本能（带置信度）
/instinct-status
# 从其他人导入本能
/instinct-import <file>
# 导出你的本能分享给团队
/instinct-export
# 将相关本能聚合成 Skill
/evolve
# 删除过期的待定本能（30 天 TTL）
/prune
AgentShield 安全扫描
ECC 集成了 AgentShield，这是在 Claude Code Hackathon 上开发的安全审计工具，内置 1282 个测试、102 条静态分析规则：
# 快速扫描（无需安装）
npx ecc-agentshield scan
# 自动修复安全问题
npx ecc-agentshield scan --fix
# 深度分析（三个 Opus agent 红队/蓝队/审计员模式）
npx ecc-agentshield scan --opus --stream
# 生成安全配置
npx ecc-agentshield init
扫描覆盖范围：CLAUDE.md、settings.json、MCP 配置、hooks、agent 定义，涵盖 5 个类别：
- 密钥检测（14 种模式）
- 权限审计
- Hook 注入分析
- MCP 服务器风险分析
- Agent 配置审查
典型工作流
开始新功能
# 1. 创建实现计划
/ecc:plan "添加 OAuth 用户认证"
# 2. 测试驱动开发
/tdd
# 3. 代码审查
/code-review
修复 Bug
# 1. 先写一个能复现 bug 的失败测试
/tdd
# 2. 实现修复，验证测试通过
# 3. 检查回归
/code-review
生产环境准备
# 1. 安全审计（OWASP Top 10）
/security-scan
# 2. 关键用户流程测试
/e2e
# 3. 验证覆盖率达到 80%+
/test-coverage
Skill Creator：从代码库自动生成 Skill
ECC 提供了两种方式从你的仓库历史自动生成 Skill：
方式 A：本地分析
# 分析当前仓库
/skill-create
# 同时生成本能（用于持续学习）
/skill-create --instincts
方式 B：GitHub App
适合 10000+ 提交的大型仓库，支持自动 PR 和团队共享，安装地址：github.com/marketplace/ecc-tools
两种方式都会生成：
- SKILL.md 文件 — 即用型 Skill
- Instinct 集合 — 用于持续学习 v2
- Pattern 提取 — 从提交历史中学习你的编码习惯
常见问题
Q: Hook 不生效，或出现"Duplicate hooks file"错误？
不要在 .claude-plugin/plugin.json 中声明 hooks 字段。Claude Code v2.1+ 会自动从安装的插件加载 hooks/hooks.json，重复声明会导致冲突。
Q: 上下文窗口快用完了？
MCP 服务器过多是常见原因。在项目配置中禁用未使用的 MCP，保持激活工具数量在 80 个以内。
Q: 只想用其中一部分组件？
可以，每个组件完全独立：
# 只安装 Agents
cp agents/*.md ~/.claude/agents/
# 只安装 Rules
mkdir -p ~/.claude/rules/
cp -r rules/common ~/.claude/rules/
Q: 支持自定义 API 端点或模型网关吗？
支持。ECC 不硬编码 Anthropic 传输层设置，配置好 claude CLI 后即可使用：
export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=your-token
claude